velocious 1.0.754 → 1.0.755

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"background-jobs-worker.d.ts","sourceRoot":"","sources":["../../../../../../src/environment-handlers/node/cli/commands/background-jobs-worker.js"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,iCAAiC,CAAA;AAKtD,YAAkB,iCAAiC,GACnD;;;;IAAqG,IAAI,EAA9F,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,iCAAiC,CACnG;;;;IAAqG,cAAc,EAAxG,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,iCAAiC,CACrG;CAAA,CAAA;AAJD;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,wBAAsB,mCAAmC,CAAC,EAAC,OAAO,EAAE,aAAuB,EAAE,SAAS,EAAE,MAAM,EAAC,EAN5G;IAAyB,OAAO,EAAxB,MAAM,IAAI,CAClB;IAAiD,aAAa,AAA9D,CACA,EADQ,iCAAiC,CACzC;IAAsB,SAAS,AAA/B,CACA,EADQ,MAAM,CACd;IAAwI,MAAM,EAAtI;QAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAC,CACjI;CAE4G,GAFlG,OAAO,CAAC,IAAI,CAAC,CA4BzB;AA0BD,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,WAAW;IAC5D,OAAO,kBAiBZ;CACF"}
1
+ {"version":3,"file":"background-jobs-worker.d.ts","sourceRoot":"","sources":["../../../../../../src/environment-handlers/node/cli/commands/background-jobs-worker.js"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,iCAAiC,CAAA;AAKtD,YAAkB,iCAAiC,GACnD;;;;IAAqG,IAAI,EAA9F,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,iCAAiC,CACnG;;;;IAAqG,cAAc,EAAxG,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,iCAAiC,CACrG;CAAA,CAAA;AAJD;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,wBAAsB,mCAAmC,CAAC,EAAC,OAAO,EAAE,aAAuB,EAAE,SAAS,EAAE,MAAM,EAAC,EAN5G;IAAyB,OAAO,EAAxB,MAAM,IAAI,CAClB;IAAiD,aAAa,AAA9D,CACA,EADQ,iCAAiC,CACzC;IAAsB,SAAS,AAA/B,CACA,EADQ,MAAM,CACd;IAAwI,MAAM,EAAtI;QAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAC,CACjI;CAE4G,GAFlG,OAAO,CAAC,IAAI,CAAC,CA4BzB;AAED,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,WAAW;IAC5D,OAAO,kBAkBZ;CACF"}
@@ -41,27 +41,6 @@ export async function waitForBackgroundJobsWorkerShutdown({ onReady, processObje
41
41
  processObject.removeListener("SIGTERM", onSignal);
42
42
  }
43
43
  }
44
- /**
45
- * Resolves the shutdown drain timeout from
46
- * `VELOCIOUS_BACKGROUND_JOBS_WORKER_SHUTDOWN_TIMEOUT_MS`:
47
- * - unset / "indefinite" / "0" → indefinite: wait for in-flight jobs to
48
- * finish and never kill a process runner. This is the default so a graceful
49
- * stop (e.g. a deploy) does not interrupt long-running jobs such as builds.
50
- * - positive integer → that many milliseconds, after which any process runner
51
- * still in flight is terminated (SIGTERM, then SIGKILL) instead of orphaned.
52
- *
53
- * When a finite cap is used it must be shorter than the supervisor's
54
- * graceful-stop window so the worker reaps its own children before being
55
- * force-killed.
56
- * @returns {number | undefined} - Timeout in ms, or undefined for indefinite.
57
- */
58
- function resolveShutdownTimeoutMs() {
59
- const raw = (process.env.VELOCIOUS_BACKGROUND_JOBS_WORKER_SHUTDOWN_TIMEOUT_MS || "").trim().toLowerCase();
60
- if (!raw || raw === "indefinite" || raw === "0")
61
- return undefined;
62
- const parsed = Number.parseInt(raw, 10);
63
- return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
64
- }
65
44
  export default class BackgroundJobsWorkerCommand extends BaseCommand {
66
45
  async execute() {
67
46
  // Identify this process in `ps`/`top` instead of a generic "node" entry.
@@ -71,12 +50,14 @@ export default class BackgroundJobsWorkerCommand extends BaseCommand {
71
50
  configuration: this.getConfiguration(),
72
51
  generationId: typeof args.generation === "string" ? args.generation : undefined
73
52
  });
74
- const timeoutMs = resolveShutdownTimeoutMs();
53
+ // The drain cap comes from the worker's own configuration
54
+ // (`VELOCIOUS_BACKGROUND_JOBS_WORKER_SHUTDOWN_TIMEOUT_MS`), not from here:
55
+ // a deploy retires this generation through the main's `retire` message, so a
56
+ // bound resolved only by this command could never reach that drain.
75
57
  await waitForBackgroundJobsWorkerShutdown({
76
58
  onReady: () => console.log("Background jobs worker connected"),
77
- timeoutMs,
78
59
  worker
79
60
  });
80
61
  }
81
62
  }
82
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFja2dyb3VuZC1qb2JzLXdvcmtlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy9lbnZpcm9ubWVudC1oYW5kbGVycy9ub2RlL2NsaS9jb21tYW5kcy9iYWNrZ3JvdW5kLWpvYnMtd29ya2VyLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sV0FBVyxNQUFNLGlDQUFpQyxDQUFBO0FBQ3pELE9BQU8sb0JBQW9CLE1BQU0sdUNBQXVDLENBQUE7QUFDeEUsT0FBTyxnQkFBZ0IsTUFBTSxzQ0FBc0MsQ0FBQTtBQUVuRTs7OztHQUlHO0FBRUg7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLG1DQUFtQyxDQUFDLEVBQUMsT0FBTyxFQUFFLGFBQWEsR0FBRyxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBQztJQUM3Rzs7O09BR0c7SUFDSCxJQUFJLGFBQWEsR0FBRyxHQUFHLEVBQUUsR0FBRSxDQUFDLENBQUE7SUFDNUIsTUFBTSxNQUFNLEdBQUcsSUFBSSxPQUFPLENBQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRSxHQUFHLGFBQWEsR0FBRyxHQUFHLEVBQUUsQ0FBQyxPQUFPLENBQUMsU0FBUyxDQUFDLENBQUEsQ0FBQyxDQUFDLENBQUMsQ0FBQTtJQUNyRixNQUFNLFFBQVEsR0FBRyxHQUFHLEVBQUUsQ0FBQyxhQUFhLEVBQUUsQ0FBQTtJQUV0QyxhQUFhLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxRQUFRLENBQUMsQ0FBQTtJQUN0QyxhQUFhLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxRQUFRLENBQUMsQ0FBQTtJQUV2QyxJQUFJLENBQUM7UUFDSCxNQUFNLE1BQU0sQ0FBQyxLQUFLLEVBQUUsQ0FBQTtRQUNwQixPQUFPLEVBQUUsQ0FBQTtRQUNULE1BQU0sT0FBTyxHQUFHLE1BQU0sQ0FBQyxnQkFBZ0IsRUFBRSxDQUFBO1FBQ3pDLE1BQU0sYUFBYSxHQUFHLE1BQU0sT0FBTyxDQUFDLElBQUksQ0FBQztZQUN2QyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDLFFBQVEsQ0FBQztZQUMzQixPQUFPLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDLFNBQVMsQ0FBQztTQUM5QixDQUFDLENBQUE7UUFFRixJQUFJLGFBQWEsS0FBSyxRQUFRO1lBQUUsTUFBTSxNQUFNLENBQUMsSUFBSSxDQUFDLEVBQUMsU0FBUyxFQUFDLENBQUMsQ0FBQTtJQUNoRSxDQUFDO1lBQVMsQ0FBQztRQUNULGFBQWEsQ0FBQyxjQUFjLENBQUMsUUFBUSxFQUFFLFFBQVEsQ0FBQyxDQUFBO1FBQ2hELGFBQWEsQ0FBQyxjQUFjLENBQUMsU0FBUyxFQUFFLFFBQVEsQ0FBQyxDQUFBO0lBQ25ELENBQUM7QUFDSCxDQUFDO0FBRUQ7Ozs7Ozs7Ozs7Ozs7R0FhRztBQUNILFNBQVMsd0JBQXdCO0lBQy9CLE1BQU0sR0FBRyxHQUFHLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxvREFBb0QsSUFBSSxFQUFFLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxXQUFXLEVBQUUsQ0FBQTtJQUV6RyxJQUFJLENBQUMsR0FBRyxJQUFJLEdBQUcsS0FBSyxZQUFZLElBQUksR0FBRyxLQUFLLEdBQUc7UUFBRSxPQUFPLFNBQVMsQ0FBQTtJQUVqRSxNQUFNLE1BQU0sR0FBRyxNQUFNLENBQUMsUUFBUSxDQUFDLEdBQUcsRUFBRSxFQUFFLENBQUMsQ0FBQTtJQUV2QyxPQUFPLE1BQU0sQ0FBQyxTQUFTLENBQUMsTUFBTSxDQUFDLElBQUksTUFBTSxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUE7QUFDcEUsQ0FBQztBQUVELE1BQU0sQ0FBQyxPQUFPLE9BQU8sMkJBQTRCLFNBQVEsV0FBVztJQUNsRSxLQUFLLENBQUMsT0FBTztRQUNYLHlFQUF5RTtRQUN6RSxPQUFPLENBQUMsS0FBSyxHQUFHLGtDQUFrQyxDQUFBO1FBRWxELE1BQU0sSUFBSSxHQUFHLGdCQUFnQixDQUFDLEVBQUMsVUFBVSxFQUFFLEVBQUMsWUFBWSxFQUFFLENBQUMsY0FBYyxDQUFDLEVBQUMsRUFBRSxXQUFXLEVBQUUsSUFBSSxDQUFDLFdBQVcsSUFBSSxFQUFFLEVBQUMsQ0FBQyxDQUFBO1FBQ2xILE1BQU0sTUFBTSxHQUFHLElBQUksb0JBQW9CLENBQUM7WUFDdEMsYUFBYSxFQUFFLElBQUksQ0FBQyxnQkFBZ0IsRUFBRTtZQUN0QyxZQUFZLEVBQUUsT0FBTyxJQUFJLENBQUMsVUFBVSxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsU0FBUztTQUNoRixDQUFDLENBQUE7UUFFRixNQUFNLFNBQVMsR0FBRyx3QkFBd0IsRUFBRSxDQUFBO1FBRTVDLE1BQU0sbUNBQW1DLENBQUM7WUFDeEMsT0FBTyxFQUFFLEdBQUcsRUFBRSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsa0NBQWtDLENBQUM7WUFDOUQsU0FBUztZQUNULE1BQU07U0FDUCxDQUFDLENBQUE7SUFDSixDQUFDO0NBQ0YiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgQmFzZUNvbW1hbmQgZnJvbSBcIi4uLy4uLy4uLy4uL2NsaS9iYXNlLWNvbW1hbmQuanNcIlxuaW1wb3J0IEJhY2tncm91bmRKb2JzV29ya2VyIGZyb20gXCIuLi8uLi8uLi8uLi9iYWNrZ3JvdW5kLWpvYnMvd29ya2VyLmpzXCJcbmltcG9ydCBjb21tYW5kQXJndW1lbnRzIGZyb20gXCIuLi8uLi8uLi8uLi9jbGkvY29tbWFuZC1hcmd1bWVudHMuanNcIlxuXG4vKipcbiAqIEB0eXBlZGVmIHtvYmplY3R9IEJhY2tncm91bmRKb2JzV29ya2VyU2lnbmFsUHJvY2Vzc1xuICogQHByb3BlcnR5IHsoZXZlbnQ6IFwiU0lHSU5UXCIgfCBcIlNJR1RFUk1cIiwgbGlzdGVuZXI6ICgpID0+IHZvaWQpID0+IEJhY2tncm91bmRKb2JzV29ya2VyU2lnbmFsUHJvY2Vzc30gb25jZSAtIFJlZ2lzdGVycyBvbmUgc2lnbmFsIGxpc3RlbmVyLlxuICogQHByb3BlcnR5IHsoZXZlbnQ6IFwiU0lHSU5UXCIgfCBcIlNJR1RFUk1cIiwgbGlzdGVuZXI6ICgpID0+IHZvaWQpID0+IEJhY2tncm91bmRKb2JzV29ya2VyU2lnbmFsUHJvY2Vzc30gcmVtb3ZlTGlzdGVuZXIgLSBSZW1vdmVzIG9uZSBzaWduYWwgbGlzdGVuZXIuXG4gKi9cblxuLyoqXG4gKiBPd25zIHByb2Nlc3Mgc2lnbmFscyBiZWZvcmUgcHVibGlzaGluZyB3b3JrZXIgcmVhZGluZXNzLlxuICogQHBhcmFtIHtvYmplY3R9IGFyZ3MgLSBTaHV0ZG93biBvd25lcnNoaXAuXG4gKiBAcGFyYW0geygpID0+IHZvaWR9IGFyZ3Mub25SZWFkeSAtIFB1Ymxpc2hlcyByZWFkaW5lc3MgYWZ0ZXIgbGlzdGVuZXJzIGV4aXN0LlxuICogQHBhcmFtIHtCYWNrZ3JvdW5kSm9ic1dvcmtlclNpZ25hbFByb2Nlc3N9IFthcmdzLnByb2Nlc3NPYmplY3RdIC0gU2lnbmFsIGVtaXR0ZXIuXG4gKiBAcGFyYW0ge251bWJlcn0gW2FyZ3MudGltZW91dE1zXSAtIE9wdGlvbmFsIHdvcmtlciBkcmFpbiB0aW1lb3V0LlxuICogQHBhcmFtIHt7c3RhcnQ6ICgpID0+IFByb21pc2U8dm9pZD4sIHN0b3A6IChhcmdzPzoge3RpbWVvdXRNcz86IG51bWJlcn0pID0+IFByb21pc2U8dm9pZD4sIHdhaXRVbnRpbFN0b3BwZWQ6ICgpID0+IFByb21pc2U8dm9pZD59fSBhcmdzLndvcmtlciAtIFdvcmtlciBsaWZlY3ljbGUgb3duZXIuXG4gKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn0gLSBSZXNvbHZlcyBvbmNlIHRoZSB3b3JrZXIgc3RvcHMuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiB3YWl0Rm9yQmFja2dyb3VuZEpvYnNXb3JrZXJTaHV0ZG93bih7b25SZWFkeSwgcHJvY2Vzc09iamVjdCA9IHByb2Nlc3MsIHRpbWVvdXRNcywgd29ya2VyfSkge1xuICAvKipcbiAgICogUmVzb2x2ZXMgdGhlIHNpZ25hbCB3YWl0LlxuICAgKiBAdHlwZSB7KCkgPT4gdm9pZH1cbiAgICovXG4gIGxldCByZXNvbHZlU2lnbmFsID0gKCkgPT4ge31cbiAgY29uc3Qgc2lnbmFsID0gbmV3IFByb21pc2UoKHJlc29sdmUpID0+IHsgcmVzb2x2ZVNpZ25hbCA9ICgpID0+IHJlc29sdmUodW5kZWZpbmVkKSB9KVxuICBjb25zdCBvblNpZ25hbCA9ICgpID0+IHJlc29sdmVTaWduYWwoKVxuXG4gIHByb2Nlc3NPYmplY3Qub25jZShcIlNJR0lOVFwiLCBvblNpZ25hbClcbiAgcHJvY2Vzc09iamVjdC5vbmNlKFwiU0lHVEVSTVwiLCBvblNpZ25hbClcblxuICB0cnkge1xuICAgIGF3YWl0IHdvcmtlci5zdGFydCgpXG4gICAgb25SZWFkeSgpXG4gICAgY29uc3Qgc3RvcHBlZCA9IHdvcmtlci53YWl0VW50aWxTdG9wcGVkKClcbiAgICBjb25zdCBzaHV0ZG93bkNhdXNlID0gYXdhaXQgUHJvbWlzZS5yYWNlKFtcbiAgICAgIHNpZ25hbC50aGVuKCgpID0+IFwic2lnbmFsXCIpLFxuICAgICAgc3RvcHBlZC50aGVuKCgpID0+IFwic3RvcHBlZFwiKVxuICAgIF0pXG5cbiAgICBpZiAoc2h1dGRvd25DYXVzZSA9PT0gXCJzaWduYWxcIikgYXdhaXQgd29ya2VyLnN0b3Aoe3RpbWVvdXRNc30pXG4gIH0gZmluYWxseSB7XG4gICAgcHJvY2Vzc09iamVjdC5yZW1vdmVMaXN0ZW5lcihcIlNJR0lOVFwiLCBvblNpZ25hbClcbiAgICBwcm9jZXNzT2JqZWN0LnJlbW92ZUxpc3RlbmVyKFwiU0lHVEVSTVwiLCBvblNpZ25hbClcbiAgfVxufVxuXG4vKipcbiAqIFJlc29sdmVzIHRoZSBzaHV0ZG93biBkcmFpbiB0aW1lb3V0IGZyb21cbiAqIGBWRUxPQ0lPVVNfQkFDS0dST1VORF9KT0JTX1dPUktFUl9TSFVURE9XTl9USU1FT1VUX01TYDpcbiAqICAgLSB1bnNldCAvIFwiaW5kZWZpbml0ZVwiIC8gXCIwXCIg4oaSIGluZGVmaW5pdGU6IHdhaXQgZm9yIGluLWZsaWdodCBqb2JzIHRvXG4gKiAgICAgZmluaXNoIGFuZCBuZXZlciBraWxsIGEgcHJvY2VzcyBydW5uZXIuIFRoaXMgaXMgdGhlIGRlZmF1bHQgc28gYSBncmFjZWZ1bFxuICogICAgIHN0b3AgKGUuZy4gYSBkZXBsb3kpIGRvZXMgbm90IGludGVycnVwdCBsb25nLXJ1bm5pbmcgam9icyBzdWNoIGFzIGJ1aWxkcy5cbiAqICAgLSBwb3NpdGl2ZSBpbnRlZ2VyIOKGkiB0aGF0IG1hbnkgbWlsbGlzZWNvbmRzLCBhZnRlciB3aGljaCBhbnkgcHJvY2VzcyBydW5uZXJcbiAqICAgICBzdGlsbCBpbiBmbGlnaHQgaXMgdGVybWluYXRlZCAoU0lHVEVSTSwgdGhlbiBTSUdLSUxMKSBpbnN0ZWFkIG9mIG9ycGhhbmVkLlxuICpcbiAqIFdoZW4gYSBmaW5pdGUgY2FwIGlzIHVzZWQgaXQgbXVzdCBiZSBzaG9ydGVyIHRoYW4gdGhlIHN1cGVydmlzb3Inc1xuICogZ3JhY2VmdWwtc3RvcCB3aW5kb3cgc28gdGhlIHdvcmtlciByZWFwcyBpdHMgb3duIGNoaWxkcmVuIGJlZm9yZSBiZWluZ1xuICogZm9yY2Uta2lsbGVkLlxuICogQHJldHVybnMge251bWJlciB8IHVuZGVmaW5lZH0gLSBUaW1lb3V0IGluIG1zLCBvciB1bmRlZmluZWQgZm9yIGluZGVmaW5pdGUuXG4gKi9cbmZ1bmN0aW9uIHJlc29sdmVTaHV0ZG93blRpbWVvdXRNcygpIHtcbiAgY29uc3QgcmF3ID0gKHByb2Nlc3MuZW52LlZFTE9DSU9VU19CQUNLR1JPVU5EX0pPQlNfV09SS0VSX1NIVVRET1dOX1RJTUVPVVRfTVMgfHwgXCJcIikudHJpbSgpLnRvTG93ZXJDYXNlKClcblxuICBpZiAoIXJhdyB8fCByYXcgPT09IFwiaW5kZWZpbml0ZVwiIHx8IHJhdyA9PT0gXCIwXCIpIHJldHVybiB1bmRlZmluZWRcblxuICBjb25zdCBwYXJzZWQgPSBOdW1iZXIucGFyc2VJbnQocmF3LCAxMClcblxuICByZXR1cm4gTnVtYmVyLmlzSW50ZWdlcihwYXJzZWQpICYmIHBhcnNlZCA+IDAgPyBwYXJzZWQgOiB1bmRlZmluZWRcbn1cblxuZXhwb3J0IGRlZmF1bHQgY2xhc3MgQmFja2dyb3VuZEpvYnNXb3JrZXJDb21tYW5kIGV4dGVuZHMgQmFzZUNvbW1hbmQge1xuICBhc3luYyBleGVjdXRlKCkge1xuICAgIC8vIElkZW50aWZ5IHRoaXMgcHJvY2VzcyBpbiBgcHNgL2B0b3BgIGluc3RlYWQgb2YgYSBnZW5lcmljIFwibm9kZVwiIGVudHJ5LlxuICAgIHByb2Nlc3MudGl0bGUgPSBcInZlbG9jaW91cyBiYWNrZ3JvdW5kLWpvYnMtd29ya2VyXCJcblxuICAgIGNvbnN0IGFyZ3MgPSBjb21tYW5kQXJndW1lbnRzKHtkZWZpbml0aW9uOiB7dmFsdWVPcHRpb25zOiBbXCItLWdlbmVyYXRpb25cIl19LCBwcm9jZXNzQXJnczogdGhpcy5wcm9jZXNzQXJncyB8fCBbXX0pXG4gICAgY29uc3Qgd29ya2VyID0gbmV3IEJhY2tncm91bmRKb2JzV29ya2VyKHtcbiAgICAgIGNvbmZpZ3VyYXRpb246IHRoaXMuZ2V0Q29uZmlndXJhdGlvbigpLFxuICAgICAgZ2VuZXJhdGlvbklkOiB0eXBlb2YgYXJncy5nZW5lcmF0aW9uID09PSBcInN0cmluZ1wiID8gYXJncy5nZW5lcmF0aW9uIDogdW5kZWZpbmVkXG4gICAgfSlcblxuICAgIGNvbnN0IHRpbWVvdXRNcyA9IHJlc29sdmVTaHV0ZG93blRpbWVvdXRNcygpXG5cbiAgICBhd2FpdCB3YWl0Rm9yQmFja2dyb3VuZEpvYnNXb3JrZXJTaHV0ZG93bih7XG4gICAgICBvblJlYWR5OiAoKSA9PiBjb25zb2xlLmxvZyhcIkJhY2tncm91bmQgam9icyB3b3JrZXIgY29ubmVjdGVkXCIpLFxuICAgICAgdGltZW91dE1zLFxuICAgICAgd29ya2VyXG4gICAgfSlcbiAgfVxufVxuIl19
63
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFja2dyb3VuZC1qb2JzLXdvcmtlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy9lbnZpcm9ubWVudC1oYW5kbGVycy9ub2RlL2NsaS9jb21tYW5kcy9iYWNrZ3JvdW5kLWpvYnMtd29ya2VyLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sV0FBVyxNQUFNLGlDQUFpQyxDQUFBO0FBQ3pELE9BQU8sb0JBQW9CLE1BQU0sdUNBQXVDLENBQUE7QUFDeEUsT0FBTyxnQkFBZ0IsTUFBTSxzQ0FBc0MsQ0FBQTtBQUVuRTs7OztHQUlHO0FBRUg7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLG1DQUFtQyxDQUFDLEVBQUMsT0FBTyxFQUFFLGFBQWEsR0FBRyxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBQztJQUM3Rzs7O09BR0c7SUFDSCxJQUFJLGFBQWEsR0FBRyxHQUFHLEVBQUUsR0FBRSxDQUFDLENBQUE7SUFDNUIsTUFBTSxNQUFNLEdBQUcsSUFBSSxPQUFPLENBQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRSxHQUFHLGFBQWEsR0FBRyxHQUFHLEVBQUUsQ0FBQyxPQUFPLENBQUMsU0FBUyxDQUFDLENBQUEsQ0FBQyxDQUFDLENBQUMsQ0FBQTtJQUNyRixNQUFNLFFBQVEsR0FBRyxHQUFHLEVBQUUsQ0FBQyxhQUFhLEVBQUUsQ0FBQTtJQUV0QyxhQUFhLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxRQUFRLENBQUMsQ0FBQTtJQUN0QyxhQUFhLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxRQUFRLENBQUMsQ0FBQTtJQUV2QyxJQUFJLENBQUM7UUFDSCxNQUFNLE1BQU0sQ0FBQyxLQUFLLEVBQUUsQ0FBQTtRQUNwQixPQUFPLEVBQUUsQ0FBQTtRQUNULE1BQU0sT0FBTyxHQUFHLE1BQU0sQ0FBQyxnQkFBZ0IsRUFBRSxDQUFBO1FBQ3pDLE1BQU0sYUFBYSxHQUFHLE1BQU0sT0FBTyxDQUFDLElBQUksQ0FBQztZQUN2QyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDLFFBQVEsQ0FBQztZQUMzQixPQUFPLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDLFNBQVMsQ0FBQztTQUM5QixDQUFDLENBQUE7UUFFRixJQUFJLGFBQWEsS0FBSyxRQUFRO1lBQUUsTUFBTSxNQUFNLENBQUMsSUFBSSxDQUFDLEVBQUMsU0FBUyxFQUFDLENBQUMsQ0FBQTtJQUNoRSxDQUFDO1lBQVMsQ0FBQztRQUNULGFBQWEsQ0FBQyxjQUFjLENBQUMsUUFBUSxFQUFFLFFBQVEsQ0FBQyxDQUFBO1FBQ2hELGFBQWEsQ0FBQyxjQUFjLENBQUMsU0FBUyxFQUFFLFFBQVEsQ0FBQyxDQUFBO0lBQ25ELENBQUM7QUFDSCxDQUFDO0FBRUQsTUFBTSxDQUFDLE9BQU8sT0FBTywyQkFBNEIsU0FBUSxXQUFXO0lBQ2xFLEtBQUssQ0FBQyxPQUFPO1FBQ1gseUVBQXlFO1FBQ3pFLE9BQU8sQ0FBQyxLQUFLLEdBQUcsa0NBQWtDLENBQUE7UUFFbEQsTUFBTSxJQUFJLEdBQUcsZ0JBQWdCLENBQUMsRUFBQyxVQUFVLEVBQUUsRUFBQyxZQUFZLEVBQUUsQ0FBQyxjQUFjLENBQUMsRUFBQyxFQUFFLFdBQVcsRUFBRSxJQUFJLENBQUMsV0FBVyxJQUFJLEVBQUUsRUFBQyxDQUFDLENBQUE7UUFDbEgsTUFBTSxNQUFNLEdBQUcsSUFBSSxvQkFBb0IsQ0FBQztZQUN0QyxhQUFhLEVBQUUsSUFBSSxDQUFDLGdCQUFnQixFQUFFO1lBQ3RDLFlBQVksRUFBRSxPQUFPLElBQUksQ0FBQyxVQUFVLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQyxTQUFTO1NBQ2hGLENBQUMsQ0FBQTtRQUVGLDBEQUEwRDtRQUMxRCwyRUFBMkU7UUFDM0UsNkVBQTZFO1FBQzdFLG9FQUFvRTtRQUNwRSxNQUFNLG1DQUFtQyxDQUFDO1lBQ3hDLE9BQU8sRUFBRSxHQUFHLEVBQUUsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLGtDQUFrQyxDQUFDO1lBQzlELE1BQU07U0FDUCxDQUFDLENBQUE7SUFDSixDQUFDO0NBQ0YiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgQmFzZUNvbW1hbmQgZnJvbSBcIi4uLy4uLy4uLy4uL2NsaS9iYXNlLWNvbW1hbmQuanNcIlxuaW1wb3J0IEJhY2tncm91bmRKb2JzV29ya2VyIGZyb20gXCIuLi8uLi8uLi8uLi9iYWNrZ3JvdW5kLWpvYnMvd29ya2VyLmpzXCJcbmltcG9ydCBjb21tYW5kQXJndW1lbnRzIGZyb20gXCIuLi8uLi8uLi8uLi9jbGkvY29tbWFuZC1hcmd1bWVudHMuanNcIlxuXG4vKipcbiAqIEB0eXBlZGVmIHtvYmplY3R9IEJhY2tncm91bmRKb2JzV29ya2VyU2lnbmFsUHJvY2Vzc1xuICogQHByb3BlcnR5IHsoZXZlbnQ6IFwiU0lHSU5UXCIgfCBcIlNJR1RFUk1cIiwgbGlzdGVuZXI6ICgpID0+IHZvaWQpID0+IEJhY2tncm91bmRKb2JzV29ya2VyU2lnbmFsUHJvY2Vzc30gb25jZSAtIFJlZ2lzdGVycyBvbmUgc2lnbmFsIGxpc3RlbmVyLlxuICogQHByb3BlcnR5IHsoZXZlbnQ6IFwiU0lHSU5UXCIgfCBcIlNJR1RFUk1cIiwgbGlzdGVuZXI6ICgpID0+IHZvaWQpID0+IEJhY2tncm91bmRKb2JzV29ya2VyU2lnbmFsUHJvY2Vzc30gcmVtb3ZlTGlzdGVuZXIgLSBSZW1vdmVzIG9uZSBzaWduYWwgbGlzdGVuZXIuXG4gKi9cblxuLyoqXG4gKiBPd25zIHByb2Nlc3Mgc2lnbmFscyBiZWZvcmUgcHVibGlzaGluZyB3b3JrZXIgcmVhZGluZXNzLlxuICogQHBhcmFtIHtvYmplY3R9IGFyZ3MgLSBTaHV0ZG93biBvd25lcnNoaXAuXG4gKiBAcGFyYW0geygpID0+IHZvaWR9IGFyZ3Mub25SZWFkeSAtIFB1Ymxpc2hlcyByZWFkaW5lc3MgYWZ0ZXIgbGlzdGVuZXJzIGV4aXN0LlxuICogQHBhcmFtIHtCYWNrZ3JvdW5kSm9ic1dvcmtlclNpZ25hbFByb2Nlc3N9IFthcmdzLnByb2Nlc3NPYmplY3RdIC0gU2lnbmFsIGVtaXR0ZXIuXG4gKiBAcGFyYW0ge251bWJlcn0gW2FyZ3MudGltZW91dE1zXSAtIE9wdGlvbmFsIHdvcmtlciBkcmFpbiB0aW1lb3V0LlxuICogQHBhcmFtIHt7c3RhcnQ6ICgpID0+IFByb21pc2U8dm9pZD4sIHN0b3A6IChhcmdzPzoge3RpbWVvdXRNcz86IG51bWJlcn0pID0+IFByb21pc2U8dm9pZD4sIHdhaXRVbnRpbFN0b3BwZWQ6ICgpID0+IFByb21pc2U8dm9pZD59fSBhcmdzLndvcmtlciAtIFdvcmtlciBsaWZlY3ljbGUgb3duZXIuXG4gKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn0gLSBSZXNvbHZlcyBvbmNlIHRoZSB3b3JrZXIgc3RvcHMuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiB3YWl0Rm9yQmFja2dyb3VuZEpvYnNXb3JrZXJTaHV0ZG93bih7b25SZWFkeSwgcHJvY2Vzc09iamVjdCA9IHByb2Nlc3MsIHRpbWVvdXRNcywgd29ya2VyfSkge1xuICAvKipcbiAgICogUmVzb2x2ZXMgdGhlIHNpZ25hbCB3YWl0LlxuICAgKiBAdHlwZSB7KCkgPT4gdm9pZH1cbiAgICovXG4gIGxldCByZXNvbHZlU2lnbmFsID0gKCkgPT4ge31cbiAgY29uc3Qgc2lnbmFsID0gbmV3IFByb21pc2UoKHJlc29sdmUpID0+IHsgcmVzb2x2ZVNpZ25hbCA9ICgpID0+IHJlc29sdmUodW5kZWZpbmVkKSB9KVxuICBjb25zdCBvblNpZ25hbCA9ICgpID0+IHJlc29sdmVTaWduYWwoKVxuXG4gIHByb2Nlc3NPYmplY3Qub25jZShcIlNJR0lOVFwiLCBvblNpZ25hbClcbiAgcHJvY2Vzc09iamVjdC5vbmNlKFwiU0lHVEVSTVwiLCBvblNpZ25hbClcblxuICB0cnkge1xuICAgIGF3YWl0IHdvcmtlci5zdGFydCgpXG4gICAgb25SZWFkeSgpXG4gICAgY29uc3Qgc3RvcHBlZCA9IHdvcmtlci53YWl0VW50aWxTdG9wcGVkKClcbiAgICBjb25zdCBzaHV0ZG93bkNhdXNlID0gYXdhaXQgUHJvbWlzZS5yYWNlKFtcbiAgICAgIHNpZ25hbC50aGVuKCgpID0+IFwic2lnbmFsXCIpLFxuICAgICAgc3RvcHBlZC50aGVuKCgpID0+IFwic3RvcHBlZFwiKVxuICAgIF0pXG5cbiAgICBpZiAoc2h1dGRvd25DYXVzZSA9PT0gXCJzaWduYWxcIikgYXdhaXQgd29ya2VyLnN0b3Aoe3RpbWVvdXRNc30pXG4gIH0gZmluYWxseSB7XG4gICAgcHJvY2Vzc09iamVjdC5yZW1vdmVMaXN0ZW5lcihcIlNJR0lOVFwiLCBvblNpZ25hbClcbiAgICBwcm9jZXNzT2JqZWN0LnJlbW92ZUxpc3RlbmVyKFwiU0lHVEVSTVwiLCBvblNpZ25hbClcbiAgfVxufVxuXG5leHBvcnQgZGVmYXVsdCBjbGFzcyBCYWNrZ3JvdW5kSm9ic1dvcmtlckNvbW1hbmQgZXh0ZW5kcyBCYXNlQ29tbWFuZCB7XG4gIGFzeW5jIGV4ZWN1dGUoKSB7XG4gICAgLy8gSWRlbnRpZnkgdGhpcyBwcm9jZXNzIGluIGBwc2AvYHRvcGAgaW5zdGVhZCBvZiBhIGdlbmVyaWMgXCJub2RlXCIgZW50cnkuXG4gICAgcHJvY2Vzcy50aXRsZSA9IFwidmVsb2Npb3VzIGJhY2tncm91bmQtam9icy13b3JrZXJcIlxuXG4gICAgY29uc3QgYXJncyA9IGNvbW1hbmRBcmd1bWVudHMoe2RlZmluaXRpb246IHt2YWx1ZU9wdGlvbnM6IFtcIi0tZ2VuZXJhdGlvblwiXX0sIHByb2Nlc3NBcmdzOiB0aGlzLnByb2Nlc3NBcmdzIHx8IFtdfSlcbiAgICBjb25zdCB3b3JrZXIgPSBuZXcgQmFja2dyb3VuZEpvYnNXb3JrZXIoe1xuICAgICAgY29uZmlndXJhdGlvbjogdGhpcy5nZXRDb25maWd1cmF0aW9uKCksXG4gICAgICBnZW5lcmF0aW9uSWQ6IHR5cGVvZiBhcmdzLmdlbmVyYXRpb24gPT09IFwic3RyaW5nXCIgPyBhcmdzLmdlbmVyYXRpb24gOiB1bmRlZmluZWRcbiAgICB9KVxuXG4gICAgLy8gVGhlIGRyYWluIGNhcCBjb21lcyBmcm9tIHRoZSB3b3JrZXIncyBvd24gY29uZmlndXJhdGlvblxuICAgIC8vIChgVkVMT0NJT1VTX0JBQ0tHUk9VTkRfSk9CU19XT1JLRVJfU0hVVERPV05fVElNRU9VVF9NU2ApLCBub3QgZnJvbSBoZXJlOlxuICAgIC8vIGEgZGVwbG95IHJldGlyZXMgdGhpcyBnZW5lcmF0aW9uIHRocm91Z2ggdGhlIG1haW4ncyBgcmV0aXJlYCBtZXNzYWdlLCBzbyBhXG4gICAgLy8gYm91bmQgcmVzb2x2ZWQgb25seSBieSB0aGlzIGNvbW1hbmQgY291bGQgbmV2ZXIgcmVhY2ggdGhhdCBkcmFpbi5cbiAgICBhd2FpdCB3YWl0Rm9yQmFja2dyb3VuZEpvYnNXb3JrZXJTaHV0ZG93bih7XG4gICAgICBvblJlYWR5OiAoKSA9PiBjb25zb2xlLmxvZyhcIkJhY2tncm91bmQgam9icyB3b3JrZXIgY29ubmVjdGVkXCIpLFxuICAgICAgd29ya2VyXG4gICAgfSlcbiAgfVxufVxuIl19
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "velocious": "build/bin/velocious.js"
4
4
  },
5
5
  "name": "velocious",
6
- "version": "1.0.754",
6
+ "version": "1.0.755",
7
7
  "main": "build/index.js",
8
8
  "types": "build/index.d.ts",
9
9
  "files": [
@@ -261,6 +261,7 @@ export default class BackgroundJobsWorker {
261
261
  * @param {number} [args.generationHandshakeTimeoutMs] - Maximum time to wait for generation acknowledgement (default: 4000).
262
262
  * @param {number} [args.reconnectDelayMs] - Delay before reconnecting an established worker connection (default: 1000).
263
263
  * @param {number} [args.jobTimeoutMs] - Override the wall-clock timeout for forked and pooled jobs from `configuration.getBackgroundJobsConfig()`. `0` disables it.
264
+ * @param {number | null} [args.workerShutdownTimeoutMs] - Override the wall-clock cap on one whole shutdown drain from `configuration.getBackgroundJobsConfig().workerShutdownTimeoutMs`. `null` drains without a bound.
264
265
  * @param {number} [args.pooledRunnerSilenceTimeoutMs] - Override the per-child IPC-silence bound for pooled children with in-flight jobs from `configuration.getBackgroundJobsConfig()` (default 120000ms). `0` disables the watchdog.
265
266
  * @param {boolean} [args.closeDatabaseConnectionsOnStop] - Whether stop owns closing the configuration's database pools (default true).
266
267
  * @param {() => void | Promise<void>} [args.onStopped] - Lifecycle hook invoked after the worker finishes stopping.
@@ -269,7 +270,7 @@ export default class BackgroundJobsWorker {
269
270
  * @param {(observation: import("./types.js").PooledChildMemoryObservation) => void | Promise<void>} [args.onPooledRunnerMemoryObservation] - Explicit pooled-child memory observation hook. Every validated observation (periodic while a child has in-flight jobs, plus on demand) is forwarded here, in addition to the worker's compact stderr log line, so an application can route memory diagnostics (e.g. to a bug reporter) without parsing logs.
270
271
  * @param {(payload: import("./types.js").BackgroundJobPayload) => void} [args.onJobAccepted] - Explicit job-acceptance observation hook. Fires the moment the worker accepts a dispatched job payload, before execution mode routing, so an observer can wait for the pickup event instead of polling in-flight sets.
271
272
  */
272
- constructor({configuration, host, port, generationId, workerInstanceId, maxConcurrentForkedJobs, maxConcurrentInlineJobs, pooledRunnerCount, pooledRunnerConcurrency, pooledRunnerMaxJobs, pooledRunnerMaxRssBytes, pooledRunnerMaxLifetimeMs, runnerMaxOldSpaceSizeMb, runnerMallocArenaMax, forkedChildSigkillGraceMs, heartbeatIntervalMs, generationHandshakeTimeoutMs = DEFAULT_GENERATION_HANDSHAKE_TIMEOUT_MS, reconnectDelayMs = 1000, jobTimeoutMs, pooledRunnerSilenceTimeoutMs, closeDatabaseConnectionsOnStop = true, onStopped, onGenerationAccepted, onRetireMessage, onPooledRunnerMemoryObservation, onJobAccepted} = {}) {
273
+ constructor({configuration, host, port, generationId, workerInstanceId, maxConcurrentForkedJobs, maxConcurrentInlineJobs, pooledRunnerCount, pooledRunnerConcurrency, pooledRunnerMaxJobs, pooledRunnerMaxRssBytes, pooledRunnerMaxLifetimeMs, runnerMaxOldSpaceSizeMb, runnerMallocArenaMax, forkedChildSigkillGraceMs, heartbeatIntervalMs, generationHandshakeTimeoutMs = DEFAULT_GENERATION_HANDSHAKE_TIMEOUT_MS, reconnectDelayMs = 1000, jobTimeoutMs, workerShutdownTimeoutMs, pooledRunnerSilenceTimeoutMs, closeDatabaseConnectionsOnStop = true, onStopped, onGenerationAccepted, onRetireMessage, onPooledRunnerMemoryObservation, onJobAccepted} = {}) {
273
274
  /**
274
275
  * Narrows the runtime value to the documented type.
275
276
  * @type {Promise<import("../configuration.js").default>} */
@@ -347,6 +348,20 @@ export default class BackgroundJobsWorker {
347
348
  * @type {number | undefined}
348
349
  */
349
350
  this.jobTimeoutMsOverride = typeof jobTimeoutMs === "number" ? jobTimeoutMs : undefined
351
+ /**
352
+ * Wall-clock cap on one whole shutdown drain, in ms, or `null` to drain
353
+ * without a bound. Constructor override wins; otherwise it is read from
354
+ * `configuration.getBackgroundJobsConfig().workerShutdownTimeoutMs` in
355
+ * `start()`. It bounds the generation-retirement drain as well as a SIGTERM
356
+ * stop, because a retired worker is the process that a deploy cannot wait on
357
+ * and must not have to wait on forever.
358
+ * @type {number | null | undefined}
359
+ */
360
+ this.workerShutdownTimeoutMsOverride = workerShutdownTimeoutMs === undefined
361
+ ? undefined
362
+ : (typeof workerShutdownTimeoutMs === "number" && Number.isInteger(workerShutdownTimeoutMs) && workerShutdownTimeoutMs > 0 ? workerShutdownTimeoutMs : null)
363
+ /** @type {number | null} */
364
+ this.workerShutdownTimeoutMs = this.workerShutdownTimeoutMsOverride ?? null
350
365
  this.shouldStop = false
351
366
  this.isRetiring = false
352
367
  /** @type {Promise<void> | undefined} */
@@ -509,6 +524,7 @@ export default class BackgroundJobsWorker {
509
524
  if (typeof this.pooledRunnerSilenceTimeoutMsOverride !== "number" && typeof poolConfig.pooledRunnerSilenceTimeoutMs === "number") this.pooledRunnerSilenceTimeoutMs = poolConfig.pooledRunnerSilenceTimeoutMs
510
525
  if (typeof this.runnerMaxOldSpaceSizeMbOverride !== "number" && typeof poolConfig.runnerMaxOldSpaceSizeMb === "number") this.runnerMaxOldSpaceSizeMb = poolConfig.runnerMaxOldSpaceSizeMb
511
526
  if (typeof this.runnerMallocArenaMaxOverride !== "number" && typeof poolConfig.runnerMallocArenaMax === "number") this.runnerMallocArenaMax = poolConfig.runnerMallocArenaMax
527
+ if (this.workerShutdownTimeoutMsOverride === undefined) this.workerShutdownTimeoutMs = poolConfig.workerShutdownTimeoutMs ?? null
512
528
 
513
529
  this.statusReporter = new BackgroundJobsStatusReporter({
514
530
  configuration: this.configuration,
@@ -586,10 +602,11 @@ export default class BackgroundJobsWorker {
586
602
  /**
587
603
  * Runs the worker shutdown lifecycle once.
588
604
  * @param {object} [args] - Options.
589
- * @param {number} [args.timeoutMs] - Max wait for in-flight jobs (per phase) in ms.
605
+ * @param {number} [args.timeoutMs] - Max wait for in-flight jobs (per phase) in ms. Defaults to the configured `workerShutdownTimeoutMs`.
590
606
  * @returns {Promise<void>} - Resolves when stopped.
591
607
  */
592
608
  async _stop({timeoutMs} = {}) {
609
+ const drainTimeoutMs = typeof timeoutMs === "number" ? timeoutMs : (this.workerShutdownTimeoutMs ?? undefined)
593
610
  this.shouldStop = true
594
611
  this.isRetiring = true
595
612
  this._stopHeartbeat()
@@ -611,14 +628,14 @@ export default class BackgroundJobsWorker {
611
628
  }
612
629
  }
613
630
 
614
- await this._drainInflight(this.inflightInlineJobs, timeoutMs, {phase: "inline-jobs"})
615
- await this._drainInflight(this.inflightPooledJobs, timeoutMs, {phase: "pooled-jobs"})
631
+ await this._drainInflight(this.inflightInlineJobs, drainTimeoutMs, {phase: "inline-jobs"})
632
+ await this._drainInflight(this.inflightPooledJobs, drainTimeoutMs, {phase: "pooled-jobs"})
616
633
  this._releaseProcessJobHoldersWithGoneChildren()
617
- await this._drainInflight(this.inflightProcessJobs, timeoutMs, {phase: "process-jobs", describeHolders: () => this._describeProcessJobHolders()})
634
+ await this._drainInflight(this.inflightProcessJobs, drainTimeoutMs, {phase: "process-jobs", describeHolders: () => this._describeProcessJobHolders()})
618
635
  await this._terminateProcessChildren()
619
636
  // Give in-flight result reports (now decoupled from job slots) a bounded
620
637
  // chance to land before the socket closes.
621
- await this._drainInflight(this.inflightReports, timeoutMs)
638
+ await this._drainInflight(this.inflightReports, drainTimeoutMs)
622
639
 
623
640
  if (this.jsonSocket) this.jsonSocket.close()
624
641
  if (!this.configuration) return
@@ -646,6 +663,12 @@ export default class BackgroundJobsWorker {
646
663
  /**
647
664
  * Drains accepted generation work while retaining the exact connection and
648
665
  * heartbeat, then performs the final terminating stop.
666
+ *
667
+ * The drain is bounded by the worker's own configured cap, as one deadline
668
+ * shared across every phase rather than one per phase: this is the path a
669
+ * deploy retires a generation through, and the supervisor's retirement budget
670
+ * is deliberately only slightly longer than the cap, so four separate windows
671
+ * would overrun it and hand the wedge straight back to the release.
649
672
  * @returns {Promise<void>} - Resolves after the worker has fully closed.
650
673
  */
651
674
  async _stopAfterGenerationDrain() {
@@ -657,11 +680,15 @@ export default class BackgroundJobsWorker {
657
680
  }
658
681
  }
659
682
 
660
- await this._drainInflight(this.inflightInlineJobs)
661
- await this._drainInflight(this.inflightPooledJobs)
683
+ const deadlineMs = typeof this.workerShutdownTimeoutMs === "number"
684
+ ? Date.now() + this.workerShutdownTimeoutMs
685
+ : undefined
686
+
687
+ await this._drainInflight(this.inflightInlineJobs, this._remainingDrainMs(deadlineMs), {phase: "inline-jobs"})
688
+ await this._drainInflight(this.inflightPooledJobs, this._remainingDrainMs(deadlineMs), {phase: "pooled-jobs"})
662
689
  this._releaseProcessJobHoldersWithGoneChildren()
663
- await this._drainInflight(this.inflightProcessJobs)
664
- await this._drainInflight(this.inflightReports)
690
+ await this._drainInflight(this.inflightProcessJobs, this._remainingDrainMs(deadlineMs), {phase: "process-jobs", describeHolders: () => this._describeProcessJobHolders()})
691
+ await this._drainInflight(this.inflightReports, this._remainingDrainMs(deadlineMs), {phase: "reports"})
665
692
 
666
693
  this.shouldStop = true
667
694
  this._stopHeartbeat()
@@ -682,6 +709,19 @@ export default class BackgroundJobsWorker {
682
709
  })
683
710
  }
684
711
 
712
+ /**
713
+ * Time left inside one shared drain deadline, or `undefined` for an unbounded
714
+ * drain. A deadline that has already passed yields `0`, which lets each later
715
+ * phase report what it is still holding instead of silently waiting.
716
+ * @param {number | undefined} deadlineMs - Absolute deadline, or undefined when unbounded.
717
+ * @returns {number | undefined} - Remaining milliseconds, or undefined for no bound.
718
+ */
719
+ _remainingDrainMs(deadlineMs) {
720
+ if (typeof deadlineMs !== "number") return undefined
721
+
722
+ return Math.max(0, deadlineMs - Date.now())
723
+ }
724
+
685
725
  /**
686
726
  * Closes application resources before framework resources when this worker owns them.
687
727
  * @returns {Promise<void>} - Resolves after every owned close succeeds.
@@ -274,6 +274,14 @@
274
274
  * tuning: set it well above the longest legitimate forked job (build runners,
275
275
  * long imports) so only genuinely-stuck runners are killed. Omit, `null`, or
276
276
  * `<= 0` to disable (default), which preserves the prior unbounded behavior.
277
+ * @property {number | null} [workerShutdownTimeoutMs] - Wall-clock cap, in ms, on
278
+ * one worker's whole shutdown drain, read from `VELOCIOUS_BACKGROUND_JOBS_WORKER_SHUTDOWN_TIMEOUT_MS`
279
+ * when the config omits it. It bounds the generation-retirement drain too, not
280
+ * only a SIGTERM stop: after the cap, whatever is still held is named in a
281
+ * `worker-shutdown-drain-timeout` event and the runner children are terminated
282
+ * (SIGTERM, then SIGKILL), so a retired generation closes itself instead of
283
+ * pinning its release. Omit, `null`, `0`, or the literal `"indefinite"` to drain
284
+ * without a bound (default), which keeps a live multi-hour job protected.
277
285
  * @property {BackgroundJobsRetentionConfiguration} [retention] - Retention/pruning
278
286
  * of terminal job rows. Without pruning the jobs table grows unbounded
279
287
  * (completed rows accumulate forever), which bloats storage and indexes and
@@ -140,6 +140,29 @@ function resolveBeaconUnreachableReportMs(value) {
140
140
  return 30_000
141
141
  }
142
142
 
143
+ /**
144
+ * Resolves the background-jobs worker's own drain cap from a raw configured value.
145
+ * `null` means "drain without a bound and never reap a live runner", which is what a
146
+ * multi-hour build needs; a positive integer is a deadline after which a runner still
147
+ * in flight is terminated instead of orphaned. The literal strings `indefinite` and
148
+ * `0` are the documented opt-out spellings — the production Rollbridge config writes
149
+ * `indefinite` — so they must not be parsed as numbers.
150
+ * @param {unknown} value - Configured value or raw environment value.
151
+ * @returns {number | null} - Milliseconds, or null for an unbounded drain.
152
+ */
153
+ function resolveWorkerShutdownTimeoutMs(value) {
154
+ if (value === null || value === undefined) return null
155
+
156
+ const normalized = typeof value === "string" ? value.trim().toLowerCase() : value
157
+
158
+ if (normalized === "" || normalized === "indefinite" || normalized === "0" || normalized === 0) return null
159
+ if (typeof normalized !== "string" && typeof normalized !== "number") return null
160
+
161
+ const parsed = Number(normalized)
162
+
163
+ return Number.isInteger(parsed) && parsed > 0 ? parsed : null
164
+ }
165
+
143
166
  const DEFAULT_WEBSOCKET_INBOUND_MAX_PENDING_BYTES = 16 * 1024 * 1024
144
167
  const DEFAULT_WEBSOCKET_INBOUND_MAX_PENDING_MESSAGES = 256
145
168
  const DEFAULT_WEBSOCKET_OUTBOUND_MAX_PENDING_BYTES = 16 * 1024 * 1024
@@ -1891,6 +1914,7 @@ export default class VelociousConfiguration {
1891
1914
  const envDispatchStrategy = processEnvironment?.VELOCIOUS_BACKGROUND_JOBS_DISPATCH_STRATEGY
1892
1915
  const envPollIntervalRaw = processEnvironment?.VELOCIOUS_BACKGROUND_JOBS_POLL_INTERVAL_MS
1893
1916
  const envJobTimeoutRaw = processEnvironment?.VELOCIOUS_BACKGROUND_JOBS_JOB_TIMEOUT_MS
1917
+ const envWorkerShutdownTimeoutRaw = processEnvironment?.VELOCIOUS_BACKGROUND_JOBS_WORKER_SHUTDOWN_TIMEOUT_MS
1894
1918
  const envPort = envPortRaw ? Number(envPortRaw) : undefined
1895
1919
  const envMaxConcurrentForked = envMaxConcurrentForkedRaw ? Number(envMaxConcurrentForkedRaw) : undefined
1896
1920
  const envMaxConcurrent = envMaxConcurrentRaw ? Number(envMaxConcurrentRaw) : undefined
@@ -1987,6 +2011,13 @@ export default class VelociousConfiguration {
1987
2011
  const jobTimeoutMs = "jobTimeoutMs" in configured
1988
2012
  ? (typeof configured.jobTimeoutMs === "number" && configured.jobTimeoutMs > 0 ? configured.jobTimeoutMs : null)
1989
2013
  : (typeof envJobTimeout === "number" && Number.isFinite(envJobTimeout) && envJobTimeout > 0 ? envJobTimeout : null)
2014
+ // The worker's own drain cap, read here so every shutdown path shares one
2015
+ // bound. `jobTimeoutMs` bounds one job; this bounds the whole retirement
2016
+ // drain, and it is the only thing that can end a drain whose remaining
2017
+ // work can no longer report its outcome.
2018
+ const workerShutdownTimeoutMs = "workerShutdownTimeoutMs" in configured
2019
+ ? resolveWorkerShutdownTimeoutMs(configured.workerShutdownTimeoutMs)
2020
+ : resolveWorkerShutdownTimeoutMs(envWorkerShutdownTimeoutRaw)
1990
2021
  const configuredRetention = configured.retention && typeof configured.retention === "object" ? configured.retention : {}
1991
2022
  const retention = {
1992
2023
  completedTtlMs: typeof configuredRetention.completedTtlMs === "number" || configuredRetention.completedTtlMs === null
@@ -2019,7 +2050,7 @@ export default class VelociousConfiguration {
2019
2050
  const jobClasses = this.getBackgroundJobClasses()
2020
2051
 
2021
2052
  const endpointPath = typeof configured.endpointPath === "string" ? configured.endpointPath : envEndpointPath
2022
- return {host, port, endpointPath, databaseIdentifier, maxConcurrentForkedJobs, maxConcurrentInlineJobs, mode, pooledRunnerCount, pooledRunnerConcurrency, pooledRunnerMaxJobs, pooledRunnerMaxRssBytes, pooledRunnerMaxLifetimeMs, pooledRunnerSilenceTimeoutMs, runnerMaxOldSpaceSizeMb, runnerMallocArenaMax, dispatchStrategy, pollIntervalMs, drainStoreOperationTimeoutMs, scheduledEnqueueTimeoutMs, queues, queuePriorityAgingUnitMs, jobClasses, jobTimeoutMs, retention, generationId, initialGenerationState, lifecycleSocketPath}
2053
+ return {host, port, endpointPath, databaseIdentifier, maxConcurrentForkedJobs, maxConcurrentInlineJobs, mode, pooledRunnerCount, pooledRunnerConcurrency, pooledRunnerMaxJobs, pooledRunnerMaxRssBytes, pooledRunnerMaxLifetimeMs, pooledRunnerSilenceTimeoutMs, runnerMaxOldSpaceSizeMb, runnerMallocArenaMax, dispatchStrategy, pollIntervalMs, drainStoreOperationTimeoutMs, scheduledEnqueueTimeoutMs, queues, queuePriorityAgingUnitMs, jobClasses, jobTimeoutMs, workerShutdownTimeoutMs, retention, generationId, initialGenerationState, lifecycleSocketPath}
2023
2054
  }
2024
2055
 
2025
2056
  /**
@@ -45,30 +45,6 @@ export async function waitForBackgroundJobsWorkerShutdown({onReady, processObjec
45
45
  }
46
46
  }
47
47
 
48
- /**
49
- * Resolves the shutdown drain timeout from
50
- * `VELOCIOUS_BACKGROUND_JOBS_WORKER_SHUTDOWN_TIMEOUT_MS`:
51
- * - unset / "indefinite" / "0" → indefinite: wait for in-flight jobs to
52
- * finish and never kill a process runner. This is the default so a graceful
53
- * stop (e.g. a deploy) does not interrupt long-running jobs such as builds.
54
- * - positive integer → that many milliseconds, after which any process runner
55
- * still in flight is terminated (SIGTERM, then SIGKILL) instead of orphaned.
56
- *
57
- * When a finite cap is used it must be shorter than the supervisor's
58
- * graceful-stop window so the worker reaps its own children before being
59
- * force-killed.
60
- * @returns {number | undefined} - Timeout in ms, or undefined for indefinite.
61
- */
62
- function resolveShutdownTimeoutMs() {
63
- const raw = (process.env.VELOCIOUS_BACKGROUND_JOBS_WORKER_SHUTDOWN_TIMEOUT_MS || "").trim().toLowerCase()
64
-
65
- if (!raw || raw === "indefinite" || raw === "0") return undefined
66
-
67
- const parsed = Number.parseInt(raw, 10)
68
-
69
- return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined
70
- }
71
-
72
48
  export default class BackgroundJobsWorkerCommand extends BaseCommand {
73
49
  async execute() {
74
50
  // Identify this process in `ps`/`top` instead of a generic "node" entry.
@@ -80,11 +56,12 @@ export default class BackgroundJobsWorkerCommand extends BaseCommand {
80
56
  generationId: typeof args.generation === "string" ? args.generation : undefined
81
57
  })
82
58
 
83
- const timeoutMs = resolveShutdownTimeoutMs()
84
-
59
+ // The drain cap comes from the worker's own configuration
60
+ // (`VELOCIOUS_BACKGROUND_JOBS_WORKER_SHUTDOWN_TIMEOUT_MS`), not from here:
61
+ // a deploy retires this generation through the main's `retire` message, so a
62
+ // bound resolved only by this command could never reach that drain.
85
63
  await waitForBackgroundJobsWorkerShutdown({
86
64
  onReady: () => console.log("Background jobs worker connected"),
87
- timeoutMs,
88
65
  worker
89
66
  })
90
67
  }