// 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. // // Baseline functional UI (data-ui-id markers for e2e); the Subframe visual polish // follows Davids D-P4 delta (Dev-Nachzug). import { type LoaderFunctionArgs, useLoaderData } from "react-router"; import { useTranslation } from "react-i18next"; import { buildFileBrowserVM, type FileBrowserRow, type FileBrowserVM } from "@toolctrl/view-models"; import { getTranslations } from "~/locale/i18next.server"; import { loadFilesContext, notFoundResponse, requireFilesPermission } from "~/utils/integrations/fileAccess.server"; import { listFilesForBrowser } from "~/utils/integrations/fileService.server"; import { mediaVariantPath, filesDetailPath } from "~/utils/integrations/fileRoutePaths"; import ServerError from "~/components/ui/errors/ServerError"; type LoaderData = { title: string; vm: FileBrowserVM }; export const loader = async ({ request, params }: LoaderFunctionArgs) => { const { t } = await getTranslations(request); const ctx = await loadFilesContext({ request, params }); const tenantSlug = params.tenant ?? ""; 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 } 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 cursor = url.searchParams.get("cursor"); const { rows, nextCursor } = await listFilesForBrowser({ tenantId: ctx.tenantId, ctx, filter: { includeArchived, mimeGroup }, cursor, }); 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({ rows: browserRows, filter: { entityType: null, mimeGroup, tags: [], assignedToUserId: null, includeArchived }, canWrite, canDelete, nextCursor, }); return Response.json({ title: `${t("files.browser.title")} | ${process.env.APP_NAME}`, vm } satisfies LoaderData); }; function formatBytes(bytes: number): string { if (bytes < 1024) return `${bytes} B`; const units = ["KB", "MB", "GB"]; let value = bytes / 1024; let unitIndex = 0; while (value >= 1024 && unitIndex < units.length - 1) { value /= 1024; unitIndex += 1; } return `${value.toFixed(1)} ${units[unitIndex]}`; } export default function FilesBrowserRoute() { const { t, i18n } = useTranslation(); const { vm } = useLoaderData(); if (vm.status !== "ready" || !vm.data) { return
; } const { rows, canWrite, emptyHeadlineKey, emptyBodyKey } = vm.data; const dateFormatter = new Intl.DateTimeFormat(i18n.language, { dateStyle: "medium" }); return (

{t("files.browser.title")}

{t("files.browser.subtitle")}

{canWrite ? ( {t("files.browser.actions.upload")} ) : null}
{rows.length === 0 ? (

{t(emptyHeadlineKey)}

{t(emptyBodyKey)}

) : ( {rows.map((row) => ( ))}
{t("files.browser.column.name")} {t("files.browser.column.size")} {t("files.browser.column.date")}
{row.displayName} {formatBytes(row.sizeBytes)} {dateFormatter.format(new Date(row.createdAtIso))}
)}
); } export function ErrorBoundary() { return ; }