mysql-boss 0.1.0

package/dist/cjs/archive.d.ts

@@ -0,0 +1,8 @@
+import type { Pool } from "mysql2/promise";
+import type { ArchivedJob } from "./index.js";
+import { type SqlStatements } from "./sql.js";
+export declare function completeJob(pool: Pool, jobId: string, workerId: string, sql?: SqlStatements): Promise<boolean>;
+export declare function getArchivedJob(pool: Pool, id: string, sql?: SqlStatements): Promise<ArchivedJob | null>;
+export declare function listArchive(pool: Pool, queue: string, before: Date, limit: number, sql?: SqlStatements): Promise<ArchivedJob[]>;
+export declare function pruneArchive(pool: Pool, retentionDays: number, sql?: SqlStatements): Promise<void>;
+//# sourceMappingURL=archive.d.ts.map

package/dist/cjs/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/archive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAkC,MAAM,gBAAgB,CAAC;AAE3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,UAAU,CAAC;AAG9D,wBAAsB,WAAW,CAChC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAiCD,wBAAsB,cAAc,CACnC,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,MAAM,EACV,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAQ7B;AAED,wBAAsB,WAAW,CAChC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,IAAI,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC,CASxB;AAED,wBAAsB,YAAY,CACjC,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/cjs/archive.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.completeJob = completeJob;
+exports.getArchivedJob = getArchivedJob;
+exports.listArchive = listArchive;
+exports.pruneArchive = pruneArchive;
+const connection_js_1 = require("./connection.js");
+const retry_util_js_1 = require("./retry-util.js");
+const sql_js_1 = require("./sql.js");
+const util_js_1 = require("./util.js");
+async function completeJob(pool, jobId, workerId, sql = sql_js_1.UNPREFIXED_SQL) {
+    return (0, retry_util_js_1.withDeadlockRetry)(async () => {
+        const conn = await (0, connection_js_1.acquireConnection)(pool);
+        try {
+            await conn.beginTransaction();
+            const [result] = await conn.query(sql.COMPLETE_ARCHIVE, [
+                jobId,
+                workerId,
+            ]);
+            if (result.affectedRows === 0) {
+                await conn.commit();
+                return false;
+            }
+            await conn.query(sql.COMPLETE_DELETE, [jobId, workerId]);
+            await conn.commit();
+            return true;
+        }
+        catch (err) {
+            await conn.rollback().catch(() => { });
+            throw err;
+        }
+        finally {
+            conn.release();
+        }
+    });
+}
+function unixDate(value) {
+    return new Date(Number(value) * 1000);
+}
+function mapArchiveRow(row) {
+    return {
+        id: row.id,
+        queue: row.queue,
+        payload: row.payload,
+        priority: row.priority,
+        retryCount: row.retry_count,
+        createdAt: unixDate(row.created_at_unix),
+        startedAt: unixDate(row.started_at_unix),
+        completedAt: unixDate(row.completed_at_unix),
+        durationMs: row.duration_ms,
+    };
+}
+async function getArchivedJob(pool, id, sql = sql_js_1.UNPREFIXED_SQL) {
+    return (0, connection_js_1.withConnection)(pool, async (connection) => {
+        const [rows] = await connection.query(sql.GET_ARCHIVED_JOB, [
+            id,
+        ]);
+        if (rows.length === 0)
+            return null;
+        return mapArchiveRow(rows[0]);
+    });
+}
+async function listArchive(pool, queue, before, limit, sql = sql_js_1.UNPREFIXED_SQL) {
+    return (0, connection_js_1.withConnection)(pool, async (connection) => {
+        const [rows] = await connection.query(sql.LIST_ARCHIVE, [
+            queue,
+            (0, util_js_1.toUtcString)(before),
+            limit,
+        ]);
+        return rows.map(mapArchiveRow);
+    });
+}
+async function pruneArchive(pool, retentionDays, sql = sql_js_1.UNPREFIXED_SQL) {
+    await (0, connection_js_1.withConnection)(pool, async (connection) => {
+        let deleted;
+        do {
+            const [result] = await connection.query(sql.ARCHIVE_PRUNE, [retentionDays]);
+            deleted = result.affectedRows;
+        } while (deleted >= 5000);
+    });
+}
+//# sourceMappingURL=archive.js.map

package/dist/cjs/archive.js.map

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

package/dist/cjs/boss.d.ts

@@ -0,0 +1,45 @@
+import type { ArchivedJob, DeadJob, EnqueueOptions, JobHandler, MysqlBossOptions, ScheduleOptions } from "./index.js";
+export declare class MysqlBoss {
+    private pool;
+    private workerId;
+    private worker;
+    private tickTimer;
+    private pruneCounter;
+    private stopped;
+    private sql;
+    private pollIntervalMs;
+    private batchSize;
+    private concurrency;
+    private leaseSeconds;
+    private heartbeatSeconds;
+    private sweepIntervalMs;
+    private tickIntervalMs;
+    private archiveRetentionDays;
+    private drainTimeoutMs;
+    private onError;
+    constructor(opts: MysqlBossOptions);
+    migrate(): Promise<void>;
+    enqueue<T>(queue: string, payload: T, opts?: EnqueueOptions): Promise<string | null>;
+    work<T>(queue: string, handler: JobHandler<T>): void;
+    private startTick;
+    schedule(name: string, queue: string, cron: string, opts?: ScheduleOptions): Promise<void>;
+    unschedule(name: string): Promise<void>;
+    listDead(q: {
+        queue: string;
+        before?: Date;
+        after?: Date;
+        limit?: number;
+        offset?: number;
+    }): Promise<DeadJob[]>;
+    replayDead(ids: string[]): Promise<number>;
+    getArchivedJob(id: string): Promise<ArchivedJob | null>;
+    listArchive(q: {
+        queue: string;
+        before?: Date;
+        limit?: number;
+    }): Promise<ArchivedJob[]>;
+    stop(opts?: {
+        drainTimeoutMs?: number;
+    }): Promise<void>;
+}
+//# sourceMappingURL=boss.d.ts.map

package/dist/cjs/boss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boss.d.ts","sourceRoot":"","sources":["../../src/boss.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,WAAW,EACX,OAAO,EACP,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,MAAM,YAAY,CAAC;AAOpB,qBAAa,SAAS;IACrB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAgB;IAE3B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,OAAO,CAA0C;IAEzD,YAAY,IAAI,EAAE,gBAAgB,EAoCjC;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7B;IAEK,OAAO,CAAC,CAAC,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,EACV,IAAI,CAAC,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsExB;IAED,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAuBnD;IAED,OAAO,CAAC,SAAS;IAkBX,QAAQ,CACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CAoBf;IAEK,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5C;IAEK,QAAQ,CAAC,CAAC,EAAE;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,KAAK,CAAC,EAAE,IAAI,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAOrB;IAEK,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/C;IAEK,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAE5D;IAEK,WAAW,CAAC,CAAC,EAAE;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAKzB;IAEK,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5D;CACD"}

package/dist/cjs/boss.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MysqlBoss = void 0;
+const node_crypto_1 = require("node:crypto");
+const archive_js_1 = require("./archive.js");
+const connection_js_1 = require("./connection.js");
+const dlq_js_1 = require("./dlq.js");
+const errors_js_1 = require("./errors.js");
+const migrate_js_1 = require("./migrate.js");
+const sql_js_1 = require("./sql.js");
+const tick_js_1 = require("./tick.js");
+const util_js_1 = require("./util.js");
+const worker_js_1 = require("./worker.js");
+class MysqlBoss {
+    pool;
+    workerId;
+    worker = null;
+    tickTimer = null;
+    pruneCounter = 0;
+    stopped = false;
+    sql;
+    pollIntervalMs;
+    batchSize;
+    concurrency;
+    leaseSeconds;
+    heartbeatSeconds;
+    sweepIntervalMs;
+    tickIntervalMs;
+    archiveRetentionDays;
+    drainTimeoutMs;
+    onError;
+    constructor(opts) {
+        this.pool = opts.pool;
+        this.workerId = (0, node_crypto_1.randomUUID)();
+        try {
+            this.sql = (0, sql_js_1.createSql)(opts.tablePrefix);
+        }
+        catch (error) {
+            throw new errors_js_1.ConfigError(error instanceof Error ? error.message : "Invalid tablePrefix");
+        }
+        this.pollIntervalMs = opts.pollIntervalMs ?? 2000;
+        this.batchSize = opts.batchSize ?? 10;
+        this.concurrency = opts.concurrency ?? this.batchSize;
+        this.leaseSeconds = opts.leaseSeconds ?? 300;
+        this.heartbeatSeconds = opts.heartbeatSeconds ?? 100;
+        this.sweepIntervalMs = opts.sweepIntervalMs ?? 60_000;
+        this.tickIntervalMs = opts.tickIntervalMs ?? 30_000;
+        this.archiveRetentionDays = opts.archiveRetentionDays ?? 14;
+        this.drainTimeoutMs = opts.drainTimeoutMs ?? 30_000;
+        this.onError = opts.onError ?? (() => { });
+        if (this.batchSize < 1 || this.batchSize > 100) {
+            throw new errors_js_1.ConfigError("batchSize must be between 1 and 100");
+        }
+        if (this.leaseSeconds < 3 * this.heartbeatSeconds) {
+            throw new errors_js_1.ConfigError(`leaseSeconds (${this.leaseSeconds}) must be >= 3 × heartbeatSeconds (${this.heartbeatSeconds})`);
+        }
+        if (this.archiveRetentionDays < 1 ||
+            !Number.isInteger(this.archiveRetentionDays)) {
+            throw new errors_js_1.ConfigError("archiveRetentionDays must be an integer >= 1");
+        }
+    }
+    async migrate() {
+        await (0, migrate_js_1.migrate)(this.pool, this.sql);
+    }
+    async enqueue(queue, payload, opts) {
+        const priority = opts?.priority ?? 0;
+        const singletonKey = opts?.singletonKey ?? null;
+        const retryLimit = opts?.retryLimit ?? 2;
+        const retryDelaySecs = opts?.retryDelaySecs ?? 30;
+        const retryBackoff = opts?.retryBackoff ? 1 : 0;
+        const runAt = opts?.runAt ?? null;
+        if (priority < -32768 || priority > 32767) {
+            throw new errors_js_1.ValidationError(`priority must be between -32768 and 32767, got ${priority}`);
+        }
+        if (singletonKey !== null) {
+            if (singletonKey.length > 191) {
+                throw new errors_js_1.ValidationError("singletonKey must be <= 191 characters");
+            }
+            if (singletonKey.startsWith("cron:")) {
+                throw new errors_js_1.ValidationError('singletonKey must not start with "cron:" (reserved for scheduled jobs)');
+            }
+        }
+        const payloadJson = payload != null ? JSON.stringify(payload) : null;
+        const runAtParam = runAt ? (0, util_js_1.toUtcString)(runAt) : null;
+        if (singletonKey !== null) {
+            return (0, connection_js_1.withConnection)(this.pool, async (connection) => {
+                const [result] = await connection.query(this.sql.ENQUEUE_SINGLETON, [
+                    queue,
+                    priority,
+                    payloadJson,
+                    singletonKey,
+                    retryLimit,
+                    retryDelaySecs,
+                    retryBackoff,
+                    runAtParam,
+                ]);
+                if (result.affectedRows === 0)
+                    return null;
+                const [rows] = await connection.query(this.sql.LAST_INSERT_ID);
+                return rows[0].id;
+            });
+        }
+        return (0, connection_js_1.withConnection)(this.pool, async (connection) => {
+            const [result] = await connection.query(this.sql.ENQUEUE, [
+                queue,
+                priority,
+                payloadJson,
+                singletonKey,
+                retryLimit,
+                retryDelaySecs,
+                retryBackoff,
+                runAtParam,
+            ]);
+            const [rows] = await connection.query(this.sql.LAST_INSERT_ID);
+            return rows[0].id;
+        });
+    }
+    work(queue, handler) {
+        if (this.stopped) {
+            throw new Error("Cannot register work after stop()");
+        }
+        if (!this.worker) {
+            this.worker = new worker_js_1.WorkerManager({
+                pool: this.pool,
+                workerId: this.workerId,
+                pollIntervalMs: this.pollIntervalMs,
+                batchSize: this.batchSize,
+                concurrency: this.concurrency,
+                leaseSeconds: this.leaseSeconds,
+                heartbeatSeconds: this.heartbeatSeconds,
+                sweepIntervalMs: this.sweepIntervalMs,
+                drainTimeoutMs: this.drainTimeoutMs,
+                onError: this.onError,
+                sql: this.sql,
+            });
+            this.startTick();
+        }
+        this.worker.registerQueue(queue, handler);
+    }
+    startTick() {
+        if (this.tickTimer)
+            return;
+        const jitter = 0.8 + Math.random() * 0.4;
+        this.tickTimer = setInterval(async () => {
+            try {
+                await (0, tick_js_1.runTick)(this.pool, this.sql);
+                this.pruneCounter++;
+                if (this.pruneCounter >= 10) {
+                    this.pruneCounter = 0;
+                    await (0, archive_js_1.pruneArchive)(this.pool, this.archiveRetentionDays, this.sql);
+                }
+            }
+            catch (err) {
+                this.onError(err, "tick");
+            }
+        }, this.tickIntervalMs * jitter);
+        this.tickTimer.unref();
+    }
+    async schedule(name, queue, cron, opts) {
+        const timezone = opts?.timezone ?? "UTC";
+        const payload = opts?.payload ?? null;
+        const jobOptions = {
+            priority: opts?.priority ?? 0,
+            retryLimit: opts?.retryLimit ?? 2,
+            retryDelaySecs: opts?.retryDelaySecs ?? 30,
+            retryBackoff: opts?.retryBackoff ?? false,
+        };
+        await (0, tick_js_1.upsertSchedule)(this.pool, name, queue, cron, timezone, payload, jobOptions, this.sql);
+    }
+    async unschedule(name) {
+        await (0, tick_js_1.deleteSchedule)(this.pool, name, this.sql);
+    }
+    async listDead(q) {
+        const before = q.before ?? new Date("9999-12-31");
+        const after = q.after ?? new Date("1970-01-01");
+        const limit = q.limit ?? 50;
+        const offset = q.offset ?? 0;
+        return (0, dlq_js_1.listDead)(this.pool, q.queue, before, after, limit, offset, this.sql);
+    }
+    async replayDead(ids) {
+        return (0, dlq_js_1.replayDead)(this.pool, ids, this.sql);
+    }
+    async getArchivedJob(id) {
+        return (0, archive_js_1.getArchivedJob)(this.pool, id, this.sql);
+    }
+    async listArchive(q) {
+        const before = q.before ?? new Date("9999-12-31");
+        const limit = q.limit ?? 50;
+        return (0, archive_js_1.listArchive)(this.pool, q.queue, before, limit, this.sql);
+    }
+    async stop(opts) {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        if (this.tickTimer) {
+            clearInterval(this.tickTimer);
+            this.tickTimer = null;
+        }
+        if (this.worker) {
+            await this.worker.stop(opts?.drainTimeoutMs);
+        }
+    }
+}
+exports.MysqlBoss = MysqlBoss;
+//# sourceMappingURL=boss.js.map

package/dist/cjs/boss.js.map

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

package/dist/cjs/claim.d.ts

@@ -0,0 +1,5 @@
+import type { Pool } from "mysql2/promise";
+import type { ActiveJob } from "./index.js";
+import { type SqlStatements } from "./sql.js";
+export declare function claimJobs(pool: Pool, queue: string, workerId: string, batchSize: number, leaseSeconds: number, sql?: SqlStatements): Promise<ActiveJob[]>;
+//# sourceMappingURL=claim.d.ts.map

package/dist/cjs/claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../../src/claim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAkC,MAAM,gBAAgB,CAAC;AAE3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,UAAU,CAAC;AAY9D,wBAAsB,SAAS,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,SAAS,EAAE,CAAC,CA4CtB"}

package/dist/cjs/claim.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claimJobs = claimJobs;
+const connection_js_1 = require("./connection.js");
+const retry_util_js_1 = require("./retry-util.js");
+const sql_js_1 = require("./sql.js");
+async function claimJobs(pool, queue, workerId, batchSize, leaseSeconds, sql = sql_js_1.UNPREFIXED_SQL) {
+    return (0, retry_util_js_1.withDeadlockRetry)(async () => {
+        const conn = await (0, connection_js_1.acquireConnection)(pool);
+        try {
+            await conn.beginTransaction();
+            const [rows] = await conn.query(sql.CLAIM_SELECT, [
+                queue,
+                batchSize,
+            ]);
+            if (rows.length === 0) {
+                await conn.commit();
+                return [];
+            }
+            const ids = rows.map((r) => r.id);
+            const [result] = await conn.query(sql.CLAIM_UPDATE, [
+                workerId,
+                leaseSeconds,
+                ids,
+            ]);
+            if (result.affectedRows !== rows.length) {
+                throw new Error(`Claim invariant violated: selected ${rows.length} jobs but updated ${result.affectedRows}`);
+            }
+            await conn.commit();
+            return rows.map((r) => ({
+                id: r.id,
+                queue: r.queue,
+                payload: r.payload,
+                retryCount: r.retry_count,
+                retryLimit: r.retry_limit,
+            }));
+        }
+        catch (err) {
+            await conn.rollback().catch(() => { });
+            throw err;
+        }
+        finally {
+            conn.release();
+        }
+    });
+}
+//# sourceMappingURL=claim.js.map

package/dist/cjs/claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.js","sourceRoot":"","sources":["../../src/claim.ts"],"names":[],"mappings":";;;AACA,mDAAoD;AAEpD,mDAAoD;AACpD,qCAA8D;AAYvD,KAAK,oBACX,IAAU,EACV,KAAa,EACb,QAAgB,EAChB,SAAiB,EACjB,YAAoB,EACpB,GAAG,GAAkB,uBAAc;IAEnC,OAAO,IAAA,iCAAiB,EAAC,KAAK,IAAI,EAAE;QACnC,MAAM,IAAI,GAAG,MAAM,IAAA,iCAAiB,EAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAE9B,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAa,GAAG,CAAC,YAAY,EAAE;gBAC7D,KAAK;gBACL,SAAS;aACT,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,EAAE,CAAC;YACX,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAkB,GAAG,CAAC,YAAY,EAAE;gBACpE,QAAQ;gBACR,YAAY;gBACZ,GAAG;aACH,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CACd,sCAAsC,IAAI,CAAC,MAAM,qBAAqB,MAAM,CAAC,YAAY,EAAE,CAC3F,CAAC;YACH,CAAC;YAED,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YAEpB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,UAAU,EAAE,CAAC,CAAC,WAAW;gBACzB,UAAU,EAAE,CAAC,CAAC,WAAW;aACzB,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACtC,MAAM,GAAG,CAAC;QACX,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,OAAO,EAAE,CAAC;QAChB,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/cjs/connection.d.ts

@@ -0,0 +1,4 @@
+import type { Pool, PoolConnection } from "mysql2/promise";
+export declare function acquireConnection(pool: Pool): Promise<PoolConnection>;
+export declare function withConnection<T>(pool: Pool, fn: (connection: PoolConnection) => Promise<T>): Promise<T>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/cjs/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG3D,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,CAS3E;AAED,wBAAsB,cAAc,CAAC,CAAC,EACrC,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAC5C,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/cjs/connection.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.acquireConnection = acquireConnection;
+exports.withConnection = withConnection;
+const sql_js_1 = require("./sql.js");
+async function acquireConnection(pool) {
+    const connection = await pool.getConnection();
+    try {
+        await connection.query(sql_js_1.INIT_SESSION);
+        return connection;
+    }
+    catch (error) {
+        connection.release();
+        throw error;
+    }
+}
+async function withConnection(pool, fn) {
+    const connection = await acquireConnection(pool);
+    try {
+        return await fn(connection);
+    }
+    finally {
+        connection.release();
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/cjs/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":";;;;AACA,qCAAwC;AAEjC,KAAK,4BAA4B,IAAU;IACjD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC9C,IAAI,CAAC;QACJ,MAAM,UAAU,CAAC,KAAK,CAAC,qBAAY,CAAC,CAAC;QACrC,OAAO,UAAU,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,UAAU,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAEM,KAAK,yBACX,IAAU,EACV,EAA8C;IAE9C,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC;QACJ,OAAO,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;YAAS,CAAC;QACV,UAAU,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;AACF,CAAC"}

package/dist/cjs/cron/next.d.ts

@@ -0,0 +1,3 @@
+import type { CronFields } from "./parse.js";
+export declare function nextOccurrence(fields: CronFields, after: Date, tz: string, maxIterations?: number): Date;
+//# sourceMappingURL=next.d.ts.map

package/dist/cjs/cron/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../../src/cron/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8E7C,wBAAgB,cAAc,CAC7B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,IAAI,EACX,EAAE,EAAE,MAAM,EACV,aAAa,SAAgB,GAC3B,IAAI,CAwIN"}

package/dist/cjs/cron/next.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nextOccurrence = nextOccurrence;
+function getLocalParts(dt, tz) {
+    const fmt = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        year: "numeric",
+        month: "numeric",
+        day: "numeric",
+        hour: "numeric",
+        minute: "numeric",
+        weekday: "short",
+        hour12: false,
+    });
+    const parts = fmt.formatToParts(dt);
+    const get = (type) => Number(parts.find((p) => p.type === type)?.value ?? 0);
+    const dowMap = {
+        Sun: 0,
+        Mon: 1,
+        Tue: 2,
+        Wed: 3,
+        Thu: 4,
+        Fri: 5,
+        Sat: 6,
+    };
+    const dowStr = parts.find((p) => p.type === "weekday")?.value ?? "Sun";
+    return {
+        year: get("year"),
+        month: get("month"),
+        day: get("day"),
+        hour: get("hour") === 24 ? 0 : get("hour"),
+        minute: get("minute"),
+        dow: dowMap[dowStr] ?? 0,
+    };
+}
+function localToUtc(year, month, day, hour, minute, tz) {
+    const guess = new Date(Date.UTC(year, month - 1, day, hour, minute));
+    for (let offset = -14 * 60; offset <= 14 * 60; offset += 15) {
+        const candidate = new Date(guess.getTime() + offset * 60_000);
+        const parts = getLocalParts(candidate, tz);
+        if (parts.year === year &&
+            parts.month === month &&
+            parts.day === day &&
+            parts.hour === hour &&
+            parts.minute === minute) {
+            return candidate;
+        }
+    }
+    return null;
+}
+function daysInMonth(year, month) {
+    return new Date(year, month, 0).getDate();
+}
+function nextOccurrence(fields, after, tz, maxIterations = 366 * 24 * 60) {
+    const local = getLocalParts(after, tz);
+    let { year, month, day, hour, minute } = local;
+    minute += 1;
+    if (minute > 59) {
+        minute = 0;
+        hour += 1;
+    }
+    if (hour > 23) {
+        hour = 0;
+        day += 1;
+    }
+    const dim = daysInMonth(year, month);
+    if (day > dim) {
+        day = 1;
+        month += 1;
+    }
+    if (month > 12) {
+        month = 1;
+        year += 1;
+    }
+    for (let i = 0; i < maxIterations; i++) {
+        if (!fields.months.has(month)) {
+            month += 1;
+            day = 1;
+            hour = 0;
+            minute = 0;
+            if (month > 12) {
+                month = 1;
+                year += 1;
+            }
+            continue;
+        }
+        const dim = daysInMonth(year, month);
+        if (day > dim) {
+            month += 1;
+            day = 1;
+            hour = 0;
+            minute = 0;
+            if (month > 12) {
+                month = 1;
+                year += 1;
+            }
+            continue;
+        }
+        const candidateUtc = localToUtc(year, month, day, hour, minute, tz);
+        if (candidateUtc === null) {
+            // DST gap — this local time doesn't exist; skip forward
+            minute += 1;
+            if (minute > 59) {
+                minute = 0;
+                hour += 1;
+            }
+            if (hour > 23) {
+                hour = 0;
+                day += 1;
+            }
+            continue;
+        }
+        const actualParts = getLocalParts(candidateUtc, tz);
+        const dow = actualParts.dow;
+        const domMatch = fields.daysOfMonth.has(day);
+        const dowMatch = fields.daysOfWeek.has(dow);
+        // Vixie cron OR semantics: if both DOM and DOW are restricted, match either
+        const dayMatch = fields.hasDom && fields.hasDow
+            ? domMatch || dowMatch
+            : fields.hasDom
+                ? domMatch
+                : fields.hasDow
+                    ? dowMatch
+                    : true;
+        if (dayMatch && fields.hours.has(hour) && fields.minutes.has(minute)) {
+            return candidateUtc;
+        }
+        if (!dayMatch) {
+            day += 1;
+            hour = 0;
+            minute = 0;
+            if (day > daysInMonth(year, month)) {
+                day = 1;
+                month += 1;
+                if (month > 12) {
+                    month = 1;
+                    year += 1;
+                }
+            }
+            continue;
+        }
+        if (!fields.hours.has(hour)) {
+            hour += 1;
+            minute = 0;
+            if (hour > 23) {
+                hour = 0;
+                day += 1;
+                if (day > daysInMonth(year, month)) {
+                    day = 1;
+                    month += 1;
+                    if (month > 12) {
+                        month = 1;
+                        year += 1;
+                    }
+                }
+            }
+            continue;
+        }
+        minute += 1;
+        if (minute > 59) {
+            minute = 0;
+            hour += 1;
+            if (hour > 23) {
+                hour = 0;
+                day += 1;
+                if (day > daysInMonth(year, month)) {
+                    day = 1;
+                    month += 1;
+                    if (month > 12) {
+                        month = 1;
+                        year += 1;
+                    }
+                }
+            }
+        }
+    }
+    throw new Error("Could not find next cron occurrence within search window");
+}
+//# sourceMappingURL=next.js.map