// P4 Files (AK-P4a) §11 — File detail route. Loader builds FileDetailVM (proxy // URLs only, AD-23); action handles archive/reactivate/delete/regenerate + // audit. Not-visible / foreign file -> 404. Baseline functional UI. import { type ActionFunctionArgs, type LoaderFunctionArgs, redirect, useActionData, useLoaderData } from "react-router"; import { buildFileDetailVM, type FileDetailVM, type FileLinkedEntity } from "@hivegrid/view-models"; import { badRequestResponse, loadFilesContext, notFoundResponse, requireFilesPermission } from "~/utils/integrations/fileAccess.server"; import { archiveFile, findFileNeighbours, getVisibleFileOrThrow, getVisibleFileWithLinks, hardDeleteFile, linkFile, reactivateFile, regenerateFilePreview, unlinkFile, updateFileMeta, type FileEntityType, } from "~/utils/integrations/fileService.server"; import { fileLinkKey, resolveFileLinkLabels } from "~/utils/integrations/fileLinkTargets.server"; import { auditFileEvent, logFileActivity } from "~/utils/integrations/fileAudit.server"; import { filesDetailPath, mediaVariantPath } from "~/utils/integrations/fileRoutePaths"; import { FileDetailPage } from "~/components/screens/files/FileDetailPage"; import ServerError from "~/components/ui/errors/ServerError"; import { useSaveToast } from "~/hooks/use-save-toast"; type LoaderData = { title: string; vm: FileDetailVM; filesHref: string; linkSearchHref: string }; type ActionData = { intent: string; ok?: true; messageKey?: string; error?: string }; const FILE_SUCCESS_KEYS: Readonly> = { link: "files.toast.linked", unlink: "files.toast.unlinked", rename: "files.toast.renamed", updateMeta: "files.toast.tagsSaved", archive: "files.toast.archived", reactivate: "files.toast.reactivated", regeneratePreview: "files.toast.previewRequested", }; const FILE_ENTITY_TYPES: FileEntityType[] = [ "contact", "company", "lead", "deal", "project", "user", "form_submission", "order", "task", "appointment", ]; export const loader = async ({ request, params }: LoaderFunctionArgs) => { const ctx = await loadFilesContext({ request, params, requireModule: true }); const fileId = params.id ?? ""; const tenantSlug = params.tenant ?? ""; let file, links; try { ({ file, links } = await getVisibleFileWithLinks(ctx.tenantId, fileId, ctx)); } catch { throw notFoundResponse(); } // Paging through the library happens from the detail view, so the neighbours // are resolved here rather than carried along in the URL. const neighbours = await findFileNeighbours({ tenantId: ctx.tenantId, ctx, fileId: file.id }); // A link that only says "Kontakt" names nothing; resolve what it points at. const linkLabels = await resolveFileLinkLabels({ tenantId: ctx.tenantId, links }); const linkedEntities: FileLinkedEntity[] = links.map((link) => ({ entityType: link.entityType, entityId: link.entityId, linkRole: link.linkRole, label: linkLabels.get(fileLinkKey(link.entityType, link.entityId)) ?? null, href: null, })); const vm = buildFileDetailVM({ id: file.id, displayName: file.displayName, mimeType: file.mimeType, sizeBytes: file.sizeBytes, createdAtIso: file.createdAt.toISOString(), tags: file.tags, notes: file.notes, source: file.source, previewStatus: file.previewStatus as never, scanStatus: file.scanStatus as never, previewUrl: file.previewStorageKey && file.previewStatus === "ready" ? mediaVariantPath(tenantSlug, file.id, "preview") : null, downloadUrl: mediaVariantPath(tenantSlug, file.id, "original"), assignedToUserId: file.assignedToUserId, linkedEntities, previousHref: neighbours.previousId ? filesDetailPath(tenantSlug, neighbours.previousId) : null, nextHref: neighbours.nextId ? filesDetailPath(tenantSlug, neighbours.nextId) : null, canWrite: ctx.permissions.includes("files.write"), canDelete: ctx.permissions.includes("files.delete"), canAdmin: ctx.permissions.includes("files.admin"), }); return Response.json({ title: `${file.displayName} | ${process.env.APP_NAME}`, vm, filesHref: `/${tenantSlug}/files`, linkSearchHref: `/${tenantSlug}/files/link-targets`, } satisfies LoaderData); }; export const action = async ({ request, params }: ActionFunctionArgs) => { const ctx = await loadFilesContext({ request, params, requireModule: true }); const fileId = params.id ?? ""; const tenantSlug = params.tenant ?? ""; const formData = await request.formData(); const intent = String(formData.get("intent") ?? ""); try { if (intent === "delete") { requireFilesPermission(ctx, "files.delete"); await getVisibleFileOrThrow(ctx.tenantId, fileId, ctx); await hardDeleteFile({ tenantId: ctx.tenantId, fileId }); await auditFileEvent({ ctx, action: "file.deleted", fileId }); return redirect(`/${tenantSlug}/files?toast=${encodeURIComponent("files.toast.deleted")}`); } requireFilesPermission(ctx, "files.write"); await getVisibleFileOrThrow(ctx.tenantId, fileId, ctx); if (intent === "link") { const entityType = String(formData.get("entityType") ?? "") as FileEntityType; const entityId = String(formData.get("entityId") ?? "").trim(); const linkRole = String(formData.get("linkRole") ?? "").trim() || null; if (!FILE_ENTITY_TYPES.includes(entityType) || !entityId) { throw badRequestResponse(); } await linkFile({ tenantId: ctx.tenantId, userId: ctx.userId, fileId, entityType, entityId, linkRole, ctx }); await auditFileEvent({ ctx, action: "file.linked", fileId, metadata: { entityType, entityId } }); await logFileActivity({ ctx, entityType, entityId, activityType: "file_uploaded", summaryText: "files.toast.linked", fileId }); return Response.json({ intent, ok: true, messageKey: FILE_SUCCESS_KEYS[intent] } satisfies ActionData); } if (intent === "unlink") { const entityType = String(formData.get("entityType") ?? "") as FileEntityType; const entityId = String(formData.get("entityId") ?? "").trim(); if (!FILE_ENTITY_TYPES.includes(entityType) || !entityId) { throw badRequestResponse(); } await unlinkFile({ tenantId: ctx.tenantId, fileId, entityType, entityId, ctx }); await auditFileEvent({ ctx, action: "file.unlinked", fileId, metadata: { entityType, entityId } }); return Response.json({ intent, ok: true, messageKey: FILE_SUCCESS_KEYS[intent] } satisfies ActionData); } if (intent === "rename") { // The title is edited in place in the header; an empty name would leave // the file without any handle at all, so it stays as it was. const displayName = String(formData.get("displayName") ?? "").trim(); if (!displayName) throw badRequestResponse(); await updateFileMeta({ tenantId: ctx.tenantId, fileId, displayName }); await auditFileEvent({ ctx, action: "file.updated", fileId, metadata: { renamed: true } }); return Response.json({ intent, ok: true, messageKey: FILE_SUCCESS_KEYS[intent] } satisfies ActionData); } if (intent === "updateMeta") { // Tags come in as a comma-separated list; normalize (trim, drop empties, // de-dupe, cap) into the String[] the File row stores. const tags = Array.from( new Set( String(formData.get("tags") ?? "") .split(",") .map((tag) => tag.trim()) .filter(Boolean), ), ).slice(0, 30); await updateFileMeta({ tenantId: ctx.tenantId, fileId, tags }); await auditFileEvent({ ctx, action: "file.updated", fileId, metadata: { tagsUpdated: true } }); return Response.json({ intent, ok: true, messageKey: FILE_SUCCESS_KEYS[intent] } satisfies ActionData); } if (intent === "archive") { await archiveFile({ tenantId: ctx.tenantId, fileId }); await auditFileEvent({ ctx, action: "file.archived", fileId }); } else if (intent === "reactivate") { await reactivateFile({ tenantId: ctx.tenantId, fileId }); await auditFileEvent({ ctx, action: "file.reactivated", fileId }); } else if (intent === "regeneratePreview") { await regenerateFilePreview({ tenantId: ctx.tenantId, fileId }); await auditFileEvent({ ctx, action: "file.updated", fileId, metadata: { previewRegenerated: true } }); } const messageKey = FILE_SUCCESS_KEYS[intent]; if (!messageKey) return Response.json({ intent, error: "files.error.invalidAction" } satisfies ActionData, { status: 400 }); return Response.json({ intent, ok: true, messageKey } satisfies ActionData); } catch (error) { if (error instanceof Response) throw error; throw notFoundResponse(); } }; export default function FileDetailRoute() { const { vm, filesHref, linkSearchHref } = useLoaderData(); const actionData = useActionData(); useSaveToast(actionData); if (vm.status !== "ready" || !vm.data) { return
; } return ; } export function ErrorBoundary() { return ; }