// 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 // //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(); const navigate = useNavigate(); const [selectedIds, setSelectedIds] = useState([]); 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 ( ); } export function ErrorBoundary() { return ; }