mysql-boss 0.1.0

package/dist/esm/boss.js

@@ -0,0 +1,201 @@
+import { randomUUID } from "node:crypto";
+import { getArchivedJob, listArchive, pruneArchive } from "./archive.js";
+import { withConnection } from "./connection.js";
+import { listDead, replayDead } from "./dlq.js";
+import { ConfigError, ValidationError } from "./errors.js";
+import { migrate } from "./migrate.js";
+import { createSql } from "./sql.js";
+import { deleteSchedule, runTick, upsertSchedule } from "./tick.js";
+import { toUtcString } from "./util.js";
+import { WorkerManager } from "./worker.js";
+export 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 = randomUUID();
+        try {
+            this.sql = createSql(opts.tablePrefix);
+        }
+        catch (error) {
+            throw new 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 ConfigError("batchSize must be between 1 and 100");
+        }
+        if (this.leaseSeconds < 3 * this.heartbeatSeconds) {
+            throw new ConfigError(`leaseSeconds (${this.leaseSeconds}) must be >= 3 × heartbeatSeconds (${this.heartbeatSeconds})`);
+        }
+        if (this.archiveRetentionDays < 1 ||
+            !Number.isInteger(this.archiveRetentionDays)) {
+            throw new ConfigError("archiveRetentionDays must be an integer >= 1");
+        }
+    }
+    async migrate() {
+        await 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 ValidationError(`priority must be between -32768 and 32767, got ${priority}`);
+        }
+        if (singletonKey !== null) {
+            if (singletonKey.length > 191) {
+                throw new ValidationError("singletonKey must be <= 191 characters");
+            }
+            if (singletonKey.startsWith("cron:")) {
+                throw new ValidationError('singletonKey must not start with "cron:" (reserved for scheduled jobs)');
+            }
+        }
+        const payloadJson = payload != null ? JSON.stringify(payload) : null;
+        const runAtParam = runAt ? toUtcString(runAt) : null;
+        if (singletonKey !== null) {
+            return 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 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 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 runTick(this.pool, this.sql);
+                this.pruneCounter++;
+                if (this.pruneCounter >= 10) {
+                    this.pruneCounter = 0;
+                    await 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 upsertSchedule(this.pool, name, queue, cron, timezone, payload, jobOptions, this.sql);
+    }
+    async unschedule(name) {
+        await 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 listDead(this.pool, q.queue, before, after, limit, offset, this.sql);
+    }
+    async replayDead(ids) {
+        return replayDead(this.pool, ids, this.sql);
+    }
+    async getArchivedJob(id) {
+        return getArchivedJob(this.pool, id, this.sql);
+    }
+    async listArchive(q) {
+        const before = q.before ?? new Date("9999-12-31");
+        const limit = q.limit ?? 50;
+        return 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);
+        }
+    }
+}
+//# sourceMappingURL=boss.js.map

package/dist/esm/boss.js.map

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

package/dist/esm/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/esm/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/esm/claim.js

@@ -0,0 +1,44 @@
+import { acquireConnection } from "./connection.js";
+import { withDeadlockRetry } from "./retry-util.js";
+import { UNPREFIXED_SQL } from "./sql.js";
+export async function claimJobs(pool, queue, workerId, batchSize, leaseSeconds, sql = UNPREFIXED_SQL) {
+    return withDeadlockRetry(async () => {
+        const conn = await 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/esm/claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.js","sourceRoot":"","sources":["../../src/claim.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAsB,cAAc,EAAE,MAAM,UAAU,CAAC;AAY9D,MAAM,CAAC,KAAK,UAAU,SAAS,CAC9B,IAAU,EACV,KAAa,EACb,QAAgB,EAChB,SAAiB,EACjB,YAAoB,EACpB,GAAG,GAAkB,cAAc;IAEnC,OAAO,iBAAiB,CAAC,KAAK,IAAI,EAAE;QACnC,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,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/esm/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/esm/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/esm/connection.js

@@ -0,0 +1,22 @@
+import { INIT_SESSION } from "./sql.js";
+export async function acquireConnection(pool) {
+    const connection = await pool.getConnection();
+    try {
+        await connection.query(INIT_SESSION);
+        return connection;
+    }
+    catch (error) {
+        connection.release();
+        throw error;
+    }
+}
+export async function withConnection(pool, fn) {
+    const connection = await acquireConnection(pool);
+    try {
+        return await fn(connection);
+    }
+    finally {
+        connection.release();
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/esm/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAU;IACjD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC9C,IAAI,CAAC;QACJ,MAAM,UAAU,CAAC,KAAK,CAAC,YAAY,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;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,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/esm/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/esm/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/esm/cron/next.js

@@ -0,0 +1,176 @@
+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();
+}
+export 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

package/dist/esm/cron/next.js.map

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

package/dist/esm/cron/parse.d.ts

@@ -0,0 +1,11 @@
+export interface CronFields {
+    minutes: Set<number>;
+    hours: Set<number>;
+    daysOfMonth: Set<number>;
+    months: Set<number>;
+    daysOfWeek: Set<number>;
+    hasDom: boolean;
+    hasDow: boolean;
+}
+export declare function parseCron(expression: string): CronFields;
+//# sourceMappingURL=parse.d.ts.map

package/dist/esm/cron/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/cron/parse.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CAChB;AA0FD,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAmBxD"}

package/dist/esm/cron/parse.js

@@ -0,0 +1,96 @@
+const MONTH_NAMES = {
+    jan: 1,
+    feb: 2,
+    mar: 3,
+    apr: 4,
+    may: 5,
+    jun: 6,
+    jul: 7,
+    aug: 8,
+    sep: 9,
+    oct: 10,
+    nov: 11,
+    dec: 12,
+};
+const DOW_NAMES = {
+    sun: 0,
+    mon: 1,
+    tue: 2,
+    wed: 3,
+    thu: 4,
+    fri: 5,
+    sat: 6,
+};
+function parseField(field, min, max, names) {
+    const result = new Set();
+    for (const part of field.split(",")) {
+        const stepParts = part.split("/");
+        const step = stepParts.length > 1 ? Number.parseInt(stepParts[1], 10) : 1;
+        if (Number.isNaN(step) || step < 1) {
+            throw new Error(`Invalid step in cron field: ${part}`);
+        }
+        const rangePart = stepParts[0];
+        if (rangePart === "*") {
+            for (let i = min; i <= max; i += step) {
+                result.add(i);
+            }
+            continue;
+        }
+        const resolve = (val) => {
+            if (names) {
+                const lower = val.toLowerCase();
+                if (lower in names)
+                    return names[lower];
+            }
+            const n = Number.parseInt(val, 10);
+            if (Number.isNaN(n) || n < min || n > max) {
+                throw new Error(`Value out of range [${min}-${max}]: ${val}`);
+            }
+            return n;
+        };
+        if (rangePart.includes("-")) {
+            const [startStr, endStr] = rangePart.split("-");
+            const start = resolve(startStr);
+            const end = resolve(endStr);
+            if (start > end) {
+                // Wrap-around for dow
+                for (let i = start; i <= max; i += step)
+                    result.add(i);
+                for (let i = min; i <= end; i += step)
+                    result.add(i);
+            }
+            else {
+                for (let i = start; i <= end; i += step)
+                    result.add(i);
+            }
+        }
+        else {
+            result.add(resolve(rangePart));
+        }
+    }
+    return result;
+}
+function normalizeDow(set) {
+    if (set.has(7)) {
+        set.add(0);
+        set.delete(7);
+    }
+    return set;
+}
+export function parseCron(expression) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        throw new Error(`Cron expression must have exactly 5 fields, got ${parts.length}: "${expression}"`);
+    }
+    const [minStr, hourStr, domStr, monStr, dowStr] = parts;
+    return {
+        minutes: parseField(minStr, 0, 59),
+        hours: parseField(hourStr, 0, 23),
+        daysOfMonth: parseField(domStr, 1, 31, undefined),
+        months: parseField(monStr, 1, 12, MONTH_NAMES),
+        daysOfWeek: normalizeDow(parseField(dowStr, 0, 7, DOW_NAMES)),
+        hasDom: domStr !== "*",
+        hasDow: dowStr !== "*",
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/esm/cron/parse.js.map

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

package/dist/esm/dlq.d.ts

@@ -0,0 +1,11 @@
+import type { Pool } from "mysql2/promise";
+import type { DeadJob } from "./index.js";
+import { type SqlStatements } from "./sql.js";
+export declare function deadLetterJob(pool: Pool, jobId: string, workerId: string, error: {
+    message: string;
+    stack?: string;
+    at: string;
+}, sql?: SqlStatements): Promise<boolean>;
+export declare function listDead(pool: Pool, queue: string, before: Date, after: Date, limit: number, offset: number, sql?: SqlStatements): Promise<DeadJob[]>;
+export declare function replayDead(pool: Pool, ids: string[], sql?: SqlStatements): Promise<number>;
+//# sourceMappingURL=dlq.d.ts.map

package/dist/esm/dlq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.d.ts","sourceRoot":"","sources":["../../src/dlq.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAkC,MAAM,gBAAgB,CAAC;AAG3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,UAAU,CAAC;AAG9D,wBAAsB,aAAa,CAClC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EACtD,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAaD,wBAAsB,QAAQ,CAC7B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,IAAI,EACZ,KAAK,EAAE,IAAI,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,OAAO,EAAE,CAAC,CAoBpB;AAID,wBAAsB,UAAU,CAC/B,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EAAE,EACb,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,MAAM,CAAC,CAoCjB"}