bunqueue 2.8.59 → 2.9.0

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 (380) hide show
  1. package/README.md +109 -77
  2. package/dist/application/background/dlq.js +2 -0
  3. package/dist/application/contextFactory.js +5 -0
  4. package/dist/application/dlqManager.d.ts +11 -1
  5. package/dist/application/dlqManager.js +48 -10
  6. package/dist/application/dlqRetry.js +59 -38
  7. package/dist/application/eventsManager.d.ts +1 -1
  8. package/dist/application/eventsManager.js +30 -26
  9. package/dist/application/lockManager.js +1 -1
  10. package/dist/application/operations/jobManagement.d.ts +4 -0
  11. package/dist/application/operations/jobMoveOperations.js +9 -4
  12. package/dist/application/postgres-queue-manager/batchSnapshot.d.ts +16 -0
  13. package/dist/application/postgres-queue-manager/batchSnapshot.js +17 -0
  14. package/dist/application/postgres-queue-manager/cloud.d.ts +30 -0
  15. package/dist/application/postgres-queue-manager/cloud.js +55 -0
  16. package/dist/application/postgres-queue-manager/config.d.ts +5 -0
  17. package/dist/application/postgres-queue-manager/config.js +1 -0
  18. package/dist/application/postgres-queue-manager/control.d.ts +26 -0
  19. package/dist/application/postgres-queue-manager/control.js +186 -0
  20. package/dist/application/postgres-queue-manager/deferredWrites.d.ts +13 -0
  21. package/dist/application/postgres-queue-manager/deferredWrites.js +60 -0
  22. package/dist/application/postgres-queue-manager/delivery.d.ts +19 -0
  23. package/dist/application/postgres-queue-manager/delivery.js +80 -0
  24. package/dist/application/postgres-queue-manager/lease.d.ts +13 -0
  25. package/dist/application/postgres-queue-manager/lease.js +88 -0
  26. package/dist/application/postgres-queue-manager/lifetimeMetrics.d.ts +32 -0
  27. package/dist/application/postgres-queue-manager/lifetimeMetrics.js +53 -0
  28. package/dist/application/postgres-queue-manager/maintenance.d.ts +14 -0
  29. package/dist/application/postgres-queue-manager/maintenance.js +100 -0
  30. package/dist/application/postgres-queue-manager/operationGate.d.ts +26 -0
  31. package/dist/application/postgres-queue-manager/operationGate.js +96 -0
  32. package/dist/application/postgres-queue-manager/operations.d.ts +25 -0
  33. package/dist/application/postgres-queue-manager/operations.js +194 -0
  34. package/dist/application/postgres-queue-manager/projectionRefreshes.d.ts +43 -0
  35. package/dist/application/postgres-queue-manager/projectionRefreshes.js +170 -0
  36. package/dist/application/postgres-queue-manager/queries.d.ts +142 -0
  37. package/dist/application/postgres-queue-manager/queries.js +231 -0
  38. package/dist/application/postgres-queue-manager/relationships.d.ts +10 -0
  39. package/dist/application/postgres-queue-manager/relationships.js +45 -0
  40. package/dist/application/postgres-queue-manager/services.d.ts +31 -0
  41. package/dist/application/postgres-queue-manager/services.js +149 -0
  42. package/dist/application/postgres-queue-manager/snapshot.d.ts +51 -0
  43. package/dist/application/postgres-queue-manager/snapshot.js +236 -0
  44. package/dist/application/postgres-queue-manager/snapshotViews.d.ts +15 -0
  45. package/dist/application/postgres-queue-manager/snapshotViews.js +100 -0
  46. package/dist/application/postgres-queue-manager/startupEventBuffer.d.ts +12 -0
  47. package/dist/application/postgres-queue-manager/startupEventBuffer.js +36 -0
  48. package/dist/application/postgres-queue-manager/state.d.ts +47 -0
  49. package/dist/application/postgres-queue-manager/state.js +273 -0
  50. package/dist/application/postgres-queue-manager/terminalDelivery.d.ts +20 -0
  51. package/dist/application/postgres-queue-manager/terminalDelivery.js +100 -0
  52. package/dist/application/postgresQueueManager.d.ts +2 -0
  53. package/dist/application/postgresQueueManager.js +1 -0
  54. package/dist/application/queue-manager/ack.js +1 -1
  55. package/dist/application/queue-manager/delivery.js +1 -1
  56. package/dist/application/queue-manager/flow-failures.js +4 -0
  57. package/dist/application/queue-manager/limits.d.ts +2 -0
  58. package/dist/application/queue-manager/limits.js +4 -0
  59. package/dist/application/queue-manager/observability.js +15 -3
  60. package/dist/application/queue-manager/queries.d.ts +7 -0
  61. package/dist/application/queue-manager/queries.js +9 -0
  62. package/dist/application/queue-manager/services.d.ts +1 -1
  63. package/dist/application/queue-manager/services.js +4 -2
  64. package/dist/application/queue-manager/state.js +16 -1
  65. package/dist/application/statsManager.d.ts +1 -1
  66. package/dist/application/statsManager.js +1 -1
  67. package/dist/cli/commands/server.js +1 -1
  68. package/dist/client/events.js +2 -2
  69. package/dist/client/flow.js +0 -1
  70. package/dist/client/forwarder.d.ts +6 -4
  71. package/dist/client/forwarder.js +5 -3
  72. package/dist/client/queue/dlq.d.ts +2 -0
  73. package/dist/client/queue/dlq.js +14 -0
  74. package/dist/client/queue/dlqOps.d.ts +2 -0
  75. package/dist/client/queue/dlqOps.js +4 -0
  76. package/dist/client/queue/helpers.js +2 -0
  77. package/dist/client/queue/operations/add/single.js +1 -1
  78. package/dist/client/queue/runtime/configuration.d.ts +4 -0
  79. package/dist/client/queue/runtime/configuration.js +8 -0
  80. package/dist/client/sandboxed/runtime/state.js +2 -2
  81. package/dist/client/tcp/connection.d.ts +1 -1
  82. package/dist/client/tcp/connection.js +1 -1
  83. package/dist/client/tcp/runtime/state.js +2 -2
  84. package/dist/client/types/metrics.d.ts +1 -1
  85. package/dist/client/worker/runtime/control.js +0 -1
  86. package/dist/client/worker/runtime/execution.js +3 -8
  87. package/dist/client/worker/runtime/lifecycle.js +0 -1
  88. package/dist/client/worker/runtime/polling.d.ts +1 -0
  89. package/dist/client/worker/runtime/polling.js +9 -0
  90. package/dist/client/worker/runtime/state.js +3 -3
  91. package/dist/client/workflow/compensationChild.d.ts +2 -0
  92. package/dist/client/workflow/compensationChild.js +3 -1
  93. package/dist/client/workflow/compensationPass.d.ts +1 -0
  94. package/dist/client/workflow/compensationPass.js +18 -2
  95. package/dist/client/workflow/compensator.d.ts +2 -1
  96. package/dist/client/workflow/compensator.js +11 -3
  97. package/dist/client/workflow/engine.js +1 -1
  98. package/dist/client/workflow/executionFence.d.ts +15 -0
  99. package/dist/client/workflow/executionFence.js +29 -0
  100. package/dist/client/workflow/executor.d.ts +5 -11
  101. package/dist/client/workflow/executor.js +48 -47
  102. package/dist/client/workflow/executorLifecycle.d.ts +1 -0
  103. package/dist/client/workflow/executorLifecycle.js +41 -10
  104. package/dist/client/workflow/executorNodes.d.ts +1 -0
  105. package/dist/client/workflow/executorNodes.js +45 -16
  106. package/dist/client/workflow/executorQueue.d.ts +9 -0
  107. package/dist/client/workflow/executorQueue.js +15 -0
  108. package/dist/client/workflow/forEachRunner.d.ts +4 -0
  109. package/dist/client/workflow/forEachRunner.js +70 -0
  110. package/dist/client/workflow/loops.d.ts +4 -5
  111. package/dist/client/workflow/loops.js +27 -93
  112. package/dist/client/workflow/mapRunner.d.ts +1 -1
  113. package/dist/client/workflow/mapRunner.js +11 -2
  114. package/dist/client/workflow/recovery.d.ts +1 -0
  115. package/dist/client/workflow/recovery.js +24 -18
  116. package/dist/client/workflow/rollbackControl.d.ts +1 -0
  117. package/dist/client/workflow/rollbackControl.js +5 -2
  118. package/dist/client/workflow/runner.d.ts +3 -1
  119. package/dist/client/workflow/runner.js +26 -3
  120. package/dist/client/workflow/stepTypes.js +1 -1
  121. package/dist/client/workflow/subWorkflowRunner.d.ts +1 -0
  122. package/dist/client/workflow/subWorkflowRunner.js +7 -0
  123. package/dist/client/workflow/waitFor.d.ts +4 -0
  124. package/dist/client/workflow/waitFor.js +23 -11
  125. package/dist/client/workflow/workflowDecisions.d.ts +1 -1
  126. package/dist/client/workflow/workflowDecisions.js +3 -1
  127. package/dist/config/resolve.d.ts +14 -0
  128. package/dist/config/resolve.js +50 -5
  129. package/dist/config/types.d.ts +18 -0
  130. package/dist/domain/queue/dlqShard.d.ts +2 -0
  131. package/dist/domain/queue/dlqShard.js +16 -0
  132. package/dist/domain/queue/shard/dlq.d.ts +1 -0
  133. package/dist/domain/queue/shard/dlq.js +3 -0
  134. package/dist/domain/types/commands/dlq.d.ts +5 -0
  135. package/dist/domain/types/commands/union.d.ts +1 -1
  136. package/dist/domain/types/cron.d.ts +5 -0
  137. package/dist/domain/types/cron.js +14 -3
  138. package/dist/domain/types/dlq.d.ts +1 -1
  139. package/dist/domain/types/dlq.js +1 -2
  140. package/dist/domain/types/jobs/model.d.ts +1 -1
  141. package/dist/infrastructure/cloud/commandHandler.js +5 -3
  142. package/dist/infrastructure/cloud/commands/integrations.js +11 -11
  143. package/dist/infrastructure/cloud/commands/jobs.js +48 -40
  144. package/dist/infrastructure/cloud/commands/queues.js +61 -75
  145. package/dist/infrastructure/cloud/queueAdapter/local.d.ts +41 -0
  146. package/dist/infrastructure/cloud/queueAdapter/local.js +187 -0
  147. package/dist/infrastructure/cloud/queueAdapter/postgres.d.ts +42 -0
  148. package/dist/infrastructure/cloud/queueAdapter/postgres.js +188 -0
  149. package/dist/infrastructure/cloud/queueAdapter/registry.d.ts +4 -0
  150. package/dist/infrastructure/cloud/queueAdapter/registry.js +15 -0
  151. package/dist/infrastructure/cloud/queueAdapter/types.d.ts +87 -0
  152. package/dist/infrastructure/cloud/queueAdapter/types.js +1 -0
  153. package/dist/infrastructure/cloud/snapshot/analytics.d.ts +2 -0
  154. package/dist/infrastructure/cloud/snapshot/analytics.js +7 -0
  155. package/dist/infrastructure/cloud/snapshot/collector.d.ts +4 -0
  156. package/dist/infrastructure/cloud/snapshot/collector.js +39 -1
  157. package/dist/infrastructure/cloud/snapshot/config.d.ts +3 -0
  158. package/dist/infrastructure/cloud/snapshot/config.js +43 -0
  159. package/dist/infrastructure/cloud/snapshot/jobs.d.ts +3 -0
  160. package/dist/infrastructure/cloud/snapshot/jobs.js +32 -1
  161. package/dist/infrastructure/cloud/snapshotCollector.js +20 -35
  162. package/dist/infrastructure/cloud/snapshotHelpers.d.ts +3 -3
  163. package/dist/infrastructure/cloud/snapshotHelpers.js +3 -3
  164. package/dist/infrastructure/cloud/statsRefresh.js +2 -1
  165. package/dist/infrastructure/cloud/types/command.d.ts +2 -2
  166. package/dist/infrastructure/persistence/postgres/admission.d.ts +18 -0
  167. package/dist/infrastructure/persistence/postgres/admission.js +193 -0
  168. package/dist/infrastructure/persistence/postgres/admissionParent.d.ts +5 -0
  169. package/dist/infrastructure/persistence/postgres/admissionParent.js +35 -0
  170. package/dist/infrastructure/persistence/postgres/admissionResult.d.ts +9 -0
  171. package/dist/infrastructure/persistence/postgres/admissionResult.js +1 -0
  172. package/dist/infrastructure/persistence/postgres/admissionStore.d.ts +12 -0
  173. package/dist/infrastructure/persistence/postgres/admissionStore.js +101 -0
  174. package/dist/infrastructure/persistence/postgres/advisoryLocks.d.ts +2 -0
  175. package/dist/infrastructure/persistence/postgres/advisoryLocks.js +13 -0
  176. package/dist/infrastructure/persistence/postgres/batchAdmission.d.ts +11 -0
  177. package/dist/infrastructure/persistence/postgres/batchAdmission.js +110 -0
  178. package/dist/infrastructure/persistence/postgres/batchCompletion.d.ts +4 -0
  179. package/dist/infrastructure/persistence/postgres/batchCompletion.js +174 -0
  180. package/dist/infrastructure/persistence/postgres/batchEvents.d.ts +14 -0
  181. package/dist/infrastructure/persistence/postgres/batchEvents.js +72 -0
  182. package/dist/infrastructure/persistence/postgres/brokerSessions.d.ts +14 -0
  183. package/dist/infrastructure/persistence/postgres/brokerSessions.js +94 -0
  184. package/dist/infrastructure/persistence/postgres/claimBatch.d.ts +11 -0
  185. package/dist/infrastructure/persistence/postgres/claimBatch.js +56 -0
  186. package/dist/infrastructure/persistence/postgres/claimSelection.d.ts +4 -0
  187. package/dist/infrastructure/persistence/postgres/claimSelection.js +198 -0
  188. package/dist/infrastructure/persistence/postgres/claims.d.ts +3 -0
  189. package/dist/infrastructure/persistence/postgres/claims.js +137 -0
  190. package/dist/infrastructure/persistence/postgres/cloudReadModel.d.ts +26 -0
  191. package/dist/infrastructure/persistence/postgres/cloudReadModel.js +123 -0
  192. package/dist/infrastructure/persistence/postgres/codec.d.ts +30 -0
  193. package/dist/infrastructure/persistence/postgres/codec.js +82 -0
  194. package/dist/infrastructure/persistence/postgres/completionEvents.d.ts +11 -0
  195. package/dist/infrastructure/persistence/postgres/completionEvents.js +21 -0
  196. package/dist/infrastructure/persistence/postgres/completionLifecycle.d.ts +11 -0
  197. package/dist/infrastructure/persistence/postgres/completionLifecycle.js +145 -0
  198. package/dist/infrastructure/persistence/postgres/completionOutcome.d.ts +4 -0
  199. package/dist/infrastructure/persistence/postgres/completionOutcome.js +112 -0
  200. package/dist/infrastructure/persistence/postgres/completionQueries.d.ts +10 -0
  201. package/dist/infrastructure/persistence/postgres/completionQueries.js +87 -0
  202. package/dist/infrastructure/persistence/postgres/connection.d.ts +3 -0
  203. package/dist/infrastructure/persistence/postgres/connection.js +15 -0
  204. package/dist/infrastructure/persistence/postgres/context.d.ts +28 -0
  205. package/dist/infrastructure/persistence/postgres/context.js +74 -0
  206. package/dist/infrastructure/persistence/postgres/control.d.ts +23 -0
  207. package/dist/infrastructure/persistence/postgres/control.js +105 -0
  208. package/dist/infrastructure/persistence/postgres/crons.d.ts +18 -0
  209. package/dist/infrastructure/persistence/postgres/crons.js +205 -0
  210. package/dist/infrastructure/persistence/postgres/deduplication.d.ts +9 -0
  211. package/dist/infrastructure/persistence/postgres/deduplication.js +47 -0
  212. package/dist/infrastructure/persistence/postgres/dependencyDestruction.d.ts +14 -0
  213. package/dist/infrastructure/persistence/postgres/dependencyDestruction.js +74 -0
  214. package/dist/infrastructure/persistence/postgres/dependencyPromotion.d.ts +29 -0
  215. package/dist/infrastructure/persistence/postgres/dependencyPromotion.js +212 -0
  216. package/dist/infrastructure/persistence/postgres/destructiveMutations.d.ts +4 -0
  217. package/dist/infrastructure/persistence/postgres/destructiveMutations.js +111 -0
  218. package/dist/infrastructure/persistence/postgres/dlqLifecycle.d.ts +13 -0
  219. package/dist/infrastructure/persistence/postgres/dlqLifecycle.js +184 -0
  220. package/dist/infrastructure/persistence/postgres/dlqMaintenance.d.ts +6 -0
  221. package/dist/infrastructure/persistence/postgres/dlqMaintenance.js +36 -0
  222. package/dist/infrastructure/persistence/postgres/dlqRetryPlan.d.ts +21 -0
  223. package/dist/infrastructure/persistence/postgres/dlqRetryPlan.js +92 -0
  224. package/dist/infrastructure/persistence/postgres/eventCommitGc.d.ts +27 -0
  225. package/dist/infrastructure/persistence/postgres/eventCommitGc.js +62 -0
  226. package/dist/infrastructure/persistence/postgres/eventJournal.d.ts +18 -0
  227. package/dist/infrastructure/persistence/postgres/eventJournal.js +76 -0
  228. package/dist/infrastructure/persistence/postgres/eventJournalSchema.d.ts +5 -0
  229. package/dist/infrastructure/persistence/postgres/eventJournalSchema.js +253 -0
  230. package/dist/infrastructure/persistence/postgres/eventPruneWatermarks.d.ts +24 -0
  231. package/dist/infrastructure/persistence/postgres/eventPruneWatermarks.js +111 -0
  232. package/dist/infrastructure/persistence/postgres/eventRetention.d.ts +18 -0
  233. package/dist/infrastructure/persistence/postgres/eventRetention.js +76 -0
  234. package/dist/infrastructure/persistence/postgres/events.d.ts +45 -0
  235. package/dist/infrastructure/persistence/postgres/events.js +249 -0
  236. package/dist/infrastructure/persistence/postgres/expiry.d.ts +3 -0
  237. package/dist/infrastructure/persistence/postgres/expiry.js +74 -0
  238. package/dist/infrastructure/persistence/postgres/flowFailures.d.ts +17 -0
  239. package/dist/infrastructure/persistence/postgres/flowFailures.js +199 -0
  240. package/dist/infrastructure/persistence/postgres/jobData.d.ts +3 -0
  241. package/dist/infrastructure/persistence/postgres/jobData.js +32 -0
  242. package/dist/infrastructure/persistence/postgres/leaseRelease.d.ts +9 -0
  243. package/dist/infrastructure/persistence/postgres/leaseRelease.js +120 -0
  244. package/dist/infrastructure/persistence/postgres/leaseRenewal.d.ts +4 -0
  245. package/dist/infrastructure/persistence/postgres/leaseRenewal.js +35 -0
  246. package/dist/infrastructure/persistence/postgres/lifetimeMetrics.d.ts +15 -0
  247. package/dist/infrastructure/persistence/postgres/lifetimeMetrics.js +46 -0
  248. package/dist/infrastructure/persistence/postgres/lifetimeMetricsFinalizer.d.ts +4 -0
  249. package/dist/infrastructure/persistence/postgres/lifetimeMetricsFinalizer.js +13 -0
  250. package/dist/infrastructure/persistence/postgres/logs.d.ts +6 -0
  251. package/dist/infrastructure/persistence/postgres/logs.js +70 -0
  252. package/dist/infrastructure/persistence/postgres/maintenance.d.ts +6 -0
  253. package/dist/infrastructure/persistence/postgres/maintenance.js +138 -0
  254. package/dist/infrastructure/persistence/postgres/maintenanceFlights.d.ts +14 -0
  255. package/dist/infrastructure/persistence/postgres/maintenanceFlights.js +66 -0
  256. package/dist/infrastructure/persistence/postgres/metricWrites.d.ts +9 -0
  257. package/dist/infrastructure/persistence/postgres/metricWrites.js +94 -0
  258. package/dist/infrastructure/persistence/postgres/mutations.d.ts +9 -0
  259. package/dist/infrastructure/persistence/postgres/mutations.js +171 -0
  260. package/dist/infrastructure/persistence/postgres/outcomes.d.ts +4 -0
  261. package/dist/infrastructure/persistence/postgres/outcomes.js +194 -0
  262. package/dist/infrastructure/persistence/postgres/policies.d.ts +11 -0
  263. package/dist/infrastructure/persistence/postgres/policies.js +18 -0
  264. package/dist/infrastructure/persistence/postgres/postCommitMaintenance.d.ts +17 -0
  265. package/dist/infrastructure/persistence/postgres/postCommitMaintenance.js +117 -0
  266. package/dist/infrastructure/persistence/postgres/promotion.d.ts +3 -0
  267. package/dist/infrastructure/persistence/postgres/promotion.js +43 -0
  268. package/dist/infrastructure/persistence/postgres/queries.d.ts +22 -0
  269. package/dist/infrastructure/persistence/postgres/queries.js +152 -0
  270. package/dist/infrastructure/persistence/postgres/queueDestruction.d.ts +3 -0
  271. package/dist/infrastructure/persistence/postgres/queueDestruction.js +154 -0
  272. package/dist/infrastructure/persistence/postgres/queueLifecycle.d.ts +10 -0
  273. package/dist/infrastructure/persistence/postgres/queueLifecycle.js +60 -0
  274. package/dist/infrastructure/persistence/postgres/rateLimit.d.ts +6 -0
  275. package/dist/infrastructure/persistence/postgres/rateLimit.js +10 -0
  276. package/dist/infrastructure/persistence/postgres/readModels.d.ts +32 -0
  277. package/dist/infrastructure/persistence/postgres/readModels.js +72 -0
  278. package/dist/infrastructure/persistence/postgres/recovery.d.ts +3 -0
  279. package/dist/infrastructure/persistence/postgres/recovery.js +178 -0
  280. package/dist/infrastructure/persistence/postgres/relationships.d.ts +9 -0
  281. package/dist/infrastructure/persistence/postgres/relationships.js +201 -0
  282. package/dist/infrastructure/persistence/postgres/removeUnprocessedChildren.d.ts +4 -0
  283. package/dist/infrastructure/persistence/postgres/removeUnprocessedChildren.js +241 -0
  284. package/dist/infrastructure/persistence/postgres/repeatMutations.d.ts +5 -0
  285. package/dist/infrastructure/persistence/postgres/repeatMutations.js +37 -0
  286. package/dist/infrastructure/persistence/postgres/runtime.d.ts +46 -0
  287. package/dist/infrastructure/persistence/postgres/runtime.js +236 -0
  288. package/dist/infrastructure/persistence/postgres/runtimeConfig.d.ts +21 -0
  289. package/dist/infrastructure/persistence/postgres/runtimeConfig.js +39 -0
  290. package/dist/infrastructure/persistence/postgres/schema.d.ts +4 -0
  291. package/dist/infrastructure/persistence/postgres/schema.js +257 -0
  292. package/dist/infrastructure/persistence/postgres/schemaInitialization.d.ts +3 -0
  293. package/dist/infrastructure/persistence/postgres/schemaInitialization.js +221 -0
  294. package/dist/infrastructure/persistence/postgres/serialAdmission.d.ts +6 -0
  295. package/dist/infrastructure/persistence/postgres/serialAdmission.js +96 -0
  296. package/dist/infrastructure/persistence/postgres/snapshotBudget.d.ts +3 -0
  297. package/dist/infrastructure/persistence/postgres/snapshotBudget.js +83 -0
  298. package/dist/infrastructure/persistence/postgres/storageHealth.d.ts +10 -0
  299. package/dist/infrastructure/persistence/postgres/storageHealth.js +29 -0
  300. package/dist/infrastructure/persistence/postgres/store.d.ts +90 -0
  301. package/dist/infrastructure/persistence/postgres/store.js +136 -0
  302. package/dist/infrastructure/persistence/postgres/telemetry.d.ts +6 -0
  303. package/dist/infrastructure/persistence/postgres/telemetry.js +88 -0
  304. package/dist/infrastructure/persistence/postgres/terminal.d.ts +8 -0
  305. package/dist/infrastructure/persistence/postgres/terminal.js +137 -0
  306. package/dist/infrastructure/persistence/postgres/transactionRetry.d.ts +6 -0
  307. package/dist/infrastructure/persistence/postgres/transactionRetry.js +42 -0
  308. package/dist/infrastructure/persistence/postgres/types.d.ts +175 -0
  309. package/dist/infrastructure/persistence/postgres/types.js +1 -0
  310. package/dist/infrastructure/persistence/postgres/workers.d.ts +15 -0
  311. package/dist/infrastructure/persistence/postgres/workers.js +126 -0
  312. package/dist/infrastructure/persistence/postgres.d.ts +2 -0
  313. package/dist/infrastructure/persistence/postgres.js +1 -0
  314. package/dist/infrastructure/persistence/sqlite/jobs.js +2 -0
  315. package/dist/infrastructure/persistence/sqlite.d.ts +1 -1
  316. package/dist/infrastructure/scheduler/cron/persisted.d.ts +5 -0
  317. package/dist/infrastructure/scheduler/cron/persisted.js +27 -0
  318. package/dist/infrastructure/scheduler/cron/runtime.js +5 -10
  319. package/dist/infrastructure/scheduler/cron/validation.d.ts +3 -0
  320. package/dist/infrastructure/scheduler/cron/validation.js +11 -0
  321. package/dist/infrastructure/scheduler/cronParser.d.ts +1 -1
  322. package/dist/infrastructure/scheduler/cronParser.js +144 -11
  323. package/dist/infrastructure/server/bootstrap.d.ts +2 -3
  324. package/dist/infrastructure/server/bootstrap.js +33 -59
  325. package/dist/infrastructure/server/errors.d.ts +4 -0
  326. package/dist/infrastructure/server/errors.js +54 -0
  327. package/dist/infrastructure/server/handler-routes/control.d.ts +5 -5
  328. package/dist/infrastructure/server/handler-routes/control.js +3 -1
  329. package/dist/infrastructure/server/handler-routes/jobs.js +0 -3
  330. package/dist/infrastructure/server/handler-routes/monitoring.d.ts +2 -2
  331. package/dist/infrastructure/server/handler.js +9 -11
  332. package/dist/infrastructure/server/handlerRoutes.d.ts +2 -2
  333. package/dist/infrastructure/server/handlerRoutes.js +2 -2
  334. package/dist/infrastructure/server/handlers/advanced/dependencies.js +7 -6
  335. package/dist/infrastructure/server/handlers/advanced/jobs.js +19 -6
  336. package/dist/infrastructure/server/handlers/advanced/queue.d.ts +9 -9
  337. package/dist/infrastructure/server/handlers/advanced/queue.js +91 -27
  338. package/dist/infrastructure/server/handlers/core.js +32 -31
  339. package/dist/infrastructure/server/handlers/cron.d.ts +4 -4
  340. package/dist/infrastructure/server/handlers/cron.js +60 -59
  341. package/dist/infrastructure/server/handlers/dashboard.d.ts +1 -1
  342. package/dist/infrastructure/server/handlers/dashboard.js +21 -8
  343. package/dist/infrastructure/server/handlers/dlq.d.ts +6 -3
  344. package/dist/infrastructure/server/handlers/dlq.js +35 -9
  345. package/dist/infrastructure/server/handlers/flow.js +2 -1
  346. package/dist/infrastructure/server/handlers/management.d.ts +5 -5
  347. package/dist/infrastructure/server/handlers/management.js +36 -9
  348. package/dist/infrastructure/server/handlers/monitoring/health.d.ts +5 -5
  349. package/dist/infrastructure/server/handlers/monitoring/health.js +45 -16
  350. package/dist/infrastructure/server/handlers/monitoring/operations.d.ts +1 -1
  351. package/dist/infrastructure/server/handlers/monitoring/operations.js +8 -1
  352. package/dist/infrastructure/server/handlers/monitoring/workers.d.ts +3 -3
  353. package/dist/infrastructure/server/handlers/monitoring/workers.js +31 -7
  354. package/dist/infrastructure/server/handlers/pushBatchValidation.d.ts +3 -1
  355. package/dist/infrastructure/server/handlers/pushBatchValidation.js +52 -7
  356. package/dist/infrastructure/server/handlers/query.d.ts +1 -1
  357. package/dist/infrastructure/server/handlers/query.js +5 -4
  358. package/dist/infrastructure/server/http.js +2 -2
  359. package/dist/infrastructure/server/httpDashboardEndpoints.d.ts +1 -1
  360. package/dist/infrastructure/server/httpDashboardEndpoints.js +19 -6
  361. package/dist/infrastructure/server/httpEndpoints.js +20 -7
  362. package/dist/infrastructure/server/httpRouteQueues.js +11 -1
  363. package/dist/infrastructure/server/shutdownCoordinator.d.ts +24 -0
  364. package/dist/infrastructure/server/shutdownCoordinator.js +106 -0
  365. package/dist/infrastructure/server/sseHandler.js +8 -3
  366. package/dist/infrastructure/server/storageAdapter.d.ts +29 -0
  367. package/dist/infrastructure/server/storageAdapter.js +61 -0
  368. package/dist/infrastructure/server/storageManager.d.ts +12 -0
  369. package/dist/infrastructure/server/storageManager.js +102 -0
  370. package/dist/infrastructure/server/tcp.js +2 -3
  371. package/dist/infrastructure/server/ws/snapshots.d.ts +1 -1
  372. package/dist/infrastructure/server/ws/snapshots.js +19 -4
  373. package/dist/infrastructure/server/wsHandler.js +10 -5
  374. package/dist/main.js +1 -1
  375. package/dist/mcp/backend/embedded/services.js +2 -1
  376. package/dist/mcp/index.d.ts +2 -2
  377. package/dist/mcp/index.js +2 -2
  378. package/dist/shared/storageHealth.d.ts +9 -0
  379. package/dist/shared/storageHealth.js +12 -0
  380. package/package.json +85 -74
@@ -1,16 +1,21 @@
1
1
  import { jobId } from '../../../domain/types/job';
2
2
  import { mapCloudCommandJob } from './jobMapper';
3
+ function pageInteger(value, fallback) {
4
+ if (value === undefined || !Number.isFinite(value))
5
+ return fallback;
6
+ return Math.min(Number.MAX_SAFE_INTEGER, Math.max(0, Math.floor(value)));
7
+ }
3
8
  export const JOB_COMMANDS = {
4
- 'job:cancel': async (queueManager, command) => {
5
- const ok = await queueManager.cancel(jobId(command.jobId ?? ''));
9
+ 'job:cancel': async (adapter, command) => {
10
+ const ok = await adapter.cancel(jobId(command.jobId ?? ''));
6
11
  return { cancelled: ok };
7
12
  },
8
- 'job:promote': async (queueManager, command) => {
9
- const ok = await queueManager.promote(jobId(command.jobId ?? ''));
13
+ 'job:promote': async (adapter, command) => {
14
+ const ok = await adapter.promote(jobId(command.jobId ?? ''));
10
15
  return { promoted: ok };
11
16
  },
12
- 'job:push': async (queueManager, command) => {
13
- const job = await queueManager.push(command.queue ?? '', {
17
+ 'job:push': async (adapter, command) => {
18
+ const job = await adapter.push(command.queue ?? '', {
14
19
  name: command.name ?? 'default',
15
20
  data: command.data ?? {},
16
21
  priority: command.priority,
@@ -18,80 +23,83 @@ export const JOB_COMMANDS = {
18
23
  });
19
24
  return { jobId: String(job.id), queue: command.queue };
20
25
  },
21
- 'job:priority': async (queueManager, command) => {
22
- const ok = await queueManager.changePriority(jobId(command.jobId ?? ''), command.priority ?? 0);
26
+ 'job:priority': async (adapter, command) => {
27
+ const ok = await adapter.changePriority(jobId(command.jobId ?? ''), command.priority ?? 0);
23
28
  return { changed: ok };
24
29
  },
25
- 'job:discard': async (queueManager, command) => {
26
- const ok = await queueManager.discard(jobId(command.jobId ?? ''));
30
+ 'job:discard': async (adapter, command) => {
31
+ const ok = await adapter.discard(jobId(command.jobId ?? ''));
27
32
  return { discarded: ok };
28
33
  },
29
- 'job:delay': async (queueManager, command) => {
30
- await queueManager.changeDelay(jobId(command.jobId ?? ''), command.delay ?? 0);
34
+ 'job:delay': async (adapter, command) => {
35
+ await adapter.changeDelay(jobId(command.jobId ?? ''), command.delay ?? 0);
31
36
  return { delayed: true };
32
37
  },
33
- 'job:updateData': async (queueManager, command) => {
34
- const ok = await queueManager.updateJobData(jobId(command.jobId ?? ''), command.data);
38
+ 'job:updateData': async (adapter, command) => {
39
+ const ok = await adapter.updateData(jobId(command.jobId ?? ''), command.data);
35
40
  return { updated: ok };
36
41
  },
37
- 'job:clearLogs': (queueManager, command) => {
38
- queueManager.clearLogs(jobId(command.jobId ?? ''), command.keepLogs);
42
+ 'job:clearLogs': async (adapter, command) => {
43
+ await adapter.clearLogs(jobId(command.jobId ?? ''), command.keepLogs);
39
44
  return { cleared: true };
40
45
  },
41
- 'job:retry': (queueManager, command) => {
46
+ 'job:retry': async (adapter, command) => {
42
47
  if (command.queue) {
43
- const count = queueManager.retryDlq(command.queue, command.jobId ? jobId(command.jobId) : undefined);
48
+ const count = await adapter.retryDlq(command.queue, command.jobId ? jobId(command.jobId) : undefined);
44
49
  return { retried: count };
45
50
  }
46
51
  return { retried: 0 };
47
52
  },
48
- 'job:logs': (queueManager, command) => ({
49
- logs: queueManager.getLogs(jobId(command.jobId ?? '')),
53
+ 'job:logs': async (adapter, command) => ({
54
+ logs: await adapter.getLogs(jobId(command.jobId ?? '')),
50
55
  }),
51
- 'job:result': (queueManager, command) => ({
52
- result: queueManager.getResult(jobId(command.jobId ?? '')) ?? null,
56
+ 'job:result': async (adapter, command) => ({
57
+ result: await adapter.getResult(jobId(command.jobId ?? '')),
53
58
  }),
54
- 'job:list': (queueManager, command) => {
55
- const limit = command.limit ?? 50;
56
- const offset = command.offset ?? 0;
59
+ 'job:list': async (adapter, command) => {
60
+ const limit = pageInteger(command.limit, 50);
61
+ const offset = pageInteger(command.offset, 0);
62
+ const end = Math.min(Number.MAX_SAFE_INTEGER, offset + limit);
57
63
  const states = command.state
58
64
  ? command.state.split(',')
59
65
  : ['waiting', 'active', 'delayed', 'completed', 'failed'];
60
- const jobs = queueManager.getJobs(command.queue ?? '', {
66
+ const jobs = await adapter.listJobs(command.queue ?? '', {
61
67
  state: states,
62
68
  start: offset,
63
- end: offset + limit - 1,
69
+ end,
64
70
  });
71
+ const source = await adapter.readSnapshotSource();
72
+ const counts = source.queues.find(({ name }) => name === (command.queue ?? ''))?.counts;
65
73
  return {
66
74
  jobs: jobs.map(mapCloudCommandJob),
67
- total: queueManager.count(command.queue ?? ''),
75
+ total: (counts?.waiting ?? 0) + (counts?.prioritized ?? 0) + (counts?.delayed ?? 0),
68
76
  offset,
69
77
  limit,
70
78
  };
71
79
  },
72
- 'job:get': async (queueManager, command) => {
80
+ 'job:get': async (adapter, command) => {
73
81
  const id = jobId(command.jobId ?? '');
74
- const job = await queueManager.getJob(id);
82
+ const job = await adapter.getJob(id);
75
83
  if (!job)
76
84
  return { job: null };
77
85
  return {
78
86
  job: {
79
87
  ...mapCloudCommandJob(job),
80
- logs: queueManager.getLogs(id),
81
- result: queueManager.getResult(id) ?? null,
88
+ logs: await adapter.getLogs(id),
89
+ result: await adapter.getResult(id),
82
90
  },
83
91
  };
84
92
  },
85
- 'job:listAll': (queueManager, command) => {
93
+ 'job:listAll': async (adapter, command) => {
86
94
  const limit = command.limit ?? 50;
87
95
  const offset = command.offset ?? 0;
88
96
  const states = command.state
89
97
  ? command.state.split(',')
90
98
  : ['waiting', 'active', 'delayed', 'completed', 'failed'];
91
99
  const allJobs = [];
92
- for (const name of queueManager.listQueues()) {
93
- const jobs = queueManager.getJobs(name, { state: states, start: 0, end: 999 });
94
- for (const job of jobs)
100
+ const source = await adapter.readSnapshotSource();
101
+ for (const { job, state } of source.jobs) {
102
+ if (states.includes(state))
95
103
  allJobs.push(mapCloudCommandJob(job));
96
104
  }
97
105
  allJobs.sort((a, b) => b.timestamp - a.timestamp);
@@ -102,10 +110,10 @@ export const JOB_COMMANDS = {
102
110
  limit,
103
111
  };
104
112
  },
105
- 'dlq:retry': (queueManager, command) => ({
106
- retried: queueManager.retryDlq(command.queue ?? '', command.jobId ? jobId(command.jobId) : undefined),
113
+ 'dlq:retry': async (adapter, command) => ({
114
+ retried: await adapter.retryDlq(command.queue ?? '', command.jobId ? jobId(command.jobId) : undefined),
107
115
  }),
108
- 'dlq:purge': (queueManager, command) => ({
109
- purged: queueManager.purgeDlq(command.queue ?? ''),
116
+ 'dlq:purge': async (adapter, command) => ({
117
+ purged: await adapter.purgeDlq(command.queue ?? ''),
110
118
  }),
111
119
  };
@@ -1,94 +1,94 @@
1
+ import { DEFAULT_DLQ_CONFIG } from '../../../domain/types/dlq';
2
+ import { DEFAULT_STALL_CONFIG } from '../../../domain/types/stall';
1
3
  import { mapCloudCommandJob } from './jobMapper';
2
4
  export const QUEUE_COMMANDS = {
3
- 'queue:pause': (queueManager, command) => {
4
- queueManager.pause(command.queue ?? '');
5
+ 'queue:pause': async (adapter, command) => {
6
+ await adapter.pause(command.queue ?? '', true);
5
7
  return { queue: command.queue, paused: true };
6
8
  },
7
- 'queue:resume': (queueManager, command) => {
8
- queueManager.resume(command.queue ?? '');
9
+ 'queue:resume': async (adapter, command) => {
10
+ await adapter.pause(command.queue ?? '', false);
9
11
  return { queue: command.queue, paused: false };
10
12
  },
11
- 'queue:drain': (queueManager, command) => {
12
- const count = queueManager.drain(command.queue ?? '');
13
+ 'queue:drain': async (adapter, command) => {
14
+ const count = await adapter.drain(command.queue ?? '');
13
15
  return { queue: command.queue, drained: count };
14
16
  },
15
- 'queue:clean': (queueManager, command) => {
16
- const ids = queueManager.clean(command.queue ?? '', command.graceMs ?? 0, command.state, command.limit);
17
+ 'queue:clean': async (adapter, command) => {
18
+ const ids = await adapter.clean(command.queue ?? '', command.graceMs ?? 0, command.state, command.limit);
17
19
  return { queue: command.queue, cleaned: ids.length, ids };
18
20
  },
19
- 'queue:obliterate': (queueManager, command) => {
20
- queueManager.obliterate(command.queue ?? '');
21
+ 'queue:obliterate': async (adapter, command) => {
22
+ await adapter.obliterate(command.queue ?? '');
21
23
  return { queue: command.queue, obliterated: true };
22
24
  },
23
- 'queue:promoteAll': async (queueManager, command) => {
25
+ 'queue:promoteAll': async (adapter, command) => {
24
26
  const limit = command.limit ?? 1000;
25
- const jobs = queueManager.getJobs(command.queue ?? '', {
26
- state: ['delayed'],
27
- start: 0,
28
- end: limit - 1,
29
- });
30
- let promoted = 0;
31
- for (const job of jobs) {
32
- try {
33
- await queueManager.promote(job.id);
34
- promoted++;
35
- }
36
- catch {
37
- // Skip jobs that can no longer be promoted.
38
- }
39
- }
27
+ const promoted = await adapter.promoteAll(command.queue ?? '', limit);
40
28
  return { queue: command.queue, promoted };
41
29
  },
42
- 'queue:retryCompleted': (queueManager, command) => {
43
- const count = queueManager.retryCompleted(command.queue ?? '');
30
+ 'queue:retryCompleted': async (adapter, command) => {
31
+ const count = await adapter.retryCompleted(command.queue ?? '');
44
32
  return { queue: command.queue, retried: count };
45
33
  },
46
- 'queue:rateLimit': (queueManager, command) => {
47
- queueManager.setRateLimit(command.queue ?? '', command.max ?? 100);
34
+ 'queue:rateLimit': async (adapter, command) => {
35
+ await adapter.setRateLimit(command.queue ?? '', command.max ?? 100);
48
36
  return { queue: command.queue, rateLimit: command.max ?? 100 };
49
37
  },
50
- 'queue:clearRateLimit': (queueManager, command) => {
51
- queueManager.clearRateLimit(command.queue ?? '');
38
+ 'queue:clearRateLimit': async (adapter, command) => {
39
+ await adapter.setRateLimit(command.queue ?? '', null);
52
40
  return { queue: command.queue, rateLimit: null };
53
41
  },
54
- 'queue:concurrency': (queueManager, command) => {
55
- queueManager.setConcurrency(command.queue ?? '', command.concurrency ?? 10);
42
+ 'queue:concurrency': async (adapter, command) => {
43
+ await adapter.setConcurrency(command.queue ?? '', command.concurrency ?? 10);
56
44
  return { queue: command.queue, concurrency: command.concurrency ?? 10 };
57
45
  },
58
- 'queue:clearConcurrency': (queueManager, command) => {
59
- queueManager.clearConcurrency(command.queue ?? '');
46
+ 'queue:clearConcurrency': async (adapter, command) => {
47
+ await adapter.setConcurrency(command.queue ?? '', null);
60
48
  return { queue: command.queue, concurrency: null };
61
49
  },
62
- 'queue:stallConfig': (queueManager, command) => {
63
- queueManager.setStallConfig(command.queue ?? '', command.config ?? {});
50
+ 'queue:stallConfig': async (adapter, command) => {
51
+ await adapter.setStallConfig(command.queue ?? '', command.config ?? {});
64
52
  return { queue: command.queue, stallConfig: command.config };
65
53
  },
66
- 'queue:dlqConfig': (queueManager, command) => {
67
- queueManager.setDlqConfig(command.queue ?? '', command.config ?? {});
54
+ 'queue:dlqConfig': async (adapter, command) => {
55
+ await adapter.setDlqConfig(command.queue ?? '', command.config ?? {});
68
56
  return { queue: command.queue, dlqConfig: command.config };
69
57
  },
70
- 'queue:detail': (queueManager, command) => {
58
+ 'queue:detail': async (adapter, command) => {
71
59
  const queue = command.queue ?? '';
72
- const counts = queueManager.getQueueJobCounts(queue);
73
- const paused = queueManager.isPaused(queue);
74
- const stallConfig = queueManager.getStallConfig(queue);
75
- const dlqConfig = queueManager.getDlqConfig(queue);
76
- const dlqEntries = queueManager.getDlqEntries(queue).slice(0, 50);
77
- const jobs = queueManager.getJobs(queue, {
60
+ const source = await adapter.readSnapshotSource([queue]);
61
+ const view = source.queues.find(({ name }) => name === queue);
62
+ const counts = view?.counts ?? {
63
+ waiting: 0,
64
+ prioritized: 0,
65
+ delayed: 0,
66
+ active: 0,
67
+ completed: 0,
68
+ failed: 0,
69
+ 'waiting-children': 0,
70
+ totalCompleted: 0,
71
+ totalFailed: 0,
72
+ };
73
+ const dlqEntries = source.dlqEntries.filter((entry) => entry.job.queue === queue).slice(0, 50);
74
+ const jobs = await adapter.listJobs(queue, {
78
75
  state: ['waiting', 'active', 'delayed', 'completed', 'failed'],
79
76
  start: 0,
80
- end: 49,
77
+ end: 50,
81
78
  });
82
79
  return {
83
80
  queue,
84
- paused,
81
+ paused: view?.paused ?? false,
85
82
  counts,
86
83
  stallConfig: {
87
- enabled: stallConfig.enabled,
88
- stallInterval: stallConfig.stallInterval,
89
- maxStalls: stallConfig.maxStalls,
84
+ enabled: view?.stallConfig.enabled ?? DEFAULT_STALL_CONFIG.enabled,
85
+ stallInterval: view?.stallConfig.stallInterval ?? DEFAULT_STALL_CONFIG.stallInterval,
86
+ maxStalls: view?.stallConfig.maxStalls ?? DEFAULT_STALL_CONFIG.maxStalls,
87
+ },
88
+ dlqConfig: {
89
+ maxRetries: view?.dlqConfig.maxAutoRetries ?? DEFAULT_DLQ_CONFIG.maxAutoRetries,
90
+ maxAge: view?.dlqConfig.maxAge ?? DEFAULT_DLQ_CONFIG.maxAge ?? 0,
90
91
  },
91
- dlqConfig: { maxRetries: dlqConfig.maxAutoRetries, maxAge: dlqConfig.maxAge ?? 0 },
92
92
  dlqEntries: dlqEntries.map((entry) => ({
93
93
  jobId: String(entry.job.id),
94
94
  reason: entry.reason,
@@ -99,28 +99,14 @@ export const QUEUE_COMMANDS = {
99
99
  jobs: jobs.map(mapCloudCommandJob),
100
100
  };
101
101
  },
102
- 'queue:list': (queueManager) => {
103
- const queueNames = queueManager.listQueues();
104
- const countsByQueue = queueManager.getAllQueueJobCounts();
105
- const queues = queueNames.flatMap((name) => {
106
- const counts = countsByQueue.get(name);
107
- if (!counts)
108
- return [];
109
- return {
110
- name,
111
- waiting: counts.waiting,
112
- prioritized: counts.prioritized,
113
- delayed: counts.delayed,
114
- active: counts.active,
115
- completed: counts.completed,
116
- failed: counts.failed,
117
- 'waiting-children': counts['waiting-children'],
118
- paused: queueManager.isPaused(name),
119
- totalCompleted: counts.totalCompleted,
120
- totalFailed: counts.totalFailed,
121
- };
122
- });
102
+ 'queue:list': async (adapter) => {
103
+ const source = await adapter.readSnapshotSource();
104
+ const queues = source.queues.map(({ name, counts, paused }) => ({
105
+ name,
106
+ ...counts,
107
+ paused,
108
+ }));
123
109
  return { queues };
124
110
  },
125
- 'stats:refresh': (queueManager) => queueManager.getStats(),
111
+ 'stats:refresh': async (adapter) => (await adapter.readSnapshotSource()).stats,
126
112
  };
@@ -0,0 +1,41 @@
1
+ import type { QueueManager } from '../../../application/queueManager';
2
+ import type { CronJobInput } from '../../../domain/types/cron';
3
+ import type { JobId } from '../../../domain/types/job';
4
+ import type { CloudQueueAdapter, CloudSnapshotSource } from './types';
5
+ /** SQLite/local Cloud strategy; delegates to the existing synchronous semantics. */
6
+ export declare class LocalCloudQueueAdapter implements CloudQueueAdapter {
7
+ readonly manager: QueueManager;
8
+ constructor(manager: QueueManager);
9
+ pause(queue: string, paused: boolean): Promise<void>;
10
+ drain(queue: string): Promise<number>;
11
+ clean(queue: string, graceMs: number, state?: string, limit?: number): Promise<JobId[]>;
12
+ obliterate(queue: string): Promise<void>;
13
+ promoteAll(queue: string, limit: number): Promise<number>;
14
+ retryCompleted(queue: string): Promise<number>;
15
+ setRateLimit(queue: string, limit: number | null): Promise<void>;
16
+ setConcurrency(queue: string, limit: number | null): Promise<void>;
17
+ setStallConfig(queue: string, patch: Record<string, unknown>): Promise<void>;
18
+ setDlqConfig(queue: string, patch: Record<string, unknown>): Promise<void>;
19
+ listJobs(queue: string, options?: {
20
+ state?: string | string[];
21
+ start?: number;
22
+ end?: number;
23
+ asc?: boolean;
24
+ }): Promise<import("../../../domain/types").Job[]>;
25
+ getJob(id: JobId): Promise<import("../../../domain/types").Job | null>;
26
+ getLogs(id: JobId): Promise<import("../../../domain/types/worker").JobLogEntry[]>;
27
+ getResult(id: JobId): Promise<unknown>;
28
+ clearLogs(id: JobId, keepLogs?: number): Promise<void>;
29
+ retryDlq(queue: string, id?: JobId): Promise<number>;
30
+ purgeDlq(queue: string): Promise<number>;
31
+ push(queue: string, input: Parameters<QueueManager['push']>[1]): Promise<import("../../../domain/types").Job>;
32
+ cancel(id: JobId): Promise<boolean>;
33
+ promote(id: JobId): Promise<boolean>;
34
+ changePriority(id: JobId, priority: number): Promise<boolean>;
35
+ discard(id: JobId): Promise<boolean>;
36
+ changeDelay(id: JobId, delay: number): Promise<boolean>;
37
+ updateData(id: JobId, data: unknown): Promise<boolean>;
38
+ addCron(input: CronJobInput): Promise<import("../../../domain/types").CronJob>;
39
+ removeCron(name: string): Promise<boolean>;
40
+ readSnapshotSource(requestedQueues?: readonly string[]): Promise<CloudSnapshotSource>;
41
+ }
@@ -0,0 +1,187 @@
1
+ const SNAPSHOT_STATES = [
2
+ 'waiting',
3
+ 'active',
4
+ 'delayed',
5
+ 'failed',
6
+ 'completed',
7
+ 'prioritized',
8
+ 'paused',
9
+ 'waiting-children',
10
+ ];
11
+ /** SQLite/local Cloud strategy; delegates to the existing synchronous semantics. */
12
+ export class LocalCloudQueueAdapter {
13
+ manager;
14
+ constructor(manager) {
15
+ this.manager = manager;
16
+ }
17
+ pause(queue, paused) {
18
+ if (paused)
19
+ this.manager.pause(queue);
20
+ else
21
+ this.manager.resume(queue);
22
+ return Promise.resolve();
23
+ }
24
+ drain(queue) {
25
+ return Promise.resolve(this.manager.drain(queue));
26
+ }
27
+ clean(queue, graceMs, state, limit) {
28
+ return Promise.resolve(this.manager.clean(queue, graceMs, state, limit));
29
+ }
30
+ obliterate(queue) {
31
+ this.manager.obliterate(queue);
32
+ return Promise.resolve();
33
+ }
34
+ async promoteAll(queue, limit) {
35
+ const jobs = this.manager.getJobs(queue, { state: ['delayed'], start: 0, end: limit });
36
+ let promoted = 0;
37
+ for (const job of jobs) {
38
+ try {
39
+ if (await this.manager.promote(job.id))
40
+ promoted++;
41
+ }
42
+ catch {
43
+ // The job may have moved since the command selected it.
44
+ }
45
+ }
46
+ return promoted;
47
+ }
48
+ retryCompleted(queue) {
49
+ return Promise.resolve(this.manager.retryCompleted(queue));
50
+ }
51
+ setRateLimit(queue, limit) {
52
+ if (limit === null)
53
+ this.manager.clearRateLimit(queue);
54
+ else
55
+ this.manager.setRateLimit(queue, limit);
56
+ return Promise.resolve();
57
+ }
58
+ setConcurrency(queue, limit) {
59
+ if (limit === null)
60
+ this.manager.clearConcurrency(queue);
61
+ else
62
+ this.manager.setConcurrency(queue, limit);
63
+ return Promise.resolve();
64
+ }
65
+ setStallConfig(queue, patch) {
66
+ this.manager.setStallConfig(queue, patch);
67
+ return Promise.resolve();
68
+ }
69
+ setDlqConfig(queue, patch) {
70
+ this.manager.setDlqConfig(queue, patch);
71
+ return Promise.resolve();
72
+ }
73
+ listJobs(queue, options = {}) {
74
+ return Promise.resolve(this.manager.getJobs(queue, options));
75
+ }
76
+ async getJob(id) {
77
+ return await this.manager.getJob(id);
78
+ }
79
+ getLogs(id) {
80
+ return Promise.resolve(this.manager.getLogs(id));
81
+ }
82
+ getResult(id) {
83
+ return Promise.resolve(this.manager.getResult(id) ?? null);
84
+ }
85
+ clearLogs(id, keepLogs) {
86
+ this.manager.clearLogs(id, keepLogs);
87
+ return Promise.resolve();
88
+ }
89
+ retryDlq(queue, id) {
90
+ return Promise.resolve(this.manager.retryDlq(queue, id));
91
+ }
92
+ purgeDlq(queue) {
93
+ return Promise.resolve(this.manager.purgeDlq(queue));
94
+ }
95
+ async push(queue, input) {
96
+ return await this.manager.push(queue, input);
97
+ }
98
+ async cancel(id) {
99
+ return await this.manager.cancel(id);
100
+ }
101
+ async promote(id) {
102
+ return await this.manager.promote(id);
103
+ }
104
+ async changePriority(id, priority) {
105
+ return await this.manager.changePriority(id, priority);
106
+ }
107
+ async discard(id) {
108
+ return await this.manager.discard(id);
109
+ }
110
+ async changeDelay(id, delay) {
111
+ return await this.manager.changeDelay(id, delay);
112
+ }
113
+ async updateData(id, data) {
114
+ return await this.manager.updateJobData(id, data);
115
+ }
116
+ addCron(input) {
117
+ return Promise.resolve(this.manager.addCron(input));
118
+ }
119
+ removeCron(name) {
120
+ return Promise.resolve(this.manager.removeCron(name));
121
+ }
122
+ readSnapshotSource(requestedQueues = []) {
123
+ const queueNames = new Set([...this.manager.listQueues(), ...requestedQueues]);
124
+ const counts = this.manager.getQueueJobCountsBatch(queueNames);
125
+ const queues = [];
126
+ const jobs = [];
127
+ const dlqEntries = [];
128
+ for (const name of queueNames) {
129
+ try {
130
+ const queueCounts = counts.get(name);
131
+ if (!queueCounts)
132
+ continue;
133
+ const limits = this.manager.getQueueLimits(name);
134
+ queues.push({
135
+ name,
136
+ counts: queueCounts,
137
+ paused: this.manager.isPaused(name),
138
+ rateLimit: limits.rateLimit,
139
+ concurrencyLimit: limits.concurrencyLimit,
140
+ stallConfig: this.manager.getStallConfig(name),
141
+ dlqConfig: this.manager.getDlqConfig(name),
142
+ });
143
+ }
144
+ catch {
145
+ // Preserve the local collector's per-queue best-effort behavior.
146
+ }
147
+ for (const state of SNAPSHOT_STATES) {
148
+ try {
149
+ for (const job of this.manager.getJobs(name, { state: [state], start: 0, end: 1000 })) {
150
+ jobs.push({ job, state });
151
+ }
152
+ }
153
+ catch {
154
+ // Preserve the local collector's per-state best-effort behavior.
155
+ }
156
+ }
157
+ try {
158
+ dlqEntries.push(...this.manager.getDlqEntries(name));
159
+ }
160
+ catch {
161
+ // Preserve the local collector's per-queue best-effort behavior.
162
+ }
163
+ }
164
+ const jobResults = new Map();
165
+ for (const [id, result] of this.manager.getAllJobResults()) {
166
+ jobResults.set(String(id), result);
167
+ }
168
+ const jobLogs = new Map();
169
+ for (const [id, logs] of this.manager.getAllJobLogs())
170
+ jobLogs.set(String(id), logs);
171
+ return Promise.resolve({
172
+ stats: this.manager.getStats(),
173
+ queues,
174
+ jobs,
175
+ dlqEntries,
176
+ workers: this.manager.workerManager.list(),
177
+ workerStats: this.manager.workerManager.getStats(),
178
+ crons: this.manager.listCrons(),
179
+ jobResults,
180
+ jobLogs,
181
+ activeLocks: [...this.manager.getAllJobLocks().values()].map((lock) => ({
182
+ ...lock,
183
+ jobId: String(lock.jobId),
184
+ })),
185
+ });
186
+ }
187
+ }
@@ -0,0 +1,42 @@
1
+ import { PostgresQueueManager } from '../../../application/postgresQueueManager';
2
+ import type { CronJobInput } from '../../../domain/types/cron';
3
+ import type { JobId } from '../../../domain/types/job';
4
+ import type { CloudQueueAdapter, CloudSnapshotSource } from './types';
5
+ /** PostgreSQL Cloud strategy; every shared surface goes through durable APIs. */
6
+ export declare class PostgresCloudQueueAdapter implements CloudQueueAdapter {
7
+ readonly manager: PostgresQueueManager;
8
+ constructor(manager: PostgresQueueManager);
9
+ pause: (queue: string, paused: boolean) => Promise<void>;
10
+ drain: (queue: string) => Promise<number>;
11
+ clean: (queue: string, graceMs: number, state?: string, limit?: number) => Promise<JobId[]>;
12
+ obliterate: (queue: string) => Promise<void>;
13
+ promoteAll: (queue: string, limit: number) => Promise<number>;
14
+ retryCompleted: (queue: string) => Promise<number>;
15
+ setRateLimit: (queue: string, limit: number | null) => Promise<void>;
16
+ setConcurrency: (queue: string, limit: number | null) => Promise<void>;
17
+ setStallConfig: (queue: string, patch: Record<string, unknown>) => Promise<void>;
18
+ setDlqConfig: (queue: string, patch: Record<string, unknown>) => Promise<void>;
19
+ listJobs: (queue: string, options?: {
20
+ state?: string | string[];
21
+ start?: number;
22
+ end?: number;
23
+ asc?: boolean;
24
+ }) => Promise<import("../../../domain/types").Job[]>;
25
+ getJob: (id: JobId) => Promise<import("../../../domain/types").Job | null>;
26
+ getLogs: (id: JobId) => Promise<import("../../../domain/types/worker").JobLogEntry[]>;
27
+ getResult: (id: JobId) => Promise<unknown>;
28
+ clearLogs: (id: JobId, keepLogs?: number) => Promise<void>;
29
+ retryDlq: (queue: string, id?: JobId) => Promise<number>;
30
+ purgeDlq: (queue: string) => Promise<number>;
31
+ push: (queue: string, input: Parameters<PostgresQueueManager["push"]>[1]) => Promise<import("../../../domain/types").Job>;
32
+ cancel: (id: JobId) => Promise<boolean>;
33
+ promote: (id: JobId) => Promise<boolean>;
34
+ changePriority: (id: JobId, priority: number) => Promise<boolean>;
35
+ discard: (id: JobId) => Promise<boolean>;
36
+ changeDelay: (id: JobId, delay: number) => Promise<boolean>;
37
+ updateData: (id: JobId, data: unknown) => Promise<boolean>;
38
+ addCron: (input: CronJobInput) => Promise<import("../../../domain/types").CronJob>;
39
+ removeCron: (name: string) => Promise<boolean>;
40
+ readSnapshotSource(requestedQueues?: readonly string[]): Promise<CloudSnapshotSource>;
41
+ private toSnapshotSource;
42
+ }