@happyvertical/smrt-timesheets 0.55.23 → 0.56.0

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

@@ -0,0 +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"}

package/dist/attendance/service.d.ts

@@ -1,27 +1,77 @@
 import type { DatabaseInterface } from '@happyvertical/sql';
-import { AttendancePunch, type AttendanceReplayOutcome } from './models.js';
+import { type AttendanceActor, type AttendanceBreakOptions, AttendanceConflict, type AttendanceContext, type AttendanceDeviceRef, type AttendancePunchOptions, type AttendanceRefusalCode, type AttendanceWork } from './context.js';
+import { AttendancePunch, type AttendanceReplayOutcome, AttendanceSegment } from './models.js';
+export { type AttendanceActor, type AttendanceBreakOptions, AttendanceConflict, type AttendanceContext, type AttendanceDeviceRef, type AttendancePunchOptions, type AttendanceRefusalCode, type AttendanceWork, validateAttendanceWork, } from './context.js';
 export type { AttendanceReplayOutcome } from './models.js';
-/** Resolve these identifiers from the authenticated session, never from tap input. */
-export interface AttendanceActor {
-    tenantId: string;
-    profileId: string;
-}
-/** Explicit work attribution for a closed punch's draft evidence entry. */
-export interface AttendanceWork {
-    workRefType: string;
-    workRefId: string;
-    description: string;
-}
+export * from './segments.js';
 /** Offline command with a durable client-generated identifier and device timestamp. */
 export interface AttendanceTap {
     clientId: string;
     at: string;
-    action: 'punchIn' | 'punchOut' | 'startBreak' | 'endBreak';
+    action: AttendanceTapAction;
     paid?: boolean;
+    /** Required by `startWork` and `switchWork`; also links evidence on `punchOut`. */
     work?: AttendanceWork;
+    /** Recorded on the punch by `punchIn`; hashed with the tap. */
+    source?: string;
+    /** Recorded on the punch by `punchIn`; hashed with the tap. */
+    device?: AttendanceDeviceRef;
+    /** Recorded on the break by `startBreak`; hashed with the tap. */
+    kind?: string;
+}
+/** Punch and break actions plus the work-segment actions (`stopWork` is "pause"). */
+export type AttendanceTapAction = 'punchIn' | 'punchOut' | 'startBreak' | 'endBreak' | 'startWork' | 'switchWork' | 'stopWork' | 'resumeWork';
+/** What a time policy sees for one tap that has not been replayed yet. */
+export interface AttendanceTimeInput {
+    /** The tap exactly as sent. */
+    tap: AttendanceTap;
+    /** The tap's device time. */
+    deviceAt: Date;
+    /** When the server received the batch. */
+    serverNow: Date;
+    /** `serverNow - deviceAt` in milliseconds: how long the tap waited. */
+    waitedMs: number;
+    /** The trusted actor the tap replays for. */
+    actor: AttendanceActor;
+}
+/** 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). */
+    reviewRequired?: boolean;
+}
+/** Why a consumer refuses or rewrites the stored reason of a refused tap. */
+export interface AttendanceRefusal {
+    code: AttendanceRefusalCode;
+    /** Replaces the default message when given. */
+    message?: string;
 }
-/** Expected state conflict, distinct from retryable database failures. */
-export declare class AttendanceConflict extends Error {
+/** A resolved auto-close deadline and, optionally, why the punch closed then. */
+export interface AttendanceAutoCloseDecision {
+    deadline: Date;
+    /** Recorded as `autoCloseReason` (1 to 200 characters); defaults to `deadline`. */
+    reason?: string;
+}
+/**
+ * Fixed maximum open seconds, or a per-punch resolver returning the deadline
+ * (a Date or a decision) or null to leave the punch open.
+ */
+export type AttendanceAutoCloseDeadline = number | ((punch: AttendancePunch) => Date | AttendanceAutoCloseDecision | null | undefined | Promise<Date | AttendanceAutoCloseDecision | null | undefined>);
+export interface AttendanceReplayOptions {
+    /**
+     * Choose each tap's effective time (for example the device time inside a
+     * window, else the server arrival time). The receipt still hashes the tap as
+     * sent, so retries with the same clientId match; the resolved time is what is
+     * stored. Called once per tap that has no receipt yet, inside its transaction.
+     */
+    resolveAt?: (input: AttendanceTimeInput) => AttendanceResolvedTime | Promise<AttendanceResolvedTime>;
+    /** Clock for `serverNow`; defaults to `new Date()` per tap. */
+    now?: () => Date;
+    /**
+     * Name the stored code (and optionally message) of a refused tap. Without it,
+     * the refusal's own `AttendanceConflict.code` is stored.
+     */
+    refusal?: (tap: AttendanceTap, error: AttendanceConflict) => AttendanceRefusal | undefined | void;
 }
 /**
  * Attendance mutations bound to a trusted tenant/profile. Applications authorize
@@ -34,31 +84,65 @@ export declare class AttendanceService {
     private readonly actor;
     constructor(db: DatabaseInterface, actor: AttendanceActor);
     private identity;
+    /**
+     * Run `operation` in the actor's serialized attendance transaction. The
+     * context's collections share the executor, so corrections and replay can
+     * compose several attendance mutations (with the segment helpers) atomically.
+     * Results that are punches or segments are re-read after commit.
+     */
+    withTransaction<T>(operation: (context: AttendanceContext) => Promise<T>): Promise<T>;
     private transact;
     private date;
     private open;
     private chronological;
     /** Open one punch; the database unique slot also protects direct model writers. */
-    punchIn(at?: Date): Promise<AttendancePunch>;
+    punchIn(at?: Date, options?: AttendancePunchOptions): Promise<AttendancePunch>;
     /** Close the punch and any active break; optionally create linked draft evidence. */
     punchOut(at: Date, work?: AttendanceWork): Promise<AttendancePunch>;
     /** Begin a break; paid defaults false and must be explicitly configured by the caller. */
-    startBreak(at: Date, paid?: boolean): Promise<AttendancePunch>;
-    /** End the current break. */
-    endBreak(at: Date): Promise<AttendancePunch>;
+    startBreak(at: Date, paid?: boolean, options?: AttendanceBreakOptions): Promise<AttendancePunch>;
+    /**
+     * End the current break. With `{ resumeWork: true }` the work interrupted by
+     * `startBreak` resumes at the same instant, atomically with the break end.
+     */
+    endBreak(at: Date, options?: {
+        resumeWork?: boolean;
+    }): Promise<AttendancePunch>;
+    /** Open a work segment in the open punch; refuses during a break or while one is open. */
+    startWork(at: Date, work: AttendanceWork): Promise<AttendanceSegment>;
+    /** Atomically close the open segment and open the next one at `at`. */
+    switchWork(at: Date, work: AttendanceWork): Promise<AttendanceSegment>;
+    /** Close the open segment without starting another. */
+    stopWork(at: Date): Promise<AttendanceSegment>;
+    /** Reopen the work a break interrupted (the latest segment must have closed on `startBreak`). */
+    resumeWork(at: Date): Promise<AttendanceSegment>;
+    /** The open work segment of the actor's open punch, or null. */
+    currentWork(): Promise<AttendanceSegment | null>;
+    /** Work segments of one of the actor's punches, oldest first. */
+    segments(punchId: string): Promise<AttendanceSegment[]>;
     private transition;
+    /** Run one replayed tap on `tx`; work actions share the punch changes' transaction. */
+    private apply;
     private validateWork;
     private link;
     /** Idempotently link a closed, owned punch to draft service evidence. */
     linkServiceTimeEntry(punchId: string, work: AttendanceWork): Promise<AttendancePunch>;
-    /** Close at startedAt + maxOpenSeconds once due, flagging the punch for review. */
-    autoClose(now: Date, maxOpenSeconds: number): Promise<AttendancePunch | null>;
+    /**
+     * Close the open punch once its deadline has passed, flagging it for review.
+     * `deadline` is either a fixed maximum open duration in seconds (closing at
+     * `startedAt + seconds`, reason `maxDuration`) or a resolver called with the
+     * open punch that returns its deadline (a `Date`, or `{ deadline, reason }`),
+     * or null to leave it open. The consumer owns time zones and shop-day rules.
+     * The open work segment and break close at the deadline; returns the closed
+     * punch, or null when nothing was due.
+     */
+    autoClose(now: Date, deadline: AttendanceAutoCloseDeadline): Promise<AttendancePunch | null>;
     /**
      * Replay device timestamps in order (ties use clientId). Committed attendance
      * wins: stale/state-conflicting taps get durable refusals; identical retries
      * return the same outcome, changed payloads using a key are rejected. A
      * database failure rolls back its tap and receipt and remains retryable.
      */
-    replay(taps: readonly AttendanceTap[]): Promise<AttendanceReplayOutcome[]>;
+    replay(taps: readonly AttendanceTap[], options?: AttendanceReplayOptions): Promise<AttendanceReplayOutcome[]>;
 }
 //# sourceMappingURL=service.d.ts.map

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;AAE5D,OAAO,EAEL,eAAe,EAGf,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AACD,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,0EAA0E;AAC1E,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAShD;;;;;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;YAQF,QAAQ;IA0CtB,OAAO,CAAC,IAAI;YAQE,IAAI;YASJ,aAAa;IA+B3B,mFAAmF;IAC7E,OAAO,CAAC,EAAE,OAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAGxD,qFAAqF;IAC/E,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAKzE,0FAA0F;IACpF,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,UAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;IAKlE,6BAA6B;IACvB,QAAQ,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;YAMpC,UAAU;IAqFxB,OAAO,CAAC,YAAY;YAcN,IAAI;IA6ClB,yEAAyE;IACnE,oBAAoB,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,eAAe,CAAC;IAY3B,mFAAmF;IAC7E,SAAS,CACb,GAAG,EAAE,IAAI,EACT,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAwBlC;;;;;OAKG;IACG,MAAM,CACV,IAAI,EAAE,SAAS,aAAa,EAAE,GAC7B,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAkGtC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/attendance/service.ts"],"names":[],"mappings":"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"}

package/dist/attendance/write.d.ts

@@ -0,0 +1,12 @@
+import type { SmrtObject } from '@happyvertical/smrt-core';
+/** True while `object` is being saved by `AttendanceCorrectionService`. */
+export declare function isCorrectionWrite(object: SmrtObject): boolean;
+/** Save `object` with closed-interval immutability lifted for this one write. */
+export declare function persistCorrection<T extends SmrtObject>(object: T): Promise<T>;
+/** Delete a closed break or segment through the correction capability. */
+export declare function deleteCorrection<T extends SmrtObject>(object: T): Promise<void>;
+/** True while `AttendanceService.autoClose` is saving `object`. */
+export declare function isAutoCloseWrite(object: SmrtObject): boolean;
+/** Save `object` with its auto-close reason writable for this one write. */
+export declare function persistAutoClose<T extends SmrtObject>(object: T): Promise<T>;
+//# sourceMappingURL=write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/attendance/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAO3D,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE7D;AAED,iFAAiF;AACjF,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,UAAU,EAC1D,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED,0EAA0E;AAC1E,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EACzD,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,IAAI,CAAC,CAOf;AAMD,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE5D;AAED,4EAA4E;AAC5E,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EACzD,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/dist/attendance.d.ts

@@ -1,5 +1,7 @@
 /** Tenant-scoped punches, breaks, automatic close and offline replay. */
 import './__smrt-register__.js';
+export * from './attendance/correction-models.js';
+export * from './attendance/correction-service.js';
 export * from './attendance/models.js';
 export * from './attendance/service.js';
 //# sourceMappingURL=attendance.d.ts.map

package/dist/attendance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attendance.d.ts","sourceRoot":"","sources":["../src/attendance.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,wBAAwB,CAAC;AAEhC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"attendance.d.ts","sourceRoot":"","sources":["../src/attendance.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,wBAAwB,CAAC;AAEhC,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC"}

package/dist/attendance.js

@@ -1,323 +1,3 @@
-import { i as ServiceTimeEntryCollection } from "./chunks/service-time-entry-CBv-FF-W.js";
-import { a as AttendanceReplay, i as AttendancePunchCollection, n as AttendanceBreakCollection, o as AttendanceReplayCollection, r as AttendancePunch, t as AttendanceBreak } from "./chunks/models-zU8Um7c2.js";
-import { isEmbeddedDatabase, isPostgresDatabase, withEmbeddedWriteTransaction } from "@happyvertical/smrt-core";
-import { getTenantId, withTenant } from "@happyvertical/smrt-tenancy";
-//#region src/attendance/service.ts
-var AttendanceConflict = class extends Error {};
-var AttendanceService = class {
-	constructor(db, actor) {
-		this.db = db;
-		this.actor = actor;
-		if (!actor.tenantId || !actor.profileId) throw new Error("Attendance requires a trusted tenant/profile actor.");
-		this.actor = {
-			tenantId: this.identity(actor.tenantId),
-			profileId: this.identity(actor.profileId)
-		};
-	}
-	db;
-	actor;
-	identity(value) {
-		if (!isPostgresDatabase(this.db)) return value;
-		const hex = value.replace(/[{}-]/g, "").toLowerCase();
-		if (!/^[0-9a-f]{32}$/.test(hex)) throw new Error("PostgreSQL attendance identities must be UUIDs.");
-		return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-	}
-	async transact(operation) {
-		const current = getTenantId();
-		if (current && this.identity(current) !== this.actor.tenantId) throw new Error("Attendance actor differs from active tenant.");
-		return withTenant({ tenantId: this.actor.tenantId }, async () => {
-			const result = await withEmbeddedWriteTransaction(this.db, isEmbeddedDatabase(this.db), async (db) => {
-				if (isPostgresDatabase(db)) await db.query("SELECT pg_advisory_xact_lock(hashtextextended($1, 0))", JSON.stringify([
-					"smrt.attendance",
-					this.actor.tenantId,
-					this.actor.profileId
-				]));
-				return operation({
-					db,
-					punches: await AttendancePunchCollection.create({ db }),
-					breaks: await AttendanceBreakCollection.create({ db }),
-					replays: await AttendanceReplayCollection.create({ db })
-				});
-			}, true);
-			if (result instanceof AttendancePunch) {
-				const [fresh] = await (await AttendancePunchCollection.create({ db: this.db })).list({
-					where: {
-						...this.actor,
-						id: result.id
-					},
-					limit: 1
-				});
-				if (!fresh) throw new Error("Committed attendance punch disappeared.");
-				return fresh;
-			}
-			return result;
-		});
-	}
-	date(at) {
-		if (!(at instanceof Date) || !Number.isFinite(at.getTime())) throw new AttendanceConflict("Attendance timestamps must be valid dates.");
-		return at;
-	}
-	async open(tx) {
-		const [punch] = await tx.punches.list({
-			where: {
-				...this.actor,
-				endedAt: null
-			},
-			limit: 1
-		});
-		if (!punch) throw new AttendanceConflict("No open punch.");
-		return punch;
-	}
-	async chronological(tx, at) {
-		const open = await tx.punches.list({
-			where: {
-				...this.actor,
-				endedAt: null
-			},
-			limit: 1
-		});
-		const rows = open.length ? open : await tx.punches.list({
-			where: { ...this.actor },
-			orderBy: "ended_at DESC",
-			limit: 1
-		});
-		if (!rows.length) return;
-		const punch = rows[0];
-		const breaks = await tx.breaks.list({ where: {
-			tenantId: this.actor.tenantId,
-			punchId: punch.id
-		} });
-		const latest = Math.max(punch.startedAt.getTime(), punch.endedAt?.getTime() ?? 0, ...breaks.flatMap((b) => [b.startedAt.getTime(), b.endedAt?.getTime() ?? 0]));
-		if (at.getTime() < latest) throw new AttendanceConflict("Tap predates committed attendance; manual review required.");
-	}
-	/** Open one punch; the database unique slot also protects direct model writers. */
-	async punchIn(at = /* @__PURE__ */ new Date()) {
-		return this.transact((tx) => this.transition(tx, "punchIn", this.date(at)));
-	}
-	/** Close the punch and any active break; optionally create linked draft evidence. */
-	async punchOut(at, work) {
-		return this.transact((tx) => this.transition(tx, "punchOut", this.date(at), false, work));
-	}
-	/** Begin a break; paid defaults false and must be explicitly configured by the caller. */
-	async startBreak(at, paid = false) {
-		return this.transact((tx) => this.transition(tx, "startBreak", this.date(at), paid));
-	}
-	/** End the current break. */
-	async endBreak(at) {
-		return this.transact((tx) => this.transition(tx, "endBreak", this.date(at)));
-	}
-	async transition(tx, action, at, paid = false, work) {
-		await this.chronological(tx, at);
-		if (action === "punchIn") {
-			if ((await tx.punches.list({
-				where: {
-					...this.actor,
-					endedAt: null
-				},
-				limit: 1
-			})).length) throw new AttendanceConflict("A punch is already open.");
-			return tx.punches.create({
-				...this.actor,
-				startedAt: at,
-				_insertOnly: true
-			});
-		}
-		const punch = await this.open(tx);
-		const breaks = await tx.breaks.list({ where: {
-			tenantId: this.actor.tenantId,
-			punchId: punch.id
-		} });
-		const active = breaks.find((b) => !b.endedAt);
-		if (action === "startBreak") {
-			if (active) throw new AttendanceConflict("A break is already open.");
-			if (typeof paid !== "boolean") throw new AttendanceConflict("paid must be boolean.");
-			await tx.breaks.create({
-				tenantId: this.actor.tenantId,
-				punchId: punch.id ?? void 0,
-				startedAt: at,
-				paid,
-				_insertOnly: true
-			});
-			return punch;
-		}
-		if (action !== "endBreak" && action !== "punchOut") throw new AttendanceConflict("Unknown attendance action.");
-		if (action === "endBreak" && !active) throw new AttendanceConflict("No open break.");
-		if (action === "punchOut" && work) {
-			this.validateWork(work);
-			const unpaidMilliseconds2 = breaks.filter((b) => !b.paid).reduce((sum, b) => sum + (b.endedAt ?? at).getTime() - b.startedAt.getTime(), 0);
-			if (Math.round((at.getTime() - punch.startedAt.getTime() - unpaidMilliseconds2) / 1e3) <= 0) throw new AttendanceConflict("Only closed punches with positive duration can produce service evidence.");
-		}
-		if (active) {
-			active.endedAt = at;
-			await active.save();
-		}
-		if (action === "endBreak") return punch;
-		punch.endedAt = at;
-		const unpaidMilliseconds = breaks.filter((b) => !b.paid).reduce((sum, b) => sum + b.endedAt.getTime() - b.startedAt.getTime(), 0);
-		punch.unpaidBreakSeconds = Math.round(unpaidMilliseconds / 1e3);
-		punch.durationSeconds = Math.round((at.getTime() - punch.startedAt.getTime() - unpaidMilliseconds) / 1e3);
-		await punch.save();
-		if (work) await this.link(tx, punch, work);
-		return punch;
-	}
-	validateWork(work) {
-		if (!work || typeof work.workRefType !== "string" || !work.workRefType || typeof work.workRefId !== "string" || !work.workRefId || typeof work.description !== "string") throw new AttendanceConflict("A complete work reference and description are required.");
-	}
-	async link(tx, punch, work) {
-		this.validateWork(work);
-		if (!punch.endedAt || punch.durationSeconds <= 0) throw new AttendanceConflict("Only closed punches with positive duration can produce service evidence.");
-		const entries = await ServiceTimeEntryCollection.create({ db: tx.db });
-		if (punch.serviceTimeEntryId) {
-			const [existing] = await entries.list({
-				where: {
-					id: punch.serviceTimeEntryId,
-					tenantId: this.actor.tenantId
-				},
-				limit: 1
-			});
-			if (!existing || existing.workRefType !== work.workRefType || existing.workRefId !== work.workRefId || existing.description !== work.description) throw new AttendanceConflict("Punch already linked to different work.");
-			return;
-		}
-		const entry = await entries.create({
-			tenantId: this.actor.tenantId,
-			participantKind: "human",
-			participantProfileId: this.actor.profileId,
-			workRefType: work.workRefType,
-			workRefId: work.workRefId,
-			description: work.description,
-			source: "timer",
-			startedAt: punch.startedAt,
-			endedAt: punch.endedAt,
-			durationSeconds: punch.durationSeconds,
-			status: "draft",
-			metadata: JSON.stringify({ attendancePunchId: punch.id }),
-			_insertOnly: true
-		});
-		if (!entry.id) throw new Error("Saved service entry has no id.");
-		punch.serviceTimeEntryId = entry.id;
-		await punch.save();
-	}
-	/** Idempotently link a closed, owned punch to draft service evidence. */
-	async linkServiceTimeEntry(punchId, work) {
-		return this.transact(async (tx) => {
-			const [punch] = await tx.punches.list({
-				where: {
-					...this.actor,
-					id: punchId
-				},
-				limit: 1
-			});
-			if (!punch) throw new AttendanceConflict("Punch not found for actor.");
-			await this.link(tx, punch, work);
-			return punch;
-		});
-	}
-	/** Close at startedAt + maxOpenSeconds once due, flagging the punch for review. */
-	async autoClose(now, maxOpenSeconds) {
-		this.date(now);
-		if (!Number.isSafeInteger(maxOpenSeconds) || maxOpenSeconds <= 0) throw new AttendanceConflict("maxOpenSeconds must be a positive integer.");
-		return this.transact(async (tx) => {
-			const [punch] = await tx.punches.list({
-				where: {
-					...this.actor,
-					endedAt: null
-				},
-				limit: 1
-			});
-			if (!punch) return null;
-			const deadline = new Date(punch.startedAt.getTime() + maxOpenSeconds * 1e3);
-			if (deadline > now) return null;
-			const closed = await this.transition(tx, "punchOut", deadline);
-			closed.reviewRequired = true;
-			await closed.save();
-			return closed;
-		});
-	}
-	/**
-	* Replay device timestamps in order (ties use clientId). Committed attendance
-	* wins: stale/state-conflicting taps get durable refusals; identical retries
-	* return the same outcome, changed payloads using a key are rejected. A
-	* database failure rolls back its tap and receipt and remains retryable.
-	*/
-	async replay(taps) {
-		for (const tap of taps) {
-			if (!tap || typeof tap.at !== "string" || typeof tap.clientId !== "string" || !tap.clientId || ![
-				"punchIn",
-				"punchOut",
-				"startBreak",
-				"endBreak"
-			].includes(tap.action)) throw new AttendanceConflict("Malformed attendance tap.");
-			this.date(new Date(tap.at));
-			if (tap.work !== void 0) this.validateWork(tap.work);
-			if (tap.paid !== void 0 && typeof tap.paid !== "boolean") throw new AttendanceConflict("paid must be boolean.");
-		}
-		const ordered = [...taps].sort((a, b) => Date.parse(a.at) - Date.parse(b.at) || (a.clientId < b.clientId ? -1 : a.clientId > b.clientId ? 1 : 0));
-		const outcomes = [];
-		for (const tap of ordered) outcomes.push(await this.transact(async (tx) => {
-			const replayKey = JSON.stringify([
-				this.actor.tenantId,
-				this.actor.profileId,
-				tap.clientId
-			]);
-			const content = JSON.stringify([
-				tap.action,
-				new Date(tap.at).toISOString(),
-				tap.paid ?? false,
-				tap.work?.workRefType ?? null,
-				tap.work?.workRefId ?? null,
-				tap.work?.description ?? null
-			]);
-			const [receipt] = await tx.replays.list({
-				where: {
-					tenantId: this.actor.tenantId,
-					replayKey
-				},
-				limit: 1
-			});
-			if (receipt) {
-				if (receipt.content !== content) throw new AttendanceConflict("Client id reused with different content.");
-				const outcome2 = receipt.getOutcome();
-				if (outcome2.clientId !== tap.clientId) throw new Error("Stored attendance receipt belongs to another client id.");
-				return outcome2;
-			}
-			let outcome;
-			try {
-				outcome = await withEmbeddedWriteTransaction(tx.db, isEmbeddedDatabase(tx.db), async (db) => {
-					const inner = {
-						db,
-						punches: await AttendancePunchCollection.create({ db }),
-						breaks: await AttendanceBreakCollection.create({ db }),
-						replays: tx.replays
-					};
-					const punch = await this.transition(inner, tap.action, new Date(tap.at), tap.paid, tap.work);
-					punch.recordedOffline = true;
-					punch.reviewRequired = true;
-					await punch.save();
-					return {
-						clientId: tap.clientId,
-						punchId: punch.id
-					};
-				}, true);
-			} catch (error) {
-				if (!(error instanceof AttendanceConflict)) throw error;
-				outcome = {
-					clientId: tap.clientId,
-					error: error.message
-				};
-			}
-			await tx.replays.create({
-				tenantId: this.actor.tenantId,
-				replayKey,
-				content,
-				outcome: JSON.stringify(outcome),
-				_insertOnly: true
-			});
-			return outcome;
-		}));
-		return outcomes;
-	}
-};
-//#endregion
-export { AttendanceBreak, AttendanceBreakCollection, AttendanceConflict, AttendancePunch, AttendancePunchCollection, AttendanceReplay, AttendanceReplayCollection, AttendanceService };
-
-//# sourceMappingURL=attendance.js.map
+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-0-YD5F_o.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-DGVy-iHI.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-BVeStEBv.js → attendance-B1jCbqSb.js}

@@ -1,5 +1,5 @@
-import { i as AttendancePunchCollection, n as AttendanceBreakCollection } from "./models-zU8Um7c2.js";
-import { i as integer, n as clipSource, r as instant } from "./rollup-U1IO_CMA.js";
+import { i as AttendancePunchCollection, n as AttendanceBreakCollection } from "./models-0-YD5F_o.js";
+import { i as integer, n as clipSource, r as instant } from "./rollup-CDqzCxI2.js";
 //#region src/rollup/attendance.ts
 async function attendanceSources(db, actor, period) {
 	const punches = await AttendancePunchCollection.create({ db });
@@ -57,4 +57,4 @@ async function attendanceSources(db, actor, period) {
 //#endregion
 export { attendanceSources };
 
-//# sourceMappingURL=attendance-BVeStEBv.js.map
+//# sourceMappingURL=attendance-B1jCbqSb.js.map

package/dist/chunks/{attendance-BVeStEBv.js.map → attendance-B1jCbqSb.js.map}

@@ -1 +1 @@
-{"version":3,"file":"attendance-BVeStEBv.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 { clipSource, instant, integer } from './calculation.js';\nimport type { TimecardActor, TimecardPeriod, TimecardSource } 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): 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 = clipSource(\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      );\n      if (source?.seconds) sources.push(source);\n    }\n  }\n  return { sources, linkedEntryIds };\n}\n"],"mappings":";;;AASA,eAAsB,kBACpB,IACA,OACA,QACqE;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,WACb;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,MACF;GACA,IAAI,QAAQ,SAAS,QAAQ,KAAK,MAAM;EAC1C;CACF;CACA,OAAO;EAAE;EAAS;CAAe;AACnC"}
+{"version":3,"file":"attendance-B1jCbqSb.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 { clipSource, instant, integer } from './calculation.js';\nimport type { TimecardActor, TimecardPeriod, TimecardSource } 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): 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 = clipSource(\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      );\n      if (source?.seconds) sources.push(source);\n    }\n  }\n  return { sources, linkedEntryIds };\n}\n"],"mappings":";;;AASA,eAAsB,kBACpB,IACA,OACA,QACqE;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,WACb;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,MACF;GACA,IAAI,QAAQ,SAAS,QAAQ,KAAK,MAAM;EAC1C;CACF;CACA,OAAO;EAAE;EAAS;CAAe;AACnC"}