@happyvertical/smrt-timesheets 0.55.24 → 0.56.1

package/dist/attendance/models.d.ts

@@ -8,7 +8,14 @@ export declare class AttendancePunch extends SmrtObject {
     durationSeconds: number;
     unpaidBreakSeconds: number;
     reviewRequired: boolean;
+    /** Why the scheduler closed this punch; empty unless `autoClose` did. Write-once. */
+    autoCloseReason: string;
     recordedOffline: boolean;
+    /** Optional short consumer-owned capture label (`device`, `web`, `import`, ...); `''` when unknown. */
+    source: string;
+    /** Qualified type of the device that captured the punch; both device columns or neither. */
+    deviceRefType: string;
+    deviceRefId: string;
     serviceTimeEntryId: string | null;
     /** Unique while open; closed rows retain independent non-null slots on every dialect. */
     openSlot: string;
@@ -22,15 +29,60 @@ export declare class AttendanceBreak extends SmrtObject {
     startedAt: Date;
     endedAt: Date | null;
     paid: boolean;
+    /** Optional short consumer-owned label (`meal`, `rest`, ...); `''` when unspecified. */
+    kind: string;
     openSlot: string;
     save(): Promise<this>;
     private saveConsistent;
+    delete(): Promise<void>;
+}
+declare const SEGMENT_CLOSE_REASONS: readonly ["stop", "switch", "break", "punchOut"];
+/** Why a work segment ended; `''` while it is open. */
+export type AttendanceSegmentCloseReason = (typeof SEGMENT_CLOSE_REASONS)[number] | '';
+/**
+ * A running unit of work inside one attendance punch: a work reference plus an
+ * optional second (task) reference as queryable columns, so job costing can
+ * index and join them. At most one segment is open per punch (`openSlot`). A
+ * segment never spans a break; `startBreak` and `punchOut` close it. Segments
+ * are attendance evidence and are not themselves service time entries.
+ */
+export declare class AttendanceSegment extends SmrtObject {
+    tenantId: string;
+    punchId: string;
+    /** Qualified class name of the work context (for example a work order). */
+    workRefType: string;
+    workRefId: string;
+    /** Optional second reference (for example an operation); both or neither. */
+    taskRefType: string;
+    taskRefId: string;
+    /** Optional short consumer lane label. */
+    kind: string;
+    description: string;
+    startedAt: Date;
+    endedAt: Date | null;
+    /** Elapsed whole seconds, set when the segment closes. */
+    durationSeconds: number;
+    /** `stop`, `switch`, `break` or `punchOut` once closed; `''` while open. */
+    closedReason: AttendanceSegmentCloseReason;
+    /** Set when a replay time policy asked for review of this segment's boundary. */
+    reviewRequired: boolean;
+    openSlot: string;
+    save(): Promise<this>;
+    private saveConsistent;
+    delete(): Promise<void>;
 }
 /** Durable success or conflict; conflicts do not mutate attendance. */
 export interface AttendanceReplayOutcome {
     clientId: string;
     punchId?: string;
+    /** Work segment a replayed work action started, switched to, stopped or resumed. */
+    segmentId?: string;
+    /** Effective time stored when a `resolveAt` policy changed it (ISO 8601). */
+    resolvedAt?: string;
+    /** Refusal message (with `code`); present exactly when the tap was refused. */
     error?: string;
+    /** Typed refusal reason; see `AttendanceRefusalCode`. */
+    code?: string;
 }
 /** Durable offline-tap outcome; never exposed through generated operations. */
 export declare class AttendanceReplay extends SmrtObject {
@@ -52,8 +104,13 @@ export declare class AttendancePunchCollection extends SmrtCollection<Attendance
 export declare class AttendanceBreakCollection extends SmrtCollection<AttendanceBreak> {
     static readonly _itemClass: typeof AttendanceBreak;
 }
+/** Work segments for job costing and attendance review. */
+export declare class AttendanceSegmentCollection extends SmrtCollection<AttendanceSegment> {
+    static readonly _itemClass: typeof AttendanceSegment;
+}
 /** Internal durable replay ledger. */
 export declare class AttendanceReplayCollection extends SmrtCollection<AttendanceReplay> {
     static readonly _itemClass: typeof AttendanceReplay;
 }
+export {};
 //# sourceMappingURL=models.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/attendance/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,cAAc,EACd,UAAU,EAGX,MAAM,0BAA0B,CAAC;AA4BlC,4EAA4E;AAC5E,qBAca,eAAgB,SAAQ,UAAU;IACjC,QAAQ,SAAM;IAC+B,SAAS,SAAM;IACxE,SAAS,EAAE,IAAI,CAAc;IAC7B,OAAO,EAAE,IAAI,GAAG,IAAI,CAAQ;IAC5B,eAAe,SAAK;IACpB,kBAAkB,SAAK;IACvB,cAAc,UAAS;IACvB,eAAe,UAAS;IAE4B,kBAAkB,EAClE,MAAM,GACN,IAAI,CAAQ;IAChB,yFAAyF;IAC9D,QAAQ,SAAM;IAE1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAMtB,cAAc;CA0D7B;AAED,0DAA0D;AAC1D,qBAca,eAAgB,SAAQ,UAAU;IACjC,QAAQ,SAAM;IACG,OAAO,SAAM;IAC1C,SAAS,EAAE,IAAI,CAAc;IAC7B,OAAO,EAAE,IAAI,GAAG,IAAI,CAAQ;IAC5B,IAAI,UAAS;IACc,QAAQ,SAAM;IAE1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAMtB,cAAc;CA6C7B;AAED,uEAAuE;AACvE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD,+EAA+E;AAC/E,qBAQa,gBAAiB,SAAQ,UAAU;IAClC,QAAQ,SAAM;IACe,SAAS,SAAM;IAC/B,OAAO,SAAM;IACb,OAAO,SAAQ;IAExC,qFAAqF;IACrF,UAAU,IAAI,uBAAuB;IAOrC,uEAAuE;IACvE,UAAU,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI;IAMjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAIrC;AAED,gDAAgD;AAChD,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,eAAe,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,UAAU,yBAAmB;CAC9C;AACD,4DAA4D;AAC5D,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,eAAe,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,UAAU,yBAAmB;CAC9C;AACD,sCAAsC;AACtC,qBAAa,0BAA2B,SAAQ,cAAc,CAAC,gBAAgB,CAAC;IAC9E,MAAM,CAAC,QAAQ,CAAC,UAAU,0BAAoB;CAC/C"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/attendance/models.ts"],"names":[],"mappings":"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"}

package/dist/attendance/segments.d.ts

@@ -0,0 +1,20 @@
+import { type AttendanceContext, type AttendanceWork } from './context.js';
+import type { AttendancePunch, AttendanceSegment, AttendanceSegmentCloseReason } from './models.js';
+/** The open segment of a punch, or null. */
+export declare function openSegment(tx: AttendanceContext, punch: AttendancePunch): Promise<AttendanceSegment | null>;
+/** All segments of a punch, oldest first. */
+export declare function listSegments(tx: AttendanceContext, punch: AttendancePunch): Promise<AttendanceSegment[]>;
+/** Close the punch's open segment, if any. Returns it, or null when none was open. */
+export declare function closeOpenSegment(tx: AttendanceContext, punch: AttendancePunch, at: Date, reason: Exclude<AttendanceSegmentCloseReason, ''>): Promise<AttendanceSegment | null>;
+/** Open a segment; refuses while a break or another segment is open. */
+export declare function beginSegment(tx: AttendanceContext, punch: AttendancePunch, at: Date, work: AttendanceWork): Promise<AttendanceSegment>;
+/** Atomically close the open segment and open the next at the same instant. */
+export declare function replaceSegment(tx: AttendanceContext, punch: AttendancePunch, at: Date, work: AttendanceWork): Promise<AttendanceSegment>;
+/** Close the open segment (`stop`); refuses when none is open. */
+export declare function endSegment(tx: AttendanceContext, punch: AttendancePunch, at: Date): Promise<AttendanceSegment>;
+/**
+ * Reopen the work a break interrupted: a new segment with the same references
+ * as the latest segment, which must have been closed by `startBreak`.
+ */
+export declare function continueSegment(tx: AttendanceContext, punch: AttendancePunch, at: Date): Promise<AttendanceSegment>;
+//# sourceMappingURL=segments.d.ts.map

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"}