mysql-boss 0.1.0

package/dist/cjs/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/cjs/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"}

package/dist/cjs/sql.js

@@ -0,0 +1,396 @@
+"use strict";
+// §1.1 — DDL
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNPREFIXED_SQL = exports.DEFAULT_TABLE_PREFIX = exports.INIT_SESSION = exports.LIST_ARCHIVE = exports.GET_ARCHIVED_JOB = exports.ARCHIVE_PRUNE = exports.SWEEP_DLQ_DELETE = exports.SWEEP_DLQ_INSERT = exports.SWEEP_RETRY = exports.SWEEP_SELECT = exports.DRAIN_RELEASE = exports.HEARTBEAT_OWNED = exports.HEARTBEAT = exports.SCHEDULE_DELETE = exports.SCHEDULE_UPSERT = exports.TICK_ADVANCE = exports.TICK_ENQUEUE = exports.TICK_SELECT = exports.DB_NOW = exports.REPLAY_DELETE = exports.REPLAY_INSERT = exports.LIST_DEAD = exports.DLQ_DELETE = exports.DLQ_INSERT = exports.FAIL_RETRY = exports.COMPLETE_DELETE = exports.COMPLETE_ARCHIVE = exports.CLAIM_UPDATE = exports.CLAIM_SELECT = exports.LAST_INSERT_ID = exports.ENQUEUE_SINGLETON = exports.ENQUEUE = exports.CREATE_SCHEDULES = exports.CREATE_JOBS_DEAD = exports.CREATE_JOBS_ARCHIVE = exports.CREATE_JOBS = void 0;
+exports.createSql = createSql;
+exports.CREATE_JOBS = `
+CREATE TABLE IF NOT EXISTS jobs (
+  id               BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
+  queue            VARCHAR(128)    NOT NULL,
+  state            ENUM('available','active') NOT NULL DEFAULT 'available',
+  priority         SMALLINT        NOT NULL DEFAULT 0,
+  payload          JSON            NULL,
+  singleton_key    VARCHAR(191)    NULL,
+  retry_count      INT UNSIGNED    NOT NULL DEFAULT 0,
+  retry_limit      INT UNSIGNED    NOT NULL DEFAULT 2,
+  retry_delay_secs INT UNSIGNED    NOT NULL DEFAULT 30,
+  retry_backoff    TINYINT(1)      NOT NULL DEFAULT 0,
+  run_at           DATETIME(6)     NOT NULL,
+  created_at       DATETIME(6)     NOT NULL DEFAULT (UTC_TIMESTAMP(6)),
+  started_at       DATETIME(6)     NULL,
+  locked_by        BINARY(16)      NULL,
+  lease_expires_at DATETIME(6)     NULL,
+  last_error       JSON            NULL,
+  PRIMARY KEY (id),
+  UNIQUE KEY uq_jobs_singleton (queue, singleton_key),
+  KEY ix_jobs_dequeue (queue, state, priority DESC, run_at, id),
+  KEY ix_jobs_lease   (state, lease_expires_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
+`;
+exports.CREATE_JOBS_ARCHIVE = `
+CREATE TABLE IF NOT EXISTS jobs_archive (
+  id            BIGINT UNSIGNED NOT NULL,
+  queue         VARCHAR(128)    NOT NULL,
+  priority      SMALLINT        NOT NULL,
+  payload       JSON            NULL,
+  singleton_key VARCHAR(191)    NULL,
+  retry_count   INT UNSIGNED    NOT NULL,
+  created_at    DATETIME(6)     NOT NULL,
+  started_at    DATETIME(6)     NOT NULL,
+  completed_at  DATETIME(6)     NOT NULL DEFAULT (UTC_TIMESTAMP(6)),
+  duration_ms   INT UNSIGNED    NOT NULL,
+  PRIMARY KEY (id),
+  KEY ix_archive_queue_time (queue, completed_at),
+  KEY ix_archive_time       (completed_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
+`;
+exports.CREATE_JOBS_DEAD = `
+CREATE TABLE IF NOT EXISTS jobs_dead (
+  id               BIGINT UNSIGNED NOT NULL,
+  queue            VARCHAR(128)    NOT NULL,
+  priority         SMALLINT        NOT NULL,
+  payload          JSON            NULL,
+  singleton_key    VARCHAR(191)    NULL,
+  retry_count      INT UNSIGNED    NOT NULL,
+  retry_limit      INT UNSIGNED    NOT NULL,
+  retry_delay_secs INT UNSIGNED    NOT NULL,
+  retry_backoff    TINYINT(1)      NOT NULL,
+  created_at       DATETIME(6)     NOT NULL,
+  failed_at        DATETIME(6)     NOT NULL DEFAULT (UTC_TIMESTAMP(6)),
+  last_error       JSON            NULL,
+  PRIMARY KEY (id),
+  KEY ix_dead_queue_time (queue, failed_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
+`;
+exports.CREATE_SCHEDULES = `
+CREATE TABLE IF NOT EXISTS schedules (
+  name             VARCHAR(128) NOT NULL,
+  queue            VARCHAR(128) NOT NULL,
+  cron             VARCHAR(64)  NOT NULL,
+  timezone         VARCHAR(64)  NOT NULL DEFAULT 'UTC',
+  payload          JSON         NULL,
+  job_options      JSON         NULL,
+  next_run_at      DATETIME(6)  NOT NULL,
+  last_enqueued_at DATETIME(6)  NULL,
+  updated_at       DATETIME(6)  NOT NULL DEFAULT (UTC_TIMESTAMP(6))
+                                ON UPDATE CURRENT_TIMESTAMP(6),
+  PRIMARY KEY (name),
+  KEY ix_schedules_due (next_run_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
+`;
+// §1.2 — Enqueue
+exports.ENQUEUE = `
+INSERT INTO jobs
+  (queue, priority, payload, singleton_key,
+   retry_limit, retry_delay_secs, retry_backoff, run_at)
+VALUES
+  (?, ?, ?, ?, ?, ?, ?, COALESCE(?, UTC_TIMESTAMP(6)));
+`;
+exports.ENQUEUE_SINGLETON = `
+INSERT IGNORE INTO jobs
+  (queue, priority, payload, singleton_key,
+   retry_limit, retry_delay_secs, retry_backoff, run_at)
+VALUES
+  (?, ?, ?, ?, ?, ?, ?, COALESCE(?, UTC_TIMESTAMP(6)));
+`;
+exports.LAST_INSERT_ID = `
+SELECT CAST(LAST_INSERT_ID() AS CHAR) AS id;
+`;
+// §1.2 — Dequeue / claim
+exports.CLAIM_SELECT = `
+SELECT CAST(id AS CHAR) AS id, queue, payload, retry_count, retry_limit,
+       retry_delay_secs, retry_backoff
+FROM jobs
+WHERE queue = ?
+  AND state = 'available'
+  AND run_at <= UTC_TIMESTAMP(6)
+ORDER BY priority DESC, run_at, id
+LIMIT ?
+FOR UPDATE SKIP LOCKED;
+`;
+exports.CLAIM_UPDATE = `
+UPDATE jobs
+SET state = 'active',
+    started_at = UTC_TIMESTAMP(6),
+    locked_by = UUID_TO_BIN(?),
+    lease_expires_at = UTC_TIMESTAMP(6) + INTERVAL ? SECOND
+WHERE id IN (?);
+`;
+// §1.2 — Complete (archive move)
+exports.COMPLETE_ARCHIVE = `
+INSERT INTO jobs_archive
+  (id, queue, priority, payload, singleton_key, retry_count,
+   created_at, started_at, duration_ms)
+SELECT id, queue, priority, payload, singleton_key, retry_count,
+       created_at, started_at,
+       TIMESTAMPDIFF(MICROSECOND, started_at, UTC_TIMESTAMP(6)) DIV 1000
+FROM jobs
+WHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';
+`;
+exports.COMPLETE_DELETE = `
+DELETE FROM jobs
+WHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';
+`;
+// §2.2 — Fail with retries remaining
+exports.FAIL_RETRY = `
+UPDATE jobs
+SET state = 'available',
+    run_at = UTC_TIMESTAMP(6) + INTERVAL
+      LEAST(
+        86400,
+        IF(retry_backoff = 1,
+           retry_delay_secs * POW(2, retry_count),
+           retry_delay_secs)
+        + FLOOR(RAND() * retry_delay_secs)
+      ) SECOND,
+    retry_count = retry_count + 1,
+    locked_by = NULL,
+    lease_expires_at = NULL,
+    started_at = NULL,
+    last_error = ?
+WHERE id = ?
+  AND locked_by = UUID_TO_BIN(?)
+  AND state = 'active'
+  AND retry_count < retry_limit;
+`;
+// §3.2 — Dead-letter move
+exports.DLQ_INSERT = `
+INSERT INTO jobs_dead
+  (id, queue, priority, payload, singleton_key,
+   retry_count, retry_limit, retry_delay_secs, retry_backoff,
+   created_at, last_error)
+SELECT id, queue, priority, payload, singleton_key,
+       retry_count + 1, retry_limit, retry_delay_secs, retry_backoff,
+       created_at, ?
+FROM jobs
+WHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';
+`;
+exports.DLQ_DELETE = `
+DELETE FROM jobs
+WHERE id = ? AND locked_by = UUID_TO_BIN(?) AND state = 'active';
+`;
+// §3.2 — DLQ query
+exports.LIST_DEAD = `
+SELECT CAST(id AS CHAR) AS id, queue, priority, payload, retry_count,
+       UNIX_TIMESTAMP(created_at) AS created_at_unix,
+       UNIX_TIMESTAMP(failed_at) AS failed_at_unix,
+       last_error
+FROM jobs_dead
+WHERE queue = ? AND failed_at BETWEEN ? AND ?
+ORDER BY failed_at DESC
+LIMIT ? OFFSET ?;
+`;
+// §3.2 — Replay
+exports.REPLAY_INSERT = `
+INSERT INTO jobs
+  (queue, priority, payload, singleton_key,
+   retry_limit, retry_delay_secs, retry_backoff, run_at)
+SELECT queue, priority, payload, singleton_key,
+       retry_limit, retry_delay_secs, retry_backoff, UTC_TIMESTAMP(6)
+FROM jobs_dead
+WHERE id IN (?)
+FOR UPDATE;
+`;
+exports.REPLAY_DELETE = `
+DELETE FROM jobs_dead WHERE id IN (?);
+`;
+// §4.2 — Cron tick
+exports.DB_NOW = "SELECT UNIX_TIMESTAMP(UTC_TIMESTAMP(6)) AS db_now_unix;";
+exports.TICK_SELECT = `
+SELECT name, queue, cron, timezone, payload, job_options,
+       next_run_at,
+       UNIX_TIMESTAMP(next_run_at) AS next_run_at_unix
+FROM schedules
+WHERE next_run_at <= UTC_TIMESTAMP(6)
+ORDER BY next_run_at
+LIMIT 20
+FOR UPDATE SKIP LOCKED;
+`;
+exports.TICK_ENQUEUE = `
+INSERT IGNORE INTO jobs
+  (queue, priority, payload, singleton_key,
+   retry_limit, retry_delay_secs, retry_backoff, run_at)
+VALUES
+  (?, ?, ?, CONCAT('cron:', ?, ':', DATE_FORMAT(?, '%Y%m%d%H%i%s')),
+   ?, ?, ?, UTC_TIMESTAMP(6));
+`;
+exports.TICK_ADVANCE = `
+UPDATE schedules
+SET next_run_at = ?, last_enqueued_at = UTC_TIMESTAMP(6)
+WHERE name = ?;
+`;
+// §4 — Schedule CRUD
+exports.SCHEDULE_UPSERT = `
+INSERT INTO schedules (name, queue, cron, timezone, payload, job_options, next_run_at)
+VALUES (?, ?, ?, ?, ?, ?, ?)
+ON DUPLICATE KEY UPDATE
+  queue = VALUES(queue),
+  cron = VALUES(cron),
+  timezone = VALUES(timezone),
+  payload = VALUES(payload),
+  job_options = VALUES(job_options),
+  next_run_at = VALUES(next_run_at);
+`;
+exports.SCHEDULE_DELETE = `
+DELETE FROM schedules WHERE name = ?;
+`;
+// §6.1 — Heartbeat
+exports.HEARTBEAT = `
+UPDATE jobs
+SET lease_expires_at = UTC_TIMESTAMP(6) + INTERVAL ? SECOND
+WHERE id IN (?) AND locked_by = UUID_TO_BIN(?) AND state = 'active';
+`;
+exports.HEARTBEAT_OWNED = `
+SELECT CAST(id AS CHAR) AS id
+FROM jobs
+WHERE id IN (?) AND locked_by = UUID_TO_BIN(?) AND state = 'active';
+`;
+// §6.2 — Drain release
+exports.DRAIN_RELEASE = `
+UPDATE jobs
+SET state = 'available', run_at = UTC_TIMESTAMP(6),
+    locked_by = NULL, lease_expires_at = NULL, started_at = NULL
+WHERE id IN (?) AND locked_by = UUID_TO_BIN(?) AND state = 'active';
+`;
+// §6.3 — Stale sweep
+exports.SWEEP_SELECT = `
+SELECT CAST(id AS CHAR) AS id, retry_count, retry_limit
+FROM jobs
+WHERE state = 'active' AND lease_expires_at < UTC_TIMESTAMP(6)
+ORDER BY lease_expires_at
+LIMIT 100
+FOR UPDATE SKIP LOCKED;
+`;
+exports.SWEEP_RETRY = `
+UPDATE jobs
+SET state = 'available',
+    run_at = UTC_TIMESTAMP(6) + INTERVAL
+      LEAST(
+        86400,
+        IF(retry_backoff = 1,
+           retry_delay_secs * POW(2, retry_count),
+           retry_delay_secs)
+        + FLOOR(RAND() * retry_delay_secs)
+      ) SECOND,
+    retry_count = retry_count + 1,
+    locked_by = NULL, lease_expires_at = NULL, started_at = NULL,
+    last_error = JSON_OBJECT('message', 'lease expired', 'at', UTC_TIMESTAMP(6))
+WHERE id IN (?) AND retry_count < retry_limit;
+`;
+exports.SWEEP_DLQ_INSERT = `
+INSERT INTO jobs_dead
+  (id, queue, priority, payload, singleton_key,
+   retry_count, retry_limit, retry_delay_secs, retry_backoff,
+   created_at, last_error)
+SELECT id, queue, priority, payload, singleton_key,
+       retry_count + 1, retry_limit, retry_delay_secs, retry_backoff,
+       created_at, JSON_OBJECT('message', 'lease expired', 'at', UTC_TIMESTAMP(6))
+FROM jobs
+WHERE id IN (?);
+`;
+exports.SWEEP_DLQ_DELETE = `
+DELETE FROM jobs WHERE id IN (?);
+`;
+// §6.3 — Archive retention
+exports.ARCHIVE_PRUNE = `
+DELETE FROM jobs_archive
+WHERE completed_at < UTC_TIMESTAMP(6) - INTERVAL ? DAY
+ORDER BY completed_at
+LIMIT 5000;
+`;
+// Archive query
+exports.GET_ARCHIVED_JOB = `
+SELECT CAST(id AS CHAR) AS id, queue, priority, payload, singleton_key, retry_count,
+       UNIX_TIMESTAMP(created_at) AS created_at_unix,
+       UNIX_TIMESTAMP(started_at) AS started_at_unix,
+       UNIX_TIMESTAMP(completed_at) AS completed_at_unix,
+       duration_ms
+FROM jobs_archive
+WHERE id = ?;
+`;
+exports.LIST_ARCHIVE = `
+SELECT CAST(id AS CHAR) AS id, queue, priority, payload, singleton_key, retry_count,
+       UNIX_TIMESTAMP(created_at) AS created_at_unix,
+       UNIX_TIMESTAMP(started_at) AS started_at_unix,
+       UNIX_TIMESTAMP(completed_at) AS completed_at_unix,
+       duration_ms
+FROM jobs_archive
+WHERE queue = ? AND completed_at < ?
+ORDER BY completed_at DESC
+LIMIT ?;
+`;
+// Connection setup
+exports.INIT_SESSION = `
+SET SESSION transaction_isolation = 'READ-COMMITTED',
+            SESSION time_zone = '+00:00';
+`;
+exports.DEFAULT_TABLE_PREFIX = "mysql_boss";
+exports.UNPREFIXED_SQL = {
+    CREATE_JOBS: exports.CREATE_JOBS,
+    CREATE_JOBS_ARCHIVE: exports.CREATE_JOBS_ARCHIVE,
+    CREATE_JOBS_DEAD: exports.CREATE_JOBS_DEAD,
+    CREATE_SCHEDULES: exports.CREATE_SCHEDULES,
+    ENQUEUE: exports.ENQUEUE,
+    ENQUEUE_SINGLETON: exports.ENQUEUE_SINGLETON,
+    LAST_INSERT_ID: exports.LAST_INSERT_ID,
+    CLAIM_SELECT: exports.CLAIM_SELECT,
+    CLAIM_UPDATE: exports.CLAIM_UPDATE,
+    COMPLETE_ARCHIVE: exports.COMPLETE_ARCHIVE,
+    COMPLETE_DELETE: exports.COMPLETE_DELETE,
+    FAIL_RETRY: exports.FAIL_RETRY,
+    DLQ_INSERT: exports.DLQ_INSERT,
+    DLQ_DELETE: exports.DLQ_DELETE,
+    LIST_DEAD: exports.LIST_DEAD,
+    REPLAY_INSERT: exports.REPLAY_INSERT,
+    REPLAY_DELETE: exports.REPLAY_DELETE,
+    DB_NOW: exports.DB_NOW,
+    TICK_SELECT: exports.TICK_SELECT,
+    TICK_ENQUEUE: exports.TICK_ENQUEUE,
+    TICK_ADVANCE: exports.TICK_ADVANCE,
+    SCHEDULE_UPSERT: exports.SCHEDULE_UPSERT,
+    SCHEDULE_DELETE: exports.SCHEDULE_DELETE,
+    HEARTBEAT: exports.HEARTBEAT,
+    HEARTBEAT_OWNED: exports.HEARTBEAT_OWNED,
+    DRAIN_RELEASE: exports.DRAIN_RELEASE,
+    SWEEP_SELECT: exports.SWEEP_SELECT,
+    SWEEP_RETRY: exports.SWEEP_RETRY,
+    SWEEP_DLQ_INSERT: exports.SWEEP_DLQ_INSERT,
+    SWEEP_DLQ_DELETE: exports.SWEEP_DLQ_DELETE,
+    ARCHIVE_PRUNE: exports.ARCHIVE_PRUNE,
+    GET_ARCHIVED_JOB: exports.GET_ARCHIVED_JOB,
+    LIST_ARCHIVE: exports.LIST_ARCHIVE,
+};
+const TABLE_SUFFIXES = [
+    "jobs_archive",
+    "jobs_dead",
+    "schedules",
+    "jobs",
+];
+/**
+ * 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.
+ */
+function createSql(tablePrefix = exports.DEFAULT_TABLE_PREFIX) {
+    if (!/^[A-Za-z0-9_]*$/.test(tablePrefix)) {
+        throw new Error("tablePrefix may contain only ASCII letters, numbers, and underscores");
+    }
+    if (tablePrefix.length > 50) {
+        throw new Error("tablePrefix must be 50 characters or fewer");
+    }
+    const tableName = (suffix) => `\`${tablePrefix ? `${tablePrefix}_${suffix}` : suffix}\``;
+    const prefixTables = (statement) => {
+        let result = statement;
+        for (const suffix of TABLE_SUFFIXES) {
+            result = result.replace(new RegExp(`\\b${suffix}\\b`, "g"), tableName(suffix));
+        }
+        return result;
+    };
+    return Object.fromEntries(Object.entries(exports.UNPREFIXED_SQL).map(([name, statement]) => [
+        name,
+        prefixTables(statement),
+    ]));
+}
+//# sourceMappingURL=sql.js.map

package/dist/cjs/sql.js.map

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

package/dist/cjs/sweep.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sweep.d.ts","sourceRoot":"","sources":["../../src/sweep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAkC,MAAM,gBAAgB,CAAC;AAG3E,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,UAAU,CAAC;AAQ9D,wBAAsB,cAAc,CACnC,IAAI,EAAE,IAAI,EACV,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,MAAM,CAAC,CA0CjB"}

package/dist/cjs/sweep.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sweepStaleJobs = sweepStaleJobs;
+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 sweepStaleJobs(pool, 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.SWEEP_SELECT);
+            if (rows.length === 0) {
+                await conn.commit();
+                return 0;
+            }
+            const retryable = [];
+            const exhausted = [];
+            for (const row of rows) {
+                if (row.retry_count < row.retry_limit) {
+                    retryable.push(row.id);
+                }
+                else {
+                    exhausted.push(row.id);
+                }
+            }
+            if (retryable.length > 0) {
+                await conn.query(sql.SWEEP_RETRY, [retryable]);
+            }
+            if (exhausted.length > 0) {
+                await conn.query(sql.SWEEP_DLQ_INSERT, [exhausted]);
+                await conn.query(sql.SWEEP_DLQ_DELETE, [exhausted]);
+            }
+            await conn.commit();
+            return rows.length;
+        }
+        catch (err) {
+            await conn.rollback().catch(() => { });
+            throw err;
+        }
+        finally {
+            conn.release();
+        }
+    });
+}
+//# sourceMappingURL=sweep.js.map

package/dist/cjs/sweep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep.js","sourceRoot":"","sources":["../../src/sweep.ts"],"names":[],"mappings":";;;AACA,mDAAoD;AACpD,mDAAoD;AACpD,qCAA8D;AAQvD,KAAK,yBACX,IAAU,EACV,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,CAAC,CAAC;YAE9D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,CAAC,CAAC;YACV,CAAC;YAED,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAa,EAAE,CAAC;YAE/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACxB,IAAI,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;oBACvC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACxB,CAAC;qBAAM,CAAC;oBACP,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACxB,CAAC;YACF,CAAC;YAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;YAChD,CAAC;YAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;gBACpD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,MAAM,CAAC;QACpB,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/tick.d.ts

@@ -0,0 +1,11 @@
+import type { Pool } from "mysql2/promise";
+import { type SqlStatements } from "./sql.js";
+export declare function runTick(pool: Pool, sql?: SqlStatements): Promise<number>;
+export declare function upsertSchedule(pool: Pool, name: string, queue: string, cron: string, timezone: string, payload: unknown, jobOptions: {
+    priority?: number;
+    retryLimit?: number;
+    retryDelaySecs?: number;
+    retryBackoff?: boolean;
+} | null, sql?: SqlStatements): Promise<void>;
+export declare function deleteSchedule(pool: Pool, name: string, sql?: SqlStatements): Promise<void>;
+//# sourceMappingURL=tick.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tick.d.ts","sourceRoot":"","sources":["../../src/tick.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAiB,MAAM,gBAAgB,CAAC;AAM1D,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,UAAU,CAAC;AAsB9D,wBAAsB,OAAO,CAC5B,IAAI,EAAE,IAAI,EACV,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAED,wBAAsB,cAAc,CACnC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,IAAI,EACR,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,cAAc,CACnC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,aAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAIf"}