@kernhq/module-hr 0.10.0 → 0.10.2

package/dist/policy/working-time.d.ts

@@ -30,6 +30,22 @@ export interface RoundingPolicy {
     direction: 'nearest' | 'employee' | 'employer';
 }
 export declare const NO_ROUNDING: RoundingPolicy;
+/**
+ * An overtime policy as a day sees it, already resolved.
+ *
+ * `computeDay` is pure and stays pure, so which policy applies to this person on this date — and
+ * how much of the cap the year has already used — are answered by the caller against the ladder and
+ * the sheet, and arrive here as numbers. Absent, every minute past the schedule counts, which is
+ * what a workspace with no overtime policy means.
+ */
+export interface OvertimePolicy {
+    /** Minutes past the schedule before overtime starts counting. */
+    thresholdMinutes: number;
+    /** Cap for the containing period, in minutes. Null is uncapped. */
+    capMinutes: number | null;
+    /** Overtime already counted in that period, on days before this one. */
+    alreadyCountedMinutes: number;
+}
 export type PunchDirection = 'in' | 'out' | 'break_start' | 'break_end';
 export interface PunchInput {
     /** The instant, server-stamped. Milliseconds since the epoch. */
@@ -42,6 +58,18 @@ export interface DayComputation {
     workedMinutes: number;
     breakMinutes: number;
     overtimeMinutes: number;
+    /**
+     * Hours worked past the schedule that the cap would not take.
+     *
+     * Reported rather than dropped: a jurisdiction capping overtime caps what may be *worked*, so
+     * these are hours somebody actually put in and a compliance report has to be able to sum them.
+     *
+     * **Null and zero say different things.** Null is no cap in force — nothing to exceed, and
+     * nothing a report should count as compliant. Zero is a cap in force that this day stayed inside.
+     * Only the policy separates them, so the distinction is drawn here rather than re-derived
+     * wherever the number is stored.
+     */
+    beyondCapMinutes: number | null;
     lateMinutes: number;
     earlyLeaveMinutes: number;
     status: 'present' | 'absent' | 'partial' | 'pending';
@@ -58,18 +86,94 @@ export interface DayComputation {
  */
 export declare const crossesMidnight: (shift: ShiftSpec) => boolean;
 /**
- * Which business day a punch belongs to.
+ * Whether a shift is already running, by business date — the fact a clock reading cannot supply.
+ *
+ * Both are read from punches already filed: a clock-in with no clock-out after it. Gathering them is
+ * the caller's job and deciding what they mean is this file's, the same split `computeDay` already
+ * makes with the punches themselves.
+ */
+export interface OpenShifts {
+    /** A shift left open on the punch's own local date. */
+    onLocalDate: boolean;
+    /** A shift left open on the date before it — the night that may still be running. */
+    onPreviousDate: boolean;
+    /**
+     * The previous date already holds punches, open or closed.
+     *
+     * Distinct from `onPreviousDate`, and the difference is a day sheet nobody can explain. A night
+     * worked 22:00–05:30 and clocked out of is *closed*, so it is not open — but it is also not
+     * waiting for anybody, and an arrival at 05:50 that joined it rewrote a finished Friday from
+     * 450 minutes to 1060, with four punches and nine hours of overtime, from somebody turning up
+     * early for Saturday.
+     */
+    workedPreviousDate: boolean;
+}
+/** Nobody is mid-shift and nothing was worked yesterday, so every punch is an arrival. */
+export declare const NOTHING_OPEN: OpenShifts;
+/**
+ * What one business date's punches say about whether a shift, and a break, are still running.
+ *
+ * One reduction behind three questions that must never disagree: which shift the next punch joins,
+ * whether the transition it asks for is possible, and what the clock widget tells the person before
+ * they press anything. Rows have to arrive sorted by instant. `out` closes a break as well as a
+ * shift, because somebody who clocks out without ending their break has still stopped working.
+ */
+export declare function openState(punches: Array<{
+    direction: string;
+}>): {
+    clockedIn: boolean;
+    onBreak: boolean;
+};
+/**
+ * Which shift a punch belongs to, and the business date that follows from it.
+ *
+ * A punch in the morning between a night shift and a day shift has two readings and **the clock
+ * cannot separate them**: at 06:59 on a Saturday, somebody who worked the 22:00–06:00 night is
+ * leaving it, and somebody who did not is arriving early for the 08:00 morning. Three versions of
+ * this function drew a line through that window — at the night's scheduled end, at the morning's
+ * start, at the midpoint of the gap widened by `graceInMinutes` — and every one of them filed one of
+ * those two people on the wrong day, one minute either side of wherever the line had moved to. There
+ * is no line to draw. What separates the two readings is not in the instant.
+ *
+ * It is in the punches. A shift is **open** when a clock-in has been filed on a business date with
+ * nothing closing it, and at most one shift is open at a time, because a person is in one place. So:
  *
- * For a day shift, the local date. For a night shift, **the date the shift started**: somebody
- * clocking out at 06:00 on Tuesday finished Monday's shift, and putting those minutes on Tuesday
- * leaves Monday short and Tuesday long — which is how a month's total comes out right while every
- * individual day is wrong.
+ * 1. **A departure belongs to the shift it is leaving.** Where a shift is open the punch joins it,
+ *    however far past the scheduled end it is made, because nothing else can close it. The most
+ *    recent open one wins: that is the shift they are actually on.
+ * 2. **Everything else is an arrival**, and it opens the shift the clock says is running — the
+ *    previous night while that night is still scheduled to run and the day's own shift has not
+ *    started yet, otherwise the day it happened on.
  *
- * The zone is the person's, from their primary office. A punch on a business trip records the zone
- * it happened in for audit but is still attributed here, or a week abroad splits somebody's month
- * across two calendars.
+ * An open shift is a fact in the database rather than a guess about an instant, which is why this
+ * degrades correctly at both ends where a boundary could not: somebody who never clocked in last
+ * night has nothing open, so their early arrival is an arrival at any hour, and somebody who worked
+ * the night has something open, so their late departure is a departure however long they overran.
+ * No constant appears in either rule, so there is no minute left to get wrong.
+ *
+ * Rule (1) reaches exactly one calendar day back, and that is what stops a shift nobody ever closed
+ * claiming punches for ever: a day later the date in between holds no punches, nothing is open, and
+ * arrivals resume. Until then the person is *told* they are still clocked in, because
+ * `attendance.state` reads this same attribution from the same rows — so the action offered to them
+ * is the one that closes it, and no refusal arrives that the screen did not predict.
+ *
+ * One thing stays undecided, and it costs a date rather than a refusal. Where the night was NEVER
+ * WORKED — nothing open and nothing filed — a punch inside its scheduled span reads as a late
+ * arrival for it: at 05:59 that files a two-hour-early arrival for the morning on the night's date.
+ * Both ends of that shift still land together, since the clock-out follows the shift the clock-in
+ * opened, so nobody is turned away. The sheet is wrong about which day, and says somebody was very
+ * late for a shift they were in fact early for.
+ *
+ * It is left because nothing available at that instant settles it: at 05:59 a person with a night
+ * scheduled and nothing filed is either eleven minutes from the end of a shift they never started
+ * or two hours early for the next one, and only the clock-out — which has not happened — tells them
+ * apart. Deciding it on how much of the night is left would be a fourth constant, and three have
+ * been tried. A night already worked is a different question and is answered above.
  */
-export declare function businessDateFor(instantMs: number, timeZone: string, shift: ShiftSpec | null): IsoDate;
+export declare function attributeToShift(instantMs: number, timeZone: string, shiftFor: (date: IsoDate) => ShiftSpec | null, open: OpenShifts): {
+    businessDate: IsoDate;
+    shift: ShiftSpec | null;
+};
 /**
  * The scheduled span of a shift on a date — computed from instants, not from clock readings.
  *
@@ -92,6 +196,8 @@ export declare function computeDay(opts: {
     shift: ShiftSpec | null;
     punches: PunchInput[];
     rounding?: RoundingPolicy;
+    /** The resolved overtime policy. Absent, everything past the schedule is overtime. */
+    overtime?: OvertimePolicy;
     /** Approved leave or a holiday: not an absence, whatever the punches say. */
     excused?: boolean;
 }): DayComputation;

package/dist/policy/working-time.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"working-time.d.ts","sourceRoot":"","sources":["../../src/policy/working-time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAGnD;;;;;;GAMG;AAEH,wGAAwG;AACxG,MAAM,WAAW,SAAS;IACxB,cAAc;IACd,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAA;IACX,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAA;IACpB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAA;IACtB,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;CAC/C;AAED,eAAO,MAAM,WAAW,EAAE,cAAyD,CAAA;AAEnF,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,KAAK,GAAG,aAAa,GAAG,WAAW,CAAA;AAEvE,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,cAAc,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,OAAO,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;IACpD,2EAA2E;IAC3E,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,SAAS,KAAG,OAAyD,CAAA;AAO5G;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAWrG;AAwBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAK5F;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,YAAY,EAAE,OAAO,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,cAAc,CA8GjB"}
+{"version":3,"file":"working-time.d.ts","sourceRoot":"","sources":["../../src/policy/working-time.ts"],"names":[],"mappings":"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"}

package/dist/policy/working-time.js

@@ -1,3 +1,6 @@
+// Overtime lives beside the accrual arithmetic because a capped hour often becomes compensatory
+// leave rather than pay. It is the same function either way, so it is imported rather than copied.
+import { overtimeFor } from './accrual.js';
 import { dateIn, minutesOfDayIn, nextDate, previousDate, zonedToInstant } from './time.js';
 export const NO_ROUNDING = { stepMinutes: 0, direction: 'nearest' };
 /**
@@ -11,29 +14,108 @@ const toMinutes = (wall) => {
     const [h, m] = wall.split(':').map(Number);
     return h * 60 + m;
 };
+/** Nobody is mid-shift and nothing was worked yesterday, so every punch is an arrival. */
+export const NOTHING_OPEN = {
+    onLocalDate: false,
+    onPreviousDate: false,
+    workedPreviousDate: false,
+};
+/**
+ * What one business date's punches say about whether a shift, and a break, are still running.
+ *
+ * One reduction behind three questions that must never disagree: which shift the next punch joins,
+ * whether the transition it asks for is possible, and what the clock widget tells the person before
+ * they press anything. Rows have to arrive sorted by instant. `out` closes a break as well as a
+ * shift, because somebody who clocks out without ending their break has still stopped working.
+ */
+export function openState(punches) {
+    let clockedIn = false;
+    let onBreak = false;
+    for (const punch of punches) {
+        if (punch.direction === 'in')
+            clockedIn = true;
+        else if (punch.direction === 'out') {
+            clockedIn = false;
+            onBreak = false;
+        }
+        else if (punch.direction === 'break_start')
+            onBreak = true;
+        else if (punch.direction === 'break_end')
+            onBreak = false;
+    }
+    return { clockedIn, onBreak };
+}
 /**
- * Which business day a punch belongs to.
+ * Which shift a punch belongs to, and the business date that follows from it.
  *
- * For a day shift, the local date. For a night shift, **the date the shift started**: somebody
- * clocking out at 06:00 on Tuesday finished Monday's shift, and putting those minutes on Tuesday
- * leaves Monday short and Tuesday long — which is how a month's total comes out right while every
- * individual day is wrong.
+ * A punch in the morning between a night shift and a day shift has two readings and **the clock
+ * cannot separate them**: at 06:59 on a Saturday, somebody who worked the 22:00–06:00 night is
+ * leaving it, and somebody who did not is arriving early for the 08:00 morning. Three versions of
+ * this function drew a line through that window — at the night's scheduled end, at the morning's
+ * start, at the midpoint of the gap widened by `graceInMinutes` — and every one of them filed one of
+ * those two people on the wrong day, one minute either side of wherever the line had moved to. There
+ * is no line to draw. What separates the two readings is not in the instant.
  *
- * The zone is the person's, from their primary office. A punch on a business trip records the zone
- * it happened in for audit but is still attributed here, or a week abroad splits somebody's month
- * across two calendars.
+ * It is in the punches. A shift is **open** when a clock-in has been filed on a business date with
+ * nothing closing it, and at most one shift is open at a time, because a person is in one place. So:
+ *
+ * 1. **A departure belongs to the shift it is leaving.** Where a shift is open the punch joins it,
+ *    however far past the scheduled end it is made, because nothing else can close it. The most
+ *    recent open one wins: that is the shift they are actually on.
+ * 2. **Everything else is an arrival**, and it opens the shift the clock says is running — the
+ *    previous night while that night is still scheduled to run and the day's own shift has not
+ *    started yet, otherwise the day it happened on.
+ *
+ * An open shift is a fact in the database rather than a guess about an instant, which is why this
+ * degrades correctly at both ends where a boundary could not: somebody who never clocked in last
+ * night has nothing open, so their early arrival is an arrival at any hour, and somebody who worked
+ * the night has something open, so their late departure is a departure however long they overran.
+ * No constant appears in either rule, so there is no minute left to get wrong.
+ *
+ * Rule (1) reaches exactly one calendar day back, and that is what stops a shift nobody ever closed
+ * claiming punches for ever: a day later the date in between holds no punches, nothing is open, and
+ * arrivals resume. Until then the person is *told* they are still clocked in, because
+ * `attendance.state` reads this same attribution from the same rows — so the action offered to them
+ * is the one that closes it, and no refusal arrives that the screen did not predict.
+ *
+ * One thing stays undecided, and it costs a date rather than a refusal. Where the night was NEVER
+ * WORKED — nothing open and nothing filed — a punch inside its scheduled span reads as a late
+ * arrival for it: at 05:59 that files a two-hour-early arrival for the morning on the night's date.
+ * Both ends of that shift still land together, since the clock-out follows the shift the clock-in
+ * opened, so nobody is turned away. The sheet is wrong about which day, and says somebody was very
+ * late for a shift they were in fact early for.
+ *
+ * It is left because nothing available at that instant settles it: at 05:59 a person with a night
+ * scheduled and nothing filed is either eleven minutes from the end of a shift they never started
+ * or two hours early for the next one, and only the clock-out — which has not happened — tells them
+ * apart. Deciding it on how much of the night is left would be a fourth constant, and three have
+ * been tried. A night already worked is a different question and is answered above.
  */
-export function businessDateFor(instantMs, timeZone, shift) {
-    const localDate = dateIn(instantMs, timeZone);
-    if (!shift || !crossesMidnight(shift))
-        return localDate;
-    const minutes = minutesOfDayIn(instantMs, timeZone);
-    const startMin = toMinutes(shift.start);
-    const endMin = toMinutes(shift.end);
-    // Anything in the small hours up to a margin past the shift's end belongs to the previous day, so
-    // a late clock-out is still attributed to the shift it actually finished.
-    const tail = Math.min(startMin, endMin + 240);
-    return minutes < tail ? previousDate(localDate) : localDate;
+export function attributeToShift(instantMs, timeZone, shiftFor, open) {
+    const local = dateIn(instantMs, timeZone);
+    const yesterday = previousDate(local);
+    // (1) A departure. Deliberately before anything reads the clock: an open shift outranks every
+    // schedule, including one that says this punch is hours past when the night should have ended.
+    if (open.onLocalDate)
+        return { businessDate: local, shift: shiftFor(local) };
+    if (open.onPreviousDate)
+        return { businessDate: yesterday, shift: shiftFor(yesterday) };
+    // (2) An arrival. The previous night still holds the small hours — somebody clocking in at 02:00
+    // is late for last night's shift, not early for tonight's — but only while it is scheduled to be
+    // running and only until the day's own shift starts, so overlapping schedules go to the one that
+    // began most recently.
+    const own = shiftFor(local);
+    const overnight = shiftFor(yesterday);
+    // A night already worked is not waiting for anybody. `open` is false either way once it is
+    // clocked out of, so without this an early arrival for the morning joined a finished night and
+    // rewrote its sheet — the one thing this function's own comment promised could not happen.
+    if (overnight && crossesMidnight(overnight) && !open.workedPreviousDate) {
+        const minute = minutesOfDayIn(instantMs, timeZone);
+        const dayStart = own ? toMinutes(own.start) : Number.POSITIVE_INFINITY;
+        if (minute < toMinutes(overnight.end) && minute < dayStart)
+            return { businessDate: yesterday, shift: overnight };
+    }
+    return { businessDate: local, shift: own };
 }
 /**
  * Round a **worked total** to the policy's step.
@@ -81,6 +163,7 @@ export function scheduledMinutesOn(date, timeZone, shift) {
 export function computeDay(opts) {
     const { businessDate, timeZone, shift, excused } = opts;
     const rounding = opts.rounding ?? NO_ROUNDING;
+    const capMinutes = opts.overtime?.capMinutes ?? null;
     const punches = [...opts.punches].sort((a, b) => a.at - b.at);
     const anomalies = [];
     const scheduledMinutes = shift ? scheduledMinutesOn(businessDate, timeZone, shift) : 0;
@@ -91,6 +174,7 @@ export function computeDay(opts) {
             workedMinutes: 0,
             breakMinutes: 0,
             overtimeMinutes: 0,
+            beyondCapMinutes: capMinutes === null ? null : 0,
             lateMinutes: 0,
             earlyLeaveMinutes: 0,
             status: excused ? 'present' : scheduledMinutes > 0 ? 'absent' : 'present',
@@ -167,7 +251,22 @@ export function computeDay(opts) {
         const scheduledEnd = zonedToInstant(endDate, shift.end, timeZone);
         earlyLeaveMinutes = Math.max(0, Math.round((scheduledEnd - lastOut) / 60000) - shift.graceOutMinutes);
     }
-    const overtimeMinutes = Math.max(0, workedMinutes - scheduledMinutes);
+    // The threshold and the cap an admin configured, applied here rather than validated on save and
+    // then ignored: `max(0, worked - scheduled)` obeyed neither, so a 30-minute threshold and the
+    // Turkish 270-hour annual cap both saved successfully and changed nothing.
+    const overtime = overtimeFor({
+        workedMinutes,
+        scheduledMinutes,
+        thresholdMinutes: opts.overtime?.thresholdMinutes ?? 0,
+        capMinutes,
+        alreadyCountedMinutes: opts.overtime?.alreadyCountedMinutes ?? 0,
+    });
+    const overtimeMinutes = overtime.overtimeMinutes;
+    const beyondCapMinutes = capMinutes === null ? null : overtime.beyondCapMinutes;
+    // The number is for a report to sum; this is what puts it in front of the person reviewing the
+    // day. Both are derived here, from the same value, so the two cannot disagree about one fact.
+    if (beyondCapMinutes)
+        anomalies.push('overtime_beyond_cap');
     const status = anomalies.includes('missing_clock_out')
         ? 'pending'
         : workedMinutes > 0
@@ -179,6 +278,7 @@ export function computeDay(opts) {
         workedMinutes,
         breakMinutes: Math.round(breakMs / 60000),
         overtimeMinutes,
+        beyondCapMinutes,
         lateMinutes,
         earlyLeaveMinutes,
         status,

package/dist/policy/working-time.js.map

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

package/dist/server/jobs.d.ts

@@ -1,16 +1,24 @@
 import type { JobDef } from '@kernhq/kernel';
-import { inArray } from 'drizzle-orm';
-import { offices } from './schema.js';
-import { todayIn } from './services/db.js';
 /**
  * HR's scheduled work.
  *
  * One rule runs through all of it: **a cron expression fires in UTC, and this module's users do
  * not live there.** A nightly job at 00:00 UTC closes an Amsterdam shift at 01:00 and an Istanbul
  * one at 03:00, and gets Tehran's half-hour offset wrong in a way nobody would ever guess from the
- * code. So the jobs run hourly and fan out per office, deciding for each whether *that office's*
- * local boundary has passed.
+ * code. So the two calendar jobs — `accrue-leave` and `carry-forward` — run hourly and fan out per
+ * office, asking each whether *that office's* local boundary has passed.
+ *
+ * That was the comment for months while no handler read the offices table: `accrue-leave` fired
+ * once a month and asked Postgres for `date_trunc('month', now())`, which is the database session's
+ * timezone, so a New York office was credited January's accrual at 21:00 on 31 January local. A
+ * boundary is a date in a zone, so it is `todayIn(office.timezone)` and nothing else.
+ *
+ * Running hourly means a handler is entered twenty-four times for every boundary it acts on, so
+ * each is idempotent by construction rather than by scheduling: the ledger is asked what it already
+ * holds before anything is written.
+ *
+ * `auto-clock-out` is the exception, and says so where it lives: an elapsed hour is the same hour in
+ * every zone, so an office decides which *zone* its punch is stamped in, not when the sweep fires.
  */
 export declare function hrJobs(): JobDef[];
-export { inArray, offices, todayIn };
 //# sourceMappingURL=jobs.d.ts.map

package/dist/server/jobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/server/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAU,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAW,OAAO,EAAoB,MAAM,aAAa,CAAA;AAEhE,OAAO,EAKL,OAAO,EAIR,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAK1C;;;;;;;;GAQG;AACH,wBAAgB,MAAM,IAAI,MAAM,EAAE,CAwYjC;AAeD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA"}
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/server/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,gBAAgB,CAAA;AA6BxD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,IAAI,MAAM,EAAE,CAqmBjC"}