Files
HiveGrid-Wireframes/hivegrid-cloud/apps/web/app/routes/app.$tenant/files._index.tsx
T

154 lines
5.8 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.
//
// Baseline functional UI (data-ui-id markers for e2e); the Subframe visual polish
// follows Davids D-P4 delta (Dev-Nachzug).
import { type LoaderFunctionArgs, useLoaderData } from "react-router";
import { useTranslation } from "react-i18next";
import { buildFileBrowserVM, type FileBrowserRow, type FileBrowserVM } from "@toolctrl/view-models";
import { getTranslations } from "~/locale/i18next.server";
import { loadFilesContext, notFoundResponse, requireFilesPermission } from "~/utils/integrations/fileAccess.server";
import { listFilesForBrowser } from "~/utils/integrations/fileService.server";
import { mediaVariantPath, filesDetailPath } from "~/utils/integrations/fileRoutePaths";
import ServerError from "~/components/ui/errors/ServerError";
type LoaderData = { title: string; vm: FileBrowserVM };
export const loader = async ({ request, params }: LoaderFunctionArgs) => {
const { t } = await getTranslations(request);
const ctx = await loadFilesContext({ request, params });
const tenantSlug = params.tenant ?? "";
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 } 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 cursor = url.searchParams.get("cursor");
const { rows, nextCursor } = await listFilesForBrowser({
tenantId: ctx.tenantId,
ctx,
filter: { includeArchived, mimeGroup },
cursor,
});
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({
rows: browserRows,
filter: { entityType: null, mimeGroup, tags: [], assignedToUserId: null, includeArchived },
canWrite,
canDelete,
nextCursor,
});
return Response.json({ title: `${t("files.browser.title")} | ${process.env.APP_NAME}`, vm } satisfies LoaderData);
};
function formatBytes(bytes: number): string {
if (bytes < 1024) return `${bytes} B`;
const units = ["KB", "MB", "GB"];
let value = bytes / 1024;
let unitIndex = 0;
while (value >= 1024 && unitIndex < units.length - 1) {
value /= 1024;
unitIndex += 1;
}
return `${value.toFixed(1)} ${units[unitIndex]}`;
}
export default function FilesBrowserRoute() {
const { t, i18n } = useTranslation();
const { vm } = useLoaderData<LoaderData>();
if (vm.status !== "ready" || !vm.data) {
return <main className="mx-auto max-w-5xl px-4 py-10" data-ui-id="ui.files.browser" />;
}
const { rows, canWrite, emptyHeadlineKey, emptyBodyKey } = vm.data;
const dateFormatter = new Intl.DateTimeFormat(i18n.language, { dateStyle: "medium" });
return (
<main className="mx-auto max-w-5xl px-4 py-10" data-ui-id="ui.files.browser">
<div className="flex items-center justify-between">
<div>
<h1 className="text-foreground text-xl font-semibold">{t("files.browser.title")}</h1>
<p className="text-muted-foreground mt-1 text-sm">{t("files.browser.subtitle")}</p>
</div>
{canWrite ? (
<a href="upload" className="text-theme-600 font-medium" data-ui-id="ui.files.browser.upload">
{t("files.browser.actions.upload")}
</a>
) : null}
</div>
{rows.length === 0 ? (
<div className="mt-10 text-center" data-ui-id="ui.files.browser.empty">
<p className="text-foreground font-medium">{t(emptyHeadlineKey)}</p>
<p className="text-muted-foreground mt-1 text-sm">{t(emptyBodyKey)}</p>
</div>
) : (
<table className="mt-6 w-full text-left text-sm" data-ui-id="ui.files.browser.table">
<thead>
<tr className="text-muted-foreground border-b">
<th className="py-2">{t("files.browser.column.name")}</th>
<th className="py-2">{t("files.browser.column.size")}</th>
<th className="py-2">{t("files.browser.column.date")}</th>
</tr>
</thead>
<tbody>
{rows.map((row) => (
<tr key={row.id} className="border-b" data-row-id={row.id}>
<td className="py-2">
<a href={row.detailHref} className="text-theme-600">
{row.displayName}
</a>
</td>
<td className="py-2">{formatBytes(row.sizeBytes)}</td>
<td className="py-2">{dateFormatter.format(new Date(row.createdAtIso))}</td>
</tr>
))}
</tbody>
</table>
)}
</main>
);
}
export function ErrorBoundary() {
return <ServerError />;
}