208 lines
9.1 KiB
TypeScript
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 />;
|
|
}
|