@happyvertical/smrt-timesheets 0.53.4 → 0.53.6

package/dist/chunks/service-time-entry-Kjeix3EU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-time-entry-Kjeix3EU.js","names":[],"sources":["../../src/__smrt-register__.ts","../../src/models/json.ts","../../src/models/service-time-entry.ts"],"sourcesContent":["/**\n * Self-registers this package's build-time manifest before any @smrt() decorator\n * in the package fires. Fixes issue #1132: in consumer runtimes (tsx, SvelteKit\n * SSR, plain `vite dev`) the decorator's synchronous manifest lookup previously\n * missed because no step populated the global manifest cache — classes got\n * registered with zero fields and `save()` / `toJSON()` silently dropped every\n * declared property.\n *\n * Import this module as the first statement in `src/index.ts` so its top-level\n * side effect runs ahead of any class module's @smrt() decorator.\n *\n * Silent no-op in dev/test, where the vitest plugin already populates manifests\n * via a different path. Only needs to succeed in the published dist output.\n *\n * @see https://github.com/happyvertical/smrt/issues/1132\n */\nimport { ObjectRegistry } from '@happyvertical/smrt-core';\n\n// During library builds, smrtPlugin replaces this entire module with generated\n// code that embeds the scanned manifest inline (#1506/#1507) — published dists\n// never resolve this URL, so downstream bundlers cannot break registration by\n// relocating the compiled module away from dist/manifest.json. The runtime\n// lookup below is the fallback for source-mode runs without that transform.\nObjectRegistry.registerPackageManifest(\n  new URL('./manifest.json', import.meta.url),\n);\n","/**\n * Parse a JSON value stored as text, returning `fallback` on malformed input.\n * Stored JSON may predate a schema change, so reads never throw.\n */\nexport function parseTimesheetJson<T>(value: string, fallback: T): T {\n  try {\n    return JSON.parse(value) as T;\n  } catch {\n    return fallback;\n  }\n}\n","import {\n  crossPackageRef,\n  field,\n  foreignKey,\n  SmrtCollection,\n  SmrtObject,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport {\n  SERVICE_TIME_ENTRY_STATUS_TRANSITIONS,\n  type ServiceEvidence,\n  type ServiceParticipantKind,\n  type ServiceTimeEntrySource,\n  type ServiceTimeEntryStatus,\n} from '../types.js';\nimport { parseTimesheetJson } from './json.js';\n\n/**\n * Fields that may not change once an entry is approved (or corrected). A\n * subtype that adds its own work context extends the list through\n * {@link ServiceTimeEntry.frozenFieldNames}.\n */\nexport const SERVICE_TIME_ENTRY_FROZEN_FIELDS = [\n  'tenantId',\n  'workRefType',\n  'workRefId',\n  'participantKind',\n  'participantProfileId',\n  'agentRef',\n  'source',\n  'description',\n  'startedAt',\n  'endedAt',\n  'durationSeconds',\n  'evidence',\n  'correctionOfId',\n] as const;\n\nfunction toColumn(key: string): string {\n  return key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);\n}\n\nfunction frozenView(\n  source: Record<string, unknown>,\n  fields: readonly string[],\n): string {\n  const result: Record<string, unknown> = {};\n  for (const key of fields) {\n    let value = source[key] ?? null;\n    if ((key === 'startedAt' || key === 'endedAt') && value) {\n      const date = value instanceof Date ? value : new Date(String(value));\n      value = Number.isNaN(date.getTime()) ? String(value) : date.toISOString();\n    }\n    if (key === 'durationSeconds' && value !== null) value = Number(value);\n    result[key] = value === '' ? null : value;\n  }\n  return JSON.stringify(result);\n}\n\nconst loadedStatus = new WeakMap<ServiceTimeEntry, ServiceTimeEntryStatus>();\n\n/**\n * A person or agent worked this long on this thing, and someone approved it.\n *\n * The base entry carries a generic work reference (`workRefType` qualified\n * class name + `workRefId`) and no domain-specific foreign key; a domain adds\n * its own context by subclassing over the same `service_time_entries` table\n * (smrt-support's subtype adds `caseId` / `specialistId`). Entries carry no\n * rate: charge and compensation live on the immutable snapshot models.\n *\n * Status moves `draft → submitted → approved | rejected`; an approved entry\n * never changes, and a correction is a new row whose `correctionOfId` points\n * at the entry it corrects, which flips to `corrected`.\n */\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: 'service_time_entries',\n  // Moved from smrt-projects in #3288; stored references keep resolving.\n  previousQualifiedNames: ['@happyvertical/smrt-projects:ServiceTimeEntry'],\n  api: { include: ['list', 'get'] },\n  cli: { include: ['list', 'get'] },\n  mcp: { include: ['list', 'get'] },\n})\nexport class ServiceTimeEntry extends SmrtObject {\n  @tenantId({ nullable: true }) tenantId: string | null = null;\n  @field({ type: 'text', nullable: true }) workRefType: string | null = null;\n  @field({ type: 'text', nullable: true }) workRefId: string | null = null;\n  @field({ type: 'text' }) participantKind: ServiceParticipantKind = 'human';\n  @crossPackageRef('@happyvertical/smrt-profiles:Profile', { nullable: true })\n  participantProfileId: string | null = null;\n  @field({ type: 'text' }) agentRef: string = '';\n  @field({ type: 'text' }) source: ServiceTimeEntrySource = 'manual';\n  @field({ type: 'text' }) description: string = '';\n  startedAt: Date | null = null;\n  endedAt: Date | null = null;\n  /** Integer seconds, or null for an explicit decimal-hours-only source. */\n  @field({ type: 'integer', nullable: true })\n  durationSeconds: number | null = 0;\n  @field({ type: 'text' }) evidence: string = '[]';\n  @field({ type: 'text' }) status: ServiceTimeEntryStatus = 'draft';\n  submittedAt: Date | null = null;\n  @crossPackageRef('@happyvertical/smrt-profiles:Profile', { nullable: true })\n  submittedByProfileId: string | null = null;\n  approvedAt: Date | null = null;\n  @crossPackageRef('@happyvertical/smrt-profiles:Profile', { nullable: true })\n  approvedByProfileId: string | null = null;\n  @field({ type: 'text' }) approvalPath: string = '';\n  rejectedAt: Date | null = null;\n  @crossPackageRef('@happyvertical/smrt-profiles:Profile', { nullable: true })\n  rejectedByProfileId: string | null = null;\n  @field({ type: 'text' }) rejectionReason: string = '';\n  @foreignKey('ServiceTimeEntry') correctionOfId: string | null = null;\n  @field({ type: 'text' }) metadata: string = '{}';\n\n  getEvidence(): ServiceEvidence[] {\n    return parseTimesheetJson(this.evidence, []);\n  }\n  setEvidence(value: ServiceEvidence[]): void {\n    this.evidence = JSON.stringify(value ?? []);\n  }\n  getMetadata(): Record<string, unknown> {\n    return parseTimesheetJson(this.metadata, {});\n  }\n  setMetadata(value: Record<string, unknown>): void {\n    this.metadata = JSON.stringify(value ?? {});\n  }\n  /** Original decimal-hours text, without binary floating-point conversion. */\n  durationHoursExact(): string | null {\n    const evidence = this.getEvidence();\n    const quantities = (Array.isArray(evidence) ? evidence : []).filter(\n      (item) => item?.kind === SERVICE_DURATION_HOURS_EVIDENCE,\n    );\n    if (quantities.length === 0) return null;\n    if (quantities.length !== 1)\n      throw new Error(\n        'Service time requires exactly one decimal-hours quantity.',\n      );\n    return validateDurationHours(quantities[0].hours);\n  }\n\n  /** Numeric convenience for display; use durationHoursExact() for exact terms. */\n  durationHours(): number {\n    if (this.durationSeconds !== null) return this.durationSeconds / 3600;\n    const hours = this.durationHoursExact();\n    if (hours === null)\n      throw new Error('Service time has no supported duration quantity.');\n    return Number(hours);\n  }\n\n  /** Guard for consumers whose policies require independently supplied seconds. */\n  requireDurationSeconds(): number {\n    if (this.durationSeconds === null)\n      throw new Error(\n        'Decimal-hours-only service time has no measured durationSeconds; use durationHoursExact() with an hours-aware policy.',\n      );\n    return this.durationSeconds;\n  }\n\n  /**\n   * Fields frozen once the entry is approved. Subtypes that add work context\n   * (e.g. a support case) return `[...super.frozenFieldNames(), ...]`.\n   */\n  protected frozenFieldNames(): readonly string[] {\n    return SERVICE_TIME_ENTRY_FROZEN_FIELDS;\n  }\n\n  override async initialize(): Promise<this> {\n    await super.initialize();\n    if (await this.isSaved()) loadedStatus.set(this, this.status);\n    return this;\n  }\n\n  override async save(): Promise<this> {\n    const hours = this.durationHoursExact();\n    if (hours !== null) {\n      if (\n        this.durationSeconds !== null ||\n        this.startedAt ||\n        this.endedAt ||\n        this.source === 'timer'\n      )\n        throw new Error(\n          'Decimal-hours-only service time cannot also supply seconds or timestamps.',\n        );\n    } else if (this.durationSeconds === null) {\n      throw new Error(\n        'Null durationSeconds requires explicit decimal-hours evidence.',\n      );\n    }\n    const prior = await this.readPrior();\n    if (\n      prior &&\n      prior.status !== this.status &&\n      !SERVICE_TIME_ENTRY_STATUS_TRANSITIONS[prior.status].includes(this.status)\n    ) {\n      throw new Error(\n        `ServiceTimeEntry ${this.id}: illegal status transition '${prior.status}' → '${this.status}'.`,\n      );\n    }\n    if (\n      prior &&\n      (prior.status === 'approved' || prior.status === 'corrected')\n    ) {\n      const current = frozenView(\n        this as unknown as Record<string, unknown>,\n        this.frozenFieldNames(),\n      );\n      if (current !== prior.frozen) {\n        throw new Error(\n          'Approved ServiceTimeEntry evidence is immutable; create a correction instead.',\n        );\n      }\n    }\n    const result = (await super.save()) as this;\n    loadedStatus.set(this, this.status);\n    return result;\n  }\n\n  private async readPrior(): Promise<{\n    status: ServiceTimeEntryStatus;\n    frozen: string;\n  } | null> {\n    if (!this.id) return null;\n    const fields = this.frozenFieldNames();\n    try {\n      const row = await this.db.get(this.tableName, { id: this.id });\n      if (!row?.status) return null;\n      const values: Record<string, unknown> = {};\n      for (const key of fields) {\n        values[key] = row[toColumn(key)];\n      }\n      return {\n        status: row.status as ServiceTimeEntryStatus,\n        frozen: frozenView(values, fields),\n      };\n    } catch {\n      const status = loadedStatus.get(this);\n      return status\n        ? {\n            status,\n            frozen: frozenView(\n              this as unknown as Record<string, unknown>,\n              fields,\n            ),\n          }\n        : null;\n    }\n  }\n}\n\n/** Collection over `service_time_entries`. */\nexport class ServiceTimeEntryCollection extends SmrtCollection<ServiceTimeEntry> {\n  static readonly _itemClass = ServiceTimeEntry;\n  async forWork(\n    workRefType: string,\n    workRefId: string,\n  ): Promise<ServiceTimeEntry[]> {\n    return this.list({\n      where: { workRefType, workRefId },\n      orderBy: 'created_at ASC',\n    });\n  }\n  async pendingApproval(): Promise<ServiceTimeEntry[]> {\n    return this.list({\n      where: { status: 'submitted' },\n      orderBy: 'submitted_at ASC',\n    });\n  }\n}\n\n/** Reserved evidence kind for a source quantity with no measured elapsed seconds. */\nexport const SERVICE_DURATION_HOURS_EVIDENCE =\n  '@happyvertical/smrt-timesheets:duration-hours';\n\n/** Validate without normalizing the original accepted decimal text. */\nexport function validateDurationHours(value: unknown): string {\n  if (\n    typeof value !== 'string' ||\n    !/^\\d+(?:\\.\\d+)?$/.test(value) ||\n    !Number.isFinite(Number(value)) ||\n    Number(value) <= 0 ||\n    Number(value) >= Number.MAX_SAFE_INTEGER\n  )\n    throw new Error(\n      'Service time durationHours must be positive plain decimal text within the supported numeric range.',\n    );\n  return value;\n}\n"],"mappings":"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"}

package/dist/index.js

@@ -1,8 +1,8 @@
-import { n as ServiceTimeEntry, r as ServiceTimeEntryCollection, t as SERVICE_TIME_ENTRY_FROZEN_FIELDS } from "./chunks/service-time-entry-hVvWmo1p.js";
-import { a as AttendanceReplay, i as AttendancePunchCollection, n as AttendanceBreakCollection, o as AttendanceReplayCollection, r as AttendancePunch, t as AttendanceBreak } from "./chunks/models-B4dKxWQL.js";
+import { a as validateDurationHours, i as ServiceTimeEntryCollection, n as SERVICE_TIME_ENTRY_FROZEN_FIELDS, r as ServiceTimeEntry, t as SERVICE_DURATION_HOURS_EVIDENCE } from "./chunks/service-time-entry-Kjeix3EU.js";
+import { a as AttendanceReplay, i as AttendancePunchCollection, n as AttendanceBreakCollection, o as AttendanceReplayCollection, r as AttendancePunch, t as AttendanceBreak } from "./chunks/models-BY7ZKK79.js";
 import { SERVICE_TIME_ENTRY_STATUS_TRANSITIONS } from "./types.js";
 import { AttendanceConflict, AttendanceService } from "./attendance.js";
-import { a as PeriodTimecard, c as TimecardAdjustmentCollection, o as PeriodTimecardCollection, s as TimecardAdjustment, t as PeriodRollupService } from "./chunks/rollup-uEAMRkKb.js";
+import { a as PeriodTimecard, c as TimecardAdjustmentCollection, o as PeriodTimecardCollection, s as TimecardAdjustment, t as PeriodRollupService } from "./chunks/rollup-kwRmgW9t.js";
 import { TIMESHEETS_MODULE_META, TIMESHEETS_UI_SLOTS } from "./ui.js";
 import { SmrtCollection, SmrtObject, ValidationError, field, foreignKey, smrt } from "@happyvertical/smrt-core";
 import { TenantScoped, tenantId } from "@happyvertical/smrt-tenancy";
@@ -173,18 +173,32 @@ var ServiceEvidenceService = class ServiceEvidenceService {
 		return new ServiceEvidenceService(entries, charges, compensation, commercial);
 	}
 	async record(input) {
+		if (![
+			"timer",
+			"manual",
+			"import",
+			"agent"
+		].includes(input.source)) throw new Error("Unsupported service time source.");
 		if (Boolean(input.workRefType) !== Boolean(input.workRefId)) throw new Error("workRefType and workRefId must be provided together.");
 		if (!(input.workRefType && input.workRefId)) throw new Error("Service time requires a work reference.");
 		if (input.participantKind === "human" && !input.participantProfileId) throw new Error("Human service time requires participantProfileId.");
 		if (input.participantKind === "agent" && !input.agentRef) throw new Error("Agent service time requires agentRef.");
 		if (input.source === "timer" && (!input.startedAt || !input.endedAt)) throw new Error("Timer service time requires startedAt and endedAt.");
 		if (input.startedAt && input.endedAt && input.startedAt >= input.endedAt) throw new Error("Service time startedAt must be before endedAt.");
-		const duration = input.durationSeconds ?? (input.startedAt && input.endedAt ? Math.round((input.endedAt.getTime() - input.startedAt.getTime()) / 1e3) : 0);
-		if (!Number.isInteger(duration) || duration <= 0) throw new Error("Service time durationSeconds must be a positive integer.");
+		const { durationHours, ...fields } = input;
+		if (input.evidence?.some((item) => item?.kind === "@happyvertical/smrt-timesheets:duration-hours")) throw new Error("Use durationHours to supply reserved decimal-hours evidence.");
+		const hours = durationHours === void 0 ? null : validateDurationHours(durationHours);
+		if (hours !== null && (input.durationSeconds != null || input.startedAt || input.endedAt)) throw new Error("Decimal-hours-only service time cannot also supply seconds or timestamps.");
+		if (hours === null && input.durationSeconds === null) throw new Error("Null durationSeconds requires durationHours.");
+		const duration = hours !== null ? null : input.durationSeconds ?? (input.startedAt && input.endedAt ? Math.round((input.endedAt.getTime() - input.startedAt.getTime()) / 1e3) : 0);
+		if (duration !== null && (!Number.isSafeInteger(duration) || duration <= 0)) throw new Error("Service time durationSeconds must be a positive integer.");
 		const entry = await this.entries.create({
-			...input,
+			...fields,
 			durationSeconds: duration,
-			evidence: JSON.stringify(input.evidence ?? []),
+			evidence: JSON.stringify([...input.evidence ?? [], ...hours === null ? [] : [{
+				kind: SERVICE_DURATION_HOURS_EVIDENCE,
+				hours
+			}]]),
 			metadata: JSON.stringify(input.metadata ?? {}),
 			status: "draft",
 			submittedAt: null,
@@ -221,6 +235,7 @@ var ServiceEvidenceService = class ServiceEvidenceService {
 			limit: 1
 		}))[0];
 		if (entry.status === "approved" && existingCharge && existingCompensation) return entry;
+		await this.commercial.validateEntry?.(entry);
 		if (entry.status === "submitted") {
 			entry.status = "approved";
 			entry.approvedAt = /* @__PURE__ */ new Date();
@@ -233,6 +248,7 @@ var ServiceEvidenceService = class ServiceEvidenceService {
 				const concurrent = await this.entries.get(timeEntryId);
 				if (concurrent?.status !== "approved") throw error;
 				entry = concurrent;
+				await this.commercial.validateEntry?.(entry);
 			}
 		}
 		const provider = existingCompensation ? null : await this.commercial.compensateProvider(entry);
@@ -310,6 +326,6 @@ async function deterministicSnapshotId(kind, timeEntryId) {
 	].join("-");
 }
 //#endregion
-export { AttendanceBreak, AttendanceBreakCollection, AttendanceConflict, AttendancePunch, AttendancePunchCollection, AttendanceReplay, AttendanceReplayCollection, AttendanceService, PeriodRollupService, PeriodTimecard, PeriodTimecardCollection, SERVICE_TIME_ENTRY_FROZEN_FIELDS, SERVICE_TIME_ENTRY_STATUS_TRANSITIONS, ServiceChargeSnapshot, ServiceChargeSnapshotCollection, ServiceCompensationSnapshot, ServiceCompensationSnapshotCollection, ServiceEvidenceService, ServiceTimeEntry, ServiceTimeEntryCollection, TIMESHEETS_MODULE_META, TIMESHEETS_UI_SLOTS, TimecardAdjustment, TimecardAdjustmentCollection };
+export { AttendanceBreak, AttendanceBreakCollection, AttendanceConflict, AttendancePunch, AttendancePunchCollection, AttendanceReplay, AttendanceReplayCollection, AttendanceService, PeriodRollupService, PeriodTimecard, PeriodTimecardCollection, SERVICE_DURATION_HOURS_EVIDENCE, SERVICE_TIME_ENTRY_FROZEN_FIELDS, SERVICE_TIME_ENTRY_STATUS_TRANSITIONS, ServiceChargeSnapshot, ServiceChargeSnapshotCollection, ServiceCompensationSnapshot, ServiceCompensationSnapshotCollection, ServiceEvidenceService, ServiceTimeEntry, ServiceTimeEntryCollection, TIMESHEETS_MODULE_META, TIMESHEETS_UI_SLOTS, TimecardAdjustment, TimecardAdjustmentCollection };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/models/service-snapshots.ts","../src/services/service-evidence-service.ts"],"sourcesContent":["import {\n  field,\n  foreignKey,\n  SmrtCollection,\n  SmrtObject,\n  smrt,\n  ValidationError,\n} from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\n\n/**\n * Refuse an amount that is not a JavaScript-safe integer number of minor\n * units. SQLite stores `19.99` in an INTEGER column without complaint and\n * PostgreSQL rejects it only at the driver, so the model boundary is the one\n * place both engines (and every writer: collections, `ServiceEvidenceService`,\n * resolvers) get the same answer. Sign is not constrained here.\n */\nexport function assertSnapshotMinorUnits(model: string, amount: unknown): void {\n  if (typeof amount !== 'number' || !Number.isSafeInteger(amount)) {\n    throw new ValidationError(\n      `${model}.amount must be a safe integer number of minor units (cents) — ` +\n        `got ${String(amount)}. $19.99 is 1999.`,\n      'VALIDATION_INVALID_VALUE',\n      {\n        fieldName: 'amount',\n        value: amount,\n        expectedType: 'safe integer minor units',\n      },\n    );\n  }\n}\n\nconst chargeSnapshot = new WeakMap<ServiceChargeSnapshot, string>();\nconst compensationSnapshot = new WeakMap<ServiceCompensationSnapshot, string>();\n\nasync function immutableCommercialSnapshot(\n  object: SmrtObject,\n  fields: string[],\n): Promise<string | null> {\n  if (!object.id) return null;\n  try {\n    const row = await object.db.get(object.tableName, { id: object.id });\n    if (!row) return null;\n    return JSON.stringify(\n      Object.fromEntries(\n        fields.map((key) => [\n          key,\n          row[key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`)] ?? null,\n        ]),\n      ),\n    );\n  } catch {\n    return null;\n  }\n}\n\nfunction commercialSnapshot(\n  object: Record<string, unknown>,\n  fields: string[],\n): string {\n  return JSON.stringify(\n    Object.fromEntries(fields.map((key) => [key, object[key] ?? null])),\n  );\n}\n\nconst CHARGE_FIELDS = [\n  'timeEntryId',\n  'amount',\n  'currency',\n  'pricingVersion',\n  'strategy',\n  'rateSnapshot',\n  'sourceChargeRef',\n];\nconst COMPENSATION_FIELDS = [\n  'timeEntryId',\n  'amount',\n  'currency',\n  'termsVersion',\n  'rateSnapshot',\n];\n\n/**\n * Immutable client-charge snapshot for one approved time entry. Money is\n * integer minor units, consistent with smrt-commerce (#2401).\n */\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: 'service_charge_snapshots',\n  // Moved from smrt-projects in #3288; stored references keep resolving.\n  previousQualifiedNames: [\n    '@happyvertical/smrt-projects:ServiceChargeSnapshot',\n  ],\n  conflictColumns: ['time_entry_id'],\n  api: { include: ['list', 'get'] },\n  cli: { include: ['list', 'get'] },\n  mcp: { include: ['list', 'get'] },\n})\nexport class ServiceChargeSnapshot extends SmrtObject {\n  @tenantId({ nullable: true }) tenantId: string | null = null;\n  @foreignKey('ServiceTimeEntry', { required: true }) timeEntryId: string = '';\n  /**\n   * Client charge in **integer minor units** of {@link currency} — `$19.99` is\n   * `1999`. The `= 0` initializer is load-bearing: SMRT maps an integer literal\n   * to INTEGER and a decimal literal to DECIMAL (#2401).\n   *\n   * Copied verbatim from the upstream `ClientCharge.amount`, so the two carry\n   * the same unit by construction; a split would land cents in a major-units\n   * column with no error anywhere.\n   */\n  amount: number = 0;\n  @field({ type: 'text' }) currency: string = 'USD';\n  @field({ type: 'text' }) pricingVersion: string = '';\n  @field({ type: 'text' }) strategy: string = '';\n  @field({ type: 'text' }) rateSnapshot: string = '{}';\n  @field({ type: 'text' }) sourceChargeRef: string = '';\n  createdAt: Date = new Date();\n\n  override async initialize(): Promise<this> {\n    await super.initialize();\n    if (await this.isSaved())\n      chargeSnapshot.set(\n        this,\n        commercialSnapshot(\n          this as unknown as Record<string, unknown>,\n          CHARGE_FIELDS,\n        ),\n      );\n    return this;\n  }\n\n  override async save(): Promise<this> {\n    assertSnapshotMinorUnits('ServiceChargeSnapshot', this.amount);\n    const current = commercialSnapshot(\n      this as unknown as Record<string, unknown>,\n      CHARGE_FIELDS,\n    );\n    const prior =\n      (await immutableCommercialSnapshot(this, CHARGE_FIELDS)) ??\n      chargeSnapshot.get(this) ??\n      null;\n    if (prior && prior !== current)\n      throw new Error(\n        'ServiceChargeSnapshot is immutable; append an upstream adjustment instead.',\n      );\n    const result = (await super.save()) as this;\n    chargeSnapshot.set(this, current);\n    return result;\n  }\n}\n\n/**\n * Immutable provider-compensation snapshot for one approved time entry,\n * kept separate from the client charge so the margin is `charge - compensation`.\n */\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: 'service_compensation_snapshots',\n  // Moved from smrt-projects in #3288; stored references keep resolving.\n  previousQualifiedNames: [\n    '@happyvertical/smrt-projects:ServiceCompensationSnapshot',\n  ],\n  conflictColumns: ['time_entry_id'],\n  api: { include: ['list', 'get'] },\n  cli: { include: ['list', 'get'] },\n  mcp: { include: ['list', 'get'] },\n})\nexport class ServiceCompensationSnapshot extends SmrtObject {\n  @tenantId({ nullable: true }) tenantId: string | null = null;\n  @foreignKey('ServiceTimeEntry', { required: true }) timeEntryId: string = '';\n  /**\n   * Provider earning in **integer minor units** of {@link currency} (#2401).\n   *\n   * Converts with {@link ServiceChargeSnapshot.amount}: the delivery margin is\n   * `charge - compensation`, so a mixed pair would make that subtraction\n   * meaningless.\n   */\n  amount: number = 0;\n  @field({ type: 'text' }) currency: string = 'USD';\n  @field({ type: 'text' }) termsVersion: string = '';\n  @field({ type: 'text' }) rateSnapshot: string = '{}';\n  createdAt: Date = new Date();\n\n  override async initialize(): Promise<this> {\n    await super.initialize();\n    if (await this.isSaved())\n      compensationSnapshot.set(\n        this,\n        commercialSnapshot(\n          this as unknown as Record<string, unknown>,\n          COMPENSATION_FIELDS,\n        ),\n      );\n    return this;\n  }\n\n  override async save(): Promise<this> {\n    assertSnapshotMinorUnits('ServiceCompensationSnapshot', this.amount);\n    const current = commercialSnapshot(\n      this as unknown as Record<string, unknown>,\n      COMPENSATION_FIELDS,\n    );\n    const prior =\n      (await immutableCommercialSnapshot(this, COMPENSATION_FIELDS)) ??\n      compensationSnapshot.get(this) ??\n      null;\n    if (prior && prior !== current)\n      throw new Error(\n        'ServiceCompensationSnapshot is immutable; create explicit settlement evidence instead.',\n      );\n    const result = (await super.save()) as this;\n    compensationSnapshot.set(this, current);\n    return result;\n  }\n}\n\n/** Collection over `service_charge_snapshots`. */\nexport class ServiceChargeSnapshotCollection extends SmrtCollection<ServiceChargeSnapshot> {\n  static readonly _itemClass = ServiceChargeSnapshot;\n}\n/** Collection over `service_compensation_snapshots`. */\nexport class ServiceCompensationSnapshotCollection extends SmrtCollection<ServiceCompensationSnapshot> {\n  static readonly _itemClass = ServiceCompensationSnapshot;\n}\n","import type { SmrtClassOptions } from '@happyvertical/smrt-core';\nimport {\n  ServiceChargeSnapshotCollection,\n  ServiceCompensationSnapshotCollection,\n} from '../models/service-snapshots.js';\nimport type { ServiceTimeEntry } from '../models/service-time-entry.js';\nimport { ServiceTimeEntryCollection } from '../models/service-time-entry.js';\nimport type {\n  ServiceEvidence,\n  ServiceParticipantKind,\n  ServiceTimeEntrySource,\n} from '../types.js';\n\n/**\n * Input for {@link ServiceEvidenceService.record}. The work reference is the\n * qualified class name and id of whatever the time was spent on.\n */\nexport interface RecordServiceTimeInput {\n  tenantId?: string | null;\n  workRefType?: string | null;\n  workRefId?: string | null;\n  participantKind: ServiceParticipantKind;\n  participantProfileId?: string | null;\n  agentRef?: string;\n  source: ServiceTimeEntrySource;\n  description: string;\n  startedAt?: Date | null;\n  endedAt?: Date | null;\n  durationSeconds?: number;\n  evidence?: ServiceEvidence[];\n  metadata?: Record<string, unknown>;\n}\n\nexport interface CommercialSnapshot {\n  /**\n   * Integer minor units of `currency` — `$19.99` is `1999` (#2401).\n   *\n   * Written straight into `ServiceChargeSnapshot.amount` /\n   * `ServiceCompensationSnapshot.amount`, INTEGER columns whose `save()`\n   * refuses anything but a safe integer on every engine. A fractional\n   * major-unit value (`19.99`) is rejected; a whole one (`150` for $150.00)\n   * is not detectable and is stored 100× too small, so return minor units.\n   */\n  amount: number;\n  currency?: string;\n  version: string;\n  strategy?: string;\n  terms: Record<string, unknown>;\n  sourceRef?: string;\n}\n\nexport interface ServiceCommercialResolver {\n  priceClient(entry: ServiceTimeEntry): Promise<CommercialSnapshot>;\n  compensateProvider(entry: ServiceTimeEntry): Promise<CommercialSnapshot>;\n}\n\n/**\n * Records, submits, approves, and corrects time entries. Approval writes one\n * immutable client-charge and one provider-compensation snapshot per entry;\n * a correction is a new entry pointing at the approved one, which flips to\n * `corrected` with its snapshots intact.\n */\nexport class ServiceEvidenceService {\n  constructor(\n    private readonly entries: ServiceTimeEntryCollection,\n    private readonly charges: ServiceChargeSnapshotCollection,\n    private readonly compensation: ServiceCompensationSnapshotCollection,\n    private readonly commercial?: ServiceCommercialResolver,\n  ) {}\n\n  static async create(\n    options: SmrtClassOptions = {},\n    commercial?: ServiceCommercialResolver,\n  ): Promise<ServiceEvidenceService> {\n    const [entries, charges, compensation] = await Promise.all([\n      ServiceTimeEntryCollection.create(options),\n      ServiceChargeSnapshotCollection.create(options),\n      ServiceCompensationSnapshotCollection.create(options),\n    ]);\n    return new ServiceEvidenceService(\n      entries,\n      charges,\n      compensation,\n      commercial,\n    );\n  }\n\n  async record(input: RecordServiceTimeInput): Promise<ServiceTimeEntry> {\n    if (Boolean(input.workRefType) !== Boolean(input.workRefId))\n      throw new Error('workRefType and workRefId must be provided together.');\n    if (!(input.workRefType && input.workRefId))\n      throw new Error('Service time requires a work reference.');\n    if (input.participantKind === 'human' && !input.participantProfileId)\n      throw new Error('Human service time requires participantProfileId.');\n    if (input.participantKind === 'agent' && !input.agentRef)\n      throw new Error('Agent service time requires agentRef.');\n    if (input.source === 'timer' && (!input.startedAt || !input.endedAt))\n      throw new Error('Timer service time requires startedAt and endedAt.');\n    if (input.startedAt && input.endedAt && input.startedAt >= input.endedAt)\n      throw new Error('Service time startedAt must be before endedAt.');\n    const duration =\n      input.durationSeconds ??\n      (input.startedAt && input.endedAt\n        ? Math.round(\n            (input.endedAt.getTime() - input.startedAt.getTime()) / 1000,\n          )\n        : 0);\n    if (!Number.isInteger(duration) || duration <= 0)\n      throw new Error(\n        'Service time durationSeconds must be a positive integer.',\n      );\n    const entry = await this.entries.create({\n      ...input,\n      durationSeconds: duration,\n      evidence: JSON.stringify(input.evidence ?? []),\n      metadata: JSON.stringify(input.metadata ?? {}),\n      status: 'draft',\n      submittedAt: null,\n      submittedByProfileId: null,\n      approvedAt: null,\n      approvedByProfileId: null,\n      approvalPath: '',\n      rejectedAt: null,\n      rejectedByProfileId: null,\n      rejectionReason: '',\n      correctionOfId: null,\n    });\n    await entry.save();\n    return entry;\n  }\n\n  async submit(\n    entry: ServiceTimeEntry,\n    profileId?: string,\n  ): Promise<ServiceTimeEntry> {\n    if (entry.status !== 'draft' && entry.status !== 'rejected')\n      throw new Error('Only draft or rejected service time may be submitted.');\n    entry.status = 'submitted';\n    entry.submittedAt = new Date();\n    entry.submittedByProfileId = profileId ?? null;\n    return entry.save();\n  }\n\n  async approve(\n    entry: ServiceTimeEntry,\n    options: { actorProfileId?: string; approvalPath: string },\n  ): Promise<ServiceTimeEntry> {\n    if (entry.status !== 'submitted' && entry.status !== 'approved')\n      throw new Error(\n        'Only submitted service time or an incomplete approval may be approved.',\n      );\n    if (!this.commercial)\n      throw new Error(\n        'A ServiceCommercialResolver is required to approve service time.',\n      );\n    const timeEntryId = entry.id;\n    if (!timeEntryId)\n      throw new Error('ServiceTimeEntry must be saved before approval.');\n    const existingCharge = (\n      await this.charges.list({ where: { timeEntryId }, limit: 1 })\n    )[0];\n    const existingCompensation = (\n      await this.compensation.list({ where: { timeEntryId }, limit: 1 })\n    )[0];\n    if (entry.status === 'approved' && existingCharge && existingCompensation)\n      return entry;\n\n    // Commit approval before either commercial resolver runs. The subscription\n    // resolver creates an approved ClientCharge as part of priceClient(), so a\n    // failed approval must never leave billable spend behind.\n    if (entry.status === 'submitted') {\n      entry.status = 'approved';\n      entry.approvedAt = new Date();\n      entry.approvedByProfileId = options.actorProfileId ?? null;\n      entry.approvalPath = options.approvalPath;\n      try {\n        await entry.save();\n      } catch (error) {\n        const revisionConflict =\n          error instanceof Error &&\n          'code' in error &&\n          error.code === 'RUNTIME_REVISION_CONFLICT';\n        if (!revisionConflict) throw error;\n        const concurrent = await this.entries.get(timeEntryId);\n        if (concurrent?.status !== 'approved') throw error;\n        entry = concurrent;\n      }\n    }\n    const provider = existingCompensation\n      ? null\n      : await this.commercial.compensateProvider(entry);\n    if (provider) {\n      const snapshotId = await deterministicSnapshotId(\n        'service-compensation-snapshot',\n        timeEntryId,\n      );\n      try {\n        await this.compensation.create({\n          id: snapshotId,\n          tenantId: entry.tenantId,\n          timeEntryId,\n          amount: provider.amount,\n          currency: provider.currency ?? 'USD',\n          termsVersion: provider.version,\n          rateSnapshot: JSON.stringify(provider.terms),\n          _insertOnly: true,\n        });\n      } catch (error) {\n        const concurrent =\n          (await this.compensation.get(snapshotId)) ??\n          (\n            await this.compensation.list({\n              where: { timeEntryId },\n              limit: 1,\n            })\n          )[0];\n        if (!concurrent) throw error;\n      }\n    }\n    const client = existingCharge\n      ? null\n      : await this.commercial.priceClient(entry);\n    if (client) {\n      const snapshotId = await deterministicSnapshotId(\n        'service-charge-snapshot',\n        timeEntryId,\n      );\n      try {\n        await this.charges.create({\n          id: snapshotId,\n          tenantId: entry.tenantId,\n          timeEntryId,\n          amount: client.amount,\n          currency: client.currency ?? 'USD',\n          pricingVersion: client.version,\n          strategy: client.strategy ?? '',\n          rateSnapshot: JSON.stringify(client.terms),\n          sourceChargeRef: client.sourceRef ?? '',\n          _insertOnly: true,\n        });\n      } catch (error) {\n        const concurrent =\n          (await this.charges.get(snapshotId)) ??\n          (\n            await this.charges.list({\n              where: { timeEntryId },\n              limit: 1,\n            })\n          )[0];\n        if (!concurrent) throw error;\n      }\n    }\n    return entry;\n  }\n\n  async correct(\n    entry: ServiceTimeEntry,\n    input: RecordServiceTimeInput,\n  ): Promise<ServiceTimeEntry> {\n    if (entry.status !== 'approved')\n      throw new Error('Only approved service time may be corrected.');\n    if (input.tenantId !== undefined && input.tenantId !== entry.tenantId) {\n      throw new Error(\n        'Service time corrections must remain in the original tenant.',\n      );\n    }\n    const correction = await this.record({\n      ...input,\n      tenantId: entry.tenantId,\n    });\n    correction.correctionOfId = entry.id ?? null;\n    await correction.save();\n    entry.status = 'corrected';\n    await entry.save();\n    return correction;\n  }\n}\n\nasync function deterministicSnapshotId(\n  kind: string,\n  timeEntryId: string,\n): Promise<string> {\n  const bytes = new TextEncoder().encode(JSON.stringify([kind, timeEntryId]));\n  const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', bytes));\n  const uuid = digest.slice(0, 16);\n  uuid[6] = (uuid[6] & 0x0f) | 0x50;\n  uuid[8] = (uuid[8] & 0x3f) | 0x80;\n  const hex = Array.from(uuid, (byte) =>\n    byte.toString(16).padStart(2, '0'),\n  ).join('');\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20),\n  ].join('-');\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/models/service-snapshots.ts","../src/services/service-evidence-service.ts"],"sourcesContent":["import {\n  field,\n  foreignKey,\n  SmrtCollection,\n  SmrtObject,\n  smrt,\n  ValidationError,\n} from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\n\n/**\n * Refuse an amount that is not a JavaScript-safe integer number of minor\n * units. SQLite stores `19.99` in an INTEGER column without complaint and\n * PostgreSQL rejects it only at the driver, so the model boundary is the one\n * place both engines (and every writer: collections, `ServiceEvidenceService`,\n * resolvers) get the same answer. Sign is not constrained here.\n */\nexport function assertSnapshotMinorUnits(model: string, amount: unknown): void {\n  if (typeof amount !== 'number' || !Number.isSafeInteger(amount)) {\n    throw new ValidationError(\n      `${model}.amount must be a safe integer number of minor units (cents) — ` +\n        `got ${String(amount)}. $19.99 is 1999.`,\n      'VALIDATION_INVALID_VALUE',\n      {\n        fieldName: 'amount',\n        value: amount,\n        expectedType: 'safe integer minor units',\n      },\n    );\n  }\n}\n\nconst chargeSnapshot = new WeakMap<ServiceChargeSnapshot, string>();\nconst compensationSnapshot = new WeakMap<ServiceCompensationSnapshot, string>();\n\nasync function immutableCommercialSnapshot(\n  object: SmrtObject,\n  fields: string[],\n): Promise<string | null> {\n  if (!object.id) return null;\n  try {\n    const row = await object.db.get(object.tableName, { id: object.id });\n    if (!row) return null;\n    return JSON.stringify(\n      Object.fromEntries(\n        fields.map((key) => [\n          key,\n          row[key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`)] ?? null,\n        ]),\n      ),\n    );\n  } catch {\n    return null;\n  }\n}\n\nfunction commercialSnapshot(\n  object: Record<string, unknown>,\n  fields: string[],\n): string {\n  return JSON.stringify(\n    Object.fromEntries(fields.map((key) => [key, object[key] ?? null])),\n  );\n}\n\nconst CHARGE_FIELDS = [\n  'timeEntryId',\n  'amount',\n  'currency',\n  'pricingVersion',\n  'strategy',\n  'rateSnapshot',\n  'sourceChargeRef',\n];\nconst COMPENSATION_FIELDS = [\n  'timeEntryId',\n  'amount',\n  'currency',\n  'termsVersion',\n  'rateSnapshot',\n];\n\n/**\n * Immutable client-charge snapshot for one approved time entry. Money is\n * integer minor units, consistent with smrt-commerce (#2401).\n */\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: 'service_charge_snapshots',\n  // Moved from smrt-projects in #3288; stored references keep resolving.\n  previousQualifiedNames: [\n    '@happyvertical/smrt-projects:ServiceChargeSnapshot',\n  ],\n  conflictColumns: ['time_entry_id'],\n  api: { include: ['list', 'get'] },\n  cli: { include: ['list', 'get'] },\n  mcp: { include: ['list', 'get'] },\n})\nexport class ServiceChargeSnapshot extends SmrtObject {\n  @tenantId({ nullable: true }) tenantId: string | null = null;\n  @foreignKey('ServiceTimeEntry', { required: true }) timeEntryId: string = '';\n  /**\n   * Client charge in **integer minor units** of {@link currency} — `$19.99` is\n   * `1999`. The `= 0` initializer is load-bearing: SMRT maps an integer literal\n   * to INTEGER and a decimal literal to DECIMAL (#2401).\n   *\n   * Copied verbatim from the upstream `ClientCharge.amount`, so the two carry\n   * the same unit by construction; a split would land cents in a major-units\n   * column with no error anywhere.\n   */\n  amount: number = 0;\n  @field({ type: 'text' }) currency: string = 'USD';\n  @field({ type: 'text' }) pricingVersion: string = '';\n  @field({ type: 'text' }) strategy: string = '';\n  @field({ type: 'text' }) rateSnapshot: string = '{}';\n  @field({ type: 'text' }) sourceChargeRef: string = '';\n  createdAt: Date = new Date();\n\n  override async initialize(): Promise<this> {\n    await super.initialize();\n    if (await this.isSaved())\n      chargeSnapshot.set(\n        this,\n        commercialSnapshot(\n          this as unknown as Record<string, unknown>,\n          CHARGE_FIELDS,\n        ),\n      );\n    return this;\n  }\n\n  override async save(): Promise<this> {\n    assertSnapshotMinorUnits('ServiceChargeSnapshot', this.amount);\n    const current = commercialSnapshot(\n      this as unknown as Record<string, unknown>,\n      CHARGE_FIELDS,\n    );\n    const prior =\n      (await immutableCommercialSnapshot(this, CHARGE_FIELDS)) ??\n      chargeSnapshot.get(this) ??\n      null;\n    if (prior && prior !== current)\n      throw new Error(\n        'ServiceChargeSnapshot is immutable; append an upstream adjustment instead.',\n      );\n    const result = (await super.save()) as this;\n    chargeSnapshot.set(this, current);\n    return result;\n  }\n}\n\n/**\n * Immutable provider-compensation snapshot for one approved time entry,\n * kept separate from the client charge so the margin is `charge - compensation`.\n */\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: 'service_compensation_snapshots',\n  // Moved from smrt-projects in #3288; stored references keep resolving.\n  previousQualifiedNames: [\n    '@happyvertical/smrt-projects:ServiceCompensationSnapshot',\n  ],\n  conflictColumns: ['time_entry_id'],\n  api: { include: ['list', 'get'] },\n  cli: { include: ['list', 'get'] },\n  mcp: { include: ['list', 'get'] },\n})\nexport class ServiceCompensationSnapshot extends SmrtObject {\n  @tenantId({ nullable: true }) tenantId: string | null = null;\n  @foreignKey('ServiceTimeEntry', { required: true }) timeEntryId: string = '';\n  /**\n   * Provider earning in **integer minor units** of {@link currency} (#2401).\n   *\n   * Converts with {@link ServiceChargeSnapshot.amount}: the delivery margin is\n   * `charge - compensation`, so a mixed pair would make that subtraction\n   * meaningless.\n   */\n  amount: number = 0;\n  @field({ type: 'text' }) currency: string = 'USD';\n  @field({ type: 'text' }) termsVersion: string = '';\n  @field({ type: 'text' }) rateSnapshot: string = '{}';\n  createdAt: Date = new Date();\n\n  override async initialize(): Promise<this> {\n    await super.initialize();\n    if (await this.isSaved())\n      compensationSnapshot.set(\n        this,\n        commercialSnapshot(\n          this as unknown as Record<string, unknown>,\n          COMPENSATION_FIELDS,\n        ),\n      );\n    return this;\n  }\n\n  override async save(): Promise<this> {\n    assertSnapshotMinorUnits('ServiceCompensationSnapshot', this.amount);\n    const current = commercialSnapshot(\n      this as unknown as Record<string, unknown>,\n      COMPENSATION_FIELDS,\n    );\n    const prior =\n      (await immutableCommercialSnapshot(this, COMPENSATION_FIELDS)) ??\n      compensationSnapshot.get(this) ??\n      null;\n    if (prior && prior !== current)\n      throw new Error(\n        'ServiceCompensationSnapshot is immutable; create explicit settlement evidence instead.',\n      );\n    const result = (await super.save()) as this;\n    compensationSnapshot.set(this, current);\n    return result;\n  }\n}\n\n/** Collection over `service_charge_snapshots`. */\nexport class ServiceChargeSnapshotCollection extends SmrtCollection<ServiceChargeSnapshot> {\n  static readonly _itemClass = ServiceChargeSnapshot;\n}\n/** Collection over `service_compensation_snapshots`. */\nexport class ServiceCompensationSnapshotCollection extends SmrtCollection<ServiceCompensationSnapshot> {\n  static readonly _itemClass = ServiceCompensationSnapshot;\n}\n","import type { SmrtClassOptions } from '@happyvertical/smrt-core';\nimport {\n  ServiceChargeSnapshotCollection,\n  ServiceCompensationSnapshotCollection,\n} from '../models/service-snapshots.js';\nimport type { ServiceTimeEntry } from '../models/service-time-entry.js';\nimport {\n  SERVICE_DURATION_HOURS_EVIDENCE,\n  ServiceTimeEntryCollection,\n  validateDurationHours,\n} from '../models/service-time-entry.js';\nimport type {\n  ServiceEvidence,\n  ServiceParticipantKind,\n  ServiceTimeEntrySource,\n} from '../types.js';\n\n/**\n * Input for {@link ServiceEvidenceService.record}. The work reference is the\n * qualified class name and id of whatever the time was spent on.\n */\nexport interface RecordServiceTimeInput {\n  tenantId?: string | null;\n  workRefType?: string | null;\n  workRefId?: string | null;\n  participantKind: ServiceParticipantKind;\n  participantProfileId?: string | null;\n  agentRef?: string;\n  source: ServiceTimeEntrySource;\n  description: string;\n  startedAt?: Date | null;\n  endedAt?: Date | null;\n  durationSeconds?: number | null;\n  /** Exact positive decimal text; exclusive with seconds and timestamps. */\n  durationHours?: string;\n  evidence?: ServiceEvidence[];\n  metadata?: Record<string, unknown>;\n}\n\nexport interface CommercialSnapshot {\n  /**\n   * Integer minor units of `currency` — `$19.99` is `1999` (#2401).\n   *\n   * Written straight into `ServiceChargeSnapshot.amount` /\n   * `ServiceCompensationSnapshot.amount`, INTEGER columns whose `save()`\n   * refuses anything but a safe integer on every engine. A fractional\n   * major-unit value (`19.99`) is rejected; a whole one (`150` for $150.00)\n   * is not detectable and is stored 100× too small, so return minor units.\n   */\n  amount: number;\n  currency?: string;\n  version: string;\n  strategy?: string;\n  terms: Record<string, unknown>;\n  sourceRef?: string;\n}\n\nexport interface ServiceCommercialResolver {\n  /** Pure preflight: reject unsupported evidence before approval or snapshot writes. */\n  validateEntry?(entry: ServiceTimeEntry): void | Promise<void>;\n  priceClient(entry: ServiceTimeEntry): Promise<CommercialSnapshot>;\n  compensateProvider(entry: ServiceTimeEntry): Promise<CommercialSnapshot>;\n}\n\n/**\n * Records, submits, approves, and corrects time entries. Approval writes one\n * immutable client-charge and one provider-compensation snapshot per entry;\n * a correction is a new entry pointing at the approved one, which flips to\n * `corrected` with its snapshots intact.\n */\nexport class ServiceEvidenceService {\n  constructor(\n    private readonly entries: ServiceTimeEntryCollection,\n    private readonly charges: ServiceChargeSnapshotCollection,\n    private readonly compensation: ServiceCompensationSnapshotCollection,\n    private readonly commercial?: ServiceCommercialResolver,\n  ) {}\n\n  static async create(\n    options: SmrtClassOptions = {},\n    commercial?: ServiceCommercialResolver,\n  ): Promise<ServiceEvidenceService> {\n    const [entries, charges, compensation] = await Promise.all([\n      ServiceTimeEntryCollection.create(options),\n      ServiceChargeSnapshotCollection.create(options),\n      ServiceCompensationSnapshotCollection.create(options),\n    ]);\n    return new ServiceEvidenceService(\n      entries,\n      charges,\n      compensation,\n      commercial,\n    );\n  }\n\n  async record(input: RecordServiceTimeInput): Promise<ServiceTimeEntry> {\n    if (!['timer', 'manual', 'import', 'agent'].includes(input.source))\n      throw new Error('Unsupported service time source.');\n    if (Boolean(input.workRefType) !== Boolean(input.workRefId))\n      throw new Error('workRefType and workRefId must be provided together.');\n    if (!(input.workRefType && input.workRefId))\n      throw new Error('Service time requires a work reference.');\n    if (input.participantKind === 'human' && !input.participantProfileId)\n      throw new Error('Human service time requires participantProfileId.');\n    if (input.participantKind === 'agent' && !input.agentRef)\n      throw new Error('Agent service time requires agentRef.');\n    if (input.source === 'timer' && (!input.startedAt || !input.endedAt))\n      throw new Error('Timer service time requires startedAt and endedAt.');\n    if (input.startedAt && input.endedAt && input.startedAt >= input.endedAt)\n      throw new Error('Service time startedAt must be before endedAt.');\n    const { durationHours, ...fields } = input;\n    if (\n      input.evidence?.some(\n        (item) => item?.kind === SERVICE_DURATION_HOURS_EVIDENCE,\n      )\n    )\n      throw new Error(\n        'Use durationHours to supply reserved decimal-hours evidence.',\n      );\n    const hours =\n      durationHours === undefined ? null : validateDurationHours(durationHours);\n    if (\n      hours !== null &&\n      (input.durationSeconds != null || input.startedAt || input.endedAt)\n    )\n      throw new Error(\n        'Decimal-hours-only service time cannot also supply seconds or timestamps.',\n      );\n    if (hours === null && input.durationSeconds === null)\n      throw new Error('Null durationSeconds requires durationHours.');\n    const duration =\n      hours !== null\n        ? null\n        : (input.durationSeconds ??\n          (input.startedAt && input.endedAt\n            ? Math.round(\n                (input.endedAt.getTime() - input.startedAt.getTime()) / 1000,\n              )\n            : 0));\n    if (duration !== null && (!Number.isSafeInteger(duration) || duration <= 0))\n      throw new Error(\n        'Service time durationSeconds must be a positive integer.',\n      );\n    const entry = await this.entries.create({\n      ...fields,\n      durationSeconds: duration,\n      evidence: JSON.stringify([\n        ...(input.evidence ?? []),\n        ...(hours === null\n          ? []\n          : [{ kind: SERVICE_DURATION_HOURS_EVIDENCE, hours }]),\n      ]),\n      metadata: JSON.stringify(input.metadata ?? {}),\n      status: 'draft',\n      submittedAt: null,\n      submittedByProfileId: null,\n      approvedAt: null,\n      approvedByProfileId: null,\n      approvalPath: '',\n      rejectedAt: null,\n      rejectedByProfileId: null,\n      rejectionReason: '',\n      correctionOfId: null,\n    });\n    await entry.save();\n    return entry;\n  }\n\n  async submit(\n    entry: ServiceTimeEntry,\n    profileId?: string,\n  ): Promise<ServiceTimeEntry> {\n    if (entry.status !== 'draft' && entry.status !== 'rejected')\n      throw new Error('Only draft or rejected service time may be submitted.');\n    entry.status = 'submitted';\n    entry.submittedAt = new Date();\n    entry.submittedByProfileId = profileId ?? null;\n    return entry.save();\n  }\n\n  async approve(\n    entry: ServiceTimeEntry,\n    options: { actorProfileId?: string; approvalPath: string },\n  ): Promise<ServiceTimeEntry> {\n    if (entry.status !== 'submitted' && entry.status !== 'approved')\n      throw new Error(\n        'Only submitted service time or an incomplete approval may be approved.',\n      );\n    if (!this.commercial)\n      throw new Error(\n        'A ServiceCommercialResolver is required to approve service time.',\n      );\n    const timeEntryId = entry.id;\n    if (!timeEntryId)\n      throw new Error('ServiceTimeEntry must be saved before approval.');\n    const existingCharge = (\n      await this.charges.list({ where: { timeEntryId }, limit: 1 })\n    )[0];\n    const existingCompensation = (\n      await this.compensation.list({ where: { timeEntryId }, limit: 1 })\n    )[0];\n    if (entry.status === 'approved' && existingCharge && existingCompensation)\n      return entry;\n\n    await this.commercial.validateEntry?.(entry);\n\n    // Commit approval before either commercial resolver runs. The subscription\n    // resolver creates an approved ClientCharge as part of priceClient(), so a\n    // failed approval must never leave billable spend behind.\n    if (entry.status === 'submitted') {\n      entry.status = 'approved';\n      entry.approvedAt = new Date();\n      entry.approvedByProfileId = options.actorProfileId ?? null;\n      entry.approvalPath = options.approvalPath;\n      try {\n        await entry.save();\n      } catch (error) {\n        const revisionConflict =\n          error instanceof Error &&\n          'code' in error &&\n          error.code === 'RUNTIME_REVISION_CONFLICT';\n        if (!revisionConflict) throw error;\n        const concurrent = await this.entries.get(timeEntryId);\n        if (concurrent?.status !== 'approved') throw error;\n        entry = concurrent;\n        await this.commercial.validateEntry?.(entry);\n      }\n    }\n    const provider = existingCompensation\n      ? null\n      : await this.commercial.compensateProvider(entry);\n    if (provider) {\n      const snapshotId = await deterministicSnapshotId(\n        'service-compensation-snapshot',\n        timeEntryId,\n      );\n      try {\n        await this.compensation.create({\n          id: snapshotId,\n          tenantId: entry.tenantId,\n          timeEntryId,\n          amount: provider.amount,\n          currency: provider.currency ?? 'USD',\n          termsVersion: provider.version,\n          rateSnapshot: JSON.stringify(provider.terms),\n          _insertOnly: true,\n        });\n      } catch (error) {\n        const concurrent =\n          (await this.compensation.get(snapshotId)) ??\n          (\n            await this.compensation.list({\n              where: { timeEntryId },\n              limit: 1,\n            })\n          )[0];\n        if (!concurrent) throw error;\n      }\n    }\n    const client = existingCharge\n      ? null\n      : await this.commercial.priceClient(entry);\n    if (client) {\n      const snapshotId = await deterministicSnapshotId(\n        'service-charge-snapshot',\n        timeEntryId,\n      );\n      try {\n        await this.charges.create({\n          id: snapshotId,\n          tenantId: entry.tenantId,\n          timeEntryId,\n          amount: client.amount,\n          currency: client.currency ?? 'USD',\n          pricingVersion: client.version,\n          strategy: client.strategy ?? '',\n          rateSnapshot: JSON.stringify(client.terms),\n          sourceChargeRef: client.sourceRef ?? '',\n          _insertOnly: true,\n        });\n      } catch (error) {\n        const concurrent =\n          (await this.charges.get(snapshotId)) ??\n          (\n            await this.charges.list({\n              where: { timeEntryId },\n              limit: 1,\n            })\n          )[0];\n        if (!concurrent) throw error;\n      }\n    }\n    return entry;\n  }\n\n  async correct(\n    entry: ServiceTimeEntry,\n    input: RecordServiceTimeInput,\n  ): Promise<ServiceTimeEntry> {\n    if (entry.status !== 'approved')\n      throw new Error('Only approved service time may be corrected.');\n    if (input.tenantId !== undefined && input.tenantId !== entry.tenantId) {\n      throw new Error(\n        'Service time corrections must remain in the original tenant.',\n      );\n    }\n    const correction = await this.record({\n      ...input,\n      tenantId: entry.tenantId,\n    });\n    correction.correctionOfId = entry.id ?? null;\n    await correction.save();\n    entry.status = 'corrected';\n    await entry.save();\n    return correction;\n  }\n}\n\nasync function deterministicSnapshotId(\n  kind: string,\n  timeEntryId: string,\n): Promise<string> {\n  const bytes = new TextEncoder().encode(JSON.stringify([kind, timeEntryId]));\n  const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', bytes));\n  const uuid = digest.slice(0, 16);\n  uuid[6] = (uuid[6] & 0x0f) | 0x50;\n  uuid[8] = (uuid[8] & 0x3f) | 0x80;\n  const hex = Array.from(uuid, (byte) =>\n    byte.toString(16).padStart(2, '0'),\n  ).join('');\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20),\n  ].join('-');\n}\n"],"mappings":"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"}

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-timesheets",
-  "packageVersion": "0.53.4",
+  "packageVersion": "0.53.6",
   "objects": {
     "@happyvertical/smrt-timesheets:AttendancePunch": {
       "name": "attendancepunch",
@@ -1818,7 +1818,9 @@
         "durationSeconds": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "_meta": {
+            "nullable": true
+          }
         },
         "evidence": {
           "type": "text",
@@ -1932,6 +1934,14 @@
           "isStatic": false,
           "isPublic": true
         },
+        "durationHoursExact": {
+          "name": "durationHoursExact",
+          "async": false,
+          "parameters": [],
+          "returnType": "string | null",
+          "isStatic": false,
+          "isPublic": true
+        },
         "durationHours": {
           "name": "durationHours",
           "async": false,
@@ -1940,6 +1950,14 @@
           "isStatic": false,
           "isPublic": true
         },
+        "requireDurationSeconds": {
+          "name": "requireDurationSeconds",
+          "async": false,
+          "parameters": [],
+          "returnType": "number",
+          "isStatic": false,
+          "isPublic": true
+        },
         "initialize": {
           "name": "initialize",
           "async": true,
@@ -1994,7 +2012,7 @@
       "collectionExportName": "ServiceTimeEntryCollection",
       "schema": {
         "tableName": "service_time_entries",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"service_time_entries\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"work_ref_type\" TEXT,\n  \"work_ref_id\" TEXT,\n  \"participant_kind\" TEXT,\n  \"participant_profile_id\" UUID,\n  \"agent_ref\" TEXT,\n  \"source\" TEXT,\n  \"description\" TEXT,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"duration_seconds\" INTEGER DEFAULT 0,\n  \"evidence\" TEXT,\n  \"status\" TEXT,\n  \"submitted_at\" TIMESTAMP,\n  \"submitted_by_profile_id\" UUID,\n  \"approved_at\" TIMESTAMP,\n  \"approved_by_profile_id\" UUID,\n  \"approval_path\" TEXT,\n  \"rejected_at\" TIMESTAMP,\n  \"rejected_by_profile_id\" UUID,\n  \"rejection_reason\" TEXT,\n  \"correction_of_id\" UUID,\n  \"metadata\" TEXT\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"service_time_entries\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"work_ref_type\" TEXT,\n  \"work_ref_id\" TEXT,\n  \"participant_kind\" TEXT,\n  \"participant_profile_id\" UUID,\n  \"agent_ref\" TEXT,\n  \"source\" TEXT,\n  \"description\" TEXT,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"duration_seconds\" INTEGER,\n  \"evidence\" TEXT,\n  \"status\" TEXT,\n  \"submitted_at\" TIMESTAMP,\n  \"submitted_by_profile_id\" UUID,\n  \"approved_at\" TIMESTAMP,\n  \"approved_by_profile_id\" UUID,\n  \"approval_path\" TEXT,\n  \"rejected_at\" TIMESTAMP,\n  \"rejected_by_profile_id\" UUID,\n  \"rejection_reason\" TEXT,\n  \"correction_of_id\" UUID,\n  \"metadata\" TEXT\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -2076,8 +2094,7 @@
           "duration_seconds": {
             "type": "INTEGER",
             "notNull": false,
-            "unique": false,
-            "default": 0
+            "unique": false
           },
           "evidence": {
             "type": "TEXT",
@@ -2199,7 +2216,7 @@
             ]
           }
         ],
-        "version": "16c0d6c8"
+        "version": "05578ed7"
       },
       "importPath": "@happyvertical/smrt-timesheets"
     },
@@ -2249,7 +2266,7 @@
       "collectionExportName": "ServiceTimeEntryCollectionCollection",
       "schema": {
         "tableName": "service_time_entries",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"service_time_entries\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"work_ref_type\" TEXT,\n  \"work_ref_id\" TEXT,\n  \"participant_kind\" TEXT,\n  \"participant_profile_id\" UUID,\n  \"agent_ref\" TEXT,\n  \"source\" TEXT,\n  \"description\" TEXT,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"duration_seconds\" INTEGER DEFAULT 0,\n  \"evidence\" TEXT,\n  \"status\" TEXT,\n  \"submitted_at\" TIMESTAMP,\n  \"submitted_by_profile_id\" UUID,\n  \"approved_at\" TIMESTAMP,\n  \"approved_by_profile_id\" UUID,\n  \"approval_path\" TEXT,\n  \"rejected_at\" TIMESTAMP,\n  \"rejected_by_profile_id\" UUID,\n  \"rejection_reason\" TEXT,\n  \"correction_of_id\" UUID,\n  \"metadata\" TEXT\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"service_time_entries\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"work_ref_type\" TEXT,\n  \"work_ref_id\" TEXT,\n  \"participant_kind\" TEXT,\n  \"participant_profile_id\" UUID,\n  \"agent_ref\" TEXT,\n  \"source\" TEXT,\n  \"description\" TEXT,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"duration_seconds\" INTEGER,\n  \"evidence\" TEXT,\n  \"status\" TEXT,\n  \"submitted_at\" TIMESTAMP,\n  \"submitted_by_profile_id\" UUID,\n  \"approved_at\" TIMESTAMP,\n  \"approved_by_profile_id\" UUID,\n  \"approval_path\" TEXT,\n  \"rejected_at\" TIMESTAMP,\n  \"rejected_by_profile_id\" UUID,\n  \"rejection_reason\" TEXT,\n  \"correction_of_id\" UUID,\n  \"metadata\" TEXT\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -2331,8 +2348,7 @@
           "duration_seconds": {
             "type": "INTEGER",
             "notNull": false,
-            "unique": false,
-            "default": 0
+            "unique": false
           },
           "evidence": {
             "type": "TEXT",
@@ -2454,7 +2470,7 @@
             ]
           }
         ],
-        "version": "16c0d6c8"
+        "version": "05578ed7"
       },
       "importPath": "@happyvertical/smrt-timesheets"
     },

package/dist/models/index.d.ts

@@ -1,3 +1,3 @@
 export { ServiceChargeSnapshot, ServiceChargeSnapshotCollection, ServiceCompensationSnapshot, ServiceCompensationSnapshotCollection, } from './service-snapshots.js';
-export { SERVICE_TIME_ENTRY_FROZEN_FIELDS, ServiceTimeEntry, ServiceTimeEntryCollection, } from './service-time-entry.js';
+export { SERVICE_DURATION_HOURS_EVIDENCE, SERVICE_TIME_ENTRY_FROZEN_FIELDS, ServiceTimeEntry, ServiceTimeEntryCollection, } from './service-time-entry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,2BAA2B,EAC3B,qCAAqC,GACtC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gCAAgC,EAChC,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,2BAA2B,EAC3B,qCAAqC,GACtC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}

package/dist/models/service-time-entry.d.ts

@@ -30,7 +30,8 @@ export declare class ServiceTimeEntry extends SmrtObject {
     description: string;
     startedAt: Date | null;
     endedAt: Date | null;
-    durationSeconds: number;
+    /** Integer seconds, or null for an explicit decimal-hours-only source. */
+    durationSeconds: number | null;
     evidence: string;
     status: ServiceTimeEntryStatus;
     submittedAt: Date | null;
@@ -47,7 +48,12 @@ export declare class ServiceTimeEntry extends SmrtObject {
     setEvidence(value: ServiceEvidence[]): void;
     getMetadata(): Record<string, unknown>;
     setMetadata(value: Record<string, unknown>): void;
+    /** Original decimal-hours text, without binary floating-point conversion. */
+    durationHoursExact(): string | null;
+    /** Numeric convenience for display; use durationHoursExact() for exact terms. */
     durationHours(): number;
+    /** Guard for consumers whose policies require independently supplied seconds. */
+    requireDurationSeconds(): number;
     /**
      * Fields frozen once the entry is approved. Subtypes that add work context
      * (e.g. a support case) return `[...super.frozenFieldNames(), ...]`.
@@ -63,4 +69,8 @@ export declare class ServiceTimeEntryCollection extends SmrtCollection<ServiceTi
     forWork(workRefType: string, workRefId: string): Promise<ServiceTimeEntry[]>;
     pendingApproval(): Promise<ServiceTimeEntry[]>;
 }
+/** Reserved evidence kind for a source quantity with no measured elapsed seconds. */
+export declare const SERVICE_DURATION_HOURS_EVIDENCE = "@happyvertical/smrt-timesheets:duration-hours";
+/** Validate without normalizing the original accepted decimal text. */
+export declare function validateDurationHours(value: unknown): string;
 //# sourceMappingURL=service-time-entry.d.ts.map

package/dist/models/service-time-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-time-entry.d.ts","sourceRoot":"","sources":["../../src/models/service-time-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AAGrB;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,4MAcnC,CAAC;AAyBX;;;;;;;;;;;;GAYG;AACH,qBASa,gBAAiB,SAAQ,UAAU;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAChD,eAAe,EAAE,sBAAsB,CAAW;IAE3E,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAClB,QAAQ,EAAE,MAAM,CAAM;IACtB,MAAM,EAAE,sBAAsB,CAAY;IAC1C,WAAW,EAAE,MAAM,CAAM;IAClD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAC9B,OAAO,EAAE,IAAI,GAAG,IAAI,CAAQ;IAC5B,eAAe,EAAE,MAAM,CAAK;IACH,QAAQ,EAAE,MAAM,CAAQ;IACxB,MAAM,EAAE,sBAAsB,CAAW;IAClE,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAEhC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC3C,UAAU,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE/B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACjB,YAAY,EAAE,MAAM,CAAM;IACnD,UAAU,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE/B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACjB,eAAe,EAAE,MAAM,CAAM;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5C,QAAQ,EAAE,MAAM,CAAQ;IAEjD,WAAW,IAAI,eAAe,EAAE;IAGhC,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,IAAI;IAG3C,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGtC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAGjD,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,SAAS,CAAC,gBAAgB,IAAI,SAAS,MAAM,EAAE;IAIhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA8BtB,SAAS;CA8BxB;AAED,8CAA8C;AAC9C,qBAAa,0BAA2B,SAAQ,cAAc,CAAC,gBAAgB,CAAC;IAC9E,MAAM,CAAC,QAAQ,CAAC,UAAU,0BAAoB;IACxC,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAMxB,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAMrD"}
+{"version":3,"file":"service-time-entry.d.ts","sourceRoot":"","sources":["../../src/models/service-time-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AAGrB;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,4MAcnC,CAAC;AAyBX;;;;;;;;;;;;GAYG;AACH,qBASa,gBAAiB,SAAQ,UAAU;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAChD,eAAe,EAAE,sBAAsB,CAAW;IAE3E,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAClB,QAAQ,EAAE,MAAM,CAAM;IACtB,MAAM,EAAE,sBAAsB,CAAY;IAC1C,WAAW,EAAE,MAAM,CAAM;IAClD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAC9B,OAAO,EAAE,IAAI,GAAG,IAAI,CAAQ;IAC5B,0EAA0E;IAE1E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAK;IACV,QAAQ,EAAE,MAAM,CAAQ;IACxB,MAAM,EAAE,sBAAsB,CAAW;IAClE,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAEhC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC3C,UAAU,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE/B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACjB,YAAY,EAAE,MAAM,CAAM;IACnD,UAAU,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE/B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACjB,eAAe,EAAE,MAAM,CAAM;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5C,QAAQ,EAAE,MAAM,CAAQ;IAEjD,WAAW,IAAI,eAAe,EAAE;IAGhC,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,IAAI;IAG3C,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGtC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAGjD,6EAA6E;IAC7E,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAanC,iFAAiF;IACjF,aAAa,IAAI,MAAM;IAQvB,iFAAiF;IACjF,sBAAsB,IAAI,MAAM;IAQhC;;;OAGG;IACH,SAAS,CAAC,gBAAgB,IAAI,SAAS,MAAM,EAAE;IAIhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA8CtB,SAAS;CA8BxB;AAED,8CAA8C;AAC9C,qBAAa,0BAA2B,SAAQ,cAAc,CAAC,gBAAgB,CAAC;IAC9E,MAAM,CAAC,QAAQ,CAAC,UAAU,0BAAoB;IACxC,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAMxB,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAMrD;AAED,qFAAqF;AACrF,eAAO,MAAM,+BAA+B,kDACK,CAAC;AAElD,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAY5D"}

package/dist/rollup/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/rollup/service.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,EACL,cAAc,EAEd,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EAExB,MAAM,YAAY,CAAC;AAuBpB;;;;GAIG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAHP,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE;QACxB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;KACpB;IAkBR,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,QAAQ;YA8BF,IAAI;IAYlB,gFAAgF;IAC1E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAG9C,iFAAiF;IAC3E,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IAsI/C,yEAAyE;IACnE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWlD,sFAAsF;IAChF,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IA8E9B,6EAA6E;IACvE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAChC,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CAwBH"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/rollup/service.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,EACL,cAAc,EAEd,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EAExB,MAAM,YAAY,CAAC;AAuBpB;;;;GAIG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAHP,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE;QACxB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;KACpB;IAkBR,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,QAAQ;YA8BF,IAAI;IAYlB,gFAAgF;IAC1E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAG9C,iFAAiF;IAC3E,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IA8I/C,yEAAyE;IACnE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWlD,sFAAsF;IAChF,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IA8E9B,6EAA6E;IACvE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAChC,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CAwBH"}

package/dist/rollup.js

@@ -1,2 +1,2 @@
-import { a as PeriodTimecard, c as TimecardAdjustmentCollection, o as PeriodTimecardCollection, s as TimecardAdjustment, t as PeriodRollupService } from "./chunks/rollup-uEAMRkKb.js";
+import { a as PeriodTimecard, c as TimecardAdjustmentCollection, o as PeriodTimecardCollection, s as TimecardAdjustment, t as PeriodRollupService } from "./chunks/rollup-kwRmgW9t.js";
 export { PeriodRollupService, PeriodTimecard, PeriodTimecardCollection, TimecardAdjustment, TimecardAdjustmentCollection };

package/dist/services/service-evidence-service.d.ts

@@ -18,7 +18,9 @@ export interface RecordServiceTimeInput {
     description: string;
     startedAt?: Date | null;
     endedAt?: Date | null;
-    durationSeconds?: number;
+    durationSeconds?: number | null;
+    /** Exact positive decimal text; exclusive with seconds and timestamps. */
+    durationHours?: string;
     evidence?: ServiceEvidence[];
     metadata?: Record<string, unknown>;
 }
@@ -40,6 +42,8 @@ export interface CommercialSnapshot {
     sourceRef?: string;
 }
 export interface ServiceCommercialResolver {
+    /** Pure preflight: reject unsupported evidence before approval or snapshot writes. */
+    validateEntry?(entry: ServiceTimeEntry): void | Promise<void>;
     priceClient(entry: ServiceTimeEntry): Promise<CommercialSnapshot>;
     compensateProvider(entry: ServiceTimeEntry): Promise<CommercialSnapshot>;
 }

package/dist/services/service-evidence-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-evidence-service.d.ts","sourceRoot":"","sources":["../../src/services/service-evidence-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,+BAA+B,EAC/B,qCAAqC,EACtC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,sBAAsB,CAAC;IACxC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;OAQG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClE,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC1E;AAED;;;;;GAKG;AACH,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAHX,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,+BAA+B,EACxC,YAAY,EAAE,qCAAqC,EACnD,UAAU,CAAC,EAAE,yBAAyB,YAAA;WAG5C,MAAM,CACjB,OAAO,GAAE,gBAAqB,EAC9B,UAAU,CAAC,EAAE,yBAAyB,GACrC,OAAO,CAAC,sBAAsB,CAAC;IAc5B,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4ChE,MAAM,CACV,KAAK,EAAE,gBAAgB,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC;IAStB,OAAO,CACX,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GACzD,OAAO,CAAC,gBAAgB,CAAC;IA6GtB,OAAO,CACX,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,gBAAgB,CAAC;CAkB7B"}
+{"version":3,"file":"service-evidence-service.d.ts","sourceRoot":"","sources":["../../src/services/service-evidence-service.ts"],"names":[],"mappings":"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"}

package/dist/smrt-knowledge.json

@@ -3,14 +3,14 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-timesheets",
-  "packageVersion": "0.53.4",
+  "packageVersion": "0.53.6",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "bfb1349eb89c8fa5664ff65dc34c203c2884a3f357913f1168dd59d1e5f3d29c",
-    "packageJson": "0a792467e588a849d4d6ffe764847170af81aa296928140fb580928e03aff8a4",
+    "manifest": "248ec7ae1d0e67d06b482b853a35c0f05a3d5a709c986b6ca72259022f7fe98d",
+    "packageJson": "ac7807e0bb28ea33dcfb0890d80ea4af39dc7d3a693356709132fe55eed51b6e",
     "agents": "21421ad5f02335e4c994227122c13b881d10e9f9d55ae09c3ac8ffa4bc2a7e09",
-    "moduleDoc:agents/period-rollup.md": "0c28783f8911c20911a2c640e89f2190df886d86749b5b03219afea4c83ab75d"
+    "moduleDoc:agents/period-rollup.md": "5fb741659d81dbef2e4850c10c2d65f09e3f5a83e8a88e2e0f19585f25158a6a"
   },
   "exports": [
     ".",
@@ -943,8 +943,7 @@
           "name": "durationSeconds",
           "type": "integer",
           "required": false,
-          "columnType": "INTEGER",
-          "default": 0
+          "columnType": "INTEGER"
         },
         {
           "name": "evidence",
@@ -1062,9 +1061,11 @@
       ],
       "methods": [
         "durationHours",
+        "durationHoursExact",
         "getEvidence",
         "getMetadata",
         "initialize",
+        "requireDurationSeconds",
         "save",
         "setEvidence",
         "setMetadata"
@@ -1074,6 +1075,10 @@
           "name": "durationHours",
           "returns": "number"
         },
+        {
+          "name": "durationHoursExact",
+          "returns": "string | null"
+        },
         {
           "name": "getEvidence",
           "returns": "ServiceEvidence[]"
@@ -1087,6 +1092,10 @@
           "async": true,
           "returns": "Promise<this>"
         },
+        {
+          "name": "requireDurationSeconds",
+          "returns": "number"
+        },
         {
           "name": "save",
           "async": true,
@@ -1167,6 +1176,13 @@
           "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
         },
+        {
+          "kind": "api",
+          "operation": "durationHoursExact",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
         {
           "kind": "api",
           "operation": "getEvidence",
@@ -1188,6 +1204,13 @@
           "reason": "`initialize` is a framework lifecycle method, not a distinct operation",
           "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
         },
+        {
+          "kind": "api",
+          "operation": "requireDurationSeconds",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
         {
           "kind": "api",
           "operation": "save",
@@ -1896,7 +1919,7 @@
     {
       "path": "agents/period-rollup.md",
       "module": "period-rollup",
-      "content": "# Period timecards\n\n`@happyvertical/smrt-timesheets/rollup` exports `PeriodRollupService`,\n`PeriodTimecard`, `TimecardAdjustment`, their collections, and resolver types.\nThe package root also exports them. SQLite and PostgreSQL are supported.\nCreate application tables through normal migrations; neither service provisions\nschema. The attendance option additionally requires the attendance tables.\n\nConstruct a service only after authenticating and authorizing its trusted\n`{ tenantId, profileId }` scope. A conflicting ambient tenant is rejected.\n`options.actorProfileId` records a separately authorized supervisor; it defaults\nto the subject profile for self confirmation/correction. Never accept this\ntrusted scope or attribution unchecked from request input. Profile authorization\nis consumer-owned; the service filters every source/card/adjustment read by its\ntrusted subject and tenant. Generic API, CLI and MCP surfaces are closed by\ndefault; consumer registry overrides may further restrict them (#3318).\n\n## Resolver contract\n\n`periodFor(at, actor)` supplies half-open UTC `startsAt`/`endsAt`, an IANA\n`timezone`, a nonempty policy `version`, and a JSON `rules` snapshot.\nThe consumer owns period length, calendar start day, timezone and DST, overtime\nthresholds, holidays and classification. The requested instant must be inside\nthe window. Overlapping windows for existing cards are rejected: introduce a new\ncalendar at a boundary after existing windows, and use adjustments for already\nconfirmed periods.\n\n`classify(period, sources, actor)` returns nonnegative safe integer\n`regularSeconds` and `overtimeSeconds`, whose sum must equal source seconds.\nInputs are detached so resolver mutation cannot rewrite evidence. Resolver\nexceptions, malformed windows, invalid timezone, fractional/unsafe totals and\nnonconserving classification abort the transaction. No Alberta or other\njurisdiction rule is assumed, and no pay rate or money is stored.\n\nA configurable UTC calendar example (illustrative policy, not payroll advice):\n\n```ts\nimport { PeriodRollupService, type PeriodRulesResolver } from\n  '@happyvertical/smrt-timesheets/rollup';\n\nconst settings = {\n  lengthDays: 14, startDay: 1, timezone: 'UTC', // 0 = Sunday\n  anchor: '2026-01-05T00:00:00Z', // aligned Monday; anchors fortnight phase\n  thresholdSeconds: 80 * 3600,\n  holidays: ['2026-12-25'],\n};\nconst resolver: PeriodRulesResolver = {\n  async periodFor(at) {\n    const anchor = new Date(settings.anchor);\n    if (anchor.getUTCDay() !== settings.startDay || settings.timezone !== 'UTC')\n      throw new Error('Use a timezone-aware calendar resolver for local periods');\n    const length = settings.lengthDays * 86400000;\n    const start = anchor.getTime() +\n      Math.floor((at.getTime() - anchor.getTime()) / length) * length;\n    return {\n      startsAt: new Date(start), endsAt: new Date(start + length),\n      timezone: settings.timezone, version: 'shop-policy-v1', rules: settings,\n    };\n  },\n  async classify(period, sources) {\n    const rules = period.rules as typeof settings;\n    // This example assigns a contribution to its clipped start's UTC date.\n    // Local daily rules should split contributions at their own local midnight.\n    let regular = 0;\n    let holiday = 0;\n    for (const source of sources) {\n      if (rules.holidays.includes(source.startsAt.slice(0, 10))) holiday += source.seconds;\n      else regular += source.seconds;\n    }\n    return {\n      regularSeconds: Math.min(regular, rules.thresholdSeconds),\n      overtimeSeconds: holiday + Math.max(0, regular - rules.thresholdSeconds),\n    };\n  },\n};\nconst rollups = new PeriodRollupService(db, authorizedSubject, resolver,\n  { attendance: true, actorProfileId: authenticatedSupervisorProfileId });\nconst card = await rollups.rollup(new Date());\nawait rollups.confirm(card.id!);\nawait rollups.adjust(card.id!, {\n  operationId: requestId, regularSeconds: 900, overtimeSeconds: 0,\n  reason: 'Approved correction after confirmation',\n});\nconst effectiveSeconds = await rollups.totals(card.id!);\n```\n\nA timezone-aware resolver must compute each local boundary separately: a local\nday crossing DST is not necessarily 86400 seconds. Resolvers can use an app's\nexisting calendar library; no new timezone dependency or implicit default is\nintroduced here.\n\n## Evidence and immutability\n\nOnly approved human `ServiceTimeEntry` rows for the subject count; corrected\nancestors do not. Correction chains must remain within that subject/tenant and\npoint to corrected parents. Multiple approved descendants of one root are\nrejected as ambiguous rather than double-counted. Entries with both `startedAt`\nand `endedAt` allocate their declared seconds\nproportionally across the period using exact integer prefix division, preserving\nseconds over adjacent periods. Unbounded entries count at `startedAt`, or, when\nabsent, `approvedAt`; an end-only timestamp does not create an interval. Missing\nboth attribution timestamps is an error. This is time attribution, not a\nclaim that a manual entry has a continuous wall-clock duration.\n\nWith `attendance: true`, closed punches without `reviewRequired` count, excluding\nunpaid breaks and retaining paid breaks. Open/review-required punches do not\ncount. Linked attendance is authoritative: its evidence entry and any approved\ncorrection descendants are excluded, including when the punch is still under\nreview or outside the requested period. Unlinked approved work entries and\nattendance both count; consumers must link overlapping evidence explicitly.\nSource snapshots preserve each paid attendance segment and entry identity.\n\nRepeated rollup updates one open card per tenant/person/start; a confirmed card\ncannot be recomputed. Confirmation is attributed and idempotent. Model save,\ncollection create/update/upsert and object/collection delete cannot bypass the\nservice. Model mutation capabilities are per-instance and not exported.\nDirect SQL is a trusted administrative boundary, not an exposed application API.\nProfile/card foreign keys restrict deletion to preserve history.\n\nAdjustments contain signed integer regular/overtime deltas, reason, operation\nkey and actor attribution. A retry reuses its row only for the exact same\npayload and actor. Effective totals may never become negative or unsafe.\nAdjustments never alter the confirmed row or source snapshot. Undo an adjustment\nwith a separately attributed compensating adjustment, never deletion.\n\nAll service mutations use a root transaction, transaction-bound collections,\nembedded writer serialization or a PostgreSQL tenant/person advisory lock.\nOutputs are reloaded on the root executor after commit. Rollup reads are an\napplication snapshot: subsequent source approvals/corrections appear on the\nnext open rollup, and confirmed cards require explicit adjustments.\n"
+      "content": "# Period timecards\n\n`@happyvertical/smrt-timesheets/rollup` exports `PeriodRollupService`,\n`PeriodTimecard`, `TimecardAdjustment`, their collections, and resolver types.\nThe package root also exports them. SQLite and PostgreSQL are supported.\nCreate application tables through normal migrations; neither service provisions\nschema. The attendance option additionally requires the attendance tables.\n\nConstruct a service only after authenticating and authorizing its trusted\n`{ tenantId, profileId }` scope. A conflicting ambient tenant is rejected.\n`options.actorProfileId` records a separately authorized supervisor; it defaults\nto the subject profile for self confirmation/correction. Never accept this\ntrusted scope or attribution unchecked from request input. Profile authorization\nis consumer-owned; the service filters every source/card/adjustment read by its\ntrusted subject and tenant. Generic API, CLI and MCP surfaces are closed by\ndefault; consumer registry overrides may further restrict them (#3318).\n\n## Resolver contract\n\n`periodFor(at, actor)` supplies half-open UTC `startsAt`/`endsAt`, an IANA\n`timezone`, a nonempty policy `version`, and a JSON `rules` snapshot.\nThe consumer owns period length, calendar start day, timezone and DST, overtime\nthresholds, holidays and classification. The requested instant must be inside\nthe window. Overlapping windows for existing cards are rejected: introduce a new\ncalendar at a boundary after existing windows, and use adjustments for already\nconfirmed periods.\n\n`classify(period, sources, actor)` returns nonnegative safe integer\n`regularSeconds` and `overtimeSeconds`, whose sum must equal source seconds.\nInputs are detached so resolver mutation cannot rewrite evidence. Resolver\nexceptions, malformed windows, invalid timezone, fractional/unsafe totals and\nnonconserving classification abort the transaction. No Alberta or other\njurisdiction rule is assumed, and no pay rate or money is stored.\n\nA configurable UTC calendar example (illustrative policy, not payroll advice):\n\n```ts\nimport { PeriodRollupService, type PeriodRulesResolver } from\n  '@happyvertical/smrt-timesheets/rollup';\n\nconst settings = {\n  lengthDays: 14, startDay: 1, timezone: 'UTC', // 0 = Sunday\n  anchor: '2026-01-05T00:00:00Z', // aligned Monday; anchors fortnight phase\n  thresholdSeconds: 80 * 3600,\n  holidays: ['2026-12-25'],\n};\nconst resolver: PeriodRulesResolver = {\n  async periodFor(at) {\n    const anchor = new Date(settings.anchor);\n    if (anchor.getUTCDay() !== settings.startDay || settings.timezone !== 'UTC')\n      throw new Error('Use a timezone-aware calendar resolver for local periods');\n    const length = settings.lengthDays * 86400000;\n    const start = anchor.getTime() +\n      Math.floor((at.getTime() - anchor.getTime()) / length) * length;\n    return {\n      startsAt: new Date(start), endsAt: new Date(start + length),\n      timezone: settings.timezone, version: 'shop-policy-v1', rules: settings,\n    };\n  },\n  async classify(period, sources) {\n    const rules = period.rules as typeof settings;\n    // This example assigns a contribution to its clipped start's UTC date.\n    // Local daily rules should split contributions at their own local midnight.\n    let regular = 0;\n    let holiday = 0;\n    for (const source of sources) {\n      if (rules.holidays.includes(source.startsAt.slice(0, 10))) holiday += source.seconds;\n      else regular += source.seconds;\n    }\n    return {\n      regularSeconds: Math.min(regular, rules.thresholdSeconds),\n      overtimeSeconds: holiday + Math.max(0, regular - rules.thresholdSeconds),\n    };\n  },\n};\nconst rollups = new PeriodRollupService(db, authorizedSubject, resolver,\n  { attendance: true, actorProfileId: authenticatedSupervisorProfileId });\nconst card = await rollups.rollup(new Date());\nawait rollups.confirm(card.id!);\nawait rollups.adjust(card.id!, {\n  operationId: requestId, regularSeconds: 900, overtimeSeconds: 0,\n  reason: 'Approved correction after confirmation',\n});\nconst effectiveSeconds = await rollups.totals(card.id!);\n```\n\nA timezone-aware resolver must compute each local boundary separately: a local\nday crossing DST is not necessarily 86400 seconds. Resolvers can use an app's\nexisting calendar library; no new timezone dependency or implicit default is\nintroduced here.\n\n## Evidence and immutability\n\nDecimal-hours-only entries have no measured integer seconds. The seconds-only\nrollup rejects these sources explicitly when their approval instant falls in the\nrequested period; it never rounds them or counts null as\nzero. Use an hours-aware consumer policy for that source representation.\n\nOnly approved human `ServiceTimeEntry` rows for the subject count; corrected\nancestors do not. Correction chains must remain within that subject/tenant and\npoint to corrected parents. Multiple approved descendants of one root are\nrejected as ambiguous rather than double-counted. Entries with both `startedAt`\nand `endedAt` allocate their declared seconds\nproportionally across the period using exact integer prefix division, preserving\nseconds over adjacent periods. Unbounded entries count at `startedAt`, or, when\nabsent, `approvedAt`; an end-only timestamp does not create an interval. Missing\nboth attribution timestamps is an error. This is time attribution, not a\nclaim that a manual entry has a continuous wall-clock duration.\n\nWith `attendance: true`, closed punches without `reviewRequired` count, excluding\nunpaid breaks and retaining paid breaks. Open/review-required punches do not\ncount. Linked attendance is authoritative: its evidence entry and any approved\ncorrection descendants are excluded, including when the punch is still under\nreview or outside the requested period. Unlinked approved work entries and\nattendance both count; consumers must link overlapping evidence explicitly.\nSource snapshots preserve each paid attendance segment and entry identity.\n\nRepeated rollup updates one open card per tenant/person/start; a confirmed card\ncannot be recomputed. Confirmation is attributed and idempotent. Model save,\ncollection create/update/upsert and object/collection delete cannot bypass the\nservice. Model mutation capabilities are per-instance and not exported.\nDirect SQL is a trusted administrative boundary, not an exposed application API.\nProfile/card foreign keys restrict deletion to preserve history.\n\nAdjustments contain signed integer regular/overtime deltas, reason, operation\nkey and actor attribution. A retry reuses its row only for the exact same\npayload and actor. Effective totals may never become negative or unsafe.\nAdjustments never alter the confirmed row or source snapshot. Undo an adjustment\nwith a separately attributed compensating adjustment, never deletion.\n\nAll service mutations use a root transaction, transaction-bound collections,\nembedded writer serialization or a PostgreSQL tenant/person advisory lock.\nOutputs are reloaded on the root executor after commit. Rollup reads are an\napplication snapshot: subsequent source approvals/corrections appear on the\nnext open rollup, and confirmed cards require explicit adjustments.\n"
     }
   ]
 }