@dbos-inc/dbos-sdk 4.28.8-preview → 4.28.12-preview

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.
Files changed (50) hide show
  1. package/README.md +20 -7
  2. package/dist/schemas/system_db_schema.d.ts +0 -8
  3. package/dist/schemas/system_db_schema.d.ts.map +1 -1
  4. package/dist/schemas/system_db_schema.js.map +1 -1
  5. package/dist/src/adminserver.d.ts.map +1 -1
  6. package/dist/src/adminserver.js +5 -19
  7. package/dist/src/adminserver.js.map +1 -1
  8. package/dist/src/client.js +4 -4
  9. package/dist/src/client.js.map +1 -1
  10. package/dist/src/conductor/conductor.js +2 -2
  11. package/dist/src/conductor/conductor.js.map +1 -1
  12. package/dist/src/conductor/protocol.d.ts +1 -0
  13. package/dist/src/conductor/protocol.d.ts.map +1 -1
  14. package/dist/src/conductor/protocol.js.map +1 -1
  15. package/dist/src/dbos-executor.d.ts +5 -36
  16. package/dist/src/dbos-executor.d.ts.map +1 -1
  17. package/dist/src/dbos-executor.js +0 -24
  18. package/dist/src/dbos-executor.js.map +1 -1
  19. package/dist/src/dbos.d.ts +1 -40
  20. package/dist/src/dbos.d.ts.map +1 -1
  21. package/dist/src/dbos.js +11 -89
  22. package/dist/src/dbos.js.map +1 -1
  23. package/dist/src/eventreceiver.d.ts +5 -11
  24. package/dist/src/eventreceiver.d.ts.map +1 -1
  25. package/dist/src/eventreceiver.js +11 -18
  26. package/dist/src/eventreceiver.js.map +1 -1
  27. package/dist/src/index.d.ts +2 -3
  28. package/dist/src/index.d.ts.map +1 -1
  29. package/dist/src/index.js +1 -5
  30. package/dist/src/index.js.map +1 -1
  31. package/dist/src/sysdb_migrations/internal/migrations.js +11 -0
  32. package/dist/src/sysdb_migrations/internal/migrations.js.map +1 -1
  33. package/dist/src/system_database.d.ts +1 -4
  34. package/dist/src/system_database.d.ts.map +1 -1
  35. package/dist/src/system_database.js +45 -89
  36. package/dist/src/system_database.js.map +1 -1
  37. package/dist/src/utils.d.ts +1 -0
  38. package/dist/src/utils.d.ts.map +1 -1
  39. package/dist/src/utils.js +4 -2
  40. package/dist/src/utils.js.map +1 -1
  41. package/dist/src/wfqueue.d.ts +41 -47
  42. package/dist/src/wfqueue.d.ts.map +1 -1
  43. package/dist/src/wfqueue.js +116 -229
  44. package/dist/src/wfqueue.js.map +1 -1
  45. package/dist/tsconfig.tsbuildinfo +1 -1
  46. package/package.json +1 -1
  47. package/dist/src/scheduler/scheduler_decorator.d.ts +0 -41
  48. package/dist/src/scheduler/scheduler_decorator.d.ts.map +0 -1
  49. package/dist/src/scheduler/scheduler_decorator.js +0 -174
  50. package/dist/src/scheduler/scheduler_decorator.js.map +0 -1
@@ -20,6 +20,7 @@ export declare const dbRetryConfig: {
20
20
  initialBackoffSec: number;
21
21
  maxBackoffSec: number;
22
22
  };
23
+ export declare const RESERVED_QUEUE_NAME_PREFIX = "_dbos_";
23
24
  export declare const INTERNAL_QUEUE_NAME = "_dbos_internal_queue";
24
25
  export declare function cancellableSleep(ms: number): {
25
26
  promise: Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":";AAMA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/F;AAqCD,wBAAgB,iBAAiB,YAEhC;AAED,eAAO,MAAM,YAAY;;;;;;;;;;CAUxB,CAAC;AACF,eAAO,MAAM,OAAO,OAAQ,MAAM,qBAA0C,CAAC;AAG7E,eAAO,MAAM,WAAW;;CAEvB,CAAC;AAGF,eAAO,MAAM,aAAa;;;CAGzB,CAAC;AAGF,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAQ1D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM;;;EAwB1C;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,KAAK,EAAE,MAAM;IAKzB,8EAA8E;IAC9E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAWxB,2EAA2E;IAC3E,OAAO,IAAI,IAAI;IAWf,8EAA8E;IACxE,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAQxD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAajF;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/D;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAErC,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAEpD;AAMD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,QAkB7F;AAGD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG;;;EAiBxD"}
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":";AAMA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/F;AAqCD,wBAAgB,iBAAiB,YAEhC;AAED,eAAO,MAAM,YAAY;;;;;;;;;;CAUxB,CAAC;AACF,eAAO,MAAM,OAAO,OAAQ,MAAM,qBAA0C,CAAC;AAG7E,eAAO,MAAM,WAAW;;CAEvB,CAAC;AAGF,eAAO,MAAM,aAAa;;;CAGzB,CAAC;AAGF,eAAO,MAAM,0BAA0B,WAAW,CAAC;AAGnD,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAQ1D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM;;;EAwB1C;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,KAAK,EAAE,MAAM;IAKzB,8EAA8E;IAC9E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAWxB,2EAA2E;IAC3E,OAAO,IAAI,IAAI;IAWf,8EAA8E;IACxE,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAQxD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAajF;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/D;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAErC,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAEpD;AAMD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,QAkB7F;AAGD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG;;;EAiBxD"}
package/dist/src/utils.js CHANGED
@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
3
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
4
4
  };
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.getClientConfig = exports.interceptStreams = exports.exhaustiveCheckGuard = exports.waitForAbort = exports.interruptibleSleep = exports.Semaphore = exports.cancellableSleep = exports.INTERNAL_QUEUE_NAME = exports.dbRetryConfig = exports.sleepConfig = exports.sleepms = exports.globalParams = exports.defaultEnableOTLP = exports.readFile = void 0;
6
+ exports.getClientConfig = exports.interceptStreams = exports.exhaustiveCheckGuard = exports.waitForAbort = exports.interruptibleSleep = exports.Semaphore = exports.cancellableSleep = exports.INTERNAL_QUEUE_NAME = exports.RESERVED_QUEUE_NAME_PREFIX = exports.dbRetryConfig = exports.sleepConfig = exports.sleepms = exports.globalParams = exports.defaultEnableOTLP = exports.readFile = void 0;
7
7
  const node_fs_1 = __importDefault(require("node:fs"));
8
8
  const node_path_1 = __importDefault(require("node:path"));
9
9
  /*
@@ -52,7 +52,7 @@ exports.globalParams = {
52
52
  appVersion: process.env.DBOS__APPVERSION || '', // The one true source of appVersion
53
53
  wasComputed: false, // Was app version set or computed? Stored procs don't support computed versions.
54
54
  executorID: process.env.DBOS__VMID || 'local', // The one true source of executorID
55
- appName: undefined, // Set at launch from the configured application name; undefined outside an application
55
+ appName: undefined, // Set at launch from the configured application name; undefined until the first launch
56
56
  appID: process.env.DBOS__APPID || '', // The one true source of appID
57
57
  enableOTLP: defaultEnableOTLP(), // Whether OTLP is enabled
58
58
  tracingEnabled: false, // Whether span creation is active (enableOTLP or external TracerProvider)
@@ -70,6 +70,8 @@ exports.dbRetryConfig = {
70
70
  initialBackoffSec: 1.0,
71
71
  maxBackoffSec: 60.0,
72
72
  };
73
+ // DBOS's own queues are named under this prefix, so users may not claim it.
74
+ exports.RESERVED_QUEUE_NAME_PREFIX = '_dbos_';
73
75
  // The name of the internal queue used by DBOS
74
76
  exports.INTERNAL_QUEUE_NAME = '_dbos_internal_queue';
75
77
  /*
@@ -1 +1 @@
1
- {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B;;IAEI;AACG,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,WAA2B,MAAM;IAC5E,OAAO,MAAM,iBAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AACxD,CAAC;AAFD,4BAEC;AAED,SAAS,eAAe;IACtB,IAAI,CAAC;QACH,SAAS,eAAe,CAAC,KAAwB;YAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,mBAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC9B,KAAK,IAAI,mBAAI,CAAC,GAAG,CAAC;gBACpB,CAAC;gBACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,mBAAI,CAAC,GAAG,CAAC,CAAC;YAChC,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YAED,KAAK,CAAC,GAAG,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAI,CAAC,GAAG,CAAC,CAAC;YAEjC,IAAI,iBAAE,CAAC,UAAU,CAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;gBAClD,OAAO,GAAG,CAAC;YACb,CAAC;YAED,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,eAAe,GAAG,mBAAI,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,CAAC;QAC9E,iEAAiE;QACjE,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,CAAwB,CAAC;QACpE,OAAO,WAAW,CAAC,OAAO,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,6DAA6D;QAC7D,uFAAuF;QACvF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,SAAgB,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC;AAC5C,CAAC;AAFD,8CAEC;AAEY,QAAA,YAAY,GAAG;IAC1B,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAE,oCAAoC;IACpF,WAAW,EAAE,KAAK,EAAE,iFAAiF;IACrG,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,EAAE,oCAAoC;IACnF,OAAO,EAAE,SAA+B,EAAE,uFAAuF;IACjI,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,+BAA+B;IACrE,UAAU,EAAE,iBAAiB,EAAE,EAAE,0BAA0B;IAC3D,cAAc,EAAE,KAAK,EAAE,0EAA0E;IACjG,WAAW,EAAE,eAAe,EAAE,EAAE,kCAAkC;IAClE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,EAAE,gCAAgC;CAChF,CAAC;AACK,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAAhE,QAAA,OAAO,WAAyD;AAE7E,yGAAyG;AAC5F,QAAA,WAAW,GAAG;IACzB,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF,wFAAwF;AAC3E,QAAA,aAAa,GAAG;IAC3B,iBAAiB,EAAE,GAAG;IACtB,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF,8CAA8C;AACjC,QAAA,mBAAmB,GAAG,sBAAsB,CAAC;AAE1D;;;;;EAKE;AACF,SAAgB,gBAAgB,CAAC,EAAU;IACzC,IAAI,SAAS,GAA8C,SAAS,CAAC;IACrE,IAAI,cAA0B,CAAC;IAC/B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC5C,cAAc,GAAG,GAAG,EAAE;YACpB,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,EAAE,CAAC;YACV,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC,CAAC;QACF,SAAS,GAAG,UAAU,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,SAAS,CAAC;YACtB,cAAc,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAxBD,4CAwBC;AAED;;;;;;;GAOG;AACH,MAAa,SAAS;IACZ,SAAS,CAAS;IACT,OAAO,GAAsB,EAAE,CAAC;IAChC,OAAO,CAAU;IAElC,YAAY,KAAa;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,8EAA8E;IAC9E,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAC3E,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,4EAA4E;YAC5E,IAAI,EAAE,CAAC;QACT,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,YAAY,CAAI,EAAoB;QACxC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;CACF;AA3CD,8BA2CC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,EAAU,EAAE,MAAmB;IAChE,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC;AAbD,gDAaC;AAED,6EAA6E;AAC7E,SAAgB,YAAY,CAAC,MAAmB;IAC9C,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC;AALD,oCAKC;AAID,SAAgB,oBAAoB,CAAC,CAAQ;IAC3C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACvD,CAAC;AAFD,oDAEC;AAED,6BAA6B;AAC7B,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACtE,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAEtE,SAAgB,gBAAgB,CAAC,SAA6D;IAC5F,MAAM,SAAS,GAAG,CAAC,MAA2B,EAAE,aAA0C,EAAE,EAAE;QAC5F,OAAO,CACL,KAA0B,EAC1B,YAA8D,EAC9D,EAAiC,EACxB,EAAE;YACX,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3B,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;gBACvC,OAAO,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,+CAA+C;YAC5F,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,EAAE,YAA8B,EAAE,EAAE,CAAC,CAAC,CAAC,qDAAqD;QACxH,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAChE,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;AAClE,CAAC;AAlBD,4CAkBC;AAED,2GAA2G;AAC3G,SAAgB,eAAe,CAAC,WAAyB;IACvD,MAAM,gBAAgB,GAAG,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IAChG,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACjG,OAAO;QACL,gBAAgB;QAChB,uBAAuB,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK;KAC1D,CAAC;IAEF,SAAS,UAAU,CAAC,GAAQ;QAC1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YACzD,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;YACzD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAjBD,0CAiBC"}
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"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"}
@@ -4,7 +4,7 @@ import type { GlobalLogger } from './telemetry/logs';
4
4
  /**
5
5
  * Log a single queue's name and its set parameters. Unset parameters are
6
6
  * omitted, matching `Queue: <name> (concurrency=…, worker_concurrency=…,
7
- * limit=N/Ts, priority, partitioned)`.
7
+ * limit=N/Ts, partition_concurrency=…)`.
8
8
  */
9
9
  export declare function logQueue(logger: GlobalLogger, q: WorkflowQueue): void;
10
10
  /**
@@ -43,10 +43,6 @@ export interface QueueParameters {
43
43
  minPollingIntervalMs?: number;
44
44
  /** @deprecated Use `globalConcurrency`. */
45
45
  concurrency?: number;
46
- /** @deprecated Priority is always enabled. */
47
- priorityEnabled?: boolean;
48
- /** @deprecated Use the partition limits, any of which partitions the queue. */
49
- partitionQueue?: boolean;
50
46
  }
51
47
  /**
52
48
  * Behavior of `DBOS.registerQueue` / `DBOSClient.registerQueue` when a queue
@@ -64,17 +60,8 @@ export interface RegisterQueueOptions extends QueueParameters {
64
60
  /** How to behave when a queue with the same name already exists. */
65
61
  onConflict?: QueueConflictResolution;
66
62
  }
67
- /** A queue's limits, each resolved to the scope it is enforced at. */
68
- export interface ResolvedQueueLimits {
69
- globalConcurrency?: number;
70
- workerConcurrency?: number;
71
- rateLimit?: QueueRateLimit;
72
- partitionConcurrency?: number;
73
- partitionWorkerConcurrency?: number;
74
- partitionRateLimit?: QueueRateLimit;
75
- }
76
- /** Resolve every limit on a queue to the scope it is actually enforced at. */
77
- export declare function resolveQueueLimits(q: WorkflowQueue): ResolvedQueueLimits;
63
+ /** True when a queue is partitioned, which is to say any per-partition limit is set on it. */
64
+ export declare function isPartitionedQueue(queue: WorkflowQueue): boolean;
78
65
  /**
79
66
  * Settings structure for a named workflow queue.
80
67
  * Workflow queues limit the rate and concurrency at which DBOS executes workflows.
@@ -86,23 +73,21 @@ export declare class WorkflowQueue {
86
73
  /**
87
74
  * Last-known cached values. May be stale for database-backed queues if
88
75
  * another process has modified the row. Use getters instead.
76
+ * `concurrency` is the queue-wide limit, across every worker and partition.
89
77
  */
90
78
  concurrency?: number;
91
79
  rateLimit?: QueueRateLimit;
92
80
  workerConcurrency?: number;
93
- priorityEnabled: boolean;
94
- partitionQueue: boolean;
95
81
  partitionConcurrency?: number;
96
82
  partitionWorkerConcurrency?: number;
97
83
  partitionRateLimit?: QueueRateLimit;
98
84
  minPollingIntervalMs?: number;
99
- /** Owner from the queues table; undefined for in-memory and unclaimed queues. */
85
+ /** Owner from the queues table; undefined for internal and unclaimed queues. */
100
86
  applicationName?: string;
101
87
  /**
102
88
  * When true, this queue's configuration is persisted in the `queues` system
103
- * table and may be mutated at runtime via the `setX` methods. When false,
104
- * the queue's configuration is fixed at construction and lives only in
105
- * process memory.
89
+ * table and may be mutated at runtime via the `setX` methods. False only for
90
+ * the process-local queues DBOS registers for its own use.
106
91
  */
107
92
  readonly databaseBacked: boolean;
108
93
  /**
@@ -112,24 +97,25 @@ export declare class WorkflowQueue {
112
97
  * so that `WorkflowQueue` does not transitively depend on `SystemDatabase`.
113
98
  */
114
99
  readonly clientBound: boolean;
115
- constructor(name: string);
116
100
  /**
101
+ * Not reachable from the published package, which exports `WorkflowQueue` as a
102
+ * type only: applications obtain queues from `DBOS.registerQueue`,
103
+ * `DBOS.retrieveQueue`, or `DBOS.listQueues`.
117
104
  *
118
- * @param name - Name to give the `WorkflowQueue`, accepted by `DBOS.startWorkflow`
119
- * @param queueParameters - Policy for limiting workflow initiation rate and execution concurrency
105
+ * @param record - The queue's configuration, persisted or not.
106
+ * @param databaseBacked - False only for the process-local queues DBOS registers for its own use.
107
+ * @param clientSystemDatabase - When set, config reads and writes target this client's database.
108
+ */
109
+ constructor(record: QueueRecord, databaseBacked?: boolean, clientSystemDatabase?: SystemDatabase);
110
+ /**
111
+ * Throws if a user-supplied queue registration is invalid. Internal queues bypass the name
112
+ * check: the reserved prefix is theirs, and they validate their parameters directly.
120
113
  */
121
- constructor(name: string, queueParameters: QueueParameters);
114
+ static validateQueueRegistration(name: string, params: QueueParameters): void;
122
115
  /** Throws if any combination of queue parameters is invalid. */
123
116
  static validateQueueParams(params: QueueParameters): void;
124
117
  /** Build a persistable record from user-supplied registration parameters. */
125
118
  static recordFromParams(name: string, params: QueueParameters): QueueRecord;
126
- /**
127
- * Construct a database-backed queue from a persisted record. Bypasses the
128
- * legacy constructor so the instance is not added to the global registry —
129
- * the queues table is the source of truth.
130
- * @internal
131
- */
132
- static _fromRecord(record: QueueRecord, clientSystemDatabase?: SystemDatabase): WorkflowQueue;
133
119
  /** @deprecated Use `setGlobalConcurrency`. */
134
120
  setConcurrency(value: number | undefined): Promise<void>;
135
121
  setGlobalConcurrency(value: number | undefined): Promise<void>;
@@ -138,10 +124,6 @@ export declare class WorkflowQueue {
138
124
  setPartitionConcurrency(value: number | undefined): Promise<void>;
139
125
  setPartitionWorkerConcurrency(value: number | undefined): Promise<void>;
140
126
  setPartitionRateLimit(value: QueueRateLimit | undefined): Promise<void>;
141
- /** @deprecated Priority is always enabled. */
142
- setPriorityEnabled(value: boolean): Promise<void>;
143
- /** @deprecated Use the partition limit setters. */
144
- setPartitionQueue(value: boolean): Promise<void>;
145
127
  setMinPollingIntervalMs(value: number): Promise<void>;
146
128
  /** @deprecated Use `getGlobalConcurrency`. */
147
129
  getConcurrency(): Promise<number | undefined>;
@@ -151,14 +133,28 @@ export declare class WorkflowQueue {
151
133
  getPartitionConcurrency(): Promise<number | undefined>;
152
134
  getPartitionWorkerConcurrency(): Promise<number | undefined>;
153
135
  getPartitionRateLimit(): Promise<QueueRateLimit | undefined>;
154
- /** @deprecated Priority is always enabled. */
155
- getPriorityEnabled(): Promise<boolean>;
156
- /** @deprecated Use the partition limit getters. */
157
- getPartitionQueue(): Promise<boolean>;
158
136
  getMinPollingIntervalMs(): Promise<number | undefined>;
159
137
  }
138
+ /**
139
+ * Register a queue that DBOS itself needs — the internal queue, a Kafka receiver's
140
+ * queue — or return the one already registered under `name`.
141
+ *
142
+ * Internal queues are not persisted in the `queues` table: their configuration is
143
+ * fixed here and lives only in this process's memory. They are always dispatched,
144
+ * bypassing any `listenQueues` filter, since this process is the only one that
145
+ * enqueues onto them.
146
+ *
147
+ * Callers must resolve their queues through this rather than caching them: a registry
148
+ * clear (`DBOS.shutdown({ deregister: true })`) drops the registration, and a cached
149
+ * queue would silently stop being dispatched, leaving its workflows ENQUEUED forever.
150
+ *
151
+ * Not a user-facing API: applications register queues with `DBOS.registerQueue`.
152
+ * @internal
153
+ */
154
+ export declare function registerInternalQueue(name: string, params?: QueueParameters): WorkflowQueue;
160
155
  declare class WFQueueRunner {
161
- readonly wfQueuesByName: Map<string, WorkflowQueue>;
156
+ /** DBOS's own process-local queues, registered via `registerInternalQueue`. */
157
+ private readonly internalQueues;
162
158
  /**
163
159
  * Queues fed by this process's own pollers (e.g. a Kafka consumer). Always dispatched,
164
160
  * regardless of any listenQueues filter, so this process executes what it enqueues.
@@ -169,8 +165,6 @@ declare class WFQueueRunner {
169
165
  private listenQueueNames;
170
166
  /** Per-queue scheduling state, keyed by queue name. */
171
167
  private readonly states;
172
- /** Names already warned about colliding with an in-memory queue (warn-once). */
173
- private readonly conflictWarned;
174
168
  private static readonly defaultMinPollingIntervalMs;
175
169
  private static readonly defaultMaxPollingIntervalMs;
176
170
  private static readonly reconcileIntervalMs;
@@ -179,11 +173,11 @@ declare class WFQueueRunner {
179
173
  private readonly scalebackFactor;
180
174
  private readonly jitterMin;
181
175
  private readonly jitterMax;
176
+ addInternalQueue(queue: WorkflowQueue): void;
177
+ getInternalQueue(name: string): WorkflowQueue | undefined;
182
178
  stop(): void;
183
179
  clearRegistrations(): void;
184
- dispatchLoop(exec: DBOSExecutor, listenQueuesArg: (WorkflowQueue | string)[] | null, maxConcurrentQueueDispatches?: number): Promise<void>;
185
- /** Resolve the listenQueues argument to the set of in-memory queues to dispatch for. */
186
- private resolveInMemoryQueues;
180
+ dispatchLoop(exec: DBOSExecutor, listenQueuesArg: string[] | null, maxConcurrentQueueDispatches?: number): Promise<void>;
187
181
  /** Begin tracking a queue if it isn't already, scheduling its first poll one interval out. */
188
182
  private ensureState;
189
183
  /** Reconcile DB-backed queues against the queues table in one query: refresh, add, or drop them. */
@@ -1 +1 @@
1
- {"version":3,"file":"wfqueue.d.ts","sourceRoot":"","sources":["../../src/wfqueue.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"wfqueue.d.ts","sourceRoot":"","sources":["../../src/wfqueue.ts"],"names":[],"mappings":"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"}