@happyvertical/smrt-timesheets 0.56.2 → 0.57.1

package/AGENTS.md

@@ -25,12 +25,16 @@ per-instance capability (`attendance/write.ts`, not exported) that lifts the
 models' closed-interval checks for one save, validates the whole punch layout,
 recomputes durations and appends an `AttendanceCorrection` (append-only ledger,
 no generated operations; only a first acknowledgement by the subject may update
-a row). Never export `write.ts`. Punch `source`/`deviceRef*` and break `kind` are immutable except through corrections; `autoCloseReason` is write-once via `persistAutoClose`. A confirmed `PeriodTimecard` is honoured by the
+a row). An open punch accepts only a `startedAt` correction, closed breaks/segments inside it, and `addPunch({ open: true })`; the open break/segment and closing stay `AttendanceService`'s. Never export `write.ts`. Punch `source`/`deviceRef*` and break `kind` are immutable except through corrections; `autoCloseReason` is write-once via `persistAutoClose`. A confirmed `PeriodTimecard` is honoured by the
 opt-in `confirmedTimecardGuard` (`rollup/correction-guard.ts`), which refuses
 while a card is submitted or confirmed. `PeriodRollupService.reopen()` returns
 such a card to `open` and appends a `TimecardReopening` (`timecard_reopenings`,
 append-only, service-only via `rollup/write.ts`); `submit()` is the optional
 open -> submitted step (`requireSubmission` makes it mandatory) (#3950).
+`PeriodRollupOptions.attribution` (`'clip'` default | `'start'`) decides crossing
+sources: `'start'` keeps a punch (breaks and segments included) or bounded entry
+whole in the period containing its start, unclipped, and excludes it from the
+next (`attributeSource` in `rollup/calculation.ts`) (#4028).
 Segment transitions live in `attendance/segments.ts`; compose them with other
 attendance writes via `AttendanceService.withTransaction`. Any new attendance
 table must be added to the `includeObjects` lists in the `*.optional.test.ts`
@@ -178,7 +182,9 @@ Timecards and adjustments have closed generated surfaces and service-only
 model writes; never bypass the instance capability with generic persistence.
 
 Replay hashes the tap AS SENT (action, device `at`, paid, work, and `source`/`device`/`kind` only when present, so older receipts still match) so retries match;
-`replay(taps, { resolveAt, now, refusal })` only changes the stored time and
-reason. Never hash the resolved time. Work actions (`startWork`, `switchWork`,
+`replay(taps, { resolveAt, now, refusal })` only changes the stored time, reason and the
+punch's `recordedOffline`/`reviewRequired` (both default true and stay set across
+later taps; false never clears an earlier flag). A reviewed correction clears
+`reviewRequired`. Never hash the resolved time. Work actions (`startWork`, `switchWork`,
 `stopWork`, `resumeWork`) run in the tap's transaction via `apply()`. Refusals store
 `code` from `AttendanceConflict.code`; give new conflicts a code.

package/README.md

@@ -366,6 +366,21 @@ Indexes on `(tenantId, workRefType, workRefId)` and `(tenantId, taskRefType,
 taskRefId)` serve job costing; a unique `(tenantId, punchId, openSlot)` index
 allows one open segment per punch. Segments never overlap each other or a break.
 
+`profileId` is the person whose time it is: the services copy it from the
+segment's punch when creating a segment (`startWork`, `switchWork`, `resumeWork`, replayed
+work actions, and the correction service's `saveSegment` and `addPunch`
+segments), it is immutable, and a write whose `profileId` differs from its
+punch's is refused. Indexed `(tenantId, profileId, startedAt)`, so labour by
+person needs no join. After adding the column through migrations, legacy rows
+have SQL NULL (hydrated as `null`); older text columns may also contain `''`.
+Closing or correcting those segments remains supported. Before reporting by
+person, run this idempotent backfill on SQLite or PostgreSQL; it preserves
+populated identities and matches the punch within the same tenant:
+`UPDATE attendance_segments SET profile_id = (SELECT p.profile_id FROM
+attendance_punches p WHERE p.id = attendance_segments.punch_id AND p.tenant_id = attendance_segments.tenant_id)
+WHERE COALESCE(CAST(profile_id AS TEXT), '') = '' AND EXISTS (SELECT 1 FROM
+attendance_punches p WHERE p.id = attendance_segments.punch_id AND p.tenant_id = attendance_segments.tenant_id)`.
+
 ```ts
 await attendance.punchIn(t(8));
 await attendance.startWork(t(8), { workRefType: '@acme:WorkOrder', workRefId: 'WO-1',
@@ -431,7 +446,8 @@ migrate them as `TEXT NOT NULL DEFAULT ''` (a NULL left on an older row is read
 `punchIn`, `punchOut`, `startBreak`, `endBreak`, or a work action (`startWork`,
 `switchWork` (both require `work`), `stopWork`, `resumeWork`). It sorts each batch by device
 time, then client id. Client ids are durable and scoped to tenant/profile.
-Successful taps set `recordedOffline` and `reviewRequired`. The conflict policy
+Successful taps set `recordedOffline` and `reviewRequired` unless `resolveAt` says otherwise;
+they never clear a flag set by an earlier tap. The conflict policy
 is **committed attendance wins**: an event predating committed activity, or
 invalid for the current state, gets a durable error outcome. Identical retries
 return that outcome even after later shifts; changed payloads using the same id
@@ -458,8 +474,13 @@ await attendance.replay(taps, {
 
 The receipt hashes the tap as sent, so a retry with the same `clientId` still
 matches even though the stored time differs; the outcome then has `resolvedAt`.
-Punches are always flagged `reviewRequired`; `reviewRequired: true` from the
-resolver also flags the resulting work segment (`AttendanceSegment.reviewRequired`,
+The resolver decides which flags this tap adds to the punch: `recordedOffline`
+and `reviewRequired` both default to `true`. Returning `false` leaves a fresh
+online punch unflagged, but never clears a flag from an earlier tap on the same
+punch. A device can therefore replay every tap while keeping any late tap under
+review. Use `AttendanceCorrectionService.correctPunch` to clear the review flag
+after a person reviews it; offline provenance remains set.
+`reviewRequired: true` also flags the resulting work segment (`AttendanceSegment.reviewRequired`,
 a new column). A refused outcome stores `{ error, code }`: `code` defaults to the
 `AttendanceConflict.code` (`predates_committed`, `punch_open`, `no_open_punch`,
 `break_open`, `no_open_break`, `during_break`, `work_open`, `no_open_work`,
@@ -514,8 +535,16 @@ the ledger. The ledger has no generated operations, and every ledger,
 closed-break and closed-segment write (insert, acknowledge, delete) is
 service-only: a generic `save()`, `delete()` or collection `create()` is refused. Notes:
 
-- Only **closed** punches are corrected; an open one is `AttendanceService`'s.
-  Moving a punch edge past a break or segment is refused: correct those first.
+- Moving a punch edge past a break or segment is refused: correct those first.
+- **Open punches** accept three corrections, each with a ledger row and the
+  same lock: `correctPunch({ punchId, startedAt })` changes the start only (it
+  cannot close the punch or move past its earliest break or segment);
+  `saveBreak`/`removeBreak`/`saveSegment`/`removeSegment` work on *closed*
+  intervals inside it (the open break or segment stays `AttendanceService`'s:
+  `startBreak`, `startWork`, ...); and `addPunch({ open: true, startedAt,
+  breaks?, segments?, ... })` records a missed clock-in that is still running,
+  with its closed breaks and segments, refused if the subject already has an
+  open punch. An open punch's durations are set when it closes.
 - `correctPunch` clears `reviewRequired` (a person reviewed it). A linked
   *draft* `ServiceTimeEntry` is kept in step; a submitted or approved one
   refuses the correction until it is corrected with `ServiceEvidenceService`.

package/agents/period-rollup.md

@@ -134,6 +134,19 @@ Outputs are reloaded on the root executor after commit. Rollup reads are an
 application snapshot: subsequent source approvals/corrections appear on the
 next open rollup, and confirmed cards require explicit adjustments.
 
+## Boundary attribution (#4028)
+
+By default (`attribution: 'clip'`) a source crossing a period boundary is
+prorated across every period it overlaps. Pass `{ attribution: 'start' }` for a
+pay rule where a shift counts wholly in the period it started: an attendance
+punch (its breaks and segments follow it) or a bounded evidence entry belongs,
+unclipped, to the period containing its start and is excluded from the period
+it spills into. A Sunday 22:00 to Monday 06:00 shift with a Monday 00:00
+boundary rolls up as 8 h / 0 h under `'start'` and 2 h / 6 h under `'clip'`.
+Source `endsAt` may then lie past the period end. Use one attribution per
+person: switching it for periods already confirmed does not re-roll them, and
+confirmed or submitted cards behave as before (reopen, then roll up again).
+
 ## Lifecycle: submit, confirm, reopen (#3950)
 
 `open` (draft) -> `submitted` (optional) -> `confirmed`. `submit(id)` freezes an

package/dist/attendance/correction-service.d.ts

@@ -33,6 +33,32 @@ export interface CorrectPunchInput extends AttendanceCorrectionRequest {
 export interface AddPunchInput extends AttendanceCorrectionRequest, AttendancePunchOptions {
     startedAt: Date;
     endedAt: Date;
+    open?: false;
+}
+/** A closed break to record inside an added open punch. */
+export interface AddPunchBreak {
+    startedAt: Date;
+    endedAt: Date;
+    paid?: boolean;
+    kind?: string;
+}
+/** A closed work segment to record inside an added open punch. */
+export interface AddPunchSegment {
+    startedAt: Date;
+    endedAt: Date;
+    work: AttendanceWork;
+}
+/**
+ * Adds a punch that is still open, with the closed breaks and segments that
+ * happened since it began. Refused if the subject already has an open punch.
+ * The open break or segment, if any, stays with `AttendanceService`.
+ */
+export interface AddOpenPunchInput extends AttendanceCorrectionRequest, AttendancePunchOptions {
+    open: true;
+    startedAt: Date;
+    endedAt?: undefined;
+    breaks?: readonly AddPunchBreak[];
+    segments?: readonly AddPunchSegment[];
 }
 /** Adds a break when `breakId` is absent; otherwise changes that break. */
 export interface SaveBreakInput extends AttendanceCorrectionRequest {
@@ -73,7 +99,9 @@ export interface RemoveSegmentInput extends AttendanceCorrectionRequest {
  * no segment across a break), recomputes `durationSeconds` and
  * `unpaidBreakSeconds`, keeps a still-draft linked service entry in step, and
  * appends an `AttendanceCorrection` row, all in one transaction serialized with
- * the subject's own taps. Open punches are not corrected here: use
+ * the subject's own taps. An open punch accepts three corrections only: its
+ * `startedAt`, closed breaks and segments inside it, and `addPunch({ open:
+ * true })`; closing it and the open break or segment stay with
  * `AttendanceService`.
  */
 export declare class AttendanceCorrectionService {
@@ -81,17 +109,25 @@ export declare class AttendanceCorrectionService {
     private readonly options;
     private readonly actor;
     constructor(db: DatabaseInterface, actor: AttendanceActor, options?: AttendanceCorrectionOptions);
-    /** Change a closed punch's start and/or end. A reviewed punch no longer needs review. */
+    /**
+     * Change a closed punch's start and/or end. A reviewed punch no longer needs
+     * review. An open punch may change `startedAt` only: it cannot be closed
+     * here, and its start cannot move past its earliest break or segment.
+     */
     correctPunch(input: CorrectPunchInput): Promise<AttendanceCorrection>;
-    /** Record a missed punch retroactively, as an already-closed interval. */
-    addPunch(input: AddPunchInput): Promise<AttendanceCorrection>;
-    /** Add a break to a closed punch, or change one (times and/or paid). */
+    /**
+     * Record a missed punch retroactively: a closed interval, or with
+     * `{ open: true }` one that is still running, carrying its closed breaks and
+     * segments.
+     */
+    addPunch(input: AddPunchInput | AddOpenPunchInput): Promise<AttendanceCorrection>;
+    /** Add a closed break to a punch, or change one (times and/or paid). */
     saveBreak(input: SaveBreakInput): Promise<AttendanceCorrection>;
-    /** Remove a break from a closed punch. */
+    /** Remove a closed break from a punch. */
     removeBreak(input: RemoveBreakInput): Promise<AttendanceCorrection>;
-    /** Add a work segment to a closed punch, or change one (times and/or work attribution). */
+    /** Add a closed work segment to a punch, or change one (times and/or work attribution). */
     saveSegment(input: SaveSegmentInput): Promise<AttendanceCorrection>;
-    /** Remove a work segment from a closed punch. */
+    /** Remove a closed work segment from a punch. */
     removeSegment(input: RemoveSegmentInput): Promise<AttendanceCorrection>;
     /**
      * The subject confirms they have seen a correction that required it. Only
@@ -102,10 +138,15 @@ export declare class AttendanceCorrectionService {
     listForPunch(punchId: string): Promise<AttendanceCorrection[]>;
     /** Corrections of the actor's own time that still await their acknowledgement. */
     pendingAcknowledgements(): Promise<AttendanceCorrection[]>;
+    /** The range a correction touches, for period-lock checks: an open punch runs to now. */
+    private span;
+    private openPunchOf;
+    private correctOpenStart;
+    private addOpenPunch;
     private attendance;
     private read;
     private run;
-    private closedPunch;
+    private anyPunch;
     private children;
     private layout;
     private attribute;

package/dist/attendance/correction-service.d.ts.map

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

package/dist/attendance/models.d.ts

@@ -49,6 +49,12 @@ export type AttendanceSegmentCloseReason = (typeof SEGMENT_CLOSE_REASONS)[number
 export declare class AttendanceSegment extends SmrtObject {
     tenantId: string;
     punchId: string;
+    /**
+     * The person whose time this is: its punch's `profileId`, set by the
+     * attendance and correction services on creation and immutable. Rows
+     * written before the column existed may read `null` (see the README backfill).
+     */
+    profileId: string;
     /** Qualified class name of the work context (for example a work order). */
     workRefType: string;
     workRefId: string;

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

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

package/dist/attendance/segments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/attendance/segments.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAEpB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AASrB,4CAA4C;AAC5C,wBAAsB,WAAW,CAC/B,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAMnC;AAED,6CAA6C;AAC7C,wBAAsB,YAAY,CAChC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAK9B;AAED,sFAAsF;AACtF,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,IAAI,EACR,MAAM,EAAE,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,GAChD,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CASnC;AAED,wEAAwE;AACxE,wBAAsB,YAAY,CAChC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,IAAI,EACR,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA4B5B;AAED,+EAA+E;AAC/E,wBAAsB,cAAc,CAClC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,IAAI,EACR,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAQ5B;AAED,kEAAkE;AAClE,wBAAsB,UAAU,CAC9B,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,IAAI,GACP,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,IAAI,GACP,OAAO,CAAC,iBAAiB,CAAC,CAoB5B"}
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/attendance/segments.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAEpB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AASrB,4CAA4C;AAC5C,wBAAsB,WAAW,CAC/B,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAMnC;AAED,6CAA6C;AAC7C,wBAAsB,YAAY,CAChC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAK9B;AAED,sFAAsF;AACtF,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,IAAI,EACR,MAAM,EAAE,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,GAChD,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CASnC;AAED,wEAAwE;AACxE,wBAAsB,YAAY,CAChC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,IAAI,EACR,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA6B5B;AAED,+EAA+E;AAC/E,wBAAsB,cAAc,CAClC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,IAAI,EACR,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAQ5B;AAED,kEAAkE;AAClE,wBAAsB,UAAU,CAC9B,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,IAAI,GACP,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,IAAI,GACP,OAAO,CAAC,iBAAiB,CAAC,CAoB5B"}

package/dist/attendance/service.d.ts

@@ -37,8 +37,14 @@ export interface AttendanceTimeInput {
 /** The effective time a policy chose, and whether a person should look at it. */
 export interface AttendanceResolvedTime {
     at: Date;
-    /** Flags the resulting work segment (punches are always flagged offline). */
+    /**
+     * Whether a person should review the result. Applies to the punch (default
+     * true when omitted) and, when true, the resulting work segment. False does
+     * not clear a punch's existing review requirement; use a reviewed correction.
+     */
     reviewRequired?: boolean;
+    /** Marks the punch offline (default true); false never clears an earlier flag. */
+    recordedOffline?: boolean;
 }
 /** Why a consumer refuses or rewrites the stored reason of a refused tap. */
 export interface AttendanceRefusal {

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

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/attendance/service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EAKpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,eAAe,EAGf,KAAK,uBAAuB,EAC5B,iBAAiB,EAElB,MAAM,aAAa,CAAC;AAsBrB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,cAAc,eAAe,CAAC;AAE9B,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mFAAmF;IACnF,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qFAAqF;AACrF,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,UAAU,GACV,YAAY,GACZ,UAAU,GACV,WAAW,GACX,YAAY,GACZ,UAAU,GACV,YAAY,CAAC;AAajB,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,GAAG,EAAE,aAAa,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,EAAE,IAAI,CAAC;IACf,0CAA0C;IAC1C,SAAS,EAAE,IAAI,CAAC;IAChB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,IAAI,CAAC;IACT,6EAA6E;IAC7E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iFAAiF;AACjF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,IAAI,CAAC;IACf,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GACnC,MAAM,GACN,CAAC,CACC,KAAK,EAAE,eAAe,KAEpB,IAAI,GACJ,2BAA2B,GAC3B,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,IAAI,GAAG,2BAA2B,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC;AAExE,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CACV,KAAK,EAAE,mBAAmB,KACvB,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC9D,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,CACR,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,kBAAkB,KACtB,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;CAC3C;AAID;;;;;GAKG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,eAAe;IAUzC,OAAO,CAAC,QAAQ;IAIhB;;;;;OAKG;IACG,eAAe,CAAC,CAAC,EACrB,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GACpD,OAAO,CAAC,CAAC,CAAC;YAIC,QAAQ;IAuDtB,OAAO,CAAC,IAAI;YAQE,IAAI;YASJ,aAAa;IAuC3B,mFAAmF;IAC7E,OAAO,CACX,EAAE,OAAa,EACf,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,eAAe,CAAC;IAS3B,qFAAqF;IAC/E,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAKzE,0FAA0F;IACpF,UAAU,CACd,EAAE,EAAE,IAAI,EACR,IAAI,UAAQ,EACZ,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,eAAe,CAAC;IAS3B;;;OAGG;IACG,QAAQ,CACZ,EAAE,EAAE,IAAI,EACR,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,OAAO,CAAC,eAAe,CAAC;IAa3B,0FAA0F;IACpF,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAO3E,uEAAuE;IACjE,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAO5E,uDAAuD;IACjD,QAAQ,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMpD,iGAAiG;IAC3F,UAAU,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMtD,gEAAgE;IAC1D,WAAW,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAStD,iEAAiE;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAW/C,UAAU;IAoGxB,uFAAuF;YACzE,KAAK;IAsDnB,OAAO,CAAC,YAAY;YAIN,IAAI;IAoDlB,yEAAyE;IACnE,oBAAoB,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,eAAe,CAAC;IAY3B;;;;;;;;OAQG;IACG,SAAS,CACb,GAAG,EAAE,IAAI,EACT,QAAQ,EAAE,2BAA2B,GACpC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA+ClC;;;;;OAKG;IACG,MAAM,CACV,IAAI,EAAE,SAAS,aAAa,EAAE,EAC9B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,uBAAuB,EAAE,CAAC;CA4JtC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/attendance/service.ts"],"names":[],"mappings":"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"}

package/dist/attendance.js

@@ -1,3 +1,3 @@
-import { a as AttendanceReplay, c as AttendanceSegmentCollection, i as AttendancePunchCollection, n as AttendanceBreakCollection, o as AttendanceReplayCollection, r as AttendancePunch, s as AttendanceSegment, t as AttendanceBreak } from "./chunks/models-C1krjn40.js";
-import { a as continueSegment, c as openSegment, d as validateAttendanceWork, f as ATTENDANCE_CORRECTION_KINDS, i as closeOpenSegment, l as replaceSegment, m as AttendanceCorrectionCollection, n as AttendanceService, o as endSegment, p as AttendanceCorrection, r as beginSegment, s as listSegments, t as AttendanceCorrectionService, u as AttendanceConflict } from "./chunks/attendance-CDfhph1R.js";
+import { a as AttendanceReplay, c as AttendanceSegmentCollection, i as AttendancePunchCollection, n as AttendanceBreakCollection, o as AttendanceReplayCollection, r as AttendancePunch, s as AttendanceSegment, t as AttendanceBreak } from "./chunks/models-BJcnFMOL.js";
+import { a as continueSegment, c as openSegment, d as validateAttendanceWork, f as ATTENDANCE_CORRECTION_KINDS, i as closeOpenSegment, l as replaceSegment, m as AttendanceCorrectionCollection, n as AttendanceService, o as endSegment, p as AttendanceCorrection, r as beginSegment, s as listSegments, t as AttendanceCorrectionService, u as AttendanceConflict } from "./chunks/attendance-UY7sTXFx.js";
 export { ATTENDANCE_CORRECTION_KINDS, AttendanceBreak, AttendanceBreakCollection, AttendanceConflict, AttendanceCorrection, AttendanceCorrectionCollection, AttendanceCorrectionService, AttendancePunch, AttendancePunchCollection, AttendanceReplay, AttendanceReplayCollection, AttendanceSegment, AttendanceSegmentCollection, AttendanceService, beginSegment, closeOpenSegment, continueSegment, endSegment, listSegments, openSegment, replaceSegment, validateAttendanceWork };

package/dist/chunks/{attendance-mk6nqJhX.js → attendance-DAitZkht.js}

@@ -1,7 +1,7 @@
-import { i as AttendancePunchCollection, n as AttendanceBreakCollection } from "./models-C1krjn40.js";
-import { i as integer, n as clipSource, r as instant } from "./rollup-C8p1PAXX.js";
+import { i as AttendancePunchCollection, n as AttendanceBreakCollection } from "./models-BJcnFMOL.js";
+import { i as integer, n as attributeSource, r as instant } from "./rollup-B-qdcGDs.js";
 //#region src/rollup/attendance.ts
-async function attendanceSources(db, actor, period) {
+async function attendanceSources(db, actor, period, attribution = "clip") {
 	const punches = await AttendancePunchCollection.create({ db });
 	const breaks = await AttendanceBreakCollection.create({ db });
 	const sources = [];
@@ -39,13 +39,13 @@ async function attendanceSources(db, actor, period) {
 		for (const [left, right] of spans) {
 			const seconds = Math.round((paidMs + right - left) / 1e3) - Math.round(paidMs / 1e3);
 			paidMs += right - left;
-			const source = clipSource({
+			const source = attributeSource({
 				kind: "attendance",
 				id: String(punch.id),
 				startsAt: new Date(left).toISOString(),
 				endsAt: new Date(right).toISOString(),
 				seconds
-			}, period);
+			}, period, attribution, start);
 			if (source?.seconds) sources.push(source);
 		}
 	}
@@ -57,4 +57,4 @@ async function attendanceSources(db, actor, period) {
 //#endregion
 export { attendanceSources };
 
-//# sourceMappingURL=attendance-mk6nqJhX.js.map
+//# sourceMappingURL=attendance-DAitZkht.js.map

package/dist/chunks/attendance-DAitZkht.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attendance-DAitZkht.js","names":[],"sources":["../../src/rollup/attendance.ts"],"sourcesContent":["import type { DatabaseInterface } from '@happyvertical/sql';\nimport {\n  AttendanceBreakCollection,\n  AttendancePunchCollection,\n} from '../attendance/models.js';\nimport { attributeSource, instant, integer } from './calculation.js';\nimport type {\n  RollupAttribution,\n  TimecardActor,\n  TimecardPeriod,\n  TimecardSource,\n} from './types.js';\n\n/** Optional attendance reader. Called on the rollup's transaction executor. */\nexport async function attendanceSources(\n  db: DatabaseInterface,\n  actor: TimecardActor,\n  period: TimecardPeriod,\n  attribution: RollupAttribution = 'clip',\n): Promise<{ sources: TimecardSource[]; linkedEntryIds: Set<string> }> {\n  const punches = await AttendancePunchCollection.create({ db });\n  const breaks = await AttendanceBreakCollection.create({ db });\n  const sources: TimecardSource[] = [];\n  const linkedEntryIds = new Set<string>();\n  for (const punch of await punches.list({ where: { ...actor } })) {\n    // A linked punch is authoritative even when pending review: never count its\n    // evidence entry behind the review gate, or outside the punch's period.\n    if (punch.serviceTimeEntryId) linkedEntryIds.add(punch.serviceTimeEntryId);\n    if (!punch.endedAt || punch.reviewRequired) continue;\n    const start = instant(punch.startedAt);\n    const end = instant(punch.endedAt);\n    if (end < start) throw new Error('Invalid attendance interval.');\n    let cursor = start;\n    let unpaidMs = 0;\n    const spans: [number, number][] = [];\n    for (const pause of await breaks.list({\n      where: { tenantId: actor.tenantId, punchId: punch.id },\n      orderBy: 'started_at ASC',\n    })) {\n      if (!pause.endedAt)\n        throw new Error('Closed attendance has an open break.');\n      const left = instant(pause.startedAt);\n      const right = instant(pause.endedAt);\n      if (left < cursor || right < left || right > end)\n        throw new Error('Invalid or overlapping attendance breaks.');\n      if (!pause.paid) {\n        spans.push([cursor, left]);\n        unpaidMs += right - left;\n      } else {\n        spans.push([cursor, right]);\n      }\n      cursor = right;\n    }\n    spans.push([cursor, end]);\n    const net = Math.round((end - start - unpaidMs) / 1000);\n    if (integer(punch.durationSeconds) !== net)\n      throw new Error('Attendance duration does not match its breaks.');\n    // Round elapsed paid prefixes once, preserving conservation across breaks.\n    let paidMs = 0;\n    for (const [left, right] of spans) {\n      const seconds =\n        Math.round((paidMs + right - left) / 1000) - Math.round(paidMs / 1000);\n      paidMs += right - left;\n      const source = attributeSource(\n        {\n          kind: 'attendance',\n          id: String(punch.id),\n          startsAt: new Date(left).toISOString(),\n          endsAt: new Date(right).toISOString(),\n          seconds,\n        },\n        period,\n        attribution,\n        start,\n      );\n      if (source?.seconds) sources.push(source);\n    }\n  }\n  return { sources, linkedEntryIds };\n}\n"],"mappings":";;;AAcA,eAAsB,kBACpB,IACA,OACA,QACA,cAAiC,QACoC;CACrE,MAAM,UAAU,MAAM,0BAA0B,OAAO,EAAE,GAAG,CAAC;CAC7D,MAAM,SAAS,MAAM,0BAA0B,OAAO,EAAE,GAAG,CAAC;CAC5D,MAAM,UAA4B,CAAC;CACnC,MAAM,iCAAiB,IAAI,IAAY;CACvC,KAAA,MAAW,SAAS,MAAM,QAAQ,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG;EAG/D,IAAI,MAAM,oBAAoB,eAAe,IAAI,MAAM,kBAAkB;EACzE,IAAI,CAAC,MAAM,WAAW,MAAM,gBAAgB;EAC5C,MAAM,QAAQ,QAAQ,MAAM,SAAS;EACrC,MAAM,MAAM,QAAQ,MAAM,OAAO;EACjC,IAAI,MAAM,OAAO,MAAM,IAAI,MAAM,8BAA8B;EAC/D,IAAI,SAAS;EACb,IAAI,WAAW;EACf,MAAM,QAA4B,CAAC;EACnC,KAAA,MAAW,SAAS,MAAM,OAAO,KAAK;GACpC,OAAO;IAAE,UAAU,MAAM;IAAU,SAAS,MAAM;GAAG;GACrD,SAAS;EACX,CAAC,GAAG;GACF,IAAI,CAAC,MAAM,SACT,MAAM,IAAI,MAAM,sCAAsC;GACxD,MAAM,OAAO,QAAQ,MAAM,SAAS;GACpC,MAAM,QAAQ,QAAQ,MAAM,OAAO;GACnC,IAAI,OAAO,UAAU,QAAQ,QAAQ,QAAQ,KAC3C,MAAM,IAAI,MAAM,2CAA2C;GAC7D,IAAI,CAAC,MAAM,MAAM;IACf,MAAM,KAAK,CAAC,QAAQ,IAAI,CAAC;IACzB,YAAY,QAAQ;GACtB,OACE,MAAM,KAAK,CAAC,QAAQ,KAAK,CAAC;GAE5B,SAAS;EACX;EACA,MAAM,KAAK,CAAC,QAAQ,GAAG,CAAC;EACxB,MAAM,MAAM,KAAK,OAAO,MAAM,QAAQ,YAAY,GAAI;EACtD,IAAI,QAAQ,MAAM,eAAe,MAAM,KACrC,MAAM,IAAI,MAAM,gDAAgD;EAElE,IAAI,SAAS;EACb,KAAA,MAAW,CAAC,MAAM,UAAU,OAAO;GACjC,MAAM,UACJ,KAAK,OAAO,SAAS,QAAQ,QAAQ,GAAI,IAAI,KAAK,MAAM,SAAS,GAAI;GACvE,UAAU,QAAQ;GAClB,MAAM,SAAS,gBACb;IACE,MAAM;IACN,IAAI,OAAO,MAAM,EAAE;IACnB,UAAU,IAAI,KAAK,IAAI,CAAA,CAAE,YAAY;IACrC,QAAQ,IAAI,KAAK,KAAK,CAAA,CAAE,YAAY;IACpC;GACF,GACA,QACA,aACA,KACF;GACA,IAAI,QAAQ,SAAS,QAAQ,KAAK,MAAM;EAC1C;CACF;CACA,OAAO;EAAE;EAAS;CAAe;AACnC"}