147 lines
6.2 KiB
TypeScript
147 lines
6.2 KiB
TypeScript
// 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
|
|
// /<tenant>/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<LoaderData>();
|
|
const navigate = useNavigate();
|
|
const [selectedIds, setSelectedIds] = useState<string[]>([]);
|
|
|
|
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 (
|
|
<FilesBrowserPage
|
|
vm={vm}
|
|
uploadHref={uploadHref}
|
|
nextHref={nextHref}
|
|
bulkZipAction={bulkZipAction}
|
|
selectedIds={selectedIds}
|
|
actions={{ onApply, onToggleSelect, onToggleSelectAll }}
|
|
/>
|
|
);
|
|
}
|
|
|
|
export function ErrorBoundary() {
|
|
return <ServerError />;
|
|
}
|