pg-boss 12.31.0 → 12.32.0

package/dist/manager.js

@@ -3,6 +3,7 @@ import { randomUUID } from 'node:crypto';
 import EventEmitter from 'node:events';
 import { serializeError as stringify } from 'serialize-error';
 import * as Attorney from "./attorney.js";
+import { TRANSACTION_ROLLBACK_TIMEOUT_MS } from "./db.js";
 import * as plans from "./plans.js";
 import * as timekeeper from "./timekeeper.js";
 import { resolveWithinSeconds } from "./tools.js";
@@ -10,6 +11,58 @@ import * as types from "./types.js";
 import Worker from "./worker.js";
 import { JobSpy } from "./spy.js";
 const INTERNAL_QUEUES = Object.values(timekeeper.QUEUES).reduce((acc, i) => ({ ...acc, [i]: i }), {});
+// postgres: current transaction is aborted, commands ignored until end of transaction block
+const TRANSACTION_ABORTED = '25P02';
+// pg's own default when the pool size is not configured. Used to tell a transactional worker how
+// much room it actually has, since each handler in flight holds a connection of its own.
+const DEFAULT_POOL_MAX = 10;
+const WARNING_TYPES = {
+    TRANSACTIONAL_POOL_HEADROOM: 'transactional_pool_headroom',
+    TRANSACTION_TIMEOUT_PROBE: 'transaction_timeout_probe'
+};
+const TRANSACTIONAL_HEARTBEAT_UNSUPPORTED = 'this backend cannot run a transactional worker on a queue with heartbeatSeconds: the heartbeat refreshes the claimed row from a pooled connection, which the handler transaction is then refused a write to. Drop heartbeatSeconds and let expireInSeconds bound the job, or drop transactional and settle it with complete({ db })';
+// The same refusal from inside a batch, where the queue passed work()'s check and the heartbeat
+// arrived afterwards: on the job itself (heartbeatSeconds on send()), or on the queue, through
+// updateQueue() or through a createQueue() that work() ran ahead of. Pointing at the queue's
+// configuration there would send the user to a setting that is not the one they need to drop.
+const TRANSACTIONAL_HEARTBEAT_ON_BATCH = 'this backend cannot run a transactional handler over a job with heartbeatSeconds: the heartbeat refreshes the claimed row from a pooled connection, which the handler transaction is then refused a write to. The queue carried no heartbeat when this worker registered, so it came from the job (heartbeatSeconds on send()) or from the queue after registration. Drop it there and let expireInSeconds bound the job, or drop transactional and settle it with complete({ db })';
+// Candidates for bounding a transactional handler's transaction from the database side, best
+// first. transaction_timeout covers the whole transaction; idle_in_transaction_session_timeout only
+// covers the gaps between statements, which still catches a handler that stops issuing them.
+// statement_timeout is deliberately absent: it bounds one statement, and leaves the next one with
+// 25P02, which would have the aborted-transaction message blame the handler for a SQL error it
+// never swallowed.
+const TRANSACTION_TIMEOUT_GUCS = ['transaction_timeout', 'idle_in_transaction_session_timeout'];
+// current_setting(name, true) answers NULL for a parameter the server does not recognise, on every
+// backend pg-boss supports, so which of the two is available takes one statement and no version
+// parsing. transaction_timeout arrived in PostgreSQL 17 and exists on CockroachDB; asking for it on
+// 13-16 any other way is a hard error.
+const TRANSACTION_TIMEOUT_PROBE = `SELECT ${TRANSACTION_TIMEOUT_GUCS.map(name => `current_setting('${name}', true) AS ${name}`).join(', ')}`;
+// The tighter of pg-boss's bound ($2, milliseconds) and the one the connection already carries for
+// GUC $1. A role, a managed provider or a pooler that sets idle_in_transaction_session_timeout means
+// it, and the transactions this runs on are the longest ones pg-boss opens, so overwriting it is
+// exactly the wrong place to do so. pg_settings reports both GUCs unitless in milliseconds on every
+// backend that has them, which current_setting does not, so the comparison needs no parsing and no
+// second round trip. LEAST ignores nulls, which covers both cases where there is nothing to be
+// tighter than: 0 is how either GUC spells "no bound" (NULLIF turns it into one of them), and a
+// backend that recognises the parameter without listing it in pg_settings is the other. Read per
+// transaction rather than cached, since the value belongs to the connection and not to the process.
+const TRANSACTION_TIMEOUT_TIGHTEST = 'LEAST($2::bigint, NULLIF((SELECT s.setting::bigint FROM pg_settings s WHERE s.name = $1), 0))';
+// Applies the bound. This is the first statement of the handler's transaction, so it must not be
+// the first place a statement can fail: the read half is rehearsed by the probe below, on the
+// pooled connection, and only set_config is new here. Sharing the expression is what keeps the two
+// from drifting apart.
+const TRANSACTION_TIMEOUT_APPLY = `SELECT set_config($1, ${TRANSACTION_TIMEOUT_TIGHTEST}::text, true)`;
+// The read half of the apply, run once by the probe with a bound of 0 so it can set nothing. A
+// backend or a db adapter that answers current_setting but has no pg_settings view fails here,
+// where failing costs the bound, rather than inside the transaction, where it would cost the batch.
+// set_config is left out on purpose: a custom adapter's executeSql may sit inside the caller's own
+// open transaction, and a rehearsal must not be able to change anything there.
+const TRANSACTION_TIMEOUT_REHEARSE = `SELECT ${TRANSACTION_TIMEOUT_TIGHTEST}`;
+// How long a refused probe is remembered before the next transactional batch asks again. The bound
+// is a backstop, so the retry has to stay; a backend that will never answer does not need to be
+// asked on every batch for the life of the process either.
+const TRANSACTION_TIMEOUT_PROBE_COOLDOWN_MS = 60_000;
 // CockroachDB returns integer columns (INT8) as strings; these aliased metadata
 // fields must be coerced back to numbers when backend === 'cockroachdb'.
 const NUMERIC_METADATA_FIELDS = [
@@ -58,6 +111,7 @@ const QUEUE_STATS_CACHE_TTL_SECONDS = 60 * 60;
 const QUEUE_STATS_FORCE_TTL_SECONDS = 60;
 const events = {
     error: 'error',
+    warning: 'warning',
     wip: 'wip'
 };
 // The fetch options that were performance escapes from the fetch's sort. The index is now ordered to
@@ -93,6 +147,20 @@ class Manager extends EventEmitter {
     queues;
     pendingOffWorkCleanups;
     #spies;
+    // Job ids a transactional handler settled itself through the transaction it was handed, keyed on
+    // that transaction's db. #processJobs reads it to interpret its own completion; see the check
+    // there. Weak because the key is the transaction, so an entry goes away with it.
+    #handlerSettledJobs;
+    // Which GUC this server bounds a transaction with, resolved on the first transactional batch and
+    // kept for the life of the process. Resolving to null means neither is recognised, or the probe
+    // itself failed; a failed probe clears the memo and sets the instant before which no batch asks
+    // again.
+    #transactionTimeoutGuc;
+    #transactionTimeoutProbeRetryAt;
+    #transactionTimeoutProbeCooldownMs;
+    // One warning per process for a probe the server will not answer. A backend or adapter that
+    // cannot answer it today will not answer it tomorrow, so there is no episode to report twice.
+    #warnedTransactionTimeoutProbe;
     #localGroupActive;
     #localGroupConfig;
     #localGroupMaxLimit;
@@ -105,6 +173,11 @@ class Manager extends EventEmitter {
         this.queues = {};
         this.pendingOffWorkCleanups = new Set();
         this.#spies = new Map();
+        this.#handlerSettledJobs = new WeakMap();
+        this.#transactionTimeoutGuc = null;
+        this.#transactionTimeoutProbeRetryAt = 0;
+        this.#transactionTimeoutProbeCooldownMs = config.__test__transactionTimeoutProbeCooldownMs ?? TRANSACTION_TIMEOUT_PROBE_COOLDOWN_MS;
+        this.#warnedTransactionTimeoutProbe = false;
         this.#localGroupActive = new Map();
         this.#localGroupConfig = new Map();
         this.#localGroupMaxLimit = new Map();
@@ -399,7 +472,18 @@ class Manager extends EventEmitter {
             }
         }
     }
-    async #processJobs(name, jobs, callback, worker, heartbeatRefreshSeconds, perJobResults = false) {
+    /**
+     * Runs a batch through its handler and settles it.
+     *
+     * With `transactional`, the handler and the completion run in one transaction of their own. The
+     * batch is already claimed by the time this is called, so the transaction covers the handler's
+     * writes and the completion and nothing else: success commits them together, and a throw rolls
+     * both back and then fails the jobs on a pooled connection, where the retry accounting is the
+     * same as any other worker's. Because the claim is outside the transaction, the jobs stay
+     * visibly `active` throughout, which is what keeps heartbeats, `expireInSeconds`, and another
+     * instance's supervisor working on them as usual.
+     */
+    async #processJobs(name, jobs, callback, worker, heartbeatRefreshSeconds, perJobResults = false, transactional = false, transactionTimeoutSeconds) {
         const jobIds = jobs.map(job => job.id);
         const maxExpiration = jobs.reduce((acc, i) => Math.max(acc, i.expireInSeconds), 0);
         // Minimum, not maximum: heartbeatSeconds is per-job, and failJobsByHeartbeat fails a job once
@@ -413,6 +497,7 @@ class Manager extends EventEmitter {
         // Store AbortController on worker so it can be aborted after graceful shutdown
         if (worker) {
             worker.abortController = ac;
+            worker.aborted = false;
         }
         let heartbeatTimer = null;
         if (heartbeatSeconds > 0) {
@@ -431,8 +516,46 @@ class Manager extends EventEmitter {
         let completedAffected = 0;
         let failedError;
         let didFail = false;
+        // Only for a transactional worker, and only from the begin below until it settles. rollback()
+        // is idempotent, so the catch can settle it without tracking whether the commit got there
+        // first.
+        let transaction = null;
         try {
-            const result = await resolveWithinSeconds(callback(jobs), maxExpiration, `handler execution exceeded ${maxExpiration}s`, ac);
+            // A per-job heartbeatSeconds, or updateQueue() after the worker registered, can put a
+            // heartbeat on a batch whose queue carried none at work(), which that check cannot see. Thrown
+            // before the begin so the batch takes the ordinary failure path rather than the backend's raw
+            // write conflict.
+            assert(!(transactional && heartbeatSeconds > 0 && this.config.noTransactionalHeartbeat), TRANSACTIONAL_HEARTBEAT_ON_BATCH);
+            if (transactional) {
+                const timeoutMs = transactionTimeoutSeconds !== undefined
+                    ? transactionTimeoutSeconds * 1000
+                    : maxExpiration * 1000 + TRANSACTION_ROLLBACK_TIMEOUT_MS;
+                // Asked before the begin. The probe runs on a pooled connection, and a pool whose
+                // connections the handlers in flight are already holding has none to hand it: the wait
+                // would then be connectionTimeoutMillis long, with this transaction open across it, and
+                // the bound lost for the whole cooldown after. Memoized after the first batch either way.
+                const timeoutGuc = timeoutMs > 0 ? await this.#resolveTransactionTimeoutGuc() : null;
+                transaction = await this.db.beginTransaction();
+                this.#handlerSettledJobs.set(transaction.db, new Set());
+                if (timeoutGuc) {
+                    await this.#applyTransactionTimeout(transaction, timeoutGuc, timeoutMs);
+                }
+            }
+            const handling = transaction
+                ? callback(jobs, transaction.db)
+                : callback(jobs);
+            const result = await resolveWithinSeconds(handling, maxExpiration, `handler execution exceeded ${maxExpiration}s`, ac);
+            // An abort resolves the race rather than rejecting it, so on this line an abandoned handler
+            // looks exactly like one that returned. failWip() aborts after failing the batch, so
+            // committing here would leave whatever the handler had written by then in the database
+            // beside a job that is already failed: the split a transactional worker exists to prevent.
+            // Rolling back instead takes the same path a throw takes, and the fail that follows finds
+            // the jobs already settled and does nothing. The worker's flag rather than the signal,
+            // because resolveWithinSeconds cancels its own timeout through the same controller and so
+            // leaves the signal aborted on every ordinary completion too.
+            if (transaction && worker?.aborted) {
+                throw new Error('pg-boss shut down while the handler was still running');
+            }
             if (perJobResults) {
                 // #settlePerJob settles each job individually and does its own (synchronous,
                 // lookup-free) spy tracking via #trackJobsSettled, so the deferred tracker below
@@ -440,12 +563,33 @@ class Manager extends EventEmitter {
                 await this.#settlePerJob(name, jobs, result);
             }
             else {
-                const completion = await this.complete(name, jobIds, jobIds.length === 1 ? result : undefined);
+                // Read out before the completion below, which goes through the same complete() and would
+                // otherwise record pg-boss's own settle as one the handler made.
+                const settledByHandler = transaction ? this.#takeHandlerSettles(transaction) : null;
+                const completion = await this.complete(name, jobIds, jobIds.length === 1 ? result : undefined, transaction ? { db: transaction.db } : undefined);
                 completedResult = result;
                 completedAffected = completion.affected;
+                if (settledByHandler) {
+                    this.#assertClaimHeld(jobIds, completion.affected, settledByHandler);
+                }
+            }
+            if (transaction) {
+                await transaction.commit();
             }
         }
         catch (err) {
+            if (transaction) {
+                // Before the fail, not after: fail() runs on a pooled connection and would otherwise wait
+                // on the job rows this transaction still holds locked.
+                await transaction.rollback();
+                // A handler that catches a SQL error it raised through the transaction leaves that
+                // transaction aborted, and postgres then rejects every later statement in it with 25P02,
+                // including the completion pg-boss runs there. Name the cause, since the raw message
+                // arrives with nothing to connect it to the handler.
+                if (err?.code === TRANSACTION_ABORTED) {
+                    err.message = `${err.message} (the handler left its transaction aborted: let a SQL error raised through tx propagate out of the handler, or isolate the statement with a SAVEPOINT)`;
+                }
+            }
             await this.fail(name, jobIds, err);
             failedError = err;
             didFail = true;
@@ -474,6 +618,136 @@ class Manager extends EventEmitter {
             }
         }
     }
+    /**
+     * Gives the handler's transaction a deadline the database enforces.
+     *
+     * Everything else bounding it lives in this process: `resolveWithinSeconds` and the deadline
+     * `rollback()` races its ROLLBACK against. Those cover a handler that hangs. They do not cover
+     * the process itself failing under it (a starved event loop, a driver wedged below the promise),
+     * which is the case that matters most. An open transaction keeps advertising `backend_xmin` and
+     * holds vacuum off the whole database for as long as it lasts, which is the condition
+     * `monitorVacuum` and the `xmin_horizon` warning exist to report, and this option is what makes a
+     * long-lived transaction reachable from user code in the first place.
+     *
+     * The default is derived from `expireInSeconds` rather than matched to it. Matching would make
+     * the diagnosis a coin flip between `handler execution exceeded Ns` with a clean rollback and a
+     * killed connection, and the transaction is open wider than the handler anyway (BEGIN precedes
+     * it, the completion and COMMIT follow it), so an equal bound would kill a batch that had already
+     * succeeded at its commit. `expireInSeconds` is also the supervisor's reclaim bound, and a third
+     * actor on that instant helps nobody. With the rollback deadline added on top, this only fires
+     * once the whole Node path has failed, which is when the server should be the one to give up.
+     *
+     * Issued here on `tx.db` rather than as a `beginTransaction()` argument: that method is public
+     * `IDatabase` surface, so an adapter that ignored a new parameter would drop the bound silently.
+     * `set_config` with the value bound rather than a built `SET LOCAL` string, so it is one
+     * parameterized statement and portable to drivers that reject multi-statement queries.
+     */
+    async #applyTransactionTimeout(transaction, guc, timeoutMs) {
+        await transaction.db.executeSql(TRANSACTION_TIMEOUT_APPLY, [guc, `${Math.round(timeoutMs)}`]);
+    }
+    /**
+     * Which GUC this server bounds a transaction with, or null if neither is available and the
+     * transaction runs unbounded.
+     *
+     * Asked on the pooled connection rather than the handler's, even though the bound is applied on
+     * the handler's. A statement that errors leaves its transaction aborted, so a probe the backend
+     * or a `db` adapter cannot answer would poison the very transaction it was meant to protect and
+     * every handler statement after it would come back 25P02 blaming the handler for a SQL error it
+     * never raised. Off the transaction, a failed probe costs the bound and nothing else.
+     *
+     * Asked before the begin for the same reason it is asked off the transaction: a pool whose
+     * connections the handlers in flight are holding has none left for the probe, so a probe issued
+     * after the begin waits out `connectionTimeoutMillis` with that transaction open and then loses
+     * the bound for the whole cooldown. Only the first batch of a process pays anything here.
+     *
+     * The apply statement also reads pg_settings, and it runs as the first statement of the handler's
+     * transaction, so the probe rehearses that read here as well. Otherwise a backend with the GUC but
+     * without the catalog view would fail every batch, silently as far as the warning system goes,
+     * which is the failure the probe exists to keep out of the transaction.
+     *
+     * The bound is a backstop against a process that has already failed, so losing it degrades rather
+     * than fails the batch: warn once, run this batch unbounded, and ask again once the cooldown has
+     * passed instead of running unbounded for the life of the process, or asking on every batch.
+     */
+    #resolveTransactionTimeoutGuc() {
+        if (!this.#transactionTimeoutGuc && Date.now() < this.#transactionTimeoutProbeRetryAt) {
+            return Promise.resolve(null);
+        }
+        this.#transactionTimeoutGuc ??= this.db.executeSql(TRANSACTION_TIMEOUT_PROBE)
+            .then(({ rows }) => TRANSACTION_TIMEOUT_GUCS.find(name => rows[0][name] !== null) ?? null)
+            .then(async (guc) => {
+            if (guc)
+                await this.db.executeSql(TRANSACTION_TIMEOUT_REHEARSE, [guc, '0']);
+            return guc;
+        })
+            .catch((err) => {
+            this.#transactionTimeoutGuc = null;
+            this.#transactionTimeoutProbeRetryAt = Date.now() + this.#transactionTimeoutProbeCooldownMs;
+            if (!this.#warnedTransactionTimeoutProbe) {
+                this.#warnedTransactionTimeoutProbe = true;
+                this.emit(events.warning, {
+                    message: `could not ask this server which transaction timeout it supports, or read the bound it already carries, so transactional handlers run with no database-side bound until the next probe: ${err.message}`,
+                    data: { type: WARNING_TYPES.TRANSACTION_TIMEOUT_PROBE }
+                });
+            }
+            return null;
+        });
+        return this.#transactionTimeoutGuc;
+    }
+    /**
+     * Guards the commit of a transactional batch on the worker still holding the claim it opened the
+     * transaction with.
+     *
+     * `complete()` only settles a job that is still `active`, so a short count means the rows were
+     * taken out of that state while the handler ran. Two things do that. The handler may have settled
+     * the jobs itself with `complete()`, `fail()`, `cancel()` or `deleteJob()` on `{ db: tx }`, which
+     * is a documented pattern and leaves pg-boss's own completion with nothing to update; those calls
+     * record their ids as they land, so they cost no round trip to recognise. Anything left over is a
+     * claim that went away: an operator's `cancel()` or `fail()`, a heartbeat the database stopped
+     * seeing, `expireInSeconds`, another instance's supervisor. That job is going to run again, so
+     * committing the handler's writes beside it produces exactly the duplicate side effect this
+     * option exists to prevent. Throwing rolls them back and takes the ordinary failure path, which
+     * records the failure against whatever state the job is in by then.
+     *
+     * A handler that settles its own jobs by writing the job table directly also lands here, since
+     * nothing about a raw `UPDATE` is recognisable as a settle. That is a narrowing rather than a
+     * regression: direct writes to the job table were never supported. The message has to offer that
+     * reading anyway, so the diagnosis is not sent after a claim that was never lost.
+     */
+    #assertClaimHeld(jobIds, affected, settledByHandler) {
+        const accounted = affected + jobIds.filter(id => settledByHandler.has(id)).length;
+        if (accounted < jobIds.length) {
+            throw new Error(`${jobIds.length - accounted} of ${jobIds.length} job(s) were no longer claimed by this worker when the handler returned, so the transaction was rolled back. Either something took the claim away (expireInSeconds, a heartbeat the database stopped seeing, an operator's cancel() or fail(), another instance's supervisor), or the handler settled the job with SQL of its own instead of complete(), fail(), cancel() or deleteJob() on { db: tx }`);
+        }
+    }
+    // The ids the handler settled through its transaction. Taken rather than read, so the completion
+    // pg-boss runs next on the same transaction does not add itself to the set.
+    #takeHandlerSettles(transaction) {
+        const settled = this.#handlerSettledJobs.get(transaction.db) ?? new Set();
+        this.#handlerSettledJobs.delete(transaction.db);
+        return settled;
+    }
+    // Records a settle a transactional handler ran through the transaction it was handed. A no-op for
+    // every other caller: only a transaction #processJobs opened is in the map.
+    //
+    // Records the ids the statement touched rather than the ids it was asked about, because the two
+    // differ in both directions. complete() on a job a peer already moved out of `active` updates no
+    // rows, and recording that as the handler's settle would account for a job nobody settled and let
+    // the batch commit, which is the duplicate #assertClaimHeld exists to stop. A handler that
+    // settles part of its own batch first then asks about all of it lands short for the opposite
+    // reason, and reading that as a lost claim would throw away a batch that did what it was asked.
+    // The count alone cannot tell those apart; the ids can, and the statement already returns them.
+    #trackHandlerSettle(options, response) {
+        const settled = options.db && this.#handlerSettledJobs.get(options.db);
+        if (!settled)
+            return;
+        // Without the ids there is no way to attribute a short count, so fall back to the all-or-nothing
+        // reading: a full settle is the handler's, anything less is left for #assertClaimHeld to judge.
+        const landed = response.settled ?? (response.affected < response.requested ? [] : response.jobs);
+        for (const id of landed) {
+            settled.add(id);
+        }
+    }
     async start() {
         this.stopped = false;
         this.queueCacheInterval = setInterval(() => this.onCacheQueues({ emit: true }), this.config.queueCacheIntervalSeconds * 1000);
@@ -529,11 +803,31 @@ class Manager extends EventEmitter {
         this.#localGroupActive.clear();
         this.#localGroupMaxLimit.clear();
     }
+    // Last step of a shutdown: closing the pool, marking the instance stopped, and emitting
+    // `stopped` all wait on this, so every worker has to be reached even when one of them cannot be
+    // failed.
     async failWip() {
         for (const worker of this.workers.values()) {
             const jobIds = worker.jobs.map(j => j.id);
             if (jobIds.length) {
-                await this.fail(worker.name, jobIds, 'pg-boss shut down while active');
+                // The fail goes in before the abort, so it lands while the handler is still holding the
+                // jobs active and its completion finds nothing to settle. Its own failure is reported
+                // rather than thrown: the remaining workers still have to be aborted.
+                try {
+                    await this.fail(worker.name, jobIds, 'pg-boss shut down while active');
+                }
+                catch (err) {
+                    try {
+                        this.emit(events.error, { ...err, message: err.message, stack: err.stack, queue: worker.name, worker: worker.id });
+                    }
+                    catch {
+                        // An `error` event nobody listens for throws ERR_UNHANDLED_ERROR straight back out of
+                        // emit(). Counting listeners here would not see it: the PgBoss instance re-emits this
+                        // event, so the throw comes from an application with no `error` handler, one frame
+                        // further out than this emitter can measure. Reporting the failure matters less than
+                        // reaching the workers after this one, the pool close, and the `stopped` event.
+                    }
+                }
             }
             worker.abort();
         }
@@ -543,7 +837,15 @@ class Manager extends EventEmitter {
         if (this.stopped) {
             throw new Error('Workers are disabled. pg-boss is stopped');
         }
-        const { pollingInterval: interval, notifyPollingInterval: notifyInterval, burstWhenReadyExceeds, burstWhenBatchFull = false, batchSize = 1, includeMetadata = false, priority = true, localConcurrency = 1, localGroupConcurrency, groupConcurrency, orderByCreatedOn = true, heartbeatRefreshSeconds, minPriority, maxPriority, perJobResults = false, } = options;
+        const { pollingInterval: interval, notifyPollingInterval: notifyInterval, burstWhenReadyExceeds, burstWhenBatchFull = false, batchSize = 1, includeMetadata = false, priority = true, localConcurrency = 1, localGroupConcurrency, groupConcurrency, orderByCreatedOn = true, heartbeatRefreshSeconds, minPriority, maxPriority, perJobResults = false, transactional = false, transactionTimeoutSeconds, } = options;
+        // Capability check rather than a check for the built-in pool, so a db adapter that implements
+        // beginTransaction can serve transactional workers too. Asserted at work() time so the mistake
+        // surfaces on the call rather than on the first fetch.
+        if (transactional) {
+            assert(typeof this.db.beginTransaction === 'function', 'transactional workers require a database connection pg-boss can open a transaction on: the built-in pool, or a db adapter implementing beginTransaction');
+            await this.#assertTransactionalHeartbeatSupported(name);
+            this.#warnOnTransactionalPoolHeadroom(localConcurrency);
+        }
         if (localGroupConcurrency != null) {
             this.#storeLocalGroupConfig(name, localGroupConcurrency);
         }
@@ -588,7 +890,7 @@ class Manager extends EventEmitter {
                 const worker = this.workers.get(workerId);
                 // Skip all in-memory group tracking when localGroupConcurrency is not enabled
                 if (localGroupConcurrency == null) {
-                    await this.#processJobs(name, jobs, callback, worker, heartbeatRefreshSeconds, perJobResults);
+                    await this.#processJobs(name, jobs, callback, worker, heartbeatRefreshSeconds, perJobResults, transactional, transactionTimeoutSeconds);
                 }
                 else {
                     const { allowed, excess, groupedJobs } = this.#trackLocalGroupStart(name, jobs);
@@ -598,7 +900,7 @@ class Manager extends EventEmitter {
                             await this.restore(name, excessIds);
                         }
                         if (allowed.length > 0) {
-                            await this.#processJobs(name, allowed, callback, worker, heartbeatRefreshSeconds, perJobResults);
+                            await this.#processJobs(name, allowed, callback, worker, heartbeatRefreshSeconds, perJobResults, transactional, transactionTimeoutSeconds);
                         }
                     }
                     finally {
@@ -621,6 +923,58 @@ class Manager extends EventEmitter {
         }
         return firstWorkerId;
     }
+    /**
+     * Refuses a transactional worker on a queue that configures heartbeats, where the backend cannot
+     * carry both.
+     *
+     * `touch()` refreshes `heartbeat_on` on the claimed row from a pooled connection so the job stays
+     * visibly `active` while the handler runs. Under CockroachDB's serializable isolation that write
+     * lands above the handler transaction's timestamp and the completion pg-boss runs inside the
+     * transaction then cannot write the same row: `40001` WriteTooOldError, every batch. The
+     * transaction has already returned rows to the handler, so there is no read timestamp left to
+     * refresh and no retry to make in place.
+     *
+     * Neither half survives being dropped quietly. Skipping the refresh would leave `heartbeat_on`
+     * to go stale under a live handler, and `failJobsByHeartbeat` would reclaim exactly the
+     * long-running jobs heartbeats exist for, so the batch would roll back and retry forever with
+     * nothing in the output to say why. Rejecting at registration says it once, where the
+     * configuration is.
+     *
+     * Only queried on a backend that sets the flag, so `work()` stays off the database everywhere
+     * else. A per-job `heartbeatSeconds` can still override a queue that has none, which this call
+     * cannot see; #processJobs catches that from the batch itself.
+     */
+    async #assertTransactionalHeartbeatSupported(name) {
+        if (!this.config.noTransactionalHeartbeat)
+            return;
+        // A queue that does not exist yet cannot be read, and work() has never required one. The batch
+        // check is the backstop either way.
+        const queue = await this.getQueue(name).catch(() => null);
+        assert(!queue?.heartbeatSeconds, TRANSACTIONAL_HEARTBEAT_UNSUPPORTED);
+    }
+    // Each transactional handler in flight holds a pool connection for its own duration, so a pool
+    // sized at or below the number of them has nothing left for the fetches, the failures, or
+    // maintenance: those wait out connectionTimeoutMillis and then reject. Only measurable for the
+    // built-in pool, and a warning rather than an assert, because the ceiling is the operator's call.
+    //
+    // Emitted only, never persisted. The `warning` table records episodes, and every type in it is
+    // deduped by a flag that clears when the condition does. This one is an assertion about static
+    // configuration with no episode behind it: `max` is fixed for the life of the process, so every
+    // later transactional work() call trips it again with a larger `pinned`, and every restart writes
+    // the same rows once more. Persisting it would bury the warnings someone actually needs.
+    #warnOnTransactionalPoolHeadroom(localConcurrency) {
+        if (!this.db._pgbdb)
+            return;
+        const max = this.config.max ?? DEFAULT_POOL_MAX;
+        const running = [...this.workers.values()].filter(worker => worker.options.transactional).length;
+        const pinned = running + localConcurrency;
+        if (pinned < max)
+            return;
+        this.emit(events.warning, {
+            message: `transactional workers can hold ${pinned} of this pool's ${max} connections while their handlers run, leaving nothing for fetches, failures, or maintenance. Raise max above ${pinned}, or lower localConcurrency.`,
+            data: { type: WARNING_TYPES.TRANSACTIONAL_POOL_HEADROOM, max, transactionalWorkers: pinned }
+        });
+    }
     addWorker(worker) {
         this.workers.set(worker.id, worker);
     }
@@ -1175,7 +1529,11 @@ class Manager extends EventEmitter {
         return {
             jobs: ids,
             requested: ids.length,
-            affected: result && result.rows ? parseInt(result.rows[0].count) : 0
+            affected: result && result.rows ? parseInt(result.rows[0].count) : 0,
+            // The settle statements aggregate the ids they touched beside the count; the read-only
+            // mutators that share this mapper (resume, restore, retry, touch) do not, so it stays
+            // optional and #trackHandlerSettle falls back to the count when it is absent.
+            settled: result?.rows?.[0]?.ids
         };
     }
     async complete(name, id, data, options = {}) {
@@ -1184,14 +1542,19 @@ class Manager extends EventEmitter {
         const ids = this.mapCompletionIdArg(id, 'complete');
         const { table } = await this.getQueueCache(name);
         const outputData = this.mapCompletionDataArg(data);
+        let response;
         // noMultiMutationCte: split the dependency-unblocking into a separate statement to
         // avoid CockroachDB's multi-mutation CTE limitation (completeJobs updates two tables).
         if (this.config.noMultiMutationCte) {
-            return this.completeDistributed(name, ids, outputData, table, db, options.includeQueued);
+            response = await this.completeDistributed(name, ids, outputData, table, db, options.includeQueued);
         }
-        const sql = plans.completeJobs(this.config.schema, table, options.includeQueued);
-        const result = await db.executeSql(sql, [name, ids, outputData]);
-        return this.mapCommandResponse(ids, result);
+        else {
+            const sql = plans.completeJobs(this.config.schema, table, options.includeQueued);
+            const result = await db.executeSql(sql, [name, ids, outputData]);
+            response = this.mapCommandResponse(ids, result);
+        }
+        this.#trackHandlerSettle(options, response);
+        return response;
     }
     // Distributed complete/fail need several statements run atomically. When we own the pooled
     // connection we pin a single client via withTransaction(); when the caller supplied their own
@@ -1208,7 +1571,7 @@ class Manager extends EventEmitter {
         // completion is a single statement on every backend.
         const sql = plans.completeJobsDistributed(this.config.schema, table, includeQueued);
         const { rows } = await db.executeSql(sql, [name, ids, outputData]);
-        return { jobs: ids, requested: ids.length, affected: rows.length };
+        return { jobs: ids, requested: ids.length, affected: rows.length, settled: rows.map(row => row.id) };
     }
     async fail(name, id, data, options = {}) {
         Attorney.assertQueueName(name);
@@ -1216,15 +1579,20 @@ class Manager extends EventEmitter {
         const ids = this.mapCompletionIdArg(id, 'fail');
         const { table } = await this.getQueueCache(name);
         const outputData = this.mapCompletionDataArg(data);
+        let response;
         // noMultiMutationCte: use separate queries to avoid CockroachDB's multi-mutation CTE limitation.
         // The delete and re-insert run in a single transaction (see ensureTransaction) so the
         // job cannot be lost between the two statements.
         if (this.config.noMultiMutationCte) {
-            return this.failDistributed(name, ids, outputData, table, db);
+            response = await this.failDistributed(name, ids, outputData, table, db);
         }
-        const sql = plans.failJobsById(this.config.schema, table);
-        const result = await db.executeSql(sql, [name, ids, outputData]);
-        return this.mapCommandResponse(ids, result);
+        else {
+            const sql = plans.failJobsById(this.config.schema, table);
+            const result = await db.executeSql(sql, [name, ids, outputData]);
+            response = this.mapCommandResponse(ids, result);
+        }
+        this.#trackHandlerSettle(options, response);
+        return response;
     }
     async failDistributed(name, ids, outputData, table, db) {
         // CockroachDB doesn't support multi-mutation CTEs, but does support transactions, so the
@@ -1234,14 +1602,14 @@ class Manager extends EventEmitter {
             const selectQuery = plans.selectJobsToFailById(this.config.schema, table);
             const { rows: jobs } = await tx.executeSql(selectQuery.text, [name, ids]);
             if (jobs.length === 0) {
-                return { jobs: ids, requested: ids.length, affected: 0 };
+                return { jobs: ids, requested: ids.length, affected: 0, settled: [] };
             }
             // Step 2: Delete the jobs
             const deleteQuery = plans.deleteJobsToFail(this.config.schema, table);
             await tx.executeSql(deleteQuery.text, [name, ids]);
             // Step 3: Re-insert jobs with updated state
             const count = await this.reinsertFailedJobs(tx, table, jobs, outputData);
-            return { jobs: ids, requested: ids.length, affected: count };
+            return { jobs: ids, requested: ids.length, affected: count, settled: jobs.map(job => job.id) };
         });
     }
     // Distributed equivalents of the supervisor's failJobsByTimeout/failJobsByHeartbeat maintenance.
@@ -1371,7 +1739,9 @@ class Manager extends EventEmitter {
         const { table } = await this.getQueueCache(name);
         const sql = plans.deleteJobsById(this.config.schema, table);
         const result = await db.executeSql(sql, [name, ids]);
-        return this.mapCommandResponse(ids, result);
+        const response = this.mapCommandResponse(ids, result);
+        this.#trackHandlerSettle(options, response);
+        return response;
     }
     async redrive(name, options = {}) {
         Attorney.assertQueueName(name);
@@ -1396,7 +1766,9 @@ class Manager extends EventEmitter {
         const { table } = await this.getQueueCache(name);
         const sql = plans.cancelJobs(this.config.schema, table);
         const result = await db.executeSql(sql, [name, ids]);
-        return this.mapCommandResponse(ids, result);
+        const response = this.mapCommandResponse(ids, result);
+        this.#trackHandlerSettle(options, response);
+        return response;
     }
     async resume(name, id, options = {}) {
         Attorney.assertQueueName(name);

package/dist/plans.d.ts.map

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