@ddd-ts-kit/scheduling 0.9.0 → 0.11.0

package/README.md

@@ -1,9 +1,11 @@
 # @ddd-ts-kit/scheduling
 
-Scheduled jobs for a project built with the kit. A job is a class of the application layer that
-says when it runs and triggers use cases: it decides nothing, the business rules stay in the
-domain. The scheduler opens an execution scope around each run, makes sure one instance of the
-application runs a given occurrence, and records what became of it.
+Scheduled jobs and background jobs for a project built with the kit. A scheduled job is a class
+of the application layer that says when it runs and triggers use cases: it decides nothing, the
+business rules stay in the domain. The scheduler opens an execution scope around each run, makes
+sure one instance of the application runs a given occurrence, and records what became of it. A
+background job is enqueued by a use case and run later by the worker of this package (see
+"Background jobs" below).
 
 ```
 npm i @ddd-ts-kit/scheduling
@@ -11,7 +13,7 @@ npm i @ddd-ts-kit/scheduling
 
 | Entry | Holds | Imports |
 |---|---|---|
-| `@ddd-ts-kit/scheduling` | `InProcessJobScheduler`, `nextOccurrence`, `latestOccurrence`, `systemJobTimers`, the `JobTimers` and `JobCheckpoints` ports, `JobTimeoutError`, `JobAbortedError`, `JobLockUnavailableError`, the metric names | the kernel |
+| `@ddd-ts-kit/scheduling` | `InProcessJobScheduler`, `nextOccurrence`, `latestOccurrence`, `systemJobTimers`, the `JobTimers` and `JobCheckpoints` ports, `JobTimeoutError`, `JobAbortedError`, `JobLockUnavailableError`, the metric names; for background jobs `QueueWorker`, `StoredJobQueue`, the `JobStore` port, `InMemoryJobStore`, `reportFailedBackgroundJobs`, `JobInterruptedError`, `InvalidEnqueueError` | the kernel |
 | `@ddd-ts-kit/scheduling/testing` | `ManualJobScheduler`, `ManualJobTimers` | the kernel |
 
 The declaration (`@Scheduled`), the port (`JobScheduler`) and the schedule parser live in
@@ -422,6 +424,67 @@ expect(scheduler.runs.map((run) => run.scheduledAt.toISOString())).toEqual(['202
 Another scheduler (on a database, on a queue) implements the `JobScheduler` port of the kernel
 and passes `jobSchedulerContract` of `@ddd-ts-kit/testing/contracts`.
 
+## Background jobs
+
+Work a use case hands to a worker, to run later: the port (`JobQueue`), the declaration
+(`@Background`) and the payload type live in the kernel; this package runs them. Why and when,
+with the guarantees: [Background jobs](../../docs/concepts/background-jobs.md).
+
+| Piece | |
+|---|---|
+| `StoredJobQueue` | the `JobQueue` of the kernel on a `JobStore`: names the job, captures the correlation, the actor, the tenant and the `traceparent` of the work that enqueues, adds it to the store; `find` and `cancel` reach the jobs of the tenant of the work in progress only (those of an elevation's tenants; every job without a tenant) |
+| `JobStore` | the port of the stores: `add`, `claim` (a lease), `heartbeat`, `update` (progress, checkpoint), `complete`, `fail`, `release`, `cancel`, `find`, `retryDead`, `purgeFinished`, `stats`; every report names its attempt (`JobLease`) |
+| `InMemoryJobStore` | the store of tests and of a process without a database: `add`, `cancel` and `retryDead` wait for the commit of the unit of work; `list()` for assertions |
+| `tenantKeyOf(enqueuedBy)` | the tenant part of the idempotency key, for a store that keeps it in a unique index: the tenant, or the empty text |
+| `QueueWorker` | claims and runs the jobs of the queues it has jobs for: `register`, `start`, `stop` (waits for a claim in flight, whose jobs go back uncounted, then for the attempts in progress), `runDue` |
+| `reportFailedBackgroundJobs(reporter)` | the observer that sends an attempt that failed unexpectedly to the error reporter |
+
+```ts
+const store = new InMemoryJobStore(); // KnexJobStore, DrizzleJobStore or RedisJobStore in production
+const jobs = new StoredJobQueue({ store, clock, ids, scope, traceparent: captureTraceparent });
+
+const worker = new QueueWorker({
+  store,
+  clock,
+  scope,
+  logger,
+  metrics,
+  concurrency: { scheduling: 4, default: 1 },
+  onRun: reportFailedBackgroundJobs(errors),
+});
+
+worker.register({ name: CompileStatementsBackgroundJob.jobName, options: { maxAttempts: 3 }, run: (payload, execution) => job.run(payload, execution) });
+await worker.start();
+```
+
+`@ddd-ts-kit/di` does all of it: `kernelModule({ jobStore })` binds the store, the queue and the
+worker, the declared jobs are registered on the worker, and the worker runs in the processes
+that run the jobs (`jobs: { start: true }`).
+
+| Option of `QueueWorker` | Default | |
+|---|---|---|
+| `concurrency` | `1` | attempts of one queue at once in this process: a number, or `{ <queue>: n, default: n }` |
+| `pollIntervalMs` | `1000` | how long an idle queue waits before asking the store again |
+| `graceMs` | `30000` | how long `stop()` waits for the attempts in progress before aborting them; an aborted attempt gives its job back uncounted |
+| `timers` | the runtime | `ManualJobTimers` in a spec |
+
+Each attempt is recorded as a `BackgroundJobRun` (`succeeded`, `retried`, `dead`, `released`,
+`interrupted`), logged at `info`, `warn` or `error`, and counted in `background_job_runs_total`
+and `background_job_duration_ms` (`BACKGROUND_RUNS_COUNTER`, `BACKGROUND_DURATION_HISTOGRAM`),
+labelled `job`, `context`, `status` and `error_code`. A store of your own passes
+`jobStoreContract` of `@ddd-ts-kit/testing/contracts`, with its unit of work.
+
+## Process managers
+
+`StoredProcessRunner` is the `ProcessRunner` of the kernel: `new StoredProcessRunner({ store,
+jobs, commands, unitOfWork })`. A step runs in one unit of work: the instance is loaded, the step
+decides, the timeouts it disarms are cancelled and those it arms are enqueued on the `JobQueue`
+as delayed jobs of the `timeoutJob` of the process (`NoTimeoutJobError` without one), the state
+is saved at the next version, then the commands are sent. `timeout(process, { id, timeout,
+jobId }, step)` runs only while `jobId` is the armed job of that timeout. `@ddd-ts-kit/di` binds
+it on `ProcessStore`, `JobQueue`, `CommandBus` and `UnitOfWork`. See
+[Sagas and process managers](../../docs/concepts/sagas-and-process-managers.md).
+
 ## Limits
 
 - **No persistence of its own.** Runs, outcomes and `lastRun` live in the memory of the
@@ -433,8 +496,11 @@ and passes `jobSchedulerContract` of `@ddd-ts-kit/testing/contracts`.
   possible and rarely wise, as each occurrence costs a lock.
 - **At most once per occurrence is best effort**, as said above. Exactly-once does not exist
   here.
-- **Not a queue.** A job does a bounded amount of work on a schedule. Work that arrives, must
-  not be lost and must be retried belongs to the outbox and to integration events.
+- **The scheduler is not a queue.** A scheduled job does a bounded amount of work on a
+  schedule. Work a command asks for, which must not be lost and must be retried, is a
+  background job (above).
+- **The worker:** at least once, no ordering, concurrency per process, polling: see the limits
+  of [Background jobs](../../docs/concepts/background-jobs.md).
 - **One process, one event loop.** A job that blocks the loop delays every other job; past
   `lateAfterMs` their occurrences are missed.
 - **Time zone rules are those of the runtime.** A zone whose rules changed needs an updated

package/dist/index.d.ts

@@ -8,7 +8,31 @@ export { JobAbortedError } from './errors/job-aborted-error.js';
 export { JobLockUnavailableError } from './errors/job-lock-unavailable-error.js';
 export { JobTimeoutError } from './errors/job-timeout-error.js';
 export { UNEXPECTED_ERROR } from './errors/error-code-of.js';
-export { DURATION_HISTOGRAM, RUNS_COUNTER } from './metric-names.js';
+export { BACKGROUND_DURATION_HISTOGRAM, BACKGROUND_RUNS_COUNTER, DURATION_HISTOGRAM, RUNS_COUNTER, } from './metric-names.js';
 export type { JobRunDetail, JobRunObserver } from './job-run-observer.js';
 export { reportFailedRuns } from './report-failed-runs.js';
+export { QueueWorker } from './queue/queue-worker.js';
+export type { QueueWorkerOptions } from './queue/queue-worker-options.js';
+export { StoredJobQueue, type StoredJobQueueOptions } from './queue/stored-job-queue.js';
+export type { BackgroundJobDefinition } from './queue/background-job-definition.js';
+export type { BackgroundJobObserver } from './queue/background-job-observer.js';
+export type { BackgroundJobOutcome } from './queue/background-job-outcome.js';
+export type { BackgroundJobRun } from './queue/background-job-run.js';
+export { reportFailedBackgroundJobs } from './queue/report-failed-background-jobs.js';
+export { InvalidEnqueueError } from './queue/errors/invalid-enqueue-error.js';
+export { JobInterruptedError } from './queue/errors/job-interrupted-error.js';
+export { UnknownBackgroundJobError } from './queue/errors/unknown-background-job-error.js';
+export { AttemptsExhaustedError } from './queue/errors/attempts-exhausted-error.js';
+export { JobStore } from './queue/store/job-store.js';
+export { InMemoryJobStore } from './queue/store/in-memory-job-store.js';
+export type { ClaimRequest } from './queue/store/claim-request.js';
+export type { ClaimedJob } from './queue/store/claimed-job.js';
+export type { JobFailure } from './queue/store/job-failure.js';
+export type { JobLease } from './queue/store/job-lease.js';
+export type { JobStoreStats } from './queue/store/job-store-stats.js';
+export type { JobUpdate } from './queue/store/job-update.js';
+export type { NewJob } from './queue/store/new-job.js';
+export { tenantKeyOf } from './queue/store/tenant-key-of.js';
+export { StoredProcessRunner, type StoredProcessRunnerOptions } from './process/stored-process-runner.js';
+export { NoTimeoutJobError } from './process/no-timeout-job-error.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzF,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,YAAY,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,YAAY,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -8,6 +8,18 @@ export { JobAbortedError } from './errors/job-aborted-error.js';
 export { JobLockUnavailableError } from './errors/job-lock-unavailable-error.js';
 export { JobTimeoutError } from './errors/job-timeout-error.js';
 export { UNEXPECTED_ERROR } from './errors/error-code-of.js';
-export { DURATION_HISTOGRAM, RUNS_COUNTER } from './metric-names.js';
+export { BACKGROUND_DURATION_HISTOGRAM, BACKGROUND_RUNS_COUNTER, DURATION_HISTOGRAM, RUNS_COUNTER, } from './metric-names.js';
 export { reportFailedRuns } from './report-failed-runs.js';
+export { QueueWorker } from './queue/queue-worker.js';
+export { StoredJobQueue } from './queue/stored-job-queue.js';
+export { reportFailedBackgroundJobs } from './queue/report-failed-background-jobs.js';
+export { InvalidEnqueueError } from './queue/errors/invalid-enqueue-error.js';
+export { JobInterruptedError } from './queue/errors/job-interrupted-error.js';
+export { UnknownBackgroundJobError } from './queue/errors/unknown-background-job-error.js';
+export { AttemptsExhaustedError } from './queue/errors/attempts-exhausted-error.js';
+export { JobStore } from './queue/store/job-store.js';
+export { InMemoryJobStore } from './queue/store/in-memory-job-store.js';
+export { tenantKeyOf } from './queue/store/tenant-key-of.js';
+export { StoredProcessRunner } from './process/stored-process-runner.js';
+export { NoTimeoutJobError } from './process/no-timeout-job-error.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAqC,MAAM,+BAA+B,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAqC,MAAM,+BAA+B,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAA8B,MAAM,6BAA6B,CAAC;AAKzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAQxE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAmC,MAAM,oCAAoC,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/job-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-runner.d.ts","sourceRoot":"","sources":["../src/job-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACpC;AASD,yFAAyF;AACzF,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAF3B,YACmB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,WAAW,EACpC;IAEJ,YAAY,IAAI,OAAO,CAEtB;IAED,4DAA4D;IACtD,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAQrE;YAOa,KAAK;YAkBL,OAAO;IAsBrB,OAAO,CAAC,UAAU;YAYJ,OAAO;YAUP,QAAQ;CAiBvB"}
+{"version":3,"file":"job-runner.d.ts","sourceRoot":"","sources":["../src/job-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACpC;AASD,yFAAyF;AACzF,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAF3B,YACmB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,WAAW,EACpC;IAEJ,YAAY,IAAI,OAAO,CAEtB;IAED,4DAA4D;IACtD,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAQrE;YAOa,KAAK;YAkBL,OAAO;IAsBrB,OAAO,CAAC,UAAU;YAYJ,OAAO;YAUP,QAAQ;CAiBvB"}

package/dist/job-runner.js

@@ -1,6 +1,7 @@
 import { executionContextOfJob, } from '@ddd-ts-kit/kernel';
 import { JobLockUnavailableError } from './errors/job-lock-unavailable-error.js';
 import { JobTimeoutError } from './errors/job-timeout-error.js';
+import { unlessAborted } from './unless-aborted.js';
 /** Runs one occurrence: the lock of the occurrence, the execution scope, the timeout. */
 export class JobRunner {
     options;
@@ -108,17 +109,4 @@ async function eachTenant(tenants, signal, run) {
         throw failures[0];
     }
 }
-/** A job that ignores its signal is left behind: the run ends when the signal is aborted. */
-function unlessAborted(signal, work) {
-    return new Promise((resolve, reject) => {
-        signal.addEventListener('abort', () => {
-            reject(reasonOf(signal));
-        }, { once: true });
-        work.then(resolve, reject);
-    });
-}
-function reasonOf(signal) {
-    const reason = signal.reason;
-    return reason instanceof Error ? reason : new Error('The run was aborted.');
-}
 //# sourceMappingURL=job-runner.js.map

package/dist/job-runner.js.map

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

package/dist/metric-names.d.ts

@@ -1,3 +1,5 @@
 export declare const RUNS_COUNTER = "scheduled_job_runs_total";
 export declare const DURATION_HISTOGRAM = "scheduled_job_duration_ms";
+export declare const BACKGROUND_RUNS_COUNTER = "background_job_runs_total";
+export declare const BACKGROUND_DURATION_HISTOGRAM = "background_job_duration_ms";
 //# sourceMappingURL=metric-names.d.ts.map

package/dist/metric-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metric-names.d.ts","sourceRoot":"","sources":["../src/metric-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,6BAA6B,CAAC;AAEvD,eAAO,MAAM,kBAAkB,8BAA8B,CAAC"}
+{"version":3,"file":"metric-names.d.ts","sourceRoot":"","sources":["../src/metric-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,6BAA6B,CAAC;AAEvD,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAEnE,eAAO,MAAM,6BAA6B,+BAA+B,CAAC"}

package/dist/metric-names.js

@@ -1,3 +1,5 @@
 export const RUNS_COUNTER = 'scheduled_job_runs_total';
 export const DURATION_HISTOGRAM = 'scheduled_job_duration_ms';
+export const BACKGROUND_RUNS_COUNTER = 'background_job_runs_total';
+export const BACKGROUND_DURATION_HISTOGRAM = 'background_job_duration_ms';
 //# sourceMappingURL=metric-names.js.map

package/dist/metric-names.js.map

@@ -1 +1 @@
-{"version":3,"file":"metric-names.js","sourceRoot":"","sources":["../src/metric-names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC"}
+{"version":3,"file":"metric-names.js","sourceRoot":"","sources":["../src/metric-names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAE9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAEnE,MAAM,CAAC,MAAM,6BAA6B,GAAG,4BAA4B,CAAC"}

package/dist/process/no-timeout-job-error.d.ts

@@ -0,0 +1,6 @@
+/** A process armed a timeout and names no background job to deliver it. */
+export declare class NoTimeoutJobError extends Error {
+    readonly code = "NO_TIMEOUT_JOB";
+    constructor(process: string);
+}
+//# sourceMappingURL=no-timeout-job-error.d.ts.map

package/dist/process/no-timeout-job-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-timeout-job-error.d.ts","sourceRoot":"","sources":["../../src/process/no-timeout-job-error.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,oBAAoB;IAEjC,YAAY,OAAO,EAAE,MAAM,EAM1B;CACF"}

package/dist/process/no-timeout-job-error.js

@@ -0,0 +1,9 @@
+/** A process armed a timeout and names no background job to deliver it. */
+export class NoTimeoutJobError extends Error {
+    code = 'NO_TIMEOUT_JOB';
+    constructor(process) {
+        super(`Process "${process}" arms a timeout and has no static timeoutJob: name the background job that delivers it.`);
+        this.name = 'NoTimeoutJobError';
+    }
+}
+//# sourceMappingURL=no-timeout-job-error.js.map

package/dist/process/no-timeout-job-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-timeout-job-error.js","sourceRoot":"","sources":["../../src/process/no-timeout-job-error.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,GAAG,gBAAgB,CAAC;IAEjC,YAAY,OAAe;QACzB,KAAK,CACH,YAAY,OAAO,0FAA0F,CAC9G,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/process/stored-process-runner.d.ts

@@ -0,0 +1,24 @@
+import { type CommandBus, type JobQueue, type ProcessDecision, type ProcessRunner, type ProcessStore, type ProcessTimeoutDue, type ProcessType, type UnitOfWork } from '@ddd-ts-kit/kernel';
+export interface StoredProcessRunnerOptions {
+    readonly store: ProcessStore;
+    /** Where the timeouts are enqueued, as delayed background jobs. */
+    readonly jobs: JobQueue;
+    readonly commands: CommandBus;
+    /** The step, its state, its timeouts and its commands commit together. */
+    readonly unitOfWork: UnitOfWork;
+}
+/** The `ProcessRunner` of the kernel on a `ProcessStore` and a `JobQueue`. */
+export declare class StoredProcessRunner implements ProcessRunner {
+    private readonly options;
+    constructor(options: StoredProcessRunnerOptions);
+    run<State>(process: ProcessType<State>, id: string, step: (current: State | undefined) => ProcessDecision<State> | undefined): Promise<void>;
+    timeout<State>(process: ProcessType<State>, due: ProcessTimeoutDue & {
+        readonly jobId: string;
+    }, step: (current: State) => ProcessDecision<State> | undefined): Promise<void>;
+    /** Disarms, arms, saves, then sends the commands: everything in the unit of work of the step. */
+    private apply;
+    private disarm;
+    /** A timeout armed again replaces the one of the same name, whose job no longer counts. */
+    private arm;
+}
+//# sourceMappingURL=stored-process-runner.d.ts.map

package/dist/process/stored-process-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-process-runner.d.ts","sourceRoot":"","sources":["../../src/process/stored-process-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEhB,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAWD,8EAA8E;AAC9E,qBAAa,mBAAoB,YAAW,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,0BAA0B,EAAI;IAEpE,GAAG,CAAC,KAAK,EACP,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAC3B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,GAAG,SAAS,KAAK,eAAe,CAAC,KAAK,CAAC,GAAG,SAAS,GACvE,OAAO,CAAC,IAAI,CAAC,CAaf;IAED,OAAO,CAAC,KAAK,EACX,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAC3B,GAAG,EAAE,iBAAiB,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EACnD,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,KAAK,eAAe,CAAC,KAAK,CAAC,GAAG,SAAS,GAC3D,OAAO,CAAC,IAAI,CAAC,CAaf;IAED,iGAAiG;YACnF,KAAK;YA4BL,MAAM;IAYpB,2FAA2F;YAC7E,GAAG;CAqBlB"}

package/dist/process/stored-process-runner.js

@@ -0,0 +1,89 @@
+import { UnreadableProcessStateError, } from '@ddd-ts-kit/kernel';
+import { NoTimeoutJobError } from './no-timeout-job-error.js';
+/** The `ProcessRunner` of the kernel on a `ProcessStore` and a `JobQueue`. */
+export class StoredProcessRunner {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    run(process, id, step) {
+        return this.options.unitOfWork.run(async () => {
+            const stored = await this.options.store.load(process.processName, id);
+            if (stored?.ended === true) {
+                return;
+            }
+            const current = stored === undefined ? undefined : stateOf(process, stored);
+            const instance = { name: process.processName, id, stored, timeouts: stored?.timeouts ?? {} };
+            await this.apply(process, instance, step(current));
+        });
+    }
+    timeout(process, due, step) {
+        return this.options.unitOfWork.run(async () => {
+            const stored = await this.options.store.load(process.processName, due.id);
+            if (stored === undefined || stored.ended || stored.timeouts[due.timeout] !== due.jobId) {
+                return;
+            }
+            const timeouts = without(stored.timeouts, [due.timeout]);
+            const instance = { name: process.processName, id: due.id, stored, timeouts };
+            await this.apply(process, instance, step(stateOf(process, stored)));
+        });
+    }
+    /** Disarms, arms, saves, then sends the commands: everything in the unit of work of the step. */
+    async apply(process, instance, decision) {
+        if (decision === undefined) {
+            return;
+        }
+        const disarmed = await this.disarm(instance.timeouts, decision.cancel ?? []);
+        const timeouts = await this.arm(process, { ...instance, timeouts: disarmed }, decision);
+        const { name, id, stored } = instance;
+        const version = (stored?.version ?? 0) + 1;
+        await this.options.store.save({
+            name,
+            id,
+            state: decision.state,
+            version,
+            ended: decision.ended === true,
+            timeouts,
+        });
+        for (const command of decision.commands ?? []) {
+            await this.options.commands.execute(command);
+        }
+    }
+    async disarm(timeouts, names) {
+        for (const name of names) {
+            const jobId = timeouts[name];
+            if (jobId !== undefined) {
+                await this.options.jobs.cancel(jobId);
+            }
+        }
+        return without(timeouts, names);
+    }
+    /** A timeout armed again replaces the one of the same name, whose job no longer counts. */
+    async arm(process, instance, decision) {
+        let armed = instance.timeouts;
+        for (const { name, at } of decision.timeouts ?? []) {
+            armed = await this.disarm(armed, [name]);
+            const { id: jobId } = await this.options.jobs.enqueue(timeoutJobOf(process), { id: instance.id, timeout: name }, { runAt: at });
+            armed = { ...armed, [name]: jobId };
+        }
+        return armed;
+    }
+}
+function stateOf(process, stored) {
+    if (!process.isState(stored.state)) {
+        throw new UnreadableProcessStateError(process.processName, stored.id);
+    }
+    return stored.state;
+}
+function without(timeouts, names) {
+    return Object.fromEntries(Object.entries(timeouts).filter(([name]) => !names.includes(name)));
+}
+/** The background job that delivers the timeouts: the runner only names it, the context declares it. */
+function timeoutJobOf(process) {
+    const { timeoutJob } = process;
+    if (timeoutJob === undefined) {
+        throw new NoTimeoutJobError(process.processName);
+    }
+    return { jobName: timeoutJob, prototype: { run: () => Promise.resolve() } };
+}
+//# sourceMappingURL=stored-process-runner.js.map

package/dist/process/stored-process-runner.js.map

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

package/dist/queue/background-job-definition.d.ts

@@ -0,0 +1,9 @@
+import type { BackgroundJobExecution, BackgroundJobOptions } from '@ddd-ts-kit/kernel';
+/** A background job as a worker receives it. */
+export interface BackgroundJobDefinition {
+    /** `<context>.<job-name>`: its queue is the context. */
+    readonly name: string;
+    readonly options?: BackgroundJobOptions;
+    readonly run: (payload: unknown, execution: BackgroundJobExecution) => Promise<void>;
+}
+//# sourceMappingURL=background-job-definition.d.ts.map

package/dist/queue/background-job-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-definition.d.ts","sourceRoot":"","sources":["../../src/queue/background-job-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEvF,gDAAgD;AAChD,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF"}

package/dist/queue/background-job-definition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=background-job-definition.js.map

package/dist/queue/background-job-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-definition.js","sourceRoot":"","sources":["../../src/queue/background-job-definition.ts"],"names":[],"mappings":""}

package/dist/queue/background-job-observer.d.ts

@@ -0,0 +1,4 @@
+import type { BackgroundJobRun } from './background-job-run.js';
+/** Told of every attempt, with what the run threw when it failed: for an error tracker, or a test. */
+export type BackgroundJobObserver = (run: BackgroundJobRun, error?: unknown) => void;
+//# sourceMappingURL=background-job-observer.d.ts.map

package/dist/queue/background-job-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-observer.d.ts","sourceRoot":"","sources":["../../src/queue/background-job-observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,sGAAsG;AACtG,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC"}

package/dist/queue/background-job-observer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=background-job-observer.js.map

package/dist/queue/background-job-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-observer.js","sourceRoot":"","sources":["../../src/queue/background-job-observer.ts"],"names":[],"mappings":""}

package/dist/queue/background-job-outcome.d.ts

@@ -0,0 +1,9 @@
+/**
+ * - `succeeded`: the run ended and the job is over.
+ * - `retried`: the run failed and the job waits for its next attempt.
+ * - `dead`: the run failed and no attempt is left.
+ * - `released`: the worker stopped before the run ended; the job waits again, the attempt not counted.
+ * - `interrupted`: the job was cancelled, or another worker claimed it, while it ran.
+ */
+export type BackgroundJobOutcome = 'succeeded' | 'retried' | 'dead' | 'released' | 'interrupted';
+//# sourceMappingURL=background-job-outcome.d.ts.map

package/dist/queue/background-job-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-outcome.d.ts","sourceRoot":"","sources":["../../src/queue/background-job-outcome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC"}

package/dist/queue/background-job-outcome.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=background-job-outcome.js.map

package/dist/queue/background-job-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-outcome.js","sourceRoot":"","sources":["../../src/queue/background-job-outcome.ts"],"names":[],"mappings":""}

package/dist/queue/background-job-recorder.d.ts

@@ -0,0 +1,19 @@
+import type { Logger, Metrics } from '@ddd-ts-kit/kernel';
+import type { BackgroundJobObserver } from './background-job-observer.js';
+import type { BackgroundJobRun } from './background-job-run.js';
+export interface BackgroundJobRecorderOptions {
+    readonly logger: Logger;
+    readonly metrics: Metrics;
+    readonly onRun?: BackgroundJobObserver;
+}
+/** Says what became of each attempt, to the log, the metrics and the observer. Never the message of an error. */
+export declare class BackgroundJobRecorder {
+    private readonly options;
+    constructor(options: BackgroundJobRecorderOptions);
+    record(run: BackgroundJobRun, error?: unknown): BackgroundJobRun;
+    /** The worker itself stumbled, claiming or reporting: it goes on, and the lease brings the job back. */
+    fault(queue: string, error: unknown): void;
+    private measure;
+    private log;
+}
+//# sourceMappingURL=background-job-recorder.d.ts.map

package/dist/queue/background-job-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-recorder.d.ts","sourceRoot":"","sources":["../../src/queue/background-job-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,MAAM,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAED,iHAAiH;AACjH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,4BAA4B,EAAI;IAEtE,MAAM,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAc/D;IAED,wGAAwG;IACxG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAQzC;IAED,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,GAAG;CAqBZ"}

package/dist/queue/background-job-recorder.js

@@ -0,0 +1,87 @@
+import { BACKGROUND_DURATION_HISTOGRAM, BACKGROUND_RUNS_COUNTER } from '../metric-names.js';
+/** Says what became of each attempt, to the log, the metrics and the observer. Never the message of an error. */
+export class BackgroundJobRecorder {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    record(run, error) {
+        quietly(() => {
+            this.measure(run);
+        });
+        quietly(() => {
+            this.log(run, error);
+        });
+        quietly(() => {
+            this.options.onRun?.(run, error);
+        });
+        return run;
+    }
+    /** The worker itself stumbled, claiming or reporting: it goes on, and the lease brings the job back. */
+    fault(queue, error) {
+        quietly(() => {
+            this.options.logger.error('Background jobs could not be followed', {
+                queue,
+                errorType: typeOf(error),
+                ...codeOf(error),
+            });
+        });
+    }
+    measure(run) {
+        const labels = { job: run.job, context: contextOf(run.job), status: run.outcome, error_code: run.errorCode };
+        this.options.metrics.counter(BACKGROUND_RUNS_COUNTER).increment(labels);
+        this.options.metrics.histogram(BACKGROUND_DURATION_HISTOGRAM).record(run.durationMs, labels);
+    }
+    log(run, error) {
+        const level = LEVELS[run.outcome];
+        if (!this.options.logger.isLevelEnabled(level)) {
+            return;
+        }
+        const fields = {
+            job: run.job,
+            jobId: run.jobId,
+            context: contextOf(run.job),
+            attempt: run.attempt,
+            outcome: run.outcome,
+            durationMs: run.durationMs,
+            correlationId: run.correlationId,
+            ...(run.errorCode === undefined ? {} : { errorCode: run.errorCode }),
+            ...(error === undefined ? {} : { errorType: typeOf(error) }),
+        };
+        this.options.logger[level](`Background job ${WORDS[run.outcome]}`, fields);
+    }
+}
+function contextOf(job) {
+    return job.split('.', 1).join('');
+}
+function typeOf(error) {
+    return error instanceof Error ? error.constructor.name : typeof error;
+}
+function codeOf(error) {
+    const code = typeof error === 'object' && error !== null ? Reflect.get(error, 'code') : undefined;
+    return typeof code === 'string' ? { errorCode: code } : {};
+}
+/** What records a run must not break it: a logger, a meter or an observer that throws is left alone. */
+function quietly(tell) {
+    try {
+        tell();
+    }
+    catch {
+        return;
+    }
+}
+const LEVELS = {
+    succeeded: 'info',
+    retried: 'warn',
+    dead: 'error',
+    released: 'info',
+    interrupted: 'warn',
+};
+const WORDS = {
+    succeeded: 'succeeded',
+    retried: 'failed: it will be tried again',
+    dead: 'failed for good: it is dead',
+    released: 'released: the worker stopped before it ended',
+    interrupted: 'interrupted: cancelled, or claimed by another worker',
+};
+//# sourceMappingURL=background-job-recorder.js.map

package/dist/queue/background-job-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-recorder.js","sourceRoot":"","sources":["../../src/queue/background-job-recorder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAW5F,iHAAiH;AACjH,MAAM,OAAO,qBAAqB;IACH,OAAO;IAApC,YAA6B,OAAqC;uBAArC,OAAO;IAAiC,CAAC;IAEtE,MAAM,CAAC,GAAqB,EAAE,KAAe;QAC3C,OAAO,CAAC,GAAG,EAAE;YACX,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,EAAE;YACX,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,EAAE;YACX,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,CAAC;IACb,CAAC;IAED,wGAAwG;IACxG,KAAK,CAAC,KAAa,EAAE,KAAc;QACjC,OAAO,CAAC,GAAG,EAAE;YACX,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE;gBACjE,KAAK;gBACL,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;gBACxB,GAAG,MAAM,CAAC,KAAK,CAAC;aACjB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO,CAAC,GAAqB;QACnC,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;QAE7G,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACxE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/F,CAAC;IAEO,GAAG,CAAC,GAAqB,EAAE,KAAc;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAElC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAc;YACxB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAC3B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;YACpE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;SAC7D,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,kBAAkB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC;CACF;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC;AACxE,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,MAAM,IAAI,GAAY,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3G,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,wGAAwG;AACxG,SAAS,OAAO,CAAC,IAAgB;IAC/B,IAAI,CAAC;QACH,IAAI,EAAE,CAAC;IACT,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;AACH,CAAC;AAED,MAAM,MAAM,GAAqD;IAC/D,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,MAAM;CACpB,CAAC;AAEF,MAAM,KAAK,GAAmD;IAC5D,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,gCAAgC;IACzC,IAAI,EAAE,6BAA6B;IACnC,QAAQ,EAAE,8CAA8C;IACxD,WAAW,EAAE,sDAAsD;CACpE,CAAC"}