@open-mercato/core 0.7.1-develop.7178.1.ab93fbaf4e → 0.7.1-develop.7179.1.e8c03264b6

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

@@ -0,0 +1,79 @@
+import { extensionPoints } from "@open-mercato/core/modules/staff/extension-points";
+import { createStrategyRegistry, BUILT_IN_STRATEGY_PRIORITY } from "../time-tracking/registries/registry.js";
+const BUILT_IN_REPORT_GROUPING_IDS = ["project_task", "project_person", "project_day"];
+const REPORT_GROUPING_REGISTRY_ID = extensionPoints.hosts.reportGroupingRegistry.spotId;
+const registry = createStrategyRegistry(REPORT_GROUPING_REGISTRY_ID);
+function registerReportGrouping(grouping) {
+  return registry.register(grouping);
+}
+function listReportGroupings() {
+  return registry.list();
+}
+function getReportGrouping(id) {
+  return registry.get(id);
+}
+function hasReportGrouping(id) {
+  return registry.has(id);
+}
+function isBuiltInReportGrouping(id) {
+  return registry.isBuiltIn(id);
+}
+function reportGroupingIds() {
+  const builtIn = BUILT_IN_REPORT_GROUPING_IDS.filter((id) => registry.has(id));
+  const contributed = registry.ids().filter((id) => !builtIn.includes(id));
+  return [...builtIn, ...contributed];
+}
+const DEFAULT_REPORT_GROUPING = "project_task";
+function normalizeReportGrouping(value) {
+  if (typeof value === "string" && registry.has(value)) return value;
+  return DEFAULT_REPORT_GROUPING;
+}
+const UNASSIGNED_LINE_KEY = "__unassigned__";
+function sortByMinutesThenLabel(left, right) {
+  return right.minutes - left.minutes || left.label.localeCompare(right.label);
+}
+function taskLineKey(entry) {
+  const rootId = entry.rootTaskId ?? entry.taskId ?? null;
+  const taskId = entry.taskId ?? null;
+  if (!rootId) return { key: UNASSIGNED_LINE_KEY, parentKey: null };
+  if (taskId && taskId !== rootId) return { key: taskId, parentKey: rootId };
+  return { key: rootId, parentKey: null };
+}
+function registerBuiltInReportGrouping(grouping) {
+  return registry.registerBuiltIn({ ...grouping, priority: BUILT_IN_STRATEGY_PRIORITY });
+}
+registerBuiltInReportGrouping({
+  id: "project_task",
+  labelKey: "staff.time_tracking.reports.grouping.project_task",
+  groupOf: taskLineKey,
+  labelOf: (key, ctx) => key === UNASSIGNED_LINE_KEY ? ctx.fallbacks.unassignedTask : ctx.directory.taskLabelById[key] ?? ctx.fallbacks.unassignedTask,
+  sort: sortByMinutesThenLabel
+});
+registerBuiltInReportGrouping({
+  id: "project_person",
+  labelKey: "staff.time_tracking.reports.grouping.project_person",
+  groupOf: (entry) => ({ key: entry.staffMemberId ?? UNASSIGNED_LINE_KEY, parentKey: null }),
+  labelOf: (key, ctx) => key === UNASSIGNED_LINE_KEY ? ctx.fallbacks.unassignedPerson : ctx.directory.personLabelById[key] ?? ctx.fallbacks.unassignedPerson,
+  sort: sortByMinutesThenLabel
+});
+registerBuiltInReportGrouping({
+  id: "project_day",
+  labelKey: "staff.time_tracking.reports.grouping.project_day",
+  groupOf: (entry) => ({ key: entry.date || UNASSIGNED_LINE_KEY, parentKey: null }),
+  labelOf: (key, ctx) => key === UNASSIGNED_LINE_KEY ? ctx.fallbacks.unassignedTask : key,
+  sort: sortByMinutesThenLabel
+});
+export {
+  BUILT_IN_REPORT_GROUPING_IDS,
+  DEFAULT_REPORT_GROUPING,
+  REPORT_GROUPING_REGISTRY_ID,
+  UNASSIGNED_LINE_KEY,
+  getReportGrouping,
+  hasReportGrouping,
+  isBuiltInReportGrouping,
+  listReportGroupings,
+  normalizeReportGrouping,
+  registerReportGrouping,
+  reportGroupingIds
+};
+//# sourceMappingURL=reportGroupings.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/reportGroupings.ts"],
+  "sourcesContent": ["/**\n * EP-36 \u2014 the report grouping strategy registry.\n *\n * A grouping decides two things and nothing else: which line an entry lands on\n * (`groupOf`, which may name a parent line so D-2's inclusive task rollup keeps\n * working) and how the finished lines are ordered (`sort`). Labelling is a third\n * concern the strategy owns because only it knows which directory to look the\n * key up in.\n *\n * The three built-ins reproduce `reportTotals.ts`'s original `lineKeyFor` /\n * `labelFor` / line sort exactly. The registry lives in its own file so\n * `reportTotals.ts` can register into it at module load without an import cycle.\n */\n\nimport { extensionPoints } from '@open-mercato/core/modules/staff/extension-points'\nimport { createStrategyRegistry, BUILT_IN_STRATEGY_PRIORITY } from '../time-tracking/registries/registry'\nimport type { ReportDirectory, ReportInputEntry, ReportLine } from './reportTotals'\n\nexport const BUILT_IN_REPORT_GROUPING_IDS = ['project_task', 'project_person', 'project_day'] as const\n\nexport type BuiltInReportGrouping = (typeof BUILT_IN_REPORT_GROUPING_IDS)[number]\n\n/**\n * Widened from the original three-way union so a contributed grouping id is\n * assignable. The union arm keeps the built-ins as completions.\n */\nexport type ReportGrouping = BuiltInReportGrouping | (string & {})\n\nexport type ReportGroupingFallbackLabels = {\n  unassignedTask: string\n  unassignedPerson: string\n  nonbillableGroup: string\n}\n\nexport type ReportGroupingLabelContext = {\n  directory: ReportDirectory\n  fallbacks: ReportGroupingFallbackLabels\n}\n\nexport type ReportGroupingKey = {\n  key: string\n  parentKey: string | null\n}\n\nexport type ReportGroupingStrategy = {\n  id: string\n  labelKey: string\n  priority?: number\n  groupOf(entry: ReportInputEntry): ReportGroupingKey\n  labelOf(key: string, ctx: ReportGroupingLabelContext): string\n  sort(left: ReportLine, right: ReportLine): number\n}\n\nexport const REPORT_GROUPING_REGISTRY_ID = extensionPoints.hosts.reportGroupingRegistry.spotId\n\nconst registry = createStrategyRegistry<ReportGroupingStrategy>(REPORT_GROUPING_REGISTRY_ID)\n\nexport function registerReportGrouping(grouping: ReportGroupingStrategy): () => void {\n  return registry.register(grouping)\n}\n\nexport function listReportGroupings(): ReportGroupingStrategy[] {\n  return registry.list()\n}\n\nexport function getReportGrouping(id: string | null | undefined): ReportGroupingStrategy | null {\n  return registry.get(id)\n}\n\nexport function hasReportGrouping(id: string | null | undefined): boolean {\n  return registry.has(id)\n}\n\n/** Identity, not membership of `BUILT_IN_REPORT_GROUPING_IDS` \u2014 a contribution cannot claim one. */\nexport function isBuiltInReportGrouping(id: string | null | undefined): boolean {\n  return registry.isBuiltIn(id)\n}\n\n/** Built-ins first, in the order the module shipped them, then contributions. */\nexport function reportGroupingIds(): string[] {\n  const builtIn = BUILT_IN_REPORT_GROUPING_IDS.filter((id) => registry.has(id))\n  const contributed = registry.ids().filter((id) => !builtIn.includes(id as BuiltInReportGrouping))\n  return [...builtIn, ...contributed]\n}\n\nexport const DEFAULT_REPORT_GROUPING: BuiltInReportGrouping = 'project_task'\n\n/**\n * The grouping a report was stored with, coerced back to something the registry\n * can serve. An id whose contributing module has since been removed falls back\n * to the module default rather than producing an ungrouped sheet.\n */\nexport function normalizeReportGrouping(value: unknown): ReportGrouping {\n  if (typeof value === 'string' && registry.has(value)) return value\n  return DEFAULT_REPORT_GROUPING\n}\n\n/**\n * The line key an entry with nothing to group by lands on. It is part of the\n * grouping contract rather than a `reportTotals` private, because a contributed\n * grouping has to be able to produce the same \"unassigned\" bucket.\n */\nexport const UNASSIGNED_LINE_KEY = '__unassigned__'\n\n/** The line ordering every built-in grouping shares: longest first, then by label. */\nfunction sortByMinutesThenLabel(left: ReportLine, right: ReportLine): number {\n  return right.minutes - left.minutes || left.label.localeCompare(right.label)\n}\n\nfunction taskLineKey(entry: ReportInputEntry): ReportGroupingKey {\n  const rootId = entry.rootTaskId ?? entry.taskId ?? null\n  const taskId = entry.taskId ?? null\n  if (!rootId) return { key: UNASSIGNED_LINE_KEY, parentKey: null }\n  // D-2: a child's time lands on the parent's line and is expandable underneath.\n  if (taskId && taskId !== rootId) return { key: taskId, parentKey: rootId }\n  return { key: rootId, parentKey: null }\n}\n\nfunction registerBuiltInReportGrouping(\n  grouping: Omit<ReportGroupingStrategy, 'priority'>,\n): ReportGroupingStrategy {\n  return registry.registerBuiltIn({ ...grouping, priority: BUILT_IN_STRATEGY_PRIORITY })\n}\n\nregisterBuiltInReportGrouping({\n  id: 'project_task',\n  labelKey: 'staff.time_tracking.reports.grouping.project_task',\n  groupOf: taskLineKey,\n  labelOf: (key, ctx) =>\n    key === UNASSIGNED_LINE_KEY\n      ? ctx.fallbacks.unassignedTask\n      : ctx.directory.taskLabelById[key] ?? ctx.fallbacks.unassignedTask,\n  sort: sortByMinutesThenLabel,\n})\n\nregisterBuiltInReportGrouping({\n  id: 'project_person',\n  labelKey: 'staff.time_tracking.reports.grouping.project_person',\n  groupOf: (entry) => ({ key: entry.staffMemberId ?? UNASSIGNED_LINE_KEY, parentKey: null }),\n  labelOf: (key, ctx) =>\n    key === UNASSIGNED_LINE_KEY\n      ? ctx.fallbacks.unassignedPerson\n      : ctx.directory.personLabelById[key] ?? ctx.fallbacks.unassignedPerson,\n  sort: sortByMinutesThenLabel,\n})\n\nregisterBuiltInReportGrouping({\n  id: 'project_day',\n  labelKey: 'staff.time_tracking.reports.grouping.project_day',\n  groupOf: (entry) => ({ key: entry.date || UNASSIGNED_LINE_KEY, parentKey: null }),\n  labelOf: (key, ctx) => (key === UNASSIGNED_LINE_KEY ? ctx.fallbacks.unassignedTask : key),\n  sort: sortByMinutesThenLabel,\n})\n"],
+  "mappings": "AAcA,SAAS,uBAAuB;AAChC,SAAS,wBAAwB,kCAAkC;AAG5D,MAAM,+BAA+B,CAAC,gBAAgB,kBAAkB,aAAa;AAmCrF,MAAM,8BAA8B,gBAAgB,MAAM,uBAAuB;AAExF,MAAM,WAAW,uBAA+C,2BAA2B;AAEpF,SAAS,uBAAuB,UAA8C;AACnF,SAAO,SAAS,SAAS,QAAQ;AACnC;AAEO,SAAS,sBAAgD;AAC9D,SAAO,SAAS,KAAK;AACvB;AAEO,SAAS,kBAAkB,IAA8D;AAC9F,SAAO,SAAS,IAAI,EAAE;AACxB;AAEO,SAAS,kBAAkB,IAAwC;AACxE,SAAO,SAAS,IAAI,EAAE;AACxB;AAGO,SAAS,wBAAwB,IAAwC;AAC9E,SAAO,SAAS,UAAU,EAAE;AAC9B;AAGO,SAAS,oBAA8B;AAC5C,QAAM,UAAU,6BAA6B,OAAO,CAAC,OAAO,SAAS,IAAI,EAAE,CAAC;AAC5E,QAAM,cAAc,SAAS,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,SAAS,EAA2B,CAAC;AAChG,SAAO,CAAC,GAAG,SAAS,GAAG,WAAW;AACpC;AAEO,MAAM,0BAAiD;AAOvD,SAAS,wBAAwB,OAAgC;AACtE,MAAI,OAAO,UAAU,YAAY,SAAS,IAAI,KAAK,EAAG,QAAO;AAC7D,SAAO;AACT;AAOO,MAAM,sBAAsB;AAGnC,SAAS,uBAAuB,MAAkB,OAA2B;AAC3E,SAAO,MAAM,UAAU,KAAK,WAAW,KAAK,MAAM,cAAc,MAAM,KAAK;AAC7E;AAEA,SAAS,YAAY,OAA4C;AAC/D,QAAM,SAAS,MAAM,cAAc,MAAM,UAAU;AACnD,QAAM,SAAS,MAAM,UAAU;AAC/B,MAAI,CAAC,OAAQ,QAAO,EAAE,KAAK,qBAAqB,WAAW,KAAK;AAEhE,MAAI,UAAU,WAAW,OAAQ,QAAO,EAAE,KAAK,QAAQ,WAAW,OAAO;AACzE,SAAO,EAAE,KAAK,QAAQ,WAAW,KAAK;AACxC;AAEA,SAAS,8BACP,UACwB;AACxB,SAAO,SAAS,gBAAgB,EAAE,GAAG,UAAU,UAAU,2BAA2B,CAAC;AACvF;AAEA,8BAA8B;AAAA,EAC5B,IAAI;AAAA,EACJ,UAAU;AAAA,EACV,SAAS;AAAA,EACT,SAAS,CAAC,KAAK,QACb,QAAQ,sBACJ,IAAI,UAAU,iBACd,IAAI,UAAU,cAAc,GAAG,KAAK,IAAI,UAAU;AAAA,EACxD,MAAM;AACR,CAAC;AAED,8BAA8B;AAAA,EAC5B,IAAI;AAAA,EACJ,UAAU;AAAA,EACV,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM,iBAAiB,qBAAqB,WAAW,KAAK;AAAA,EACxF,SAAS,CAAC,KAAK,QACb,QAAQ,sBACJ,IAAI,UAAU,mBACd,IAAI,UAAU,gBAAgB,GAAG,KAAK,IAAI,UAAU;AAAA,EAC1D,MAAM;AACR,CAAC;AAED,8BAA8B;AAAA,EAC5B,IAAI;AAAA,EACJ,UAAU;AAAA,EACV,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM,QAAQ,qBAAqB,WAAW,KAAK;AAAA,EAC/E,SAAS,CAAC,KAAK,QAAS,QAAQ,sBAAsB,IAAI,UAAU,iBAAiB;AAAA,EACrF,MAAM;AACR,CAAC;",
+  "names": []
+}

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

@@ -0,0 +1,11 @@
+function reportSheetLabels(translate) {
+  return {
+    unassignedTask: translate("staff.time_tracking.reports.sheet.noTask", "No task"),
+    unassignedPerson: translate("staff.time_tracking.reports.sheet.noPerson", "Unassigned"),
+    nonbillableGroup: translate("staff.time_tracking.reports.sheet.nonbillable", "Non-billable time")
+  };
+}
+export {
+  reportSheetLabels
+};
+//# sourceMappingURL=reportLabels.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/reportLabels.ts"],
+  "sourcesContent": ["/**\n * The three fallback labels a report sheet needs when a line has nothing to name\n * itself with. They live here rather than in a route because the close command,\n * the preview, the sheet and the exports must all use the same ones \u2014 a freeze\n * record labelled \"No task\" and a PDF labelled \"Unassigned\" would be the same\n * line reading differently in two places a client can compare.\n */\n\nexport type ReportLabelTranslate = (key: string, fallback: string) => string\n\nexport type ReportSheetLabels = {\n  unassignedTask: string\n  unassignedPerson: string\n  nonbillableGroup: string\n}\n\nexport function reportSheetLabels(translate: ReportLabelTranslate): ReportSheetLabels {\n  return {\n    unassignedTask: translate('staff.time_tracking.reports.sheet.noTask', 'No task'),\n    unassignedPerson: translate('staff.time_tracking.reports.sheet.noPerson', 'Unassigned'),\n    nonbillableGroup: translate('staff.time_tracking.reports.sheet.nonbillable', 'Non-billable time'),\n  }\n}\n"],
+  "mappings": "AAgBO,SAAS,kBAAkB,WAAoD;AACpF,SAAO;AAAA,IACL,gBAAgB,UAAU,4CAA4C,SAAS;AAAA,IAC/E,kBAAkB,UAAU,8CAA8C,YAAY;AAAA,IACtF,kBAAkB,UAAU,iDAAiD,mBAAmB;AAAA,EAClG;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,83 @@
+import { isUniqueViolation } from "@open-mercato/shared/lib/crud/errors";
+const REPORT_REFERENCE_PREFIX = "RAP";
+const FIRST_REPORT_SEQUENCE_NUMBER = 1;
+const REPORT_SEQUENCE_PAD = 4;
+const REPORT_REFERENCE_MAX_ATTEMPTS = 5;
+function reportReferenceYear(issuedAt) {
+  if (!(issuedAt instanceof Date) || Number.isNaN(issuedAt.getTime())) {
+    return (/* @__PURE__ */ new Date()).getFullYear();
+  }
+  return issuedAt.getFullYear();
+}
+function reportReferencePrefix(year) {
+  return `${REPORT_REFERENCE_PREFIX}-${year}-`;
+}
+function formatReportReference(year, sequenceNumber) {
+  const padded = String(Math.max(FIRST_REPORT_SEQUENCE_NUMBER, sequenceNumber)).padStart(
+    REPORT_SEQUENCE_PAD,
+    "0"
+  );
+  return `${reportReferencePrefix(year)}${padded}`;
+}
+function parseReportSequenceNumber(reference, year) {
+  if (typeof reference !== "string") return null;
+  const prefix = reportReferencePrefix(year);
+  if (!reference.startsWith(prefix)) return null;
+  const tail = reference.slice(prefix.length);
+  if (!/^\d+$/.test(tail)) return null;
+  const parsed = Number.parseInt(tail, 10);
+  if (!Number.isFinite(parsed) || parsed < FIRST_REPORT_SEQUENCE_NUMBER) return null;
+  return parsed;
+}
+function highestReportSequenceNumber(references, year) {
+  let highest = 0;
+  for (const reference of references) {
+    const parsed = parseReportSequenceNumber(reference, year);
+    if (parsed !== null && parsed > highest) highest = parsed;
+  }
+  return highest;
+}
+function nextReportSequenceNumber(highestSequenceNumber) {
+  if (typeof highestSequenceNumber !== "number" || !Number.isFinite(highestSequenceNumber)) {
+    return FIRST_REPORT_SEQUENCE_NUMBER;
+  }
+  const next = Math.floor(highestSequenceNumber) + 1;
+  return next < FIRST_REPORT_SEQUENCE_NUMBER ? FIRST_REPORT_SEQUENCE_NUMBER : next;
+}
+function allocateReportReference(year, highestSequenceNumber) {
+  const sequenceNumber = nextReportSequenceNumber(highestSequenceNumber);
+  return { sequenceNumber, reference: formatReportReference(year, sequenceNumber) };
+}
+function isReportReferenceConflict(err) {
+  return isUniqueViolation(err);
+}
+async function withReportReferenceRetry(runAttempt, options = {}) {
+  const maxAttempts = Math.max(1, options.maxAttempts ?? REPORT_REFERENCE_MAX_ATTEMPTS);
+  const isConflict = options.isConflict ?? isReportReferenceConflict;
+  let lastError = null;
+  for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+    try {
+      return await runAttempt(attempt);
+    } catch (err) {
+      if (!isConflict(err)) throw err;
+      lastError = err;
+    }
+  }
+  throw lastError;
+}
+export {
+  FIRST_REPORT_SEQUENCE_NUMBER,
+  REPORT_REFERENCE_MAX_ATTEMPTS,
+  REPORT_REFERENCE_PREFIX,
+  REPORT_SEQUENCE_PAD,
+  allocateReportReference,
+  formatReportReference,
+  highestReportSequenceNumber,
+  isReportReferenceConflict,
+  nextReportSequenceNumber,
+  parseReportSequenceNumber,
+  reportReferencePrefix,
+  reportReferenceYear,
+  withReportReferenceRetry
+};
+//# sourceMappingURL=reportReference.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/reportReference.ts"],
+  "sourcesContent": ["/**\n * Report numbering \u2014 the `RAP-2026-0042` printed on the sheet header of screen 14.\n *\n * The number is a billing document identifier: it is quoted on a PDF a client\n * keeps, so it is allocated once, frozen, and **never reused**. Two consequences\n * follow and are both enforced here:\n *\n *  1. **The highest number ever handed out wins, deleted reports included.** The\n *     unique index only covers live rows, so a soft-deleted `RAP-2026-0042` would\n *     otherwise let the next report take that number \u2014 and the client holding the\n *     first PDF would find a different report behind it.\n *  2. **Allocation races are settled by the database, not by a pre-read.** Reading\n *     `MAX(sequence)` up front only narrows the window; two people generating a\n *     report at the same moment would still both compute `0042`. The partial\n *     unique index on `(organization_id, tenant_id, reference) WHERE deleted_at IS\n *     NULL` makes the loser's insert fail, and the loser retries the whole\n *     transaction against a max that now includes the winner's row. This is the\n *     same shape `lib/timesheets-tasks/taskReference.ts` uses for `TT-142`.\n *\n * The year in the reference is the year the report is **issued**, not the year its\n * period covers: a report generated in January for December's work is a January\n * document, and its sequence belongs to the new year's run. The sheet prints the\n * issue date beside the reference, so the two always agree.\n */\n\nimport { isUniqueViolation } from '@open-mercato/shared/lib/crud/errors'\n\nexport const REPORT_REFERENCE_PREFIX = 'RAP'\n\nexport const FIRST_REPORT_SEQUENCE_NUMBER = 1\n\n/** Width of the zero-padded run, matching the mockup's `RAP-2026-0042`. */\nexport const REPORT_SEQUENCE_PAD = 4\n\n/**\n * Attempts before the conflict is surfaced. Each retry costs one aborted\n * transaction; an organization would need this many simultaneous generations\n * landing on the same number for the last one to give up.\n */\nexport const REPORT_REFERENCE_MAX_ATTEMPTS = 5\n\nexport type ReportReferenceAllocation = {\n  sequenceNumber: number\n  reference: string\n}\n\nexport function reportReferenceYear(issuedAt: Date | null | undefined): number {\n  if (!(issuedAt instanceof Date) || Number.isNaN(issuedAt.getTime())) {\n    return new Date().getFullYear()\n  }\n  return issuedAt.getFullYear()\n}\n\nexport function reportReferencePrefix(year: number): string {\n  return `${REPORT_REFERENCE_PREFIX}-${year}-`\n}\n\nexport function formatReportReference(year: number, sequenceNumber: number): string {\n  const padded = String(Math.max(FIRST_REPORT_SEQUENCE_NUMBER, sequenceNumber)).padStart(\n    REPORT_SEQUENCE_PAD,\n    '0',\n  )\n  return `${reportReferencePrefix(year)}${padded}`\n}\n\n/**\n * Reads the run number back out of a stored reference. Returns `null` for\n * anything that is not this year's series, so a hand-edited or legacy reference\n * can never inflate the next allocation.\n */\nexport function parseReportSequenceNumber(reference: unknown, year: number): number | null {\n  if (typeof reference !== 'string') return null\n  const prefix = reportReferencePrefix(year)\n  if (!reference.startsWith(prefix)) return null\n  const tail = reference.slice(prefix.length)\n  if (!/^\\d+$/.test(tail)) return null\n  const parsed = Number.parseInt(tail, 10)\n  if (!Number.isFinite(parsed) || parsed < FIRST_REPORT_SEQUENCE_NUMBER) return null\n  return parsed\n}\n\nexport function highestReportSequenceNumber(references: readonly unknown[], year: number): number {\n  let highest = 0\n  for (const reference of references) {\n    const parsed = parseReportSequenceNumber(reference, year)\n    if (parsed !== null && parsed > highest) highest = parsed\n  }\n  return highest\n}\n\nexport function nextReportSequenceNumber(highestSequenceNumber: number | null | undefined): number {\n  if (typeof highestSequenceNumber !== 'number' || !Number.isFinite(highestSequenceNumber)) {\n    return FIRST_REPORT_SEQUENCE_NUMBER\n  }\n  const next = Math.floor(highestSequenceNumber) + 1\n  return next < FIRST_REPORT_SEQUENCE_NUMBER ? FIRST_REPORT_SEQUENCE_NUMBER : next\n}\n\n/**\n * The candidate one attempt writes. A plain function of what that attempt read\n * inside its own transaction, so nothing is carried between attempts.\n */\nexport function allocateReportReference(\n  year: number,\n  highestSequenceNumber: number | null | undefined,\n): ReportReferenceAllocation {\n  const sequenceNumber = nextReportSequenceNumber(highestSequenceNumber)\n  return { sequenceNumber, reference: formatReportReference(year, sequenceNumber) }\n}\n\nexport function isReportReferenceConflict(err: unknown): boolean {\n  return isUniqueViolation(err)\n}\n\nexport type ReportReferenceRetryOptions = {\n  maxAttempts?: number\n  isConflict?: (err: unknown) => boolean\n}\n\n/**\n * Runs the create attempt until it wins the number or the budget runs out.\n *\n * `runAttempt` MUST re-read the organization's highest reference inside its own\n * transaction \u2014 that is the whole point of retrying rather than pre-reading. A\n * non-conflict error is rethrown immediately: only a lost race is worth\n * repeating.\n */\nexport async function withReportReferenceRetry<T>(\n  runAttempt: (attempt: number) => Promise<T>,\n  options: ReportReferenceRetryOptions = {},\n): Promise<T> {\n  const maxAttempts = Math.max(1, options.maxAttempts ?? REPORT_REFERENCE_MAX_ATTEMPTS)\n  const isConflict = options.isConflict ?? isReportReferenceConflict\n  let lastError: unknown = null\n\n  for (let attempt = 0; attempt < maxAttempts; attempt += 1) {\n    try {\n      return await runAttempt(attempt)\n    } catch (err) {\n      if (!isConflict(err)) throw err\n      lastError = err\n    }\n  }\n\n  throw lastError\n}\n"],
+  "mappings": "AAyBA,SAAS,yBAAyB;AAE3B,MAAM,0BAA0B;AAEhC,MAAM,+BAA+B;AAGrC,MAAM,sBAAsB;AAO5B,MAAM,gCAAgC;AAOtC,SAAS,oBAAoB,UAA2C;AAC7E,MAAI,EAAE,oBAAoB,SAAS,OAAO,MAAM,SAAS,QAAQ,CAAC,GAAG;AACnE,YAAO,oBAAI,KAAK,GAAE,YAAY;AAAA,EAChC;AACA,SAAO,SAAS,YAAY;AAC9B;AAEO,SAAS,sBAAsB,MAAsB;AAC1D,SAAO,GAAG,uBAAuB,IAAI,IAAI;AAC3C;AAEO,SAAS,sBAAsB,MAAc,gBAAgC;AAClF,QAAM,SAAS,OAAO,KAAK,IAAI,8BAA8B,cAAc,CAAC,EAAE;AAAA,IAC5E;AAAA,IACA;AAAA,EACF;AACA,SAAO,GAAG,sBAAsB,IAAI,CAAC,GAAG,MAAM;AAChD;AAOO,SAAS,0BAA0B,WAAoB,MAA6B;AACzF,MAAI,OAAO,cAAc,SAAU,QAAO;AAC1C,QAAM,SAAS,sBAAsB,IAAI;AACzC,MAAI,CAAC,UAAU,WAAW,MAAM,EAAG,QAAO;AAC1C,QAAM,OAAO,UAAU,MAAM,OAAO,MAAM;AAC1C,MAAI,CAAC,QAAQ,KAAK,IAAI,EAAG,QAAO;AAChC,QAAM,SAAS,OAAO,SAAS,MAAM,EAAE;AACvC,MAAI,CAAC,OAAO,SAAS,MAAM,KAAK,SAAS,6BAA8B,QAAO;AAC9E,SAAO;AACT;AAEO,SAAS,4BAA4B,YAAgC,MAAsB;AAChG,MAAI,UAAU;AACd,aAAW,aAAa,YAAY;AAClC,UAAM,SAAS,0BAA0B,WAAW,IAAI;AACxD,QAAI,WAAW,QAAQ,SAAS,QAAS,WAAU;AAAA,EACrD;AACA,SAAO;AACT;AAEO,SAAS,yBAAyB,uBAA0D;AACjG,MAAI,OAAO,0BAA0B,YAAY,CAAC,OAAO,SAAS,qBAAqB,GAAG;AACxF,WAAO;AAAA,EACT;AACA,QAAM,OAAO,KAAK,MAAM,qBAAqB,IAAI;AACjD,SAAO,OAAO,+BAA+B,+BAA+B;AAC9E;AAMO,SAAS,wBACd,MACA,uBAC2B;AAC3B,QAAM,iBAAiB,yBAAyB,qBAAqB;AACrE,SAAO,EAAE,gBAAgB,WAAW,sBAAsB,MAAM,cAAc,EAAE;AAClF;AAEO,SAAS,0BAA0B,KAAuB;AAC/D,SAAO,kBAAkB,GAAG;AAC9B;AAeA,eAAsB,yBACpB,YACA,UAAuC,CAAC,GAC5B;AACZ,QAAM,cAAc,KAAK,IAAI,GAAG,QAAQ,eAAe,6BAA6B;AACpF,QAAM,aAAa,QAAQ,cAAc;AACzC,MAAI,YAAqB;AAEzB,WAAS,UAAU,GAAG,UAAU,aAAa,WAAW,GAAG;AACzD,QAAI;AACF,aAAO,MAAM,WAAW,OAAO;AAAA,IACjC,SAAS,KAAK;AACZ,UAAI,CAAC,WAAW,GAAG,EAAG,OAAM;AAC5B,kBAAY;AAAA,IACd;AAAA,EACF;AAEA,QAAM;AACR;",
+  "names": []
+}

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

@@ -0,0 +1,42 @@
+import { formatReportMinutes, resolveEntryValues, sumAmounts } from "./reportTotals.js";
+function buildReportRows(input) {
+  const projectById = new Map(input.projects.map((project) => [project.id, project]));
+  const rows = input.entries.map((entry) => {
+    const project = projectById.get(entry.timeProjectId) ?? null;
+    const values = resolveEntryValues(entry, project);
+    const taskId = entry.taskId ?? null;
+    return {
+      entryId: entry.id,
+      date: entry.date,
+      projectId: entry.timeProjectId,
+      projectName: project?.name ?? entry.timeProjectId,
+      taskLabel: (taskId ? input.directory.taskLabelById[taskId] : null) ?? input.labels.unassignedTask,
+      personLabel: (entry.staffMemberId ? input.directory.personLabelById[entry.staffMemberId] : null) ?? input.labels.unassignedPerson,
+      description: entry.description ?? "",
+      rawMinutes: values.rawMinutes,
+      minutes: values.minutes,
+      hours: formatReportMinutes(values.minutes),
+      isBillable: values.isBillable,
+      rate: values.rate,
+      amount: values.amount,
+      hasOverride: values.hasOverride,
+      isFrozen: values.isFrozen
+    };
+  });
+  rows.sort(
+    (left, right) => left.date.localeCompare(right.date) || left.projectName.localeCompare(right.projectName) || left.taskLabel.localeCompare(right.taskLabel)
+  );
+  return rows;
+}
+function sumReportRowAmounts(rows) {
+  return sumAmounts(rows.map((row) => row.amount));
+}
+function sumReportRowMinutes(rows, billable) {
+  return rows.reduce((total, row) => row.isBillable === billable ? total + row.minutes : total, 0);
+}
+export {
+  buildReportRows,
+  sumReportRowAmounts,
+  sumReportRowMinutes
+};
+//# sourceMappingURL=reportRows.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/reportRows.ts"],
+  "sourcesContent": ["/**\n * The raw, one-line-per-entry view of a report.\n *\n * Screen 14 note 3: the PDF mirrors the grouped sheet, while CSV and XLSX add\n * the raw columns accounting actually needs \u2014 date, person, description \u2014 which\n * the grouped sheet deliberately does not print for a client. Screen 15's\n * \"locked entries\" table reads the same rows.\n *\n * Amounts come from `resolveEntryValues`, the same function the grouped sheet\n * and the freeze records use, so an accountant reconciling the CSV against the\n * PDF total never finds a discrepancy.\n */\n\nimport { formatReportMinutes, resolveEntryValues, sumAmounts } from './reportTotals'\nimport type { ReportDirectory, ReportInputEntry, ReportInputProject } from './reportTotals'\n\nexport type ReportRow = {\n  entryId: string\n  date: string\n  projectId: string\n  projectName: string\n  taskLabel: string\n  personLabel: string\n  description: string\n  rawMinutes: number\n  minutes: number\n  hours: string\n  isBillable: boolean\n  rate: number | null\n  amount: number | null\n  hasOverride: boolean\n  isFrozen: boolean\n}\n\nexport type BuildReportRowsInput = {\n  entries: readonly ReportInputEntry[]\n  projects: readonly ReportInputProject[]\n  directory: ReportDirectory\n  labels: { unassignedTask: string; unassignedPerson: string }\n}\n\nexport function buildReportRows(input: BuildReportRowsInput): ReportRow[] {\n  const projectById = new Map(input.projects.map((project) => [project.id, project]))\n  const rows = input.entries.map((entry) => {\n    const project = projectById.get(entry.timeProjectId) ?? null\n    const values = resolveEntryValues(entry, project)\n    const taskId = entry.taskId ?? null\n    return {\n      entryId: entry.id,\n      date: entry.date,\n      projectId: entry.timeProjectId,\n      projectName: project?.name ?? entry.timeProjectId,\n      taskLabel: (taskId ? input.directory.taskLabelById[taskId] : null) ?? input.labels.unassignedTask,\n      personLabel:\n        (entry.staffMemberId ? input.directory.personLabelById[entry.staffMemberId] : null) ??\n        input.labels.unassignedPerson,\n      description: entry.description ?? '',\n      rawMinutes: values.rawMinutes,\n      minutes: values.minutes,\n      hours: formatReportMinutes(values.minutes),\n      isBillable: values.isBillable,\n      rate: values.rate,\n      amount: values.amount,\n      hasOverride: values.hasOverride,\n      isFrozen: values.isFrozen,\n    } satisfies ReportRow\n  })\n\n  rows.sort(\n    (left, right) =>\n      left.date.localeCompare(right.date) ||\n      left.projectName.localeCompare(right.projectName) ||\n      left.taskLabel.localeCompare(right.taskLabel),\n  )\n  return rows\n}\n\n/**\n * The rows' amounts add up to the report's grand total by construction \u2014 same\n * per-entry values, summed in integer cents. Exposed so the export and the\n * screen can assert it rather than assume it.\n */\nexport function sumReportRowAmounts(rows: readonly ReportRow[]): number {\n  return sumAmounts(rows.map((row) => row.amount))\n}\n\nexport function sumReportRowMinutes(rows: readonly ReportRow[], billable: boolean): number {\n  return rows.reduce((total, row) => (row.isBillable === billable ? total + row.minutes : total), 0)\n}\n"],
+  "mappings": "AAaA,SAAS,qBAAqB,oBAAoB,kBAAkB;AA4B7D,SAAS,gBAAgB,OAA0C;AACxE,QAAM,cAAc,IAAI,IAAI,MAAM,SAAS,IAAI,CAAC,YAAY,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;AAClF,QAAM,OAAO,MAAM,QAAQ,IAAI,CAAC,UAAU;AACxC,UAAM,UAAU,YAAY,IAAI,MAAM,aAAa,KAAK;AACxD,UAAM,SAAS,mBAAmB,OAAO,OAAO;AAChD,UAAM,SAAS,MAAM,UAAU;AAC/B,WAAO;AAAA,MACL,SAAS,MAAM;AAAA,MACf,MAAM,MAAM;AAAA,MACZ,WAAW,MAAM;AAAA,MACjB,aAAa,SAAS,QAAQ,MAAM;AAAA,MACpC,YAAY,SAAS,MAAM,UAAU,cAAc,MAAM,IAAI,SAAS,MAAM,OAAO;AAAA,MACnF,cACG,MAAM,gBAAgB,MAAM,UAAU,gBAAgB,MAAM,aAAa,IAAI,SAC9E,MAAM,OAAO;AAAA,MACf,aAAa,MAAM,eAAe;AAAA,MAClC,YAAY,OAAO;AAAA,MACnB,SAAS,OAAO;AAAA,MAChB,OAAO,oBAAoB,OAAO,OAAO;AAAA,MACzC,YAAY,OAAO;AAAA,MACnB,MAAM,OAAO;AAAA,MACb,QAAQ,OAAO;AAAA,MACf,aAAa,OAAO;AAAA,MACpB,UAAU,OAAO;AAAA,IACnB;AAAA,EACF,CAAC;AAED,OAAK;AAAA,IACH,CAAC,MAAM,UACL,KAAK,KAAK,cAAc,MAAM,IAAI,KAClC,KAAK,YAAY,cAAc,MAAM,WAAW,KAChD,KAAK,UAAU,cAAc,MAAM,SAAS;AAAA,EAChD;AACA,SAAO;AACT;AAOO,SAAS,oBAAoB,MAAoC;AACtE,SAAO,WAAW,KAAK,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC;AACjD;AAEO,SAAS,oBAAoB,MAA4B,UAA2B;AACzF,SAAO,KAAK,OAAO,CAAC,OAAO,QAAS,IAAI,eAAe,WAAW,QAAQ,IAAI,UAAU,OAAQ,CAAC;AACnG;",
+  "names": []
+}

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

@@ -0,0 +1,107 @@
+import { parseReportPreview, readNumber } from "./reportConfigData.js";
+function readString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function readCustomerName(snapshot) {
+  if (!snapshot || typeof snapshot !== "object") return null;
+  const row = snapshot;
+  for (const key of ["name", "displayName", "display_name", "legalName", "legal_name"]) {
+    const value = readString(row[key]);
+    if (value) return value;
+  }
+  return null;
+}
+function parseReportSheet(payload) {
+  if (!payload || typeof payload !== "object") return null;
+  const row = payload;
+  const reportRaw = row.report;
+  if (!reportRaw || typeof reportRaw !== "object") return null;
+  const report = reportRaw;
+  const id = readString(report.id);
+  if (!id) return null;
+  const preview = parseReportPreview({
+    currencyCode: report.currencyCode,
+    grouping: report.grouping,
+    nonbillableMode: report.nonbillableMode,
+    includeAlreadyReported: report.includeAlreadyReported,
+    showRates: report.showRates,
+    projects: [],
+    groups: row.groups,
+    totals: row.totals,
+    alreadyReportedCount: row.alreadyReportedCount,
+    alreadyReportedMinutes: row.alreadyReportedMinutes,
+    alreadyReportedIn: row.alreadyReportedIn,
+    rounding: { unitMinutes: report.roundingUnitMinutes, direction: report.roundingDirection }
+  });
+  if (!preview) return null;
+  return {
+    report: {
+      id,
+      reference: readString(report.reference) ?? "",
+      title: readString(report.title) ?? "",
+      status: report.status === "closed" ? "closed" : "draft",
+      customerId: readString(report.customerId),
+      customerName: readCustomerName(report.customerSnapshot),
+      periodFrom: readString(report.periodFrom),
+      periodTo: readString(report.periodTo),
+      currencyCode: preview.currencyCode,
+      grouping: preview.grouping,
+      nonbillableMode: preview.nonbillableMode,
+      includeAlreadyReported: preview.includeAlreadyReported,
+      showRates: preview.showRates,
+      roundingUnitMinutes: preview.rounding.unitMinutes,
+      roundingDirection: preview.rounding.direction,
+      closedAt: readString(report.closedAt),
+      closedByUserId: readString(report.closedByUserId),
+      timeProjectIds: Array.isArray(report.timeProjectIds) ? report.timeProjectIds.filter((value) => typeof value === "string") : []
+    },
+    groups: preview.groups,
+    totals: preview.totals,
+    alreadyReportedCount: preview.alreadyReportedCount,
+    alreadyReportedMinutes: preview.alreadyReportedMinutes,
+    rows: Array.isArray(row.rows) ? row.rows.map((entry) => {
+      if (!entry || typeof entry !== "object") return null;
+      const source = entry;
+      const entryId = readString(source.entryId);
+      if (!entryId) return null;
+      return {
+        entryId,
+        date: readString(source.date) ?? "",
+        projectName: readString(source.projectName) ?? "",
+        taskLabel: readString(source.taskLabel) ?? "",
+        personLabel: readString(source.personLabel) ?? "",
+        description: readString(source.description) ?? "",
+        minutes: readNumber(source.minutes) ?? 0,
+        rawMinutes: readNumber(source.rawMinutes) ?? 0,
+        hours: readString(source.hours) ?? "",
+        isBillable: source.isBillable !== false,
+        rate: readNumber(source.rate),
+        amount: readNumber(source.amount),
+        hasOverride: source.hasOverride === true
+      };
+    }).filter((entry) => entry !== null) : [],
+    rowCount: readNumber(row.rowCount) ?? 0,
+    rowsTruncated: row.rowsTruncated === true,
+    events: Array.isArray(row.events) ? row.events.map((entry) => {
+      if (!entry || typeof entry !== "object") return null;
+      const source = entry;
+      const eventId = readString(source.id);
+      const eventType = source.eventType;
+      if (!eventId) return null;
+      if (eventType !== "closed" && eventType !== "unlocked" && eventType !== "exported") return null;
+      return {
+        id: eventId,
+        eventType,
+        reason: readString(source.reason),
+        actorUserId: readString(source.actorUserId),
+        metadata: source.metadata && typeof source.metadata === "object" ? source.metadata : null,
+        createdAt: readString(source.createdAt)
+      };
+    }).filter((entry) => entry !== null) : []
+  };
+}
+export {
+  parseReportSheet,
+  readCustomerName
+};
+//# sourceMappingURL=reportSheetData.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/reportSheetData.ts"],
+  "sourcesContent": ["/**\n * Client-side parsing for `GET .../reports/[id]/sheet`.\n *\n * Defensive for the same reason `reportConfigData` is: these numbers are printed\n * on a document a client can dispute, so a shape surprise must yield a visibly\n * empty sheet rather than a plausible wrong figure.\n */\n\nimport { parseReportPreview, readNumber, type PreviewGroup } from './reportConfigData'\n\nexport type ReportEventType = 'closed' | 'unlocked' | 'exported'\n\nexport type ReportHistoryEvent = {\n  id: string\n  eventType: ReportEventType\n  reason: string | null\n  actorUserId: string | null\n  metadata: Record<string, unknown> | null\n  createdAt: string | null\n}\n\nexport type ReportSheetRow = {\n  entryId: string\n  date: string\n  projectName: string\n  taskLabel: string\n  personLabel: string\n  description: string\n  minutes: number\n  rawMinutes: number\n  hours: string\n  isBillable: boolean\n  rate: number | null\n  amount: number | null\n  hasOverride: boolean\n}\n\nexport type ReportSheetHeader = {\n  id: string\n  reference: string\n  title: string\n  status: 'draft' | 'closed'\n  customerId: string | null\n  customerName: string | null\n  periodFrom: string | null\n  periodTo: string | null\n  currencyCode: string | null\n  grouping: 'project_task' | 'project_person' | 'project_day'\n  nonbillableMode: 'separate' | 'exclude'\n  includeAlreadyReported: boolean\n  showRates: boolean\n  roundingUnitMinutes: number\n  roundingDirection: string\n  closedAt: string | null\n  closedByUserId: string | null\n  timeProjectIds: string[]\n}\n\nexport type ReportSheetPayload = {\n  report: ReportSheetHeader\n  groups: PreviewGroup[]\n  totals: {\n    entryCount: number\n    billableMinutes: number\n    nonbillableMinutes: number\n    totalAmount: number | null\n  }\n  alreadyReportedCount: number\n  alreadyReportedMinutes: number\n  rows: ReportSheetRow[]\n  rowCount: number\n  rowsTruncated: boolean\n  events: ReportHistoryEvent[]\n}\n\nfunction readString(value: unknown): string | null {\n  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null\n}\n\n/** D-9: the customer name comes from the report's own snapshot, never a join. */\nexport function readCustomerName(snapshot: unknown): string | null {\n  if (!snapshot || typeof snapshot !== 'object') return null\n  const row = snapshot as Record<string, unknown>\n  for (const key of ['name', 'displayName', 'display_name', 'legalName', 'legal_name']) {\n    const value = readString(row[key])\n    if (value) return value\n  }\n  return null\n}\n\nexport function parseReportSheet(payload: unknown): ReportSheetPayload | null {\n  if (!payload || typeof payload !== 'object') return null\n  const row = payload as Record<string, unknown>\n  const reportRaw = row.report\n  if (!reportRaw || typeof reportRaw !== 'object') return null\n  const report = reportRaw as Record<string, unknown>\n  const id = readString(report.id)\n  if (!id) return null\n\n  // The grouped sheet has exactly the preview's shape, so it goes through the\n  // same parser \u2014 one place decides what a malformed group means.\n  const preview = parseReportPreview({\n    currencyCode: report.currencyCode,\n    grouping: report.grouping,\n    nonbillableMode: report.nonbillableMode,\n    includeAlreadyReported: report.includeAlreadyReported,\n    showRates: report.showRates,\n    projects: [],\n    groups: row.groups,\n    totals: row.totals,\n    alreadyReportedCount: row.alreadyReportedCount,\n    alreadyReportedMinutes: row.alreadyReportedMinutes,\n    alreadyReportedIn: row.alreadyReportedIn,\n    rounding: { unitMinutes: report.roundingUnitMinutes, direction: report.roundingDirection },\n  })\n  if (!preview) return null\n\n  return {\n    report: {\n      id,\n      reference: readString(report.reference) ?? '',\n      title: readString(report.title) ?? '',\n      status: report.status === 'closed' ? 'closed' : 'draft',\n      customerId: readString(report.customerId),\n      customerName: readCustomerName(report.customerSnapshot),\n      periodFrom: readString(report.periodFrom),\n      periodTo: readString(report.periodTo),\n      currencyCode: preview.currencyCode,\n      grouping: preview.grouping,\n      nonbillableMode: preview.nonbillableMode,\n      includeAlreadyReported: preview.includeAlreadyReported,\n      showRates: preview.showRates,\n      roundingUnitMinutes: preview.rounding.unitMinutes,\n      roundingDirection: preview.rounding.direction,\n      closedAt: readString(report.closedAt),\n      closedByUserId: readString(report.closedByUserId),\n      timeProjectIds: Array.isArray(report.timeProjectIds)\n        ? report.timeProjectIds.filter((value): value is string => typeof value === 'string')\n        : [],\n    },\n    groups: preview.groups,\n    totals: preview.totals,\n    alreadyReportedCount: preview.alreadyReportedCount,\n    alreadyReportedMinutes: preview.alreadyReportedMinutes,\n    rows: Array.isArray(row.rows)\n      ? row.rows\n          .map((entry) => {\n            if (!entry || typeof entry !== 'object') return null\n            const source = entry as Record<string, unknown>\n            const entryId = readString(source.entryId)\n            if (!entryId) return null\n            return {\n              entryId,\n              date: readString(source.date) ?? '',\n              projectName: readString(source.projectName) ?? '',\n              taskLabel: readString(source.taskLabel) ?? '',\n              personLabel: readString(source.personLabel) ?? '',\n              description: readString(source.description) ?? '',\n              minutes: readNumber(source.minutes) ?? 0,\n              rawMinutes: readNumber(source.rawMinutes) ?? 0,\n              hours: readString(source.hours) ?? '',\n              isBillable: source.isBillable !== false,\n              rate: readNumber(source.rate),\n              amount: readNumber(source.amount),\n              hasOverride: source.hasOverride === true,\n            } satisfies ReportSheetRow\n          })\n          .filter((entry): entry is ReportSheetRow => entry !== null)\n      : [],\n    rowCount: readNumber(row.rowCount) ?? 0,\n    rowsTruncated: row.rowsTruncated === true,\n    events: Array.isArray(row.events)\n      ? row.events\n          .map((entry) => {\n            if (!entry || typeof entry !== 'object') return null\n            const source = entry as Record<string, unknown>\n            const eventId = readString(source.id)\n            const eventType = source.eventType\n            if (!eventId) return null\n            if (eventType !== 'closed' && eventType !== 'unlocked' && eventType !== 'exported') return null\n            return {\n              id: eventId,\n              eventType,\n              reason: readString(source.reason),\n              actorUserId: readString(source.actorUserId),\n              metadata:\n                source.metadata && typeof source.metadata === 'object'\n                  ? (source.metadata as Record<string, unknown>)\n                  : null,\n              createdAt: readString(source.createdAt),\n            } satisfies ReportHistoryEvent\n          })\n          .filter((entry): entry is ReportHistoryEvent => entry !== null)\n      : [],\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}