@dudousxd/nestjs-durable-transport-db 0.2.2 → 0.3.1

package/dist/index.cjs

@@ -71,6 +71,19 @@ function mikroOrmExecutor(em) {
 __name(mikroOrmExecutor, "mikroOrmExecutor");
 
 // src/db-transport.ts
+var RUNS_INSERT_CHUNK = 500;
+var DEADLOCK_RETRIES = 5;
+function isDeadlock(err) {
+  const codes = [
+    err.code,
+    err.errno,
+    err.driverError?.code,
+    err.driverError?.errno
+  ];
+  return codes.some((c) => c === "ER_LOCK_DEADLOCK" || c === 1213 || c === "40P01");
+}
+__name(isDeadlock, "isDeadlock");
+var RUNS_CLAIM_MAX = 50;
 function numberOption(value, fallback, min) {
   return value !== void 0 && Number.isFinite(value) && value >= min ? value : fallback;
 }
@@ -83,6 +96,8 @@ var DbTransport = class {
   group;
   tasksTable;
   resultsTable;
+  runsTable;
+  runConsumers = /* @__PURE__ */ new Set();
   pollMs;
   leaseMs;
   batchSize;
@@ -108,6 +123,7 @@ var DbTransport = class {
     const prefix = options.prefix ?? "durable";
     this.tasksTable = `${prefix}_transport_tasks`;
     this.resultsTable = `${prefix}_transport_results`;
+    this.runsTable = `${prefix}_transport_runs`;
     this.pollMs = numberOption(options.pollMs, 500, 0);
     this.leaseMs = numberOption(options.leaseMs, 3e4, 1);
     this.batchSize = Math.floor(numberOption(options.batchSize, 10, 1));
@@ -181,6 +197,18 @@ var DbTransport = class {
         ${this.q("claimed_at")} bigint,
         ${this.q("created_at")} bigint NOT NULL
       )`);
+    await this.createIfMissing(`CREATE TABLE IF NOT EXISTS ${this.q(this.runsTable)} (
+        ${this.q("run_id")} ${str} PRIMARY KEY,
+        ${this.q("ns")} ${str} NOT NULL,
+        ${this.q("priority")} integer NOT NULL,
+        ${this.q("wake")} integer NOT NULL,
+        ${this.q("claimed_by")} ${str},
+        ${this.q("claim_token")} ${str},
+        ${this.q("claimed_at")} bigint,
+        ${this.q("created_at")} bigint NOT NULL
+      )`);
+    await this.exec.query(`CREATE INDEX ${this.q(`${this.runsTable}_ns_idx`)} ON ${this.q(this.runsTable)} (${this.q("ns")}, ${this.q("priority")}, ${this.q("created_at")})`).catch(() => {
+    });
     await this.exec.query(`CREATE INDEX ${this.q(`${this.tasksTable}_grp_idx`)} ON ${tasks} (${this.q("grp")}, ${this.q("status")}, ${this.q("created_at")})`).catch(() => {
     });
   }
@@ -224,6 +252,181 @@ var DbTransport = class {
   }
   onHeartbeat(_handler) {
   }
+  // ── run queue (engine ↔ engine) ─────────────────────────────────────────────────────────────
+  /**
+  * Queue `pending` runs for whichever engine instance polls the run queue first: one row per run,
+  * keyed by run id, so a run already waiting is not queued twice. A run whose row an instance holds
+  * right now is released for another take, so a dispatch landing while the run's previous entry is
+  * being handled is not lost when that entry is deleted. Up to {@link RUNS_INSERT_CHUNK} rows per
+  * insert.
+  */
+  async dispatchRuns(runs, opts) {
+    if (runs.length === 0) return;
+    await this.ensureSchema();
+    const byRun = /* @__PURE__ */ new Map();
+    for (const run of runs) {
+      if (!byRun.has(run.runId) || run.reason === "wake") byRun.set(run.runId, run);
+    }
+    const unique = [
+      ...byRun.values()
+    ].sort((a, b) => a.runId < b.runId ? -1 : a.runId > b.runId ? 1 : 0);
+    const t = this.q(this.runsTable);
+    const cols = [
+      "run_id",
+      "ns",
+      "priority",
+      "wake",
+      "created_at"
+    ];
+    const now = this.now();
+    for (let at = 0; at < unique.length; at += RUNS_INSERT_CHUNK) {
+      const chunk = unique.slice(at, at + RUNS_INSERT_CHUNK);
+      const values = chunk.map((_, r) => `(${cols.map((__, c) => this.ph(r * cols.length + c + 1)).join(", ")})`).join(", ");
+      const insert = `INTO ${t} (${cols.map((c) => this.q(c)).join(", ")}) VALUES ${values}`;
+      const release = [
+        "claimed_by",
+        "claim_token",
+        "claimed_at"
+      ].map((c) => `${this.q(c)} = NULL`).join(", ");
+      const wake = this.q("wake");
+      const sql = this.isPg ? `INSERT ${insert} ON CONFLICT (${this.q("run_id")}) DO UPDATE SET ${release}, ${wake} = GREATEST(${t}.${wake}, EXCLUDED.${wake})` : `INSERT ${insert} ON DUPLICATE KEY UPDATE ${release}, ${wake} = GREATEST(${wake}, VALUES(${wake}))`;
+      await this.retryOnDeadlock(() => this.exec.query(sql, chunk.flatMap((run, r) => [
+        run.runId,
+        opts?.namespace ?? "",
+        run.priority ?? 0,
+        run.reason === "wake" ? 1 : 0,
+        now + r
+      ])));
+    }
+  }
+  /**
+  * Poll the run queue, at most `opts.concurrency` runs in flight on this instance. Rows are claimed
+  * with `FOR UPDATE SKIP LOCKED` (instances never take the same run), highest priority then oldest
+  * first; a row is deleted once its handler settles, and its lease is renewed meanwhile, so a row is
+  * re-taken only after the instance holding it went down. The returned stop takes no more rows and
+  * resolves once the runs in flight settled.
+  */
+  onDispatchedRun(handler, opts) {
+    const consumer = {
+      stopped: false,
+      inflight: /* @__PURE__ */ new Set(),
+      slotFreed: void 0,
+      loop: Promise.resolve()
+    };
+    const concurrency = Math.max(1, Math.floor(opts.concurrency));
+    const ns = opts.namespace ?? "";
+    consumer.loop = this.consumeRuns(consumer, handler, concurrency, ns).catch((err) => {
+      this.onError(err);
+    });
+    this.runConsumers.add(consumer);
+    return () => this.stopRunConsumer(consumer);
+  }
+  async stopRunConsumer(consumer) {
+    consumer.stopped = true;
+    consumer.slotFreed?.();
+    await consumer.loop;
+    this.runConsumers.delete(consumer);
+  }
+  async consumeRuns(consumer, handler, concurrency, ns) {
+    const renew = setInterval(() => void this.renewRunLeases(consumer).catch(() => void 0), Math.max(1e3, Math.floor(this.leaseMs / 3)));
+    renew.unref?.();
+    const settled = /* @__PURE__ */ new Set();
+    try {
+      while (this.running && !consumer.stopped) {
+        const free = concurrency - consumer.inflight.size;
+        if (free <= 0) {
+          await new Promise((resolve) => {
+            consumer.slotFreed = resolve;
+          });
+          consumer.slotFreed = void 0;
+          continue;
+        }
+        let rows = [];
+        try {
+          await this.ensureSchema();
+          rows = await this.retryOnDeadlock(() => this.claimRuns(ns, Math.min(free, RUNS_CLAIM_MAX)));
+        } catch (err) {
+          if (this.running && !consumer.stopped) this.onError(err);
+        }
+        for (const { run, token } of rows) {
+          consumer.inflight.add(token);
+          const done = handler(run).catch(() => void 0).then(() => this.retryOnDeadlock(() => this.exec.query(`DELETE FROM ${this.q(this.runsTable)} WHERE ${this.q("claim_token")} = ${this.ph(1)}`, [
+            token
+          ])).catch(() => void 0)).finally(() => {
+            consumer.inflight.delete(token);
+            settled.delete(done);
+            consumer.slotFreed?.();
+          });
+          settled.add(done);
+        }
+        if (rows.length === 0) await this.sleep(this.pollMs);
+      }
+      await Promise.allSettled([
+        ...settled
+      ]);
+    } finally {
+      clearInterval(renew);
+    }
+  }
+  /**
+  * Run `statement`, again on a deadlock: queueing a run (an upsert), taking one (`SKIP LOCKED`)
+  * and deleting a handled one touch the same rows from different instances, and the database then
+  * rolls one of them back rather than wait (InnoDB reports `ER_LOCK_DEADLOCK`, Postgres `40P01`).
+  */
+  async retryOnDeadlock(statement) {
+    for (let attempt = 1; ; attempt += 1) {
+      try {
+        return await statement();
+      } catch (err) {
+        if (attempt >= DEADLOCK_RETRIES || !isDeadlock(err)) throw err;
+        await this.sleep(10 * attempt + Math.floor(Math.random() * 10));
+      }
+    }
+  }
+  async claimRuns(ns, limit) {
+    const t = this.q(this.runsTable);
+    const staleBefore = this.now() - this.leaseMs;
+    return this.exec.transaction(async (tx) => {
+      const rows = await tx.query(`SELECT ${this.q("run_id")}, ${this.q("wake")} FROM ${t}
+         WHERE ${this.q("ns")} = ${this.ph(1)}
+           AND (${this.q("claimed_at")} IS NULL OR ${this.q("claimed_at")} < ${this.ph(2)})
+         ORDER BY ${this.q("priority")} DESC, ${this.q("created_at")} ASC
+         LIMIT ${Math.floor(limit)} FOR UPDATE SKIP LOCKED`, [
+        ns,
+        staleBefore
+      ]);
+      const claimed = rows.map((r) => ({
+        run: {
+          runId: r.run_id,
+          reason: Number(r.wake) === 1 ? "wake" : "start"
+        },
+        token: globalThis.crypto.randomUUID()
+      }));
+      const now = this.now();
+      for (const { run: { runId }, token } of claimed) {
+        await tx.query(`UPDATE ${t} SET ${this.q("claimed_by")} = ${this.ph(1)}, ${this.q("claim_token")} = ${this.ph(2)}, ${this.q("claimed_at")} = ${this.ph(3)}
+           WHERE ${this.q("run_id")} = ${this.ph(4)}`, [
+          this.instanceId,
+          token,
+          now,
+          runId
+        ]);
+      }
+      return claimed;
+    });
+  }
+  /** Keep the rows of the runs in flight leased, so a long turn is not re-taken by another instance. */
+  async renewRunLeases(consumer) {
+    const tokens = [
+      ...consumer.inflight
+    ];
+    if (tokens.length === 0) return;
+    await this.exec.query(`UPDATE ${this.q(this.runsTable)} SET ${this.q("claimed_at")} = ${this.ph(1)}
+       WHERE ${this.q("claim_token")} IN (${tokens.map((_, i) => this.ph(i + 2)).join(", ")})`, [
+      this.now(),
+      ...tokens
+    ]);
+  }
   // ── polling ──────────────────────────────────────────────────────────────────────────────────
   /** Run `tick` repeatedly; sleep `pollMs` when it reports an empty queue. Stops on `close()`. */
   async loop(tick) {
@@ -499,7 +702,10 @@ var DbTransport = class {
     this.running = false;
     await Promise.allSettled([
       this.taskLoop,
-      this.resultLoop
+      this.resultLoop,
+      ...[
+        ...this.runConsumers
+      ].map((c) => this.stopRunConsumer(c))
     ]);
     await Promise.allSettled([
       ...this.runningTasks

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/db-transport.ts","../src/executors.ts"],"sourcesContent":["export * from './db-transport';\n","import { randomUUID } from 'node:crypto';\nimport {\n  type Heartbeat,\n  type RemoteTask,\n  type StepHandler,\n  type StepResult,\n  type Transport,\n  runStepHandler,\n} from '@dudousxd/nestjs-durable-core';\nimport type { SqlExecutor, SqlTx } from './executors';\n\nexport { mikroOrmExecutor, type SqlExecutor, type SqlTx, typeOrmExecutor } from './executors';\n\n/** Raw row shapes returned by `SELECT *` (declared fields, so they're not `| undefined` under noUncheckedIndexedAccess). */\ninterface TaskRow {\n  step_id: string;\n  run_id: string;\n  seq: string | number;\n  name: string;\n  input: string | null;\n  attempt: string | number;\n}\ninterface ResultRow {\n  step_id: string;\n  run_id: string;\n  seq: string | number;\n  status: string;\n  output: string | null;\n  error: string | null;\n  started_at: string | number | null;\n}\n\nexport interface DbTransportOptions {\n  /**\n   * How to run SQL — built from the app's **own** ORM/connection (no broker, no extra connection).\n   * Use `mikroOrmExecutor(em)` to ride the app's MikroORM, `typeOrmExecutor(dataSource)` for TypeORM,\n   * `drizzlePgExecutor(db)` (from `@dudousxd/nestjs-durable-store-drizzle/pg`) for Drizzle on\n   * Postgres, or implement `SqlExecutor` for anything else.\n   */\n  executor: SqlExecutor;\n  /** The worker group this instance serves. Required to register `handle()` consumers. */\n  group?: string;\n  /** Table-name prefix. Tables: `${prefix}_transport_tasks` / `${prefix}_transport_results`. Default `durable`. */\n  prefix?: string;\n  /** Poll interval in ms when a queue is empty. Default 500. */\n  pollMs?: number;\n  /**\n   * How long a claimed row is owned before it's reclaimable (crash recovery), in ms. Default 30_000.\n   * Every claim this instance holds is renewed every `leaseMs / 3` while it is waiting or running, so\n   * a step may run longer than `leaseMs`; only a crashed (or event-loop-blocked) instance loses it.\n   */\n  leaseMs?: number;\n  /**\n   * Max rows claimed per poll. Default 10. The task loop claims only as many rows as it has free\n   * {@link concurrency} slots (capped by this); the results loop claims up to this many.\n   */\n  batchSize?: number;\n  /**\n   * How many tasks this instance runs at once (worker side). Default 1. A row is claimed only when a\n   * slot is free to run it, so rows never wait claimed behind a slow task while a sibling sits idle.\n   */\n  concurrency?: number;\n  /**\n   * Where a transport failure is reported: a failing poll, a throwing result handler (the result is\n   * re-delivered after the lease), a lost claim. Default `console.error`.\n   */\n  onError?: (err: unknown) => void;\n  /** Create the two tables on first use if missing. Default true. */\n  autoCreate?: boolean;\n  /** Identifies this instance in `claimed_by` (for debugging). Defaults to a random id. */\n  instanceId?: string;\n}\n\n/**\n * A numeric option: `fallback` unless `value` is a finite number of at least `min`. `Math.max(1, NaN)`\n * is `NaN`, so a clamp alone would let a `NaN` through (to `LIMIT NaN`, or a `NaN` timer).\n */\nfunction numberOption(value: number | undefined, fallback: number, min: number): number {\n  return value !== undefined && Number.isFinite(value) && value >= min ? value : fallback;\n}\n\n/**\n * A SQL-backed `Transport` — DBOS-style. Instead of a broker (Redis/SQS), remote steps are **rows**\n * in the same database the durable store already uses: `dispatch` inserts a task row, a worker\n * claims it with `SELECT … FOR UPDATE SKIP LOCKED` (so instances never double-claim), runs it, and\n * writes a result row the engine polls. Zero new infrastructure — the DB you already have IS the\n * queue.\n *\n * Trade-off vs a real broker: throughput is bounded by polling + row contention. Great for\n * workflow/pipeline scale (modest rate, long steps); not for high-fanout firehoses.\n *\n * Requires `FOR UPDATE SKIP LOCKED` — **MySQL 8+** or **Postgres 9.5+** (not SQLite). Run one\n * instance engine-side (`onResult`, dispatches) and one per worker process (`handle()` for its group).\n */\nexport class DbTransport implements Transport {\n  private readonly exec: SqlExecutor;\n  private readonly group?: string | undefined;\n  private readonly tasksTable: string;\n  private readonly resultsTable: string;\n  private readonly pollMs: number;\n  private readonly leaseMs: number;\n  private readonly batchSize: number;\n  private readonly concurrency: number;\n  private readonly onError: (err: unknown) => void;\n  private readonly autoCreate: boolean;\n  private readonly instanceId: string;\n  private readonly isPg: boolean;\n\n  private readonly handlers = new Map<string, StepHandler>();\n  private running = true;\n  private schemaReady?: Promise<void> | undefined;\n  private taskLoop?: Promise<void>;\n  private resultLoop?: Promise<void>;\n  /** Tasks running on this instance (at most `concurrency`). */\n  private readonly runningTasks = new Set<Promise<void>>();\n  /** Claim tokens this instance holds, by table — every one is renewed on `renewTimer`. */\n  private readonly held = new Map<string, Set<string>>();\n  private renewTimer?: ReturnType<typeof setInterval> | undefined;\n  private renewal?: Promise<void> | undefined;\n\n  constructor(options: DbTransportOptions) {\n    this.exec = options.executor;\n    this.group = options.group;\n    const prefix = options.prefix ?? 'durable';\n    this.tasksTable = `${prefix}_transport_tasks`;\n    this.resultsTable = `${prefix}_transport_results`;\n    this.pollMs = numberOption(options.pollMs, 500, 0);\n    this.leaseMs = numberOption(options.leaseMs, 30_000, 1);\n    this.batchSize = Math.floor(numberOption(options.batchSize, 10, 1));\n    this.concurrency = Math.floor(numberOption(options.concurrency, 1, 1));\n    this.onError = options.onError ?? ((err) => console.error('[DbTransport]', err));\n    this.autoCreate = options.autoCreate ?? true;\n    // Random, not time-based: two instances booted in the same millisecond must not share an id.\n    this.instanceId = options.instanceId ?? `db-${randomUUID()}`;\n    this.isPg = this.exec.dialect === 'postgres';\n  }\n\n  // ── dialect helpers ──────────────────────────────────────────────────────────────────────────\n  /** Positional placeholder for param `i` (1-based): `$i` on Postgres, `?` elsewhere. */\n  private ph(i: number): string {\n    return this.isPg ? `$${i}` : '?';\n  }\n  private q(id: string): string {\n    return this.exec.escapeId(id);\n  }\n  private now(): number {\n    return Math.floor(Date.now());\n  }\n\n  // ── schema ───────────────────────────────────────────────────────────────────────────────────\n  private ensureSchema(): Promise<void> {\n    if (!this.schemaReady) {\n      // A failed attempt is not cached: the next call tries again instead of failing forever.\n      this.schemaReady = this.createTables().catch((err) => {\n        this.schemaReady = undefined;\n        throw err;\n      });\n    }\n    return this.schemaReady;\n  }\n\n  /**\n   * Run one `CREATE … IF NOT EXISTS`. Two instances booting on a fresh database race it, and Postgres\n   * can reject the loser with a unique violation on its catalog even with `IF NOT EXISTS`; the\n   * statement is simply re-run, by which point the table exists and it is a no-op.\n   */\n  private async createIfMissing(sql: string): Promise<void> {\n    try {\n      await this.exec.query(sql);\n    } catch {\n      await this.exec.query(sql);\n    }\n  }\n\n  private async createTables(): Promise<void> {\n    if (!this.autoCreate) return;\n    const str = 'varchar(191)';\n    const txt = this.isPg ? 'text' : 'longtext';\n    const tasks = this.q(this.tasksTable);\n    const results = this.q(this.resultsTable);\n    await this.createIfMissing(\n      `CREATE TABLE IF NOT EXISTS ${tasks} (\n        ${this.q('step_id')} ${str} PRIMARY KEY,\n        ${this.q('run_id')} ${str} NOT NULL,\n        ${this.q('seq')} integer NOT NULL,\n        ${this.q('name')} ${str} NOT NULL,\n        ${this.q('grp')} ${str} NOT NULL,\n        ${this.q('input')} ${txt},\n        ${this.q('attempt')} integer NOT NULL,\n        ${this.q('status')} varchar(32) NOT NULL,\n        ${this.q('claimed_by')} ${str},\n        ${this.q('claimed_at')} bigint,\n        ${this.q('created_at')} bigint NOT NULL\n      )`,\n    );\n    await this.createIfMissing(\n      `CREATE TABLE IF NOT EXISTS ${results} (\n        ${this.q('step_id')} ${str} PRIMARY KEY,\n        ${this.q('run_id')} ${str} NOT NULL,\n        ${this.q('seq')} integer NOT NULL,\n        ${this.q('status')} varchar(32) NOT NULL,\n        ${this.q('output')} ${txt},\n        ${this.q('error')} ${txt},\n        ${this.q('started_at')} bigint,\n        ${this.q('claimed_by')} ${str},\n        ${this.q('claimed_at')} bigint,\n        ${this.q('created_at')} bigint NOT NULL\n      )`,\n    );\n    // Best-effort index for the group poll (MySQL has no CREATE INDEX IF NOT EXISTS < 8.0.13).\n    await this.exec\n      .query(\n        `CREATE INDEX ${this.q(`${this.tasksTable}_grp_idx`)} ON ${tasks} (${this.q('grp')}, ${this.q('status')}, ${this.q('created_at')})`,\n      )\n      .catch(() => {});\n  }\n\n  // ── engine → worker ────────────────────────────────────────────────────────────────────────\n  async dispatch(task: RemoteTask): Promise<void> {\n    await this.ensureSchema();\n    const t = this.q(this.tasksTable);\n    // Idempotent: a redelivered dispatch for the same step_id is ignored (the row already exists).\n    const ignore = this.isPg\n      ? `INSERT INTO ${t} (...) ON CONFLICT (${this.q('step_id')}) DO NOTHING`\n      : `INSERT IGNORE INTO ${t} (...)`;\n    const cols = [\n      'step_id',\n      'run_id',\n      'seq',\n      'name',\n      'grp',\n      'input',\n      'attempt',\n      'status',\n      'created_at',\n    ];\n    const sql = ignore.replace(\n      '(...)',\n      `(${cols.map((c) => this.q(c)).join(', ')}) VALUES (${cols.map((_, i) => this.ph(i + 1)).join(', ')})`,\n    );\n    await this.exec.query(sql, [\n      task.stepId,\n      task.runId,\n      task.seq,\n      task.name,\n      task.group,\n      JSON.stringify(task.input ?? null),\n      task.attempt,\n      'pending',\n      this.now(),\n    ]);\n  }\n\n  // ── worker → engine ────────────────────────────────────────────────────────────────────────\n  handle(name: string, fn: StepHandler): void {\n    if (!this.group) throw new Error('DbTransport needs a `group` to register handlers');\n    this.handlers.set(name, fn);\n    if (!this.taskLoop) this.taskLoop = this.loop(() => this.drainTasks(this.group as string));\n  }\n\n  onResult(handler: (result: StepResult) => Promise<void>): void {\n    if (!this.resultLoop) this.resultLoop = this.loop(() => this.drainResults(handler));\n  }\n\n  onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void {\n    // Not modelled; the lease/reclaim on `claimed_at` is the liveness mechanism.\n  }\n\n  // ── polling ──────────────────────────────────────────────────────────────────────────────────\n  /** Run `tick` repeatedly; sleep `pollMs` when it reports an empty queue. Stops on `close()`. */\n  private async loop(tick: () => Promise<number>): Promise<void> {\n    while (this.running) {\n      let processed = 0;\n      try {\n        await this.ensureSchema();\n        processed = await tick();\n      } catch (err) {\n        if (this.running) this.onError(err);\n      }\n      if (processed === 0 && this.running) await this.sleep(this.pollMs);\n    }\n  }\n\n  /**\n   * One task-loop round: claim as many rows as there are free slots (never more — a claimed row that\n   * isn't running is one an idle sibling can't run), and start each. With every slot busy, wait for\n   * one to free instead of polling.\n   */\n  private async drainTasks(group: string): Promise<number> {\n    const free = this.concurrency - this.runningTasks.size;\n    if (free <= 0) {\n      await Promise.race(this.runningTasks);\n      return 1;\n    }\n    const { rows, token } = await this.claim<TaskRow>(\n      this.tasksTable,\n      Math.min(free, this.batchSize),\n      `${this.q('grp')} = ${this.ph(1)}`,\n      [group],\n    );\n    if (rows.length === 0) return 0;\n    this.hold(this.tasksTable, token);\n    let left = rows.length;\n    for (const row of rows) {\n      const run = this.runTask(row, group, token).finally(() => {\n        this.runningTasks.delete(run);\n        left -= 1;\n        if (left === 0) this.release(this.tasksTable, token);\n      });\n      this.runningTasks.add(run);\n    }\n    return rows.length;\n  }\n\n  /**\n   * Run one claimed task and settle it — only while this instance still holds the claim: the claim is\n   * re-checked before running, and the task row is deleted and its result written in ONE transaction,\n   * conditional on the claim token, so an instance whose claim was taken over neither deletes the new\n   * holder's row nor publishes a second result.\n   */\n  private async runTask(row: TaskRow, group: string, token: string): Promise<void> {\n    try {\n      if (!(await this.stillHolds(row.step_id, token))) {\n        this.onError(\n          new Error(\n            `[DbTransport] lost the claim on task ${row.step_id} before running it — another instance took it over; not running it here`,\n          ),\n        );\n        return;\n      }\n      const task: RemoteTask = {\n        runId: row.run_id,\n        seq: Number(row.seq),\n        stepId: row.step_id,\n        name: row.name,\n        group,\n        input: row.input == null ? undefined : JSON.parse(row.input),\n        attempt: Number(row.attempt),\n      };\n      const result = await runStepHandler(task, this.handlers.get(task.name));\n      if (!(await this.settleTask(task.stepId, token, result))) {\n        this.onError(\n          new Error(\n            `[DbTransport] lost the claim on task ${task.stepId} while running it (this instance went silent past leaseMs) — another instance took it over and may run it too; this run's result was dropped. Raise leaseMs if steps block the event loop`,\n          ),\n        );\n      }\n    } catch (err) {\n      // A database error settling the row (or a malformed row): it stays claimed, stops being\n      // renewed, and is reclaimed after the lease — at-least-once, like a crash.\n      this.onError(err);\n    }\n  }\n\n  /** Whether the claim on `stepId` is still `token`'s (re-stamping it if so). */\n  private async stillHolds(stepId: string, token: string): Promise<boolean> {\n    const t = this.q(this.tasksTable);\n    const rows = await this.exec.transaction(async (tx) => {\n      const held = await tx.query<{ step_id: string }>(\n        `SELECT ${this.q('step_id')} FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)} FOR UPDATE`,\n        [stepId, token],\n      );\n      if (held.length > 0) {\n        await tx.query(\n          `UPDATE ${t} SET ${this.q('claimed_at')} = ${this.ph(1)} WHERE ${this.q('step_id')} = ${this.ph(2)} AND ${this.q('claimed_by')} = ${this.ph(3)}`,\n          [this.now(), stepId, token],\n        );\n      }\n      return held;\n    });\n    return rows.length > 0;\n  }\n\n  /** Delete the task row and publish its result in ONE transaction, only while `token` holds it. */\n  private async settleTask(stepId: string, token: string, result: StepResult): Promise<boolean> {\n    const t = this.q(this.tasksTable);\n    return this.exec.transaction(async (tx) => {\n      const held = await tx.query<{ step_id: string }>(\n        `SELECT ${this.q('step_id')} FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)} FOR UPDATE`,\n        [stepId, token],\n      );\n      if (held.length === 0) return false;\n      await tx.query(\n        `DELETE FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)}`,\n        [stepId, token],\n      );\n      await this.insertResult(result, tx);\n      return true;\n    });\n  }\n\n  /**\n   * Claim a batch of results, deliver each to the engine, and delete it — only after its handler ran\n   * (at-least-once), and only while this round still holds the claim (a newer result for the same\n   * step that replaced the row resets the claim, so it is delivered next instead of deleted). The\n   * batch's claim is renewed until it is done. A throwing handler is reported and its row left for\n   * re-delivery after the lease; the rest of the batch continues.\n   */\n  private async drainResults(handler: (result: StepResult) => Promise<void>): Promise<number> {\n    const { rows, token } = await this.claim<ResultRow>(\n      this.resultsTable,\n      this.batchSize,\n      '1 = 1',\n      [],\n    );\n    if (rows.length === 0) return 0;\n    this.hold(this.resultsTable, token);\n    try {\n      for (const row of rows) {\n        if (!this.running) break;\n        try {\n          const result: StepResult = {\n            runId: row.run_id,\n            seq: Number(row.seq),\n            stepId: row.step_id,\n            status: row.status as StepResult['status'],\n            output: row.output == null ? undefined : JSON.parse(row.output),\n            error: row.error == null ? undefined : JSON.parse(row.error),\n            startedAt: row.started_at == null ? undefined : Number(row.started_at),\n          };\n          await handler(result);\n          await this.exec.query(\n            `DELETE FROM ${this.q(this.resultsTable)} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)}`,\n            [row.step_id, token],\n          );\n        } catch (err) {\n          this.onError(err);\n        }\n      }\n    } finally {\n      this.release(this.resultsTable, token);\n    }\n    return rows.length;\n  }\n\n  /**\n   * Atomically claim up to `limit` un-leased rows matching `where` and stamp them with a claim token\n   * unique to this round (`<instanceId>:<uuid>`). `SELECT … FOR UPDATE SKIP LOCKED` inside the txn\n   * means concurrent instances skip each other's locked rows instead of blocking, so no row is\n   * claimed twice; the token is what every later delete/settle is conditional on.\n   */\n  private async claim<T extends { step_id: string }>(\n    table: string,\n    limit: number,\n    where: string,\n    whereParams: unknown[],\n  ): Promise<{ rows: T[]; token: string }> {\n    const t = this.q(table);\n    const staleBefore = this.now() - this.leaseMs;\n    const token = `${this.instanceId}:${randomUUID()}`;\n    const rows = await this.exec.transaction(async (tx) => {\n      const leaseClause = `(${this.q('claimed_at')} IS NULL OR ${this.q('claimed_at')} < ${this.ph(whereParams.length + 1)})`;\n      const found = await tx.query<T>(\n        `SELECT * FROM ${t} WHERE ${where} AND ${leaseClause}\n         ORDER BY ${this.q('created_at')} ASC LIMIT ${Math.max(1, Math.floor(limit))} FOR UPDATE SKIP LOCKED`,\n        [...whereParams, staleBefore],\n      );\n      if (found.length > 0) {\n        const ids = found.map((r) => r.step_id);\n        const placeholders = ids.map((_, i) => this.ph(i + 3)).join(', ');\n        await tx.query(\n          `UPDATE ${t} SET ${this.q('claimed_by')} = ${this.ph(1)}, ${this.q('claimed_at')} = ${this.ph(2)}\n           WHERE ${this.q('step_id')} IN (${placeholders})`,\n          [token, this.now(), ...ids],\n        );\n      }\n      return found;\n    });\n    return { rows, token };\n  }\n\n  // ── claim renewal: every claim held, not only the row being run ─────────────────────────────\n  private hold(table: string, token: string): void {\n    let tokens = this.held.get(table);\n    if (!tokens) {\n      tokens = new Set();\n      this.held.set(table, tokens);\n    }\n    tokens.add(token);\n    if (this.renewTimer) return;\n    const intervalMs = Math.max(10, Math.floor(this.leaseMs / 3));\n    this.renewTimer = setInterval(() => {\n      if (this.renewal) return; // a slow database never stacks renewal rounds\n      const round = this.renewHeld()\n        .catch((err) => this.onError(err))\n        .finally(() => {\n          if (this.renewal === round) this.renewal = undefined;\n        });\n      this.renewal = round;\n    }, intervalMs);\n    this.renewTimer.unref?.();\n  }\n\n  private release(table: string, token: string): void {\n    const tokens = this.held.get(table);\n    tokens?.delete(token);\n    if (tokens?.size === 0) this.held.delete(table);\n    if (this.held.size === 0 && this.renewTimer) {\n      clearInterval(this.renewTimer);\n      this.renewTimer = undefined;\n    }\n  }\n\n  /** Re-stamp `claimed_at` on every row still claimed under a token this instance holds. */\n  private async renewHeld(): Promise<void> {\n    for (const [table, tokens] of this.held) {\n      if (tokens.size === 0) continue;\n      const list = [...tokens];\n      const placeholders = list.map((_, i) => this.ph(i + 2)).join(', ');\n      await this.exec.query(\n        `UPDATE ${this.q(table)} SET ${this.q('claimed_at')} = ${this.ph(1)} WHERE ${this.q('claimed_by')} IN (${placeholders})`,\n        [this.now(), ...list],\n      );\n    }\n  }\n\n  /**\n   * Write a result row. A result already waiting for the same step (an earlier attempt's, not yet\n   * deleted by the engine) is REPLACED and its claim reset, never kept: `step_id` is stable across\n   * attempts, so keeping the old row would silently drop a retry's result.\n   */\n  private async insertResult(result: StepResult, tx: SqlTx = this.exec): Promise<void> {\n    const t = this.q(this.resultsTable);\n    const cols = [\n      'step_id',\n      'run_id',\n      'seq',\n      'status',\n      'output',\n      'error',\n      'started_at',\n      'created_at',\n    ];\n    const replace = ['run_id', 'seq', 'status', 'output', 'error', 'started_at', 'created_at'];\n    const values = `(${cols.map((c) => this.q(c)).join(', ')}) VALUES (${cols.map((_, i) => this.ph(i + 1)).join(', ')})`;\n    const sql = this.isPg\n      ? `INSERT INTO ${t} ${values} ON CONFLICT (${this.q('step_id')}) DO UPDATE SET ${[\n          ...replace.map((c) => `${this.q(c)} = EXCLUDED.${this.q(c)}`),\n          `${this.q('claimed_by')} = NULL`,\n          `${this.q('claimed_at')} = NULL`,\n        ].join(', ')}`\n      : `INSERT INTO ${t} ${values} ON DUPLICATE KEY UPDATE ${[\n          ...replace.map((c) => `${this.q(c)} = VALUES(${this.q(c)})`),\n          `${this.q('claimed_by')} = NULL`,\n          `${this.q('claimed_at')} = NULL`,\n        ].join(', ')}`;\n    await tx.query(sql, [\n      result.stepId,\n      result.runId,\n      result.seq,\n      result.status,\n      result.output === undefined ? null : JSON.stringify(result.output),\n      result.error === undefined ? null : JSON.stringify(result.error),\n      result.startedAt ?? null,\n      this.now(),\n    ]);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((r) => setTimeout(r, ms));\n  }\n\n  /** Stop the pollers and wait for the current ticks to settle. Does not close the shared DataSource. */\n  async close(): Promise<void> {\n    this.running = false;\n    await Promise.allSettled([this.taskLoop, this.resultLoop]);\n    // Let running tasks settle (their claims keep being renewed until they do).\n    await Promise.allSettled([...this.runningTasks]);\n    if (this.renewTimer) clearInterval(this.renewTimer);\n    this.renewTimer = undefined;\n    await this.renewal;\n  }\n}\n","/**\n * The tiny SQL surface `DbTransport` needs, so it rides **whatever ORM/connection the app already\n * has** instead of forcing a specific one. Implement it for your ORM (adapters for TypeORM and\n * MikroORM ship below) and hand it to `new DbTransport({ executor })`. Mirrors how the durable\n * *store* is ORM-pluggable (store-typeorm / store-mikro-orm / …).\n */\nexport interface SqlExecutor {\n  /** Drives placeholder style (`$n` vs `?`) and a couple of DDL type choices. */\n  readonly dialect: 'mysql' | 'postgres';\n  /** Quote/escape an identifier (table/column name) for this dialect. */\n  escapeId(id: string): string;\n  /** Run a statement outside a transaction. */\n  query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\n  /** Run `fn` inside a transaction — the claim uses `FOR UPDATE SKIP LOCKED` within it. */\n  transaction<T>(fn: (tx: SqlTx) => Promise<T>): Promise<T>;\n}\n\nexport interface SqlTx {\n  query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\n}\n\n// ── TypeORM ──────────────────────────────────────────────────────────────────────────────────────\n\n/** Structural slice of a TypeORM `DataSource` — avoids a hard dependency on typeorm. */\ninterface TypeOrmDataSourceLike {\n  options: { type: string };\n  driver: { escape(id: string): string };\n  query(sql: string, params?: unknown[]): Promise<unknown>;\n  createQueryRunner(): {\n    connect(): Promise<void>;\n    startTransaction(): Promise<void>;\n    commitTransaction(): Promise<void>;\n    rollbackTransaction(): Promise<void>;\n    release(): Promise<void>;\n    query(sql: string, params?: unknown[]): Promise<unknown>;\n  };\n}\n\n/** Build an executor from a TypeORM `DataSource` (e.g. the one the durable store already uses). */\nexport function typeOrmExecutor(ds: TypeOrmDataSourceLike): SqlExecutor {\n  return {\n    dialect: /postgres/.test(String(ds.options.type)) ? 'postgres' : 'mysql',\n    escapeId: (id) => ds.driver.escape(id),\n    query: <T>(sql: string, params?: unknown[]) => ds.query(sql, params) as Promise<T[]>,\n    transaction: async <T>(fn: (tx: SqlTx) => Promise<T>) => {\n      const qr = ds.createQueryRunner();\n      await qr.connect();\n      await qr.startTransaction();\n      try {\n        const result = await fn({\n          query: <U>(sql: string, params?: unknown[]) => qr.query(sql, params) as Promise<U[]>,\n        });\n        await qr.commitTransaction();\n        return result;\n      } catch (err) {\n        await qr.rollbackTransaction();\n        throw err;\n      } finally {\n        await qr.release();\n      }\n    },\n  };\n}\n\n// ── MikroORM ─────────────────────────────────────────────────────────────────────────────────────\n\n/** Structural slice of a MikroORM `EntityManager` — avoids a hard dependency on @mikro-orm/core. */\ninterface MikroOrmEmLike {\n  getPlatform(): { constructor: { name: string }; quoteIdentifier(id: string): string };\n  getConnection(): {\n    execute(sql: string, params?: unknown[], method?: 'all', ctx?: unknown): Promise<unknown>;\n  };\n  getTransactionContext?(): unknown;\n  transactional<T>(cb: (em: MikroOrmEmLike) => Promise<T>): Promise<T>;\n}\n\n/**\n * Build an executor from a MikroORM `EntityManager` — i.e. **the app's own configured ORM**. Runs\n * raw SQL through `em.getConnection().execute(...)` and wraps the claim in `em.transactional(...)`,\n * threading the transaction context so `FOR UPDATE SKIP LOCKED` locks within the tx.\n */\nexport function mikroOrmExecutor(em: MikroOrmEmLike): SqlExecutor {\n  const platform = em.getPlatform();\n  return {\n    dialect: /postgre/i.test(platform.constructor.name) ? 'postgres' : 'mysql',\n    escapeId: (id) => platform.quoteIdentifier(id),\n    query: <T>(sql: string, params?: unknown[]) =>\n      em.getConnection().execute(sql, params ?? [], 'all') as Promise<T[]>,\n    transaction: <T>(fn: (tx: SqlTx) => Promise<T>) =>\n      em.transactional((txEm) =>\n        fn({\n          query: <U>(sql: string, params?: unknown[]) =>\n            txEm\n              .getConnection()\n              .execute(sql, params ?? [], 'all', txEm.getTransactionContext?.()) as Promise<U[]>,\n        }),\n      ),\n  };\n}\n"],"mappings":"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","names":["typeOrmExecutor","ds","dialect","test","String","options","type","escapeId","id","driver","escape","query","sql","params","transaction","fn","qr","createQueryRunner","connect","startTransaction","result","commitTransaction","err","rollbackTransaction","release","mikroOrmExecutor","em","platform","getPlatform","name","quoteIdentifier","getConnection","execute","transactional","txEm","getTransactionContext","numberOption","value","fallback","min","undefined","Number","isFinite","DbTransport","exec","group","tasksTable","resultsTable","pollMs","leaseMs","batchSize","concurrency","onError","autoCreate","instanceId","isPg","handlers","Map","running","schemaReady","taskLoop","resultLoop","runningTasks","Set","held","renewTimer","renewal","options","executor","prefix","Math","floor","err","console","error","randomUUID","dialect","ph","i","q","id","escapeId","now","Date","ensureSchema","createTables","catch","createIfMissing","sql","query","str","txt","tasks","results","dispatch","task","t","ignore","cols","replace","map","c","join","_","stepId","runId","seq","name","JSON","stringify","input","attempt","handle","fn","Error","set","loop","drainTasks","onResult","handler","drainResults","onHeartbeat","_handler","tick","processed","sleep","free","size","Promise","race","rows","token","claim","length","hold","left","row","run","runTask","finally","delete","release","add","stillHolds","step_id","run_id","parse","result","runStepHandler","get","settleTask","transaction","tx","insertResult","status","output","startedAt","started_at","table","limit","where","whereParams","staleBefore","leaseClause","found","max","ids","r","placeholders","tokens","intervalMs","setInterval","round","renewHeld","unref","clearInterval","list","values","ms","setTimeout","close","allSettled"]}
+{"version":3,"sources":["../src/index.ts","../src/db-transport.ts","../src/executors.ts"],"sourcesContent":["export * from './db-transport';\n","import { randomUUID } from 'node:crypto';\nimport {\n  type Heartbeat,\n  type RemoteTask,\n  type RunConsumerOptions,\n  type RunDispatch,\n  type RunQueueOptions,\n  type StepHandler,\n  type StepResult,\n  type Transport,\n  runStepHandler,\n} from '@dudousxd/nestjs-durable-core';\nimport type { SqlExecutor, SqlTx } from './executors';\n\nexport { mikroOrmExecutor, type SqlExecutor, type SqlTx, typeOrmExecutor } from './executors';\n\n/** Raw row shapes returned by `SELECT *` (declared fields, so they're not `| undefined` under noUncheckedIndexedAccess). */\ninterface TaskRow {\n  step_id: string;\n  run_id: string;\n  seq: string | number;\n  name: string;\n  input: string | null;\n  attempt: string | number;\n}\ninterface RunRow {\n  run_id: string;\n  wake: number | string;\n}\n\n/** A claimed run row: its run id and the token of this claim. */\ninterface ClaimedRun {\n  run: RunDispatch;\n  token: string;\n}\n\n/** Most rows one {@link DbTransport.dispatchRuns} insert writes. */\nconst RUNS_INSERT_CHUNK = 500;\n/** Tries for a statement the database rolled back as a deadlock (see `retryOnDeadlock`). */\nconst DEADLOCK_RETRIES = 5;\n\n/** Whether `err` is the database rolling a statement back to break a deadlock. */\nfunction isDeadlock(err: unknown): boolean {\n  const codes = [\n    (err as { code?: unknown }).code,\n    (err as { errno?: unknown }).errno,\n    (err as { driverError?: { code?: unknown; errno?: unknown } }).driverError?.code,\n    (err as { driverError?: { code?: unknown; errno?: unknown } }).driverError?.errno,\n  ];\n  return codes.some((c) => c === 'ER_LOCK_DEADLOCK' || c === 1213 || c === '40P01');\n}\n\n/** Most run rows one consumer poll claims. */\nconst RUNS_CLAIM_MAX = 50;\n\n/** A run-queue consumer started by {@link DbTransport.onDispatchedRun}. */\ninterface RunConsumer {\n  stopped: boolean;\n  /** Claim tokens of the rows whose runs are in flight. */\n  inflight: Set<string>;\n  slotFreed: (() => void) | undefined;\n  loop: Promise<void>;\n}\n\ninterface ResultRow {\n  step_id: string;\n  run_id: string;\n  seq: string | number;\n  status: string;\n  output: string | null;\n  error: string | null;\n  started_at: string | number | null;\n}\n\nexport interface DbTransportOptions {\n  /**\n   * How to run SQL — built from the app's **own** ORM/connection (no broker, no extra connection).\n   * Use `mikroOrmExecutor(em)` to ride the app's MikroORM, `typeOrmExecutor(dataSource)` for TypeORM,\n   * `drizzlePgExecutor(db)` (from `@dudousxd/nestjs-durable-store-drizzle/pg`) for Drizzle on\n   * Postgres, or implement `SqlExecutor` for anything else.\n   */\n  executor: SqlExecutor;\n  /** The worker group this instance serves. Required to register `handle()` consumers. */\n  group?: string;\n  /**\n   * Table-name prefix. Tables: `${prefix}_transport_tasks` / `${prefix}_transport_results`, and\n   * `${prefix}_transport_runs` for the run queue. Default `durable`.\n   */\n  prefix?: string;\n  /** Poll interval in ms when a queue is empty. Default 500. */\n  pollMs?: number;\n  /**\n   * How long a claimed row is owned before it's reclaimable (crash recovery), in ms. Default 30_000.\n   * Every claim this instance holds is renewed every `leaseMs / 3` while it is waiting or running, so\n   * a step may run longer than `leaseMs`; only a crashed (or event-loop-blocked) instance loses it.\n   */\n  leaseMs?: number;\n  /**\n   * Max rows claimed per poll. Default 10. The task loop claims only as many rows as it has free\n   * {@link concurrency} slots (capped by this); the results loop claims up to this many.\n   */\n  batchSize?: number;\n  /**\n   * How many tasks this instance runs at once (worker side). Default 1. A row is claimed only when a\n   * slot is free to run it, so rows never wait claimed behind a slow task while a sibling sits idle.\n   */\n  concurrency?: number;\n  /**\n   * Where a transport failure is reported: a failing poll, a throwing result handler (the result is\n   * re-delivered after the lease), a lost claim. Default `console.error`.\n   */\n  onError?: (err: unknown) => void;\n  /** Create the tables on first use if missing. Default true. */\n  autoCreate?: boolean;\n  /** Identifies this instance in `claimed_by` (for debugging). Defaults to a random id. */\n  instanceId?: string;\n}\n\n/**\n * A numeric option: `fallback` unless `value` is a finite number of at least `min`. `Math.max(1, NaN)`\n * is `NaN`, so a clamp alone would let a `NaN` through (to `LIMIT NaN`, or a `NaN` timer).\n */\nfunction numberOption(value: number | undefined, fallback: number, min: number): number {\n  return value !== undefined && Number.isFinite(value) && value >= min ? value : fallback;\n}\n\n/**\n * A SQL-backed `Transport` — DBOS-style. Instead of a broker (Redis/SQS), remote steps are **rows**\n * in the same database the durable store already uses: `dispatch` inserts a task row, a worker\n * claims it with `SELECT … FOR UPDATE SKIP LOCKED` (so instances never double-claim), runs it, and\n * writes a result row the engine polls. Zero new infrastructure — the DB you already have IS the\n * queue.\n *\n * Trade-off vs a real broker: throughput is bounded by polling + row contention. Great for\n * workflow/pipeline scale (modest rate, long steps); not for high-fanout firehoses.\n *\n * Requires `FOR UPDATE SKIP LOCKED` — **MySQL 8+** or **Postgres 9.5+** (not SQLite). Run one\n * instance engine-side (`onResult`, dispatches) and one per worker process (`handle()` for its group).\n */\nexport class DbTransport implements Transport {\n  private readonly exec: SqlExecutor;\n  private readonly group?: string | undefined;\n  private readonly tasksTable: string;\n  private readonly resultsTable: string;\n  private readonly runsTable: string;\n  private readonly runConsumers = new Set<RunConsumer>();\n  private readonly pollMs: number;\n  private readonly leaseMs: number;\n  private readonly batchSize: number;\n  private readonly concurrency: number;\n  private readonly onError: (err: unknown) => void;\n  private readonly autoCreate: boolean;\n  private readonly instanceId: string;\n  private readonly isPg: boolean;\n\n  private readonly handlers = new Map<string, StepHandler>();\n  private running = true;\n  private schemaReady?: Promise<void> | undefined;\n  private taskLoop?: Promise<void>;\n  private resultLoop?: Promise<void>;\n  /** Tasks running on this instance (at most `concurrency`). */\n  private readonly runningTasks = new Set<Promise<void>>();\n  /** Claim tokens this instance holds, by table — every one is renewed on `renewTimer`. */\n  private readonly held = new Map<string, Set<string>>();\n  private renewTimer?: ReturnType<typeof setInterval> | undefined;\n  private renewal?: Promise<void> | undefined;\n\n  constructor(options: DbTransportOptions) {\n    this.exec = options.executor;\n    this.group = options.group;\n    const prefix = options.prefix ?? 'durable';\n    this.tasksTable = `${prefix}_transport_tasks`;\n    this.resultsTable = `${prefix}_transport_results`;\n    this.runsTable = `${prefix}_transport_runs`;\n    this.pollMs = numberOption(options.pollMs, 500, 0);\n    this.leaseMs = numberOption(options.leaseMs, 30_000, 1);\n    this.batchSize = Math.floor(numberOption(options.batchSize, 10, 1));\n    this.concurrency = Math.floor(numberOption(options.concurrency, 1, 1));\n    this.onError = options.onError ?? ((err) => console.error('[DbTransport]', err));\n    this.autoCreate = options.autoCreate ?? true;\n    // Random, not time-based: two instances booted in the same millisecond must not share an id.\n    this.instanceId = options.instanceId ?? `db-${randomUUID()}`;\n    this.isPg = this.exec.dialect === 'postgres';\n  }\n\n  // ── dialect helpers ──────────────────────────────────────────────────────────────────────────\n  /** Positional placeholder for param `i` (1-based): `$i` on Postgres, `?` elsewhere. */\n  private ph(i: number): string {\n    return this.isPg ? `$${i}` : '?';\n  }\n  private q(id: string): string {\n    return this.exec.escapeId(id);\n  }\n  private now(): number {\n    return Math.floor(Date.now());\n  }\n\n  // ── schema ───────────────────────────────────────────────────────────────────────────────────\n  private ensureSchema(): Promise<void> {\n    if (!this.schemaReady) {\n      // A failed attempt is not cached: the next call tries again instead of failing forever.\n      this.schemaReady = this.createTables().catch((err) => {\n        this.schemaReady = undefined;\n        throw err;\n      });\n    }\n    return this.schemaReady;\n  }\n\n  /**\n   * Run one `CREATE … IF NOT EXISTS`. Two instances booting on a fresh database race it, and Postgres\n   * can reject the loser with a unique violation on its catalog even with `IF NOT EXISTS`; the\n   * statement is simply re-run, by which point the table exists and it is a no-op.\n   */\n  private async createIfMissing(sql: string): Promise<void> {\n    try {\n      await this.exec.query(sql);\n    } catch {\n      await this.exec.query(sql);\n    }\n  }\n\n  private async createTables(): Promise<void> {\n    if (!this.autoCreate) return;\n    const str = 'varchar(191)';\n    const txt = this.isPg ? 'text' : 'longtext';\n    const tasks = this.q(this.tasksTable);\n    const results = this.q(this.resultsTable);\n    await this.createIfMissing(\n      `CREATE TABLE IF NOT EXISTS ${tasks} (\n        ${this.q('step_id')} ${str} PRIMARY KEY,\n        ${this.q('run_id')} ${str} NOT NULL,\n        ${this.q('seq')} integer NOT NULL,\n        ${this.q('name')} ${str} NOT NULL,\n        ${this.q('grp')} ${str} NOT NULL,\n        ${this.q('input')} ${txt},\n        ${this.q('attempt')} integer NOT NULL,\n        ${this.q('status')} varchar(32) NOT NULL,\n        ${this.q('claimed_by')} ${str},\n        ${this.q('claimed_at')} bigint,\n        ${this.q('created_at')} bigint NOT NULL\n      )`,\n    );\n    await this.createIfMissing(\n      `CREATE TABLE IF NOT EXISTS ${results} (\n        ${this.q('step_id')} ${str} PRIMARY KEY,\n        ${this.q('run_id')} ${str} NOT NULL,\n        ${this.q('seq')} integer NOT NULL,\n        ${this.q('status')} varchar(32) NOT NULL,\n        ${this.q('output')} ${txt},\n        ${this.q('error')} ${txt},\n        ${this.q('started_at')} bigint,\n        ${this.q('claimed_by')} ${str},\n        ${this.q('claimed_at')} bigint,\n        ${this.q('created_at')} bigint NOT NULL\n      )`,\n    );\n    await this.createIfMissing(\n      `CREATE TABLE IF NOT EXISTS ${this.q(this.runsTable)} (\n        ${this.q('run_id')} ${str} PRIMARY KEY,\n        ${this.q('ns')} ${str} NOT NULL,\n        ${this.q('priority')} integer NOT NULL,\n        ${this.q('wake')} integer NOT NULL,\n        ${this.q('claimed_by')} ${str},\n        ${this.q('claim_token')} ${str},\n        ${this.q('claimed_at')} bigint,\n        ${this.q('created_at')} bigint NOT NULL\n      )`,\n    );\n    await this.exec\n      .query(\n        `CREATE INDEX ${this.q(`${this.runsTable}_ns_idx`)} ON ${this.q(this.runsTable)} (${this.q('ns')}, ${this.q('priority')}, ${this.q('created_at')})`,\n      )\n      .catch(() => {});\n    // Best-effort index for the group poll (MySQL has no CREATE INDEX IF NOT EXISTS < 8.0.13).\n    await this.exec\n      .query(\n        `CREATE INDEX ${this.q(`${this.tasksTable}_grp_idx`)} ON ${tasks} (${this.q('grp')}, ${this.q('status')}, ${this.q('created_at')})`,\n      )\n      .catch(() => {});\n  }\n\n  // ── engine → worker ────────────────────────────────────────────────────────────────────────\n  async dispatch(task: RemoteTask): Promise<void> {\n    await this.ensureSchema();\n    const t = this.q(this.tasksTable);\n    // Idempotent: a redelivered dispatch for the same step_id is ignored (the row already exists).\n    const ignore = this.isPg\n      ? `INSERT INTO ${t} (...) ON CONFLICT (${this.q('step_id')}) DO NOTHING`\n      : `INSERT IGNORE INTO ${t} (...)`;\n    const cols = [\n      'step_id',\n      'run_id',\n      'seq',\n      'name',\n      'grp',\n      'input',\n      'attempt',\n      'status',\n      'created_at',\n    ];\n    const sql = ignore.replace(\n      '(...)',\n      `(${cols.map((c) => this.q(c)).join(', ')}) VALUES (${cols.map((_, i) => this.ph(i + 1)).join(', ')})`,\n    );\n    await this.exec.query(sql, [\n      task.stepId,\n      task.runId,\n      task.seq,\n      task.name,\n      task.group,\n      JSON.stringify(task.input ?? null),\n      task.attempt,\n      'pending',\n      this.now(),\n    ]);\n  }\n\n  // ── worker → engine ────────────────────────────────────────────────────────────────────────\n  handle(name: string, fn: StepHandler): void {\n    if (!this.group) throw new Error('DbTransport needs a `group` to register handlers');\n    this.handlers.set(name, fn);\n    if (!this.taskLoop) this.taskLoop = this.loop(() => this.drainTasks(this.group as string));\n  }\n\n  onResult(handler: (result: StepResult) => Promise<void>): void {\n    if (!this.resultLoop) this.resultLoop = this.loop(() => this.drainResults(handler));\n  }\n\n  onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void {\n    // Not modelled; the lease/reclaim on `claimed_at` is the liveness mechanism.\n  }\n\n  // ── run queue (engine ↔ engine) ─────────────────────────────────────────────────────────────\n  /**\n   * Queue `pending` runs for whichever engine instance polls the run queue first: one row per run,\n   * keyed by run id, so a run already waiting is not queued twice. A run whose row an instance holds\n   * right now is released for another take, so a dispatch landing while the run's previous entry is\n   * being handled is not lost when that entry is deleted. Up to {@link RUNS_INSERT_CHUNK} rows per\n   * insert.\n   */\n  async dispatchRuns(runs: readonly RunDispatch[], opts?: RunQueueOptions): Promise<void> {\n    if (runs.length === 0) return;\n    await this.ensureSchema();\n    // One row per run (an upsert may not touch the same row twice in one statement); a wake among\n    // a run's dispatches makes its row a wake.\n    const byRun = new Map<string, RunDispatch>();\n    for (const run of runs) {\n      if (!byRun.has(run.runId) || run.reason === 'wake') byRun.set(run.runId, run);\n    }\n    // In run-id order: two dispatches touching overlapping rows lock them in the same order.\n    const unique = [...byRun.values()].sort((a, b) =>\n      a.runId < b.runId ? -1 : a.runId > b.runId ? 1 : 0,\n    );\n    const t = this.q(this.runsTable);\n    const cols = ['run_id', 'ns', 'priority', 'wake', 'created_at'];\n    const now = this.now();\n    for (let at = 0; at < unique.length; at += RUNS_INSERT_CHUNK) {\n      const chunk = unique.slice(at, at + RUNS_INSERT_CHUNK);\n      const values = chunk\n        .map((_, r) => `(${cols.map((__, c) => this.ph(r * cols.length + c + 1)).join(', ')})`)\n        .join(', ');\n      const insert = `INTO ${t} (${cols.map((c) => this.q(c)).join(', ')}) VALUES ${values}`;\n      const release = ['claimed_by', 'claim_token', 'claimed_at']\n        .map((c) => `${this.q(c)} = NULL`)\n        .join(', ');\n      const wake = this.q('wake');\n      const sql = this.isPg\n        ? `INSERT ${insert} ON CONFLICT (${this.q('run_id')}) DO UPDATE SET ${release}, ${wake} = GREATEST(${t}.${wake}, EXCLUDED.${wake})`\n        : `INSERT ${insert} ON DUPLICATE KEY UPDATE ${release}, ${wake} = GREATEST(${wake}, VALUES(${wake}))`;\n      await this.retryOnDeadlock(() =>\n        this.exec.query(\n          sql,\n          chunk.flatMap((run, r) => [\n            run.runId,\n            opts?.namespace ?? '',\n            run.priority ?? 0,\n            run.reason === 'wake' ? 1 : 0,\n            now + r,\n          ]),\n        ),\n      );\n    }\n  }\n\n  /**\n   * Poll the run queue, at most `opts.concurrency` runs in flight on this instance. Rows are claimed\n   * with `FOR UPDATE SKIP LOCKED` (instances never take the same run), highest priority then oldest\n   * first; a row is deleted once its handler settles, and its lease is renewed meanwhile, so a row is\n   * re-taken only after the instance holding it went down. The returned stop takes no more rows and\n   * resolves once the runs in flight settled.\n   */\n  onDispatchedRun(\n    handler: (run: RunDispatch) => Promise<void>,\n    opts: RunConsumerOptions,\n  ): () => Promise<void> {\n    const consumer: RunConsumer = {\n      stopped: false,\n      inflight: new Set(),\n      slotFreed: undefined,\n      loop: Promise.resolve(),\n    };\n    const concurrency = Math.max(1, Math.floor(opts.concurrency));\n    const ns = opts.namespace ?? '';\n    consumer.loop = this.consumeRuns(consumer, handler, concurrency, ns).catch((err) => {\n      this.onError(err);\n    });\n    this.runConsumers.add(consumer);\n    return () => this.stopRunConsumer(consumer);\n  }\n\n  private async stopRunConsumer(consumer: RunConsumer): Promise<void> {\n    consumer.stopped = true;\n    consumer.slotFreed?.();\n    await consumer.loop;\n    this.runConsumers.delete(consumer);\n  }\n\n  private async consumeRuns(\n    consumer: RunConsumer,\n    handler: (run: RunDispatch) => Promise<void>,\n    concurrency: number,\n    ns: string,\n  ): Promise<void> {\n    const renew = setInterval(\n      () => void this.renewRunLeases(consumer).catch(() => undefined),\n      Math.max(1_000, Math.floor(this.leaseMs / 3)),\n    );\n    renew.unref?.();\n    const settled = new Set<Promise<unknown>>();\n    try {\n      while (this.running && !consumer.stopped) {\n        const free = concurrency - consumer.inflight.size;\n        if (free <= 0) {\n          await new Promise<void>((resolve) => {\n            consumer.slotFreed = resolve;\n          });\n          consumer.slotFreed = undefined;\n          continue;\n        }\n        let rows: ClaimedRun[] = [];\n        try {\n          await this.ensureSchema();\n          rows = await this.retryOnDeadlock(() =>\n            this.claimRuns(ns, Math.min(free, RUNS_CLAIM_MAX)),\n          );\n        } catch (err) {\n          if (this.running && !consumer.stopped) this.onError(err);\n        }\n        for (const { run, token } of rows) {\n          consumer.inflight.add(token);\n          const done = handler(run)\n            .catch(() => undefined)\n            .then(() =>\n              this.retryOnDeadlock(() =>\n                this.exec.query(\n                  `DELETE FROM ${this.q(this.runsTable)} WHERE ${this.q('claim_token')} = ${this.ph(1)}`,\n                  [token],\n                ),\n              ).catch(() => undefined),\n            )\n            .finally(() => {\n              consumer.inflight.delete(token);\n              settled.delete(done);\n              consumer.slotFreed?.();\n            });\n          settled.add(done);\n        }\n        if (rows.length === 0) await this.sleep(this.pollMs);\n      }\n      await Promise.allSettled([...settled]);\n    } finally {\n      clearInterval(renew);\n    }\n  }\n\n  /**\n   * Run `statement`, again on a deadlock: queueing a run (an upsert), taking one (`SKIP LOCKED`)\n   * and deleting a handled one touch the same rows from different instances, and the database then\n   * rolls one of them back rather than wait (InnoDB reports `ER_LOCK_DEADLOCK`, Postgres `40P01`).\n   */\n  private async retryOnDeadlock<T>(statement: () => Promise<T>): Promise<T> {\n    for (let attempt = 1; ; attempt += 1) {\n      try {\n        return await statement();\n      } catch (err) {\n        if (attempt >= DEADLOCK_RETRIES || !isDeadlock(err)) throw err;\n        await this.sleep(10 * attempt + Math.floor(Math.random() * 10));\n      }\n    }\n  }\n\n  private async claimRuns(ns: string, limit: number): Promise<ClaimedRun[]> {\n    const t = this.q(this.runsTable);\n    const staleBefore = this.now() - this.leaseMs;\n    return this.exec.transaction(async (tx) => {\n      const rows = await tx.query<RunRow>(\n        `SELECT ${this.q('run_id')}, ${this.q('wake')} FROM ${t}\n         WHERE ${this.q('ns')} = ${this.ph(1)}\n           AND (${this.q('claimed_at')} IS NULL OR ${this.q('claimed_at')} < ${this.ph(2)})\n         ORDER BY ${this.q('priority')} DESC, ${this.q('created_at')} ASC\n         LIMIT ${Math.floor(limit)} FOR UPDATE SKIP LOCKED`,\n        [ns, staleBefore],\n      );\n      const claimed = rows.map((r) => ({\n        run: {\n          runId: r.run_id,\n          reason: Number(r.wake) === 1 ? ('wake' as const) : ('start' as const),\n        },\n        token: globalThis.crypto.randomUUID(),\n      }));\n      const now = this.now();\n      for (const {\n        run: { runId },\n        token,\n      } of claimed) {\n        await tx.query(\n          `UPDATE ${t} SET ${this.q('claimed_by')} = ${this.ph(1)}, ${this.q('claim_token')} = ${this.ph(2)}, ${this.q('claimed_at')} = ${this.ph(3)}\n           WHERE ${this.q('run_id')} = ${this.ph(4)}`,\n          [this.instanceId, token, now, runId],\n        );\n      }\n      return claimed;\n    });\n  }\n\n  /** Keep the rows of the runs in flight leased, so a long turn is not re-taken by another instance. */\n  private async renewRunLeases(consumer: RunConsumer): Promise<void> {\n    const tokens = [...consumer.inflight];\n    if (tokens.length === 0) return;\n    await this.exec.query(\n      `UPDATE ${this.q(this.runsTable)} SET ${this.q('claimed_at')} = ${this.ph(1)}\n       WHERE ${this.q('claim_token')} IN (${tokens.map((_, i) => this.ph(i + 2)).join(', ')})`,\n      [this.now(), ...tokens],\n    );\n  }\n\n  // ── polling ──────────────────────────────────────────────────────────────────────────────────\n  /** Run `tick` repeatedly; sleep `pollMs` when it reports an empty queue. Stops on `close()`. */\n  private async loop(tick: () => Promise<number>): Promise<void> {\n    while (this.running) {\n      let processed = 0;\n      try {\n        await this.ensureSchema();\n        processed = await tick();\n      } catch (err) {\n        if (this.running) this.onError(err);\n      }\n      if (processed === 0 && this.running) await this.sleep(this.pollMs);\n    }\n  }\n\n  /**\n   * One task-loop round: claim as many rows as there are free slots (never more — a claimed row that\n   * isn't running is one an idle sibling can't run), and start each. With every slot busy, wait for\n   * one to free instead of polling.\n   */\n  private async drainTasks(group: string): Promise<number> {\n    const free = this.concurrency - this.runningTasks.size;\n    if (free <= 0) {\n      await Promise.race(this.runningTasks);\n      return 1;\n    }\n    const { rows, token } = await this.claim<TaskRow>(\n      this.tasksTable,\n      Math.min(free, this.batchSize),\n      `${this.q('grp')} = ${this.ph(1)}`,\n      [group],\n    );\n    if (rows.length === 0) return 0;\n    this.hold(this.tasksTable, token);\n    let left = rows.length;\n    for (const row of rows) {\n      const run = this.runTask(row, group, token).finally(() => {\n        this.runningTasks.delete(run);\n        left -= 1;\n        if (left === 0) this.release(this.tasksTable, token);\n      });\n      this.runningTasks.add(run);\n    }\n    return rows.length;\n  }\n\n  /**\n   * Run one claimed task and settle it — only while this instance still holds the claim: the claim is\n   * re-checked before running, and the task row is deleted and its result written in ONE transaction,\n   * conditional on the claim token, so an instance whose claim was taken over neither deletes the new\n   * holder's row nor publishes a second result.\n   */\n  private async runTask(row: TaskRow, group: string, token: string): Promise<void> {\n    try {\n      if (!(await this.stillHolds(row.step_id, token))) {\n        this.onError(\n          new Error(\n            `[DbTransport] lost the claim on task ${row.step_id} before running it — another instance took it over; not running it here`,\n          ),\n        );\n        return;\n      }\n      const task: RemoteTask = {\n        runId: row.run_id,\n        seq: Number(row.seq),\n        stepId: row.step_id,\n        name: row.name,\n        group,\n        input: row.input == null ? undefined : JSON.parse(row.input),\n        attempt: Number(row.attempt),\n      };\n      const result = await runStepHandler(task, this.handlers.get(task.name));\n      if (!(await this.settleTask(task.stepId, token, result))) {\n        this.onError(\n          new Error(\n            `[DbTransport] lost the claim on task ${task.stepId} while running it (this instance went silent past leaseMs) — another instance took it over and may run it too; this run's result was dropped. Raise leaseMs if steps block the event loop`,\n          ),\n        );\n      }\n    } catch (err) {\n      // A database error settling the row (or a malformed row): it stays claimed, stops being\n      // renewed, and is reclaimed after the lease — at-least-once, like a crash.\n      this.onError(err);\n    }\n  }\n\n  /** Whether the claim on `stepId` is still `token`'s (re-stamping it if so). */\n  private async stillHolds(stepId: string, token: string): Promise<boolean> {\n    const t = this.q(this.tasksTable);\n    const rows = await this.exec.transaction(async (tx) => {\n      const held = await tx.query<{ step_id: string }>(\n        `SELECT ${this.q('step_id')} FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)} FOR UPDATE`,\n        [stepId, token],\n      );\n      if (held.length > 0) {\n        await tx.query(\n          `UPDATE ${t} SET ${this.q('claimed_at')} = ${this.ph(1)} WHERE ${this.q('step_id')} = ${this.ph(2)} AND ${this.q('claimed_by')} = ${this.ph(3)}`,\n          [this.now(), stepId, token],\n        );\n      }\n      return held;\n    });\n    return rows.length > 0;\n  }\n\n  /** Delete the task row and publish its result in ONE transaction, only while `token` holds it. */\n  private async settleTask(stepId: string, token: string, result: StepResult): Promise<boolean> {\n    const t = this.q(this.tasksTable);\n    return this.exec.transaction(async (tx) => {\n      const held = await tx.query<{ step_id: string }>(\n        `SELECT ${this.q('step_id')} FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)} FOR UPDATE`,\n        [stepId, token],\n      );\n      if (held.length === 0) return false;\n      await tx.query(\n        `DELETE FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)}`,\n        [stepId, token],\n      );\n      await this.insertResult(result, tx);\n      return true;\n    });\n  }\n\n  /**\n   * Claim a batch of results, deliver each to the engine, and delete it — only after its handler ran\n   * (at-least-once), and only while this round still holds the claim (a newer result for the same\n   * step that replaced the row resets the claim, so it is delivered next instead of deleted). The\n   * batch's claim is renewed until it is done. A throwing handler is reported and its row left for\n   * re-delivery after the lease; the rest of the batch continues.\n   */\n  private async drainResults(handler: (result: StepResult) => Promise<void>): Promise<number> {\n    const { rows, token } = await this.claim<ResultRow>(\n      this.resultsTable,\n      this.batchSize,\n      '1 = 1',\n      [],\n    );\n    if (rows.length === 0) return 0;\n    this.hold(this.resultsTable, token);\n    try {\n      for (const row of rows) {\n        if (!this.running) break;\n        try {\n          const result: StepResult = {\n            runId: row.run_id,\n            seq: Number(row.seq),\n            stepId: row.step_id,\n            status: row.status as StepResult['status'],\n            output: row.output == null ? undefined : JSON.parse(row.output),\n            error: row.error == null ? undefined : JSON.parse(row.error),\n            startedAt: row.started_at == null ? undefined : Number(row.started_at),\n          };\n          await handler(result);\n          await this.exec.query(\n            `DELETE FROM ${this.q(this.resultsTable)} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)}`,\n            [row.step_id, token],\n          );\n        } catch (err) {\n          this.onError(err);\n        }\n      }\n    } finally {\n      this.release(this.resultsTable, token);\n    }\n    return rows.length;\n  }\n\n  /**\n   * Atomically claim up to `limit` un-leased rows matching `where` and stamp them with a claim token\n   * unique to this round (`<instanceId>:<uuid>`). `SELECT … FOR UPDATE SKIP LOCKED` inside the txn\n   * means concurrent instances skip each other's locked rows instead of blocking, so no row is\n   * claimed twice; the token is what every later delete/settle is conditional on.\n   */\n  private async claim<T extends { step_id: string }>(\n    table: string,\n    limit: number,\n    where: string,\n    whereParams: unknown[],\n  ): Promise<{ rows: T[]; token: string }> {\n    const t = this.q(table);\n    const staleBefore = this.now() - this.leaseMs;\n    const token = `${this.instanceId}:${randomUUID()}`;\n    const rows = await this.exec.transaction(async (tx) => {\n      const leaseClause = `(${this.q('claimed_at')} IS NULL OR ${this.q('claimed_at')} < ${this.ph(whereParams.length + 1)})`;\n      const found = await tx.query<T>(\n        `SELECT * FROM ${t} WHERE ${where} AND ${leaseClause}\n         ORDER BY ${this.q('created_at')} ASC LIMIT ${Math.max(1, Math.floor(limit))} FOR UPDATE SKIP LOCKED`,\n        [...whereParams, staleBefore],\n      );\n      if (found.length > 0) {\n        const ids = found.map((r) => r.step_id);\n        const placeholders = ids.map((_, i) => this.ph(i + 3)).join(', ');\n        await tx.query(\n          `UPDATE ${t} SET ${this.q('claimed_by')} = ${this.ph(1)}, ${this.q('claimed_at')} = ${this.ph(2)}\n           WHERE ${this.q('step_id')} IN (${placeholders})`,\n          [token, this.now(), ...ids],\n        );\n      }\n      return found;\n    });\n    return { rows, token };\n  }\n\n  // ── claim renewal: every claim held, not only the row being run ─────────────────────────────\n  private hold(table: string, token: string): void {\n    let tokens = this.held.get(table);\n    if (!tokens) {\n      tokens = new Set();\n      this.held.set(table, tokens);\n    }\n    tokens.add(token);\n    if (this.renewTimer) return;\n    const intervalMs = Math.max(10, Math.floor(this.leaseMs / 3));\n    this.renewTimer = setInterval(() => {\n      if (this.renewal) return; // a slow database never stacks renewal rounds\n      const round = this.renewHeld()\n        .catch((err) => this.onError(err))\n        .finally(() => {\n          if (this.renewal === round) this.renewal = undefined;\n        });\n      this.renewal = round;\n    }, intervalMs);\n    this.renewTimer.unref?.();\n  }\n\n  private release(table: string, token: string): void {\n    const tokens = this.held.get(table);\n    tokens?.delete(token);\n    if (tokens?.size === 0) this.held.delete(table);\n    if (this.held.size === 0 && this.renewTimer) {\n      clearInterval(this.renewTimer);\n      this.renewTimer = undefined;\n    }\n  }\n\n  /** Re-stamp `claimed_at` on every row still claimed under a token this instance holds. */\n  private async renewHeld(): Promise<void> {\n    for (const [table, tokens] of this.held) {\n      if (tokens.size === 0) continue;\n      const list = [...tokens];\n      const placeholders = list.map((_, i) => this.ph(i + 2)).join(', ');\n      await this.exec.query(\n        `UPDATE ${this.q(table)} SET ${this.q('claimed_at')} = ${this.ph(1)} WHERE ${this.q('claimed_by')} IN (${placeholders})`,\n        [this.now(), ...list],\n      );\n    }\n  }\n\n  /**\n   * Write a result row. A result already waiting for the same step (an earlier attempt's, not yet\n   * deleted by the engine) is REPLACED and its claim reset, never kept: `step_id` is stable across\n   * attempts, so keeping the old row would silently drop a retry's result.\n   */\n  private async insertResult(result: StepResult, tx: SqlTx = this.exec): Promise<void> {\n    const t = this.q(this.resultsTable);\n    const cols = [\n      'step_id',\n      'run_id',\n      'seq',\n      'status',\n      'output',\n      'error',\n      'started_at',\n      'created_at',\n    ];\n    const replace = ['run_id', 'seq', 'status', 'output', 'error', 'started_at', 'created_at'];\n    const values = `(${cols.map((c) => this.q(c)).join(', ')}) VALUES (${cols.map((_, i) => this.ph(i + 1)).join(', ')})`;\n    const sql = this.isPg\n      ? `INSERT INTO ${t} ${values} ON CONFLICT (${this.q('step_id')}) DO UPDATE SET ${[\n          ...replace.map((c) => `${this.q(c)} = EXCLUDED.${this.q(c)}`),\n          `${this.q('claimed_by')} = NULL`,\n          `${this.q('claimed_at')} = NULL`,\n        ].join(', ')}`\n      : `INSERT INTO ${t} ${values} ON DUPLICATE KEY UPDATE ${[\n          ...replace.map((c) => `${this.q(c)} = VALUES(${this.q(c)})`),\n          `${this.q('claimed_by')} = NULL`,\n          `${this.q('claimed_at')} = NULL`,\n        ].join(', ')}`;\n    await tx.query(sql, [\n      result.stepId,\n      result.runId,\n      result.seq,\n      result.status,\n      result.output === undefined ? null : JSON.stringify(result.output),\n      result.error === undefined ? null : JSON.stringify(result.error),\n      result.startedAt ?? null,\n      this.now(),\n    ]);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((r) => setTimeout(r, ms));\n  }\n\n  /** Stop the pollers and wait for the current ticks to settle. Does not close the shared DataSource. */\n  async close(): Promise<void> {\n    this.running = false;\n    await Promise.allSettled([\n      this.taskLoop,\n      this.resultLoop,\n      ...[...this.runConsumers].map((c) => this.stopRunConsumer(c)),\n    ]);\n    // Let running tasks settle (their claims keep being renewed until they do).\n    await Promise.allSettled([...this.runningTasks]);\n    if (this.renewTimer) clearInterval(this.renewTimer);\n    this.renewTimer = undefined;\n    await this.renewal;\n  }\n}\n","/**\n * The tiny SQL surface `DbTransport` needs, so it rides **whatever ORM/connection the app already\n * has** instead of forcing a specific one. Implement it for your ORM (adapters for TypeORM and\n * MikroORM ship below) and hand it to `new DbTransport({ executor })`. Mirrors how the durable\n * *store* is ORM-pluggable (store-typeorm / store-mikro-orm / …).\n */\nexport interface SqlExecutor {\n  /** Drives placeholder style (`$n` vs `?`) and a couple of DDL type choices. */\n  readonly dialect: 'mysql' | 'postgres';\n  /** Quote/escape an identifier (table/column name) for this dialect. */\n  escapeId(id: string): string;\n  /** Run a statement outside a transaction. */\n  query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\n  /** Run `fn` inside a transaction — the claim uses `FOR UPDATE SKIP LOCKED` within it. */\n  transaction<T>(fn: (tx: SqlTx) => Promise<T>): Promise<T>;\n}\n\nexport interface SqlTx {\n  query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\n}\n\n// ── TypeORM ──────────────────────────────────────────────────────────────────────────────────────\n\n/** Structural slice of a TypeORM `DataSource` — avoids a hard dependency on typeorm. */\ninterface TypeOrmDataSourceLike {\n  options: { type: string };\n  driver: { escape(id: string): string };\n  query(sql: string, params?: unknown[]): Promise<unknown>;\n  createQueryRunner(): {\n    connect(): Promise<void>;\n    startTransaction(): Promise<void>;\n    commitTransaction(): Promise<void>;\n    rollbackTransaction(): Promise<void>;\n    release(): Promise<void>;\n    query(sql: string, params?: unknown[]): Promise<unknown>;\n  };\n}\n\n/** Build an executor from a TypeORM `DataSource` (e.g. the one the durable store already uses). */\nexport function typeOrmExecutor(ds: TypeOrmDataSourceLike): SqlExecutor {\n  return {\n    dialect: /postgres/.test(String(ds.options.type)) ? 'postgres' : 'mysql',\n    escapeId: (id) => ds.driver.escape(id),\n    query: <T>(sql: string, params?: unknown[]) => ds.query(sql, params) as Promise<T[]>,\n    transaction: async <T>(fn: (tx: SqlTx) => Promise<T>) => {\n      const qr = ds.createQueryRunner();\n      await qr.connect();\n      await qr.startTransaction();\n      try {\n        const result = await fn({\n          query: <U>(sql: string, params?: unknown[]) => qr.query(sql, params) as Promise<U[]>,\n        });\n        await qr.commitTransaction();\n        return result;\n      } catch (err) {\n        await qr.rollbackTransaction();\n        throw err;\n      } finally {\n        await qr.release();\n      }\n    },\n  };\n}\n\n// ── MikroORM ─────────────────────────────────────────────────────────────────────────────────────\n\n/** Structural slice of a MikroORM `EntityManager` — avoids a hard dependency on @mikro-orm/core. */\ninterface MikroOrmEmLike {\n  getPlatform(): { constructor: { name: string }; quoteIdentifier(id: string): string };\n  getConnection(): {\n    execute(sql: string, params?: unknown[], method?: 'all', ctx?: unknown): Promise<unknown>;\n  };\n  getTransactionContext?(): unknown;\n  transactional<T>(cb: (em: MikroOrmEmLike) => Promise<T>): Promise<T>;\n}\n\n/**\n * Build an executor from a MikroORM `EntityManager` — i.e. **the app's own configured ORM**. Runs\n * raw SQL through `em.getConnection().execute(...)` and wraps the claim in `em.transactional(...)`,\n * threading the transaction context so `FOR UPDATE SKIP LOCKED` locks within the tx.\n */\nexport function mikroOrmExecutor(em: MikroOrmEmLike): SqlExecutor {\n  const platform = em.getPlatform();\n  return {\n    dialect: /postgre/i.test(platform.constructor.name) ? 'postgres' : 'mysql',\n    escapeId: (id) => platform.quoteIdentifier(id),\n    query: <T>(sql: string, params?: unknown[]) =>\n      em.getConnection().execute(sql, params ?? [], 'all') as Promise<T[]>,\n    transaction: <T>(fn: (tx: SqlTx) => Promise<T>) =>\n      em.transactional((txEm) =>\n        fn({\n          query: <U>(sql: string, params?: unknown[]) =>\n            txEm\n              .getConnection()\n              .execute(sql, params ?? [], 'all', txEm.getTransactionContext?.()) as Promise<U[]>,\n        }),\n      ),\n  };\n}\n"],"mappings":"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","names":["typeOrmExecutor","ds","dialect","test","String","options","type","escapeId","id","driver","escape","query","sql","params","transaction","fn","qr","createQueryRunner","connect","startTransaction","result","commitTransaction","err","rollbackTransaction","release","mikroOrmExecutor","em","platform","getPlatform","name","quoteIdentifier","getConnection","execute","transactional","txEm","getTransactionContext","RUNS_INSERT_CHUNK","DEADLOCK_RETRIES","isDeadlock","err","codes","code","errno","driverError","some","c","RUNS_CLAIM_MAX","numberOption","value","fallback","min","undefined","Number","isFinite","DbTransport","exec","group","tasksTable","resultsTable","runsTable","runConsumers","Set","pollMs","leaseMs","batchSize","concurrency","onError","autoCreate","instanceId","isPg","handlers","Map","running","schemaReady","taskLoop","resultLoop","runningTasks","held","renewTimer","renewal","options","executor","prefix","Math","floor","console","error","randomUUID","dialect","ph","i","q","id","escapeId","now","Date","ensureSchema","createTables","catch","createIfMissing","sql","query","str","txt","tasks","results","dispatch","task","t","ignore","cols","replace","map","join","_","stepId","runId","seq","name","JSON","stringify","input","attempt","handle","fn","Error","set","loop","drainTasks","onResult","handler","drainResults","onHeartbeat","_handler","dispatchRuns","runs","opts","length","byRun","run","has","reason","unique","values","sort","a","b","at","chunk","slice","r","__","insert","release","wake","retryOnDeadlock","flatMap","namespace","priority","onDispatchedRun","consumer","stopped","inflight","slotFreed","Promise","resolve","max","ns","consumeRuns","add","stopRunConsumer","delete","renew","setInterval","renewRunLeases","unref","settled","free","size","rows","claimRuns","token","done","then","finally","sleep","allSettled","clearInterval","statement","random","limit","staleBefore","transaction","tx","claimed","run_id","globalThis","crypto","tokens","tick","processed","race","claim","hold","left","row","runTask","stillHolds","step_id","parse","result","runStepHandler","get","settleTask","insertResult","status","output","startedAt","started_at","table","where","whereParams","leaseClause","found","ids","placeholders","intervalMs","round","renewHeld","list","ms","setTimeout","close"]}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Transport, RemoteTask, StepHandler, StepResult, Heartbeat } from '@dudousxd/nestjs-durable-core';
+import { Transport, RemoteTask, StepHandler, StepResult, Heartbeat, RunDispatch, RunQueueOptions, RunConsumerOptions } from '@dudousxd/nestjs-durable-core';
 
 /**
  * The tiny SQL surface `DbTransport` needs, so it rides **whatever ORM/connection the app already
@@ -70,7 +70,10 @@ interface DbTransportOptions {
     executor: SqlExecutor;
     /** The worker group this instance serves. Required to register `handle()` consumers. */
     group?: string;
-    /** Table-name prefix. Tables: `${prefix}_transport_tasks` / `${prefix}_transport_results`. Default `durable`. */
+    /**
+     * Table-name prefix. Tables: `${prefix}_transport_tasks` / `${prefix}_transport_results`, and
+     * `${prefix}_transport_runs` for the run queue. Default `durable`.
+     */
     prefix?: string;
     /** Poll interval in ms when a queue is empty. Default 500. */
     pollMs?: number;
@@ -95,7 +98,7 @@ interface DbTransportOptions {
      * re-delivered after the lease), a lost claim. Default `console.error`.
      */
     onError?: (err: unknown) => void;
-    /** Create the two tables on first use if missing. Default true. */
+    /** Create the tables on first use if missing. Default true. */
     autoCreate?: boolean;
     /** Identifies this instance in `claimed_by` (for debugging). Defaults to a random id. */
     instanceId?: string;
@@ -118,6 +121,8 @@ declare class DbTransport implements Transport {
     private readonly group?;
     private readonly tasksTable;
     private readonly resultsTable;
+    private readonly runsTable;
+    private readonly runConsumers;
     private readonly pollMs;
     private readonly leaseMs;
     private readonly batchSize;
@@ -154,6 +159,33 @@ declare class DbTransport implements Transport {
     handle(name: string, fn: StepHandler): void;
     onResult(handler: (result: StepResult) => Promise<void>): void;
     onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void;
+    /**
+     * Queue `pending` runs for whichever engine instance polls the run queue first: one row per run,
+     * keyed by run id, so a run already waiting is not queued twice. A run whose row an instance holds
+     * right now is released for another take, so a dispatch landing while the run's previous entry is
+     * being handled is not lost when that entry is deleted. Up to {@link RUNS_INSERT_CHUNK} rows per
+     * insert.
+     */
+    dispatchRuns(runs: readonly RunDispatch[], opts?: RunQueueOptions): Promise<void>;
+    /**
+     * Poll the run queue, at most `opts.concurrency` runs in flight on this instance. Rows are claimed
+     * with `FOR UPDATE SKIP LOCKED` (instances never take the same run), highest priority then oldest
+     * first; a row is deleted once its handler settles, and its lease is renewed meanwhile, so a row is
+     * re-taken only after the instance holding it went down. The returned stop takes no more rows and
+     * resolves once the runs in flight settled.
+     */
+    onDispatchedRun(handler: (run: RunDispatch) => Promise<void>, opts: RunConsumerOptions): () => Promise<void>;
+    private stopRunConsumer;
+    private consumeRuns;
+    /**
+     * Run `statement`, again on a deadlock: queueing a run (an upsert), taking one (`SKIP LOCKED`)
+     * and deleting a handled one touch the same rows from different instances, and the database then
+     * rolls one of them back rather than wait (InnoDB reports `ER_LOCK_DEADLOCK`, Postgres `40P01`).
+     */
+    private retryOnDeadlock;
+    private claimRuns;
+    /** Keep the rows of the runs in flight leased, so a long turn is not re-taken by another instance. */
+    private renewRunLeases;
     /** Run `tick` repeatedly; sleep `pollMs` when it reports an empty queue. Stops on `close()`. */
     private loop;
     /**

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Transport, RemoteTask, StepHandler, StepResult, Heartbeat } from '@dudousxd/nestjs-durable-core';
+import { Transport, RemoteTask, StepHandler, StepResult, Heartbeat, RunDispatch, RunQueueOptions, RunConsumerOptions } from '@dudousxd/nestjs-durable-core';
 
 /**
  * The tiny SQL surface `DbTransport` needs, so it rides **whatever ORM/connection the app already
@@ -70,7 +70,10 @@ interface DbTransportOptions {
     executor: SqlExecutor;
     /** The worker group this instance serves. Required to register `handle()` consumers. */
     group?: string;
-    /** Table-name prefix. Tables: `${prefix}_transport_tasks` / `${prefix}_transport_results`. Default `durable`. */
+    /**
+     * Table-name prefix. Tables: `${prefix}_transport_tasks` / `${prefix}_transport_results`, and
+     * `${prefix}_transport_runs` for the run queue. Default `durable`.
+     */
     prefix?: string;
     /** Poll interval in ms when a queue is empty. Default 500. */
     pollMs?: number;
@@ -95,7 +98,7 @@ interface DbTransportOptions {
      * re-delivered after the lease), a lost claim. Default `console.error`.
      */
     onError?: (err: unknown) => void;
-    /** Create the two tables on first use if missing. Default true. */
+    /** Create the tables on first use if missing. Default true. */
     autoCreate?: boolean;
     /** Identifies this instance in `claimed_by` (for debugging). Defaults to a random id. */
     instanceId?: string;
@@ -118,6 +121,8 @@ declare class DbTransport implements Transport {
     private readonly group?;
     private readonly tasksTable;
     private readonly resultsTable;
+    private readonly runsTable;
+    private readonly runConsumers;
     private readonly pollMs;
     private readonly leaseMs;
     private readonly batchSize;
@@ -154,6 +159,33 @@ declare class DbTransport implements Transport {
     handle(name: string, fn: StepHandler): void;
     onResult(handler: (result: StepResult) => Promise<void>): void;
     onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void;
+    /**
+     * Queue `pending` runs for whichever engine instance polls the run queue first: one row per run,
+     * keyed by run id, so a run already waiting is not queued twice. A run whose row an instance holds
+     * right now is released for another take, so a dispatch landing while the run's previous entry is
+     * being handled is not lost when that entry is deleted. Up to {@link RUNS_INSERT_CHUNK} rows per
+     * insert.
+     */
+    dispatchRuns(runs: readonly RunDispatch[], opts?: RunQueueOptions): Promise<void>;
+    /**
+     * Poll the run queue, at most `opts.concurrency` runs in flight on this instance. Rows are claimed
+     * with `FOR UPDATE SKIP LOCKED` (instances never take the same run), highest priority then oldest
+     * first; a row is deleted once its handler settles, and its lease is renewed meanwhile, so a row is
+     * re-taken only after the instance holding it went down. The returned stop takes no more rows and
+     * resolves once the runs in flight settled.
+     */
+    onDispatchedRun(handler: (run: RunDispatch) => Promise<void>, opts: RunConsumerOptions): () => Promise<void>;
+    private stopRunConsumer;
+    private consumeRuns;
+    /**
+     * Run `statement`, again on a deadlock: queueing a run (an upsert), taking one (`SKIP LOCKED`)
+     * and deleting a handled one touch the same rows from different instances, and the database then
+     * rolls one of them back rather than wait (InnoDB reports `ER_LOCK_DEADLOCK`, Postgres `40P01`).
+     */
+    private retryOnDeadlock;
+    private claimRuns;
+    /** Keep the rows of the runs in flight leased, so a long turn is not re-taken by another instance. */
+    private renewRunLeases;
     /** Run `tick` repeatedly; sleep `pollMs` when it reports an empty queue. Stops on `close()`. */
     private loop;
     /**

package/dist/index.js

@@ -45,6 +45,19 @@ function mikroOrmExecutor(em) {
 __name(mikroOrmExecutor, "mikroOrmExecutor");
 
 // src/db-transport.ts
+var RUNS_INSERT_CHUNK = 500;
+var DEADLOCK_RETRIES = 5;
+function isDeadlock(err) {
+  const codes = [
+    err.code,
+    err.errno,
+    err.driverError?.code,
+    err.driverError?.errno
+  ];
+  return codes.some((c) => c === "ER_LOCK_DEADLOCK" || c === 1213 || c === "40P01");
+}
+__name(isDeadlock, "isDeadlock");
+var RUNS_CLAIM_MAX = 50;
 function numberOption(value, fallback, min) {
   return value !== void 0 && Number.isFinite(value) && value >= min ? value : fallback;
 }
@@ -57,6 +70,8 @@ var DbTransport = class {
   group;
   tasksTable;
   resultsTable;
+  runsTable;
+  runConsumers = /* @__PURE__ */ new Set();
   pollMs;
   leaseMs;
   batchSize;
@@ -82,6 +97,7 @@ var DbTransport = class {
     const prefix = options.prefix ?? "durable";
     this.tasksTable = `${prefix}_transport_tasks`;
     this.resultsTable = `${prefix}_transport_results`;
+    this.runsTable = `${prefix}_transport_runs`;
     this.pollMs = numberOption(options.pollMs, 500, 0);
     this.leaseMs = numberOption(options.leaseMs, 3e4, 1);
     this.batchSize = Math.floor(numberOption(options.batchSize, 10, 1));
@@ -155,6 +171,18 @@ var DbTransport = class {
         ${this.q("claimed_at")} bigint,
         ${this.q("created_at")} bigint NOT NULL
       )`);
+    await this.createIfMissing(`CREATE TABLE IF NOT EXISTS ${this.q(this.runsTable)} (
+        ${this.q("run_id")} ${str} PRIMARY KEY,
+        ${this.q("ns")} ${str} NOT NULL,
+        ${this.q("priority")} integer NOT NULL,
+        ${this.q("wake")} integer NOT NULL,
+        ${this.q("claimed_by")} ${str},
+        ${this.q("claim_token")} ${str},
+        ${this.q("claimed_at")} bigint,
+        ${this.q("created_at")} bigint NOT NULL
+      )`);
+    await this.exec.query(`CREATE INDEX ${this.q(`${this.runsTable}_ns_idx`)} ON ${this.q(this.runsTable)} (${this.q("ns")}, ${this.q("priority")}, ${this.q("created_at")})`).catch(() => {
+    });
     await this.exec.query(`CREATE INDEX ${this.q(`${this.tasksTable}_grp_idx`)} ON ${tasks} (${this.q("grp")}, ${this.q("status")}, ${this.q("created_at")})`).catch(() => {
     });
   }
@@ -198,6 +226,181 @@ var DbTransport = class {
   }
   onHeartbeat(_handler) {
   }
+  // ── run queue (engine ↔ engine) ─────────────────────────────────────────────────────────────
+  /**
+  * Queue `pending` runs for whichever engine instance polls the run queue first: one row per run,
+  * keyed by run id, so a run already waiting is not queued twice. A run whose row an instance holds
+  * right now is released for another take, so a dispatch landing while the run's previous entry is
+  * being handled is not lost when that entry is deleted. Up to {@link RUNS_INSERT_CHUNK} rows per
+  * insert.
+  */
+  async dispatchRuns(runs, opts) {
+    if (runs.length === 0) return;
+    await this.ensureSchema();
+    const byRun = /* @__PURE__ */ new Map();
+    for (const run of runs) {
+      if (!byRun.has(run.runId) || run.reason === "wake") byRun.set(run.runId, run);
+    }
+    const unique = [
+      ...byRun.values()
+    ].sort((a, b) => a.runId < b.runId ? -1 : a.runId > b.runId ? 1 : 0);
+    const t = this.q(this.runsTable);
+    const cols = [
+      "run_id",
+      "ns",
+      "priority",
+      "wake",
+      "created_at"
+    ];
+    const now = this.now();
+    for (let at = 0; at < unique.length; at += RUNS_INSERT_CHUNK) {
+      const chunk = unique.slice(at, at + RUNS_INSERT_CHUNK);
+      const values = chunk.map((_, r) => `(${cols.map((__, c) => this.ph(r * cols.length + c + 1)).join(", ")})`).join(", ");
+      const insert = `INTO ${t} (${cols.map((c) => this.q(c)).join(", ")}) VALUES ${values}`;
+      const release = [
+        "claimed_by",
+        "claim_token",
+        "claimed_at"
+      ].map((c) => `${this.q(c)} = NULL`).join(", ");
+      const wake = this.q("wake");
+      const sql = this.isPg ? `INSERT ${insert} ON CONFLICT (${this.q("run_id")}) DO UPDATE SET ${release}, ${wake} = GREATEST(${t}.${wake}, EXCLUDED.${wake})` : `INSERT ${insert} ON DUPLICATE KEY UPDATE ${release}, ${wake} = GREATEST(${wake}, VALUES(${wake}))`;
+      await this.retryOnDeadlock(() => this.exec.query(sql, chunk.flatMap((run, r) => [
+        run.runId,
+        opts?.namespace ?? "",
+        run.priority ?? 0,
+        run.reason === "wake" ? 1 : 0,
+        now + r
+      ])));
+    }
+  }
+  /**
+  * Poll the run queue, at most `opts.concurrency` runs in flight on this instance. Rows are claimed
+  * with `FOR UPDATE SKIP LOCKED` (instances never take the same run), highest priority then oldest
+  * first; a row is deleted once its handler settles, and its lease is renewed meanwhile, so a row is
+  * re-taken only after the instance holding it went down. The returned stop takes no more rows and
+  * resolves once the runs in flight settled.
+  */
+  onDispatchedRun(handler, opts) {
+    const consumer = {
+      stopped: false,
+      inflight: /* @__PURE__ */ new Set(),
+      slotFreed: void 0,
+      loop: Promise.resolve()
+    };
+    const concurrency = Math.max(1, Math.floor(opts.concurrency));
+    const ns = opts.namespace ?? "";
+    consumer.loop = this.consumeRuns(consumer, handler, concurrency, ns).catch((err) => {
+      this.onError(err);
+    });
+    this.runConsumers.add(consumer);
+    return () => this.stopRunConsumer(consumer);
+  }
+  async stopRunConsumer(consumer) {
+    consumer.stopped = true;
+    consumer.slotFreed?.();
+    await consumer.loop;
+    this.runConsumers.delete(consumer);
+  }
+  async consumeRuns(consumer, handler, concurrency, ns) {
+    const renew = setInterval(() => void this.renewRunLeases(consumer).catch(() => void 0), Math.max(1e3, Math.floor(this.leaseMs / 3)));
+    renew.unref?.();
+    const settled = /* @__PURE__ */ new Set();
+    try {
+      while (this.running && !consumer.stopped) {
+        const free = concurrency - consumer.inflight.size;
+        if (free <= 0) {
+          await new Promise((resolve) => {
+            consumer.slotFreed = resolve;
+          });
+          consumer.slotFreed = void 0;
+          continue;
+        }
+        let rows = [];
+        try {
+          await this.ensureSchema();
+          rows = await this.retryOnDeadlock(() => this.claimRuns(ns, Math.min(free, RUNS_CLAIM_MAX)));
+        } catch (err) {
+          if (this.running && !consumer.stopped) this.onError(err);
+        }
+        for (const { run, token } of rows) {
+          consumer.inflight.add(token);
+          const done = handler(run).catch(() => void 0).then(() => this.retryOnDeadlock(() => this.exec.query(`DELETE FROM ${this.q(this.runsTable)} WHERE ${this.q("claim_token")} = ${this.ph(1)}`, [
+            token
+          ])).catch(() => void 0)).finally(() => {
+            consumer.inflight.delete(token);
+            settled.delete(done);
+            consumer.slotFreed?.();
+          });
+          settled.add(done);
+        }
+        if (rows.length === 0) await this.sleep(this.pollMs);
+      }
+      await Promise.allSettled([
+        ...settled
+      ]);
+    } finally {
+      clearInterval(renew);
+    }
+  }
+  /**
+  * Run `statement`, again on a deadlock: queueing a run (an upsert), taking one (`SKIP LOCKED`)
+  * and deleting a handled one touch the same rows from different instances, and the database then
+  * rolls one of them back rather than wait (InnoDB reports `ER_LOCK_DEADLOCK`, Postgres `40P01`).
+  */
+  async retryOnDeadlock(statement) {
+    for (let attempt = 1; ; attempt += 1) {
+      try {
+        return await statement();
+      } catch (err) {
+        if (attempt >= DEADLOCK_RETRIES || !isDeadlock(err)) throw err;
+        await this.sleep(10 * attempt + Math.floor(Math.random() * 10));
+      }
+    }
+  }
+  async claimRuns(ns, limit) {
+    const t = this.q(this.runsTable);
+    const staleBefore = this.now() - this.leaseMs;
+    return this.exec.transaction(async (tx) => {
+      const rows = await tx.query(`SELECT ${this.q("run_id")}, ${this.q("wake")} FROM ${t}
+         WHERE ${this.q("ns")} = ${this.ph(1)}
+           AND (${this.q("claimed_at")} IS NULL OR ${this.q("claimed_at")} < ${this.ph(2)})
+         ORDER BY ${this.q("priority")} DESC, ${this.q("created_at")} ASC
+         LIMIT ${Math.floor(limit)} FOR UPDATE SKIP LOCKED`, [
+        ns,
+        staleBefore
+      ]);
+      const claimed = rows.map((r) => ({
+        run: {
+          runId: r.run_id,
+          reason: Number(r.wake) === 1 ? "wake" : "start"
+        },
+        token: globalThis.crypto.randomUUID()
+      }));
+      const now = this.now();
+      for (const { run: { runId }, token } of claimed) {
+        await tx.query(`UPDATE ${t} SET ${this.q("claimed_by")} = ${this.ph(1)}, ${this.q("claim_token")} = ${this.ph(2)}, ${this.q("claimed_at")} = ${this.ph(3)}
+           WHERE ${this.q("run_id")} = ${this.ph(4)}`, [
+          this.instanceId,
+          token,
+          now,
+          runId
+        ]);
+      }
+      return claimed;
+    });
+  }
+  /** Keep the rows of the runs in flight leased, so a long turn is not re-taken by another instance. */
+  async renewRunLeases(consumer) {
+    const tokens = [
+      ...consumer.inflight
+    ];
+    if (tokens.length === 0) return;
+    await this.exec.query(`UPDATE ${this.q(this.runsTable)} SET ${this.q("claimed_at")} = ${this.ph(1)}
+       WHERE ${this.q("claim_token")} IN (${tokens.map((_, i) => this.ph(i + 2)).join(", ")})`, [
+      this.now(),
+      ...tokens
+    ]);
+  }
   // ── polling ──────────────────────────────────────────────────────────────────────────────────
   /** Run `tick` repeatedly; sleep `pollMs` when it reports an empty queue. Stops on `close()`. */
   async loop(tick) {
@@ -473,7 +676,10 @@ var DbTransport = class {
     this.running = false;
     await Promise.allSettled([
       this.taskLoop,
-      this.resultLoop
+      this.resultLoop,
+      ...[
+        ...this.runConsumers
+      ].map((c) => this.stopRunConsumer(c))
     ]);
     await Promise.allSettled([
       ...this.runningTasks

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/db-transport.ts","../src/executors.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport {\n  type Heartbeat,\n  type RemoteTask,\n  type StepHandler,\n  type StepResult,\n  type Transport,\n  runStepHandler,\n} from '@dudousxd/nestjs-durable-core';\nimport type { SqlExecutor, SqlTx } from './executors';\n\nexport { mikroOrmExecutor, type SqlExecutor, type SqlTx, typeOrmExecutor } from './executors';\n\n/** Raw row shapes returned by `SELECT *` (declared fields, so they're not `| undefined` under noUncheckedIndexedAccess). */\ninterface TaskRow {\n  step_id: string;\n  run_id: string;\n  seq: string | number;\n  name: string;\n  input: string | null;\n  attempt: string | number;\n}\ninterface ResultRow {\n  step_id: string;\n  run_id: string;\n  seq: string | number;\n  status: string;\n  output: string | null;\n  error: string | null;\n  started_at: string | number | null;\n}\n\nexport interface DbTransportOptions {\n  /**\n   * How to run SQL — built from the app's **own** ORM/connection (no broker, no extra connection).\n   * Use `mikroOrmExecutor(em)` to ride the app's MikroORM, `typeOrmExecutor(dataSource)` for TypeORM,\n   * `drizzlePgExecutor(db)` (from `@dudousxd/nestjs-durable-store-drizzle/pg`) for Drizzle on\n   * Postgres, or implement `SqlExecutor` for anything else.\n   */\n  executor: SqlExecutor;\n  /** The worker group this instance serves. Required to register `handle()` consumers. */\n  group?: string;\n  /** Table-name prefix. Tables: `${prefix}_transport_tasks` / `${prefix}_transport_results`. Default `durable`. */\n  prefix?: string;\n  /** Poll interval in ms when a queue is empty. Default 500. */\n  pollMs?: number;\n  /**\n   * How long a claimed row is owned before it's reclaimable (crash recovery), in ms. Default 30_000.\n   * Every claim this instance holds is renewed every `leaseMs / 3` while it is waiting or running, so\n   * a step may run longer than `leaseMs`; only a crashed (or event-loop-blocked) instance loses it.\n   */\n  leaseMs?: number;\n  /**\n   * Max rows claimed per poll. Default 10. The task loop claims only as many rows as it has free\n   * {@link concurrency} slots (capped by this); the results loop claims up to this many.\n   */\n  batchSize?: number;\n  /**\n   * How many tasks this instance runs at once (worker side). Default 1. A row is claimed only when a\n   * slot is free to run it, so rows never wait claimed behind a slow task while a sibling sits idle.\n   */\n  concurrency?: number;\n  /**\n   * Where a transport failure is reported: a failing poll, a throwing result handler (the result is\n   * re-delivered after the lease), a lost claim. Default `console.error`.\n   */\n  onError?: (err: unknown) => void;\n  /** Create the two tables on first use if missing. Default true. */\n  autoCreate?: boolean;\n  /** Identifies this instance in `claimed_by` (for debugging). Defaults to a random id. */\n  instanceId?: string;\n}\n\n/**\n * A numeric option: `fallback` unless `value` is a finite number of at least `min`. `Math.max(1, NaN)`\n * is `NaN`, so a clamp alone would let a `NaN` through (to `LIMIT NaN`, or a `NaN` timer).\n */\nfunction numberOption(value: number | undefined, fallback: number, min: number): number {\n  return value !== undefined && Number.isFinite(value) && value >= min ? value : fallback;\n}\n\n/**\n * A SQL-backed `Transport` — DBOS-style. Instead of a broker (Redis/SQS), remote steps are **rows**\n * in the same database the durable store already uses: `dispatch` inserts a task row, a worker\n * claims it with `SELECT … FOR UPDATE SKIP LOCKED` (so instances never double-claim), runs it, and\n * writes a result row the engine polls. Zero new infrastructure — the DB you already have IS the\n * queue.\n *\n * Trade-off vs a real broker: throughput is bounded by polling + row contention. Great for\n * workflow/pipeline scale (modest rate, long steps); not for high-fanout firehoses.\n *\n * Requires `FOR UPDATE SKIP LOCKED` — **MySQL 8+** or **Postgres 9.5+** (not SQLite). Run one\n * instance engine-side (`onResult`, dispatches) and one per worker process (`handle()` for its group).\n */\nexport class DbTransport implements Transport {\n  private readonly exec: SqlExecutor;\n  private readonly group?: string | undefined;\n  private readonly tasksTable: string;\n  private readonly resultsTable: string;\n  private readonly pollMs: number;\n  private readonly leaseMs: number;\n  private readonly batchSize: number;\n  private readonly concurrency: number;\n  private readonly onError: (err: unknown) => void;\n  private readonly autoCreate: boolean;\n  private readonly instanceId: string;\n  private readonly isPg: boolean;\n\n  private readonly handlers = new Map<string, StepHandler>();\n  private running = true;\n  private schemaReady?: Promise<void> | undefined;\n  private taskLoop?: Promise<void>;\n  private resultLoop?: Promise<void>;\n  /** Tasks running on this instance (at most `concurrency`). */\n  private readonly runningTasks = new Set<Promise<void>>();\n  /** Claim tokens this instance holds, by table — every one is renewed on `renewTimer`. */\n  private readonly held = new Map<string, Set<string>>();\n  private renewTimer?: ReturnType<typeof setInterval> | undefined;\n  private renewal?: Promise<void> | undefined;\n\n  constructor(options: DbTransportOptions) {\n    this.exec = options.executor;\n    this.group = options.group;\n    const prefix = options.prefix ?? 'durable';\n    this.tasksTable = `${prefix}_transport_tasks`;\n    this.resultsTable = `${prefix}_transport_results`;\n    this.pollMs = numberOption(options.pollMs, 500, 0);\n    this.leaseMs = numberOption(options.leaseMs, 30_000, 1);\n    this.batchSize = Math.floor(numberOption(options.batchSize, 10, 1));\n    this.concurrency = Math.floor(numberOption(options.concurrency, 1, 1));\n    this.onError = options.onError ?? ((err) => console.error('[DbTransport]', err));\n    this.autoCreate = options.autoCreate ?? true;\n    // Random, not time-based: two instances booted in the same millisecond must not share an id.\n    this.instanceId = options.instanceId ?? `db-${randomUUID()}`;\n    this.isPg = this.exec.dialect === 'postgres';\n  }\n\n  // ── dialect helpers ──────────────────────────────────────────────────────────────────────────\n  /** Positional placeholder for param `i` (1-based): `$i` on Postgres, `?` elsewhere. */\n  private ph(i: number): string {\n    return this.isPg ? `$${i}` : '?';\n  }\n  private q(id: string): string {\n    return this.exec.escapeId(id);\n  }\n  private now(): number {\n    return Math.floor(Date.now());\n  }\n\n  // ── schema ───────────────────────────────────────────────────────────────────────────────────\n  private ensureSchema(): Promise<void> {\n    if (!this.schemaReady) {\n      // A failed attempt is not cached: the next call tries again instead of failing forever.\n      this.schemaReady = this.createTables().catch((err) => {\n        this.schemaReady = undefined;\n        throw err;\n      });\n    }\n    return this.schemaReady;\n  }\n\n  /**\n   * Run one `CREATE … IF NOT EXISTS`. Two instances booting on a fresh database race it, and Postgres\n   * can reject the loser with a unique violation on its catalog even with `IF NOT EXISTS`; the\n   * statement is simply re-run, by which point the table exists and it is a no-op.\n   */\n  private async createIfMissing(sql: string): Promise<void> {\n    try {\n      await this.exec.query(sql);\n    } catch {\n      await this.exec.query(sql);\n    }\n  }\n\n  private async createTables(): Promise<void> {\n    if (!this.autoCreate) return;\n    const str = 'varchar(191)';\n    const txt = this.isPg ? 'text' : 'longtext';\n    const tasks = this.q(this.tasksTable);\n    const results = this.q(this.resultsTable);\n    await this.createIfMissing(\n      `CREATE TABLE IF NOT EXISTS ${tasks} (\n        ${this.q('step_id')} ${str} PRIMARY KEY,\n        ${this.q('run_id')} ${str} NOT NULL,\n        ${this.q('seq')} integer NOT NULL,\n        ${this.q('name')} ${str} NOT NULL,\n        ${this.q('grp')} ${str} NOT NULL,\n        ${this.q('input')} ${txt},\n        ${this.q('attempt')} integer NOT NULL,\n        ${this.q('status')} varchar(32) NOT NULL,\n        ${this.q('claimed_by')} ${str},\n        ${this.q('claimed_at')} bigint,\n        ${this.q('created_at')} bigint NOT NULL\n      )`,\n    );\n    await this.createIfMissing(\n      `CREATE TABLE IF NOT EXISTS ${results} (\n        ${this.q('step_id')} ${str} PRIMARY KEY,\n        ${this.q('run_id')} ${str} NOT NULL,\n        ${this.q('seq')} integer NOT NULL,\n        ${this.q('status')} varchar(32) NOT NULL,\n        ${this.q('output')} ${txt},\n        ${this.q('error')} ${txt},\n        ${this.q('started_at')} bigint,\n        ${this.q('claimed_by')} ${str},\n        ${this.q('claimed_at')} bigint,\n        ${this.q('created_at')} bigint NOT NULL\n      )`,\n    );\n    // Best-effort index for the group poll (MySQL has no CREATE INDEX IF NOT EXISTS < 8.0.13).\n    await this.exec\n      .query(\n        `CREATE INDEX ${this.q(`${this.tasksTable}_grp_idx`)} ON ${tasks} (${this.q('grp')}, ${this.q('status')}, ${this.q('created_at')})`,\n      )\n      .catch(() => {});\n  }\n\n  // ── engine → worker ────────────────────────────────────────────────────────────────────────\n  async dispatch(task: RemoteTask): Promise<void> {\n    await this.ensureSchema();\n    const t = this.q(this.tasksTable);\n    // Idempotent: a redelivered dispatch for the same step_id is ignored (the row already exists).\n    const ignore = this.isPg\n      ? `INSERT INTO ${t} (...) ON CONFLICT (${this.q('step_id')}) DO NOTHING`\n      : `INSERT IGNORE INTO ${t} (...)`;\n    const cols = [\n      'step_id',\n      'run_id',\n      'seq',\n      'name',\n      'grp',\n      'input',\n      'attempt',\n      'status',\n      'created_at',\n    ];\n    const sql = ignore.replace(\n      '(...)',\n      `(${cols.map((c) => this.q(c)).join(', ')}) VALUES (${cols.map((_, i) => this.ph(i + 1)).join(', ')})`,\n    );\n    await this.exec.query(sql, [\n      task.stepId,\n      task.runId,\n      task.seq,\n      task.name,\n      task.group,\n      JSON.stringify(task.input ?? null),\n      task.attempt,\n      'pending',\n      this.now(),\n    ]);\n  }\n\n  // ── worker → engine ────────────────────────────────────────────────────────────────────────\n  handle(name: string, fn: StepHandler): void {\n    if (!this.group) throw new Error('DbTransport needs a `group` to register handlers');\n    this.handlers.set(name, fn);\n    if (!this.taskLoop) this.taskLoop = this.loop(() => this.drainTasks(this.group as string));\n  }\n\n  onResult(handler: (result: StepResult) => Promise<void>): void {\n    if (!this.resultLoop) this.resultLoop = this.loop(() => this.drainResults(handler));\n  }\n\n  onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void {\n    // Not modelled; the lease/reclaim on `claimed_at` is the liveness mechanism.\n  }\n\n  // ── polling ──────────────────────────────────────────────────────────────────────────────────\n  /** Run `tick` repeatedly; sleep `pollMs` when it reports an empty queue. Stops on `close()`. */\n  private async loop(tick: () => Promise<number>): Promise<void> {\n    while (this.running) {\n      let processed = 0;\n      try {\n        await this.ensureSchema();\n        processed = await tick();\n      } catch (err) {\n        if (this.running) this.onError(err);\n      }\n      if (processed === 0 && this.running) await this.sleep(this.pollMs);\n    }\n  }\n\n  /**\n   * One task-loop round: claim as many rows as there are free slots (never more — a claimed row that\n   * isn't running is one an idle sibling can't run), and start each. With every slot busy, wait for\n   * one to free instead of polling.\n   */\n  private async drainTasks(group: string): Promise<number> {\n    const free = this.concurrency - this.runningTasks.size;\n    if (free <= 0) {\n      await Promise.race(this.runningTasks);\n      return 1;\n    }\n    const { rows, token } = await this.claim<TaskRow>(\n      this.tasksTable,\n      Math.min(free, this.batchSize),\n      `${this.q('grp')} = ${this.ph(1)}`,\n      [group],\n    );\n    if (rows.length === 0) return 0;\n    this.hold(this.tasksTable, token);\n    let left = rows.length;\n    for (const row of rows) {\n      const run = this.runTask(row, group, token).finally(() => {\n        this.runningTasks.delete(run);\n        left -= 1;\n        if (left === 0) this.release(this.tasksTable, token);\n      });\n      this.runningTasks.add(run);\n    }\n    return rows.length;\n  }\n\n  /**\n   * Run one claimed task and settle it — only while this instance still holds the claim: the claim is\n   * re-checked before running, and the task row is deleted and its result written in ONE transaction,\n   * conditional on the claim token, so an instance whose claim was taken over neither deletes the new\n   * holder's row nor publishes a second result.\n   */\n  private async runTask(row: TaskRow, group: string, token: string): Promise<void> {\n    try {\n      if (!(await this.stillHolds(row.step_id, token))) {\n        this.onError(\n          new Error(\n            `[DbTransport] lost the claim on task ${row.step_id} before running it — another instance took it over; not running it here`,\n          ),\n        );\n        return;\n      }\n      const task: RemoteTask = {\n        runId: row.run_id,\n        seq: Number(row.seq),\n        stepId: row.step_id,\n        name: row.name,\n        group,\n        input: row.input == null ? undefined : JSON.parse(row.input),\n        attempt: Number(row.attempt),\n      };\n      const result = await runStepHandler(task, this.handlers.get(task.name));\n      if (!(await this.settleTask(task.stepId, token, result))) {\n        this.onError(\n          new Error(\n            `[DbTransport] lost the claim on task ${task.stepId} while running it (this instance went silent past leaseMs) — another instance took it over and may run it too; this run's result was dropped. Raise leaseMs if steps block the event loop`,\n          ),\n        );\n      }\n    } catch (err) {\n      // A database error settling the row (or a malformed row): it stays claimed, stops being\n      // renewed, and is reclaimed after the lease — at-least-once, like a crash.\n      this.onError(err);\n    }\n  }\n\n  /** Whether the claim on `stepId` is still `token`'s (re-stamping it if so). */\n  private async stillHolds(stepId: string, token: string): Promise<boolean> {\n    const t = this.q(this.tasksTable);\n    const rows = await this.exec.transaction(async (tx) => {\n      const held = await tx.query<{ step_id: string }>(\n        `SELECT ${this.q('step_id')} FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)} FOR UPDATE`,\n        [stepId, token],\n      );\n      if (held.length > 0) {\n        await tx.query(\n          `UPDATE ${t} SET ${this.q('claimed_at')} = ${this.ph(1)} WHERE ${this.q('step_id')} = ${this.ph(2)} AND ${this.q('claimed_by')} = ${this.ph(3)}`,\n          [this.now(), stepId, token],\n        );\n      }\n      return held;\n    });\n    return rows.length > 0;\n  }\n\n  /** Delete the task row and publish its result in ONE transaction, only while `token` holds it. */\n  private async settleTask(stepId: string, token: string, result: StepResult): Promise<boolean> {\n    const t = this.q(this.tasksTable);\n    return this.exec.transaction(async (tx) => {\n      const held = await tx.query<{ step_id: string }>(\n        `SELECT ${this.q('step_id')} FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)} FOR UPDATE`,\n        [stepId, token],\n      );\n      if (held.length === 0) return false;\n      await tx.query(\n        `DELETE FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)}`,\n        [stepId, token],\n      );\n      await this.insertResult(result, tx);\n      return true;\n    });\n  }\n\n  /**\n   * Claim a batch of results, deliver each to the engine, and delete it — only after its handler ran\n   * (at-least-once), and only while this round still holds the claim (a newer result for the same\n   * step that replaced the row resets the claim, so it is delivered next instead of deleted). The\n   * batch's claim is renewed until it is done. A throwing handler is reported and its row left for\n   * re-delivery after the lease; the rest of the batch continues.\n   */\n  private async drainResults(handler: (result: StepResult) => Promise<void>): Promise<number> {\n    const { rows, token } = await this.claim<ResultRow>(\n      this.resultsTable,\n      this.batchSize,\n      '1 = 1',\n      [],\n    );\n    if (rows.length === 0) return 0;\n    this.hold(this.resultsTable, token);\n    try {\n      for (const row of rows) {\n        if (!this.running) break;\n        try {\n          const result: StepResult = {\n            runId: row.run_id,\n            seq: Number(row.seq),\n            stepId: row.step_id,\n            status: row.status as StepResult['status'],\n            output: row.output == null ? undefined : JSON.parse(row.output),\n            error: row.error == null ? undefined : JSON.parse(row.error),\n            startedAt: row.started_at == null ? undefined : Number(row.started_at),\n          };\n          await handler(result);\n          await this.exec.query(\n            `DELETE FROM ${this.q(this.resultsTable)} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)}`,\n            [row.step_id, token],\n          );\n        } catch (err) {\n          this.onError(err);\n        }\n      }\n    } finally {\n      this.release(this.resultsTable, token);\n    }\n    return rows.length;\n  }\n\n  /**\n   * Atomically claim up to `limit` un-leased rows matching `where` and stamp them with a claim token\n   * unique to this round (`<instanceId>:<uuid>`). `SELECT … FOR UPDATE SKIP LOCKED` inside the txn\n   * means concurrent instances skip each other's locked rows instead of blocking, so no row is\n   * claimed twice; the token is what every later delete/settle is conditional on.\n   */\n  private async claim<T extends { step_id: string }>(\n    table: string,\n    limit: number,\n    where: string,\n    whereParams: unknown[],\n  ): Promise<{ rows: T[]; token: string }> {\n    const t = this.q(table);\n    const staleBefore = this.now() - this.leaseMs;\n    const token = `${this.instanceId}:${randomUUID()}`;\n    const rows = await this.exec.transaction(async (tx) => {\n      const leaseClause = `(${this.q('claimed_at')} IS NULL OR ${this.q('claimed_at')} < ${this.ph(whereParams.length + 1)})`;\n      const found = await tx.query<T>(\n        `SELECT * FROM ${t} WHERE ${where} AND ${leaseClause}\n         ORDER BY ${this.q('created_at')} ASC LIMIT ${Math.max(1, Math.floor(limit))} FOR UPDATE SKIP LOCKED`,\n        [...whereParams, staleBefore],\n      );\n      if (found.length > 0) {\n        const ids = found.map((r) => r.step_id);\n        const placeholders = ids.map((_, i) => this.ph(i + 3)).join(', ');\n        await tx.query(\n          `UPDATE ${t} SET ${this.q('claimed_by')} = ${this.ph(1)}, ${this.q('claimed_at')} = ${this.ph(2)}\n           WHERE ${this.q('step_id')} IN (${placeholders})`,\n          [token, this.now(), ...ids],\n        );\n      }\n      return found;\n    });\n    return { rows, token };\n  }\n\n  // ── claim renewal: every claim held, not only the row being run ─────────────────────────────\n  private hold(table: string, token: string): void {\n    let tokens = this.held.get(table);\n    if (!tokens) {\n      tokens = new Set();\n      this.held.set(table, tokens);\n    }\n    tokens.add(token);\n    if (this.renewTimer) return;\n    const intervalMs = Math.max(10, Math.floor(this.leaseMs / 3));\n    this.renewTimer = setInterval(() => {\n      if (this.renewal) return; // a slow database never stacks renewal rounds\n      const round = this.renewHeld()\n        .catch((err) => this.onError(err))\n        .finally(() => {\n          if (this.renewal === round) this.renewal = undefined;\n        });\n      this.renewal = round;\n    }, intervalMs);\n    this.renewTimer.unref?.();\n  }\n\n  private release(table: string, token: string): void {\n    const tokens = this.held.get(table);\n    tokens?.delete(token);\n    if (tokens?.size === 0) this.held.delete(table);\n    if (this.held.size === 0 && this.renewTimer) {\n      clearInterval(this.renewTimer);\n      this.renewTimer = undefined;\n    }\n  }\n\n  /** Re-stamp `claimed_at` on every row still claimed under a token this instance holds. */\n  private async renewHeld(): Promise<void> {\n    for (const [table, tokens] of this.held) {\n      if (tokens.size === 0) continue;\n      const list = [...tokens];\n      const placeholders = list.map((_, i) => this.ph(i + 2)).join(', ');\n      await this.exec.query(\n        `UPDATE ${this.q(table)} SET ${this.q('claimed_at')} = ${this.ph(1)} WHERE ${this.q('claimed_by')} IN (${placeholders})`,\n        [this.now(), ...list],\n      );\n    }\n  }\n\n  /**\n   * Write a result row. A result already waiting for the same step (an earlier attempt's, not yet\n   * deleted by the engine) is REPLACED and its claim reset, never kept: `step_id` is stable across\n   * attempts, so keeping the old row would silently drop a retry's result.\n   */\n  private async insertResult(result: StepResult, tx: SqlTx = this.exec): Promise<void> {\n    const t = this.q(this.resultsTable);\n    const cols = [\n      'step_id',\n      'run_id',\n      'seq',\n      'status',\n      'output',\n      'error',\n      'started_at',\n      'created_at',\n    ];\n    const replace = ['run_id', 'seq', 'status', 'output', 'error', 'started_at', 'created_at'];\n    const values = `(${cols.map((c) => this.q(c)).join(', ')}) VALUES (${cols.map((_, i) => this.ph(i + 1)).join(', ')})`;\n    const sql = this.isPg\n      ? `INSERT INTO ${t} ${values} ON CONFLICT (${this.q('step_id')}) DO UPDATE SET ${[\n          ...replace.map((c) => `${this.q(c)} = EXCLUDED.${this.q(c)}`),\n          `${this.q('claimed_by')} = NULL`,\n          `${this.q('claimed_at')} = NULL`,\n        ].join(', ')}`\n      : `INSERT INTO ${t} ${values} ON DUPLICATE KEY UPDATE ${[\n          ...replace.map((c) => `${this.q(c)} = VALUES(${this.q(c)})`),\n          `${this.q('claimed_by')} = NULL`,\n          `${this.q('claimed_at')} = NULL`,\n        ].join(', ')}`;\n    await tx.query(sql, [\n      result.stepId,\n      result.runId,\n      result.seq,\n      result.status,\n      result.output === undefined ? null : JSON.stringify(result.output),\n      result.error === undefined ? null : JSON.stringify(result.error),\n      result.startedAt ?? null,\n      this.now(),\n    ]);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((r) => setTimeout(r, ms));\n  }\n\n  /** Stop the pollers and wait for the current ticks to settle. Does not close the shared DataSource. */\n  async close(): Promise<void> {\n    this.running = false;\n    await Promise.allSettled([this.taskLoop, this.resultLoop]);\n    // Let running tasks settle (their claims keep being renewed until they do).\n    await Promise.allSettled([...this.runningTasks]);\n    if (this.renewTimer) clearInterval(this.renewTimer);\n    this.renewTimer = undefined;\n    await this.renewal;\n  }\n}\n","/**\n * The tiny SQL surface `DbTransport` needs, so it rides **whatever ORM/connection the app already\n * has** instead of forcing a specific one. Implement it for your ORM (adapters for TypeORM and\n * MikroORM ship below) and hand it to `new DbTransport({ executor })`. Mirrors how the durable\n * *store* is ORM-pluggable (store-typeorm / store-mikro-orm / …).\n */\nexport interface SqlExecutor {\n  /** Drives placeholder style (`$n` vs `?`) and a couple of DDL type choices. */\n  readonly dialect: 'mysql' | 'postgres';\n  /** Quote/escape an identifier (table/column name) for this dialect. */\n  escapeId(id: string): string;\n  /** Run a statement outside a transaction. */\n  query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\n  /** Run `fn` inside a transaction — the claim uses `FOR UPDATE SKIP LOCKED` within it. */\n  transaction<T>(fn: (tx: SqlTx) => Promise<T>): Promise<T>;\n}\n\nexport interface SqlTx {\n  query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\n}\n\n// ── TypeORM ──────────────────────────────────────────────────────────────────────────────────────\n\n/** Structural slice of a TypeORM `DataSource` — avoids a hard dependency on typeorm. */\ninterface TypeOrmDataSourceLike {\n  options: { type: string };\n  driver: { escape(id: string): string };\n  query(sql: string, params?: unknown[]): Promise<unknown>;\n  createQueryRunner(): {\n    connect(): Promise<void>;\n    startTransaction(): Promise<void>;\n    commitTransaction(): Promise<void>;\n    rollbackTransaction(): Promise<void>;\n    release(): Promise<void>;\n    query(sql: string, params?: unknown[]): Promise<unknown>;\n  };\n}\n\n/** Build an executor from a TypeORM `DataSource` (e.g. the one the durable store already uses). */\nexport function typeOrmExecutor(ds: TypeOrmDataSourceLike): SqlExecutor {\n  return {\n    dialect: /postgres/.test(String(ds.options.type)) ? 'postgres' : 'mysql',\n    escapeId: (id) => ds.driver.escape(id),\n    query: <T>(sql: string, params?: unknown[]) => ds.query(sql, params) as Promise<T[]>,\n    transaction: async <T>(fn: (tx: SqlTx) => Promise<T>) => {\n      const qr = ds.createQueryRunner();\n      await qr.connect();\n      await qr.startTransaction();\n      try {\n        const result = await fn({\n          query: <U>(sql: string, params?: unknown[]) => qr.query(sql, params) as Promise<U[]>,\n        });\n        await qr.commitTransaction();\n        return result;\n      } catch (err) {\n        await qr.rollbackTransaction();\n        throw err;\n      } finally {\n        await qr.release();\n      }\n    },\n  };\n}\n\n// ── MikroORM ─────────────────────────────────────────────────────────────────────────────────────\n\n/** Structural slice of a MikroORM `EntityManager` — avoids a hard dependency on @mikro-orm/core. */\ninterface MikroOrmEmLike {\n  getPlatform(): { constructor: { name: string }; quoteIdentifier(id: string): string };\n  getConnection(): {\n    execute(sql: string, params?: unknown[], method?: 'all', ctx?: unknown): Promise<unknown>;\n  };\n  getTransactionContext?(): unknown;\n  transactional<T>(cb: (em: MikroOrmEmLike) => Promise<T>): Promise<T>;\n}\n\n/**\n * Build an executor from a MikroORM `EntityManager` — i.e. **the app's own configured ORM**. Runs\n * raw SQL through `em.getConnection().execute(...)` and wraps the claim in `em.transactional(...)`,\n * threading the transaction context so `FOR UPDATE SKIP LOCKED` locks within the tx.\n */\nexport function mikroOrmExecutor(em: MikroOrmEmLike): SqlExecutor {\n  const platform = em.getPlatform();\n  return {\n    dialect: /postgre/i.test(platform.constructor.name) ? 'postgres' : 'mysql',\n    escapeId: (id) => platform.quoteIdentifier(id),\n    query: <T>(sql: string, params?: unknown[]) =>\n      em.getConnection().execute(sql, params ?? [], 'all') as Promise<T[]>,\n    transaction: <T>(fn: (tx: SqlTx) => Promise<T>) =>\n      em.transactional((txEm) =>\n        fn({\n          query: <U>(sql: string, params?: unknown[]) =>\n            txEm\n              .getConnection()\n              .execute(sql, params ?? [], 'all', txEm.getTransactionContext?.()) as Promise<U[]>,\n        }),\n      ),\n  };\n}\n"],"mappings":"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","names":["randomUUID","runStepHandler","typeOrmExecutor","ds","dialect","test","String","options","type","escapeId","id","driver","escape","query","sql","params","transaction","fn","qr","createQueryRunner","connect","startTransaction","result","commitTransaction","err","rollbackTransaction","release","mikroOrmExecutor","em","platform","getPlatform","name","quoteIdentifier","getConnection","execute","transactional","txEm","getTransactionContext","numberOption","value","fallback","min","undefined","Number","isFinite","DbTransport","exec","group","tasksTable","resultsTable","pollMs","leaseMs","batchSize","concurrency","onError","autoCreate","instanceId","isPg","handlers","Map","running","schemaReady","taskLoop","resultLoop","runningTasks","Set","held","renewTimer","renewal","options","executor","prefix","Math","floor","err","console","error","randomUUID","dialect","ph","i","q","id","escapeId","now","Date","ensureSchema","createTables","catch","createIfMissing","sql","query","str","txt","tasks","results","dispatch","task","t","ignore","cols","replace","map","c","join","_","stepId","runId","seq","name","JSON","stringify","input","attempt","handle","fn","Error","set","loop","drainTasks","onResult","handler","drainResults","onHeartbeat","_handler","tick","processed","sleep","free","size","Promise","race","rows","token","claim","length","hold","left","row","run","runTask","finally","delete","release","add","stillHolds","step_id","run_id","parse","result","runStepHandler","get","settleTask","transaction","tx","insertResult","status","output","startedAt","started_at","table","limit","where","whereParams","staleBefore","leaseClause","found","max","ids","r","placeholders","tokens","intervalMs","setInterval","round","renewHeld","unref","clearInterval","list","values","ms","setTimeout","close","allSettled"]}
+{"version":3,"sources":["../src/db-transport.ts","../src/executors.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport {\n  type Heartbeat,\n  type RemoteTask,\n  type RunConsumerOptions,\n  type RunDispatch,\n  type RunQueueOptions,\n  type StepHandler,\n  type StepResult,\n  type Transport,\n  runStepHandler,\n} from '@dudousxd/nestjs-durable-core';\nimport type { SqlExecutor, SqlTx } from './executors';\n\nexport { mikroOrmExecutor, type SqlExecutor, type SqlTx, typeOrmExecutor } from './executors';\n\n/** Raw row shapes returned by `SELECT *` (declared fields, so they're not `| undefined` under noUncheckedIndexedAccess). */\ninterface TaskRow {\n  step_id: string;\n  run_id: string;\n  seq: string | number;\n  name: string;\n  input: string | null;\n  attempt: string | number;\n}\ninterface RunRow {\n  run_id: string;\n  wake: number | string;\n}\n\n/** A claimed run row: its run id and the token of this claim. */\ninterface ClaimedRun {\n  run: RunDispatch;\n  token: string;\n}\n\n/** Most rows one {@link DbTransport.dispatchRuns} insert writes. */\nconst RUNS_INSERT_CHUNK = 500;\n/** Tries for a statement the database rolled back as a deadlock (see `retryOnDeadlock`). */\nconst DEADLOCK_RETRIES = 5;\n\n/** Whether `err` is the database rolling a statement back to break a deadlock. */\nfunction isDeadlock(err: unknown): boolean {\n  const codes = [\n    (err as { code?: unknown }).code,\n    (err as { errno?: unknown }).errno,\n    (err as { driverError?: { code?: unknown; errno?: unknown } }).driverError?.code,\n    (err as { driverError?: { code?: unknown; errno?: unknown } }).driverError?.errno,\n  ];\n  return codes.some((c) => c === 'ER_LOCK_DEADLOCK' || c === 1213 || c === '40P01');\n}\n\n/** Most run rows one consumer poll claims. */\nconst RUNS_CLAIM_MAX = 50;\n\n/** A run-queue consumer started by {@link DbTransport.onDispatchedRun}. */\ninterface RunConsumer {\n  stopped: boolean;\n  /** Claim tokens of the rows whose runs are in flight. */\n  inflight: Set<string>;\n  slotFreed: (() => void) | undefined;\n  loop: Promise<void>;\n}\n\ninterface ResultRow {\n  step_id: string;\n  run_id: string;\n  seq: string | number;\n  status: string;\n  output: string | null;\n  error: string | null;\n  started_at: string | number | null;\n}\n\nexport interface DbTransportOptions {\n  /**\n   * How to run SQL — built from the app's **own** ORM/connection (no broker, no extra connection).\n   * Use `mikroOrmExecutor(em)` to ride the app's MikroORM, `typeOrmExecutor(dataSource)` for TypeORM,\n   * `drizzlePgExecutor(db)` (from `@dudousxd/nestjs-durable-store-drizzle/pg`) for Drizzle on\n   * Postgres, or implement `SqlExecutor` for anything else.\n   */\n  executor: SqlExecutor;\n  /** The worker group this instance serves. Required to register `handle()` consumers. */\n  group?: string;\n  /**\n   * Table-name prefix. Tables: `${prefix}_transport_tasks` / `${prefix}_transport_results`, and\n   * `${prefix}_transport_runs` for the run queue. Default `durable`.\n   */\n  prefix?: string;\n  /** Poll interval in ms when a queue is empty. Default 500. */\n  pollMs?: number;\n  /**\n   * How long a claimed row is owned before it's reclaimable (crash recovery), in ms. Default 30_000.\n   * Every claim this instance holds is renewed every `leaseMs / 3` while it is waiting or running, so\n   * a step may run longer than `leaseMs`; only a crashed (or event-loop-blocked) instance loses it.\n   */\n  leaseMs?: number;\n  /**\n   * Max rows claimed per poll. Default 10. The task loop claims only as many rows as it has free\n   * {@link concurrency} slots (capped by this); the results loop claims up to this many.\n   */\n  batchSize?: number;\n  /**\n   * How many tasks this instance runs at once (worker side). Default 1. A row is claimed only when a\n   * slot is free to run it, so rows never wait claimed behind a slow task while a sibling sits idle.\n   */\n  concurrency?: number;\n  /**\n   * Where a transport failure is reported: a failing poll, a throwing result handler (the result is\n   * re-delivered after the lease), a lost claim. Default `console.error`.\n   */\n  onError?: (err: unknown) => void;\n  /** Create the tables on first use if missing. Default true. */\n  autoCreate?: boolean;\n  /** Identifies this instance in `claimed_by` (for debugging). Defaults to a random id. */\n  instanceId?: string;\n}\n\n/**\n * A numeric option: `fallback` unless `value` is a finite number of at least `min`. `Math.max(1, NaN)`\n * is `NaN`, so a clamp alone would let a `NaN` through (to `LIMIT NaN`, or a `NaN` timer).\n */\nfunction numberOption(value: number | undefined, fallback: number, min: number): number {\n  return value !== undefined && Number.isFinite(value) && value >= min ? value : fallback;\n}\n\n/**\n * A SQL-backed `Transport` — DBOS-style. Instead of a broker (Redis/SQS), remote steps are **rows**\n * in the same database the durable store already uses: `dispatch` inserts a task row, a worker\n * claims it with `SELECT … FOR UPDATE SKIP LOCKED` (so instances never double-claim), runs it, and\n * writes a result row the engine polls. Zero new infrastructure — the DB you already have IS the\n * queue.\n *\n * Trade-off vs a real broker: throughput is bounded by polling + row contention. Great for\n * workflow/pipeline scale (modest rate, long steps); not for high-fanout firehoses.\n *\n * Requires `FOR UPDATE SKIP LOCKED` — **MySQL 8+** or **Postgres 9.5+** (not SQLite). Run one\n * instance engine-side (`onResult`, dispatches) and one per worker process (`handle()` for its group).\n */\nexport class DbTransport implements Transport {\n  private readonly exec: SqlExecutor;\n  private readonly group?: string | undefined;\n  private readonly tasksTable: string;\n  private readonly resultsTable: string;\n  private readonly runsTable: string;\n  private readonly runConsumers = new Set<RunConsumer>();\n  private readonly pollMs: number;\n  private readonly leaseMs: number;\n  private readonly batchSize: number;\n  private readonly concurrency: number;\n  private readonly onError: (err: unknown) => void;\n  private readonly autoCreate: boolean;\n  private readonly instanceId: string;\n  private readonly isPg: boolean;\n\n  private readonly handlers = new Map<string, StepHandler>();\n  private running = true;\n  private schemaReady?: Promise<void> | undefined;\n  private taskLoop?: Promise<void>;\n  private resultLoop?: Promise<void>;\n  /** Tasks running on this instance (at most `concurrency`). */\n  private readonly runningTasks = new Set<Promise<void>>();\n  /** Claim tokens this instance holds, by table — every one is renewed on `renewTimer`. */\n  private readonly held = new Map<string, Set<string>>();\n  private renewTimer?: ReturnType<typeof setInterval> | undefined;\n  private renewal?: Promise<void> | undefined;\n\n  constructor(options: DbTransportOptions) {\n    this.exec = options.executor;\n    this.group = options.group;\n    const prefix = options.prefix ?? 'durable';\n    this.tasksTable = `${prefix}_transport_tasks`;\n    this.resultsTable = `${prefix}_transport_results`;\n    this.runsTable = `${prefix}_transport_runs`;\n    this.pollMs = numberOption(options.pollMs, 500, 0);\n    this.leaseMs = numberOption(options.leaseMs, 30_000, 1);\n    this.batchSize = Math.floor(numberOption(options.batchSize, 10, 1));\n    this.concurrency = Math.floor(numberOption(options.concurrency, 1, 1));\n    this.onError = options.onError ?? ((err) => console.error('[DbTransport]', err));\n    this.autoCreate = options.autoCreate ?? true;\n    // Random, not time-based: two instances booted in the same millisecond must not share an id.\n    this.instanceId = options.instanceId ?? `db-${randomUUID()}`;\n    this.isPg = this.exec.dialect === 'postgres';\n  }\n\n  // ── dialect helpers ──────────────────────────────────────────────────────────────────────────\n  /** Positional placeholder for param `i` (1-based): `$i` on Postgres, `?` elsewhere. */\n  private ph(i: number): string {\n    return this.isPg ? `$${i}` : '?';\n  }\n  private q(id: string): string {\n    return this.exec.escapeId(id);\n  }\n  private now(): number {\n    return Math.floor(Date.now());\n  }\n\n  // ── schema ───────────────────────────────────────────────────────────────────────────────────\n  private ensureSchema(): Promise<void> {\n    if (!this.schemaReady) {\n      // A failed attempt is not cached: the next call tries again instead of failing forever.\n      this.schemaReady = this.createTables().catch((err) => {\n        this.schemaReady = undefined;\n        throw err;\n      });\n    }\n    return this.schemaReady;\n  }\n\n  /**\n   * Run one `CREATE … IF NOT EXISTS`. Two instances booting on a fresh database race it, and Postgres\n   * can reject the loser with a unique violation on its catalog even with `IF NOT EXISTS`; the\n   * statement is simply re-run, by which point the table exists and it is a no-op.\n   */\n  private async createIfMissing(sql: string): Promise<void> {\n    try {\n      await this.exec.query(sql);\n    } catch {\n      await this.exec.query(sql);\n    }\n  }\n\n  private async createTables(): Promise<void> {\n    if (!this.autoCreate) return;\n    const str = 'varchar(191)';\n    const txt = this.isPg ? 'text' : 'longtext';\n    const tasks = this.q(this.tasksTable);\n    const results = this.q(this.resultsTable);\n    await this.createIfMissing(\n      `CREATE TABLE IF NOT EXISTS ${tasks} (\n        ${this.q('step_id')} ${str} PRIMARY KEY,\n        ${this.q('run_id')} ${str} NOT NULL,\n        ${this.q('seq')} integer NOT NULL,\n        ${this.q('name')} ${str} NOT NULL,\n        ${this.q('grp')} ${str} NOT NULL,\n        ${this.q('input')} ${txt},\n        ${this.q('attempt')} integer NOT NULL,\n        ${this.q('status')} varchar(32) NOT NULL,\n        ${this.q('claimed_by')} ${str},\n        ${this.q('claimed_at')} bigint,\n        ${this.q('created_at')} bigint NOT NULL\n      )`,\n    );\n    await this.createIfMissing(\n      `CREATE TABLE IF NOT EXISTS ${results} (\n        ${this.q('step_id')} ${str} PRIMARY KEY,\n        ${this.q('run_id')} ${str} NOT NULL,\n        ${this.q('seq')} integer NOT NULL,\n        ${this.q('status')} varchar(32) NOT NULL,\n        ${this.q('output')} ${txt},\n        ${this.q('error')} ${txt},\n        ${this.q('started_at')} bigint,\n        ${this.q('claimed_by')} ${str},\n        ${this.q('claimed_at')} bigint,\n        ${this.q('created_at')} bigint NOT NULL\n      )`,\n    );\n    await this.createIfMissing(\n      `CREATE TABLE IF NOT EXISTS ${this.q(this.runsTable)} (\n        ${this.q('run_id')} ${str} PRIMARY KEY,\n        ${this.q('ns')} ${str} NOT NULL,\n        ${this.q('priority')} integer NOT NULL,\n        ${this.q('wake')} integer NOT NULL,\n        ${this.q('claimed_by')} ${str},\n        ${this.q('claim_token')} ${str},\n        ${this.q('claimed_at')} bigint,\n        ${this.q('created_at')} bigint NOT NULL\n      )`,\n    );\n    await this.exec\n      .query(\n        `CREATE INDEX ${this.q(`${this.runsTable}_ns_idx`)} ON ${this.q(this.runsTable)} (${this.q('ns')}, ${this.q('priority')}, ${this.q('created_at')})`,\n      )\n      .catch(() => {});\n    // Best-effort index for the group poll (MySQL has no CREATE INDEX IF NOT EXISTS < 8.0.13).\n    await this.exec\n      .query(\n        `CREATE INDEX ${this.q(`${this.tasksTable}_grp_idx`)} ON ${tasks} (${this.q('grp')}, ${this.q('status')}, ${this.q('created_at')})`,\n      )\n      .catch(() => {});\n  }\n\n  // ── engine → worker ────────────────────────────────────────────────────────────────────────\n  async dispatch(task: RemoteTask): Promise<void> {\n    await this.ensureSchema();\n    const t = this.q(this.tasksTable);\n    // Idempotent: a redelivered dispatch for the same step_id is ignored (the row already exists).\n    const ignore = this.isPg\n      ? `INSERT INTO ${t} (...) ON CONFLICT (${this.q('step_id')}) DO NOTHING`\n      : `INSERT IGNORE INTO ${t} (...)`;\n    const cols = [\n      'step_id',\n      'run_id',\n      'seq',\n      'name',\n      'grp',\n      'input',\n      'attempt',\n      'status',\n      'created_at',\n    ];\n    const sql = ignore.replace(\n      '(...)',\n      `(${cols.map((c) => this.q(c)).join(', ')}) VALUES (${cols.map((_, i) => this.ph(i + 1)).join(', ')})`,\n    );\n    await this.exec.query(sql, [\n      task.stepId,\n      task.runId,\n      task.seq,\n      task.name,\n      task.group,\n      JSON.stringify(task.input ?? null),\n      task.attempt,\n      'pending',\n      this.now(),\n    ]);\n  }\n\n  // ── worker → engine ────────────────────────────────────────────────────────────────────────\n  handle(name: string, fn: StepHandler): void {\n    if (!this.group) throw new Error('DbTransport needs a `group` to register handlers');\n    this.handlers.set(name, fn);\n    if (!this.taskLoop) this.taskLoop = this.loop(() => this.drainTasks(this.group as string));\n  }\n\n  onResult(handler: (result: StepResult) => Promise<void>): void {\n    if (!this.resultLoop) this.resultLoop = this.loop(() => this.drainResults(handler));\n  }\n\n  onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void {\n    // Not modelled; the lease/reclaim on `claimed_at` is the liveness mechanism.\n  }\n\n  // ── run queue (engine ↔ engine) ─────────────────────────────────────────────────────────────\n  /**\n   * Queue `pending` runs for whichever engine instance polls the run queue first: one row per run,\n   * keyed by run id, so a run already waiting is not queued twice. A run whose row an instance holds\n   * right now is released for another take, so a dispatch landing while the run's previous entry is\n   * being handled is not lost when that entry is deleted. Up to {@link RUNS_INSERT_CHUNK} rows per\n   * insert.\n   */\n  async dispatchRuns(runs: readonly RunDispatch[], opts?: RunQueueOptions): Promise<void> {\n    if (runs.length === 0) return;\n    await this.ensureSchema();\n    // One row per run (an upsert may not touch the same row twice in one statement); a wake among\n    // a run's dispatches makes its row a wake.\n    const byRun = new Map<string, RunDispatch>();\n    for (const run of runs) {\n      if (!byRun.has(run.runId) || run.reason === 'wake') byRun.set(run.runId, run);\n    }\n    // In run-id order: two dispatches touching overlapping rows lock them in the same order.\n    const unique = [...byRun.values()].sort((a, b) =>\n      a.runId < b.runId ? -1 : a.runId > b.runId ? 1 : 0,\n    );\n    const t = this.q(this.runsTable);\n    const cols = ['run_id', 'ns', 'priority', 'wake', 'created_at'];\n    const now = this.now();\n    for (let at = 0; at < unique.length; at += RUNS_INSERT_CHUNK) {\n      const chunk = unique.slice(at, at + RUNS_INSERT_CHUNK);\n      const values = chunk\n        .map((_, r) => `(${cols.map((__, c) => this.ph(r * cols.length + c + 1)).join(', ')})`)\n        .join(', ');\n      const insert = `INTO ${t} (${cols.map((c) => this.q(c)).join(', ')}) VALUES ${values}`;\n      const release = ['claimed_by', 'claim_token', 'claimed_at']\n        .map((c) => `${this.q(c)} = NULL`)\n        .join(', ');\n      const wake = this.q('wake');\n      const sql = this.isPg\n        ? `INSERT ${insert} ON CONFLICT (${this.q('run_id')}) DO UPDATE SET ${release}, ${wake} = GREATEST(${t}.${wake}, EXCLUDED.${wake})`\n        : `INSERT ${insert} ON DUPLICATE KEY UPDATE ${release}, ${wake} = GREATEST(${wake}, VALUES(${wake}))`;\n      await this.retryOnDeadlock(() =>\n        this.exec.query(\n          sql,\n          chunk.flatMap((run, r) => [\n            run.runId,\n            opts?.namespace ?? '',\n            run.priority ?? 0,\n            run.reason === 'wake' ? 1 : 0,\n            now + r,\n          ]),\n        ),\n      );\n    }\n  }\n\n  /**\n   * Poll the run queue, at most `opts.concurrency` runs in flight on this instance. Rows are claimed\n   * with `FOR UPDATE SKIP LOCKED` (instances never take the same run), highest priority then oldest\n   * first; a row is deleted once its handler settles, and its lease is renewed meanwhile, so a row is\n   * re-taken only after the instance holding it went down. The returned stop takes no more rows and\n   * resolves once the runs in flight settled.\n   */\n  onDispatchedRun(\n    handler: (run: RunDispatch) => Promise<void>,\n    opts: RunConsumerOptions,\n  ): () => Promise<void> {\n    const consumer: RunConsumer = {\n      stopped: false,\n      inflight: new Set(),\n      slotFreed: undefined,\n      loop: Promise.resolve(),\n    };\n    const concurrency = Math.max(1, Math.floor(opts.concurrency));\n    const ns = opts.namespace ?? '';\n    consumer.loop = this.consumeRuns(consumer, handler, concurrency, ns).catch((err) => {\n      this.onError(err);\n    });\n    this.runConsumers.add(consumer);\n    return () => this.stopRunConsumer(consumer);\n  }\n\n  private async stopRunConsumer(consumer: RunConsumer): Promise<void> {\n    consumer.stopped = true;\n    consumer.slotFreed?.();\n    await consumer.loop;\n    this.runConsumers.delete(consumer);\n  }\n\n  private async consumeRuns(\n    consumer: RunConsumer,\n    handler: (run: RunDispatch) => Promise<void>,\n    concurrency: number,\n    ns: string,\n  ): Promise<void> {\n    const renew = setInterval(\n      () => void this.renewRunLeases(consumer).catch(() => undefined),\n      Math.max(1_000, Math.floor(this.leaseMs / 3)),\n    );\n    renew.unref?.();\n    const settled = new Set<Promise<unknown>>();\n    try {\n      while (this.running && !consumer.stopped) {\n        const free = concurrency - consumer.inflight.size;\n        if (free <= 0) {\n          await new Promise<void>((resolve) => {\n            consumer.slotFreed = resolve;\n          });\n          consumer.slotFreed = undefined;\n          continue;\n        }\n        let rows: ClaimedRun[] = [];\n        try {\n          await this.ensureSchema();\n          rows = await this.retryOnDeadlock(() =>\n            this.claimRuns(ns, Math.min(free, RUNS_CLAIM_MAX)),\n          );\n        } catch (err) {\n          if (this.running && !consumer.stopped) this.onError(err);\n        }\n        for (const { run, token } of rows) {\n          consumer.inflight.add(token);\n          const done = handler(run)\n            .catch(() => undefined)\n            .then(() =>\n              this.retryOnDeadlock(() =>\n                this.exec.query(\n                  `DELETE FROM ${this.q(this.runsTable)} WHERE ${this.q('claim_token')} = ${this.ph(1)}`,\n                  [token],\n                ),\n              ).catch(() => undefined),\n            )\n            .finally(() => {\n              consumer.inflight.delete(token);\n              settled.delete(done);\n              consumer.slotFreed?.();\n            });\n          settled.add(done);\n        }\n        if (rows.length === 0) await this.sleep(this.pollMs);\n      }\n      await Promise.allSettled([...settled]);\n    } finally {\n      clearInterval(renew);\n    }\n  }\n\n  /**\n   * Run `statement`, again on a deadlock: queueing a run (an upsert), taking one (`SKIP LOCKED`)\n   * and deleting a handled one touch the same rows from different instances, and the database then\n   * rolls one of them back rather than wait (InnoDB reports `ER_LOCK_DEADLOCK`, Postgres `40P01`).\n   */\n  private async retryOnDeadlock<T>(statement: () => Promise<T>): Promise<T> {\n    for (let attempt = 1; ; attempt += 1) {\n      try {\n        return await statement();\n      } catch (err) {\n        if (attempt >= DEADLOCK_RETRIES || !isDeadlock(err)) throw err;\n        await this.sleep(10 * attempt + Math.floor(Math.random() * 10));\n      }\n    }\n  }\n\n  private async claimRuns(ns: string, limit: number): Promise<ClaimedRun[]> {\n    const t = this.q(this.runsTable);\n    const staleBefore = this.now() - this.leaseMs;\n    return this.exec.transaction(async (tx) => {\n      const rows = await tx.query<RunRow>(\n        `SELECT ${this.q('run_id')}, ${this.q('wake')} FROM ${t}\n         WHERE ${this.q('ns')} = ${this.ph(1)}\n           AND (${this.q('claimed_at')} IS NULL OR ${this.q('claimed_at')} < ${this.ph(2)})\n         ORDER BY ${this.q('priority')} DESC, ${this.q('created_at')} ASC\n         LIMIT ${Math.floor(limit)} FOR UPDATE SKIP LOCKED`,\n        [ns, staleBefore],\n      );\n      const claimed = rows.map((r) => ({\n        run: {\n          runId: r.run_id,\n          reason: Number(r.wake) === 1 ? ('wake' as const) : ('start' as const),\n        },\n        token: globalThis.crypto.randomUUID(),\n      }));\n      const now = this.now();\n      for (const {\n        run: { runId },\n        token,\n      } of claimed) {\n        await tx.query(\n          `UPDATE ${t} SET ${this.q('claimed_by')} = ${this.ph(1)}, ${this.q('claim_token')} = ${this.ph(2)}, ${this.q('claimed_at')} = ${this.ph(3)}\n           WHERE ${this.q('run_id')} = ${this.ph(4)}`,\n          [this.instanceId, token, now, runId],\n        );\n      }\n      return claimed;\n    });\n  }\n\n  /** Keep the rows of the runs in flight leased, so a long turn is not re-taken by another instance. */\n  private async renewRunLeases(consumer: RunConsumer): Promise<void> {\n    const tokens = [...consumer.inflight];\n    if (tokens.length === 0) return;\n    await this.exec.query(\n      `UPDATE ${this.q(this.runsTable)} SET ${this.q('claimed_at')} = ${this.ph(1)}\n       WHERE ${this.q('claim_token')} IN (${tokens.map((_, i) => this.ph(i + 2)).join(', ')})`,\n      [this.now(), ...tokens],\n    );\n  }\n\n  // ── polling ──────────────────────────────────────────────────────────────────────────────────\n  /** Run `tick` repeatedly; sleep `pollMs` when it reports an empty queue. Stops on `close()`. */\n  private async loop(tick: () => Promise<number>): Promise<void> {\n    while (this.running) {\n      let processed = 0;\n      try {\n        await this.ensureSchema();\n        processed = await tick();\n      } catch (err) {\n        if (this.running) this.onError(err);\n      }\n      if (processed === 0 && this.running) await this.sleep(this.pollMs);\n    }\n  }\n\n  /**\n   * One task-loop round: claim as many rows as there are free slots (never more — a claimed row that\n   * isn't running is one an idle sibling can't run), and start each. With every slot busy, wait for\n   * one to free instead of polling.\n   */\n  private async drainTasks(group: string): Promise<number> {\n    const free = this.concurrency - this.runningTasks.size;\n    if (free <= 0) {\n      await Promise.race(this.runningTasks);\n      return 1;\n    }\n    const { rows, token } = await this.claim<TaskRow>(\n      this.tasksTable,\n      Math.min(free, this.batchSize),\n      `${this.q('grp')} = ${this.ph(1)}`,\n      [group],\n    );\n    if (rows.length === 0) return 0;\n    this.hold(this.tasksTable, token);\n    let left = rows.length;\n    for (const row of rows) {\n      const run = this.runTask(row, group, token).finally(() => {\n        this.runningTasks.delete(run);\n        left -= 1;\n        if (left === 0) this.release(this.tasksTable, token);\n      });\n      this.runningTasks.add(run);\n    }\n    return rows.length;\n  }\n\n  /**\n   * Run one claimed task and settle it — only while this instance still holds the claim: the claim is\n   * re-checked before running, and the task row is deleted and its result written in ONE transaction,\n   * conditional on the claim token, so an instance whose claim was taken over neither deletes the new\n   * holder's row nor publishes a second result.\n   */\n  private async runTask(row: TaskRow, group: string, token: string): Promise<void> {\n    try {\n      if (!(await this.stillHolds(row.step_id, token))) {\n        this.onError(\n          new Error(\n            `[DbTransport] lost the claim on task ${row.step_id} before running it — another instance took it over; not running it here`,\n          ),\n        );\n        return;\n      }\n      const task: RemoteTask = {\n        runId: row.run_id,\n        seq: Number(row.seq),\n        stepId: row.step_id,\n        name: row.name,\n        group,\n        input: row.input == null ? undefined : JSON.parse(row.input),\n        attempt: Number(row.attempt),\n      };\n      const result = await runStepHandler(task, this.handlers.get(task.name));\n      if (!(await this.settleTask(task.stepId, token, result))) {\n        this.onError(\n          new Error(\n            `[DbTransport] lost the claim on task ${task.stepId} while running it (this instance went silent past leaseMs) — another instance took it over and may run it too; this run's result was dropped. Raise leaseMs if steps block the event loop`,\n          ),\n        );\n      }\n    } catch (err) {\n      // A database error settling the row (or a malformed row): it stays claimed, stops being\n      // renewed, and is reclaimed after the lease — at-least-once, like a crash.\n      this.onError(err);\n    }\n  }\n\n  /** Whether the claim on `stepId` is still `token`'s (re-stamping it if so). */\n  private async stillHolds(stepId: string, token: string): Promise<boolean> {\n    const t = this.q(this.tasksTable);\n    const rows = await this.exec.transaction(async (tx) => {\n      const held = await tx.query<{ step_id: string }>(\n        `SELECT ${this.q('step_id')} FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)} FOR UPDATE`,\n        [stepId, token],\n      );\n      if (held.length > 0) {\n        await tx.query(\n          `UPDATE ${t} SET ${this.q('claimed_at')} = ${this.ph(1)} WHERE ${this.q('step_id')} = ${this.ph(2)} AND ${this.q('claimed_by')} = ${this.ph(3)}`,\n          [this.now(), stepId, token],\n        );\n      }\n      return held;\n    });\n    return rows.length > 0;\n  }\n\n  /** Delete the task row and publish its result in ONE transaction, only while `token` holds it. */\n  private async settleTask(stepId: string, token: string, result: StepResult): Promise<boolean> {\n    const t = this.q(this.tasksTable);\n    return this.exec.transaction(async (tx) => {\n      const held = await tx.query<{ step_id: string }>(\n        `SELECT ${this.q('step_id')} FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)} FOR UPDATE`,\n        [stepId, token],\n      );\n      if (held.length === 0) return false;\n      await tx.query(\n        `DELETE FROM ${t} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)}`,\n        [stepId, token],\n      );\n      await this.insertResult(result, tx);\n      return true;\n    });\n  }\n\n  /**\n   * Claim a batch of results, deliver each to the engine, and delete it — only after its handler ran\n   * (at-least-once), and only while this round still holds the claim (a newer result for the same\n   * step that replaced the row resets the claim, so it is delivered next instead of deleted). The\n   * batch's claim is renewed until it is done. A throwing handler is reported and its row left for\n   * re-delivery after the lease; the rest of the batch continues.\n   */\n  private async drainResults(handler: (result: StepResult) => Promise<void>): Promise<number> {\n    const { rows, token } = await this.claim<ResultRow>(\n      this.resultsTable,\n      this.batchSize,\n      '1 = 1',\n      [],\n    );\n    if (rows.length === 0) return 0;\n    this.hold(this.resultsTable, token);\n    try {\n      for (const row of rows) {\n        if (!this.running) break;\n        try {\n          const result: StepResult = {\n            runId: row.run_id,\n            seq: Number(row.seq),\n            stepId: row.step_id,\n            status: row.status as StepResult['status'],\n            output: row.output == null ? undefined : JSON.parse(row.output),\n            error: row.error == null ? undefined : JSON.parse(row.error),\n            startedAt: row.started_at == null ? undefined : Number(row.started_at),\n          };\n          await handler(result);\n          await this.exec.query(\n            `DELETE FROM ${this.q(this.resultsTable)} WHERE ${this.q('step_id')} = ${this.ph(1)} AND ${this.q('claimed_by')} = ${this.ph(2)}`,\n            [row.step_id, token],\n          );\n        } catch (err) {\n          this.onError(err);\n        }\n      }\n    } finally {\n      this.release(this.resultsTable, token);\n    }\n    return rows.length;\n  }\n\n  /**\n   * Atomically claim up to `limit` un-leased rows matching `where` and stamp them with a claim token\n   * unique to this round (`<instanceId>:<uuid>`). `SELECT … FOR UPDATE SKIP LOCKED` inside the txn\n   * means concurrent instances skip each other's locked rows instead of blocking, so no row is\n   * claimed twice; the token is what every later delete/settle is conditional on.\n   */\n  private async claim<T extends { step_id: string }>(\n    table: string,\n    limit: number,\n    where: string,\n    whereParams: unknown[],\n  ): Promise<{ rows: T[]; token: string }> {\n    const t = this.q(table);\n    const staleBefore = this.now() - this.leaseMs;\n    const token = `${this.instanceId}:${randomUUID()}`;\n    const rows = await this.exec.transaction(async (tx) => {\n      const leaseClause = `(${this.q('claimed_at')} IS NULL OR ${this.q('claimed_at')} < ${this.ph(whereParams.length + 1)})`;\n      const found = await tx.query<T>(\n        `SELECT * FROM ${t} WHERE ${where} AND ${leaseClause}\n         ORDER BY ${this.q('created_at')} ASC LIMIT ${Math.max(1, Math.floor(limit))} FOR UPDATE SKIP LOCKED`,\n        [...whereParams, staleBefore],\n      );\n      if (found.length > 0) {\n        const ids = found.map((r) => r.step_id);\n        const placeholders = ids.map((_, i) => this.ph(i + 3)).join(', ');\n        await tx.query(\n          `UPDATE ${t} SET ${this.q('claimed_by')} = ${this.ph(1)}, ${this.q('claimed_at')} = ${this.ph(2)}\n           WHERE ${this.q('step_id')} IN (${placeholders})`,\n          [token, this.now(), ...ids],\n        );\n      }\n      return found;\n    });\n    return { rows, token };\n  }\n\n  // ── claim renewal: every claim held, not only the row being run ─────────────────────────────\n  private hold(table: string, token: string): void {\n    let tokens = this.held.get(table);\n    if (!tokens) {\n      tokens = new Set();\n      this.held.set(table, tokens);\n    }\n    tokens.add(token);\n    if (this.renewTimer) return;\n    const intervalMs = Math.max(10, Math.floor(this.leaseMs / 3));\n    this.renewTimer = setInterval(() => {\n      if (this.renewal) return; // a slow database never stacks renewal rounds\n      const round = this.renewHeld()\n        .catch((err) => this.onError(err))\n        .finally(() => {\n          if (this.renewal === round) this.renewal = undefined;\n        });\n      this.renewal = round;\n    }, intervalMs);\n    this.renewTimer.unref?.();\n  }\n\n  private release(table: string, token: string): void {\n    const tokens = this.held.get(table);\n    tokens?.delete(token);\n    if (tokens?.size === 0) this.held.delete(table);\n    if (this.held.size === 0 && this.renewTimer) {\n      clearInterval(this.renewTimer);\n      this.renewTimer = undefined;\n    }\n  }\n\n  /** Re-stamp `claimed_at` on every row still claimed under a token this instance holds. */\n  private async renewHeld(): Promise<void> {\n    for (const [table, tokens] of this.held) {\n      if (tokens.size === 0) continue;\n      const list = [...tokens];\n      const placeholders = list.map((_, i) => this.ph(i + 2)).join(', ');\n      await this.exec.query(\n        `UPDATE ${this.q(table)} SET ${this.q('claimed_at')} = ${this.ph(1)} WHERE ${this.q('claimed_by')} IN (${placeholders})`,\n        [this.now(), ...list],\n      );\n    }\n  }\n\n  /**\n   * Write a result row. A result already waiting for the same step (an earlier attempt's, not yet\n   * deleted by the engine) is REPLACED and its claim reset, never kept: `step_id` is stable across\n   * attempts, so keeping the old row would silently drop a retry's result.\n   */\n  private async insertResult(result: StepResult, tx: SqlTx = this.exec): Promise<void> {\n    const t = this.q(this.resultsTable);\n    const cols = [\n      'step_id',\n      'run_id',\n      'seq',\n      'status',\n      'output',\n      'error',\n      'started_at',\n      'created_at',\n    ];\n    const replace = ['run_id', 'seq', 'status', 'output', 'error', 'started_at', 'created_at'];\n    const values = `(${cols.map((c) => this.q(c)).join(', ')}) VALUES (${cols.map((_, i) => this.ph(i + 1)).join(', ')})`;\n    const sql = this.isPg\n      ? `INSERT INTO ${t} ${values} ON CONFLICT (${this.q('step_id')}) DO UPDATE SET ${[\n          ...replace.map((c) => `${this.q(c)} = EXCLUDED.${this.q(c)}`),\n          `${this.q('claimed_by')} = NULL`,\n          `${this.q('claimed_at')} = NULL`,\n        ].join(', ')}`\n      : `INSERT INTO ${t} ${values} ON DUPLICATE KEY UPDATE ${[\n          ...replace.map((c) => `${this.q(c)} = VALUES(${this.q(c)})`),\n          `${this.q('claimed_by')} = NULL`,\n          `${this.q('claimed_at')} = NULL`,\n        ].join(', ')}`;\n    await tx.query(sql, [\n      result.stepId,\n      result.runId,\n      result.seq,\n      result.status,\n      result.output === undefined ? null : JSON.stringify(result.output),\n      result.error === undefined ? null : JSON.stringify(result.error),\n      result.startedAt ?? null,\n      this.now(),\n    ]);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((r) => setTimeout(r, ms));\n  }\n\n  /** Stop the pollers and wait for the current ticks to settle. Does not close the shared DataSource. */\n  async close(): Promise<void> {\n    this.running = false;\n    await Promise.allSettled([\n      this.taskLoop,\n      this.resultLoop,\n      ...[...this.runConsumers].map((c) => this.stopRunConsumer(c)),\n    ]);\n    // Let running tasks settle (their claims keep being renewed until they do).\n    await Promise.allSettled([...this.runningTasks]);\n    if (this.renewTimer) clearInterval(this.renewTimer);\n    this.renewTimer = undefined;\n    await this.renewal;\n  }\n}\n","/**\n * The tiny SQL surface `DbTransport` needs, so it rides **whatever ORM/connection the app already\n * has** instead of forcing a specific one. Implement it for your ORM (adapters for TypeORM and\n * MikroORM ship below) and hand it to `new DbTransport({ executor })`. Mirrors how the durable\n * *store* is ORM-pluggable (store-typeorm / store-mikro-orm / …).\n */\nexport interface SqlExecutor {\n  /** Drives placeholder style (`$n` vs `?`) and a couple of DDL type choices. */\n  readonly dialect: 'mysql' | 'postgres';\n  /** Quote/escape an identifier (table/column name) for this dialect. */\n  escapeId(id: string): string;\n  /** Run a statement outside a transaction. */\n  query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\n  /** Run `fn` inside a transaction — the claim uses `FOR UPDATE SKIP LOCKED` within it. */\n  transaction<T>(fn: (tx: SqlTx) => Promise<T>): Promise<T>;\n}\n\nexport interface SqlTx {\n  query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\n}\n\n// ── TypeORM ──────────────────────────────────────────────────────────────────────────────────────\n\n/** Structural slice of a TypeORM `DataSource` — avoids a hard dependency on typeorm. */\ninterface TypeOrmDataSourceLike {\n  options: { type: string };\n  driver: { escape(id: string): string };\n  query(sql: string, params?: unknown[]): Promise<unknown>;\n  createQueryRunner(): {\n    connect(): Promise<void>;\n    startTransaction(): Promise<void>;\n    commitTransaction(): Promise<void>;\n    rollbackTransaction(): Promise<void>;\n    release(): Promise<void>;\n    query(sql: string, params?: unknown[]): Promise<unknown>;\n  };\n}\n\n/** Build an executor from a TypeORM `DataSource` (e.g. the one the durable store already uses). */\nexport function typeOrmExecutor(ds: TypeOrmDataSourceLike): SqlExecutor {\n  return {\n    dialect: /postgres/.test(String(ds.options.type)) ? 'postgres' : 'mysql',\n    escapeId: (id) => ds.driver.escape(id),\n    query: <T>(sql: string, params?: unknown[]) => ds.query(sql, params) as Promise<T[]>,\n    transaction: async <T>(fn: (tx: SqlTx) => Promise<T>) => {\n      const qr = ds.createQueryRunner();\n      await qr.connect();\n      await qr.startTransaction();\n      try {\n        const result = await fn({\n          query: <U>(sql: string, params?: unknown[]) => qr.query(sql, params) as Promise<U[]>,\n        });\n        await qr.commitTransaction();\n        return result;\n      } catch (err) {\n        await qr.rollbackTransaction();\n        throw err;\n      } finally {\n        await qr.release();\n      }\n    },\n  };\n}\n\n// ── MikroORM ─────────────────────────────────────────────────────────────────────────────────────\n\n/** Structural slice of a MikroORM `EntityManager` — avoids a hard dependency on @mikro-orm/core. */\ninterface MikroOrmEmLike {\n  getPlatform(): { constructor: { name: string }; quoteIdentifier(id: string): string };\n  getConnection(): {\n    execute(sql: string, params?: unknown[], method?: 'all', ctx?: unknown): Promise<unknown>;\n  };\n  getTransactionContext?(): unknown;\n  transactional<T>(cb: (em: MikroOrmEmLike) => Promise<T>): Promise<T>;\n}\n\n/**\n * Build an executor from a MikroORM `EntityManager` — i.e. **the app's own configured ORM**. Runs\n * raw SQL through `em.getConnection().execute(...)` and wraps the claim in `em.transactional(...)`,\n * threading the transaction context so `FOR UPDATE SKIP LOCKED` locks within the tx.\n */\nexport function mikroOrmExecutor(em: MikroOrmEmLike): SqlExecutor {\n  const platform = em.getPlatform();\n  return {\n    dialect: /postgre/i.test(platform.constructor.name) ? 'postgres' : 'mysql',\n    escapeId: (id) => platform.quoteIdentifier(id),\n    query: <T>(sql: string, params?: unknown[]) =>\n      em.getConnection().execute(sql, params ?? [], 'all') as Promise<T[]>,\n    transaction: <T>(fn: (tx: SqlTx) => Promise<T>) =>\n      em.transactional((txEm) =>\n        fn({\n          query: <U>(sql: string, params?: unknown[]) =>\n            txEm\n              .getConnection()\n              .execute(sql, params ?? [], 'all', txEm.getTransactionContext?.()) as Promise<U[]>,\n        }),\n      ),\n  };\n}\n"],"mappings":"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","names":["randomUUID","runStepHandler","typeOrmExecutor","ds","dialect","test","String","options","type","escapeId","id","driver","escape","query","sql","params","transaction","fn","qr","createQueryRunner","connect","startTransaction","result","commitTransaction","err","rollbackTransaction","release","mikroOrmExecutor","em","platform","getPlatform","name","quoteIdentifier","getConnection","execute","transactional","txEm","getTransactionContext","RUNS_INSERT_CHUNK","DEADLOCK_RETRIES","isDeadlock","err","codes","code","errno","driverError","some","c","RUNS_CLAIM_MAX","numberOption","value","fallback","min","undefined","Number","isFinite","DbTransport","exec","group","tasksTable","resultsTable","runsTable","runConsumers","Set","pollMs","leaseMs","batchSize","concurrency","onError","autoCreate","instanceId","isPg","handlers","Map","running","schemaReady","taskLoop","resultLoop","runningTasks","held","renewTimer","renewal","options","executor","prefix","Math","floor","console","error","randomUUID","dialect","ph","i","q","id","escapeId","now","Date","ensureSchema","createTables","catch","createIfMissing","sql","query","str","txt","tasks","results","dispatch","task","t","ignore","cols","replace","map","join","_","stepId","runId","seq","name","JSON","stringify","input","attempt","handle","fn","Error","set","loop","drainTasks","onResult","handler","drainResults","onHeartbeat","_handler","dispatchRuns","runs","opts","length","byRun","run","has","reason","unique","values","sort","a","b","at","chunk","slice","r","__","insert","release","wake","retryOnDeadlock","flatMap","namespace","priority","onDispatchedRun","consumer","stopped","inflight","slotFreed","Promise","resolve","max","ns","consumeRuns","add","stopRunConsumer","delete","renew","setInterval","renewRunLeases","unref","settled","free","size","rows","claimRuns","token","done","then","finally","sleep","allSettled","clearInterval","statement","random","limit","staleBefore","transaction","tx","claimed","run_id","globalThis","crypto","tokens","tick","processed","race","claim","hold","left","row","runTask","stillHolds","step_id","parse","result","runStepHandler","get","settleTask","insertResult","status","output","startedAt","started_at","table","where","whereParams","leaseClause","found","ids","placeholders","intervalMs","round","renewHeld","list","ms","setTimeout","close"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-durable-transport-db",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Database (SQL) Transport for nestjs-durable — DBOS-style: dispatch remote steps as rows in the durable DB, no broker",
   "license": "MIT",
   "author": "Davide Carvalho",
@@ -35,15 +35,16 @@
     }
   },
   "devDependencies": {
+    "@testcontainers/mysql": "10.18.0",
     "@testcontainers/postgresql": "10.18.0",
     "mysql2": "3.11.5",
     "pg": "8.13.1",
     "reflect-metadata": "0.2.2",
+    "tsup": "8.3.5",
     "typeorm": "0.3.31",
     "typescript": "5.9.3",
     "zod": "3.25.76",
-    "tsup": "8.3.5",
-    "@dudousxd/nestjs-durable-core": "^0.80.0"
+    "@dudousxd/nestjs-durable-core": "^0.85.3"
   },
   "module": "./dist/index.js",
   "exports": {