mysql-boss 0.1.0

package/dist/esm/dlq.js

@@ -0,0 +1,87 @@
+import { acquireConnection, withConnection } from "./connection.js";
+import { SingletonCollisionError } from "./errors.js";
+import { withDeadlockRetry } from "./retry-util.js";
+import { UNPREFIXED_SQL } from "./sql.js";
+import { toUtcString } from "./util.js";
+export async function deadLetterJob(pool, jobId, workerId, error, sql = UNPREFIXED_SQL) {
+    return withDeadlockRetry(async () => {
+        const conn = await acquireConnection(pool);
+        try {
+            await conn.beginTransaction();
+            const [result] = await conn.query(sql.DLQ_INSERT, [
+                JSON.stringify(error),
+                jobId,
+                workerId,
+            ]);
+            if (result.affectedRows === 0) {
+                await conn.commit();
+                return false;
+            }
+            await conn.query(sql.DLQ_DELETE, [jobId, workerId]);
+            await conn.commit();
+            return true;
+        }
+        catch (err) {
+            await conn.rollback().catch(() => { });
+            throw err;
+        }
+        finally {
+            conn.release();
+        }
+    });
+}
+export async function listDead(pool, queue, before, after, limit, offset, sql = UNPREFIXED_SQL) {
+    return withConnection(pool, async (connection) => {
+        const [rows] = await connection.query(sql.LIST_DEAD, [
+            queue,
+            toUtcString(after),
+            toUtcString(before),
+            limit,
+            offset,
+        ]);
+        return rows.map((r) => ({
+            id: r.id,
+            queue: r.queue,
+            payload: r.payload,
+            priority: r.priority,
+            retryCount: r.retry_count,
+            createdAt: new Date(Number(r.created_at_unix) * 1000),
+            failedAt: new Date(Number(r.failed_at_unix) * 1000),
+            lastError: r.last_error,
+        }));
+    });
+}
+const ER_DUP_ENTRY = 1062;
+export async function replayDead(pool, ids, sql = UNPREFIXED_SQL) {
+    return withDeadlockRetry(async () => {
+        const conn = await acquireConnection(pool);
+        try {
+            await conn.beginTransaction();
+            try {
+                const bigIds = ids.map(BigInt);
+                const [result] = await conn.query(sql.REPLAY_INSERT, [
+                    bigIds,
+                ]);
+                if (result.affectedRows > 0) {
+                    await conn.query(sql.REPLAY_DELETE, [bigIds]);
+                }
+                await conn.commit();
+                return result.affectedRows;
+            }
+            catch (err) {
+                await conn.rollback();
+                if (typeof err === "object" &&
+                    err !== null &&
+                    "errno" in err &&
+                    err.errno === ER_DUP_ENTRY) {
+                    throw new SingletonCollisionError("Replay collides with a live singleton job");
+                }
+                throw err;
+            }
+        }
+        finally {
+            conn.release();
+        }
+    });
+}
+//# sourceMappingURL=dlq.js.map

package/dist/esm/dlq.js.map

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

package/dist/esm/errors.d.ts

@@ -0,0 +1,10 @@
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+export declare class SingletonCollisionError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IACrC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACzC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD"}

package/dist/esm/errors.js

@@ -0,0 +1,19 @@
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ValidationError";
+    }
+}
+export class SingletonCollisionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SingletonCollisionError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IACrC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC3B,CAAC;CACD;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACzC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACjD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACvC,CAAC;CACD"}

package/dist/esm/fail.d.ts

@@ -0,0 +1,8 @@
+import type { Pool } from "mysql2/promise";
+import { type SqlStatements } from "./sql.js";
+export declare function failJob(pool: Pool, jobId: string, workerId: string, error: {
+    message: string;
+    stack?: string;
+    at: string;
+}, sql?: SqlStatements): Promise<boolean>;
+//# sourceMappingURL=fail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fail.d.ts","sourceRoot":"","sources":["../../src/fail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAmB,MAAM,gBAAgB,CAAC;AAG5D,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,UAAU,CAAC;AAE9D,wBAAsB,OAAO,CAC5B,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,CAWlB"}

package/dist/esm/fail.js

@@ -0,0 +1,16 @@
+import { withConnection } from "./connection.js";
+import { withDeadlockRetry } from "./retry-util.js";
+import { UNPREFIXED_SQL } from "./sql.js";
+export async function failJob(pool, jobId, workerId, error, sql = UNPREFIXED_SQL) {
+    return withDeadlockRetry(async () => {
+        return withConnection(pool, async (connection) => {
+            const [result] = await connection.query(sql.FAIL_RETRY, [
+                JSON.stringify(error),
+                jobId,
+                workerId,
+            ]);
+            return result.affectedRows > 0;
+        });
+    });
+}
+//# sourceMappingURL=fail.js.map

package/dist/esm/fail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail.js","sourceRoot":"","sources":["../../src/fail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAsB,cAAc,EAAE,MAAM,UAAU,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,OAAO,CAC5B,IAAU,EACV,KAAa,EACb,QAAgB,EAChB,KAAsD,EACtD,GAAG,GAAkB,cAAc;IAEnC,OAAO,iBAAiB,CAAC,KAAK,IAAI,EAAE;QACnC,OAAO,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;YAChD,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,KAAK,CAAkB,GAAG,CAAC,UAAU,EAAE;gBACxE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBACrB,KAAK;gBACL,QAAQ;aACR,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/heartbeat.d.ts

@@ -0,0 +1,4 @@
+import type { Pool } from "mysql2/promise";
+import { type SqlStatements } from "./sql.js";
+export declare function heartbeatOwnedJobs(pool: Pool, jobIds: bigint[], workerId: string, leaseSeconds: number, sql?: SqlStatements): Promise<Set<string>>;
+//# sourceMappingURL=heartbeat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAiB,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,UAAU,CAAC;AAM9D,wBAAsB,kBAAkB,CACvC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAUtB"}

package/dist/esm/heartbeat.js

@@ -0,0 +1,15 @@
+import { withConnection } from "./connection.js";
+import { UNPREFIXED_SQL } from "./sql.js";
+export async function heartbeatOwnedJobs(pool, jobIds, workerId, leaseSeconds, sql = UNPREFIXED_SQL) {
+    if (jobIds.length === 0)
+        return new Set();
+    return withConnection(pool, async (connection) => {
+        await connection.query(sql.HEARTBEAT, [leaseSeconds, jobIds, workerId]);
+        const [rows] = await connection.query(sql.HEARTBEAT_OWNED, [
+            jobIds,
+            workerId,
+        ]);
+        return new Set(rows.map((row) => row.id));
+    });
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/esm/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/heartbeat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAsB,cAAc,EAAE,MAAM,UAAU,CAAC;AAM9D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,IAAU,EACV,MAAgB,EAChB,QAAgB,EAChB,YAAoB,EACpB,GAAG,GAAkB,cAAc;IAEnC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IAC1C,OAAO,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;QAChD,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,UAAU,CAAC,KAAK,CAAa,GAAG,CAAC,eAAe,EAAE;YACtE,MAAM;YACN,QAAQ;SACR,CAAC,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,70 @@
+import type { Pool } from "mysql2/promise";
+export interface MysqlBossOptions {
+    pool: Pool;
+    /**
+     * Prefix for all queue tables. Defaults to "mysql_boss", producing
+     * mysql_boss_jobs, mysql_boss_jobs_archive, mysql_boss_jobs_dead, and
+     * mysql_boss_schedules. Set to "" to use the legacy unprefixed names.
+     */
+    tablePrefix?: string;
+    pollIntervalMs?: number;
+    batchSize?: number;
+    concurrency?: number;
+    leaseSeconds?: number;
+    heartbeatSeconds?: number;
+    sweepIntervalMs?: number;
+    tickIntervalMs?: number;
+    archiveRetentionDays?: number;
+    drainTimeoutMs?: number;
+    onError?: (err: unknown, context: string) => void;
+}
+export interface EnqueueOptions {
+    priority?: number;
+    singletonKey?: string;
+    retryLimit?: number;
+    retryDelaySecs?: number;
+    retryBackoff?: boolean;
+    runAt?: Date;
+}
+export interface ActiveJob<T = unknown> {
+    id: string;
+    queue: string;
+    payload: T;
+    retryCount: number;
+    retryLimit: number;
+}
+export type JobHandler<T = unknown> = (job: ActiveJob<T>, ctx: {
+    signal: AbortSignal;
+}) => Promise<void>;
+export interface DeadJob<T = unknown> {
+    id: string;
+    queue: string;
+    payload: T;
+    priority: number;
+    retryCount: number;
+    createdAt: Date;
+    failedAt: Date;
+    lastError: {
+        message: string;
+        stack?: string;
+        at: string;
+    } | null;
+}
+export interface ArchivedJob<T = unknown> {
+    id: string;
+    queue: string;
+    payload: T;
+    priority: number;
+    retryCount: number;
+    createdAt: Date;
+    startedAt: Date;
+    completedAt: Date;
+    durationMs: number;
+}
+export interface ScheduleOptions extends Omit<EnqueueOptions, "singletonKey" | "runAt"> {
+    timezone?: string;
+    payload?: unknown;
+}
+export { MysqlBoss } from "./boss.js";
+export { ConfigError, ValidationError, SingletonCollisionError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,IAAI,CAAC;IACX;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,CACrC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,EACjB,GAAG,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,OAAO;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAChB,SAAQ,IAAI,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACN,WAAW,EACX,eAAe,EACf,uBAAuB,GACvB,MAAM,aAAa,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+export { MysqlBoss } from "./boss.js";
+export { ConfigError, ValidationError, SingletonCollisionError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAyEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACN,WAAW,EACX,eAAe,EACf,uBAAuB,GACvB,MAAM,aAAa,CAAC"}

package/dist/esm/migrate.d.ts

@@ -0,0 +1,4 @@
+import type { Pool } from "mysql2/promise";
+import { type SqlStatements } from "./sql.js";
+export declare function migrate(pool: Pool, sql?: SqlStatements): Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,UAAU,CAAC;AAE9D,wBAAsB,OAAO,CAC5B,IAAI,EAAE,IAAI,EACV,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/esm/migrate.js

@@ -0,0 +1,11 @@
+import { withConnection } from "./connection.js";
+import { UNPREFIXED_SQL } from "./sql.js";
+export async function migrate(pool, sql = UNPREFIXED_SQL) {
+    await withConnection(pool, async (connection) => {
+        await connection.query(sql.CREATE_JOBS);
+        await connection.query(sql.CREATE_JOBS_ARCHIVE);
+        await connection.query(sql.CREATE_JOBS_DEAD);
+        await connection.query(sql.CREATE_SCHEDULES);
+    });
+}
+//# sourceMappingURL=migrate.js.map

package/dist/esm/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/migrate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAsB,cAAc,EAAE,MAAM,UAAU,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,OAAO,CAC5B,IAAU,EACV,GAAG,GAAkB,cAAc;IAEnC,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;QAC/C,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAChD,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/retry-util.d.ts

@@ -0,0 +1,2 @@
+export declare function withDeadlockRetry<T>(fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=retry-util.d.ts.map

package/dist/esm/retry-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-util.d.ts","sourceRoot":"","sources":["../../src/retry-util.ts"],"names":[],"mappings":"AAYA,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAe3E"}

package/dist/esm/retry-util.js

@@ -0,0 +1,28 @@
+const ER_LOCK_DEADLOCK = 1213;
+const ER_LOCK_WAIT_TIMEOUT = 1205;
+const MAX_RETRIES = 3;
+function isRetryable(err) {
+    if (typeof err === "object" && err !== null && "errno" in err) {
+        const errno = err.errno;
+        return errno === ER_LOCK_DEADLOCK || errno === ER_LOCK_WAIT_TIMEOUT;
+    }
+    return false;
+}
+export async function withDeadlockRetry(fn) {
+    let lastErr;
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastErr = err;
+            if (!isRetryable(err) || attempt === MAX_RETRIES - 1) {
+                throw err;
+            }
+            const jitter = Math.random() * 50 * (attempt + 1);
+            await new Promise((resolve) => setTimeout(resolve, jitter));
+        }
+    }
+    throw lastErr;
+}
+//# sourceMappingURL=retry-util.js.map

package/dist/esm/retry-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-util.js","sourceRoot":"","sources":["../../src/retry-util.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,SAAS,WAAW,CAAC,GAAY;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAI,GAAyB,CAAC,KAAK,CAAC;QAC/C,OAAO,KAAK,KAAK,gBAAgB,IAAI,KAAK,KAAK,oBAAoB,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAI,EAAoB;IAC9D,IAAI,OAAgB,CAAC;IACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACJ,OAAO,MAAM,EAAE,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,GAAG,GAAG,CAAC;YACd,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,WAAW,GAAG,CAAC,EAAE,CAAC;gBACtD,MAAM,GAAG,CAAC;YACX,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAClD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7D,CAAC;IACF,CAAC;IACD,MAAM,OAAO,CAAC;AACf,CAAC"}

package/dist/esm/sql.d.ts

@@ -0,0 +1,82 @@
+export declare const CREATE_JOBS = "\nCREATE TABLE IF NOT EXISTS jobs (\n  id               BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,\n  queue            VARCHAR(128)    NOT NULL,\n  state            ENUM('available','active') NOT NULL DEFAULT 'available',\n  priority         SMALLINT        NOT NULL DEFAULT 0,\n  payload          JSON            NULL,\n  singleton_key    VARCHAR(191)    NULL,\n  retry_count      INT UNSIGNED    NOT NULL DEFAULT 0,\n  retry_limit      INT UNSIGNED    NOT NULL DEFAULT 2,\n  retry_delay_secs INT UNSIGNED    NOT NULL DEFAULT 30,\n  retry_backoff    TINYINT(1)      NOT NULL DEFAULT 0,\n  run_at           DATETIME(6)     NOT NULL,\n  created_at       DATETIME(6)     NOT NULL DEFAULT (UTC_TIMESTAMP(6)),\n  started_at       DATETIME(6)     NULL,\n  locked_by        BINARY(16)      NULL,\n  lease_expires_at DATETIME(6)     NULL,\n  last_error       JSON            NULL,\n  PRIMARY KEY (id),\n  UNIQUE KEY uq_jobs_singleton (queue, singleton_key),\n  KEY ix_jobs_dequeue (queue, state, priority DESC, run_at, id),\n  KEY ix_jobs_lease   (state, lease_expires_at)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;\n";
+export declare const CREATE_JOBS_ARCHIVE = "\nCREATE TABLE IF NOT EXISTS jobs_archive (\n  id            BIGINT UNSIGNED NOT NULL,\n  queue         VARCHAR(128)    NOT NULL,\n  priority      SMALLINT        NOT NULL,\n  payload       JSON            NULL,\n  singleton_key VARCHAR(191)    NULL,\n  retry_count   INT UNSIGNED    NOT NULL,\n  created_at    DATETIME(6)     NOT NULL,\n  started_at    DATETIME(6)     NOT NULL,\n  completed_at  DATETIME(6)     NOT NULL DEFAULT (UTC_TIMESTAMP(6)),\n  duration_ms   INT UNSIGNED    NOT NULL,\n  PRIMARY KEY (id),\n  KEY ix_archive_queue_time (queue, completed_at),\n  KEY ix_archive_time       (completed_at)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;\n";
+export declare const CREATE_JOBS_DEAD = "\nCREATE TABLE IF NOT EXISTS jobs_dead (\n  id               BIGINT UNSIGNED NOT NULL,\n  queue            VARCHAR(128)    NOT NULL,\n  priority         SMALLINT        NOT NULL,\n  payload          JSON            NULL,\n  singleton_key    VARCHAR(191)    NULL,\n  retry_count      INT UNSIGNED    NOT NULL,\n  retry_limit      INT UNSIGNED    NOT NULL,\n  retry_delay_secs INT UNSIGNED    NOT NULL,\n  retry_backoff    TINYINT(1)      NOT NULL,\n  created_at       DATETIME(6)     NOT NULL,\n  failed_at        DATETIME(6)     NOT NULL DEFAULT (UTC_TIMESTAMP(6)),\n  last_error       JSON            NULL,\n  PRIMARY KEY (id),\n  KEY ix_dead_queue_time (queue, failed_at)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;\n";
+export declare const CREATE_SCHEDULES = "\nCREATE TABLE IF NOT EXISTS schedules (\n  name             VARCHAR(128) NOT NULL,\n  queue            VARCHAR(128) NOT NULL,\n  cron             VARCHAR(64)  NOT NULL,\n  timezone         VARCHAR(64)  NOT NULL DEFAULT 'UTC',\n  payload          JSON         NULL,\n  job_options      JSON         NULL,\n  next_run_at      DATETIME(6)  NOT NULL,\n  last_enqueued_at DATETIME(6)  NULL,\n  updated_at       DATETIME(6)  NOT NULL DEFAULT (UTC_TIMESTAMP(6))\n                                ON UPDATE CURRENT_TIMESTAMP(6),\n  PRIMARY KEY (name),\n  KEY ix_schedules_due (next_run_at)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;\n";
+export declare const ENQUEUE = "\nINSERT INTO jobs\n  (queue, priority, payload, singleton_key,\n   retry_limit, retry_delay_secs, retry_backoff, run_at)\nVALUES\n  (?, ?, ?, ?, ?, ?, ?, COALESCE(?, UTC_TIMESTAMP(6)));\n";
+export declare const ENQUEUE_SINGLETON = "\nINSERT IGNORE INTO jobs\n  (queue, priority, payload, singleton_key,\n   retry_limit, retry_delay_secs, retry_backoff, run_at)\nVALUES\n  (?, ?, ?, ?, ?, ?, ?, COALESCE(?, UTC_TIMESTAMP(6)));\n";
+export declare const LAST_INSERT_ID = "\nSELECT CAST(LAST_INSERT_ID() AS CHAR) AS id;\n";
+export declare const CLAIM_SELECT = "\nSELECT CAST(id AS CHAR) AS id, queue, payload, retry_count, retry_limit,\n       retry_delay_secs, retry_backoff\nFROM jobs\nWHERE queue = ?\n  AND state = 'available'\n  AND run_at <= UTC_TIMESTAMP(6)\nORDER BY priority DESC, run_at, id\nLIMIT ?\nFOR UPDATE SKIP LOCKED;\n";
+export declare const CLAIM_UPDATE = "\nUPDATE jobs\nSET state = 'active',\n    started_at = UTC_TIMESTAMP(6),\n    locked_by = UUID_TO_BIN(?),\n    lease_expires_at = UTC_TIMESTAMP(6) + INTERVAL ? SECOND\nWHERE id IN (?);\n";
+export declare const COMPLETE_ARCHIVE = "\nINSERT INTO jobs_archive\n  (id, queue, priority, payload, singleton_key, retry_count,\n   created_at, started_at, duration_ms)\nSELECT id, queue, priority, payload, singleton_key, retry_count,\n       created_at, started_at,\n       TIMESTAMPDIFF(MICROSECOND, started_at, UTC_TIMESTAMP(6)) DIV 1000\nFROM jobs\nWHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+export declare const COMPLETE_DELETE = "\nDELETE FROM jobs\nWHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+export declare const FAIL_RETRY = "\nUPDATE jobs\nSET state = 'available',\n    run_at = UTC_TIMESTAMP(6) + INTERVAL\n      LEAST(\n        86400,\n        IF(retry_backoff = 1,\n           retry_delay_secs * POW(2, retry_count),\n           retry_delay_secs)\n        + FLOOR(RAND() * retry_delay_secs)\n      ) SECOND,\n    retry_count = retry_count + 1,\n    locked_by = NULL,\n    lease_expires_at = NULL,\n    started_at = NULL,\n    last_error = ?\nWHERE id = ?\n  AND locked_by = UUID_TO_BIN(?)\n  AND state = 'active'\n  AND retry_count < retry_limit;\n";
+export declare const DLQ_INSERT = "\nINSERT INTO jobs_dead\n  (id, queue, priority, payload, singleton_key,\n   retry_count, retry_limit, retry_delay_secs, retry_backoff,\n   created_at, last_error)\nSELECT id, queue, priority, payload, singleton_key,\n       retry_count + 1, retry_limit, retry_delay_secs, retry_backoff,\n       created_at, ?\nFROM jobs\nWHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+export declare const DLQ_DELETE = "\nDELETE FROM jobs\nWHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+export declare const LIST_DEAD = "\nSELECT CAST(id AS CHAR) AS id, queue, priority, payload, retry_count,\n       UNIX_TIMESTAMP(created_at) AS created_at_unix,\n       UNIX_TIMESTAMP(failed_at) AS failed_at_unix,\n       last_error\nFROM jobs_dead\nWHERE queue = ? AND failed_at BETWEEN ? AND ?\nORDER BY failed_at DESC\nLIMIT ? OFFSET ?;\n";
+export declare const REPLAY_INSERT = "\nINSERT INTO jobs\n  (queue, priority, payload, singleton_key,\n   retry_limit, retry_delay_secs, retry_backoff, run_at)\nSELECT queue, priority, payload, singleton_key,\n       retry_limit, retry_delay_secs, retry_backoff, UTC_TIMESTAMP(6)\nFROM jobs_dead\nWHERE id IN (?)\nFOR UPDATE;\n";
+export declare const REPLAY_DELETE = "\nDELETE FROM jobs_dead WHERE id IN (?);\n";
+export declare const DB_NOW = "SELECT UNIX_TIMESTAMP(UTC_TIMESTAMP(6)) AS db_now_unix;";
+export declare const TICK_SELECT = "\nSELECT name, queue, cron, timezone, payload, job_options,\n       next_run_at,\n       UNIX_TIMESTAMP(next_run_at) AS next_run_at_unix\nFROM schedules\nWHERE next_run_at <= UTC_TIMESTAMP(6)\nORDER BY next_run_at\nLIMIT 20\nFOR UPDATE SKIP LOCKED;\n";
+export declare const TICK_ENQUEUE = "\nINSERT IGNORE INTO jobs\n  (queue, priority, payload, singleton_key,\n   retry_limit, retry_delay_secs, retry_backoff, run_at)\nVALUES\n  (?, ?, ?, CONCAT('cron:', ?, ':', DATE_FORMAT(?, '%Y%m%d%H%i%s')),\n   ?, ?, ?, UTC_TIMESTAMP(6));\n";
+export declare const TICK_ADVANCE = "\nUPDATE schedules\nSET next_run_at = ?, last_enqueued_at = UTC_TIMESTAMP(6)\nWHERE name = ?;\n";
+export declare const SCHEDULE_UPSERT = "\nINSERT INTO schedules (name, queue, cron, timezone, payload, job_options, next_run_at)\nVALUES (?, ?, ?, ?, ?, ?, ?)\nON DUPLICATE KEY UPDATE\n  queue = VALUES(queue),\n  cron = VALUES(cron),\n  timezone = VALUES(timezone),\n  payload = VALUES(payload),\n  job_options = VALUES(job_options),\n  next_run_at = VALUES(next_run_at);\n";
+export declare const SCHEDULE_DELETE = "\nDELETE FROM schedules WHERE name = ?;\n";
+export declare const HEARTBEAT = "\nUPDATE jobs\nSET lease_expires_at = UTC_TIMESTAMP(6) + INTERVAL ? SECOND\nWHERE id IN (?) AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+export declare const HEARTBEAT_OWNED = "\nSELECT CAST(id AS CHAR) AS id\nFROM jobs\nWHERE id IN (?) AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+export declare const DRAIN_RELEASE = "\nUPDATE jobs\nSET state = 'available', run_at = UTC_TIMESTAMP(6),\n    locked_by = NULL, lease_expires_at = NULL, started_at = NULL\nWHERE id IN (?) AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+export declare const SWEEP_SELECT = "\nSELECT CAST(id AS CHAR) AS id, retry_count, retry_limit\nFROM jobs\nWHERE state = 'active' AND lease_expires_at < UTC_TIMESTAMP(6)\nORDER BY lease_expires_at\nLIMIT 100\nFOR UPDATE SKIP LOCKED;\n";
+export declare const SWEEP_RETRY = "\nUPDATE jobs\nSET state = 'available',\n    run_at = UTC_TIMESTAMP(6) + INTERVAL\n      LEAST(\n        86400,\n        IF(retry_backoff = 1,\n           retry_delay_secs * POW(2, retry_count),\n           retry_delay_secs)\n        + FLOOR(RAND() * retry_delay_secs)\n      ) SECOND,\n    retry_count = retry_count + 1,\n    locked_by = NULL, lease_expires_at = NULL, started_at = NULL,\n    last_error = JSON_OBJECT('message', 'lease expired', 'at', UTC_TIMESTAMP(6))\nWHERE id IN (?) AND retry_count < retry_limit;\n";
+export declare const SWEEP_DLQ_INSERT = "\nINSERT INTO jobs_dead\n  (id, queue, priority, payload, singleton_key,\n   retry_count, retry_limit, retry_delay_secs, retry_backoff,\n   created_at, last_error)\nSELECT id, queue, priority, payload, singleton_key,\n       retry_count + 1, retry_limit, retry_delay_secs, retry_backoff,\n       created_at, JSON_OBJECT('message', 'lease expired', 'at', UTC_TIMESTAMP(6))\nFROM jobs\nWHERE id IN (?);\n";
+export declare const SWEEP_DLQ_DELETE = "\nDELETE FROM jobs WHERE id IN (?);\n";
+export declare const ARCHIVE_PRUNE = "\nDELETE FROM jobs_archive\nWHERE completed_at < UTC_TIMESTAMP(6) - INTERVAL ? DAY\nORDER BY completed_at\nLIMIT 5000;\n";
+export declare const GET_ARCHIVED_JOB = "\nSELECT CAST(id AS CHAR) AS id, queue, priority, payload, singleton_key, retry_count,\n       UNIX_TIMESTAMP(created_at) AS created_at_unix,\n       UNIX_TIMESTAMP(started_at) AS started_at_unix,\n       UNIX_TIMESTAMP(completed_at) AS completed_at_unix,\n       duration_ms\nFROM jobs_archive\nWHERE id = ?;\n";
+export declare const LIST_ARCHIVE = "\nSELECT CAST(id AS CHAR) AS id, queue, priority, payload, singleton_key, retry_count,\n       UNIX_TIMESTAMP(created_at) AS created_at_unix,\n       UNIX_TIMESTAMP(started_at) AS started_at_unix,\n       UNIX_TIMESTAMP(completed_at) AS completed_at_unix,\n       duration_ms\nFROM jobs_archive\nWHERE queue = ? AND completed_at < ?\nORDER BY completed_at DESC\nLIMIT ?;\n";
+export declare const INIT_SESSION = "\nSET SESSION transaction_isolation = 'READ-COMMITTED',\n            SESSION time_zone = '+00:00';\n";
+export declare const DEFAULT_TABLE_PREFIX = "mysql_boss";
+export declare const UNPREFIXED_SQL: {
+    readonly CREATE_JOBS: "\nCREATE TABLE IF NOT EXISTS jobs (\n  id               BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,\n  queue            VARCHAR(128)    NOT NULL,\n  state            ENUM('available','active') NOT NULL DEFAULT 'available',\n  priority         SMALLINT        NOT NULL DEFAULT 0,\n  payload          JSON            NULL,\n  singleton_key    VARCHAR(191)    NULL,\n  retry_count      INT UNSIGNED    NOT NULL DEFAULT 0,\n  retry_limit      INT UNSIGNED    NOT NULL DEFAULT 2,\n  retry_delay_secs INT UNSIGNED    NOT NULL DEFAULT 30,\n  retry_backoff    TINYINT(1)      NOT NULL DEFAULT 0,\n  run_at           DATETIME(6)     NOT NULL,\n  created_at       DATETIME(6)     NOT NULL DEFAULT (UTC_TIMESTAMP(6)),\n  started_at       DATETIME(6)     NULL,\n  locked_by        BINARY(16)      NULL,\n  lease_expires_at DATETIME(6)     NULL,\n  last_error       JSON            NULL,\n  PRIMARY KEY (id),\n  UNIQUE KEY uq_jobs_singleton (queue, singleton_key),\n  KEY ix_jobs_dequeue (queue, state, priority DESC, run_at, id),\n  KEY ix_jobs_lease   (state, lease_expires_at)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;\n";
+    readonly CREATE_JOBS_ARCHIVE: "\nCREATE TABLE IF NOT EXISTS jobs_archive (\n  id            BIGINT UNSIGNED NOT NULL,\n  queue         VARCHAR(128)    NOT NULL,\n  priority      SMALLINT        NOT NULL,\n  payload       JSON            NULL,\n  singleton_key VARCHAR(191)    NULL,\n  retry_count   INT UNSIGNED    NOT NULL,\n  created_at    DATETIME(6)     NOT NULL,\n  started_at    DATETIME(6)     NOT NULL,\n  completed_at  DATETIME(6)     NOT NULL DEFAULT (UTC_TIMESTAMP(6)),\n  duration_ms   INT UNSIGNED    NOT NULL,\n  PRIMARY KEY (id),\n  KEY ix_archive_queue_time (queue, completed_at),\n  KEY ix_archive_time       (completed_at)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;\n";
+    readonly CREATE_JOBS_DEAD: "\nCREATE TABLE IF NOT EXISTS jobs_dead (\n  id               BIGINT UNSIGNED NOT NULL,\n  queue            VARCHAR(128)    NOT NULL,\n  priority         SMALLINT        NOT NULL,\n  payload          JSON            NULL,\n  singleton_key    VARCHAR(191)    NULL,\n  retry_count      INT UNSIGNED    NOT NULL,\n  retry_limit      INT UNSIGNED    NOT NULL,\n  retry_delay_secs INT UNSIGNED    NOT NULL,\n  retry_backoff    TINYINT(1)      NOT NULL,\n  created_at       DATETIME(6)     NOT NULL,\n  failed_at        DATETIME(6)     NOT NULL DEFAULT (UTC_TIMESTAMP(6)),\n  last_error       JSON            NULL,\n  PRIMARY KEY (id),\n  KEY ix_dead_queue_time (queue, failed_at)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;\n";
+    readonly CREATE_SCHEDULES: "\nCREATE TABLE IF NOT EXISTS schedules (\n  name             VARCHAR(128) NOT NULL,\n  queue            VARCHAR(128) NOT NULL,\n  cron             VARCHAR(64)  NOT NULL,\n  timezone         VARCHAR(64)  NOT NULL DEFAULT 'UTC',\n  payload          JSON         NULL,\n  job_options      JSON         NULL,\n  next_run_at      DATETIME(6)  NOT NULL,\n  last_enqueued_at DATETIME(6)  NULL,\n  updated_at       DATETIME(6)  NOT NULL DEFAULT (UTC_TIMESTAMP(6))\n                                ON UPDATE CURRENT_TIMESTAMP(6),\n  PRIMARY KEY (name),\n  KEY ix_schedules_due (next_run_at)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;\n";
+    readonly ENQUEUE: "\nINSERT INTO jobs\n  (queue, priority, payload, singleton_key,\n   retry_limit, retry_delay_secs, retry_backoff, run_at)\nVALUES\n  (?, ?, ?, ?, ?, ?, ?, COALESCE(?, UTC_TIMESTAMP(6)));\n";
+    readonly ENQUEUE_SINGLETON: "\nINSERT IGNORE INTO jobs\n  (queue, priority, payload, singleton_key,\n   retry_limit, retry_delay_secs, retry_backoff, run_at)\nVALUES\n  (?, ?, ?, ?, ?, ?, ?, COALESCE(?, UTC_TIMESTAMP(6)));\n";
+    readonly LAST_INSERT_ID: "\nSELECT CAST(LAST_INSERT_ID() AS CHAR) AS id;\n";
+    readonly CLAIM_SELECT: "\nSELECT CAST(id AS CHAR) AS id, queue, payload, retry_count, retry_limit,\n       retry_delay_secs, retry_backoff\nFROM jobs\nWHERE queue = ?\n  AND state = 'available'\n  AND run_at <= UTC_TIMESTAMP(6)\nORDER BY priority DESC, run_at, id\nLIMIT ?\nFOR UPDATE SKIP LOCKED;\n";
+    readonly CLAIM_UPDATE: "\nUPDATE jobs\nSET state = 'active',\n    started_at = UTC_TIMESTAMP(6),\n    locked_by = UUID_TO_BIN(?),\n    lease_expires_at = UTC_TIMESTAMP(6) + INTERVAL ? SECOND\nWHERE id IN (?);\n";
+    readonly COMPLETE_ARCHIVE: "\nINSERT INTO jobs_archive\n  (id, queue, priority, payload, singleton_key, retry_count,\n   created_at, started_at, duration_ms)\nSELECT id, queue, priority, payload, singleton_key, retry_count,\n       created_at, started_at,\n       TIMESTAMPDIFF(MICROSECOND, started_at, UTC_TIMESTAMP(6)) DIV 1000\nFROM jobs\nWHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+    readonly COMPLETE_DELETE: "\nDELETE FROM jobs\nWHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+    readonly FAIL_RETRY: "\nUPDATE jobs\nSET state = 'available',\n    run_at = UTC_TIMESTAMP(6) + INTERVAL\n      LEAST(\n        86400,\n        IF(retry_backoff = 1,\n           retry_delay_secs * POW(2, retry_count),\n           retry_delay_secs)\n        + FLOOR(RAND() * retry_delay_secs)\n      ) SECOND,\n    retry_count = retry_count + 1,\n    locked_by = NULL,\n    lease_expires_at = NULL,\n    started_at = NULL,\n    last_error = ?\nWHERE id = ?\n  AND locked_by = UUID_TO_BIN(?)\n  AND state = 'active'\n  AND retry_count < retry_limit;\n";
+    readonly DLQ_INSERT: "\nINSERT INTO jobs_dead\n  (id, queue, priority, payload, singleton_key,\n   retry_count, retry_limit, retry_delay_secs, retry_backoff,\n   created_at, last_error)\nSELECT id, queue, priority, payload, singleton_key,\n       retry_count + 1, retry_limit, retry_delay_secs, retry_backoff,\n       created_at, ?\nFROM jobs\nWHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+    readonly DLQ_DELETE: "\nDELETE FROM jobs\nWHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+    readonly LIST_DEAD: "\nSELECT CAST(id AS CHAR) AS id, queue, priority, payload, retry_count,\n       UNIX_TIMESTAMP(created_at) AS created_at_unix,\n       UNIX_TIMESTAMP(failed_at) AS failed_at_unix,\n       last_error\nFROM jobs_dead\nWHERE queue = ? AND failed_at BETWEEN ? AND ?\nORDER BY failed_at DESC\nLIMIT ? OFFSET ?;\n";
+    readonly REPLAY_INSERT: "\nINSERT INTO jobs\n  (queue, priority, payload, singleton_key,\n   retry_limit, retry_delay_secs, retry_backoff, run_at)\nSELECT queue, priority, payload, singleton_key,\n       retry_limit, retry_delay_secs, retry_backoff, UTC_TIMESTAMP(6)\nFROM jobs_dead\nWHERE id IN (?)\nFOR UPDATE;\n";
+    readonly REPLAY_DELETE: "\nDELETE FROM jobs_dead WHERE id IN (?);\n";
+    readonly DB_NOW: "SELECT UNIX_TIMESTAMP(UTC_TIMESTAMP(6)) AS db_now_unix;";
+    readonly TICK_SELECT: "\nSELECT name, queue, cron, timezone, payload, job_options,\n       next_run_at,\n       UNIX_TIMESTAMP(next_run_at) AS next_run_at_unix\nFROM schedules\nWHERE next_run_at <= UTC_TIMESTAMP(6)\nORDER BY next_run_at\nLIMIT 20\nFOR UPDATE SKIP LOCKED;\n";
+    readonly TICK_ENQUEUE: "\nINSERT IGNORE INTO jobs\n  (queue, priority, payload, singleton_key,\n   retry_limit, retry_delay_secs, retry_backoff, run_at)\nVALUES\n  (?, ?, ?, CONCAT('cron:', ?, ':', DATE_FORMAT(?, '%Y%m%d%H%i%s')),\n   ?, ?, ?, UTC_TIMESTAMP(6));\n";
+    readonly TICK_ADVANCE: "\nUPDATE schedules\nSET next_run_at = ?, last_enqueued_at = UTC_TIMESTAMP(6)\nWHERE name = ?;\n";
+    readonly SCHEDULE_UPSERT: "\nINSERT INTO schedules (name, queue, cron, timezone, payload, job_options, next_run_at)\nVALUES (?, ?, ?, ?, ?, ?, ?)\nON DUPLICATE KEY UPDATE\n  queue = VALUES(queue),\n  cron = VALUES(cron),\n  timezone = VALUES(timezone),\n  payload = VALUES(payload),\n  job_options = VALUES(job_options),\n  next_run_at = VALUES(next_run_at);\n";
+    readonly SCHEDULE_DELETE: "\nDELETE FROM schedules WHERE name = ?;\n";
+    readonly HEARTBEAT: "\nUPDATE jobs\nSET lease_expires_at = UTC_TIMESTAMP(6) + INTERVAL ? SECOND\nWHERE id IN (?) AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+    readonly HEARTBEAT_OWNED: "\nSELECT CAST(id AS CHAR) AS id\nFROM jobs\nWHERE id IN (?) AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+    readonly DRAIN_RELEASE: "\nUPDATE jobs\nSET state = 'available', run_at = UTC_TIMESTAMP(6),\n    locked_by = NULL, lease_expires_at = NULL, started_at = NULL\nWHERE id IN (?) AND locked_by = UUID_TO_BIN(?) AND state = 'active';\n";
+    readonly SWEEP_SELECT: "\nSELECT CAST(id AS CHAR) AS id, retry_count, retry_limit\nFROM jobs\nWHERE state = 'active' AND lease_expires_at < UTC_TIMESTAMP(6)\nORDER BY lease_expires_at\nLIMIT 100\nFOR UPDATE SKIP LOCKED;\n";
+    readonly SWEEP_RETRY: "\nUPDATE jobs\nSET state = 'available',\n    run_at = UTC_TIMESTAMP(6) + INTERVAL\n      LEAST(\n        86400,\n        IF(retry_backoff = 1,\n           retry_delay_secs * POW(2, retry_count),\n           retry_delay_secs)\n        + FLOOR(RAND() * retry_delay_secs)\n      ) SECOND,\n    retry_count = retry_count + 1,\n    locked_by = NULL, lease_expires_at = NULL, started_at = NULL,\n    last_error = JSON_OBJECT('message', 'lease expired', 'at', UTC_TIMESTAMP(6))\nWHERE id IN (?) AND retry_count < retry_limit;\n";
+    readonly SWEEP_DLQ_INSERT: "\nINSERT INTO jobs_dead\n  (id, queue, priority, payload, singleton_key,\n   retry_count, retry_limit, retry_delay_secs, retry_backoff,\n   created_at, last_error)\nSELECT id, queue, priority, payload, singleton_key,\n       retry_count + 1, retry_limit, retry_delay_secs, retry_backoff,\n       created_at, JSON_OBJECT('message', 'lease expired', 'at', UTC_TIMESTAMP(6))\nFROM jobs\nWHERE id IN (?);\n";
+    readonly SWEEP_DLQ_DELETE: "\nDELETE FROM jobs WHERE id IN (?);\n";
+    readonly ARCHIVE_PRUNE: "\nDELETE FROM jobs_archive\nWHERE completed_at < UTC_TIMESTAMP(6) - INTERVAL ? DAY\nORDER BY completed_at\nLIMIT 5000;\n";
+    readonly GET_ARCHIVED_JOB: "\nSELECT CAST(id AS CHAR) AS id, queue, priority, payload, singleton_key, retry_count,\n       UNIX_TIMESTAMP(created_at) AS created_at_unix,\n       UNIX_TIMESTAMP(started_at) AS started_at_unix,\n       UNIX_TIMESTAMP(completed_at) AS completed_at_unix,\n       duration_ms\nFROM jobs_archive\nWHERE id = ?;\n";
+    readonly LIST_ARCHIVE: "\nSELECT CAST(id AS CHAR) AS id, queue, priority, payload, singleton_key, retry_count,\n       UNIX_TIMESTAMP(created_at) AS created_at_unix,\n       UNIX_TIMESTAMP(started_at) AS started_at_unix,\n       UNIX_TIMESTAMP(completed_at) AS completed_at_unix,\n       duration_ms\nFROM jobs_archive\nWHERE queue = ? AND completed_at < ?\nORDER BY completed_at DESC\nLIMIT ?;\n";
+};
+export type SqlStatements = {
+    [K in keyof typeof UNPREFIXED_SQL]: string;
+};
+/**
+ * Builds the SQL used by one MysqlBoss instance.
+ *
+ * Prefixes are deliberately limited to portable identifier characters. This
+ * lets us quote every generated table name safely instead of interpolating an
+ * arbitrary SQL identifier.
+ */
+export declare function createSql(tablePrefix?: string): SqlStatements;
+//# sourceMappingURL=sql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/sql.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,mnCAuBvB,CAAC;AAEF,eAAO,MAAM,mBAAmB,6qBAgB/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,6uBAiB5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,ipBAe5B,CAAC;AAIF,eAAO,MAAM,OAAO,iMAMnB,CAAC;AAEF,eAAO,MAAM,iBAAiB,wMAM7B,CAAC;AAEF,eAAO,MAAM,cAAc,qDAE1B,CAAC;AAIF,eAAO,MAAM,YAAY,wRAUxB,CAAC;AAEF,eAAO,MAAM,YAAY,+LAOxB,CAAC;AAIF,eAAO,MAAM,gBAAgB,kYAS5B,CAAC;AAEF,eAAO,MAAM,eAAe,4FAG3B,CAAC;AAIF,eAAO,MAAM,UAAU,mhBAoBtB,CAAC;AAIF,eAAO,MAAM,UAAU,0YAUtB,CAAC;AAEF,eAAO,MAAM,UAAU,4FAGtB,CAAC;AAIF,eAAO,MAAM,SAAS,wTASrB,CAAC;AAIF,eAAO,MAAM,aAAa,sSASzB,CAAC;AAEF,eAAO,MAAM,aAAa,+CAEzB,CAAC;AAIF,eAAO,MAAM,MAAM,4DAA4D,CAAC;AAEhF,eAAO,MAAM,WAAW,+PASvB,CAAC;AAEF,eAAO,MAAM,YAAY,qPAOxB,CAAC;AAEF,eAAO,MAAM,YAAY,oGAIxB,CAAC;AAIF,eAAO,MAAM,eAAe,kVAU3B,CAAC;AAEF,eAAO,MAAM,eAAe,8CAE3B,CAAC;AAIF,eAAO,MAAM,SAAS,uJAIrB,CAAC;AAEF,eAAO,MAAM,eAAe,uHAI3B,CAAC;AAIF,eAAO,MAAM,aAAa,iNAKzB,CAAC;AAIF,eAAO,MAAM,YAAY,0MAOxB,CAAC;AAEF,eAAO,MAAM,WAAW,6gBAevB,CAAC;AAEF,eAAO,MAAM,gBAAgB,uZAU5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,0CAE5B,CAAC;AAIF,eAAO,MAAM,aAAa,6HAKzB,CAAC;AAIF,eAAO,MAAM,gBAAgB,4TAQ5B,CAAC;AAEF,eAAO,MAAM,YAAY,yXAUxB,CAAC;AAIF,eAAO,MAAM,YAAY,yGAGxB,CAAC;AAEF,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCjB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG;KAC1B,CAAC,IAAI,MAAM,OAAO,cAAc,GAAG,MAAM;CAC1C,CAAC;AASF;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,WAAW,SAAuB,GAAG,aAAa,CA8B3E"}