@happyvertical/smrt-timesheets 0.53.1 → 0.53.2

package/dist/rollup/attendance.d.ts

@@ -0,0 +1,8 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { TimecardActor, TimecardPeriod, TimecardSource } from './types.js';
+/** Optional attendance reader. Called on the rollup's transaction executor. */
+export declare function attendanceSources(db: DatabaseInterface, actor: TimecardActor, period: TimecardPeriod): Promise<{
+    sources: TimecardSource[];
+    linkedEntryIds: Set<string>;
+}>;
+//# sourceMappingURL=attendance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attendance.d.ts","sourceRoot":"","sources":["../../src/rollup/attendance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAM5D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhF,+EAA+E;AAC/E,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CA0DrE"}

package/dist/rollup/calculation.d.ts

@@ -0,0 +1,7 @@
+import type { TimecardPeriod, TimecardSource } from './types.js';
+export declare function integer(value: number, signed?: boolean): number;
+export declare function instant(value: Date): number;
+export declare function validatePeriod(value: TimecardPeriod, at: Date): TimecardPeriod;
+/** Prefix allocation preserves integer seconds across adjacent half-open periods. */
+export declare function clipSource(source: TimecardSource, period: TimecardPeriod): TimecardSource | null;
+//# sourceMappingURL=calculation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculation.d.ts","sourceRoot":"","sources":["../../src/rollup/calculation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,CAI7D;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAI3C;AACD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,EAAE,EAAE,IAAI,GACP,cAAc,CAsChB;AACD,qFAAqF;AACrF,wBAAgB,UAAU,CACxB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,GACrB,cAAc,GAAG,IAAI,CAsBvB"}

package/dist/rollup/models.d.ts

@@ -0,0 +1,47 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import type { TimecardSource } from './types.js';
+/** One person's immutable-on-confirmation period snapshot, in integer seconds. */
+export declare class PeriodTimecard extends SmrtObject {
+    tenantId: string;
+    profileId: string;
+    startsAt: Date;
+    endsAt: Date;
+    timezone: string;
+    rulesVersion: string;
+    rulesSnapshot: string;
+    sourceSnapshot: string;
+    regularSeconds: number;
+    overtimeSeconds: number;
+    totalSeconds: number;
+    status: 'open' | 'confirmed';
+    confirmedAt: Date | null;
+    confirmedByProfileId: string | null;
+    /** Return a detached source snapshot; corrupt persisted JSON fails closed. */
+    getSources(): TimecardSource[];
+    /** Return the consumer policy frozen with this rollup. */
+    getRules(): Record<string, unknown>;
+    save(): Promise<this>;
+    delete(): Promise<void>;
+}
+/** Attributed append-only signed seconds; the confirmed base card never changes. */
+export declare class TimecardAdjustment extends SmrtObject {
+    tenantId: string;
+    timecardId: string;
+    profileId: string;
+    actorProfileId: string;
+    operationId: string;
+    regularSeconds: number;
+    overtimeSeconds: number;
+    reason: string;
+    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;
+}
+/** Scoped append-only adjustment collection. */
+export declare class TimecardAdjustmentCollection extends SmrtCollection<TimecardAdjustment> {
+    static readonly _itemClass: typeof TimecardAdjustment;
+}
+//# sourceMappingURL=models.d.ts.map

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

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

package/dist/rollup/service.d.ts

@@ -0,0 +1,37 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { PeriodTimecard, TimecardAdjustment } from './models.js';
+import type { PeriodRulesResolver, TimecardActor, TimecardAdjustmentInput } from './types.js';
+/**
+ * Server-side, trusted tenant/person capability. Consumers authorize this scope
+ * before construction. Reads and writes reject conflicting ambient tenancy.
+ * SQLite and PostgreSQL are supported; policy and payroll remain consumer-owned.
+ */
+export declare class PeriodRollupService {
+    private readonly db;
+    private readonly actor;
+    private readonly resolver;
+    private readonly options;
+    constructor(db: DatabaseInterface, actor: TimecardActor, resolver: PeriodRulesResolver, options?: {
+        attendance?: boolean;
+        actorProfileId?: string;
+    });
+    private identity;
+    private scope;
+    private transact;
+    private card;
+    /** Scoped read on the root executor, including after transaction completion. */
+    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. */
+    confirm(id: string): Promise<PeriodTimecard>;
+    /** 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. */
+    totals(id: string): Promise<{
+        regularSeconds: number;
+        overtimeSeconds: number;
+        totalSeconds: number;
+    }>;
+}
+//# sourceMappingURL=service.d.ts.map

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

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

package/dist/rollup/types.d.ts

@@ -0,0 +1,38 @@
+/** Trusted scope resolved and authorized by the consumer's server. */
+export interface TimecardActor {
+    tenantId: string;
+    profileId: string;
+}
+/** Half-open UTC period; the resolver owns calendar length/start day and DST. */
+export interface TimecardPeriod {
+    startsAt: Date;
+    endsAt: Date;
+    timezone: string;
+    version: string;
+    /** JSON policy snapshot: thresholds, holidays, calendar configuration, etc. */
+    rules: Record<string, unknown>;
+}
+/** Auditable integer-second contribution after clipping to the period. */
+export interface TimecardSource {
+    kind: 'entry' | 'attendance';
+    id: string;
+    startsAt: string;
+    endsAt: string;
+    seconds: number;
+}
+/** No payroll or jurisdiction policy is built into this interface. */
+export interface PeriodRulesResolver {
+    periodFor(at: Date, actor: Readonly<TimecardActor>): Promise<TimecardPeriod>;
+    classify(period: Readonly<TimecardPeriod>, sources: readonly Readonly<TimecardSource>[], actor: Readonly<TimecardActor>): Promise<{
+        regularSeconds: number;
+        overtimeSeconds: number;
+    }>;
+}
+/** Signed correction to a confirmed card, deduplicated by a caller operation key. */
+export interface TimecardAdjustmentInput {
+    operationId: string;
+    regularSeconds: number;
+    overtimeSeconds: number;
+    reason: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/rollup/write.d.ts

@@ -0,0 +1,4 @@
+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>;
+//# sourceMappingURL=write.d.ts.map

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

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

package/dist/rollup.d.ts

@@ -0,0 +1,5 @@
+import './__smrt-register__.js';
+export { PeriodTimecard, PeriodTimecardCollection, TimecardAdjustment, TimecardAdjustmentCollection, } from './rollup/models.js';
+export { PeriodRollupService } from './rollup/service.js';
+export type { PeriodRulesResolver, TimecardActor, TimecardAdjustmentInput, TimecardPeriod, TimecardSource, } from './rollup/types.js';
+//# sourceMappingURL=rollup.d.ts.map

package/dist/rollup.d.ts.map

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

package/dist/rollup.js

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