/** * AK-P3 — Audit-Viewer (`/admin/audit`). * * Permission-gated (`admin.auditTrails.view`), server-side filtered list over the * tamper-evident `AuditEvent` table (NOT the legacy `Log` model used by * `/admin/audit-trails`). The loader builds the AuditListVM once (persisted * summaryText + field-by-field beforeDiff/afterDiff since the AK-P3 core schema * extension; derived summary + metadata fallback for legacy rows) and the route * renders the interim `` screen (AD-28). */ import type { LoaderFunctionArgs, MetaFunction } from "react-router"; import { useLoaderData, useNavigate } from "react-router"; import { listAuditEvents, AUDIT_VIEWER_DEFAULT_PAGE_SIZE } from "@hivegrid/db/audit-events-query.server"; import { buildAuditListVM, type AuditListVM, type AuditListFilterState } from "@hivegrid/view-models"; import { AuditListPage, type AuditListQuery } from "~/components/screens/audit/AuditListPage"; import ServerError from "~/components/ui/errors/ServerError"; import { getTranslations } from "~/locale/i18next.server"; import { adminPath } from "~/utils/app/CanonicalUrlUtils"; import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsService"; const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/; type LoaderData = { title: string; vm: AuditListVM; }; function parseFilters(url: URL): AuditListFilterState { const get = (k: string) => url.searchParams.get(k)?.trim() || null; const from = get("from"); const to = get("to"); return { from: from && ISO_DATE.test(from) ? from : null, to: to && ISO_DATE.test(to) ? to : null, actorType: get("actorType"), action: get("action"), outcome: get("outcome"), targetType: get("targetType"), }; } function buildWhere(filters: AuditListFilterState, tenantId: string | null): Record { const where: Record = {}; if (tenantId) where.tenantId = tenantId; if (filters.actorType) where.actorType = filters.actorType; if (filters.outcome) where.outcome = filters.outcome; if (filters.targetType) where.targetType = filters.targetType; if (filters.action) where.action = { contains: filters.action, mode: "insensitive" }; if (filters.from || filters.to) { const range: Record = {}; if (filters.from) range.gte = new Date(`${filters.from}T00:00:00.000Z`); if (filters.to) { const upper = new Date(`${filters.to}T00:00:00.000Z`); upper.setUTCDate(upper.getUTCDate() + 1); range.lt = upper; } where.createdAt = range; } return where; } export const loader = async ({ request }: LoaderFunctionArgs) => { await verifyUserHasPermission(request, "admin.auditTrails.view"); const { t } = await getTranslations(request); const url = new URL(request.url); const filters = parseFilters(url); const tenantId = url.searchParams.get("tenantId")?.trim() || null; const pageRaw = Number.parseInt(url.searchParams.get("page") ?? "1", 10); const page = Number.isFinite(pageRaw) && pageRaw > 0 ? pageRaw : 1; const pageSize = AUDIT_VIEWER_DEFAULT_PAGE_SIZE; // listAuditEvents lives in @hivegrid/db so the route stays free of findMany. const { rows, total, take } = await listAuditEvents({ where: buildWhere(filters, tenantId), take: pageSize, skip: pageSize * (page - 1), }); const vm = buildAuditListVM({ rows: rows.map((row) => ({ id: row.id, createdAtIso: row.createdAt.toISOString(), actorType: row.actorType, actorEmail: row.actorEmail, actorId: row.actorId, action: row.action, targetType: row.targetType, targetId: row.targetId, outcome: row.outcome, hasMetadata: row.metadata != null, metadata: row.metadata, beforeDiff: row.beforeDiff, afterDiff: row.afterDiff, summaryText: row.summaryText, })), filter: filters, pagination: { page, pageSize: take, total, totalPages: Math.max(1, Math.ceil(total / take)) }, canExport: true, }); const data: LoaderData = { title: `${t("settings:audit.viewer.title")} | ${process.env.APP_NAME}`, vm, }; return data; }; export const meta: MetaFunction = ({ data }) => [{ title: data?.title }]; export default function AuditViewerRoute() { const { vm } = useLoaderData(); const navigate = useNavigate(); function onApply(query: AuditListQuery) { const params = new URLSearchParams(); if (query.from) params.set("from", query.from); if (query.to) params.set("to", query.to); if (query.actorType) params.set("actorType", query.actorType); if (query.action) params.set("action", query.action); if (query.outcome) params.set("outcome", query.outcome); if (query.targetType) params.set("targetType", query.targetType); if (query.page > 1) params.set("page", String(query.page)); navigate({ search: params.toString() ? `?${params.toString()}` : "" }); } // Canonical admin-host link (host-aware alias, e.g. /audit-export) — matches // how every other admin surface links internally. return ; } export function ErrorBoundary() { return ; }