@kernhq/module-hr 0.2.0 → 0.4.0

package/dist/contract/attendance.js

@@ -0,0 +1,154 @@
+import { Timestamp, WorkspaceId } from '@kernhq/contracts';
+import { z } from 'zod';
+import { IsoDate, TimeZone, WallClock } from './models.js';
+const ws = { workspaceId: WorkspaceId };
+/**
+ * Attendance: who was at work, when, and for how long.
+ *
+ * Two rules shape everything here:
+ *
+ * - **Raw punches are immutable.** A wrong punch is *voided* by a correcting row, never edited. An
+ *   attendance record somebody can quietly rewrite is worth nothing in the dispute it exists for.
+ * - **The day sheet is derived.** `AttendanceDay` is a projection of punches + schedule + calendar +
+ *   leave, recomputable from scratch at any time. It is never the source of truth, so a bad
+ *   computation is a bug to fix and re-run rather than data to repair by hand.
+ */
+export const PunchDirection = z.enum(['in', 'out', 'break_start', 'break_end']);
+export const PunchMethod = z.enum(['web', 'mobile', 'kiosk', 'qr', 'device', 'import', 'manual']);
+/**
+ * How much the recorded instant can be trusted.
+ *
+ * `trusted` was stamped by the server as it happened. `claimed` came from a client that was offline
+ * and is asserting when it happened — believed within a policy threshold, flagged beyond it.
+ * `disputed` is a claim somebody has to look at. Client clocks lie, sometimes by accident and
+ * sometimes not, and a system that cannot say which is which cannot defend any of its numbers.
+ */
+export const PunchTrust = z.enum(['trusted', 'claimed', 'disputed']);
+export const Punch = z.object({
+    id: z.uuid(),
+    ...ws,
+    personId: z.uuid(),
+    direction: PunchDirection,
+    /** Server-stamped, or the client's claim when it was offline. Always an instant, never a local time. */
+    at: Timestamp,
+    /** What the client believed the time was. Kept for audit even when it disagrees. */
+    clientReportedAt: Timestamp.nullable(),
+    /** How far the client's clock was out, in milliseconds. Null when the server stamped it. */
+    skewMs: z.number().int().nullable(),
+    /** The day this belongs to, in the person's schedule zone. A night shift lands on its start date. */
+    businessDate: IsoDate,
+    /** The zone the punch actually happened in — for audit, not for attribution. */
+    timezone: TimeZone,
+    method: PunchMethod,
+    /** The office whose geofence or allowlist accepted it; any office the person is assigned to. */
+    officeId: z.uuid().nullable(),
+    deviceId: z.uuid().nullable(),
+    geo: z.object({ lat: z.number(), lng: z.number(), accuracyM: z.number().optional() }).nullable(),
+    trust: PunchTrust,
+    /** Set when a later correction voided this row. The row itself never changes otherwise. */
+    voidedByPunchId: z.uuid().nullable(),
+    note: z.string().max(500).nullable(),
+    createdAt: Timestamp,
+});
+export const AttendanceStatus = z.enum([
+    'present',
+    'absent',
+    'leave',
+    'holiday',
+    'weekend',
+    'partial',
+    /** Something is unpaired — usually a missing clock-out. Needs a human. */
+    'pending',
+]);
+/**
+ * One person, one day, derived.
+ *
+ * Recomputable from punches, schedule, calendar and leave at any moment. `policyHash` records what
+ * produced it, so a recomputation can tell whether a row is stale; `locked` mirrors the period, so
+ * a closed month cannot silently move.
+ */
+export const AttendanceDay = z.object({
+    id: z.uuid(),
+    ...ws,
+    personId: z.uuid(),
+    businessDate: IsoDate,
+    scheduledMinutes: z.number().int(),
+    workedMinutes: z.number().int(),
+    breakMinutes: z.number().int(),
+    overtimeMinutes: z.number().int(),
+    lateMinutes: z.number().int(),
+    earlyLeaveMinutes: z.number().int(),
+    status: AttendanceStatus,
+    leaveRequestId: z.uuid().nullable(),
+    anomalies: z.array(z.string()),
+    firstIn: Timestamp.nullable(),
+    lastOut: Timestamp.nullable(),
+    policyHash: z.string().max(64).nullable(),
+    locked: z.boolean(),
+    computedAt: Timestamp,
+});
+/** A week of shifts, in wall-clock readings. Meaningless until a date and a zone arrive. */
+export const ScheduleWeek = z.record(z.enum(['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun']), z
+    .object({
+    start: WallClock,
+    end: WallClock,
+    breakMinutes: z.number().int().min(0).max(480).default(0),
+})
+    .nullable());
+export const Schedule = z.object({
+    id: z.uuid(),
+    ...ws,
+    name: z.string().min(1).max(120),
+    kind: z.enum(['fixed', 'flexible', 'shift']),
+    week: ScheduleWeek,
+    /** `office` means the person's primary office — the default, and almost always right. */
+    tzMode: z.enum(['office', 'person', 'fixed']),
+    tz: TimeZone.nullable(),
+    graceInMinutes: z.number().int().min(0).max(240),
+    graceOutMinutes: z.number().int().min(0).max(240),
+    roundingStepMinutes: z.number().int().min(0).max(60),
+    roundingDirection: z.enum(['nearest', 'employee', 'employer']),
+    /** Close an open shift automatically after this many minutes. Null leaves it for a human. */
+    autoClockOutAfterMinutes: z.number().int().min(60).nullable(),
+    archivedAt: Timestamp.nullable(),
+});
+export const ScheduleAssignment = z.object({
+    id: z.uuid(),
+    ...ws,
+    personId: z.uuid(),
+    scheduleId: z.uuid(),
+    effectiveFrom: IsoDate,
+    effectiveTo: IsoDate.nullable(),
+});
+/**
+ * A request to fix a wrong or missing punch.
+ *
+ * It does not edit anything. Approving it writes *new* punches that void the old ones, so the
+ * original record and the correction both survive — which is the difference between a corrected
+ * timesheet and an edited one.
+ */
+export const Regularization = z.object({
+    id: z.uuid(),
+    ...ws,
+    personId: z.uuid(),
+    businessDate: IsoDate,
+    /** Null when the person never punched at all and is asking for the whole day to be recorded. */
+    punchId: z.uuid().nullable(),
+    proposed: z.array(z.object({ direction: PunchDirection, at: Timestamp })),
+    reason: z.string().min(1).max(1000),
+    status: z.enum(['pending', 'approved', 'rejected', 'cancelled']),
+    approvalRequestId: z.uuid().nullable(),
+    appliedAt: Timestamp.nullable(),
+    createdAt: Timestamp,
+});
+/** The person's own live state: are they clocked in, since when, on a break? */
+export const ClockState = z.object({
+    personId: z.uuid(),
+    businessDate: IsoDate,
+    clockedIn: z.boolean(),
+    onBreak: z.boolean(),
+    since: Timestamp.nullable(),
+    workedMinutesToday: z.number().int(),
+    timezone: TimeZone,
+});
+//# sourceMappingURL=attendance.js.map

package/dist/contract/attendance.js.map

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

package/dist/contract/capabilities.d.ts

@@ -26,7 +26,7 @@ export declare const hrCapabilities: readonly {
     label: string;
     dependsOn: string[];
     defaultEnabled: boolean;
-    level: 3 | 1 | 2;
+    level: 1 | 2 | 3;
     required: boolean;
     description?: string | undefined;
 }[];

package/dist/contract/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/contract/capabilities.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,cAAc;;;;;;;;GAiDzB,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAA;AAElE;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CA4BpE,CAAA"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/contract/capabilities.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,cAAc;;;;;;;;GAuFzB,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAA;AAElE;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAsEpE,CAAA"}

package/dist/contract/capabilities.js

@@ -63,6 +63,44 @@ export const hrCapabilities = defineCapabilities([
         defaultEnabled: true,
         level: 1,
     },
+    {
+        id: 'leave',
+        label: 'Leave',
+        description: 'Time off: types, balances, requests and approvals',
+        dependsOn: ['core', 'calendars'],
+        // On by default. Leave is what most companies come to an HR system for, and a directory that
+        // cannot answer "who is off next week" is answering a question nobody asked.
+        defaultEnabled: true,
+        level: 1,
+    },
+    {
+        id: 'approvals',
+        label: 'Approval chains',
+        description: 'Named multi-step approvals with delegation, instead of a single manager',
+        dependsOn: ['core'],
+        // Off by default: at Level 1 the requester's manager approves, implicitly, and a company with
+        // one approver does not need a chain editor to find out that it has one.
+        defaultEnabled: false,
+        level: 2,
+    },
+    {
+        id: 'attendance',
+        label: 'Attendance',
+        description: 'Clock in and out, schedules and a daily sheet',
+        dependsOn: ['core', 'calendars'],
+        // Off by default. Plenty of companies never clock anybody in, and a directory that offers a
+        // clock button to salaried staff is offering a feature nobody asked for.
+        defaultEnabled: false,
+        level: 1,
+    },
+    {
+        id: 'overtime',
+        label: 'Overtime',
+        description: 'Detect and approve time worked beyond the schedule',
+        dependsOn: ['attendance'],
+        defaultEnabled: false,
+        level: 2,
+    },
     {
         id: 'documents',
         label: 'Employee documents',
@@ -110,5 +148,47 @@ export const hrCapabilityProcedures = {
         'calendars.workingDays',
     ],
     documents: ['documents.list', 'documents.attach', 'documents.remove'],
+    leave: [
+        'leave.types.list',
+        'leave.types.create',
+        'leave.types.update',
+        'leave.types.archive',
+        'leave.balance.get',
+        'leave.ledger.list',
+        'leave.adjust',
+        'leave.requests.list',
+        'leave.requests.get',
+        'leave.requests.simulate',
+        'leave.requests.create',
+        'leave.requests.cancel',
+        'leave.team.calendar',
+    ],
+    attendance: [
+        'attendance.state',
+        'attendance.clockIn',
+        'attendance.clockOut',
+        'attendance.breakStart',
+        'attendance.breakEnd',
+        'attendance.punches.list',
+        'attendance.punches.void',
+        'attendance.days.list',
+        'attendance.days.recompute',
+        'attendance.schedules.list',
+        'attendance.schedules.create',
+        'attendance.schedules.update',
+        'attendance.schedules.archive',
+        'attendance.schedules.assign',
+        'attendance.regularizations.list',
+        'attendance.regularizations.request',
+    ],
+    approvals: [
+        'approvals.chains.list',
+        'approvals.chains.create',
+        'approvals.chains.update',
+        'approvals.chains.archive',
+        'approvals.delegate',
+        'approvals.revokeDelegation',
+        'approvals.delegations',
+    ],
 };
 //# sourceMappingURL=capabilities.js.map

package/dist/contract/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/contract/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;IAC/C;QACE,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,+EAA+E;QAC5F,SAAS,EAAE,CAAC,MAAM,CAAC;QACnB,iGAAiG;QACjG,+FAA+F;QAC/F,4FAA4F;QAC5F,+FAA+F;QAC/F,+BAA+B;QAC/B,cAAc,EAAE,KAAK;QACrB,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,mEAAmE;QAChF,iGAAiG;QACjG,4EAA4E;QAC5E,SAAS,EAAE,CAAC,SAAS,CAAC;QACtB,cAAc,EAAE,KAAK;QACrB,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,wDAAwD;QACrE,SAAS,EAAE,CAAC,MAAM,CAAC;QACnB,gGAAgG;QAChG,4CAA4C;QAC5C,cAAc,EAAE,IAAI;QACpB,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,iEAAiE;QAC9E,SAAS,EAAE,CAAC,MAAM,CAAC;QACnB,cAAc,EAAE,KAAK;QACrB,KAAK,EAAE,CAAC;KACT;CACF,CAAC,CAAA;AAIF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsC;IACvE,OAAO,EAAE;QACP,cAAc;QACd,aAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,iBAAiB;QACjB,oBAAoB;QACpB,gBAAgB;QAChB,kBAAkB;QAClB,gBAAgB;KACjB;IACD,cAAc,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;IAC3G,SAAS,EAAE;QACT,gBAAgB;QAChB,eAAe;QACf,kBAAkB;QAClB,kBAAkB;QAClB,mBAAmB;QACnB,qBAAqB;QACrB,oBAAoB;QACpB,uBAAuB;QACvB,uBAAuB;QACvB,wBAAwB;QACxB,sBAAsB;QACtB,uBAAuB;KACxB;IACD,SAAS,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,CAAC;CACtE,CAAA"}
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/contract/capabilities.ts"],"names":[],"mappings":"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"}

package/dist/contract/events.d.ts

@@ -64,6 +64,66 @@ export declare const hrEvents: {
      * sheet) is stale from here. The payload names the date range touched so a consumer can recompute
      * that window rather than everything.
      */
+    leaveRequested: import("@kernhq/contracts").EventDef<"hr.leave.requested", z.ZodObject<{
+        requestId: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        personId: z.ZodUUID;
+        startsOn: z.ZodISODate;
+        endsOn: z.ZodISODate;
+    }, z.core.$strip>>;
+    /**
+     * Decided either way, with the outcome in the payload.
+     *
+     * One event rather than approved/rejected pairs: every consumer so far cares that a decision
+     * happened and then branches, and two events means two subscriptions to keep in step.
+     */
+    leaveDecided: import("@kernhq/contracts").EventDef<"hr.leave.decided", z.ZodObject<{
+        requestId: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        personId: z.ZodUUID;
+        status: z.ZodString;
+        startsOn: z.ZodISODate;
+        endsOn: z.ZodISODate;
+    }, z.core.$strip>>;
+    /** A balance moved. Carries the delta so a consumer need not re-sum the ledger. */
+    leaveBalanceChanged: import("@kernhq/contracts").EventDef<"hr.leave.balance_changed", z.ZodObject<{
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        personId: z.ZodUUID;
+        leaveTypeId: z.ZodUUID;
+        deltaMinutes: z.ZodNumber;
+    }, z.core.$strip>>;
+    approvalRequested: import("@kernhq/contracts").EventDef<"hr.approval.requested", z.ZodObject<{
+        requestId: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        subjectType: z.ZodString;
+        subjectId: z.ZodUUID;
+        approverIds: z.ZodArray<z.ZodUUID>;
+    }, z.core.$strip>>;
+    approvalDecided: import("@kernhq/contracts").EventDef<"hr.approval.decided", z.ZodObject<{
+        requestId: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        subjectType: z.ZodString;
+        subjectId: z.ZodUUID;
+        status: z.ZodString;
+    }, z.core.$strip>>;
+    punchRecorded: import("@kernhq/contracts").EventDef<"hr.punch.recorded", z.ZodObject<{
+        punchId: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        personId: z.ZodUUID;
+        direction: z.ZodString;
+        businessDate: z.ZodISODate;
+    }, z.core.$strip>>;
+    /**
+     * A derived day changed. Carries the date so a consumer recomputes that window rather than
+     * everything — this fires on every punch, so a coarse payload would be a stampede.
+     */
+    attendanceDayComputed: import("@kernhq/contracts").EventDef<"hr.attendance.day_computed", z.ZodObject<{
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        personId: z.ZodUUID;
+        businessDate: z.ZodISODate;
+        status: z.ZodString;
+        workedMinutes: z.ZodNumber;
+    }, z.core.$strip>>;
     calendarChanged: import("@kernhq/contracts").EventDef<"hr.calendar.changed", z.ZodObject<{
         calendarId: z.ZodUUID;
         workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;

package/dist/contract/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/contract/events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;IASnB;;;;;;OAMG;;;;;;;;;;;;;;IAoBH;;;;;OAKG;;;;;;;;;;;;;IAeH;;;;;;OAMG;;;;;;;CAUJ,CAAA"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/contract/events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;IASnB;;;;;;OAMG;;;;;;;;;;;;;;IAoBH;;;;;OAKG;;;;;;;;;;;;;IAeH;;;;;;OAMG;;;;;;;;IAWH;;;;;OAKG;;;;;;;;;IAYH,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwCnF;;;OAGG;;;;;;;;;;;;;;CAoBJ,CAAA"}

package/dist/contract/events.js

@@ -53,6 +53,66 @@ export const hrEvents = {
      * sheet) is stale from here. The payload names the date range touched so a consumer can recompute
      * that window rather than everything.
      */
+    leaveRequested: defineEvent('hr.leave.requested', z.object({
+        requestId: z.uuid(),
+        workspaceId: WorkspaceId,
+        personId: z.uuid(),
+        startsOn: z.iso.date(),
+        endsOn: z.iso.date(),
+    })),
+    /**
+     * Decided either way, with the outcome in the payload.
+     *
+     * One event rather than approved/rejected pairs: every consumer so far cares that a decision
+     * happened and then branches, and two events means two subscriptions to keep in step.
+     */
+    leaveDecided: defineEvent('hr.leave.decided', z.object({
+        requestId: z.uuid(),
+        workspaceId: WorkspaceId,
+        personId: z.uuid(),
+        status: z.string(),
+        startsOn: z.iso.date(),
+        endsOn: z.iso.date(),
+    })),
+    /** A balance moved. Carries the delta so a consumer need not re-sum the ledger. */
+    leaveBalanceChanged: defineEvent('hr.leave.balance_changed', z.object({
+        workspaceId: WorkspaceId,
+        personId: z.uuid(),
+        leaveTypeId: z.uuid(),
+        deltaMinutes: z.number().int(),
+    })),
+    approvalRequested: defineEvent('hr.approval.requested', z.object({
+        requestId: z.uuid(),
+        workspaceId: WorkspaceId,
+        subjectType: z.string(),
+        subjectId: z.uuid(),
+        approverIds: z.array(z.uuid()),
+    })),
+    approvalDecided: defineEvent('hr.approval.decided', z.object({
+        requestId: z.uuid(),
+        workspaceId: WorkspaceId,
+        subjectType: z.string(),
+        subjectId: z.uuid(),
+        status: z.string(),
+    })),
+    punchRecorded: defineEvent('hr.punch.recorded', z.object({
+        punchId: z.uuid(),
+        workspaceId: WorkspaceId,
+        personId: z.uuid(),
+        direction: z.string(),
+        businessDate: z.iso.date(),
+    })),
+    /**
+     * A derived day changed. Carries the date so a consumer recomputes that window rather than
+     * everything — this fires on every punch, so a coarse payload would be a stampede.
+     */
+    attendanceDayComputed: defineEvent('hr.attendance.day_computed', z.object({
+        workspaceId: WorkspaceId,
+        personId: z.uuid(),
+        businessDate: z.iso.date(),
+        status: z.string(),
+        workedMinutes: z.number().int(),
+    })),
     calendarChanged: defineEvent('hr.calendar.changed', z.object({
         calendarId: z.uuid(),
         workspaceId: WorkspaceId,

package/dist/contract/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/contract/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,aAAa,EAAE,WAAW,CACxB,mBAAmB,EACnB,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CACxF;IACD,aAAa,EAAE,WAAW,CACxB,mBAAmB,EACnB,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CACxF;IACD;;;;;;OAMG;IACH,mBAAmB,EAAE,WAAW,CAC9B,0BAA0B,EAC1B,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE;QAClB,WAAW,EAAE,WAAW;QACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE;KACjB,CAAC,CACH;IACD,iBAAiB,EAAE,WAAW,CAC5B,uBAAuB,EACvB,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE;QAClB,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE;QACtB,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE;KAC5B,CAAC,CACH;IACD;;;;;OAKG;IACH,uBAAuB,EAAE,WAAW,CAClC,8BAA8B,EAC9B,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE;QAClB,WAAW,EAAE,WAAW;QACxB,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE;QAClB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;QACtB,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE;KAC5B,CAAC,CACH;IACD,aAAa,EAAE,WAAW,CACxB,mBAAmB,EACnB,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAChF;IACD;;;;;;OAMG;IACH,eAAe,EAAE,WAAW,CAC1B,qBAAqB,EACrB,CAAC,CAAC,MAAM,CAAC;QACP,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE;QACpB,WAAW,EAAE,WAAW;QACxB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;QAC7B,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;KAC5B,CAAC,CACH;CACF,CAAA"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/contract/events.ts"],"names":[],"mappings":"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"}

package/dist/contract/index.d.ts

@@ -6,8 +6,11 @@
  * exists here and not in the router is a lie that compiles. `module.test.ts` checks exactly that,
  * and also that every procedure listed in `hrCapabilityProcedures` carries its capability guard.
  */
+export * from './approvals.js';
+export * from './attendance.js';
 export * from './capabilities.js';
 export * from './events.js';
+export * from './leave.js';
 export * from './models.js';
 export * from './permissions.js';
 export * from './router.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}

package/dist/contract/index.js

@@ -6,8 +6,11 @@
  * exists here and not in the router is a lie that compiles. `module.test.ts` checks exactly that,
  * and also that every procedure listed in `hrCapabilityProcedures` carries its capability guard.
  */
+export * from './approvals.js';
+export * from './attendance.js';
 export * from './capabilities.js';
 export * from './events.js';
+export * from './leave.js';
 export * from './models.js';
 export * from './permissions.js';
 export * from './router.js';

package/dist/contract/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}

package/dist/contract/leave.d.ts

@@ -0,0 +1,168 @@
+import { z } from 'zod';
+/**
+ * Leave, and the one rule everything here follows: **a balance is a sum, never a stored number.**
+ *
+ * Every grant, accrual, consumption, reversal, expiry and adjustment is an append-only ledger entry.
+ * Cancelling approved leave inserts a reversal; it does not delete the consumption. That costs a
+ * little arithmetic and buys the only thing that matters when an employee and HR disagree about a
+ * balance: a list of what happened, in order, that nobody edited.
+ */
+export declare const LeaveUnit: z.ZodEnum<{
+    half_day: "half_day";
+    day: "day";
+    hour: "hour";
+}>;
+export type LeaveUnit = z.infer<typeof LeaveUnit>;
+export declare const LeaveType: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    paid: z.ZodBoolean;
+    unit: z.ZodEnum<{
+        half_day: "half_day";
+        day: "day";
+        hour: "hour";
+    }>;
+    color: z.ZodNullable<z.ZodString>;
+    icon: z.ZodNullable<z.ZodString>;
+    requiresDocumentAfterDays: z.ZodNullable<z.ZodNumber>;
+    countsWorkingDaysOnly: z.ZodBoolean;
+    allowNegative: z.ZodBoolean;
+    maxNegativeMinutes: z.ZodNumber;
+    order: z.ZodNumber;
+    archivedAt: z.ZodNullable<z.ZodISODateTime>;
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    id: z.ZodUUID;
+}, z.core.$strip>;
+export type LeaveType = z.infer<typeof LeaveType>;
+/**
+ * Why a ledger entry exists. The set is closed on purpose — a new kind of movement is a decision,
+ * not a string somebody passes in.
+ */
+export declare const LedgerKind: z.ZodEnum<{
+    grant: "grant";
+    accrual: "accrual";
+    consumption: "consumption";
+    reversal: "reversal";
+    expiry: "expiry";
+    adjustment: "adjustment";
+    carry_in: "carry_in";
+    carry_out: "carry_out";
+    encashment: "encashment";
+}>;
+export type LedgerKind = z.infer<typeof LedgerKind>;
+export declare const LeaveLedgerEntry: z.ZodObject<{
+    personId: z.ZodUUID;
+    leaveTypeId: z.ZodUUID;
+    kind: z.ZodEnum<{
+        grant: "grant";
+        accrual: "accrual";
+        consumption: "consumption";
+        reversal: "reversal";
+        expiry: "expiry";
+        adjustment: "adjustment";
+        carry_in: "carry_in";
+        carry_out: "carry_out";
+        encashment: "encashment";
+    }>;
+    amountMinutes: z.ZodNumber;
+    effectiveOn: z.ZodISODate;
+    periodYear: z.ZodNumber;
+    requestId: z.ZodNullable<z.ZodUUID>;
+    reversesEntryId: z.ZodNullable<z.ZodUUID>;
+    policyHash: z.ZodNullable<z.ZodString>;
+    reason: z.ZodNullable<z.ZodString>;
+    createdBy: z.ZodNullable<z.ZodUUID>;
+    createdAt: z.ZodISODateTime;
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    id: z.ZodUUID;
+}, z.core.$strip>;
+export type LeaveLedgerEntry = z.infer<typeof LeaveLedgerEntry>;
+export declare const LeaveBalance: z.ZodObject<{
+    personId: z.ZodUUID;
+    leaveTypeId: z.ZodUUID;
+    leaveTypeName: z.ZodString;
+    unit: z.ZodEnum<{
+        half_day: "half_day";
+        day: "day";
+        hour: "hour";
+    }>;
+    periodYear: z.ZodNumber;
+    balanceMinutes: z.ZodNumber;
+    bookedMinutes: z.ZodNumber;
+    pendingMinutes: z.ZodNumber;
+    availableMinutes: z.ZodNumber;
+    balance: z.ZodNumber;
+    available: z.ZodNumber;
+}, z.core.$strip>;
+export type LeaveBalance = z.infer<typeof LeaveBalance>;
+export declare const LeaveRequestStatus: z.ZodEnum<{
+    pending: "pending";
+    approved: "approved";
+    rejected: "rejected";
+    cancelled: "cancelled";
+    draft: "draft";
+    withdrawn: "withdrawn";
+}>;
+export type LeaveRequestStatus = z.infer<typeof LeaveRequestStatus>;
+/** Which half of a day a request starts or ends on. */
+export declare const DayPart: z.ZodEnum<{
+    full: "full";
+    morning: "morning";
+    afternoon: "afternoon";
+}>;
+export type DayPart = z.infer<typeof DayPart>;
+export declare const LeaveRequest: z.ZodObject<{
+    personId: z.ZodUUID;
+    leaveTypeId: z.ZodUUID;
+    startsOn: z.ZodISODate;
+    endsOn: z.ZodISODate;
+    startPart: z.ZodEnum<{
+        full: "full";
+        morning: "morning";
+        afternoon: "afternoon";
+    }>;
+    endPart: z.ZodEnum<{
+        full: "full";
+        morning: "morning";
+        afternoon: "afternoon";
+    }>;
+    hours: z.ZodNullable<z.ZodNumber>;
+    workingDays: z.ZodNumber;
+    minutes: z.ZodNumber;
+    status: z.ZodEnum<{
+        pending: "pending";
+        approved: "approved";
+        rejected: "rejected";
+        cancelled: "cancelled";
+        draft: "draft";
+        withdrawn: "withdrawn";
+    }>;
+    reason: z.ZodNullable<z.ZodString>;
+    documentFileId: z.ZodNullable<z.ZodUUID>;
+    approvalRequestId: z.ZodNullable<z.ZodUUID>;
+    decidedAt: z.ZodNullable<z.ZodISODateTime>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    id: z.ZodUUID;
+}, z.core.$strip>;
+export type LeaveRequest = z.infer<typeof LeaveRequest>;
+/** What a request would cost, before anybody submits it. */
+export declare const LeaveSimulation: z.ZodObject<{
+    workingDays: z.ZodNumber;
+    minutes: z.ZodNumber;
+    days: z.ZodArray<z.ZodObject<{
+        date: z.ZodISODate;
+        fraction: z.ZodNumber;
+        counted: z.ZodBoolean;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    balanceBeforeMinutes: z.ZodNumber;
+    balanceAfterMinutes: z.ZodNumber;
+    blockers: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LeaveSimulation = z.infer<typeof LeaveSimulation>;
+//# sourceMappingURL=leave.d.ts.map

package/dist/contract/leave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leave.d.ts","sourceRoot":"","sources":["../../src/contract/leave.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB;;;;;;;GAOG;AAEH,eAAO,MAAM,SAAS;;;;EAAsC,CAAA;AAC5D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA;AAEjD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;iBAwBpB,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA;AAEjD;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;EAiBrB,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AAEnD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;iBAqB3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;iBAiBvB,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD,eAAO,MAAM,kBAAkB;;;;;;;EAQ7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE,uDAAuD;AACvD,eAAO,MAAM,OAAO;;;;EAA2C,CAAA;AAC/D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAA;AAE7C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBvB,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD,4DAA4D;AAC5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;iBAgB1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA"}