@zukhruf/sqlite-queue 0.0.0-stage → 0.3.41

package/dist/timekeeper.js

@@ -0,0 +1,305 @@
+import { EventEmitter } from 'node:events';
+import { setImmediate } from 'node:timers/promises';
+import { CronExpressionParser } from 'cron-parser';
+import { scheduleKinds, scheduleMissedPolicies } from 'pg-boss';
+import { transaction } from '@zukhruf/sqlite-transaction';
+import { ClaimTimer } from "./claim-timer.js";
+import { InFlight } from "./in-flight.js";
+import { NaiveTimestamp } from "./naive-timestamp.js";
+import { Recurrence } from "./recurrence.js";
+import { Row } from "./rows.js";
+import { SqlValues } from "./sql-values.js";
+// pg-boss's Timekeeper (node_modules/pg-boss/dist/timekeeper.js) without the
+// clock-skew loop (SQLite's clock is the database clock), invalid_schedule
+// warnings, kind relabels and last_job_id: only schedule() writes a row, so
+// no row is unreadable or mislabelled, and no method of the queue reads one
+// back. A pass every cronMonitorIntervalSeconds claims the instance-wide
+// cron stamp, files each schedule's due occurrences in __pgboss__send-it, one
+// job per minute slot, and the send-it worker forwards each to its queue.
+export class Timekeeper extends EventEmitter {
+    // timekeeper.js:12-14
+    static sendIt = '__pgboss__send-it';
+    // timekeeper.js:46: how long an occurrence stays due, and the width of the
+    // slot its job is filed in.
+    static #occurrenceWindowSeconds = 60;
+    // timekeeper.js:48
+    static #missedPolicies = Object.values(scheduleMissedPolicies);
+    #clock;
+    #activity;
+    #config;
+    #manager;
+    #phase = { kind: 'stopped' };
+    // pg-boss's _timekeeping: the pass in flight.
+    #pass = null;
+    constructor(clock, activity, config, manager) {
+        super();
+        this.#clock = clock;
+        this.#activity = activity;
+        this.#config = config;
+        this.#manager = manager;
+    }
+    // timekeeper.js:66-68: the name's underscores escaped, so the first
+    // unescaped underscore pair is the separator.
+    static #occurrenceKey(name, key) {
+        return `${name.replaceAll('_', '\\_')}__${key}`;
+    }
+    // timekeeper.js:76-79
+    static #throttleSlot(instant) {
+        const width = Timekeeper.#occurrenceWindowSeconds * 1000;
+        return new Date(Math.floor(instant.getTime() / width) * width)
+            .toISOString()
+            .replace('T', ' ')
+            .slice(0, 19);
+    }
+    // timekeeper.js:105-112: SQLite hands timestamps back as the text it
+    // stored.
+    static #toTime(value) {
+        if (value === null) {
+            return null;
+        }
+        const time = new Date(value).getTime();
+        return Number.isNaN(time) ? null : time;
+    }
+    // timekeeper.js:145-150
+    static #missedPolicy(options) {
+        const missed = typeof options === 'object' && options !== null && 'missed' in options
+            ? options.missed
+            : undefined;
+        return missed !== undefined && Timekeeper.#missedPolicies.includes(missed)
+            ? missed
+            : scheduleMissedPolicies.skip;
+    }
+    // timekeeper.js:241-262. The first pass runs on a real setImmediate, as
+    // pg-boss's does, then every cronMonitorIntervalSeconds on the clock.
+    async start(database) {
+        if (this.#phase.kind === 'keeping') {
+            return;
+        }
+        await this.#manager.createQueue(Timekeeper.sendIt);
+        await this.#manager.work(Timekeeper.sendIt, {
+            pollingIntervalSeconds: this.#config.cronWorkerIntervalSeconds,
+            batchSize: 50,
+        }, (jobs) => this.#onSendIt(jobs));
+        void setImmediate().then(() => this.#onCron());
+        this.#phase = {
+            kind: 'keeping',
+            database,
+            timer: new ClaimTimer(this.#clock, this.#config.cronMonitorIntervalSeconds, () => this.#onCron()),
+        };
+    }
+    // timekeeper.js:263-280, which polls its pass flag every 10 ms of real
+    // time.
+    async stop() {
+        const phase = this.#phase;
+        if (phase.kind !== 'keeping') {
+            return;
+        }
+        this.#phase = { kind: 'stopped' };
+        await this.#manager.offWork(Timekeeper.sendIt, { wait: true });
+        phase.timer.stop();
+        await this.#pass?.settled();
+    }
+    // timekeeper.js:335-384
+    async #onCron() {
+        if (this.#phase.kind !== 'keeping' || this.#pass) {
+            return;
+        }
+        const pass = this.#cronPass(this.#phase);
+        this.#pass = new InFlight(pass);
+        try {
+            await pass;
+        }
+        finally {
+            this.#pass = null;
+        }
+    }
+    async #cronPass(phase) {
+        try {
+            const { priorCronOn, elapsed, claimed } = await this.#activity.query(() => Timekeeper.#trySetCronTime(phase.database, this.#config.cronMonitorIntervalSeconds, new Date(this.#clock.now())));
+            if (claimed) {
+                phase.timer.anchor();
+            }
+            else {
+                phase.timer.anchor(this.#claimRetryDelay(elapsed));
+            }
+            if (this.#phase.kind === 'keeping' && claimed) {
+                await this.#cron(phase.database, priorCronOn);
+            }
+        }
+        catch (error) {
+            this.emit('error', error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    // timekeeper.js:406-411: until the claim it lost to comes due, plus a
+    // quarter of the interval capped at a second.
+    #claimRetryDelay(elapsed) {
+        const interval = this.#config.cronMonitorIntervalSeconds * 1000;
+        const age = Number(elapsed);
+        const remaining = Number.isFinite(age) && age > 0
+            ? Math.max(0, interval - age * 1000)
+            : interval;
+        return remaining + Math.min(1000, interval / 4);
+    }
+    // trySetCronTime and trySetTimestamp (plans.js:1078-1086, 1111-1118): the
+    // stamp it replaced and its age, and whether this pass moved it. A stamp
+    // never written counts as a week old.
+    static #trySetCronTime(db, seconds, now) {
+        return transaction(db, () => {
+            const row = Row.parse(db.prepare('SELECT cron_on FROM pgboss_version').get(), 'version');
+            const priorCronOn = Row.readNullableString(row, 'cron_on');
+            const prior = Timekeeper.#toTime(priorCronOn);
+            const elapsed = prior === null ? null : (now.getTime() - prior) / 1000;
+            const claimed = (now.getTime() - (prior ?? now.getTime() - 604_800_000)) / 1000 >=
+                seconds;
+            if (claimed) {
+                db.prepare('UPDATE pgboss_version SET cron_on = ?').run(SqlValues.asIso(now));
+            }
+            return { priorCronOn, elapsed, claimed };
+        }, { mode: 'immediate' });
+    }
+    // timekeeper.js:418-527, one instant for the whole pass.
+    async #cron(db, priorCronOn) {
+        const schedules = await this.#activity.query(() => Timekeeper.#getSchedules(db));
+        const scheduled = [];
+        const databaseTime = this.#clock.now();
+        const windowStart = databaseTime - Timekeeper.#occurrenceWindowSeconds * 1000;
+        const lastPass = Timekeeper.#toTime(priorCronOn);
+        for (const schedule of schedules) {
+            const { name, key, data, options, kind, cron, timezone } = schedule;
+            let due;
+            try {
+                due = Timekeeper.#readOccurrences(cron, kind, timezone, databaseTime);
+            }
+            catch {
+                // timekeeper.js:450-458: one row never decides the others'.
+                continue;
+            }
+            let missed = null;
+            try {
+                missed = Timekeeper.#missedOccurrence(schedule, lastPass, windowStart);
+            }
+            catch {
+                // timekeeper.js:464-474: the gap closes anyway, since the claim has
+                // moved.
+            }
+            // timekeeper.js:503-515: a set of slots, so a missed occurrence and a
+            // due one in the same minute send one job.
+            const slots = new Set();
+            if (missed !== null) {
+                slots.add(Timekeeper.#throttleSlot(missed));
+            }
+            for (const occurrence of due) {
+                slots.add(Timekeeper.#throttleSlot(occurrence));
+            }
+            for (const slot of slots) {
+                scheduled.push({
+                    data: { name, key, data, options, slot },
+                    singletonKey: Timekeeper.#occurrenceKey(name, key),
+                    // The insert casts the slot to a zoneless timestamp
+                    // (plans.js:2258).
+                    singletonOn: NaiveTimestamp.fromUtc(new Date(`${slot}Z`)),
+                });
+            }
+        }
+        if (scheduled.length > 0 && this.#phase.kind === 'keeping') {
+            await this.#manager.insert(Timekeeper.sendIt, scheduled);
+        }
+    }
+    // getSchedules (plans.js:1276-1290), in name and key order.
+    static #getSchedules(db) {
+        return db
+            .prepare(`SELECT queue_name, key, kind, cron, COALESCE(timezone, 'UTC') AS timezone,
+          data, options, created_on
+        FROM pgboss_schedule
+        ORDER BY queue_name, key`)
+            .all()
+            .map((value) => {
+            const row = Row.parse(value, 'schedule');
+            const data = Row.readNullableString(row, 'data');
+            const options = Row.readNullableString(row, 'options');
+            return {
+                name: Row.readString(row, 'queue_name'),
+                key: Row.readString(row, 'key'),
+                kind: Row.readString(row, 'kind'),
+                cron: Row.readString(row, 'cron'),
+                timezone: Row.readString(row, 'timezone'),
+                data: data === null ? null : JSON.parse(data),
+                options: options === null ? null : JSON.parse(options),
+                createdOn: Row.readString(row, 'created_on'),
+            };
+        });
+    }
+    // timekeeper.js:591-601: under `once`, the latest occurrence in
+    // (max(lastPass, createdOn), windowStart], the gap no pass covered.
+    static #missedOccurrence(schedule, lastPass, windowStart) {
+        const { cron, kind, timezone, options, createdOn } = schedule;
+        if (Timekeeper.#missedPolicy(options) === scheduleMissedPolicies.skip ||
+            lastPass === null) {
+            return null;
+        }
+        const from = Math.max(lastPass, Timekeeper.#toTime(createdOn) ?? lastPass);
+        if (from >= windowStart) {
+            return null;
+        }
+        return Timekeeper.#latestOccurrenceBefore(cron, kind, timezone, new Date(from), new Date(windowStart));
+    }
+    // timekeeper.js:610-621. cron-parser's prev() answers strictly before its
+    // reference, so the reference is a millisecond past `until`.
+    static #latestOccurrenceBefore(expression, kind, tz, after, until) {
+        if (kind === scheduleKinds.rrule) {
+            return Recurrence.latestOccurrenceBefore(expression, after, until, tz);
+        }
+        const occurrence = CronExpressionParser.parse(expression, {
+            tz,
+            strict: false,
+            currentDate: new Date(until.getTime() + 1),
+        })
+            .prev()
+            .toDate();
+        return occurrence.getTime() > after.getTime() ? occurrence : null;
+    }
+    // timekeeper.js:639-653: every occurrence in the last minute, a cron
+    // expression's latest only.
+    static #readOccurrences(expression, kind, tz, databaseTime) {
+        const window = new Date(databaseTime - Timekeeper.#occurrenceWindowSeconds * 1000);
+        if (kind === scheduleKinds.rrule) {
+            return Recurrence.occurrencesInWindow(expression, window, new Date(databaseTime), tz);
+        }
+        const previous = CronExpressionParser.parse(expression, {
+            tz,
+            strict: false,
+            currentDate: new Date(databaseTime + 1),
+        })
+            .prev()
+            .toDate();
+        return previous.getTime() > window.getTime() ? [previous] : [];
+    }
+    // timekeeper.js:658-665: an error event nobody listens for must not fail
+    // the send-it job, which would replay every occurrence in its batch.
+    #reportSendItError(error) {
+        try {
+            this.emit('error', error instanceof Error ? error : new Error(String(error)));
+        }
+        catch {
+            // nothing left to report it to
+        }
+    }
+    // timekeeper.js:666-687: each occurrence's request goes to send() without
+    // its key and slot; a send that rejects is reported, and the send-it job
+    // completes either way.
+    async #onSendIt(jobs) {
+        const results = await Promise.allSettled(jobs.map(async ({ data }) => {
+            if (typeof data !== 'object' || data === null) {
+                throw new TypeError('send-it job data must be an object');
+            }
+            const request = Object.fromEntries(Object.entries(data).filter(([field]) => field !== 'key' && field !== 'slot'));
+            return await this.#manager.send(request);
+        }));
+        for (const result of results) {
+            if (result.status === 'rejected') {
+                this.#reportSendItError(result.reason);
+            }
+        }
+    }
+}
+//# sourceMappingURL=timekeeper.js.map

package/dist/timekeeper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timekeeper.js","sourceRoot":"","sources":["../src/timekeeper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAQnD,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA2D5C,6EAA6E;AAC7E,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,8EAA8E;AAC9E,0EAA0E;AAC1E,MAAM,OAAO,UAAW,SAAQ,YAA2C;IACzE,sBAAsB;IACtB,MAAM,CAAU,MAAM,GAAG,mBAAmB,CAAC;IAC7C,2EAA2E;IAC3E,4BAA4B;IAC5B,MAAM,CAAU,wBAAwB,GAAG,EAAE,CAAC;IAC9C,mBAAmB;IACnB,MAAM,CAAU,eAAe,GAAuB,MAAM,CAAC,MAAM,CACjE,sBAAsB,CACvB,CAAC;IAEO,MAAM,CAAQ;IACd,SAAS,CAAW;IACpB,OAAO,CAAmB;IAC1B,QAAQ,CAAoB;IACrC,MAAM,GAAoB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC9C,8CAA8C;IAC9C,KAAK,GAA0B,IAAI,CAAC;IAEpC,YACE,KAAY,EACZ,QAAkB,EAClB,MAAwB,EACxB,OAA0B;QAE1B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,oEAAoE;IACpE,8CAA8C;IAC9C,MAAM,CAAC,cAAc,CAAC,IAAY,EAAE,GAAW;QAC7C,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;IAClD,CAAC;IAED,sBAAsB;IACtB,MAAM,CAAC,aAAa,CAAC,OAAa;QAChC,MAAM,KAAK,GAAG,UAAU,CAAC,wBAAwB,GAAG,IAAI,CAAC;QACzD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;aAC3D,WAAW,EAAE;aACb,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;aACjB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,qEAAqE;IACrE,UAAU;IACV,MAAM,CAAC,OAAO,CAAC,KAAoB;QACjC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IAED,wBAAwB;IACxB,MAAM,CAAC,aAAa,CAAC,OAAgB;QACnC,MAAM,MAAM,GACV,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,IAAI,OAAO;YACpE,CAAC,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,MAAM,KAAK,SAAS,IAAI,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC;YACxE,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC;IAClC,CAAC;IAED,wEAAwE;IACxE,sEAAsE;IACtE,KAAK,CAAC,KAAK,CAAC,QAAsB;QAChC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CACtB,UAAU,CAAC,MAAM,EACjB;YACE,sBAAsB,EAAE,IAAI,CAAC,OAAO,CAAC,yBAAyB;YAC9D,SAAS,EAAE,EAAE;SACd,EACD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAC/B,CAAC;QACF,KAAK,YAAY,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,EAAE,SAAS;YACf,QAAQ;YACR,KAAK,EAAE,IAAI,UAAU,CACnB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,CAAC,0BAA0B,EACvC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CACrB;SACF,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,QAAQ;IACR,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC;QACb,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAGf;QACC,IAAI,CAAC;YACH,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CACxE,UAAU,CAAC,eAAe,CACxB,KAAK,CAAC,QAAQ,EACd,IAAI,CAAC,OAAO,CAAC,0BAA0B,EACvC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAC5B,CACF,CAAC;YACF,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;YACrD,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,EAAE,CAAC;gBAC9C,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CACP,OAAO,EACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,8CAA8C;IAC9C,gBAAgB,CAAC,OAAsB;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;QAChE,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,SAAS,GACb,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;YAC7B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC;YACpC,CAAC,CAAC,QAAQ,CAAC;QACf,OAAO,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,0EAA0E;IAC1E,yEAAyE;IACzE,sCAAsC;IACtC,MAAM,CAAC,eAAe,CAAC,EAAgB,EAAE,OAAe,EAAE,GAAS;QACjE,OAAO,WAAW,CAChB,EAAE,EACF,GAAG,EAAE;YACH,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CACnB,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,EAAE,EACtD,SAAS,CACV,CAAC;YACF,MAAM,WAAW,GAAG,GAAG,CAAC,kBAAkB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;YACvE,MAAM,OAAO,GACX,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC,CAAC,GAAG,IAAI;gBAC/D,OAAO,CAAC;YACV,IAAI,OAAO,EAAE,CAAC;gBACZ,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CACrD,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CACrB,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC3C,CAAC,EACD,EAAE,IAAI,EAAE,WAAW,EAAE,CACtB,CAAC;IACJ,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,KAAK,CAAC,EAAgB,EAAE,WAA0B;QACtD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAChD,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,CAC7B,CAAC;QACF,MAAM,SAAS,GAAiB,EAAE,CAAC;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QACvC,MAAM,WAAW,GACf,YAAY,GAAG,UAAU,CAAC,wBAAwB,GAAG,IAAI,CAAC;QAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACjD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;YACpE,IAAI,GAAW,CAAC;YAChB,IAAI,CAAC;gBACH,GAAG,GAAG,UAAU,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC;gBACP,4DAA4D;gBAC5D,SAAS;YACX,CAAC;YACD,IAAI,MAAM,GAAgB,IAAI,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,GAAG,UAAU,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;YACzE,CAAC;YAAC,MAAM,CAAC;gBACP,oEAAoE;gBACpE,SAAS;YACX,CAAC;YACD,sEAAsE;YACtE,2CAA2C;YAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;YAChC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;YAC9C,CAAC;YACD,KAAK,MAAM,UAAU,IAAI,GAAG,EAAE,CAAC;gBAC7B,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;YAClD,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,SAAS,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;oBACxC,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC;oBAClD,oDAAoD;oBACpD,mBAAmB;oBACnB,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;iBAC1D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3D,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,MAAM,CAAC,aAAa,CAAC,EAAgB;QACnC,OAAO,EAAE;aACN,OAAO,CACN;;;iCAGyB,CAC1B;aACA,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,GAAG,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACvD,OAAO;gBACL,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,YAAY,CAAC;gBACvC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC;gBAC/B,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;gBACjC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;gBACjC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC;gBACzC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC7C,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;gBACtD,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,YAAY,CAAC;aAC7C,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;IAED,gEAAgE;IAChE,oEAAoE;IACpE,MAAM,CAAC,iBAAiB,CACtB,QAAkB,EAClB,QAAuB,EACvB,WAAmB;QAEnB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;QAC9D,IACE,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,sBAAsB,CAAC,IAAI;YACjE,QAAQ,KAAK,IAAI,EACjB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,CAAC;QAC3E,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,UAAU,CAAC,uBAAuB,CACvC,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,IAAI,CAAC,IAAI,CAAC,EACd,IAAI,IAAI,CAAC,WAAW,CAAC,CACtB,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,6DAA6D;IAC7D,MAAM,CAAC,uBAAuB,CAC5B,UAAkB,EAClB,IAAY,EACZ,EAAU,EACV,KAAW,EACX,KAAW;QAEX,IAAI,IAAI,KAAK,aAAa,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,UAAU,CAAC,sBAAsB,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,UAAU,GAAG,oBAAoB,CAAC,KAAK,CAAC,UAAU,EAAE;YACxD,EAAE;YACF,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;SAC3C,CAAC;aACC,IAAI,EAAE;aACN,MAAM,EAAE,CAAC;QACZ,OAAO,UAAU,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;IAED,qEAAqE;IACrE,4BAA4B;IAC5B,MAAM,CAAC,gBAAgB,CACrB,UAAkB,EAClB,IAAY,EACZ,EAAU,EACV,YAAoB;QAEpB,MAAM,MAAM,GAAG,IAAI,IAAI,CACrB,YAAY,GAAG,UAAU,CAAC,wBAAwB,GAAG,IAAI,CAC1D,CAAC;QACF,IAAI,IAAI,KAAK,aAAa,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,UAAU,CAAC,mBAAmB,CACnC,UAAU,EACV,MAAM,EACN,IAAI,IAAI,CAAC,YAAY,CAAC,EACtB,EAAE,CACH,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,UAAU,EAAE;YACtD,EAAE;YACF,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;SACxC,CAAC;aACC,IAAI,EAAE;aACN,MAAM,EAAE,CAAC;QACZ,OAAO,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,yEAAyE;IACzE,qEAAqE;IACrE,kBAAkB,CAAC,KAAc;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CACP,OAAO,EACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,yEAAyE;IACzE,wBAAwB;IACxB,KAAK,CAAC,SAAS,CAAC,IAAoB;QAClC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;YAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC9C,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CACzB,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,CACjD,CACF,CAAC;YACF,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC,CAAC,CACH,CAAC;QACF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACjC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC"}

package/dist/timers.d.ts

@@ -0,0 +1,9 @@
+import type { Clock } from 'pg-boss';
+export type ClockDelay = Promise<void> & {
+    abort(): void;
+};
+export declare class Timers {
+    static delay(clock: Clock, ms: number, error?: string, abortController?: AbortController): ClockDelay;
+    static resolveWithinSeconds<T>(clock: Clock, promise: Promise<T>, seconds: number, message: string, abortController: AbortController): Promise<T | void>;
+}
+//# sourceMappingURL=timers.d.ts.map

package/dist/timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../src/timers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CAAC;AAI3D,qBAAa,MAAM;IAEjB,MAAM,CAAC,KAAK,CACV,KAAK,EAAE,KAAK,EACZ,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,eAAe,GAChC,UAAU;WAiCA,oBAAoB,CAAC,CAAC,EACjC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CASrB"}

package/dist/timers.js

@@ -0,0 +1,50 @@
+// pg-boss's waits, scheduled on the configured clock so a test clock fires
+// them (node_modules/pg-boss/dist/tools.js:32-77).
+export class Timers {
+    // clockDelay: rejects with `error` when the wait runs out, if given.
+    static delay(clock, ms, error, abortController) {
+        const controller = abortController ?? new AbortController();
+        const promise = new Promise((resolve, reject) => {
+            const handle = clock.setTimeout(() => {
+                controller.signal.removeEventListener('abort', onAbort);
+                if (error) {
+                    reject(new Error(error));
+                }
+                else {
+                    resolve();
+                }
+            }, ms);
+            const onAbort = () => {
+                clock.clearTimeout(handle);
+                resolve();
+            };
+            if (controller.signal.aborted) {
+                onAbort();
+            }
+            else {
+                controller.signal.addEventListener('abort', onAbort, { once: true });
+            }
+        });
+        return Object.assign(promise, {
+            abort: () => {
+                if (!controller.signal.aborted) {
+                    controller.abort();
+                }
+            },
+        });
+    }
+    // Races `promise` against `seconds` (at least one), rejecting with
+    // `message` when they run out. Settling aborts the controller either way,
+    // which is how the deadline cancels itself.
+    static async resolveWithinSeconds(clock, promise, seconds, message, abortController) {
+        const timeout = Math.max(1, seconds) * 1000;
+        const deadline = Timers.delay(clock, timeout, message, abortController);
+        try {
+            return await Promise.race([promise, deadline]);
+        }
+        finally {
+            deadline.abort();
+        }
+    }
+}
+//# sourceMappingURL=timers.js.map

package/dist/timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../src/timers.ts"],"names":[],"mappings":"AAKA,2EAA2E;AAC3E,mDAAmD;AACnD,MAAM,OAAO,MAAM;IACjB,qEAAqE;IACrE,MAAM,CAAC,KAAK,CACV,KAAY,EACZ,EAAU,EACV,KAAc,EACd,eAAiC;QAEjC,MAAM,UAAU,GAAG,eAAe,IAAI,IAAI,eAAe,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE;gBACnC,UAAU,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACxD,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,EAAE,EAAE,CAAC,CAAC;YACP,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBAC3B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC9B,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;YAC5B,KAAK,EAAE,GAAG,EAAE;gBACV,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC/B,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,0EAA0E;IAC1E,4CAA4C;IAC5C,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAC/B,KAAY,EACZ,OAAmB,EACnB,OAAe,EACf,OAAe,EACf,eAAgC;QAEhC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;QACxE,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjD,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/uuid.d.ts

@@ -0,0 +1,7 @@
+export declare class Uuid {
+    #private;
+    static canonical(text: string): string;
+    static fromPayload(value: unknown): string;
+    static parameter(value: unknown): string | null;
+}
+//# sourceMappingURL=uuid.d.ts.map

package/dist/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"AAMA,qBAAa,IAAI;;IAIf,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAuBtC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAQ1C,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;CAGhD"}

package/dist/uuid.js

@@ -0,0 +1,36 @@
+import { DatabaseError } from "./database-error.js";
+// Postgres's uuid input, which pg-boss binds every job id through: 32 hex
+// digits in either case, a hyphen allowed after any group of four but the
+// last, optionally in braces, printed lower case as 8-4-4-4-12; any other
+// text is 22P02 (https://www.postgresql.org/docs/current/datatype-uuid.html).
+export class Uuid {
+    static #input = /^(?:\{([0-9a-f]{4}(?:-?[0-9a-f]{4}){7})\}|([0-9a-f]{4}(?:-?[0-9a-f]{4}){7}))$/i;
+    static canonical(text) {
+        const match = Uuid.#input.exec(text);
+        const digits = (match?.[1] ?? match?.[2])
+            ?.replaceAll('-', '')
+            .toLowerCase();
+        if (digits === undefined) {
+            throw new DatabaseError(`invalid input syntax for type uuid: "${text}"`, '22P02');
+        }
+        return [
+            digits.slice(0, 8),
+            digits.slice(8, 12),
+            digits.slice(12, 16),
+            digits.slice(16, 20),
+            digits.slice(20),
+        ].join('-');
+    }
+    // send()'s id, which pg-boss's insert reads out of its JSON payload
+    // (node_modules/pg-boss/dist/plans.js:2303): a string as it is, anything
+    // else as its JSON text.
+    static fromPayload(value) {
+        return Uuid.canonical(typeof value === 'string' ? value : JSON.stringify(value));
+    }
+    // findJobs()'s id, bound as a parameter (plans.js:3694): null is SQL NULL,
+    // which matches no job.
+    static parameter(value) {
+        return value === null ? null : Uuid.canonical(String(value));
+    }
+}
+//# sourceMappingURL=uuid.js.map

package/dist/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,8EAA8E;AAC9E,MAAM,OAAO,IAAI;IACf,MAAM,CAAU,MAAM,GACpB,gFAAgF,CAAC;IAEnF,MAAM,CAAC,SAAS,CAAC,IAAY;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YACvC,EAAE,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;aACpB,WAAW,EAAE,CAAC;QACjB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,aAAa,CACrB,wCAAwC,IAAI,GAAG,EAC/C,OAAO,CACR,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YAClB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;SACjB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,yEAAyE;IACzE,yBAAyB;IACzB,MAAM,CAAC,WAAW,CAAC,KAAc;QAC/B,OAAO,IAAI,CAAC,SAAS,CACnB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAC1D,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,wBAAwB;IACxB,MAAM,CAAC,SAAS,CAAC,KAAc;QAC7B,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC"}

package/dist/worker.d.ts

@@ -0,0 +1,35 @@
+import type { Clock, WipData, WorkOptions } from 'pg-boss';
+export type WorkerOptions = WorkOptions & {
+    pollingInterval: number;
+    notifyPollingInterval: number;
+};
+export interface WorkerConfig<TJob> {
+    id: string;
+    workId: string;
+    name: string;
+    options: WorkerOptions;
+    clock: Clock;
+    resolveInterval: (lastFetchCount: number) => number;
+    fetch: () => Promise<TJob[]>;
+    onFetch: (jobs: TJob[]) => Promise<void>;
+    onError: (error: Error) => void;
+}
+export declare class Worker<TJob> {
+    #private;
+    readonly id: string;
+    readonly workId: string;
+    readonly name: string;
+    readonly options: WorkerOptions;
+    readonly createdOn: number;
+    jobs: TJob[];
+    abortController: AbortController | null;
+    constructor(config: WorkerConfig<TJob>);
+    get stopping(): boolean;
+    get stopped(): boolean;
+    start(): void;
+    notify(): void;
+    abort(): void;
+    stop(): Promise<void>;
+    toWipData(): WipData;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAe,MAAM,SAAS,CAAC;AAQxE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,WAAW,YAAY,CAAC,IAAI;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7B,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAKD,qBAAa,MAAM,CAAC,IAAI;;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,IAAI,EAAE,IAAI,EAAE,CAAM;IAElB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;gBAqBnC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC;IAatC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAKD,KAAK,IAAI,IAAI;IAsDb,MAAM,IAAI,IAAI;IAMd,KAAK,IAAI,IAAI;IASP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,SAAS,IAAI,OAAO;CAiBrB"}

package/dist/worker.js

@@ -0,0 +1,147 @@
+import { Latch } from '@zukhruf/async';
+import { Timers } from "./timers.js";
+// One polling loop of a work() call, which starts one per localConcurrency
+// (node_modules/pg-boss/dist/worker.js:53-114): fetch at once, hand the jobs
+// over, then wait out the interval on the clock unless notified meanwhile.
+export class Worker {
+    id;
+    // The id work() returned, shared by every loop it started.
+    workId;
+    name;
+    options;
+    createdOn;
+    // The batch in flight, which a shutdown fails (manager.js:884-909).
+    jobs = [];
+    // The batch's controller while it runs, which a shutdown aborts.
+    abortController = null;
+    #clock;
+    #resolveInterval;
+    #fetch;
+    #onFetch;
+    #onError;
+    #state = 'created';
+    // pg-boss's #beenNotified, cleared as each round starts: notify() counts,
+    // and a round was notified when the count moved since it started.
+    #notifications = 0;
+    // Aborts the round's wait; a fresh one arms each wait.
+    #wake = new AbortController();
+    // How the loop ended, which stop() waits for.
+    #ran = new Latch();
+    #lastFetchedOn = null;
+    #lastJobStartedOn = null;
+    #lastJobEndedOn = null;
+    #lastJobDuration = null;
+    #lastError = null;
+    #lastErrorOn = null;
+    constructor(config) {
+        this.id = config.id;
+        this.workId = config.workId;
+        this.name = config.name;
+        this.options = config.options;
+        this.#clock = config.clock;
+        this.createdOn = config.clock.now();
+        this.#resolveInterval = config.resolveInterval;
+        this.#fetch = config.fetch;
+        this.#onFetch = config.onFetch;
+        this.#onError = config.onError;
+    }
+    get stopping() {
+        return this.#state === 'stopping';
+    }
+    get stopped() {
+        return this.#state === 'stopped';
+    }
+    // pg-boss keeps the loop's promise for stop() to await (worker.js:51, 113):
+    // a loop that rejects, for example on an error emit with no listener,
+    // rejects the stop that waits for it, and is unhandled when no stop waits.
+    start() {
+        void this.#run().then(() => this.#ran.open({ ok: true }), (error) => {
+            this.#ran.open({ ok: false, error });
+            if (!this.stopping) {
+                throw error;
+            }
+        });
+    }
+    async #run() {
+        // A stop() before start() leaves the loop at once.
+        if (this.#state === 'created') {
+            this.#state = 'active';
+        }
+        while (!this.stopping) {
+            const started = this.#clock.now();
+            // Stays 0 on an error, so a failed fetch backs off to the normal poll.
+            let fetchedCount = 0;
+            const notifications = this.#notifications;
+            try {
+                const jobs = await this.#fetch();
+                this.#lastFetchedOn = this.#clock.now();
+                fetchedCount = jobs.length;
+                this.jobs = jobs;
+                this.#lastJobStartedOn = this.#lastFetchedOn;
+                await this.#onFetch(jobs);
+                this.#lastJobEndedOn = this.#clock.now();
+                this.jobs = [];
+            }
+            catch (caught) {
+                this.#lastErrorOn = this.#clock.now();
+                const error = caught instanceof Error ? caught : new Error(String(caught));
+                this.#lastError = error;
+                error.message = `${error.message} (Queue: ${this.name}, Worker: ${this.id})`;
+                this.#onError(error);
+            }
+            const duration = this.#clock.now() - started;
+            this.#lastJobDuration = duration;
+            const remaining = this.#resolveInterval(fetchedCount) - duration;
+            if (!this.stopping &&
+                this.#notifications === notifications &&
+                remaining > 100) {
+                this.#wake = new AbortController();
+                await Timers.delay(this.#clock, remaining, undefined, this.#wake);
+            }
+        }
+        this.#state = 'stopped';
+    }
+    notify() {
+        this.#notifications += 1;
+        this.#wake.abort();
+    }
+    // worker.js:115-122
+    abort() {
+        if (!this.abortController) {
+            return;
+        }
+        if (!this.abortController.signal.aborted) {
+            this.abortController.abort();
+        }
+    }
+    async stop() {
+        if (this.stopped) {
+            return;
+        }
+        this.#state = 'stopping';
+        this.#wake.abort();
+        const ran = await this.#ran.wait();
+        if (!ran.ok) {
+            throw ran.error;
+        }
+    }
+    // worker.js:123-139
+    toWipData() {
+        return {
+            id: this.id,
+            workId: this.workId,
+            name: this.name,
+            options: this.options,
+            state: this.#state,
+            count: this.jobs.length,
+            createdOn: this.createdOn,
+            lastFetchedOn: this.#lastFetchedOn,
+            lastJobStartedOn: this.#lastJobStartedOn,
+            lastJobEndedOn: this.#lastJobEndedOn,
+            lastError: this.#lastError,
+            lastErrorOn: this.#lastErrorOn,
+            lastJobDuration: this.#lastJobDuration,
+        };
+    }
+}
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

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