/** * Phase 10 Task #67 — Tenant Compliance-Audit-Export. * * Per-tenant self-service variant of the admin audit-export. Identical * filter surface but tenantId-locked: a tenant admin can only see their * own AuditEvent rows. Used for SOC2-Type-II evidence collection by * tenants who need to deliver their own privileged-action report. */ import type { LoaderFunctionArgs } from "react-router"; import { useLoaderData } from "react-router"; import { useTranslation } from "react-i18next"; import { getDbClient } from "@toolctrl/db/client.server"; import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsService"; import { getTenantIdFromUrl } from "~/utils/services/.server/urlService"; import { getTranslations } from "~/locale/i18next.server"; import { useLocaleFormatters } from "~/locale/format"; import { AUDIT_EXPORT_MAX_ROWS, buildAuditExportWhere, computeAuditIntegritySummary, parseAuditExportFilters, renderAuditExportCsv, type AuditExportRow } from "~/routes/admin/audit-export.helpers.server"; import { buildAuditPdfLabels, renderAuditExportPdfResponse } from "~/utils/audit/pdfRender"; type LoaderData = { title: string; tenantSlug: string; defaultFrom: string; defaultTo: string; maxRows: number; }; export const loader = async ({ request, params }: LoaderFunctionArgs) => { const tenantId = await getTenantIdFromUrl(params); await verifyUserHasPermission(request, "app.settings.auditTrails.view", tenantId); const { t } = await getTranslations(request); const url = new URL(request.url); if (url.searchParams.get("export") === "csv") { return streamTenantAuditExport(tenantId, url); } if (url.searchParams.get("export") === "pdf" || url.searchParams.get("format") === "pdf") { return streamTenantAuditPdfExport(tenantId, url, t); } const today = new Date(); const fromDate = new Date(today); fromDate.setDate(fromDate.getDate() - 30); const data: LoaderData = { title: `${t("models.log.plural")} | ${process.env.APP_NAME}`, tenantSlug: params.tenant ?? "", defaultFrom: fromDate.toISOString().slice(0, 10), defaultTo: today.toISOString().slice(0, 10), maxRows: AUDIT_EXPORT_MAX_ROWS, }; return Response.json(data); }; async function streamTenantAuditExport(tenantId: string, url: URL): Promise { // Force tenantId scope onto the URL filters so a request that tries to // smuggle a different tenantId via query string is silently ignored. const filters = { ...parseAuditExportFilters(url), tenantId }; const db = getDbClient(); const rows = (await db.auditEvent.findMany({ where: buildAuditExportWhere(filters), orderBy: { createdAt: "asc" }, take: AUDIT_EXPORT_MAX_ROWS, })) as unknown as AuditExportRow[]; const integrity = computeAuditIntegritySummary(rows); const csv = renderAuditExportCsv(rows, integrity); return new Response(csv, { headers: { "Content-Type": "text/csv; charset=utf-8", "Content-Disposition": `attachment; filename="audit-export-${tenantId}-${url.searchParams.get("from") ?? "all"}_${url.searchParams.get("to") ?? "all"}.csv"`, "X-Audit-Chain-Status": integrity.ok ? "ok" : "broken", }, }); } async function streamTenantAuditPdfExport(tenantId: string, url: URL, t: Awaited>["t"]): Promise { const filters = { ...parseAuditExportFilters(url), tenantId }; const db = getDbClient(); const rows = (await db.auditEvent.findMany({ where: buildAuditExportWhere(filters), orderBy: { createdAt: "asc" }, take: AUDIT_EXPORT_MAX_ROWS, })) as unknown as AuditExportRow[]; const integrity = computeAuditIntegritySummary(rows); return renderAuditExportPdfResponse( { tenantId, filters, integrity, rows, labels: buildAuditPdfLabels(t), }, { filenamePrefix: "audit-export" } ); } export default function TenantAuditExportRoute() { const data = useLoaderData(); const { t } = useTranslation(["settings", "translations"]); const formatters = useLocaleFormatters(); return (

{t("translations:models.log.plural")}

{t( "auditExport.description", { tenantSlug: data.tenantSlug, maxRows: formatters.number(data.maxRows) }, )}

); }