@happyvertical/smrt-timesheets 0.55.24 → 0.56.1

package/dist/models/service-snapshots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-snapshots.d.ts","sourceRoot":"","sources":["../../src/models/service-snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EACd,UAAU,EAGX,MAAM,0BAA0B,CAAC;AAGlC;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAa7E;AAoDD;;;GAGG;AACH,qBAYa,qBAAsB,SAAQ,UAAU;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACT,WAAW,EAAE,MAAM,CAAM;IAC7E;;;;;;;;OAQG;IACH,MAAM,EAAE,MAAM,CAAK;IACM,QAAQ,EAAE,MAAM,CAAS;IACzB,cAAc,EAAE,MAAM,CAAM;IAC5B,QAAQ,EAAE,MAAM,CAAM;IACtB,YAAY,EAAE,MAAM,CAAQ;IAC5B,eAAe,EAAE,MAAM,CAAM;IACtD,SAAS,EAAE,IAAI,CAAc;IAEd,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAkBrC;AAED;;;GAGG;AACH,qBAYa,2BAA4B,SAAQ,UAAU;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACT,WAAW,EAAE,MAAM,CAAM;IAC7E;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAK;IACM,QAAQ,EAAE,MAAM,CAAS;IACzB,YAAY,EAAE,MAAM,CAAM;IAC1B,YAAY,EAAE,MAAM,CAAQ;IACrD,SAAS,EAAE,IAAI,CAAc;IAEd,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAkBrC;AAED,kDAAkD;AAClD,qBAAa,+BAAgC,SAAQ,cAAc,CAAC,qBAAqB,CAAC;IACxF,MAAM,CAAC,QAAQ,CAAC,UAAU,+BAAyB;CACpD;AACD,wDAAwD;AACxD,qBAAa,qCAAsC,SAAQ,cAAc,CAAC,2BAA2B,CAAC;IACpG,MAAM,CAAC,QAAQ,CAAC,UAAU,qCAA+B;CAC1D"}
+{"version":3,"file":"service-snapshots.d.ts","sourceRoot":"","sources":["../../src/models/service-snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EACd,UAAU,EAGX,MAAM,0BAA0B,CAAC;AAGlC;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAa7E;AAoDD;;;GAGG;AACH,qBAYa,qBAAsB,SAAQ,UAAU;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACT,WAAW,EAAE,MAAM,CAAM;IAC7E;;;;;;;;OAQG;IACH,MAAM,EAAE,MAAM,CAAK;IACM,QAAQ,EAAE,MAAM,CAAS;IACzB,cAAc,EAAE,MAAM,CAAM;IAC5B,QAAQ,EAAE,MAAM,CAAM;IACtB,YAAY,EAAE,MAAM,CAAQ;IAC5B,eAAe,EAAE,MAAM,CAAM;IACtD,SAAS,EAAE,IAAI,CAAc;IAEd,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAkBrC;AAED;;;GAGG;AACH,qBAYa,2BAA4B,SAAQ,UAAU;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACT,WAAW,EAAE,MAAM,CAAM;IAC7E;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAK;IACM,QAAQ,EAAE,MAAM,CAAS;IACzB,YAAY,EAAE,MAAM,CAAM;IAC1B,YAAY,EAAE,MAAM,CAAQ;IACrD,SAAS,EAAE,IAAI,CAAc;IAEd,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAkBrC;AAED,kDAAkD;AAIlD,qBACa,+BAAgC,SAAQ,cAAc,CAAC,qBAAqB,CAAC;IACxF,MAAM,CAAC,QAAQ,CAAC,UAAU,+BAAyB;CACpD;AACD,wDAAwD;AAIxD,qBACa,qCAAsC,SAAQ,cAAc,CAAC,2BAA2B,CAAC;IACpG,MAAM,CAAC,QAAQ,CAAC,UAAU,qCAA+B;CAC1D"}

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

@@ -1,4 +1,5 @@
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import type { RecordServiceTimeActionInput, ServiceTimeEntryActionTarget } from '../services/time-entry-actions.js';
 import { type ServiceEvidence, type ServiceParticipantKind, type ServiceTimeEntrySource, type ServiceTimeEntryStatus } from '../types.js';
 /**
  * Fields that may not change once an entry is approved (or corrected). A
@@ -6,6 +7,13 @@ import { type ServiceEvidence, type ServiceParticipantKind, type ServiceTimeEntr
  * {@link ServiceTimeEntry.frozenFieldNames}.
  */
 export declare const SERVICE_TIME_ENTRY_FROZEN_FIELDS: readonly ["tenantId", "workRefType", "workRefId", "participantKind", "participantProfileId", "agentRef", "source", "description", "startedAt", "endedAt", "durationSeconds", "evidence", "correctionOfId"];
+/**
+ * The service-backed write actions (#4001). Each is a `POST
+ * /<collection>/<action>` route guarded by the `<collection>.<action>`
+ * permission inside the action itself, so every transport that reaches it
+ * enforces the same rule.
+ */
+export declare const SERVICE_TIME_ENTRY_ACTIONS: readonly ["record", "submit", "approve"];
 /**
  * A person or agent worked this long on this thing, and someone approved it.
  *
@@ -63,9 +71,36 @@ export declare class ServiceTimeEntry extends SmrtObject {
     save(): Promise<this>;
     private readPrior;
 }
-/** Collection over `service_time_entries`. */
+/**
+ * Collection over `service_time_entries`.
+ *
+ * Collection classes are registered too, so this one carries its own surface:
+ * undecorated, it published generated `create`/`update`/`delete` MCP tools and
+ * CLI commands that wrote status and the approval trail directly. It keeps the
+ * reads it published and hosts the service-backed actions on REST only.
+ */
 export declare class ServiceTimeEntryCollection extends SmrtCollection<ServiceTimeEntry> {
     static readonly _itemClass: typeof ServiceTimeEntry;
+    /**
+     * Record a draft time entry for the signed-in person through
+     * `ServiceEvidenceService.record()`. Needs `<collection>.record`; recording
+     * for another participant also needs `<collection>.approve`. The tenant and
+     * actor come from the session, never from the body.
+     */
+    record(options: RecordServiceTimeActionInput): Promise<ServiceTimeEntry>;
+    /**
+     * Submit a draft or rejected entry for approval through
+     * `ServiceEvidenceService.submit()`. Needs `<collection>.submit`; only the
+     * entry's participant may submit it unless the caller can also approve.
+     */
+    submit(options: ServiceTimeEntryActionTarget): Promise<ServiceTimeEntry>;
+    /**
+     * Approve a submitted entry through `ServiceEvidenceService.approve()`,
+     * writing its charge and compensation snapshots with the host's installed
+     * `ServiceCommercialResolver`. Needs an explicit `<collection>.approve`
+     * grant (no super-admin bypass). Retrying an incomplete approval is safe.
+     */
+    approve(options: ServiceTimeEntryActionTarget): Promise<ServiceTimeEntry>;
     forWork(workRefType: string, workRefId: string): Promise<ServiceTimeEntry[]>;
     pendingApproval(): Promise<ServiceTimeEntry[]>;
 }

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,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"}
+{"version":3,"file":"service-time-entry.d.ts","sourceRoot":"","sources":["../../src/models/service-time-entry.ts"],"names":[],"mappings":"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"}

package/dist/recipes.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Declared recipes for smrt-timesheets (#3590, #3604): user-facing units of
+ * functionality an app or agent can pick instead of the whole package.
+ * The scanner reads these statics into the `recipes` array of `manifest.json`
+ * and `smrt-knowledge.json`; nothing here runs at that point.
+ *
+ * @packageDocumentation
+ */
+import { SmrtRecipe } from '@happyvertical/smrt-core';
+import { ServiceTimeEntry } from './models/service-time-entry.js';
+/** Time entries: Record who worked how long on what, for approval. */
+export declare class TimeEntriesRecipe extends SmrtRecipe {
+    static id: string;
+    static help: string;
+    static label: string;
+    static summary: string;
+    static synonyms: string[];
+    static section: {
+        id: string;
+        label: string;
+        icon: string;
+        description: string;
+    };
+    static models: (typeof ServiceTimeEntry)[];
+    static nav: {
+        label: string;
+        model: typeof ServiceTimeEntry;
+        icon: string;
+        description: string;
+    }[];
+    static options: {
+        readonly ServiceTimeEntry: {
+            readonly fields: {
+                readonly participantProfileId: {
+                    readonly label: "Person";
+                    readonly order: 1;
+                };
+                readonly description: {
+                    readonly order: 2;
+                    readonly help: "What the time was spent on, in a few words.";
+                };
+                readonly startedAt: {
+                    readonly label: "Started";
+                    readonly order: 3;
+                };
+                readonly endedAt: {
+                    readonly label: "Ended";
+                    readonly order: 4;
+                };
+                readonly durationSeconds: {
+                    readonly label: "Duration (seconds)";
+                    readonly order: 5;
+                    readonly help: "Whole seconds: 3600 is one hour.";
+                };
+                readonly workRefId: {
+                    readonly label: "Work reference";
+                    readonly order: 6;
+                    readonly help: "The job, project or case this time belongs to.";
+                };
+                readonly workRefType: {
+                    readonly visibility: "hidden";
+                };
+                readonly participantKind: {
+                    readonly default: "human";
+                    readonly visibility: "hidden";
+                };
+                readonly agentRef: {
+                    readonly visibility: "hidden";
+                };
+                readonly source: {
+                    readonly default: "manual";
+                    readonly visibility: "hidden";
+                };
+                readonly evidence: {
+                    readonly visibility: "hidden";
+                };
+                readonly status: {
+                    readonly visibility: "hidden";
+                    readonly locked: true;
+                };
+                readonly submittedAt: {
+                    readonly visibility: "hidden";
+                    readonly locked: true;
+                };
+                readonly submittedByProfileId: {
+                    readonly visibility: "hidden";
+                    readonly locked: true;
+                };
+                readonly approvedAt: {
+                    readonly visibility: "hidden";
+                    readonly locked: true;
+                };
+                readonly approvedByProfileId: {
+                    readonly visibility: "hidden";
+                    readonly locked: true;
+                };
+                readonly approvalPath: {
+                    readonly visibility: "hidden";
+                    readonly locked: true;
+                };
+                readonly rejectedAt: {
+                    readonly visibility: "hidden";
+                    readonly locked: true;
+                };
+                readonly rejectedByProfileId: {
+                    readonly visibility: "hidden";
+                    readonly locked: true;
+                };
+                readonly rejectionReason: {
+                    readonly visibility: "hidden";
+                    readonly locked: true;
+                };
+                readonly correctionOfId: {
+                    readonly visibility: "hidden";
+                    readonly locked: true;
+                };
+                readonly metadata: {
+                    readonly visibility: "hidden";
+                };
+            };
+        };
+    };
+}
+//# sourceMappingURL=recipes.d.ts.map

package/dist/recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,sEAAsE;AACtE,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,MAAM,CAAC,EAAE,SAA6B;IACtC,MAAM,CAAC,IAAI,SAA8B;IACzC,MAAM,CAAC,KAAK,SAAkB;IAC9B,MAAM,CAAC,OAAO,SAAuD;IACrE,MAAM,CAAC,QAAQ,WAMb;IACF,MAAM,CAAC,OAAO;;;;;MAKZ;IACF,MAAM,CAAC,MAAM,8BAAsB;IACnC,MAAM,CAAC,GAAG;;;;;QAQR;IACF,MAAM,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA0CH;CACZ"}

package/dist/rollup/correction-guard.d.ts

@@ -0,0 +1,12 @@
+import type { AttendanceCorrectionGuard } from '../attendance/correction-service.js';
+/**
+ * An `AttendanceCorrectionService` guard that refuses to change attendance
+ * inside a period a `PeriodTimecard` has confirmed. A confirmed card never
+ * changes, so correcting its sources would leave card and attendance
+ * disagreeing; reopen the card first (`PeriodRollupService.reopen`), correct,
+ * then roll up again. A submitted card is frozen too. A reopened card is `open`
+ * again, so corrections inside it are allowed.
+ * Needs the `period_timecards` table, which is why it is opt-in.
+ */
+export declare const confirmedTimecardGuard: AttendanceCorrectionGuard;
+//# sourceMappingURL=correction-guard.d.ts.map

package/dist/rollup/correction-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correction-guard.d.ts","sourceRoot":"","sources":["../../src/rollup/correction-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAGrF;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,yBAuBpC,CAAC"}

package/dist/rollup/models.d.ts

@@ -1,5 +1,7 @@
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
 import type { TimecardSource } from './types.js';
+/** `open` is the draft state; `submitted` is optional (see `PeriodRollupService`). */
+export type TimecardStatus = 'open' | 'submitted' | 'confirmed';
 /** One person's immutable-on-confirmation period snapshot, in integer seconds. */
 export declare class PeriodTimecard extends SmrtObject {
     tenantId: string;
@@ -13,7 +15,10 @@ export declare class PeriodTimecard extends SmrtObject {
     regularSeconds: number;
     overtimeSeconds: number;
     totalSeconds: number;
-    status: 'open' | 'confirmed';
+    status: TimecardStatus;
+    /** Set by `submit()`; cleared when the card is reopened. */
+    submittedAt: Date | null;
+    submittedByProfileId: string | null;
     confirmedAt: Date | null;
     confirmedByProfileId: string | null;
     /** Return a detached source snapshot; corrupt persisted JSON fails closed. */
@@ -36,6 +41,27 @@ export declare class TimecardAdjustment extends SmrtObject {
     save(): Promise<this>;
     delete(): Promise<void>;
 }
+/**
+ * Append-only audit row for one reopening of a submitted or confirmed card: who
+ * reopened whose period, why, and the totals it had at that moment (base,
+ * adjustments and effective, in integer seconds). Written only by
+ * `PeriodRollupService.reopen()` in the same transaction as the status change.
+ */
+export declare class TimecardReopening extends SmrtObject {
+    tenantId: string;
+    timecardId: string;
+    profileId: string;
+    actorProfileId: string;
+    operationId: string;
+    fromStatus: TimecardStatus;
+    reason: string;
+    /** JSON: base/adjustment/effective seconds, confirmation and submission attribution. */
+    previousState: string;
+    /** The totals and attribution the card had when it was reopened. */
+    getPrevious<T = Record<string, unknown>>(): T;
+    save(): Promise<this>;
+    delete(): Promise<void>;
+}
 /** Scoped persistence collection; mutations must use PeriodRollupService. */
 export declare class PeriodTimecardCollection extends SmrtCollection<PeriodTimecard> {
     static readonly _itemClass: typeof PeriodTimecard;
@@ -44,4 +70,8 @@ export declare class PeriodTimecardCollection extends SmrtCollection<PeriodTimec
 export declare class TimecardAdjustmentCollection extends SmrtCollection<TimecardAdjustment> {
     static readonly _itemClass: typeof TimecardAdjustment;
 }
+/** Scoped append-only reopening ledger. */
+export declare class TimecardReopeningCollection extends SmrtCollection<TimecardReopening> {
+    static readonly _itemClass: typeof TimecardReopening;
+}
 //# sourceMappingURL=models.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/rollup/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,kFAAkF;AAClF,qBAQa,cAAe,SAAQ,UAAU;IAChC,QAAQ,SAAM;IAI1B,SAAS,SAAM;IACf,QAAQ,EAAE,IAAI,CAAe;IAC7B,MAAM,EAAE,IAAI,CAAe;IAC3B,QAAQ,SAAM;IACd,YAAY,SAAM;IACO,aAAa,SAAQ;IACrB,cAAc,SAAQ;IAC/C,cAAc,SAAK;IACnB,eAAe,SAAK;IACpB,YAAY,SAAK;IACQ,MAAM,EAAE,MAAM,GAAG,WAAW,CAAU;IAC/D,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAKhC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE3C,8EAA8E;IAC9E,UAAU,IAAI,cAAc,EAAE;IAM9B,0DAA0D;IAC1D,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC;AAED,oFAAoF;AACpF,qBAQa,kBAAmB,SAAQ,UAAU;IACpC,QAAQ,SAAM;IAC4B,UAAU,SAAM;IAItE,SAAS,SAAM;IAIf,cAAc,SAAM;IACpB,WAAW,SAAM;IACjB,cAAc,SAAK;IACnB,eAAe,SAAK;IACpB,MAAM,SAAM;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC;AACD,6EAA6E;AAC7E,qBAAa,wBAAyB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC1E,MAAM,CAAC,QAAQ,CAAC,UAAU,wBAAkB;CAC7C;AACD,gDAAgD;AAChD,qBAAa,4BAA6B,SAAQ,cAAc,CAAC,kBAAkB,CAAC;IAClF,MAAM,CAAC,QAAQ,CAAC,UAAU,4BAAsB;CACjD"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/rollup/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,sFAAsF;AACtF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;AAEhE,kFAAkF;AAClF,qBAQa,cAAe,SAAQ,UAAU;IAChC,QAAQ,SAAM;IAI1B,SAAS,SAAM;IACf,QAAQ,EAAE,IAAI,CAAe;IAC7B,MAAM,EAAE,IAAI,CAAe;IAC3B,QAAQ,SAAM;IACd,YAAY,SAAM;IACO,aAAa,SAAQ;IACrB,cAAc,SAAQ;IAC/C,cAAc,SAAK;IACnB,eAAe,SAAK;IACpB,YAAY,SAAK;IACQ,MAAM,EAAE,cAAc,CAAU;IACzD,4DAA4D;IAC5D,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAKhC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC3C,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAKhC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE3C,8EAA8E;IAC9E,UAAU,IAAI,cAAc,EAAE;IAM9B,0DAA0D;IAC1D,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC;AAED,oFAAoF;AACpF,qBAQa,kBAAmB,SAAQ,UAAU;IACpC,QAAQ,SAAM;IAC4B,UAAU,SAAM;IAItE,SAAS,SAAM;IAIf,cAAc,SAAM;IACpB,WAAW,SAAM;IACjB,cAAc,SAAK;IACnB,eAAe,SAAK;IACpB,MAAM,SAAM;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC;AACD;;;;;GAKG;AACH,qBAca,iBAAkB,SAAQ,UAAU;IACnC,QAAQ,SAAM;IAC4B,UAAU,SAAM;IAItE,SAAS,SAAM;IAIf,cAAc,SAAM;IACpB,WAAW,SAAM;IACQ,UAAU,EAAE,cAAc,CAAe;IACzC,MAAM,SAAM;IACrC,wFAAwF;IAC/D,aAAa,SAAQ;IAC9C,oEAAoE;IACpE,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;IAM9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC;AACD,6EAA6E;AAC7E,qBAAa,wBAAyB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC1E,MAAM,CAAC,QAAQ,CAAC,UAAU,wBAAkB;CAC7C;AACD,gDAAgD;AAChD,qBAAa,4BAA6B,SAAQ,cAAc,CAAC,kBAAkB,CAAC;IAClF,MAAM,CAAC,QAAQ,CAAC,UAAU,4BAAsB;CACjD;AACD,2CAA2C;AAC3C,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,iBAAiB,CAAC;IAChF,MAAM,CAAC,QAAQ,CAAC,UAAU,2BAAqB;CAChD"}

package/dist/rollup/service.d.ts

@@ -1,6 +1,6 @@
 import type { DatabaseInterface } from '@happyvertical/sql';
-import { PeriodTimecard, TimecardAdjustment } from './models.js';
-import type { PeriodRulesResolver, TimecardActor, TimecardAdjustmentInput } from './types.js';
+import { PeriodTimecard, TimecardAdjustment, TimecardReopening } from './models.js';
+import type { PeriodRollupOptions, PeriodRulesResolver, TimecardActor, TimecardAdjustmentInput, TimecardReopenInput } from './types.js';
 /**
  * Server-side, trusted tenant/person capability. Consumers authorize this scope
  * before construction. Reads and writes reject conflicting ambient tenancy.
@@ -11,10 +11,7 @@ export declare class PeriodRollupService {
     private readonly actor;
     private readonly resolver;
     private readonly options;
-    constructor(db: DatabaseInterface, actor: TimecardActor, resolver: PeriodRulesResolver, options?: {
-        attendance?: boolean;
-        actorProfileId?: string;
-    });
+    constructor(db: DatabaseInterface, actor: TimecardActor, resolver: PeriodRulesResolver, options?: PeriodRollupOptions);
     private identity;
     private scope;
     private transact;
@@ -23,8 +20,29 @@ export declare class PeriodRollupService {
     get(id: string): Promise<PeriodTimecard>;
     /** Rebuild one open card from a consistent transaction-bound source snapshot. */
     rollup(at: Date): Promise<PeriodTimecard>;
-    /** Confirm the current snapshot; repeated confirmation is idempotent. */
+    /**
+     * Optional step: freeze an open card for review (open -> submitted). The
+     * actor is the submitter; repeating it on a submitted card is idempotent.
+     */
+    submit(id: string): Promise<PeriodTimecard>;
+    /**
+     * Confirm the current snapshot; repeated confirmation is idempotent. With
+     * `requireSubmission` the card must be submitted first.
+     */
     confirm(id: string): Promise<PeriodTimecard>;
+    /**
+     * Return a submitted or confirmed card to `open` so its sources can be
+     * corrected and `rollup()` run again, then confirmed anew. Needs a reason and
+     * an operation key; appends a `TimecardReopening` with the totals the card had
+     * (base, adjustments, effective). Adjustments stay on the ledger and keep
+     * counting in `totals()`: after a re-roll, offset them with a new adjustment
+     * if the correction made them redundant. The consumer authorizes the actor
+     * (give reopening its own permission); a retry with the same key and reason
+     * is a no-op.
+     */
+    reopen(id: string, input: TimecardReopenInput): Promise<PeriodTimecard>;
+    /** The append-only reopening history of one card, oldest first. */
+    reopenings(id: string): Promise<TimecardReopening[]>;
     /** Append a correction. An operation key retry must have exactly the same payload. */
     adjust(id: string, input: TimecardAdjustmentInput): Promise<TimecardAdjustment>;
     /** Effective totals combine the frozen base with append-only corrections. */

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;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"}
+{"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,EAElB,iBAAiB,EAElB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EAEpB,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,mBAAwB;IAmBpD,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;IAgJ/C;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcjD;;;OAGG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAalD;;;;;;;;;OASG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,cAAc,CAAC;IA0F1B,mEAAmE;IAC7D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAU1D,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/types.d.ts

@@ -35,4 +35,22 @@ export interface TimecardAdjustmentInput {
     overtimeSeconds: number;
     reason: string;
 }
+/** Reopen a submitted or confirmed card. The actor is authorized by the consumer. */
+export interface TimecardReopenInput {
+    /** Idempotency key; a retry must carry exactly the same reason. */
+    operationId: string;
+    /** Required, non-blank; stored on the ledger row. */
+    reason: string;
+}
+/** Service options for the card lifecycle. */
+export interface PeriodRollupOptions {
+    attendance?: boolean;
+    actorProfileId?: string;
+    /**
+     * When true, `confirm()` accepts only a `submitted` card (open -> submitted
+     * -> confirmed). Default false: `submit()` is optional and `confirm()` also
+     * accepts an `open` card (open -> confirmed), as before.
+     */
+    requireSubmission?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rollup/types.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7E,QAAQ,CACN,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,OAAO,EAAE,SAAS,QAAQ,CAAC,cAAc,CAAC,EAAE,EAC5C,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC7B,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAED,qFAAqF;AACrF,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rollup/types.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7E,QAAQ,CACN,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,OAAO,EAAE,SAAS,QAAQ,CAAC,cAAc,CAAC,EAAE,EAC5C,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC7B,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAED,qFAAqF;AACrF,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/rollup/write.d.ts

@@ -1,4 +1,6 @@
 import type { SmrtObject } from '@happyvertical/smrt-core';
 export declare function assertRollupWrite(object: SmrtObject): void;
 export declare function persistRollup<T extends SmrtObject>(object: T): Promise<T>;
+export declare function isReopenWrite(object: SmrtObject): boolean;
+export declare function persistReopen<T extends SmrtObject>(object: T): Promise<T>;
 //# sourceMappingURL=write.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/rollup/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAI3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAK1D;AACD,wBAAsB,aAAa,CAAC,CAAC,SAAS,UAAU,EACtD,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,CAAC,CAQZ"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/rollup/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAI3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAK1D;AACD,wBAAsB,aAAa,CAAC,CAAC,SAAS,UAAU,EACtD,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,CAAC,CAQZ;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD;AACD,wBAAsB,aAAa,CAAC,CAAC,SAAS,UAAU,EACtD,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/rollup.d.ts

@@ -1,5 +1,6 @@
 import './__smrt-register__.js';
-export { PeriodTimecard, PeriodTimecardCollection, TimecardAdjustment, TimecardAdjustmentCollection, } from './rollup/models.js';
+export { confirmedTimecardGuard } from './rollup/correction-guard.js';
+export { PeriodTimecard, PeriodTimecardCollection, TimecardAdjustment, TimecardAdjustmentCollection, TimecardReopening, TimecardReopeningCollection, type TimecardStatus, } from './rollup/models.js';
 export { PeriodRollupService } from './rollup/service.js';
-export type { PeriodRulesResolver, TimecardActor, TimecardAdjustmentInput, TimecardPeriod, TimecardSource, } from './rollup/types.js';
+export type { PeriodRollupOptions, PeriodRulesResolver, TimecardActor, TimecardAdjustmentInput, TimecardPeriod, TimecardReopenInput, TimecardSource, } from './rollup/types.js';
 //# sourceMappingURL=rollup.d.ts.map

package/dist/rollup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,4BAA4B,EAC5B,iBAAiB,EACjB,2BAA2B,EAC3B,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,mBAAmB,CAAC"}

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-Du6uaqyM.js";
-export { PeriodRollupService, PeriodTimecard, PeriodTimecardCollection, TimecardAdjustment, TimecardAdjustmentCollection };
+import { a as confirmedTimecardGuard, c as TimecardAdjustment, d as TimecardReopeningCollection, l as TimecardAdjustmentCollection, o as PeriodTimecard, s as PeriodTimecardCollection, t as PeriodRollupService, u as TimecardReopening } from "./chunks/rollup-CzCb-DxI.js";
+export { PeriodRollupService, PeriodTimecard, PeriodTimecardCollection, TimecardAdjustment, TimecardAdjustmentCollection, TimecardReopening, TimecardReopeningCollection, confirmedTimecardGuard };

package/dist/services/action-principal.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The acting principal for the generated service-backed time entry actions
+ * (#4001).
+ *
+ * Identity always comes from the ambient request context, never from the
+ * request body: the tenancy ALS (`withTenant`, the SvelteKit/Express
+ * adapters) first, then the authenticated smrt-users session-permission ALS
+ * (`createSessionHandler()` without `enterTenantContext`). This is the
+ * smrt-fields / smrt-preferences precedent. Authorization goes through
+ * smrt-users' `assertOperationPermission()` against the principal's published
+ * permission snapshot, so ceilings, super-admin and catalog presence behave
+ * exactly as they do for every other guarded operation.
+ */
+import type { SmrtClassOptions } from '@happyvertical/smrt-core';
+import { type OperationPermissionCollectionInput } from '@happyvertical/smrt-users';
+/** A refused action with a 4xx status the generated transports serialize. */
+export declare class TimesheetActionError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly publicMessage: string;
+    constructor(status: number, code: string, message: string);
+}
+/** Who is acting, resolved from the ambient context. */
+export interface TimesheetActionPrincipal {
+    tenantId: string;
+    userId: string;
+    permissions: ReadonlySet<string>;
+    /** smrt-profiles Profile linked to the user; stamped into audit fields. */
+    profileId: string;
+    /** True when the tenancy ALS already carries this principal. */
+    fromTenancy: boolean;
+}
+/** True when the ambient principal holds `<collection>.<action>`. */
+export declare function principalHolds(collection: OperationPermissionCollectionInput, action: string, options: SmrtClassOptions): Promise<boolean>;
+/**
+ * Authorize `<collection>.<action>` for the ambient principal and resolve the
+ * profile it acts as. Fails closed (403) without an authenticated,
+ * tenant-bound principal, without the permission, or without a linked
+ * profile — an action always records who took it.
+ *
+ * System context never bypasses: trusted server code without a person calls
+ * `ServiceEvidenceService` directly. `allowSuperAdminBypass: false` is for
+ * money and separation-of-duties operations that need an explicit grant.
+ */
+export declare function authorizeTimesheetAction(collection: OperationPermissionCollectionInput, action: string, options: SmrtClassOptions, guard: {
+    allowSuperAdminBypass: boolean;
+}): Promise<TimesheetActionPrincipal>;
+/**
+ * Run `fn` with the tenancy ALS carrying `principal`, so the tenancy
+ * interceptor scopes every read and write. A session-only principal is
+ * entered with the same tenant, user and permissions; nothing is widened.
+ */
+export declare function withActionPrincipal<T>(principal: TimesheetActionPrincipal, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=action-principal.d.ts.map

package/dist/services/action-principal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-principal.d.ts","sourceRoot":"","sources":["../../src/services/action-principal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAGL,KAAK,kCAAkC,EAGxC,MAAM,2BAA2B,CAAC;AAEnC,6EAA6E;AAC7E,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAO1D;AAED,wDAAwD;AACxD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,WAAW,EAAE,OAAO,CAAC;CACtB;AAyDD,qEAAqE;AACrE,wBAAsB,cAAc,CAClC,UAAU,EAAE,kCAAkC,EAC9C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,kCAAkC,EAC9C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE;IAAE,qBAAqB,EAAE,OAAO,CAAA;CAAE,GACxC,OAAO,CAAC,wBAAwB,CAAC,CA0CnC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,SAAS,EAAE,wBAAwB,EACnC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAUZ"}

package/dist/services/index.d.ts

@@ -1,5 +1,7 @@
+export { TimesheetActionError, type TimesheetActionPrincipal, } from './action-principal.js';
 export * from './dated-labour-commercial-resolver.js';
 export * from './dated-percentage-labour-commercial-resolver.js';
 export * from './labour-valuation-reconciliation.js';
 export * from './service-evidence-service.js';
+export * from './time-entry-actions.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAC;AACtD,cAAc,kDAAkD,CAAC;AACjE,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,wBAAwB,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,cAAc,uCAAuC,CAAC;AACtD,cAAc,kDAAkD,CAAC;AACjE,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC"}

package/dist/services/time-entry-actions.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Service-backed write actions for `ServiceTimeEntry` (#4001).
+ *
+ * The generated CRUD writes stay closed: these are the only generated write
+ * path, and each delegates to {@link ServiceEvidenceService}, so the status
+ * machine, the submission/approval trail and the charge/compensation
+ * snapshots are set in exactly one place. The thin collection methods in
+ * `models/service-time-entry.ts` call in here.
+ */
+import type { SmrtClassOptions } from '@happyvertical/smrt-core';
+import type { ServiceTimeEntry, ServiceTimeEntryCollection } from '../models/service-time-entry.js';
+import type { ServiceEvidence } from '../types.js';
+import { type ServiceCommercialResolver } from './service-evidence-service.js';
+/** Approval path stamped by the generated `approve` action. */
+export declare const SERVICE_TIME_ENTRY_ACTION_APPROVAL_PATH = "operator";
+/**
+ * What `approve` prices with: a resolver, or a factory the action calls per
+ * request with the collection's options. Use the factory whenever the
+ * resolver writes (e.g. smrt-projects' `SubscriptionServiceCommercialResolver`
+ * records client charges): `options.db` is the request-bound executor, so
+ * those writes share the request's transaction and PostgreSQL RLS state
+ * instead of a connection captured at startup.
+ */
+export type ServiceTimeEntryCommercialResolverSource = ServiceCommercialResolver | ((context: {
+    options: SmrtClassOptions;
+}) => ServiceCommercialResolver | Promise<ServiceCommercialResolver>);
+/**
+ * Install what the generated `approve` action prices with. Pass `null` to
+ * remove it. Without one, `approve` refuses with 409
+ * (`approval_not_configured`) and writes nothing.
+ *
+ * @example
+ * ```ts
+ * setServiceTimeEntryCommercialResolver(({ options }) =>
+ *   SubscriptionServiceCommercialResolver.create(options, provider),
+ * );
+ * ```
+ */
+export declare function setServiceTimeEntryCommercialResolver(resolver: ServiceTimeEntryCommercialResolverSource | null): void;
+/** The source installed by {@link setServiceTimeEntryCommercialResolver}. */
+export declare function getServiceTimeEntryCommercialResolver(): ServiceTimeEntryCommercialResolverSource | null;
+/** Body of the `record` action. Identity and tenant come from the session. */
+export interface RecordServiceTimeActionInput {
+    workRefType: string;
+    workRefId: string;
+    /** Defaults to the acting user's profile; another person needs `approve`. */
+    participantProfileId?: string | null;
+    /** `manual` (default) or `timer`; imports and agents use the service. */
+    source?: 'manual' | 'timer';
+    description?: string;
+    /** ISO 8601 instant. */
+    startedAt?: string | null;
+    /** ISO 8601 instant. */
+    endedAt?: string | null;
+    durationSeconds?: number | null;
+    /** Exact positive decimal text; exclusive with seconds and timestamps. */
+    durationHours?: string;
+    evidence?: ServiceEvidence[];
+    metadata?: Record<string, unknown>;
+}
+/** Body of the `submit` and `approve` actions. */
+export interface ServiceTimeEntryActionTarget {
+    entryId: string;
+}
+/** `record`: create a draft entry through `ServiceEvidenceService.record()`. */
+export declare function recordServiceTimeAction(entries: ServiceTimeEntryCollection, input: unknown): Promise<ServiceTimeEntry>;
+/**
+ * `submit`: `draft | rejected → submitted` through
+ * `ServiceEvidenceService.submit()`, stamping `submittedAt` and the acting
+ * profile. Only the entry's participant may submit it, unless the caller
+ * holds `approve` (a supervisor submitting on someone's behalf).
+ */
+export declare function submitServiceTimeAction(entries: ServiceTimeEntryCollection, input: unknown): Promise<ServiceTimeEntry>;
+/**
+ * `approve`: `submitted → approved` through `ServiceEvidenceService.approve()`,
+ * which stamps `approvedAt`, the acting profile and the approval path, then
+ * writes the immutable charge and compensation snapshots through the
+ * installed {@link setServiceTimeEntryCommercialResolver resolver} (a factory
+ * is called per request with the collection's options). Money:
+ * super-admin bypass does not apply, the grant must be explicit.
+ */
+export declare function approveServiceTimeAction(entries: ServiceTimeEntryCollection, input: unknown): Promise<ServiceTimeEntry>;
+//# sourceMappingURL=time-entry-actions.d.ts.map

package/dist/services/time-entry-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-entry-actions.d.ts","sourceRoot":"","sources":["../../src/services/time-entry-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAKjE,OAAO,KAAK,EACV,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQnD,OAAO,EACL,KAAK,yBAAyB,EAE/B,MAAM,+BAA+B,CAAC;AAEvC,+DAA+D;AAC/D,eAAO,MAAM,uCAAuC,aAAa,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,MAAM,wCAAwC,GAChD,yBAAyB,GACzB,CAAC,CAAC,OAAO,EAAE;IACT,OAAO,EAAE,gBAAgB,CAAC;CAC3B,KAAK,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC;AAK1E;;;;;;;;;;;GAWG;AACH,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,wCAAwC,GAAG,IAAI,GACxD,IAAI,CAEN;AAED,6EAA6E;AAC7E,wBAAgB,qCAAqC,IAAI,wCAAwC,GAAG,IAAI,CAEvG;AAED,8EAA8E;AAC9E,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,yEAAyE;IACzE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,kDAAkD;AAClD,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAgHD,gFAAgF;AAChF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,0BAA0B,EACnC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,gBAAgB,CAAC,CAqF3B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,0BAA0B,EACnC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,gBAAgB,CAAC,CAuB3B;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,0BAA0B,EACnC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,gBAAgB,CAAC,CAkC3B"}