Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/web/app/routes/app.$tenant/files.$id.tsx
T

208 lines
9.1 KiB
TypeScript

// 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<Record<string, string>> = {
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<LoaderData>();
const actionData = useActionData<ActionData>();
useSaveToast(actionData);
if (vm.status !== "ready" || !vm.data) {
return <div className="flex w-full flex-col gap-6 p-6" data-ui-id="ui.files.detail" />;
}
return <FileDetailPage data={vm.data} entityTypes={FILE_ENTITY_TYPES} filesHref={filesHref} linkSearchHref={linkSearchHref} />;
}
export function ErrorBoundary() {
return <ServerError />;
}