@zukhruf/sqlite-queue 0.0.0-stage → 0.3.42

package/dist/start-after.js

@@ -0,0 +1,125 @@
+// A startAfter string pg-boss would hand to Postgres's own timestamp or
+// interval grammar, outside the subset this queue resolves itself.
+export class UnsupportedStartAfterError extends Error {
+    name = 'UnsupportedStartAfterError';
+    startAfter;
+    constructor(startAfter) {
+        super(`startAfter "${startAfter}" is outside the supported forms: a Date, seconds, an ISO 8601 date time or duration, or Postgres interval units with integer amounts`);
+        this.startAfter = startAfter;
+    }
+}
+// pg-boss normalizes startAfter in Attorney.checkSendArgs
+// (node_modules/pg-boss/dist/attorney.js:108-116, 140-146), then casts a
+// date time string as timestamptz and anything else as an interval added to
+// now (plans.js:2228-2230, 2299-2302). This resolves the same normalization
+// and a cited subset of what Postgres then parses; every supported form is
+// proven equal to pg-boss in the parity suite (src/parity).
+export class StartAfter {
+    static #isoDate = /^\d{4}-\d{2}-\d{2}/;
+    static #zonelessTime = /^(?:[T ]\d{2}(?::\d{2}(?::\d{2}(?:[.,]\d+)?)?)?)?$/;
+    static #dateTime = /^(\d{4}-\d{2}-\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d+))?)?)?(Z|[+-]\d{2}(?::?\d{2})?)$/;
+    static #seconds = /^[+-]?\d+(?:\.\d+)?$/;
+    static #isoDuration = /^P(?:(\d+)Y)?(?:(\d+)M)?(?:(\d+)W)?(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/;
+    static #unitsShape = /^(?:\d+\s*[a-z]+\s*)+$/i;
+    static #unitPairs = /(\d+)\s*([a-z]+)/gi;
+    // Postgres interval units with integer amounts, as the field they add to.
+    static #unitScales = new Map([
+        ...['second', 'seconds', 'sec', 'secs'].map((unit) => [unit, { field: 'milliseconds', size: 1000 }]),
+        ...['minute', 'minutes', 'min', 'mins'].map((unit) => [unit, { field: 'milliseconds', size: 60_000 }]),
+        ...['hour', 'hours', 'hr', 'hrs'].map((unit) => [unit, { field: 'milliseconds', size: 3_600_000 }]),
+        ...['day', 'days'].map((unit) => [unit, { field: 'days', size: 1 }]),
+        ...['week', 'weeks'].map((unit) => [unit, { field: 'days', size: 7 }]),
+        ...['month', 'months', 'mon', 'mons'].map((unit) => [unit, { field: 'months', size: 1 }]),
+        ...['year', 'years', 'yr', 'yrs'].map((unit) => [unit, { field: 'months', size: 12 }]),
+    ]);
+    static resolve(value, now) {
+        const normalized = StartAfter.#normalize(value);
+        if (normalized === undefined) {
+            return now;
+        }
+        // Errors name the caller's own value, not its normalized form.
+        const original = typeof value === 'string' ? value : normalized;
+        // plans.js:2228-2230: a string ending in Z or starting with a date is a
+        // timestamp, anything else an interval.
+        if (normalized.endsWith('Z') || StartAfter.#isoDate.test(normalized)) {
+            return StartAfter.#timestamp(normalized, original);
+        }
+        return StartAfter.#add(now, StartAfter.#interval(normalized, original));
+    }
+    // attorney.js:140-146
+    static #normalize(value) {
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        if (Number(value) > 0) {
+            return String(value);
+        }
+        if (typeof value === 'string') {
+            // attorney.js:115-117, pinZonelessDateTime.
+            return StartAfter.#isoDate.test(value) &&
+                StartAfter.#zonelessTime.test(value.slice(10))
+                ? `${value}Z`
+                : value;
+        }
+        return undefined;
+    }
+    static #timestamp(value, original) {
+        const match = StartAfter.#dateTime.exec(value);
+        if (!match) {
+            throw new UnsupportedStartAfterError(original);
+        }
+        const [, date, hour = '00', minute = '00', second = '00', fraction, zone] = match;
+        const offset = zone === undefined || zone === 'Z'
+            ? 'Z'
+            : `${zone.slice(0, 3)}:${zone.slice(3).replace(':', '') || '00'}`;
+        const milliseconds = fraction === undefined ? '' : `.${fraction}`;
+        return new Date(`${date}T${hour}:${minute}:${second}${milliseconds}${offset}`);
+    }
+    static #interval(value, original) {
+        const trimmed = value.trim();
+        if (StartAfter.#seconds.test(trimmed)) {
+            return { months: 0, days: 0, milliseconds: Number(trimmed) * 1000 };
+        }
+        const duration = StartAfter.#isoDuration.exec(trimmed);
+        if (duration && trimmed !== 'P' && !trimmed.endsWith('T')) {
+            const [, years, months, weeks, days, hours, minutes, seconds] = duration;
+            return {
+                months: Number(years ?? 0) * 12 + Number(months ?? 0),
+                days: Number(weeks ?? 0) * 7 + Number(days ?? 0),
+                milliseconds: Number(hours ?? 0) * 3_600_000 +
+                    Number(minutes ?? 0) * 60_000 +
+                    Number(seconds ?? 0) * 1000,
+            };
+        }
+        return StartAfter.#units(trimmed, original);
+    }
+    static #units(trimmed, original) {
+        if (!StartAfter.#unitsShape.test(trimmed)) {
+            throw new UnsupportedStartAfterError(original);
+        }
+        const interval = { months: 0, days: 0, milliseconds: 0 };
+        for (const [, amount, unit] of trimmed.matchAll(StartAfter.#unitPairs)) {
+            const scale = StartAfter.#unitScales.get(String(unit).toLowerCase());
+            if (scale === undefined) {
+                throw new UnsupportedStartAfterError(original);
+            }
+            interval[scale.field] += Number(amount) * scale.size;
+        }
+        return interval;
+    }
+    // Postgres adds an interval's months (clamped to the target month's last
+    // day), then its days, then its time part.
+    static #add(now, interval) {
+        const result = new Date(now.getTime());
+        if (interval.months !== 0) {
+            const day = result.getUTCDate();
+            result.setUTCDate(1);
+            result.setUTCMonth(result.getUTCMonth() + interval.months);
+            const lastDay = new Date(Date.UTC(result.getUTCFullYear(), result.getUTCMonth() + 1, 0)).getUTCDate();
+            result.setUTCDate(Math.min(day, lastDay));
+        }
+        result.setUTCDate(result.getUTCDate() + interval.days);
+        return new Date(result.getTime() + interval.milliseconds);
+    }
+}
+//# sourceMappingURL=start-after.js.map

package/dist/start-after.js.map

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

package/dist/supervisor.d.ts

@@ -0,0 +1,16 @@
+import { EventEmitter } from 'node:events';
+import type { DatabaseSync } from 'node:sqlite';
+import type { Clock, PgBossEventMap } from 'pg-boss';
+import type { Activity } from './activity.ts';
+import type { SuperviseIntervals } from './attorney.ts';
+export type SupervisorConfig = SuperviseIntervals & {
+    supervise: boolean | undefined;
+    warningQueueSize: number | undefined;
+};
+export declare class Supervisor extends EventEmitter<Pick<PgBossEventMap, 'error' | 'warning'>> {
+    #private;
+    constructor(clock: Clock, activity: Activity, config: SupervisorConfig);
+    start(database: DatabaseSync): void;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=supervisor.d.ts.map

package/dist/supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../src/supervisor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAKrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AA4BxD,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG;IAClD,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAoBF,qBAAa,UAAW,SAAQ,YAAY,CAC1C,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC,CAC1C;;gBAUa,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB;IAUtE,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAa7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAuU5B"}

package/dist/supervisor.js

@@ -0,0 +1,288 @@
+import assert from 'node:assert';
+import { EventEmitter } from 'node:events';
+import { policies } from 'pg-boss';
+import { transaction } from '@zukhruf/sqlite-transaction';
+import { ClaimTimer } from "./claim-timer.js";
+import { InFlight } from "./in-flight.js";
+import { JobSettler } from "./job-settler.js";
+import { Row } from "./rows.js";
+import { SqlValues } from "./sql-values.js";
+// node_modules/pg-boss/dist/boss.js:14
+const LARGE_QUEUE = { size: 10_000, message: 'Warning: large queue backlog' };
+// The outputs failJobsByTimeout and failJobsByHeartbeat store (plans.js:2376,
+// 2384).
+const TIMED_OUT = JSON.stringify({ value: { message: 'job timed out' } });
+const HEARTBEAT_TIMED_OUT = JSON.stringify({
+    value: { message: 'job heartbeat timeout' },
+});
+// A pass works on at most this many queues at a time (boss.js:269).
+const CHUNK = 100;
+// pg-boss's Boss (node_modules/pg-boss/dist/boss.js) for one job table: a
+// pass every superviseIntervalSeconds claims each queue's monitor and
+// maintenance when due, refreshes the monitored queues' counts, warns about
+// backlogs and fails expired and heartbeat-lost jobs, then deletes what the
+// maintained queues no longer keep. Each statement is one Activity.query, so
+// an attached TestClock waits the whole pass out. The pass's Postgres tail
+// (vacuum backoff and check, warning and stats retention, reindex) and
+// cleanupDependencies (no job_dependency table) have no counterpart here.
+export class Supervisor extends EventEmitter {
+    #clock;
+    #activity;
+    #config;
+    // boss.js:121
+    #largeQueueSize;
+    #phase = { kind: 'unstarted' };
+    // pg-boss's #maintaining: the pass in flight.
+    #pass = null;
+    constructor(clock, activity, config) {
+        super();
+        this.#clock = clock;
+        this.#activity = activity;
+        this.#config = config;
+        this.#largeQueueSize = config.warningQueueSize || LARGE_QUEUE.size;
+    }
+    // boss.js:128-137: started whether or not supervise is set, which only
+    // decides whether the timer is armed.
+    start(database) {
+        if (this.#phase.kind === 'supervising') {
+            return;
+        }
+        const timer = this.#config.supervise
+            ? new ClaimTimer(this.#clock, this.#config.superviseIntervalSeconds, () => this.#onSupervise())
+            : null;
+        this.#phase = { kind: 'supervising', database, timer };
+    }
+    // boss.js:138-148, which polls its pass flag every 10 ms of real time.
+    async stop() {
+        const phase = this.#phase;
+        if (phase.kind !== 'supervising') {
+            return;
+        }
+        phase.timer?.stop();
+        this.#phase = { kind: 'stopped', database: phase.database };
+        await this.#pass?.settled();
+    }
+    get #stopped() {
+        return this.#phase.kind !== 'supervising';
+    }
+    // boss.js:173-199
+    async #onSupervise() {
+        if (this.#stopped || this.#pass) {
+            return;
+        }
+        const pass = this.#supervise();
+        this.#pass = new InFlight(pass);
+        try {
+            await pass;
+        }
+        finally {
+            this.#pass = null;
+        }
+    }
+    async #supervise() {
+        try {
+            const names = await this.#query((db) => Supervisor.#queueNames(db));
+            if (!this.#stopped) {
+                await this.#supervisePass(names);
+            }
+        }
+        catch (error) {
+            this.emit('error', error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    // boss.js:239-279: the next pass is anchored once every claim is stamped.
+    async #supervisePass(names) {
+        for (let start = 0; start < names.length; start += CHUNK) {
+            if (this.#stopped) {
+                return;
+            }
+            const chunk = names.slice(start, start + CHUNK);
+            await this.#monitor(chunk);
+            await this.#maintain(chunk);
+        }
+        if (this.#phase.kind === 'supervising') {
+            this.#phase.timer?.anchor();
+        }
+    }
+    // boss.js:293-381. Nothing here backs off the stats, so every claimed
+    // queue's counts are refreshed (refreshStats, plans.js:987).
+    async #monitor(names) {
+        if (this.#stopped) {
+            return;
+        }
+        const claimed = await this.#query((db, now) => Supervisor.#claim(db, names, 'monitor_claim_on', 'COALESCE(monitor_claim_on, monitor_on)', this.#config.monitorIntervalSeconds, now));
+        if (this.#stopped || claimed.length === 0) {
+            return;
+        }
+        const stats = await this.#query((db, now) => Supervisor.#cacheQueueStats(db, claimed, now));
+        if (this.#stopped) {
+            return;
+        }
+        // boss.js:352-358
+        for (const row of stats) {
+            const threshold = row.warningQueueSize || this.#largeQueueSize;
+            if (row.queuedCount > threshold) {
+                this.emit('warning', {
+                    message: `${LARGE_QUEUE.message}: queue "${row.name}" has ${row.queuedCount} jobs in the ` +
+                        `created or retry state, over its warning threshold of ${threshold}. Your queue should be reviewed`,
+                    data: row,
+                });
+            }
+        }
+        if (this.#stopped) {
+            return;
+        }
+        const queues = JSON.stringify(claimed);
+        // failJobsByTimeout (plans.js:2372-2378)
+        await this.#query((db, now) => JobSettler.failJobs(db, [
+            `state = 'active'
+          AND ${SqlValues.plusSecondsSql('started_on', 'expire_seconds')} < ?
+          AND queue_name IN (SELECT value FROM json_each(?))`,
+            SqlValues.asIso(now),
+            queues,
+        ], TIMED_OUT, now));
+        if (this.#stopped) {
+            return;
+        }
+        // failJobsByHeartbeat (plans.js:2379-2386)
+        await this.#query((db, now) => JobSettler.failJobs(db, [
+            `state = 'active'
+          AND heartbeat_seconds IS NOT NULL
+          AND ${SqlValues.plusSecondsSql('heartbeat_on', 'heartbeat_seconds')} < ?
+          AND queue_name IN (SELECT value FROM json_each(?))`,
+            SqlValues.asIso(now),
+            queues,
+        ], HEARTBEAT_TIMED_OUT, now));
+    }
+    // boss.js:382-396
+    async #maintain(names) {
+        if (this.#stopped) {
+            return;
+        }
+        const claimed = await this.#query((db, now) => Supervisor.#claim(db, names, 'maintain_on', 'maintain_on', this.#config.maintenanceIntervalSeconds, now));
+        if (this.#stopped) {
+            return;
+        }
+        if (claimed.length > 0) {
+            await this.#query((db, now) => Supervisor.#deletion(db, claimed, now));
+        }
+    }
+    // A statement on the clock's now, run when issued and settled one counted
+    // turn later.
+    #query(statement) {
+        return this.#activity.query(() => {
+            assert(this.#phase.kind !== 'unstarted', 'Database not opened.');
+            return statement(this.#phase.database, new Date(this.#clock.now()));
+        });
+    }
+    // getQueues (plans.js:1181-1220) has no ORDER BY; PGlite returns the
+    // queues in creation order, which decides each 100-queue chunk.
+    static #queueNames(db) {
+        return db
+            .prepare('SELECT name FROM pgboss_queue ORDER BY rowid')
+            .all()
+            .map((row) => Row.readString(row, 'name'));
+    }
+    // trySetQueueMonitorTime and trySetQueueTimestamp (plans.js:973-990,
+    // 1119-1137): a queue is due once its stamp is `seconds` old, or at once
+    // without one; the due queues are stamped now. pg-boss takes the rows in
+    // name order only as a lock order (queueRowLock, 1146-1148) and leaves its
+    // RETURNING order to the planner; SQLite's single writer needs no lock
+    // order, and name order keeps the pass's warnings in one stable order.
+    static #claim(db, names, column, stamp, seconds, now) {
+        return transaction(db, () => {
+            const due = db
+                .prepare(`SELECT name, ${stamp} AS stamp FROM pgboss_queue
+          WHERE name IN (SELECT value FROM json_each(?))
+          ORDER BY name`)
+                .all(JSON.stringify(names))
+                .filter((row) => {
+                const stamped = Row.readNullableString(row, 'stamp');
+                return (stamped === null ||
+                    (now.getTime() - Date.parse(stamped)) / 1000 >= seconds);
+            })
+                .map((row) => Row.readString(row, 'name'));
+            const update = db.prepare(`UPDATE pgboss_queue SET ${column} = ? WHERE name = ?`);
+            for (const name of due) {
+                update.run(SqlValues.asIso(now), name);
+            }
+            return due;
+        }, { mode: 'immediate' });
+    }
+    // cacheQueueStats over getQueueStats (plans.js:3411-3471, 3480-3557): each
+    // claimed queue's counts by state, the keys its singleton and stately jobs
+    // hold active (NULL for none, as array_agg over no rows) and monitor_on,
+    // written and returned in the claim's order.
+    static #cacheQueueStats(db, names, now) {
+        const started = performance.now();
+        const isoNow = SqlValues.asIso(now);
+        const queues = JSON.stringify(names);
+        return transaction(db, () => {
+            const counts = new Map(db
+                .prepare(`SELECT queue_name,
+              SUM(state IN ('created', 'retry') AND start_after > ?) AS deferred,
+              SUM(state IN ('created', 'retry')) AS queued,
+              SUM(state = 'active') AS active,
+              SUM(state = 'failed') AS failed,
+              COUNT(*) AS total
+            FROM pgboss_job
+            WHERE queue_name IN (SELECT value FROM json_each(?))
+            GROUP BY queue_name`)
+                .all(isoNow, queues)
+                .map((row) => [Row.readString(row, 'queue_name'), row]));
+            const singletons = new Map();
+            for (const row of db
+                .prepare(`SELECT queue_name, singleton_key FROM pgboss_job
+          WHERE queue_name IN (SELECT value FROM json_each(?))
+            AND state = 'active'
+            AND policy IN ('${policies.singleton}', '${policies.stately}')
+          ORDER BY rowid`)
+                .all(queues)) {
+                const name = Row.readString(row, 'queue_name');
+                singletons.set(name, [
+                    ...(singletons.get(name) ?? []),
+                    Row.readNullableString(row, 'singleton_key'),
+                ]);
+            }
+            const update = db.prepare(`UPDATE pgboss_queue SET
+          deferred_count = ?,
+          queued_count = ?,
+          ready_count = ?,
+          active_count = ?,
+          failed_count = ?,
+          total_count = ?,
+          singletons_active = ?,
+          monitor_on = ?
+        WHERE name = ?
+        RETURNING name, queued_count, warning_queue_size`);
+            return names.flatMap((name) => {
+                const row = counts.get(name);
+                const count = (column) => row ? Row.readNumber(row, column) : 0;
+                const keys = singletons.get(name);
+                const written = update.get(count('deferred'), count('queued'), Math.max(count('queued') - count('deferred'), 0), count('active'), count('failed'), count('total'), keys ? JSON.stringify(keys) : null, isoNow, name);
+                return written === undefined
+                    ? []
+                    : [
+                        {
+                            name: Row.readString(written, 'name'),
+                            queuedCount: Row.readNumber(written, 'queued_count'),
+                            warningQueueSize: Row.readNumber(written, 'warning_queue_size'),
+                            pinSeconds: (performance.now() - started) / 1000,
+                        },
+                    ];
+            });
+        }, { mode: 'immediate' });
+    }
+    // deletion (plans.js:3055-3066): settled jobs deletion_seconds after they
+    // settled, unless that is 0, and jobs never started once past keep_until.
+    static #deletion(db, names, now) {
+        const isoNow = SqlValues.asIso(now);
+        db.prepare(`DELETE FROM pgboss_job
+      WHERE queue_name IN (SELECT value FROM json_each(?))
+        AND (
+          (deletion_seconds > 0 AND ${SqlValues.plusSecondsSql('completed_on', 'deletion_seconds')} < ?)
+          OR (state IN ('created', 'retry') AND keep_until < ?)
+        )`).run(JSON.stringify(names), isoNow, isoNow);
+    }
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/supervisor.js.map

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

package/dist/throttle.d.ts

@@ -0,0 +1,6 @@
+import type { SendOptions } from 'pg-boss';
+export declare class Throttle {
+    static slot(singletonSeconds: SendOptions['singletonSeconds'], offset: SendOptions['singletonSeconds'], now: Date): string | null;
+    static debounceStartAfter(singletonSeconds: SendOptions['singletonSeconds'], now: Date): number;
+}
+//# sourceMappingURL=throttle.d.ts.map

package/dist/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../src/throttle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAO3C,qBAAa,QAAQ;IAOnB,MAAM,CAAC,IAAI,CACT,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAAC,EACjD,MAAM,EAAE,WAAW,CAAC,kBAAkB,CAAC,EACvC,GAAG,EAAE,IAAI,GACR,MAAM,GAAG,IAAI;IAgBhB,MAAM,CAAC,kBAAkB,CACvB,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAAC,EACjD,GAAG,EAAE,IAAI,GACR,MAAM;CAQV"}

package/dist/throttle.js

@@ -0,0 +1,35 @@
+import { DatabaseError } from "./database-error.js";
+import { NaiveTimestamp } from "./naive-timestamp.js";
+// pg-boss's send throttle: singletonSeconds, and singletonNextSlot to retry a
+// refused send into the next slot.
+export class Throttle {
+    // pg-boss's throttle slot: singletonSeconds wide, shifted by an offset, as a
+    // zoneless timestamp (node_modules/pg-boss/dist/plans.js:2279). A null width
+    // is no throttle there (`"singletonSeconds" IS NOT NULL`), and a zero width
+    // divides by zero in Postgres, which pg-boss surfaces as the driver's error.
+    // The offset is 0, or singletonSeconds when a refused send retries into the
+    // next slot (manager.js:1253-1256).
+    static slot(singletonSeconds, offset, now) {
+        if (singletonSeconds === undefined || singletonSeconds === null) {
+            return null;
+        }
+        const width = Number(singletonSeconds);
+        if (width === 0) {
+            throw new DatabaseError('division by zero', '22012');
+        }
+        const slotStartSeconds = width * Math.floor((now.getTime() / 1000 + Number(offset)) / width);
+        return NaiveTimestamp.fromUtc(new Date(slotStartSeconds * 1000));
+    }
+    // manager.js:1533-1542: seconds until the next throttle slot starts, never 0,
+    // and one more for slots wider than a second. Without a width the slot
+    // arithmetic is NaN, which the `|| 1` floors, as in pg-boss.
+    static debounceStartAfter(singletonSeconds, now) {
+        const width = Number(singletonSeconds);
+        const interval = width * 1000;
+        const slotStart = Math.floor(now.getTime() / interval) * interval;
+        const elapsedSeconds = Math.floor((now.getTime() - slotStart) / 1000);
+        const startAfter = width - elapsedSeconds || 1;
+        return width > 1 ? startAfter + 1 : startAfter;
+    }
+}
+//# sourceMappingURL=throttle.js.map

package/dist/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../src/throttle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,8EAA8E;AAC9E,mCAAmC;AACnC,MAAM,OAAO,QAAQ;IACnB,6EAA6E;IAC7E,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAC5E,oCAAoC;IACpC,MAAM,CAAC,IAAI,CACT,gBAAiD,EACjD,MAAuC,EACvC,GAAS;QAET,IAAI,gBAAgB,KAAK,SAAS,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,gBAAgB,GACpB,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QACtE,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,8EAA8E;IAC9E,uEAAuE;IACvE,6DAA6D;IAC7D,MAAM,CAAC,kBAAkB,CACvB,gBAAiD,EACjD,GAAS;QAET,MAAM,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAClE,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,KAAK,GAAG,cAAc,IAAI,CAAC,CAAC;QAC/C,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACjD,CAAC;CACF"}

package/dist/timekeeper.d.ts

@@ -0,0 +1,36 @@
+import { EventEmitter } from 'node:events';
+import type { DatabaseSync } from 'node:sqlite';
+import type { Clock, PgBossEventMap, WorkHandler, WorkOptions } from 'pg-boss';
+import type { Activity } from './activity.ts';
+export type SlottedJob = {
+    data: {
+        name: string;
+        key: string;
+        data: unknown;
+        options: unknown;
+        slot: string;
+    };
+    singletonKey: string;
+    singletonOn: string;
+};
+export type TimekeeperManager = {
+    createQueue(name: string): Promise<void>;
+    work(name: string, options: WorkOptions, handler: WorkHandler<unknown>): Promise<string>;
+    offWork(name: string, options: {
+        wait: boolean;
+    }): Promise<void>;
+    send(request: unknown): Promise<string | null>;
+    insert(name: string, jobs: SlottedJob[]): Promise<void>;
+};
+export type TimekeeperConfig = {
+    cronMonitorIntervalSeconds: number;
+    cronWorkerIntervalSeconds: number;
+};
+export declare class Timekeeper extends EventEmitter<Pick<PgBossEventMap, 'error'>> {
+    #private;
+    static readonly sendIt = "__pgboss__send-it";
+    constructor(clock: Clock, activity: Activity, config: TimekeeperConfig, manager: TimekeeperManager);
+    start(database: DatabaseSync): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=timekeeper.d.ts.map

package/dist/timekeeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timekeeper.d.ts","sourceRoot":"","sources":["../src/timekeeper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,OAAO,KAAK,EACV,KAAK,EAEL,cAAc,EACd,WAAW,EACX,WAAW,EACZ,MAAM,SAAS,CAAC;AAKjB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAW9C,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAIF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0BAA0B,EAAE,MAAM,CAAC;IACnC,yBAAyB,EAAE,MAAM,CAAC;CACnC,CAAC;AAgCF,qBAAa,UAAW,SAAQ,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;;IAEzE,MAAM,CAAC,QAAQ,CAAC,MAAM,uBAAuB;gBAkB3C,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,iBAAiB;IA+CtB,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA4R5B"}