pg-boss 12.25.0 → 12.26.0

package/dist/index.js

@@ -32,8 +32,9 @@ export function getRollbackPlans(schema, version) {
 export class PgBoss extends EventEmitter {
     #stoppingOn;
     #stopped;
-    #starting;
     #started;
+    #startingPromise = null;
+    #stoppingPromise = null;
     #config;
     #db;
     #boss;
@@ -83,43 +84,58 @@ export class PgBoss extends EventEmitter {
         }
     }
     async start() {
-        if (this.#starting || this.#started) {
+        // A stop() already in flight must finish (clearing any resources it's tearing down) before a
+        // fresh start() begins, otherwise the two race over the same intervals/pool.
+        if (this.#stoppingPromise) {
+            await this.#stoppingPromise.catch(() => { });
+        }
+        // Return the SAME in-flight promise to a concurrent caller instead of a fresh `this` — a
+        // second caller must observe the actual outcome (including a rejection), not silently no-op
+        // while the first call is still mid-flight.
+        if (this.#startingPromise) {
+            return this.#startingPromise;
+        }
+        if (this.#started) {
             return this;
         }
-        this.#starting = true;
+        // Cleared to false before any subsystem is started (not just on success): if #doStart throws
+        // partway through, subsystems already started (e.g. manager's queueCacheInterval/wipInterval)
+        // must still be reachable by stop() for cleanup, and stop() no-ops whenever #stopped is true.
+        this.#stopped = false;
+        this.#startingPromise = this.#doStart();
         try {
-            if (this.#db._pgbdb && !this.#db.opened) {
-                await this.#db.open();
-            }
-            await this.#warnIfDistributedMisconfigured();
-            if (this.#config.migrate) {
-                await this.#contractor.start();
-            }
-            else {
-                await this.#contractor.check();
-            }
-            await this.#manager.start();
-            if (this.#config.useListenNotify) {
-                await this.#notifier.start();
-            }
-            if (this.#config.supervise) {
-                await this.#boss.start();
-                await this.#navigator.start();
-            }
-            if (this.#config.schedule) {
-                await this.#timekeeper.start();
-            }
-            if (this.#config.migrate) {
-                await this.#bam.start();
-            }
+            return await this.#startingPromise;
+        }
+        finally {
+            this.#startingPromise = null;
+        }
+    }
+    async #doStart() {
+        if (this.#db._pgbdb && !this.#db.opened) {
+            await this.#db.open();
+        }
+        await this.#warnIfDistributedMisconfigured();
+        if (this.#config.migrate) {
+            await this.#contractor.start();
+        }
+        else {
+            await this.#contractor.check();
+        }
+        await this.#manager.start();
+        if (this.#config.useListenNotify) {
+            await this.#notifier.start();
         }
-        catch (err) {
-            this.#starting = false;
-            throw err;
+        if (this.#config.supervise) {
+            await this.#boss.start();
+            await this.#navigator.start();
+        }
+        if (this.#config.schedule) {
+            await this.#timekeeper.start();
+        }
+        if (this.#config.migrate) {
+            await this.#bam.start();
         }
-        this.#starting = false;
         this.#started = true;
-        this.#stopped = false;
         return this;
     }
     // YugabyteDB needs the yugabytedb backend profile (no table partitioning + no advisory locks;
@@ -144,37 +160,61 @@ export class PgBoss extends EventEmitter {
         }
     }
     async stop(options = {}) {
-        if (this.#stoppingOn || this.#stopped) {
+        // A start() already in flight must finish (or fail) before stop() evaluates state, otherwise
+        // stop() reads #stopped mid-start and silently no-ops while start() keeps running.
+        if (this.#startingPromise) {
+            await this.#startingPromise.catch(() => { });
+        }
+        if (this.#stoppingPromise) {
+            return this.#stoppingPromise;
+        }
+        if (this.#stopped) {
             return;
         }
         let { close = true, graceful = true, timeout = 30000 } = options;
         timeout = Math.max(timeout, 1000);
         this.#stoppingOn = Date.now();
-        await this.#notifier.stop();
-        await this.#manager.stop();
-        await this.#timekeeper.stop();
-        await this.#boss.stop();
-        await this.#navigator.stop();
-        await this.#bam.stop();
-        const shutdown = async () => {
-            await this.#manager.failWip();
-            if (this.#db._pgbdb && this.#db.opened && close) {
-                await this.#db.close();
-                // Give event loop time to process socket closes
-                await delay(10);
+        this.#stoppingPromise = this.#doStop(close, graceful, timeout);
+        try {
+            return await this.#stoppingPromise;
+        }
+        finally {
+            this.#stoppingPromise = null;
+        }
+    }
+    async #doStop(close, graceful, timeout) {
+        try {
+            await this.#notifier.stop();
+            await this.#manager.stop();
+            await this.#timekeeper.stop();
+            await this.#boss.stop();
+            await this.#navigator.stop();
+            await this.#bam.stop();
+            const shutdown = async () => {
+                await this.#manager.failWip();
+                if (this.#db._pgbdb && this.#db.opened && close) {
+                    await this.#db.close();
+                    // Give event loop time to process socket closes
+                    await delay(10);
+                }
+                this.#stopped = true;
+                this.#started = false;
+                this.emit(events.stopped);
+            };
+            if (!graceful) {
+                await shutdown();
+                return;
             }
-            this.#stopped = true;
-            this.#stoppingOn = null;
-            this.#started = false;
-            this.emit(events.stopped);
-        };
-        if (!graceful) {
-            return await shutdown();
+            while ((Date.now() - this.#stoppingOn) < timeout && this.#manager.hasPendingCleanups()) {
+                await delay(500);
+            }
+            await shutdown();
         }
-        while ((Date.now() - this.#stoppingOn) < timeout && this.#manager.hasPendingCleanups()) {
-            await delay(500);
+        finally {
+            // Reset unconditionally (success or throw) so a stop() that fails partway can be retried
+            // instead of every future stop()/start() call silently no-op-ing forever on the stale marker.
+            this.#stoppingOn = null;
         }
-        await shutdown();
     }
     async send(...args) {
         return await this.#manager.send(...args);
@@ -325,6 +365,9 @@ export class PgBoss extends EventEmitter {
     schemaVersion() {
         return this.#contractor.schemaVersion();
     }
+    detectSchemaDrift() {
+        return this.#contractor.detectDrift();
+    }
     schedule(name, cron, data, options) {
         return this.#timekeeper.schedule(name, cron, data, options);
     }

package/dist/manager.d.ts.map

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

package/dist/manager.js

@@ -252,7 +252,7 @@ class Manager extends EventEmitter {
             // Fail the whole batch so the mistake surfaces and the jobs are retried.
             const err = new Error('perJobResults handler must resolve with an array of job results');
             await this.fail(name, jobs.map(job => job.id), err);
-            this.#trackJobsFailed(name, jobs, err);
+            await this.#trackJobsFailed(name, jobs, err);
             return;
         }
         // Index the handler's dispositions by job id, keeping only valid entries that reference a job
@@ -393,7 +393,12 @@ class Manager extends EventEmitter {
     async #processJobs(name, jobs, callback, worker, heartbeatRefreshSeconds, perJobResults = false) {
         const jobIds = jobs.map(job => job.id);
         const maxExpiration = jobs.reduce((acc, i) => Math.max(acc, i.expireInSeconds), 0);
-        const heartbeatSeconds = jobs.reduce((acc, j) => Math.max(acc, j.heartbeatSeconds || 0), 0);
+        // Minimum, not maximum: heartbeatSeconds is per-job, and failJobsByHeartbeat fails a job once
+        // its OWN heartbeat_on is stale by ITS OWN heartbeat_seconds. A refresh cadence derived from
+        // the batch max would let a small-heartbeat job in a mixed batch go stale and get failed out
+        // from under a still-running handler before the shared timer ever touches it.
+        const heartbeatCandidates = jobs.map(j => j.heartbeatSeconds || 0).filter(s => s > 0);
+        const heartbeatSeconds = heartbeatCandidates.length ? Math.min(...heartbeatCandidates) : 0;
         const ac = new AbortController();
         jobs.forEach(job => { job.signal = ac.signal; });
         // Store AbortController on worker so it can be aborted after graceful shutdown
@@ -578,18 +583,18 @@ class Manager extends EventEmitter {
                 }
                 else {
                     const { allowed, excess, groupedJobs } = this.#trackLocalGroupStart(name, jobs);
-                    if (excess.length > 0) {
-                        const excessIds = excess.map(job => job.id);
-                        await this.restore(name, excessIds);
-                    }
-                    if (allowed.length > 0) {
-                        try {
-                            await this.#processJobs(name, allowed, callback, worker, heartbeatRefreshSeconds, perJobResults);
+                    try {
+                        if (excess.length > 0) {
+                            const excessIds = excess.map(job => job.id);
+                            await this.restore(name, excessIds);
                         }
-                        finally {
-                            this.#trackLocalGroupEnd(name, groupedJobs);
+                        if (allowed.length > 0) {
+                            await this.#processJobs(name, allowed, callback, worker, heartbeatRefreshSeconds, perJobResults);
                         }
                     }
+                    finally {
+                        this.#trackLocalGroupEnd(name, groupedJobs);
+                    }
                 }
                 this.emitWip(name);
             };
@@ -638,7 +643,13 @@ class Manager extends EventEmitter {
     async offWork(name, options = { wait: true }) {
         assert(name, 'queue name is required');
         assert(typeof name === 'string', 'queue name must be a string');
-        const query = (i) => options?.id ? i.id === options.id : i.name === name;
+        // work() returns only the first spawned worker's id (shared as `workId` across every worker
+        // it spawned under localConcurrency), so { id } must match on workId too — otherwise only
+        // worker 0 of a localConcurrency > 1 call ever stops, and the rest poll forever with no other
+        // way to reach them. i.id is still checked so a specific worker id from getWipData() still
+        // targets just that one worker. name is always required so a stray/mismatched id can't stop
+        // a worker on a different queue.
+        const query = (i) => i.name === name && (options?.id ? (i.id === options.id || i.workId === options.id) : true);
         const workers = this.getWorkers().filter(i => query(i) && !i.stopping && !i.stopped);
         if (workers.length === 0) {
             return;
@@ -886,6 +897,15 @@ class Manager extends EventEmitter {
     }
     async insert(name, jobs, options = {}) {
         assert(Array.isArray(jobs), 'jobs argument should be an array');
+        const seenIds = new Set();
+        for (const job of jobs) {
+            if (job.id != null) {
+                if (seenIds.has(job.id)) {
+                    throw new Error(`duplicate job id in insert batch: ${job.id}`);
+                }
+                seenIds.add(job.id);
+            }
+        }
         const { table, policy, notify } = await this.getQueueCache(name);
         if (policy === plans.QUEUE_POLICIES.key_strict_fifo) {
             for (const job of jobs) {
@@ -894,20 +914,35 @@ class Manager extends EventEmitter {
                 }
             }
         }
+        const spy = this.config.__test__enableSpies ? this.#spies.get(name) : undefined;
+        // insertJobs ends in ON CONFLICT DO NOTHING, so skipped rows shift the returned rows out of
+        // alignment with the input jobs — a positional rows[i] <-> jobs[i] pairing attributes the wrong
+        // data to the wrong id. When a spy is watching, assign every job an explicit id up front (the
+        // insert COALESCEs id, so this is equivalent to letting the DB generate one) and index data by
+        // id, so returned rows can be matched back to their job regardless of any conflicts.
+        const dataById = spy ? new Map() : undefined;
         const insertPayload = jobs.map(j => {
             const { blocked, blocking, pendingDependencies, ...rest } = j;
+            if (dataById) {
+                // Best-effort spy bookkeeping, only reached when __test__enableSpies is set (a test-intended
+                // opt-in, off by default). The id we assign here is exactly what the DB would otherwise
+                // COALESCE in, so generating it client-side is harmless — and if randomUUID ever fell short,
+                // only spy attribution would degrade, never the insert itself.
+                rest.id ??= randomUUID();
+                dataById.set(rest.id, j.data ?? {});
+            }
             return rest;
         });
         const db = this.assertDb(options);
-        const spy = this.config.__test__enableSpies ? this.#spies.get(name) : undefined;
         // Return IDs if spy is active for this queue (needed for job tracking)
         const returnId = !!spy || !!options.returnId;
         const sql = plans.insertJobs(this.config.schema, { table, name, returnId, notify: this.#notifyEnabled(notify) });
         const { rows } = await db.executeSql(sql, [JSON.stringify(insertPayload)]);
         if (rows.length) {
             if (spy) {
-                for (let i = 0; i < rows.length; i++) {
-                    spy.addJob(rows[i].id, name, jobs[i].data || {}, 'created');
+                // dataById is populated for every job when a spy is active
+                for (const row of rows) {
+                    spy.addJob(row.id, name, dataById.get(row.id), 'created');
                 }
             }
             return rows.map((i) => i.id);
@@ -1035,7 +1070,13 @@ class Manager extends EventEmitter {
             result = await db.executeSql(query.text, query.values);
         }
         catch (err) {
-            // errors from fetchquery should only be unique constraint violations
+            // The only fetch error we tolerate is a unique-constraint violation (SQLSTATE 23505) from a
+            // policy/singleton index when a concurrent fetch won the same slot — treat that as an empty
+            // fetch. Anything else (a DB outage, a malformed query) must surface: swallowing it turned
+            // every failed fetch into a silent [] with no error event, indistinguishable from an empty
+            // queue. Rethrowing routes it to the worker's onError (emits `error`) or to a direct caller.
+            if (err?.code !== '23505')
+                throw err;
         }
         const rows = result?.rows || [];
         // CockroachDB returns integer columns as strings; normalize them. Even a minimal fetch
@@ -1220,7 +1261,7 @@ class Manager extends EventEmitter {
                 }
                 else {
                     const exp = Math.min(16, retryCount + 1);
-                    const delay = retryDelay * (Math.pow(2, exp) / 2 + Math.pow(2, exp) / 2 * Math.random());
+                    const delay = Math.max(retryDelay, 1) * (Math.pow(2, exp) / 2 + Math.pow(2, exp) / 2 * Math.random());
                     // Match the canonical failJobs() SQL: LEAST(retry_delay_max, delay) caps the backoff,
                     // treating NULL as "no cap" and 0 as a real cap. (`?:` would wrongly treat 0 as no cap.)
                     const cappedDelay = retryDelayMax != null ? Math.min(retryDelayMax, delay) : delay;
@@ -1253,7 +1294,7 @@ class Manager extends EventEmitter {
                 ]);
                 // Insert to dead letter queue if failed and has dead_letter configured
                 if (job.dead_letter) {
-                    await tx.executeSql(dlqSql, [job.dead_letter, job.data, jobOutput, job.name, job.id, job.created_on, job.retry_count]);
+                    await tx.executeSql(dlqSql, [job.dead_letter, job.data, jobOutput, job.name, job.id, job.created_on, job.retry_count, job.singleton_key, job.heartbeat_seconds]);
                 }
             }
             count++;
@@ -1399,13 +1440,18 @@ class Manager extends EventEmitter {
     }
     async deleteQueue(name) {
         Attorney.assertQueueName(name);
+        // Scope the catch to the cache lookup only: a queue that doesn't exist is a no-op. The DELETE
+        // and cache eviction must NOT be swallowed — a transient connection error there previously
+        // resolved as success while the queue (and its stale cache entry) survived.
         try {
             await this.getQueueCache(name);
-            const sql = plans.deleteQueue(this.config.schema, name, this.config.noAdvisoryLocks);
-            await this.db.executeSql(sql);
-            this.#evictQueueCache(name);
         }
-        catch { }
+        catch {
+            return;
+        }
+        const sql = plans.deleteQueue(this.config.schema, name, this.config.noAdvisoryLocks);
+        await this.db.executeSql(sql);
+        this.#evictQueueCache(name);
     }
     async deleteQueuedJobs(name) {
         Attorney.assertQueueName(name);

package/dist/migrationStore.d.ts

@@ -11,6 +11,7 @@ declare function rollback(schema: string, version: number, migrations?: types.Mi
 declare function next(schema: string, version: number, migrations?: types.Migration[], noAdvisoryLocks?: boolean): string;
 declare function migrateCommands(schema: string, version: number, migrations?: types.Migration[], noAdvisoryLocks?: boolean, options?: MigrateOptions): MigrationCommands;
 declare function migrate(schema: string, version: number, migrations?: types.Migration[], noAdvisoryLocks?: boolean, options?: MigrateOptions): string;
+declare function getMinVersion(schema: string): number;
 declare function getAll(schema: string, noPartitioning?: boolean, noCovering?: boolean): types.Migration[];
-export { rollback, next, migrate, migrateCommands, getAll, };
+export { rollback, next, migrate, migrateCommands, getAll, getMinVersion, };
 //# sourceMappingURL=migrationStore.d.ts.map

package/dist/migrationStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrationStore.d.ts","sourceRoot":"","sources":["../src/migrationStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAKnC,UAAU,cAAc;IACtB,WAAW,CAAC,EAAE,OAAO,CAAA;IAIrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AA4CD,UAAU,iBAAiB;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AASD,iBAAS,QAAQ,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,eAAe,CAAC,EAAE,OAAO,UAQ5G;AAED,iBAAS,IAAI,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,eAAe,CAAC,EAAE,OAAO,UAQxG;AAKD,iBAAS,eAAe,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,iBAAiB,CAgCrK;AAKD,iBAAS,OAAO,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,UAIzI;AAopBD,iBAAS,MAAM,CAAE,MAAM,EAAE,MAAM,EAAE,cAAc,UAAQ,EAAE,UAAU,UAAQ,GAAG,KAAK,CAAC,SAAS,EAAE,CAmZ9F;AAED,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,eAAe,EACf,MAAM,GACP,CAAA"}
+{"version":3,"file":"migrationStore.d.ts","sourceRoot":"","sources":["../src/migrationStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAKnC,UAAU,cAAc;IACtB,WAAW,CAAC,EAAE,OAAO,CAAA;IAIrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAgDD,UAAU,iBAAiB;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AASD,iBAAS,QAAQ,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,eAAe,CAAC,EAAE,OAAO,UAQ5G;AAED,iBAAS,IAAI,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,eAAe,CAAC,EAAE,OAAO,UAQxG;AAKD,iBAAS,eAAe,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,iBAAiB,CA+CrK;AAKD,iBAAS,OAAO,CAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,UAIzI;AAyrBD,iBAAS,aAAa,CAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,iBAAS,MAAM,CAAE,MAAM,EAAE,MAAM,EAAE,cAAc,UAAQ,EAAE,UAAU,UAAQ,GAAG,KAAK,CAAC,SAAS,EAAE,CAoa9F;AAED,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,eAAe,EACf,MAAM,EACN,aAAa,GACd,CAAA"}

package/dist/migrationStore.js

@@ -4,9 +4,13 @@ import * as types from "./types.js";
 // Mirrors the SQL job_table_format() function (src/plans.ts): rewrites a command targeting
 // the base `job` table to target a specific partition table.
 function formatJobTable(command, table) {
+    // Anchor both rewrites so a schema name that itself contains these substrings (e.g. `job_intake`)
+    // isn't mangled: `.job\b` only matches the base table reference (`schema.job`, not `schema.job_i5`
+    // whose `job` is followed by `_`), and `job_iN` only matches the bare index-name tokens (job_i1..9),
+    // never the `job_i` inside an arbitrary schema name.
     return command
-        .replaceAll('.job', `.${table}`)
-        .replaceAll('job_i', `${table}_i`);
+        .replace(/\.job\b/g, `.${table}`)
+        .replace(/\bjob_i(\d+)/g, `${table}_i$1`);
 }
 // Derives the direct index DDL that a job_table_run_async() command would eventually run
 // via BAM, one statement per target table, each prefixed with a provenance comment. The
@@ -53,6 +57,19 @@ function next(schema, version, migrations, noAdvisoryLocks) {
 // programmatically must run `concurrent` statements individually, outside a transaction.
 function migrateCommands(schema, version, migrations, noAdvisoryLocks, options = {}) {
     migrations = migrations || getAll(schema);
+    // Refuse to migrate from a real DB version older than the oldest migration can start from.
+    // Without this floor, `filter(i => i.previous >= version)` happily selects the whole chain for any
+    // version below the minimum `previous`, applying migrations over missing intermediate steps — a
+    // cryptic mid-transaction failure, or worse a "success" that stamps the latest version onto an
+    // incomplete schema. Version 0 is the sentinel for a full "from scratch" export (getMigrationPlans)
+    // and is intentionally exempt.
+    // Only floor a valid numeric version; a non-numeric/garbage version falls through to the
+    // "Version X not found" assert below. Version 0 is the full-export sentinel and is exempt.
+    if (Number.isInteger(version) && version !== 0) {
+        const minPrevious = Math.min(...migrations.map(i => i.previous));
+        assert(version >= minPrevious, `Cannot migrate pg-boss schema from version ${version}: the oldest supported starting version is ${minPrevious}. ` +
+            'Upgrade to a schema at or above that version using an older pg-boss release first.');
+    }
     const concurrent = [];
     const result = migrations
         .filter(i => i.previous >= version)
@@ -732,6 +749,45 @@ const ensureQueueStatsPartitionsFn = {
     $$
   `
 };
+// Frozen job_table_format() bodies, one per schema version, so the v37 migration is an immutable
+// snapshot even if plans.jobTableFormatFunction drifts later. 37 is the anchored regexp_replace
+// fix (matches only the base table reference and bare job_iN tokens); 36 is the prior naive
+// replace(), kept solely so v37's rollback restores the exact previous definition.
+const jobTableFormatFn = {
+    36: (schema) => `
+    CREATE OR REPLACE FUNCTION ${schema}.job_table_format(command text, table_name text)
+    RETURNS text AS
+    $$
+      SELECT format(
+        replace(
+          replace(command, '.job', '.%1$I'),
+          'job_i', '%1$s_i'
+        ),
+        table_name
+      );
+    $$
+    LANGUAGE sql IMMUTABLE;
+  `,
+    37: (schema) => `
+    CREATE OR REPLACE FUNCTION ${schema}.job_table_format(command text, table_name text)
+    RETURNS text AS
+    $$
+      SELECT format(
+        regexp_replace(
+          regexp_replace(command, '\\.job\\y', '.%1$I', 'g'),
+          '\\yjob_i(\\d+)', '%1$s_i\\1', 'g'
+        ),
+        table_name
+      );
+    $$
+    LANGUAGE sql IMMUTABLE;
+  `
+};
+// Lowest schema version a migration can start from (the smallest `previous` in the set). Below
+// this there is no chain to apply; callers use it as an honest floor / offline fallback.
+function getMinVersion(schema) {
+    return Math.min(...getAll(schema).map(i => i.previous));
+}
 function getAll(schema, noPartitioning = false, noCovering = false) {
     return [
         {
@@ -877,7 +933,7 @@ function getAll(schema, noPartitioning = false, noCovering = false) {
                 `ALTER INDEX ${schema}.job_common_i3 RENAME TO job_i3`,
                 `ALTER INDEX ${schema}.job_common_i2 RENAME TO job_i2`,
                 `ALTER INDEX ${schema}.job_common_i1 RENAME TO job_i1`,
-                `SELECT ${schema}.job_table_run('DROP INDEX ${schema}.job_i7')`,
+                `SELECT ${schema}.job_table_run('DROP INDEX IF EXISTS ${schema}.job_i7')`,
                 createQueueFn[26](schema),
                 `DROP FUNCTION ${schema}.job_table_run(text, text, text)`,
                 `DROP FUNCTION ${schema}.job_table_run_async(text, int, text, text, text)`,
@@ -1133,7 +1189,24 @@ function getAll(schema, noPartitioning = false, noCovering = false) {
             ],
             // The default change is forward-compatible and harmless to keep, so rollback leaves it in place.
             uninstall: []
+        },
+        {
+            release: '12.26.0',
+            version: 37,
+            previous: 36,
+            // Fix job_table_format(): the naive replace() mangled schema names containing `.job` or
+            // `job_i` (e.g. `job_intake`), rewriting index builds to a nonexistent schema. The anchored
+            // regexp_replace version matches only the base table reference and bare job_iN index tokens.
+            // Only installed where partitioning is enabled — the function is created by plans.create()
+            // solely in that case (plans.ts), so a noPartitioning database has none to replace.
+            install: noPartitioning
+                ? []
+                : [jobTableFormatFn[37](schema)],
+            // Restore the prior (naive) definition on rollback so the schema matches v36 exactly.
+            uninstall: noPartitioning
+                ? []
+                : [jobTableFormatFn[36](schema)]
         }
     ];
 }
-export { rollback, next, migrate, migrateCommands, getAll, };
+export { rollback, next, migrate, migrateCommands, getAll, getMinVersion, };

package/dist/plans.d.ts

@@ -1,4 +1,5 @@
-import type { JobMatchStrategy, UpdateQueueOptions } from './types.ts';
+import type { JobMatchStrategy, UpdateQueueOptions, ManagedIndex, ManagedFunction } from './types.ts';
+import type { ExpectedColumns, ExpectedConstraints } from './drifter.ts';
 export interface SqlQuery {
     text: string;
     values: unknown[];
@@ -9,6 +10,7 @@ export declare const PG_ERROR: {
 export declare const DEFAULT_SCHEMA = "pgboss";
 export declare const MIGRATE_RACE_MESSAGE = "division by zero";
 export declare const CREATE_RACE_MESSAGE = "already exists";
+export declare const SINGLE_QUOTE_REGEX: RegExp;
 export declare const JOB_STATES: Readonly<{
     created: "created";
     retry: "retry";
@@ -25,6 +27,7 @@ export declare const QUEUE_POLICIES: Readonly<{
     exclusive: "exclusive";
     key_strict_fifo: "key_strict_fifo";
 }>;
+export declare const COMMON_JOB_TABLE = "job_common";
 interface CreateOptions {
     createSchema?: boolean;
     noTablePartitioning?: boolean;
@@ -37,6 +40,7 @@ export declare function createTableWarning(schema: string): string;
 export declare function createIndexWarning(schema: string): string;
 export declare function createTableJobDependency(schema: string): string;
 export declare function createIndexJobDependencyParent(schema: string): string;
+export declare function jobTableFormatFunction(schema: string): string;
 export declare function createQueue(schema: string, name: string, options: unknown, noAdvisoryLocks?: boolean): string;
 export declare function notifyChannelSql(schema: string): string;
 export declare function notifyQueue(schema: string, name: string): string;
@@ -178,10 +182,28 @@ export declare function getDependencies(schema: string): string;
 export declare function getDependents(schema: string): string;
 export declare function cleanupDependencies(schema: string, table: string, queues: string[], noAdvisoryLocks?: boolean): string;
 export declare function getBlockedKeys(schema: string, table: string): string;
-export declare function getNextBamCommand(schema: string): string;
+export declare function getNextBamCommand(schema: string, { useLiveness }?: {
+    useLiveness?: boolean;
+}): string;
+export declare function bamHealDrop(schema: string, command: string): string | null;
+export declare function bamHealProbe(schema: string, command: string): string | null;
 export declare function setBamCompleted(schema: string, id: string): string;
 export declare function setBamFailed(schema: string, id: string, error: string): string;
 export declare function getBamStatus(schema: string): string;
 export declare function getBamEntries(schema: string): string;
+export declare function jobCommonExists(schema: string): string;
+export declare function getManagedQueuePartitions(schema: string): string;
+export declare function getIncompleteBamCommands(schema: string): string;
+export declare function bamCommandIndexName(command: string): string | null;
+interface QueuePartition {
+    table: string;
+    policy?: string | null;
+}
+export declare const EXPECTED_JOB_STATES: readonly string[];
+export declare function expectedManagedTables(schema: string, partitioned: boolean, partitions?: QueuePartition[]): string[];
+export declare function expectedManagedColumns(schema: string, partitioned: boolean, partitions?: QueuePartition[]): ExpectedColumns[];
+export declare function expectedManagedConstraints(schema: string, partitioned: boolean): ExpectedConstraints[];
+export declare function expectedManagedFunctions(schema: string, partitioned: boolean): ManagedFunction[];
+export declare function expectedManagedIndexes(schema: string, partitioned: boolean, partitions?: QueuePartition[]): ManagedIndex[];
 export {};
 //# sourceMappingURL=plans.d.ts.map