@open-mercato/core 0.7.1-develop.7178.1.ab93fbaf4e → 0.7.1-develop.7180.1.9717fbbb43

package/dist/modules/staff/lib/timesheets-reports/buildReportSheet.js

@@ -0,0 +1,63 @@
+import { loadReportData } from "./loadReportData.js";
+import { normalizeReportGrouping } from "./reportGroupings.js";
+import {
+  computeReportTotals,
+  resolveReportCurrency
+} from "./reportTotals.js";
+function toDate(value, fallback) {
+  if (value instanceof Date && !Number.isNaN(value.getTime())) return value;
+  if (typeof value === "string") {
+    const parsed = new Date(value);
+    if (!Number.isNaN(parsed.getTime())) return parsed;
+  }
+  return fallback;
+}
+async function buildReportSheet(input) {
+  const { em, scope, report, labels } = input;
+  const isClosed = report.status === "closed";
+  const grouping = normalizeReportGrouping(input.grouping ?? report.grouping);
+  const nonbillableMode = report.nonbillableMode;
+  const data = await loadReportData({
+    em,
+    scope,
+    timeProjectIds: input.timeProjectIds,
+    periodFrom: toDate(report.periodFrom, /* @__PURE__ */ new Date(0)),
+    periodTo: toDate(report.periodTo, /* @__PURE__ */ new Date())
+  });
+  const entries = isClosed ? data.entries.filter((entry) => entry.frozen?.reportId === report.id) : data.entries;
+  const totals = computeReportTotals({
+    entries,
+    projects: data.projects,
+    directory: data.directory,
+    options: {
+      grouping,
+      nonbillableMode,
+      includeAlreadyReported: report.includeAlreadyReported ?? false
+    },
+    currentReportId: report.id,
+    labels
+  });
+  const currency = resolveReportCurrency(
+    data.projects.map((project) => ({
+      id: project.id,
+      name: project.name,
+      currencyCode: project.currencyCode
+    }))
+  );
+  return {
+    totals,
+    entries,
+    projects: data.projects,
+    directory: data.directory,
+    // A closed report keeps the currency it was closed with, even if a project
+    // has since been relabelled (risk R11).
+    currencyCode: isClosed ? report.currencyCode : currency.ok ? currency.currencyCode : report.currencyCode,
+    grouping,
+    nonbillableMode,
+    isClosed
+  };
+}
+export {
+  buildReportSheet
+};
+//# sourceMappingURL=buildReportSheet.js.map

package/dist/modules/staff/lib/timesheets-reports/buildReportSheet.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/buildReportSheet.ts"],
+  "sourcesContent": ["/**\n * The sheet of screen 14, built once and reused by the detail page, the exports\n * and the close command.\n *\n * The one rule that matters here is the difference between a draft and a closed\n * report:\n *\n *  - a **draft** is computed live, so it moves when an entry is edited or the\n *    rounding rule changes \u2014 by design, and screen 16 says so;\n *  - a **closed** report renders exactly what it froze. Its lines come from the\n *    `staff_time_report_entries` snapshots, so a later rounding change, a rate\n *    change or an unlocked-and-edited entry cannot restate an invoice a client\n *    already holds (risk R1).\n *\n * Both paths go through the same `computeReportTotals`, which is what keeps the\n * preview, the sheet and the freeze records arithmetically identical.\n */\n\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport type { StaffTimeReport } from '../../data/entities'\nimport { loadReportData, type ReportDataScope } from './loadReportData'\nimport { normalizeReportGrouping } from './reportGroupings'\nimport {\n  computeReportTotals,\n  resolveReportCurrency,\n  type ReportDirectory,\n  type ReportGrouping,\n  type ReportInputEntry,\n  type ReportInputProject,\n  type ReportNonBillableMode,\n  type ReportTotals,\n} from './reportTotals'\n\nexport type ReportSheetLabels = {\n  unassignedTask: string\n  unassignedPerson: string\n  nonbillableGroup: string\n}\n\nexport type BuildReportSheetInput = {\n  em: EntityManager\n  scope: ReportDataScope\n  report: StaffTimeReport\n  timeProjectIds: readonly string[]\n  labels: ReportSheetLabels\n  /** Overrides the report's stored grouping, for an export that re-groups. */\n  grouping?: ReportGrouping\n}\n\nexport type ReportSheet = {\n  totals: ReportTotals\n  entries: ReportInputEntry[]\n  projects: ReportInputProject[]\n  directory: ReportDirectory\n  currencyCode: string | null\n  grouping: ReportGrouping\n  nonbillableMode: ReportNonBillableMode\n  isClosed: boolean\n}\n\nfunction toDate(value: Date | string | null | undefined, fallback: Date): Date {\n  if (value instanceof Date && !Number.isNaN(value.getTime())) return value\n  if (typeof value === 'string') {\n    const parsed = new Date(value)\n    if (!Number.isNaN(parsed.getTime())) return parsed\n  }\n  return fallback\n}\n\nexport async function buildReportSheet(input: BuildReportSheetInput): Promise<ReportSheet> {\n  const { em, scope, report, labels } = input\n  const isClosed = report.status === 'closed'\n  const grouping = normalizeReportGrouping(input.grouping ?? report.grouping)\n  const nonbillableMode = report.nonbillableMode as ReportNonBillableMode\n\n  const data = await loadReportData({\n    em,\n    scope,\n    timeProjectIds: input.timeProjectIds,\n    periodFrom: toDate(report.periodFrom, new Date(0)),\n    periodTo: toDate(report.periodTo, new Date()),\n  })\n\n  // A closed report shows only what it froze. An entry logged into the period\n  // AFTER the report closed is genuinely new work and belongs to the next\n  // report \u2014 screen 15 note 2 is explicit that the lock covers entries, not\n  // tasks, so logging more time on the same task must stay possible.\n  const entries = isClosed\n    ? data.entries.filter((entry) => entry.frozen?.reportId === report.id)\n    : data.entries\n\n  const totals = computeReportTotals({\n    entries,\n    projects: data.projects,\n    directory: data.directory,\n    options: {\n      grouping,\n      nonbillableMode,\n      includeAlreadyReported: report.includeAlreadyReported ?? false,\n    },\n    currentReportId: report.id,\n    labels,\n  })\n\n  const currency = resolveReportCurrency(\n    data.projects.map((project) => ({\n      id: project.id,\n      name: project.name,\n      currencyCode: project.currencyCode,\n    })),\n  )\n\n  return {\n    totals,\n    entries,\n    projects: data.projects,\n    directory: data.directory,\n    // A closed report keeps the currency it was closed with, even if a project\n    // has since been relabelled (risk R11).\n    currencyCode: isClosed ? report.currencyCode : currency.ok ? currency.currencyCode : report.currencyCode,\n    grouping,\n    nonbillableMode,\n    isClosed,\n  }\n}\n"],
+  "mappings": "AAoBA,SAAS,sBAA4C;AACrD,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,EACA;AAAA,OAOK;AA6BP,SAAS,OAAO,OAAyC,UAAsB;AAC7E,MAAI,iBAAiB,QAAQ,CAAC,OAAO,MAAM,MAAM,QAAQ,CAAC,EAAG,QAAO;AACpE,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,SAAS,IAAI,KAAK,KAAK;AAC7B,QAAI,CAAC,OAAO,MAAM,OAAO,QAAQ,CAAC,EAAG,QAAO;AAAA,EAC9C;AACA,SAAO;AACT;AAEA,eAAsB,iBAAiB,OAAoD;AACzF,QAAM,EAAE,IAAI,OAAO,QAAQ,OAAO,IAAI;AACtC,QAAM,WAAW,OAAO,WAAW;AACnC,QAAM,WAAW,wBAAwB,MAAM,YAAY,OAAO,QAAQ;AAC1E,QAAM,kBAAkB,OAAO;AAE/B,QAAM,OAAO,MAAM,eAAe;AAAA,IAChC;AAAA,IACA;AAAA,IACA,gBAAgB,MAAM;AAAA,IACtB,YAAY,OAAO,OAAO,YAAY,oBAAI,KAAK,CAAC,CAAC;AAAA,IACjD,UAAU,OAAO,OAAO,UAAU,oBAAI,KAAK,CAAC;AAAA,EAC9C,CAAC;AAMD,QAAM,UAAU,WACZ,KAAK,QAAQ,OAAO,CAAC,UAAU,MAAM,QAAQ,aAAa,OAAO,EAAE,IACnE,KAAK;AAET,QAAM,SAAS,oBAAoB;AAAA,IACjC;AAAA,IACA,UAAU,KAAK;AAAA,IACf,WAAW,KAAK;AAAA,IAChB,SAAS;AAAA,MACP;AAAA,MACA;AAAA,MACA,wBAAwB,OAAO,0BAA0B;AAAA,IAC3D;AAAA,IACA,iBAAiB,OAAO;AAAA,IACxB;AAAA,EACF,CAAC;AAED,QAAM,WAAW;AAAA,IACf,KAAK,SAAS,IAAI,CAAC,aAAa;AAAA,MAC9B,IAAI,QAAQ;AAAA,MACZ,MAAM,QAAQ;AAAA,MACd,cAAc,QAAQ;AAAA,IACxB,EAAE;AAAA,EACJ;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAU,KAAK;AAAA,IACf,WAAW,KAAK;AAAA;AAAA;AAAA,IAGhB,cAAc,WAAW,OAAO,eAAe,SAAS,KAAK,SAAS,eAAe,OAAO;AAAA,IAC5F;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/staff/lib/timesheets-reports/loadReportData.js

@@ -0,0 +1,170 @@
+import { findWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import {
+  StaffTeamMember,
+  StaffTimeEntry,
+  StaffTimeProject,
+  StaffTimeReport,
+  StaffTimeReportEntry,
+  StaffTimeTask
+} from "../../data/entities.js";
+function toNumberOrNull(value) {
+  if (value === null || value === void 0) return null;
+  const parsed = typeof value === "number" ? value : Number.parseFloat(String(value));
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function toIsoDate(value) {
+  if (!value) return "";
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return "";
+    const year = value.getFullYear();
+    const month = String(value.getMonth() + 1).padStart(2, "0");
+    const day = String(value.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+  }
+  return String(value).slice(0, 10);
+}
+function resolveRootTaskId(taskId, parentById) {
+  if (!taskId) return null;
+  const parent = parentById.get(taskId);
+  if (!parent) return taskId;
+  return parent;
+}
+async function loadReportData(input) {
+  const { em, scope, periodFrom, periodTo } = input;
+  const projectIds = Array.from(new Set(input.timeProjectIds.filter((id) => typeof id === "string" && id.length > 0)));
+  if (projectIds.length === 0) {
+    return {
+      projects: [],
+      entries: [],
+      directory: { taskLabelById: {}, personLabelById: {} },
+      projectRows: []
+    };
+  }
+  const projectRows = await em.find(StaffTimeProject, {
+    id: { $in: projectIds },
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    deletedAt: null
+  });
+  const entryRows = await em.find(StaffTimeEntry, {
+    timeProjectId: { $in: projectIds },
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    deletedAt: null,
+    date: { $gte: periodFrom, $lte: periodTo }
+  });
+  const taskIds = Array.from(
+    new Set(entryRows.map((entry) => entry.taskId).filter((id) => typeof id === "string" && id.length > 0))
+  );
+  const taskRows = taskIds.length > 0 ? await em.find(StaffTimeTask, {
+    id: { $in: taskIds },
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId
+  }) : [];
+  const parentIds = Array.from(
+    new Set(
+      taskRows.map((task) => task.parentTaskId).filter((id) => typeof id === "string" && id.length > 0 && !taskIds.includes(id))
+    )
+  );
+  const parentRows = parentIds.length > 0 ? await em.find(StaffTimeTask, {
+    id: { $in: parentIds },
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId
+  }) : [];
+  const parentById = /* @__PURE__ */ new Map();
+  const taskLabelById = {};
+  for (const task of [...taskRows, ...parentRows]) {
+    parentById.set(task.id, task.parentTaskId ?? null);
+    taskLabelById[task.id] = task.title;
+  }
+  const staffMemberIds = Array.from(
+    new Set(
+      entryRows.map((entry) => entry.staffMemberId).filter((id) => typeof id === "string" && id.length > 0)
+    )
+  );
+  const memberRows = staffMemberIds.length > 0 ? await findWithDecryption(
+    em,
+    StaffTeamMember,
+    {
+      id: { $in: staffMemberIds },
+      tenantId: scope.tenantId,
+      organizationId: scope.organizationId
+    },
+    {},
+    scope
+  ) : [];
+  const personLabelById = {};
+  for (const member of memberRows) personLabelById[member.id] = member.displayName;
+  const frozenByEntryId = await loadFrozenValues(
+    em,
+    scope,
+    entryRows.map((entry) => entry.id)
+  );
+  const entries = entryRows.map((entry) => ({
+    id: entry.id,
+    timeProjectId: entry.timeProjectId ?? "",
+    taskId: entry.taskId ?? null,
+    rootTaskId: resolveRootTaskId(entry.taskId ?? null, parentById),
+    staffMemberId: entry.staffMemberId ?? null,
+    date: toIsoDate(entry.date),
+    durationMinutes: entry.durationMinutes ?? 0,
+    roundedMinutes: entry.roundedMinutes ?? null,
+    isBillable: entry.isBillable ?? true,
+    rateOverrideAmount: toNumberOrNull(entry.rateOverrideAmount),
+    description: entry.notes ?? null,
+    frozen: frozenByEntryId.get(entry.id) ?? null
+  }));
+  const projects = projectRows.map((project) => ({
+    id: project.id,
+    name: project.name,
+    hourlyRate: toNumberOrNull(project.hourlyRate),
+    currencyCode: project.currencyCode ?? null
+  }));
+  return {
+    projects,
+    entries,
+    directory: { taskLabelById, personLabelById },
+    projectRows
+  };
+}
+async function loadFrozenValues(em, scope, timeEntryIds) {
+  const ids = Array.from(new Set(timeEntryIds.filter((id) => typeof id === "string" && id.length > 0)));
+  const result = /* @__PURE__ */ new Map();
+  if (ids.length === 0) return result;
+  const rows = await em.find(StaffTimeReportEntry, {
+    timeEntryId: { $in: ids },
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId
+  });
+  if (rows.length === 0) return result;
+  const reportIds = Array.from(new Set(rows.map((row) => row.reportId)));
+  const reports = await em.find(StaffTimeReport, {
+    id: { $in: reportIds },
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    status: "closed",
+    deletedAt: null
+  });
+  const reportById = new Map(reports.map((report) => [report.id, report]));
+  for (const row of rows) {
+    const report = reportById.get(row.reportId);
+    if (!report) continue;
+    result.set(row.timeEntryId, {
+      reportId: report.id,
+      reference: report.reference ?? null,
+      title: report.title ?? null,
+      rawMinutes: row.frozenRawMinutes ?? 0,
+      roundedMinutes: row.frozenRoundedMinutes ?? 0,
+      rateAmount: toNumberOrNull(row.frozenRateAmount),
+      currencyCode: row.frozenCurrencyCode ?? null,
+      amount: toNumberOrNull(row.frozenAmount),
+      isBillable: row.frozenIsBillable ?? true
+    });
+  }
+  return result;
+}
+export {
+  loadFrozenValues,
+  loadReportData
+};
+//# sourceMappingURL=loadReportData.js.map

package/dist/modules/staff/lib/timesheets-reports/loadReportData.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/loadReportData.ts"],
+  "sourcesContent": ["/**\n * The one read that feeds every report surface: the live preview of screen 13,\n * the sheet of screen 14, the close command's freeze records and the exports.\n *\n * It is deliberately a single loader rather than one query per surface, because\n * a preview that counts different hours from the sheet it generates \u2014 or from\n * the snapshot the close writes \u2014 is the failure mode this whole phase exists to\n * prevent. Everything downstream consumes the same `ReportInputEntry[]`.\n *\n * Scoping is not optional here: every query carries `tenantId` and\n * `organizationId`, and the project ids are expected to have been narrowed by\n * `resolveProjectAccess` before they arrive.\n */\n\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport {\n  StaffTeamMember,\n  StaffTimeEntry,\n  StaffTimeProject,\n  StaffTimeReport,\n  StaffTimeReportEntry,\n  StaffTimeTask,\n} from '../../data/entities'\nimport type { FrozenEntryValues, ReportDirectory, ReportInputEntry, ReportInputProject } from './reportTotals'\n\nexport type ReportDataScope = {\n  tenantId: string\n  organizationId: string\n}\n\nexport type LoadReportDataInput = {\n  em: EntityManager\n  scope: ReportDataScope\n  timeProjectIds: readonly string[]\n  periodFrom: Date\n  periodTo: Date\n}\n\nexport type ReportData = {\n  projects: ReportInputProject[]\n  entries: ReportInputEntry[]\n  directory: ReportDirectory\n  /** Raw project rows, kept so callers can assert currency without a second read. */\n  projectRows: StaffTimeProject[]\n}\n\nfunction toNumberOrNull(value: unknown): number | null {\n  if (value === null || value === undefined) return null\n  const parsed = typeof value === 'number' ? value : Number.parseFloat(String(value))\n  return Number.isFinite(parsed) ? parsed : null\n}\n\nfunction toIsoDate(value: Date | string | null | undefined): string {\n  if (!value) return ''\n  if (value instanceof Date) {\n    if (Number.isNaN(value.getTime())) return ''\n    const year = value.getFullYear()\n    const month = String(value.getMonth() + 1).padStart(2, '0')\n    const day = String(value.getDate()).padStart(2, '0')\n    return `${year}-${month}-${day}`\n  }\n  return String(value).slice(0, 10)\n}\n\n/**\n * D-2 caps nesting at one level, so a task's root is either itself or its\n * parent. The fallback to the task's own id keeps a line visible even if a\n * parent row has since been hard-removed.\n */\nfunction resolveRootTaskId(taskId: string | null, parentById: ReadonlyMap<string, string | null>): string | null {\n  if (!taskId) return null\n  const parent = parentById.get(taskId)\n  if (!parent) return taskId\n  return parent\n}\n\nexport async function loadReportData(input: LoadReportDataInput): Promise<ReportData> {\n  const { em, scope, periodFrom, periodTo } = input\n  const projectIds = Array.from(new Set(input.timeProjectIds.filter((id) => typeof id === 'string' && id.length > 0)))\n  if (projectIds.length === 0) {\n    return {\n      projects: [],\n      entries: [],\n      directory: { taskLabelById: {}, personLabelById: {} },\n      projectRows: [],\n    }\n  }\n\n  const projectRows = await em.find(StaffTimeProject, {\n    id: { $in: projectIds },\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n    deletedAt: null,\n  })\n\n  const entryRows = await em.find(StaffTimeEntry, {\n    timeProjectId: { $in: projectIds },\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n    deletedAt: null,\n    date: { $gte: periodFrom, $lte: periodTo },\n  })\n\n  const taskIds = Array.from(\n    new Set(entryRows.map((entry) => entry.taskId).filter((id): id is string => typeof id === 'string' && id.length > 0)),\n  )\n  const taskRows =\n    taskIds.length > 0\n      ? await em.find(StaffTimeTask, {\n          id: { $in: taskIds },\n          tenantId: scope.tenantId,\n          organizationId: scope.organizationId,\n        })\n      : []\n\n  // A child task's parent is not necessarily among the entries' tasks, so the\n  // parents are fetched in a second pass to give the rolled-up line its label.\n  const parentIds = Array.from(\n    new Set(\n      taskRows\n        .map((task) => task.parentTaskId)\n        .filter((id): id is string => typeof id === 'string' && id.length > 0 && !taskIds.includes(id)),\n    ),\n  )\n  const parentRows =\n    parentIds.length > 0\n      ? await em.find(StaffTimeTask, {\n          id: { $in: parentIds },\n          tenantId: scope.tenantId,\n          organizationId: scope.organizationId,\n        })\n      : []\n\n  const parentById = new Map<string, string | null>()\n  const taskLabelById: Record<string, string> = {}\n  for (const task of [...taskRows, ...parentRows]) {\n    parentById.set(task.id, task.parentTaskId ?? null)\n    taskLabelById[task.id] = task.title\n  }\n\n  const staffMemberIds = Array.from(\n    new Set(\n      entryRows\n        .map((entry) => entry.staffMemberId)\n        .filter((id): id is string => typeof id === 'string' && id.length > 0),\n    ),\n  )\n  const memberRows =\n    staffMemberIds.length > 0\n      ? await findWithDecryption(\n          em,\n          StaffTeamMember,\n          {\n            id: { $in: staffMemberIds },\n            tenantId: scope.tenantId,\n            organizationId: scope.organizationId,\n          },\n          {},\n          scope,\n        )\n      : []\n  const personLabelById: Record<string, string> = {}\n  for (const member of memberRows) personLabelById[member.id] = member.displayName\n\n  const frozenByEntryId = await loadFrozenValues(\n    em,\n    scope,\n    entryRows.map((entry) => entry.id),\n  )\n\n  const entries: ReportInputEntry[] = entryRows.map((entry) => ({\n    id: entry.id,\n    timeProjectId: entry.timeProjectId ?? '',\n    taskId: entry.taskId ?? null,\n    rootTaskId: resolveRootTaskId(entry.taskId ?? null, parentById),\n    staffMemberId: entry.staffMemberId ?? null,\n    date: toIsoDate(entry.date),\n    durationMinutes: entry.durationMinutes ?? 0,\n    roundedMinutes: entry.roundedMinutes ?? null,\n    isBillable: entry.isBillable ?? true,\n    rateOverrideAmount: toNumberOrNull(entry.rateOverrideAmount),\n    description: entry.notes ?? null,\n    frozen: frozenByEntryId.get(entry.id) ?? null,\n  }))\n\n  const projects: ReportInputProject[] = projectRows.map((project) => ({\n    id: project.id,\n    name: project.name,\n    hourlyRate: toNumberOrNull(project.hourlyRate),\n    currencyCode: project.currencyCode ?? null,\n  }))\n\n  return {\n    projects,\n    entries,\n    directory: { taskLabelById, personLabelById },\n    projectRows,\n  }\n}\n\n/**\n * D-5's indexed lookup. `staff_time_report_entries` is authoritative for \"has\n * this hour been billed already?\", and only rows belonging to a **closed**\n * report count: a freeze record left behind by a report that has since been\n * unlocked must not keep an hour out of the next invoice.\n */\nexport async function loadFrozenValues(\n  em: EntityManager,\n  scope: ReportDataScope,\n  timeEntryIds: readonly string[],\n): Promise<Map<string, FrozenEntryValues>> {\n  const ids = Array.from(new Set(timeEntryIds.filter((id) => typeof id === 'string' && id.length > 0)))\n  const result = new Map<string, FrozenEntryValues>()\n  if (ids.length === 0) return result\n\n  const rows = await em.find(StaffTimeReportEntry, {\n    timeEntryId: { $in: ids },\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n  })\n  if (rows.length === 0) return result\n\n  const reportIds = Array.from(new Set(rows.map((row) => row.reportId)))\n  const reports = await em.find(StaffTimeReport, {\n    id: { $in: reportIds },\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n    status: 'closed',\n    deletedAt: null,\n  })\n  const reportById = new Map(reports.map((report) => [report.id, report]))\n\n  for (const row of rows) {\n    const report = reportById.get(row.reportId)\n    if (!report) continue\n    result.set(row.timeEntryId, {\n      reportId: report.id,\n      reference: report.reference ?? null,\n      title: report.title ?? null,\n      rawMinutes: row.frozenRawMinutes ?? 0,\n      roundedMinutes: row.frozenRoundedMinutes ?? 0,\n      rateAmount: toNumberOrNull(row.frozenRateAmount),\n      currencyCode: row.frozenCurrencyCode ?? null,\n      amount: toNumberOrNull(row.frozenAmount),\n      isBillable: row.frozenIsBillable ?? true,\n    })\n  }\n\n  return result\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/staff/lib/timesheets-reports/pdf.js

@@ -0,0 +1,205 @@
+const PDF_CONTENT_TYPE = "application/pdf";
+const PAGE_WIDTH = 595.28;
+const PAGE_HEIGHT = 841.89;
+const MARGIN_X = 42;
+const MARGIN_TOP = 56;
+const MARGIN_BOTTOM = 48;
+const LINE_HEIGHT = 14;
+const DEFAULT_SIZE = 9;
+const DIFFERENCE_GLYPHS = [
+  ["\u0105", 1, "aogonek"],
+  ["\u0107", 2, "cacute"],
+  ["\u0119", 3, "eogonek"],
+  ["\u0142", 4, "lslash"],
+  ["\u0144", 5, "nacute"],
+  ["\u015B", 6, "sacute"],
+  ["\u017A", 7, "zacute"],
+  ["\u017C", 8, "zdotaccent"],
+  ["\u0104", 9, "Aogonek"],
+  ["\u0106", 10, "Cacute"],
+  ["\u0118", 11, "Eogonek"],
+  ["\u0141", 12, "Lslash"],
+  ["\u0143", 13, "Nacute"],
+  ["\u015A", 14, "Sacute"],
+  ["\u0179", 15, "Zacute"],
+  ["\u017B", 16, "Zdotaccent"]
+];
+const WIN_ANSI_EXTRAS = {
+  "\xF3": 243,
+  "\xD3": 211,
+  "\xE9": 233,
+  "\xE8": 232,
+  "\xE4": 228,
+  "\xF6": 246,
+  "\xFC": 252,
+  "\xDF": 223,
+  "\xE1": 225,
+  "\xED": 237,
+  "\xF1": 241,
+  "\xFA": 250,
+  "\u2013": 150,
+  "\u2014": 151,
+  "\xB7": 183,
+  "\u20AC": 128,
+  "\u201E": 132,
+  "\u201D": 148,
+  "\u2019": 146,
+  "\u2018": 145,
+  "\u2026": 133,
+  "\xB0": 176,
+  "\xD7": 215
+};
+const ENCODING_MAP = (() => {
+  const map = /* @__PURE__ */ new Map();
+  for (let code = 32; code <= 126; code += 1) map.set(String.fromCharCode(code), code);
+  for (const [char, code] of Object.entries(WIN_ANSI_EXTRAS)) map.set(char, code);
+  for (const [char, code] of DIFFERENCE_GLYPHS) map.set(char, code);
+  return map;
+})();
+function encodePdfText(value) {
+  let out = "";
+  for (const char of value) {
+    const code = ENCODING_MAP.get(char) ?? 63;
+    const byte = String.fromCharCode(code);
+    if (byte === "(" || byte === ")" || byte === "\\") out += `\\${byte}`;
+    else out += byte;
+  }
+  return out;
+}
+const HELVETICA_WIDTHS = (() => {
+  const widths = {};
+  const groups = [
+    [278, " !I|jltfi.,:;'`"],
+    [355, '"'],
+    [556, "#$0123456789+<=>~"],
+    [889, "%"],
+    [667, "&BCDEHKNRSUVXY"],
+    [333, "()[]{}/\\*-r"],
+    [584, "^"],
+    [500, "?_"],
+    [1015, "@"],
+    [722, "ADGHOQ"],
+    [611, "FPZ"],
+    [944, "M"],
+    [778, "W"],
+    [556, "abcdeghknopqsu"],
+    [222, "i"],
+    [500, "yvz"],
+    [833, "m"],
+    [722, "w"],
+    [333, "JLT"]
+  ];
+  for (const [width, chars] of groups) {
+    for (const char of chars) widths[char] = width;
+  }
+  return widths;
+})();
+function measureText(text, size, bold) {
+  let units = 0;
+  for (const char of text) units += HELVETICA_WIDTHS[char] ?? 556;
+  const factor = bold ? 1.03 : 1;
+  return units / 1e3 * size * factor;
+}
+function buildPages(input) {
+  const pages = [];
+  let current = [];
+  let y = PAGE_HEIGHT - MARGIN_TOP;
+  const pushPage = () => {
+    if (current.length > 0) pages.push(current);
+    current = [];
+    y = PAGE_HEIGHT - MARGIN_TOP;
+  };
+  for (const line of input.lines) {
+    const height = line.kind === "space" ? line.height : LINE_HEIGHT;
+    if (y - height < MARGIN_BOTTOM) pushPage();
+    if (line.kind === "space") {
+      y -= line.height;
+      continue;
+    }
+    if (line.kind === "rule") {
+      current.push(
+        `0.8 0.8 0.8 RG 0.5 w ${MARGIN_X} ${(y - 4).toFixed(2)} m ${(PAGE_WIDTH - MARGIN_X).toFixed(2)} ${(y - 4).toFixed(2)} l S`
+      );
+      y -= LINE_HEIGHT;
+      continue;
+    }
+    for (const cell of line.cells) {
+      const size = cell.size ?? DEFAULT_SIZE;
+      const font = cell.bold ? "/F2" : "/F1";
+      const width = measureText(cell.text, size, cell.bold === true);
+      const x = cell.align === "right" ? cell.x - width : cell.x;
+      const colour = cell.muted ? "0.45 0.45 0.45 rg" : "0 0 0 rg";
+      current.push(
+        `BT ${colour} ${font} ${size} Tf 1 0 0 1 ${x.toFixed(2)} ${y.toFixed(2)} Tm (${encodePdfText(cell.text)}) Tj ET`
+      );
+    }
+    y -= LINE_HEIGHT;
+  }
+  pushPage();
+  return pages.length > 0 ? pages : [[]];
+}
+function buildPdf(input) {
+  const pages = buildPages(input);
+  const objects = [];
+  const differences = DIFFERENCE_GLYPHS.map(([, code, glyph]) => `${code} /${glyph}`).join(" ");
+  const pageObjectStart = 6;
+  const pageIds = pages.map((_, index) => pageObjectStart + index * 2);
+  objects[1] = "<< /Type /Catalog /Pages 2 0 R >>";
+  objects[2] = `<< /Type /Pages /Kids [${pageIds.map((id) => `${id} 0 R`).join(" ")}] /Count ${pages.length} >>`;
+  objects[3] = "<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica /Encoding 5 0 R >>";
+  objects[4] = "<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica-Bold /Encoding 5 0 R >>";
+  objects[5] = `<< /Type /Encoding /BaseEncoding /WinAnsiEncoding /Differences [${differences}] >>`;
+  pages.forEach((content, index) => {
+    const pageId = pageIds[index];
+    const contentId = pageId + 1;
+    const stream = content.join("\n");
+    objects[pageId] = `<< /Type /Page /Parent 2 0 R /MediaBox [0 0 ${PAGE_WIDTH} ${PAGE_HEIGHT}] /Resources << /Font << /F1 3 0 R /F2 4 0 R >> >> /Contents ${contentId} 0 R >>`;
+    objects[contentId] = `<< /Length ${Buffer.byteLength(stream, "latin1")} >>
+stream
+${stream}
+endstream`;
+  });
+  const chunks = [Buffer.from("%PDF-1.4\n", "latin1")];
+  let offset = chunks[0].length;
+  const offsets = [];
+  for (let id = 1; id < objects.length; id += 1) {
+    const body = objects[id];
+    if (body === void 0) continue;
+    offsets[id] = offset;
+    const chunk = Buffer.from(`${id} 0 obj
+${body}
+endobj
+`, "latin1");
+    chunks.push(chunk);
+    offset += chunk.length;
+  }
+  const maxId = objects.length;
+  const xrefOffset = offset;
+  const xrefRows = ["0000000000 65535 f \n"];
+  for (let id = 1; id < maxId; id += 1) {
+    const at = offsets[id];
+    xrefRows.push(at === void 0 ? "0000000000 65535 f \n" : `${String(at).padStart(10, "0")} 00000 n 
+`);
+  }
+  chunks.push(
+    Buffer.from(
+      `xref
+0 ${maxId}
+${xrefRows.join("")}trailer
+<< /Size ${maxId} /Root 1 0 R >>
+startxref
+${xrefOffset}
+%%EOF
+`,
+      "latin1"
+    )
+  );
+  return Buffer.concat(chunks);
+}
+export {
+  PDF_CONTENT_TYPE,
+  buildPdf,
+  encodePdfText,
+  measureText
+};
+//# sourceMappingURL=pdf.js.map

package/dist/modules/staff/lib/timesheets-reports/pdf.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/pdf.ts"],
+  "sourcesContent": ["/**\n * A minimal, dependency-free PDF writer \u2014 just enough to print the report sheet\n * of screen 14 as the client-facing document US-G4 asks for.\n *\n * The repository has no PDF library and adding a production dependency is an\n * \"ask first\" change, so this emits PDF 1.4 directly: a catalog, a pages tree,\n * two base-14 fonts and one content stream per page. Nothing here is a general\n * PDF toolkit; it lays out left-aligned and right-aligned text runs on a fixed\n * grid, which is exactly what a table of hours and amounts needs.\n *\n * **Polish text is the reason for the encoding work.** The mockups are Polish\n * and a report is a client-facing document, so `\u0105 \u0107 \u0119 \u0142 \u0144 \u015B \u017A \u017C` must survive.\n * WinAnsiEncoding covers `\u00F3`/`\u00D3` and nothing else Polish, so the remaining\n * sixteen glyphs are mapped into unused low code points through a `/Differences`\n * array using their standard Adobe glyph names. A character with no mapping is\n * rendered as `?` rather than being dropped, so a missing glyph is visible\n * rather than silently changing a name.\n */\n\nexport type PdfTextAlign = 'left' | 'right'\n\nexport type PdfCell = {\n  text: string\n  x: number\n  align?: PdfTextAlign\n  bold?: boolean\n  size?: number\n  /** Grey for hints and secondary text; black otherwise. */\n  muted?: boolean\n}\n\nexport type PdfLine =\n  | { kind: 'cells'; cells: PdfCell[] }\n  | { kind: 'rule' }\n  | { kind: 'space'; height: number }\n\nexport type PdfDocumentInput = {\n  title: string\n  lines: PdfLine[]\n}\n\nexport const PDF_CONTENT_TYPE = 'application/pdf'\n\nconst PAGE_WIDTH = 595.28\nconst PAGE_HEIGHT = 841.89\nconst MARGIN_X = 42\nconst MARGIN_TOP = 56\nconst MARGIN_BOTTOM = 48\nconst LINE_HEIGHT = 14\nconst DEFAULT_SIZE = 9\n\n/**\n * Glyphs Polish needs that WinAnsiEncoding does not carry, parked in unused\n * low code points and declared through /Differences.\n */\nconst DIFFERENCE_GLYPHS: Array<[string, number, string]> = [\n  ['\u0105', 1, 'aogonek'],\n  ['\u0107', 2, 'cacute'],\n  ['\u0119', 3, 'eogonek'],\n  ['\u0142', 4, 'lslash'],\n  ['\u0144', 5, 'nacute'],\n  ['\u015B', 6, 'sacute'],\n  ['\u017A', 7, 'zacute'],\n  ['\u017C', 8, 'zdotaccent'],\n  ['\u0104', 9, 'Aogonek'],\n  ['\u0106', 10, 'Cacute'],\n  ['\u0118', 11, 'Eogonek'],\n  ['\u0141', 12, 'Lslash'],\n  ['\u0143', 13, 'Nacute'],\n  ['\u015A', 14, 'Sacute'],\n  ['\u0179', 15, 'Zacute'],\n  ['\u017B', 16, 'Zdotaccent'],\n]\n\n/** Characters WinAnsiEncoding already carries at a code above ASCII. */\nconst WIN_ANSI_EXTRAS: Record<string, number> = {\n  '\u00F3': 0xf3,\n  '\u00D3': 0xd3,\n  '\u00E9': 0xe9,\n  '\u00E8': 0xe8,\n  '\u00E4': 0xe4,\n  '\u00F6': 0xf6,\n  '\u00FC': 0xfc,\n  '\u00DF': 0xdf,\n  '\u00E1': 0xe1,\n  '\u00ED': 0xed,\n  '\u00F1': 0xf1,\n  '\u00FA': 0xfa,\n  '\u2013': 0x96,\n  '\u2014': 0x97,\n  '\u00B7': 0xb7,\n  '\u20AC': 0x80,\n  '\u201E': 0x84,\n  '\u201D': 0x94,\n  '\u2019': 0x92,\n  '\u2018': 0x91,\n  '\u2026': 0x85,\n  '\u00B0': 0xb0,\n  '\u00D7': 0xd7,\n}\n\nconst ENCODING_MAP: Map<string, number> = (() => {\n  const map = new Map<string, number>()\n  for (let code = 32; code <= 126; code += 1) map.set(String.fromCharCode(code), code)\n  for (const [char, code] of Object.entries(WIN_ANSI_EXTRAS)) map.set(char, code)\n  for (const [char, code] of DIFFERENCE_GLYPHS) map.set(char, code)\n  return map\n})()\n\nexport function encodePdfText(value: string): string {\n  let out = ''\n  for (const char of value) {\n    const code = ENCODING_MAP.get(char) ?? 0x3f\n    const byte = String.fromCharCode(code)\n    if (byte === '(' || byte === ')' || byte === '\\\\') out += `\\\\${byte}`\n    else out += byte\n  }\n  return out\n}\n\n/**\n * Helvetica advance widths (1/1000 em) for the printable ASCII range, used to\n * right-align the money and hours columns. Characters outside the table fall\n * back to the average width, which is close enough for the accented letters and\n * only ever shifts a right-aligned label by a hair.\n */\nconst HELVETICA_WIDTHS: Record<string, number> = (() => {\n  const widths: Record<string, number> = {}\n  const groups: Array<[number, string]> = [\n    [278, ' !I|jltfi.,:;\\'`'],\n    [355, '\"'],\n    [556, '#$0123456789+<=>~'],\n    [889, '%'],\n    [667, '&BCDEHKNRSUVXY'],\n    [333, '()[]{}/\\\\*-r'],\n    [584, '^'],\n    [500, '?_'],\n    [1015, '@'],\n    [722, 'ADGHOQ'],\n    [611, 'FPZ'],\n    [944, 'M'],\n    [778, 'W'],\n    [556, 'abcdeghknopqsu'],\n    [222, 'i'],\n    [500, 'yvz'],\n    [833, 'm'],\n    [722, 'w'],\n    [333, 'JLT'],\n  ]\n  for (const [width, chars] of groups) {\n    for (const char of chars) widths[char] = width\n  }\n  return widths\n})()\n\nexport function measureText(text: string, size: number, bold: boolean): number {\n  let units = 0\n  for (const char of text) units += HELVETICA_WIDTHS[char] ?? 556\n  // Helvetica-Bold runs a touch wider; a flat factor is accurate enough for\n  // right-aligning a column and avoids shipping a second width table.\n  const factor = bold ? 1.03 : 1\n  return (units / 1000) * size * factor\n}\n\ntype PageContent = string[]\n\nfunction buildPages(input: PdfDocumentInput): PageContent[] {\n  const pages: PageContent[] = []\n  let current: PageContent = []\n  let y = PAGE_HEIGHT - MARGIN_TOP\n\n  const pushPage = () => {\n    if (current.length > 0) pages.push(current)\n    current = []\n    y = PAGE_HEIGHT - MARGIN_TOP\n  }\n\n  for (const line of input.lines) {\n    const height = line.kind === 'space' ? line.height : LINE_HEIGHT\n    if (y - height < MARGIN_BOTTOM) pushPage()\n\n    if (line.kind === 'space') {\n      y -= line.height\n      continue\n    }\n    if (line.kind === 'rule') {\n      current.push(\n        `0.8 0.8 0.8 RG 0.5 w ${MARGIN_X} ${(y - 4).toFixed(2)} m ${(PAGE_WIDTH - MARGIN_X).toFixed(2)} ${(y - 4).toFixed(2)} l S`,\n      )\n      y -= LINE_HEIGHT\n      continue\n    }\n\n    for (const cell of line.cells) {\n      const size = cell.size ?? DEFAULT_SIZE\n      const font = cell.bold ? '/F2' : '/F1'\n      const width = measureText(cell.text, size, cell.bold === true)\n      const x = cell.align === 'right' ? cell.x - width : cell.x\n      const colour = cell.muted ? '0.45 0.45 0.45 rg' : '0 0 0 rg'\n      current.push(\n        `BT ${colour} ${font} ${size} Tf 1 0 0 1 ${x.toFixed(2)} ${y.toFixed(2)} Tm (${encodePdfText(cell.text)}) Tj ET`,\n      )\n    }\n    y -= LINE_HEIGHT\n  }\n\n  pushPage()\n  return pages.length > 0 ? pages : [[]]\n}\n\nexport function buildPdf(input: PdfDocumentInput): Buffer {\n  const pages = buildPages(input)\n  const objects: string[] = []\n\n  const differences = DIFFERENCE_GLYPHS.map(([, code, glyph]) => `${code} /${glyph}`).join(' ')\n  const pageObjectStart = 6\n  const pageIds = pages.map((_, index) => pageObjectStart + index * 2)\n\n  objects[1] = '<< /Type /Catalog /Pages 2 0 R >>'\n  objects[2] = `<< /Type /Pages /Kids [${pageIds.map((id) => `${id} 0 R`).join(' ')}] /Count ${pages.length} >>`\n  objects[3] = '<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica /Encoding 5 0 R >>'\n  objects[4] = '<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica-Bold /Encoding 5 0 R >>'\n  objects[5] = `<< /Type /Encoding /BaseEncoding /WinAnsiEncoding /Differences [${differences}] >>`\n\n  pages.forEach((content, index) => {\n    const pageId = pageIds[index]\n    const contentId = pageId + 1\n    const stream = content.join('\\n')\n    objects[pageId] =\n      `<< /Type /Page /Parent 2 0 R /MediaBox [0 0 ${PAGE_WIDTH} ${PAGE_HEIGHT}] ` +\n      `/Resources << /Font << /F1 3 0 R /F2 4 0 R >> >> /Contents ${contentId} 0 R >>`\n    objects[contentId] = `<< /Length ${Buffer.byteLength(stream, 'latin1')} >>\\nstream\\n${stream}\\nendstream`\n  })\n\n  const chunks: Buffer[] = [Buffer.from('%PDF-1.4\\n', 'latin1')]\n  let offset = chunks[0].length\n  const offsets: number[] = []\n\n  for (let id = 1; id < objects.length; id += 1) {\n    const body = objects[id]\n    if (body === undefined) continue\n    offsets[id] = offset\n    const chunk = Buffer.from(`${id} 0 obj\\n${body}\\nendobj\\n`, 'latin1')\n    chunks.push(chunk)\n    offset += chunk.length\n  }\n\n  const maxId = objects.length\n  const xrefOffset = offset\n  const xrefRows = ['0000000000 65535 f \\n']\n  for (let id = 1; id < maxId; id += 1) {\n    const at = offsets[id]\n    xrefRows.push(at === undefined ? '0000000000 65535 f \\n' : `${String(at).padStart(10, '0')} 00000 n \\n`)\n  }\n  chunks.push(\n    Buffer.from(\n      `xref\\n0 ${maxId}\\n${xrefRows.join('')}trailer\\n<< /Size ${maxId} /Root 1 0 R >>\\nstartxref\\n${xrefOffset}\\n%%EOF\\n`,\n      'latin1',\n    ),\n  )\n\n  return Buffer.concat(chunks)\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/staff/lib/timesheets-reports/reportApprovalPolicies.js

@@ -0,0 +1,68 @@
+import { extensionPoints } from "@open-mercato/core/modules/staff/extension-points";
+import { createStrategyRegistry, BUILT_IN_STRATEGY_PRIORITY } from "../time-tracking/registries/registry.js";
+import { runStrategy } from "../time-tracking/registries/invoke.js";
+import { hasResolverScope } from "../time-tracking/registries/scope.js";
+const REPORT_APPROVAL_POLICY_REGISTRY_ID = extensionPoints.hosts.reportApprovalPolicyRegistry.spotId;
+const BUILT_IN_REPORT_APPROVAL_POLICY_ID = "staff.time_tracking.report_approval.acl_only";
+const registry = createStrategyRegistry(REPORT_APPROVAL_POLICY_REGISTRY_ID);
+function registerReportApprovalPolicy(policy) {
+  return registry.register(policy);
+}
+function listReportApprovalPolicies() {
+  return registry.list();
+}
+function getReportApprovalPolicy(id) {
+  return registry.get(id);
+}
+registry.registerBuiltIn({
+  id: BUILT_IN_REPORT_APPROVAL_POLICY_ID,
+  priority: BUILT_IN_STRATEGY_PRIORITY
+});
+function applicablePolicies(ctx) {
+  const scoped = hasResolverScope(ctx);
+  return registry.list().filter((policy) => scoped || policy.id === BUILT_IN_REPORT_APPROVAL_POLICY_ID);
+}
+function refusalOnFailure() {
+  return { code: "approval_policy_unavailable", messageKey: "staff.errors.forbidden" };
+}
+function evaluatePolicyVerdict(ctx, read) {
+  for (const policy of applicablePolicies(ctx)) {
+    const verdict = runStrategy(
+      REPORT_APPROVAL_POLICY_REGISTRY_ID,
+      policy.id,
+      () => read(policy),
+      () => refusalOnFailure()
+    );
+    if (verdict) return verdict;
+  }
+  return null;
+}
+function evaluateReportClosePolicies(ctx) {
+  return evaluatePolicyVerdict(ctx, (policy) => policy.canClose?.(ctx));
+}
+function evaluateReportUnlockPolicies(ctx) {
+  return evaluatePolicyVerdict(ctx, (policy) => policy.canUnlock?.(ctx));
+}
+async function notifyReportClosed(ctx) {
+  const failures = [];
+  for (const policy of applicablePolicies(ctx)) {
+    if (!policy.onClosed) continue;
+    try {
+      await policy.onClosed(ctx);
+    } catch (error) {
+      failures.push({ policyId: policy.id, error });
+    }
+  }
+  return failures;
+}
+export {
+  BUILT_IN_REPORT_APPROVAL_POLICY_ID,
+  REPORT_APPROVAL_POLICY_REGISTRY_ID,
+  evaluateReportClosePolicies,
+  evaluateReportUnlockPolicies,
+  getReportApprovalPolicy,
+  listReportApprovalPolicies,
+  notifyReportClosed,
+  registerReportApprovalPolicy
+};
+//# sourceMappingURL=reportApprovalPolicies.js.map

package/dist/modules/staff/lib/timesheets-reports/reportApprovalPolicies.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/reportApprovalPolicies.ts"],
+  "sourcesContent": ["/**\n * EP-41 \u2014 the report approval / lock policy provider.\n *\n * The policy layer sits ON TOP of the ACL check, it does not replace it. The\n * close and unlock routes still require `staff.timesheets.lock` and\n * `staff.timesheets.reports.unlock` respectively, unconditionally and before\n * anything here runs; a policy can only add a reason to refuse. That is enforced\n * structurally: `canClose` / `canUnlock` return a refusal or nothing, never a\n * grant, so there is no shape in which a policy can open a door the ACL closed.\n *\n * The built-in `staff.time_tracking.report_approval.acl_only` refuses nothing,\n * which is exactly the ACL-only gate the module shipped with.\n */\n\nimport { extensionPoints } from '@open-mercato/core/modules/staff/extension-points'\nimport { createStrategyRegistry, BUILT_IN_STRATEGY_PRIORITY } from '../time-tracking/registries/registry'\nimport { runStrategy } from '../time-tracking/registries/invoke'\nimport { hasResolverScope, type ScopedResolverContext } from '../time-tracking/registries/scope'\n\nexport type ReportApprovalContext = ScopedResolverContext & {\n  reportId: string\n  actorUserId: string | null\n  /** The features the ACL gate already resolved for the actor. */\n  actorFeatures: readonly string[]\n  status: string\n  reason?: string | null\n}\n\nexport type ReportApprovalRefusal = {\n  /** Machine-readable, surfaced in the response body as `code`. */\n  code: string\n  /** i18n key the route translates; never a user-facing literal. */\n  messageKey: string\n}\n\n/** `null` \u2014 and `undefined` \u2014 mean \"no objection\", never \"allowed\". */\nexport type ReportApprovalVerdict = ReportApprovalRefusal | null | undefined\n\nexport type ReportApprovalPolicy = {\n  id: string\n  priority?: number\n  canClose?(ctx: ReportApprovalContext): ReportApprovalVerdict\n  canUnlock?(ctx: ReportApprovalContext): ReportApprovalVerdict\n  onClosed?(ctx: ReportApprovalContext): void | Promise<void>\n}\n\nexport const REPORT_APPROVAL_POLICY_REGISTRY_ID = extensionPoints.hosts.reportApprovalPolicyRegistry.spotId\n\nexport const BUILT_IN_REPORT_APPROVAL_POLICY_ID = 'staff.time_tracking.report_approval.acl_only'\n\nconst registry = createStrategyRegistry<ReportApprovalPolicy>(REPORT_APPROVAL_POLICY_REGISTRY_ID)\n\nexport function registerReportApprovalPolicy(policy: ReportApprovalPolicy): () => void {\n  return registry.register(policy)\n}\n\nexport function listReportApprovalPolicies(): ReportApprovalPolicy[] {\n  return registry.list()\n}\n\nexport function getReportApprovalPolicy(id: string | null | undefined): ReportApprovalPolicy | null {\n  return registry.get(id)\n}\n\nregistry.registerBuiltIn({\n  id: BUILT_IN_REPORT_APPROVAL_POLICY_ID,\n  priority: BUILT_IN_STRATEGY_PRIORITY,\n})\n\nfunction applicablePolicies(ctx: ReportApprovalContext): ReportApprovalPolicy[] {\n  const scoped = hasResolverScope(ctx)\n  return registry\n    .list()\n    .filter((policy) => scoped || policy.id === BUILT_IN_REPORT_APPROVAL_POLICY_ID)\n}\n\n/**\n * These two are the only registry call sites that do NOT fall back to the built-in\n * when a policy throws, and the asymmetry is deliberate: they are gates, and the\n * built-in grants (it declares no `canClose`/`canUnlock` at all, because the ACL\n * check in the routes runs first and unconditionally). Falling back would turn a\n * broken policy into permission. A thrower refuses instead, which is the same answer\n * the policy would have given if it could not satisfy itself.\n */\nfunction refusalOnFailure(): ReportApprovalRefusal {\n  return { code: 'approval_policy_unavailable', messageKey: 'staff.errors.forbidden' }\n}\n\nfunction evaluatePolicyVerdict(\n  ctx: ReportApprovalContext,\n  read: (policy: ReportApprovalPolicy) => ReportApprovalVerdict,\n): ReportApprovalRefusal | null {\n  for (const policy of applicablePolicies(ctx)) {\n    const verdict = runStrategy(\n      REPORT_APPROVAL_POLICY_REGISTRY_ID,\n      policy.id,\n      () => read(policy),\n      () => refusalOnFailure(),\n    )\n    if (verdict) return verdict\n  }\n  return null\n}\n\n/** The first refusal wins; every policy must agree before a close proceeds. */\nexport function evaluateReportClosePolicies(ctx: ReportApprovalContext): ReportApprovalRefusal | null {\n  return evaluatePolicyVerdict(ctx, (policy) => policy.canClose?.(ctx))\n}\n\nexport function evaluateReportUnlockPolicies(ctx: ReportApprovalContext): ReportApprovalRefusal | null {\n  return evaluatePolicyVerdict(ctx, (policy) => policy.canUnlock?.(ctx))\n}\n\nexport type ReportApprovalNotificationFailure = {\n  policyId: string\n  error: unknown\n}\n\n/**\n * Fired after a close has committed. A throwing hook cannot unwind a freeze that\n * already happened, so failures are collected and handed back for the caller to\n * log \u2014 the same trade the export route makes with its audit row.\n */\nexport async function notifyReportClosed(\n  ctx: ReportApprovalContext,\n): Promise<ReportApprovalNotificationFailure[]> {\n  const failures: ReportApprovalNotificationFailure[] = []\n  for (const policy of applicablePolicies(ctx)) {\n    if (!policy.onClosed) continue\n    try {\n      await policy.onClosed(ctx)\n    } catch (error) {\n      failures.push({ policyId: policy.id, error })\n    }\n  }\n  return failures\n}\n"],
+  "mappings": "AAcA,SAAS,uBAAuB;AAChC,SAAS,wBAAwB,kCAAkC;AACnE,SAAS,mBAAmB;AAC5B,SAAS,wBAAoD;AA6BtD,MAAM,qCAAqC,gBAAgB,MAAM,6BAA6B;AAE9F,MAAM,qCAAqC;AAElD,MAAM,WAAW,uBAA6C,kCAAkC;AAEzF,SAAS,6BAA6B,QAA0C;AACrF,SAAO,SAAS,SAAS,MAAM;AACjC;AAEO,SAAS,6BAAqD;AACnE,SAAO,SAAS,KAAK;AACvB;AAEO,SAAS,wBAAwB,IAA4D;AAClG,SAAO,SAAS,IAAI,EAAE;AACxB;AAEA,SAAS,gBAAgB;AAAA,EACvB,IAAI;AAAA,EACJ,UAAU;AACZ,CAAC;AAED,SAAS,mBAAmB,KAAoD;AAC9E,QAAM,SAAS,iBAAiB,GAAG;AACnC,SAAO,SACJ,KAAK,EACL,OAAO,CAAC,WAAW,UAAU,OAAO,OAAO,kCAAkC;AAClF;AAUA,SAAS,mBAA0C;AACjD,SAAO,EAAE,MAAM,+BAA+B,YAAY,yBAAyB;AACrF;AAEA,SAAS,sBACP,KACA,MAC8B;AAC9B,aAAW,UAAU,mBAAmB,GAAG,GAAG;AAC5C,UAAM,UAAU;AAAA,MACd;AAAA,MACA,OAAO;AAAA,MACP,MAAM,KAAK,MAAM;AAAA,MACjB,MAAM,iBAAiB;AAAA,IACzB;AACA,QAAI,QAAS,QAAO;AAAA,EACtB;AACA,SAAO;AACT;AAGO,SAAS,4BAA4B,KAA0D;AACpG,SAAO,sBAAsB,KAAK,CAAC,WAAW,OAAO,WAAW,GAAG,CAAC;AACtE;AAEO,SAAS,6BAA6B,KAA0D;AACrG,SAAO,sBAAsB,KAAK,CAAC,WAAW,OAAO,YAAY,GAAG,CAAC;AACvE;AAYA,eAAsB,mBACpB,KAC8C;AAC9C,QAAM,WAAgD,CAAC;AACvD,aAAW,UAAU,mBAAmB,GAAG,GAAG;AAC5C,QAAI,CAAC,OAAO,SAAU;AACtB,QAAI;AACF,YAAM,OAAO,SAAS,GAAG;AAAA,IAC3B,SAAS,OAAO;AACd,eAAS,KAAK,EAAE,UAAU,OAAO,IAAI,MAAM,CAAC;AAAA,IAC9C;AAAA,EACF;AACA,SAAO;AACT;",
+  "names": []
+}