@ddd-ts-kit/scheduling 0.9.0 → 0.11.0

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

@@ -0,0 +1,15 @@
+import type { BackgroundJobOutcome } from './background-job-outcome.js';
+/** One attempt of a background job and what became of it, as data. Never a payload, never a message. */
+export interface BackgroundJobRun {
+    readonly job: string;
+    readonly jobId: string;
+    readonly attempt: number;
+    readonly outcome: BackgroundJobOutcome;
+    readonly startedAt: Date;
+    readonly durationMs: number;
+    /** The `code` of what the run threw, or `UNEXPECTED_ERROR`. */
+    readonly errorCode?: string;
+    /** The correlation of the work that enqueued the job. */
+    readonly correlationId: string;
+}
+//# sourceMappingURL=background-job-run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-run.d.ts","sourceRoot":"","sources":["../../src/queue/background-job-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,wGAAwG;AACxG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC"}

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

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

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

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

package/dist/queue/claimed-job-runner.d.ts

@@ -0,0 +1,44 @@
+import { type Clock, type ExecutionScope } from '@ddd-ts-kit/kernel';
+import type { JobTimers } from '../job-timers.js';
+import type { BackgroundJobRecorder } from './background-job-recorder.js';
+import type { BackgroundJobRun } from './background-job-run.js';
+import type { RegisteredBackgroundJob } from './registered-background-job.js';
+import type { ClaimedJob } from './store/claimed-job.js';
+import type { JobStore } from './store/job-store.js';
+interface Refusal {
+    readonly error: Error;
+    /** False when no attempt is left. */
+    readonly retry: boolean;
+}
+export interface ClaimedJobRunnerOptions {
+    readonly store: JobStore;
+    readonly clock: Clock;
+    readonly scope: ExecutionScope;
+    readonly timers: JobTimers;
+}
+/** Runs one attempt of a claimed job: the execution scope, the heartbeats, the timeout, and what the store is told. */
+export declare class ClaimedJobRunner {
+    private readonly options;
+    private readonly recorder;
+    constructor(options: ClaimedJobRunnerOptions, recorder: BackgroundJobRecorder);
+    /** Answers what became of the attempt. Never rejects. `stopping` aborts it when the worker stops. */
+    run(job: ClaimedJob, registered: RegisteredBackgroundJob, stopping: AbortSignal): Promise<BackgroundJobRun>;
+    /** Settles a job this worker does not run: no attempt is left, or no module registered it. Never rejects. */
+    refuse(job: ClaimedJob, registered: RegisteredBackgroundJob, refusal: Refusal): Promise<BackgroundJobRun>;
+    private started;
+    private attempt;
+    private inScope;
+    private write;
+    private beatLater;
+    /** A heartbeat the store cannot take keeps the run going: if the lease ends, the report of the run is refused. */
+    private beat;
+    private armTimeout;
+    private succeeded;
+    private failed;
+    private settled;
+    private retryAt;
+    private leaseEnd;
+    private recorded;
+}
+export {};
+//# sourceMappingURL=claimed-job-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimed-job-runner.d.ts","sourceRoot":"","sources":["../../src/queue/claimed-job-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,KAAK,EACV,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrD,UAAU,OAAO;IACf,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B;AAED,uHAAuH;AACvH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAF3B,YACmB,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,qBAAqB,EAC9C;IAEJ,qGAAqG;IAC/F,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,uBAAuB,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBhH;IAED,6GAA6G;IACvG,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,uBAAuB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ9G;IAED,OAAO,CAAC,OAAO;YAWD,OAAO;IAUrB,OAAO,CAAC,OAAO;YA4BD,KAAK;IAYnB,OAAO,CAAC,SAAS;IAQjB,kHAAkH;YACpG,IAAI;IAUlB,OAAO,CAAC,UAAU;YAYJ,SAAS;YAMT,MAAM;YAcN,OAAO;IAQrB,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,QAAQ;CAiBjB"}

package/dist/queue/claimed-job-runner.js

@@ -0,0 +1,178 @@
+import { executionContextOfBackgroundJob, retryDelayMs, } from '@ddd-ts-kit/kernel';
+import { errorCodeOf } from '../errors/error-code-of.js';
+import { JobAbortedError } from '../errors/job-aborted-error.js';
+import { JobTimeoutError } from '../errors/job-timeout-error.js';
+import { unlessAborted } from '../unless-aborted.js';
+import { JobInterruptedError } from './errors/job-interrupted-error.js';
+/** Runs one attempt of a claimed job: the execution scope, the heartbeats, the timeout, and what the store is told. */
+export class ClaimedJobRunner {
+    options;
+    recorder;
+    constructor(options, recorder) {
+        this.options = options;
+        this.recorder = recorder;
+    }
+    /** Answers what became of the attempt. Never rejects. `stopping` aborts it when the worker stops. */
+    async run(job, registered, stopping) {
+        const running = this.started(job, registered);
+        const unlink = linked(stopping, running.controller, () => new JobAbortedError(job.name));
+        const disarm = this.armTimeout(running);
+        this.beatLater(running);
+        try {
+            return await this.attempt(running);
+        }
+        catch (error) {
+            // The store could not be told: the lease ends and the job is claimed again.
+            return this.recorded(running, 'interrupted', error);
+        }
+        finally {
+            running.stopBeating();
+            disarm();
+            unlink();
+        }
+    }
+    /** Settles a job this worker does not run: no attempt is left, or no module registered it. Never rejects. */
+    async refuse(job, registered, refusal) {
+        const running = this.started(job, registered);
+        try {
+            return await this.settled(running, refusal.error, refusal.retry ? this.retryAt(running) : null);
+        }
+        catch (error) {
+            return this.recorded(running, 'interrupted', error);
+        }
+    }
+    started(job, registered) {
+        return {
+            job,
+            registered,
+            lease: { id: job.id, attempt: job.attempt },
+            controller: new AbortController(),
+            startedAt: this.options.clock.now(),
+            stopBeating: nothing,
+        };
+    }
+    async attempt(running) {
+        try {
+            await unlessAborted(running.controller.signal, this.inScope(running));
+        }
+        catch (error) {
+            return this.failed(running, error);
+        }
+        return this.succeeded(running);
+    }
+    inScope(running) {
+        const { job, registered, controller, startedAt } = running;
+        const { timeoutMs } = registered.policy;
+        const deadline = timeoutMs === undefined ? undefined : new Date(startedAt.getTime() + timeoutMs);
+        const { traceparent } = job.enqueuedBy;
+        const context = executionContextOfBackgroundJob({
+            jobId: job.id,
+            enqueuedBy: job.enqueuedBy,
+            ...(deadline === undefined ? {} : { deadline }),
+        });
+        const execution = {
+            jobId: job.id,
+            attempt: job.attempt,
+            enqueuedAt: job.enqueuedAt,
+            actor: job.enqueuedBy.actor,
+            startedAt,
+            checkpoint: job.checkpoint,
+            signal: controller.signal,
+            ...(traceparent === undefined ? {} : { traceparent }),
+            saveCheckpoint: (checkpoint) => this.write(running, { checkpoint }),
+            reportProgress: (progress) => this.write(running, { progress }),
+        };
+        return this.options.scope.run(context, () => registered.definition.run(job.payload, execution));
+    }
+    async write(running, update) {
+        const held = await this.options.store.update(running.lease, update, this.leaseEnd(running));
+        if (!held) {
+            const interrupted = new JobInterruptedError(running.job.name);
+            running.controller.abort(interrupted);
+            throw interrupted;
+        }
+    }
+    beatLater(running) {
+        const every = Math.max(1, Math.floor(running.registered.policy.leaseMs / 3));
+        running.stopBeating = this.options.timers.schedule(every, () => {
+            void this.beat(running);
+        });
+    }
+    /** A heartbeat the store cannot take keeps the run going: if the lease ends, the report of the run is refused. */
+    async beat(running) {
+        const held = await this.options.store.heartbeat(running.lease, this.leaseEnd(running)).catch(() => true);
+        if (held) {
+            this.beatLater(running);
+        }
+        else {
+            running.controller.abort(new JobInterruptedError(running.job.name));
+        }
+    }
+    armTimeout({ registered, controller, job }) {
+        const { timeoutMs } = registered.policy;
+        if (timeoutMs === undefined) {
+            return nothing;
+        }
+        return this.options.timers.schedule(timeoutMs, () => {
+            controller.abort(new JobTimeoutError(job.name, timeoutMs));
+        });
+    }
+    async succeeded(running) {
+        const held = await this.options.store.complete(running.lease, this.options.clock.now());
+        return this.recorded(running, held ? 'succeeded' : 'interrupted');
+    }
+    async failed(running, error) {
+        if (error instanceof JobInterruptedError) {
+            return this.recorded(running, 'interrupted', error);
+        }
+        if (error instanceof JobAbortedError) {
+            const released = await this.options.store.release(running.lease, this.options.clock.now());
+            return this.recorded(running, released ? 'released' : 'interrupted', error);
+        }
+        return this.settled(running, error, this.retryAt(running));
+    }
+    async settled(running, error, retryAt) {
+        const failure = { errorCode: errorCodeOf(error), retryAt, at: this.options.clock.now() };
+        const held = await this.options.store.fail(running.lease, failure);
+        const outcome = !held ? 'interrupted' : retryAt === null ? 'dead' : 'retried';
+        return this.recorded(running, outcome, error);
+    }
+    retryAt({ job, registered }) {
+        if (job.attempt >= registered.policy.maxAttempts) {
+            return null;
+        }
+        return new Date(this.options.clock.now().getTime() + retryDelayMs(registered.policy, job.attempt));
+    }
+    leaseEnd(running) {
+        return new Date(this.options.clock.now().getTime() + running.registered.policy.leaseMs);
+    }
+    recorded(running, outcome, error) {
+        const { job, startedAt } = running;
+        const durationMs = this.options.clock.now().getTime() - startedAt.getTime();
+        const run = {
+            job: job.name,
+            jobId: job.id,
+            attempt: job.attempt,
+            outcome,
+            startedAt,
+            durationMs,
+            correlationId: job.enqueuedBy.correlationId,
+            ...(error === undefined ? {} : { errorCode: errorCodeOf(error) }),
+        };
+        return this.recorder.record(run, error);
+    }
+}
+function nothing() {
+    return undefined;
+}
+/** Aborts `controller` when `signal` is, with the reason `reason` gives. Answers how to stop listening. */
+function linked(signal, controller, reason) {
+    const abort = () => {
+        controller.abort(reason());
+    };
+    signal.addEventListener('abort', abort, { once: true });
+    return () => {
+        signal.removeEventListener('abort', abort);
+    };
+}
+//# sourceMappingURL=claimed-job-runner.js.map

package/dist/queue/claimed-job-runner.js.map

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

package/dist/queue/errors/attempts-exhausted-error.d.ts

@@ -0,0 +1,6 @@
+/** A job claimed again after its last attempt: its worker died, or lost its lease, during that attempt. */
+export declare class AttemptsExhaustedError extends Error {
+    readonly code = "ATTEMPTS_EXHAUSTED";
+    constructor(job: string, maxAttempts: number);
+}
+//# sourceMappingURL=attempts-exhausted-error.d.ts.map

package/dist/queue/errors/attempts-exhausted-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempts-exhausted-error.d.ts","sourceRoot":"","sources":["../../../src/queue/errors/attempts-exhausted-error.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,wBAAwB;IAErC,YAAY,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAG3C;CACF"}

package/dist/queue/errors/attempts-exhausted-error.js

@@ -0,0 +1,9 @@
+/** A job claimed again after its last attempt: its worker died, or lost its lease, during that attempt. */
+export class AttemptsExhaustedError extends Error {
+    code = 'ATTEMPTS_EXHAUSTED';
+    constructor(job, maxAttempts) {
+        super(`Background job "${job}" used its ${maxAttempts} attempt(s).`);
+        this.name = 'AttemptsExhaustedError';
+    }
+}
+//# sourceMappingURL=attempts-exhausted-error.js.map

package/dist/queue/errors/attempts-exhausted-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempts-exhausted-error.js","sourceRoot":"","sources":["../../../src/queue/errors/attempts-exhausted-error.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,IAAI,GAAG,oBAAoB,CAAC;IAErC,YAAY,GAAW,EAAE,WAAmB;QAC1C,KAAK,CAAC,mBAAmB,GAAG,cAAc,WAAW,cAAc,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF"}

package/dist/queue/errors/invalid-enqueue-error.d.ts

@@ -0,0 +1,8 @@
+/** What `enqueue` cannot accept: raised where the job is enqueued, before anything is stored. */
+export declare class InvalidEnqueueError extends Error {
+    readonly code = "INVALID_ENQUEUE";
+    private constructor();
+    static unnamed(jobName: string): InvalidEnqueueError;
+    static twoInstants(): InvalidEnqueueError;
+}
+//# sourceMappingURL=invalid-enqueue-error.d.ts.map

package/dist/queue/errors/invalid-enqueue-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-enqueue-error.d.ts","sourceRoot":"","sources":["../../../src/queue/errors/invalid-enqueue-error.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,qBAAqB;IAElC,OAAO,eAGN;IAED,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAInD;IAED,MAAM,CAAC,WAAW,IAAI,mBAAmB,CAExC;CACF"}

package/dist/queue/errors/invalid-enqueue-error.js

@@ -0,0 +1,15 @@
+/** What `enqueue` cannot accept: raised where the job is enqueued, before anything is stored. */
+export class InvalidEnqueueError extends Error {
+    code = 'INVALID_ENQUEUE';
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidEnqueueError';
+    }
+    static unnamed(jobName) {
+        return new InvalidEnqueueError(`"${jobName}" is not a job name: the static jobName of a background job is <context>.<job-name>.`);
+    }
+    static twoInstants() {
+        return new InvalidEnqueueError('A job is enqueued with a delay or a runAt, not both.');
+    }
+}
+//# sourceMappingURL=invalid-enqueue-error.js.map

package/dist/queue/errors/invalid-enqueue-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-enqueue-error.js","sourceRoot":"","sources":["../../../src/queue/errors/invalid-enqueue-error.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,iBAAiB,CAAC;IAElC,YAAoB,OAAe;QACjC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,mBAAmB,CAC5B,IAAI,OAAO,sFAAsF,CAClG,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,OAAO,IAAI,mBAAmB,CAAC,sDAAsD,CAAC,CAAC;IACzF,CAAC;CACF"}

package/dist/queue/errors/job-interrupted-error.d.ts

@@ -0,0 +1,6 @@
+/** The store no longer gives this run the job: it was cancelled, or its lease expired and another worker claimed it. */
+export declare class JobInterruptedError extends Error {
+    readonly code = "JOB_INTERRUPTED";
+    constructor(job: string);
+}
+//# sourceMappingURL=job-interrupted-error.d.ts.map

package/dist/queue/errors/job-interrupted-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-interrupted-error.d.ts","sourceRoot":"","sources":["../../../src/queue/errors/job-interrupted-error.ts"],"names":[],"mappings":"AAAA,wHAAwH;AACxH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,qBAAqB;IAElC,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF"}

package/dist/queue/errors/job-interrupted-error.js

@@ -0,0 +1,9 @@
+/** The store no longer gives this run the job: it was cancelled, or its lease expired and another worker claimed it. */
+export class JobInterruptedError extends Error {
+    code = 'JOB_INTERRUPTED';
+    constructor(job) {
+        super(`Background job "${job}" was cancelled or claimed by another worker: this run stops.`);
+        this.name = 'JobInterruptedError';
+    }
+}
+//# sourceMappingURL=job-interrupted-error.js.map

package/dist/queue/errors/job-interrupted-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-interrupted-error.js","sourceRoot":"","sources":["../../../src/queue/errors/job-interrupted-error.ts"],"names":[],"mappings":"AAAA,wHAAwH;AACxH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,iBAAiB,CAAC;IAElC,YAAY,GAAW;QACrB,KAAK,CAAC,mBAAmB,GAAG,+DAA+D,CAAC,CAAC;QAC7F,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/queue/errors/unknown-background-job-error.d.ts

@@ -0,0 +1,6 @@
+/** A worker claimed a job of its queue that no module registered: a newer version enqueued it, or it was renamed. */
+export declare class UnknownBackgroundJobError extends Error {
+    readonly code = "UNKNOWN_BACKGROUND_JOB";
+    constructor(job: string);
+}
+//# sourceMappingURL=unknown-background-job-error.d.ts.map

package/dist/queue/errors/unknown-background-job-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-background-job-error.d.ts","sourceRoot":"","sources":["../../../src/queue/errors/unknown-background-job-error.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,4BAA4B;IAEzC,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF"}

package/dist/queue/errors/unknown-background-job-error.js

@@ -0,0 +1,9 @@
+/** A worker claimed a job of its queue that no module registered: a newer version enqueued it, or it was renamed. */
+export class UnknownBackgroundJobError extends Error {
+    code = 'UNKNOWN_BACKGROUND_JOB';
+    constructor(job) {
+        super(`No background job is named "${job}" in this worker.`);
+        this.name = 'UnknownBackgroundJobError';
+    }
+}
+//# sourceMappingURL=unknown-background-job-error.js.map

package/dist/queue/errors/unknown-background-job-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-background-job-error.js","sourceRoot":"","sources":["../../../src/queue/errors/unknown-background-job-error.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,IAAI,GAAG,wBAAwB,CAAC;IAEzC,YAAY,GAAW;QACrB,KAAK,CAAC,+BAA+B,GAAG,mBAAmB,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF"}

package/dist/queue/queue-state.d.ts

@@ -0,0 +1,12 @@
+import type { BackgroundJobRun } from './background-job-run.js';
+/** What a worker follows of one queue. */
+export interface QueueState {
+    readonly name: string;
+    readonly concurrency: number;
+    /** The attempts in progress. */
+    readonly active: Set<Promise<BackgroundJobRun>>;
+    /** The claim in progress and the launch of what it claimed, which `stop` waits for. */
+    filling: Promise<void> | undefined;
+    cancelSleep: (() => void) | undefined;
+}
+//# sourceMappingURL=queue-state.d.ts.map

package/dist/queue/queue-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-state.d.ts","sourceRoot":"","sources":["../../src/queue/queue-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAChD,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,WAAW,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACvC"}

package/dist/queue/queue-state.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-state.js.map

package/dist/queue/queue-state.js.map

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

package/dist/queue/queue-worker-options.d.ts

@@ -0,0 +1,29 @@
+import type { Clock, ExecutionScope, Logger, Metrics } from '@ddd-ts-kit/kernel';
+import type { JobTimers } from '../job-timers.js';
+import type { BackgroundJobObserver } from './background-job-observer.js';
+import type { JobStore } from './store/job-store.js';
+export interface QueueWorkerOptions {
+    readonly store: JobStore;
+    /** Every instant comes from it. */
+    readonly clock: Clock;
+    /** Each attempt runs inside it, in a context of origin `queue`. */
+    readonly scope: ExecutionScope;
+    /** Default: writes nothing. */
+    readonly logger?: Logger;
+    /** Default: measures nothing. */
+    readonly metrics?: Metrics;
+    /** Default: the timers of the runtime. */
+    readonly timers?: JobTimers;
+    /**
+     * How many attempts of one queue run at once in this process: a number for every queue, or a
+     * number per queue with `default` for the others. Default 1. A limit per process, not across
+     * the workers of a deployment.
+     */
+    readonly concurrency?: number | Readonly<Record<string, number>>;
+    /** How long an idle queue waits before it asks the store again. Default 1000. */
+    readonly pollIntervalMs?: number;
+    /** How long `stop()` waits for the attempts in progress before aborting them. Default 30 000. */
+    readonly graceMs?: number;
+    readonly onRun?: BackgroundJobObserver;
+}
+//# sourceMappingURL=queue-worker-options.d.ts.map

package/dist/queue/queue-worker-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-worker-options.d.ts","sourceRoot":"","sources":["../../src/queue/queue-worker-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,iFAAiF;IACjF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,iGAAiG;IACjG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;CACxC"}

package/dist/queue/queue-worker-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-worker-options.js.map

package/dist/queue/queue-worker-options.js.map

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

package/dist/queue/queue-worker.d.ts

@@ -0,0 +1,52 @@
+import type { BackgroundJobDefinition } from './background-job-definition.js';
+import type { BackgroundJobRun } from './background-job-run.js';
+import type { QueueWorkerOptions } from './queue-worker-options.js';
+/**
+ * Runs the background jobs of the queues it has jobs for, in this process: each queue is the
+ * context of its jobs, so a worker given the modules of some contexts consumes their queues and
+ * no other. Delivery is at least once: a job whose worker died comes back when its lease ends.
+ */
+export declare class QueueWorker {
+    private readonly options;
+    private readonly jobs;
+    private readonly queues;
+    private readonly recorder;
+    private readonly runner;
+    private stopping;
+    private running;
+    constructor(options: QueueWorkerOptions);
+    /** Throws `DuplicateJobError` for a name already registered, `InvalidJobScheduleError` for options it cannot read. */
+    register(definition: BackgroundJobDefinition): void;
+    /** The names of the queues this worker consumes. */
+    queueNames(): readonly string[];
+    /** Starts claiming. Starting twice does nothing. */
+    start(): Promise<void>;
+    /**
+     * Stops claiming, waits for the attempts in progress up to the grace period, then aborts them:
+     * an aborted attempt gives its job back, uncounted, for the next worker. A claim in flight
+     * when it is called gives its jobs back the same way. Stopping is cooperative: a job that
+     * ignores its signal goes on behind, and is claimed again once its lease ends.
+     */
+    stop(): Promise<void>;
+    /**
+     * Claims and runs every job due now, queue after queue, until none is left, and answers the
+     * attempts: for a test, or a command run once. Not while the worker runs.
+     */
+    runDue(): Promise<BackgroundJobRun[]>;
+    private followed;
+    private concurrencyOf;
+    /** Claims while there is room and work; an idle queue sleeps, a full one waits for an attempt to end. */
+    private pump;
+    /** Never rejects: a fault of the store is recorded, and the queue asks again after a poll. */
+    private fillOrSleep;
+    private fill;
+    private claimed;
+    /** Read anew after an await: `stop()` may have been called while it waited. */
+    private stopped;
+    /** Jobs claimed while the worker stopped go back to the store, their attempt not counted. */
+    private giveBack;
+    private launch;
+    private attempt;
+    private sleep;
+}
+//# sourceMappingURL=queue-worker.d.ts.map

package/dist/queue/queue-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-worker.d.ts","sourceRoot":"","sources":["../../src/queue/queue-worker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAIpE;;;;GAIG;AACH,qBAAa,WAAW;IAaV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8C;IAEnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IAExD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IAEjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAE1C,OAAO,CAAC,QAAQ,CAAyB;IAEzC,OAAO,CAAC,OAAO,CAAS;IAExB,YAA6B,OAAO,EAAE,kBAAkB,EAMvD;IAED,sHAAsH;IACtH,QAAQ,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CASlD;IAED,oDAAoD;IACpD,UAAU,IAAI,SAAS,MAAM,EAAE,CAE9B;IAED,oDAAoD;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ3B;IAED;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB1B;IAED;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAU1C;IAED,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,aAAa;IAUrB,yGAAyG;YAC3F,IAAI;IASlB,8FAA8F;YAChF,WAAW;YAWX,IAAI;IA4BlB,OAAO,CAAC,OAAO;IAWf,+EAA+E;IAC/E,OAAO,CAAC,OAAO;IAIf,6FAA6F;YAC/E,QAAQ;IAMtB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,KAAK;CAad"}