Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/web/app/routes/app.$tenant/files._index.tsx
T
2026-07-08 16:15:37 +02:00

147 lines
6.2 KiB
TypeScript

// P4 Files (AK-P4a) §11 — Files browser route. Loader builds the FileBrowserVM
// once (server-side); the component only renders (DoD A). Module off -> locked
// empty state (like walking-skeleton). Missing files.read_own -> 404.
//
// Interim-UI (AD-28): renders the ~/ui preview screen FilesBrowserPage; the loader
// owns navigation for filter/view changes (server-side). Final Subframe optics land
// as a tracked design-nachzug once David's D-P4 delta ships.
import { useState } from "react";
import { type LoaderFunctionArgs, useLoaderData, useNavigate } from "react-router";
import { buildFileBrowserVM, type FileBrowserRow, type FileBrowserVM, type FileViewMode } from "@hivegrid/view-models";
import { getTranslations } from "~/locale/i18next.server";
import { loadFilesContext, notFoundResponse, requireFilesPermission } from "~/utils/integrations/fileAccess.server";
import { listFilesForBrowser, listFileFilterOptions } from "~/utils/integrations/fileService.server";
import { mediaVariantPath, filesDetailPath } from "~/utils/integrations/fileRoutePaths";
import { FilesBrowserPage, type FilesBrowserQuery } from "~/components/screens/files/FilesBrowserPage";
import ServerError from "~/components/ui/errors/ServerError";
type LoaderData = { title: string; vm: FileBrowserVM; nextHref: string | null; uploadHref: string; bulkZipAction: string };
export const loader = async ({ request, params }: LoaderFunctionArgs) => {
const { t } = await getTranslations(request);
const ctx = await loadFilesContext({ request, params });
const tenantSlug = params.tenant ?? "";
// Absolute (host-aware) URLs — a relative "upload" would resolve against the
// /<tenant>/files base and drop the "files" segment (→ 404).
const uploadHref = `/${tenantSlug}/files/upload`;
const bulkZipAction = `/${tenantSlug}/files/bulk-zip`;
if (!ctx.hasModule) {
// Locked connector state: render an empty VM (no rows, no write).
const vm = buildFileBrowserVM({
rows: [],
filter: { entityType: null, mimeGroup: null, tags: [], assignedToUserId: null, includeArchived: false },
canWrite: false,
canDelete: false,
});
return Response.json({ title: `${t("files.browser.title")} | ${process.env.APP_NAME}`, vm, nextHref: null, uploadHref, bulkZipAction } satisfies LoaderData);
}
try {
requireFilesPermission(ctx, "files.read_own");
} catch {
throw notFoundResponse();
}
const url = new URL(request.url);
const includeArchived = url.searchParams.get("archived") === "1";
const mimeGroup = url.searchParams.get("mime");
const entityType = url.searchParams.get("entity");
const tag = url.searchParams.get("tag");
const assignedToUserId = url.searchParams.get("assignee");
const cursor = url.searchParams.get("cursor");
const viewMode: FileViewMode = url.searchParams.get("view") === "grid" ? "grid" : "table";
const [{ rows, nextCursor }, filterOptions] = await Promise.all([
listFilesForBrowser({
tenantId: ctx.tenantId,
ctx,
filter: { includeArchived, mimeGroup, entityType, tags: tag ? [tag] : undefined, assignedToUserId },
cursor,
}),
listFileFilterOptions({ tenantId: ctx.tenantId }),
]);
const canWrite = ctx.permissions.includes("files.write");
const canDelete = ctx.permissions.includes("files.delete");
const browserRows: FileBrowserRow[] = rows.map((file) => ({
id: file.id,
displayName: file.displayName,
mimeType: file.mimeType,
sizeBytes: file.sizeBytes,
createdAtIso: file.createdAt.toISOString(),
tags: file.tags,
source: file.source,
previewStatus: file.previewStatus as FileBrowserRow["previewStatus"],
scanStatus: file.scanStatus as FileBrowserRow["scanStatus"],
thumbnailUrl: file.thumbnailStorageKey && file.previewStatus === "ready" ? mediaVariantPath(tenantSlug, file.id, "thumb") : null,
detailHref: filesDetailPath(tenantSlug, file.id),
linkedEntityLabelKey: null,
}));
const vm = buildFileBrowserVM({
viewMode,
rows: browserRows,
filter: { entityType, mimeGroup, tags: tag ? [tag] : [], assignedToUserId, includeArchived },
filterOptions,
canWrite,
canDelete,
nextCursor,
});
// Preserve the active filter/view when paging via cursor.
const nextParams = new URLSearchParams();
if (mimeGroup) nextParams.set("mime", mimeGroup);
if (entityType) nextParams.set("entity", entityType);
if (tag) nextParams.set("tag", tag);
if (assignedToUserId) nextParams.set("assignee", assignedToUserId);
if (includeArchived) nextParams.set("archived", "1");
if (viewMode === "grid") nextParams.set("view", "grid");
if (nextCursor) nextParams.set("cursor", nextCursor);
const nextHref = nextCursor ? `?${nextParams.toString()}` : null;
return Response.json({ title: `${t("files.browser.title")} | ${process.env.APP_NAME}`, vm, nextHref, uploadHref, bulkZipAction } satisfies LoaderData);
};
export default function FilesBrowserRoute() {
const { vm, nextHref, uploadHref, bulkZipAction } = useLoaderData<LoaderData>();
const navigate = useNavigate();
const [selectedIds, setSelectedIds] = useState<string[]>([]);
function onToggleSelect(id: string) {
setSelectedIds((prev) => (prev.includes(id) ? prev.filter((value) => value !== id) : [...prev, id]));
}
function onToggleSelectAll(ids: readonly string[], selectAll: boolean) {
setSelectedIds(selectAll ? [...ids] : []);
}
function onApply(query: FilesBrowserQuery) {
const params = new URLSearchParams();
if (query.mimeGroup) params.set("mime", query.mimeGroup);
if (query.entityType) params.set("entity", query.entityType);
if (query.tag) params.set("tag", query.tag);
if (query.assignedToUserId) params.set("assignee", query.assignedToUserId);
if (query.includeArchived) params.set("archived", "1");
if (query.viewMode === "grid") params.set("view", "grid");
// Reset cursor pagination whenever the filter/view changes.
navigate({ search: params.toString() });
}
return (
<FilesBrowserPage
vm={vm}
uploadHref={uploadHref}
nextHref={nextHref}
bulkZipAction={bulkZipAction}
selectedIds={selectedIds}
actions={{ onApply, onToggleSelect, onToggleSelectAll }}
/>
);
}
export function ErrorBoundary() {
return <ServerError />;
}