@ddd-ts-kit/scheduling 0.9.0 → 0.11.0

package/dist/queue/queue-worker.js

@@ -0,0 +1,194 @@
+import { DuplicateJobError, NoopLogger, NoopMetrics } from '@ddd-ts-kit/kernel';
+import { systemJobTimers } from '../system-job-timers.js';
+import { BackgroundJobRecorder } from './background-job-recorder.js';
+import { ClaimedJobRunner } from './claimed-job-runner.js';
+import { AttemptsExhaustedError } from './errors/attempts-exhausted-error.js';
+import { UnknownBackgroundJobError } from './errors/unknown-background-job-error.js';
+import { RegisteredBackgroundJob } from './registered-background-job.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 class QueueWorker {
+    options;
+    jobs = new Map();
+    queues = new Map();
+    recorder;
+    runner;
+    stopping = new AbortController();
+    running = false;
+    constructor(options) {
+        this.options = options;
+        const { logger = new NoopLogger(), metrics = new NoopMetrics(), onRun } = options;
+        const { store, clock, scope, timers = systemJobTimers } = options;
+        this.recorder = new BackgroundJobRecorder({ logger, metrics, ...(onRun === undefined ? {} : { onRun }) });
+        this.runner = new ClaimedJobRunner({ store, clock, scope, timers }, this.recorder);
+    }
+    /** Throws `DuplicateJobError` for a name already registered, `InvalidJobScheduleError` for options it cannot read. */
+    register(definition) {
+        if (this.jobs.has(definition.name)) {
+            throw new DuplicateJobError(definition.name);
+        }
+        const job = new RegisteredBackgroundJob(definition);
+        this.jobs.set(job.name, job);
+        this.followed(job.queue);
+    }
+    /** The names of the queues this worker consumes. */
+    queueNames() {
+        return [...this.queues.keys()];
+    }
+    /** Starts claiming. Starting twice does nothing. */
+    async start() {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        this.stopping = new AbortController();
+        await Promise.all([...this.queues.values()].map((queue) => this.pump(queue)));
+    }
+    /**
+     * 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.
+     */
+    async stop() {
+        this.running = false;
+        for (const queue of this.queues.values()) {
+            queue.cancelSleep?.();
+        }
+        const timers = this.options.timers ?? systemJobTimers;
+        const cancelAbort = timers.schedule(this.options.graceMs ?? 30_000, () => {
+            this.stopping.abort();
+        });
+        const queues = [...this.queues.values()];
+        await Promise.all(queues.flatMap((queue) => (queue.filling === undefined ? [] : [queue.filling])));
+        await Promise.all(queues.flatMap((queue) => [...queue.active]));
+        cancelAbort();
+    }
+    /**
+     * 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.
+     */
+    async runDue() {
+        const runs = [];
+        for (const queue of this.queues.values()) {
+            for (let batch = await this.claimed(queue); batch.length > 0; batch = await this.claimed(queue)) {
+                runs.push(...(await Promise.all(batch.map((job) => this.attempt(job)))));
+            }
+        }
+        return runs;
+    }
+    followed(name) {
+        if (this.queues.has(name)) {
+            return;
+        }
+        this.queues.set(name, {
+            name,
+            concurrency: this.concurrencyOf(name),
+            active: new Set(),
+            filling: undefined,
+            cancelSleep: undefined,
+        });
+    }
+    concurrencyOf(queue) {
+        const { concurrency = 1 } = this.options;
+        if (typeof concurrency === 'number') {
+            return concurrency;
+        }
+        return concurrency[queue] ?? concurrency['default'] ?? 1;
+    }
+    /** Claims while there is room and work; an idle queue sleeps, a full one waits for an attempt to end. */
+    async pump(queue) {
+        if (queue.filling !== undefined || !this.running) {
+            return;
+        }
+        queue.filling = this.fillOrSleep(queue);
+        await queue.filling;
+    }
+    /** Never rejects: a fault of the store is recorded, and the queue asks again after a poll. */
+    async fillOrSleep(queue) {
+        try {
+            await this.fill(queue);
+        }
+        catch (error) {
+            this.recorder.fault(queue.name, error);
+            this.sleep(queue);
+        }
+        finally {
+            queue.filling = undefined;
+        }
+    }
+    async fill(queue) {
+        while (this.running) {
+            const room = queue.concurrency - queue.active.size;
+            if (room <= 0) {
+                return;
+            }
+            const claimed = await this.claimed(queue, room);
+            if (this.stopped()) {
+                await this.giveBack(claimed);
+                return;
+            }
+            for (const job of claimed) {
+                this.launch(queue, job);
+            }
+            if (claimed.length < room) {
+                this.sleep(queue);
+                return;
+            }
+        }
+    }
+    claimed(queue, limit = queue.concurrency) {
+        const leases = [...this.jobs.values()].filter((job) => job.queue === queue.name).map((job) => job.policy.leaseMs);
+        return this.options.store.claim({
+            queue: queue.name,
+            limit,
+            now: this.options.clock.now(),
+            leaseMs: Math.max(...leases),
+        });
+    }
+    /** Read anew after an await: `stop()` may have been called while it waited. */
+    stopped() {
+        return !this.running;
+    }
+    /** Jobs claimed while the worker stopped go back to the store, their attempt not counted. */
+    async giveBack(claimed) {
+        const now = this.options.clock.now();
+        await Promise.all(claimed.map((job) => this.options.store.release({ id: job.id, attempt: job.attempt }, now)));
+    }
+    launch(queue, job) {
+        const active = this.attempt(job).finally(() => {
+            queue.active.delete(active);
+            void this.pump(queue);
+        });
+        queue.active.add(active);
+    }
+    attempt(job) {
+        const registered = this.jobs.get(job.name);
+        if (registered === undefined) {
+            const stranger = new RegisteredBackgroundJob({ name: job.name, run: () => Promise.resolve() });
+            return this.runner.refuse(job, stranger, { error: new UnknownBackgroundJobError(job.name), retry: true });
+        }
+        const { maxAttempts } = registered.policy;
+        if (job.attempt > maxAttempts) {
+            return this.runner.refuse(job, registered, {
+                error: new AttemptsExhaustedError(job.name, maxAttempts),
+                retry: false,
+            });
+        }
+        return this.runner.run(job, registered, this.stopping.signal);
+    }
+    sleep(queue) {
+        if (!this.running) {
+            return;
+        }
+        const timers = this.options.timers ?? systemJobTimers;
+        queue.cancelSleep?.();
+        queue.cancelSleep = timers.schedule(this.options.pollIntervalMs ?? 1_000, () => {
+            void this.pump(queue);
+        });
+    }
+}
+//# sourceMappingURL=queue-worker.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { type BackgroundJobPolicy } from '@ddd-ts-kit/kernel';
+import type { BackgroundJobDefinition } from './background-job-definition.js';
+/** A background job a worker knows, its options read once. */
+export declare class RegisteredBackgroundJob {
+    readonly definition: BackgroundJobDefinition;
+    readonly policy: BackgroundJobPolicy;
+    constructor(definition: BackgroundJobDefinition);
+    get name(): string;
+    get queue(): string;
+}
+//# sourceMappingURL=registered-background-job.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registered-background-job.d.ts","sourceRoot":"","sources":["../../src/queue/registered-background-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,8DAA8D;AAC9D,qBAAa,uBAAuB;IAGtB,QAAQ,CAAC,UAAU,EAAE,uBAAuB;IAFxD,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAErC,YAAqB,UAAU,EAAE,uBAAuB,EAEvD;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}

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

@@ -0,0 +1,17 @@
+import { backgroundJobPolicy } from '@ddd-ts-kit/kernel';
+/** A background job a worker knows, its options read once. */
+export class RegisteredBackgroundJob {
+    definition;
+    policy;
+    constructor(definition) {
+        this.definition = definition;
+        this.policy = backgroundJobPolicy(definition.options);
+    }
+    get name() {
+        return this.definition.name;
+    }
+    get queue() {
+        return this.definition.name.split('.', 1).join('');
+    }
+}
+//# sourceMappingURL=registered-background-job.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registered-background-job.js","sourceRoot":"","sources":["../../src/queue/registered-background-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA4B,MAAM,oBAAoB,CAAC;AAGnF,8DAA8D;AAC9D,MAAM,OAAO,uBAAuB;IAGb,UAAU;IAFtB,MAAM,CAAsB;IAErC,YAAqB,UAAmC;0BAAnC,UAAU;QAC7B,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/queue/report-failed-background-jobs.d.ts

@@ -0,0 +1,11 @@
+import { type ErrorReporter } from '@ddd-ts-kit/kernel';
+import type { BackgroundJobObserver } from './background-job-observer.js';
+/**
+ * The observer that reports every attempt that failed with something else than a `DomainError`:
+ * a timeout, a fault of the job, a job no module registered. An attempt that a bus middleware
+ * already reported is left alone, and one that was released or interrupted is no failure.
+ *
+ *     new QueueWorker({ ..., onRun: reportFailedBackgroundJobs(errors) });
+ */
+export declare function reportFailedBackgroundJobs(reporter: ErrorReporter): BackgroundJobObserver;
+//# sourceMappingURL=report-failed-background-jobs.d.ts.map

package/dist/queue/report-failed-background-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-failed-background-jobs.d.ts","sourceRoot":"","sources":["../../src/queue/report-failed-background-jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,aAAa,GAAG,qBAAqB,CAiBzF"}

package/dist/queue/report-failed-background-jobs.js

@@ -0,0 +1,22 @@
+import { errorReportOf, isUnexpectedError, reportOnce } from '@ddd-ts-kit/kernel';
+/**
+ * The observer that reports every attempt that failed with something else than a `DomainError`:
+ * a timeout, a fault of the job, a job no module registered. An attempt that a bus middleware
+ * already reported is left alone, and one that was released or interrupted is no failure.
+ *
+ *     new QueueWorker({ ..., onRun: reportFailedBackgroundJobs(errors) });
+ */
+export function reportFailedBackgroundJobs(reporter) {
+    return (run, error) => {
+        if ((run.outcome !== 'retried' && run.outcome !== 'dead') || !isUnexpectedError(error)) {
+            return;
+        }
+        reportOnce(reporter, error, errorReportOf(error, {
+            origin: 'queue',
+            operation: run.job,
+            context: run.job.split('.', 1).join(''),
+            correlationId: run.correlationId,
+        }));
+    };
+}
+//# sourceMappingURL=report-failed-background-jobs.js.map

package/dist/queue/report-failed-background-jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-failed-background-jobs.js","sourceRoot":"","sources":["../../src/queue/report-failed-background-jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAsB,MAAM,oBAAoB,CAAC;AAGtG;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAuB;IAChE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACpB,IAAI,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YACvF,OAAO;QACT,CAAC;QAED,UAAU,CACR,QAAQ,EACR,KAAK,EACL,aAAa,CAAC,KAAK,EAAE;YACnB,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,GAAG,CAAC,GAAG;YAClB,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,aAAa,EAAE,GAAG,CAAC,aAAa;SACjC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/queue/running-job.d.ts

@@ -0,0 +1,14 @@
+import type { JobLease } from './store/job-lease.js';
+import type { ClaimedJob } from './store/claimed-job.js';
+import type { RegisteredBackgroundJob } from './registered-background-job.js';
+/** One attempt in progress: what it runs, what it holds, and how to stop it. */
+export interface RunningJob {
+    readonly job: ClaimedJob;
+    readonly registered: RegisteredBackgroundJob;
+    readonly lease: JobLease;
+    readonly controller: AbortController;
+    readonly startedAt: Date;
+    /** Cancels the next heartbeat. */
+    stopBeating: () => void;
+}
+//# sourceMappingURL=running-job.d.ts.map

package/dist/queue/running-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"running-job.d.ts","sourceRoot":"","sources":["../../src/queue/running-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,kCAAkC;IAClC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB"}

package/dist/queue/running-job.js

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

package/dist/queue/running-job.js.map

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

package/dist/queue/store/claim-request.d.ts

@@ -0,0 +1,8 @@
+export interface ClaimRequest {
+    readonly queue: string;
+    readonly limit: number;
+    readonly now: Date;
+    /** How long the claimed jobs stay invisible to other claims. */
+    readonly leaseMs: number;
+}
+//# sourceMappingURL=claim-request.d.ts.map

package/dist/queue/store/claim-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-request.d.ts","sourceRoot":"","sources":["../../../src/queue/store/claim-request.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

package/dist/queue/store/claim-request.js

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

package/dist/queue/store/claim-request.js.map

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

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

@@ -0,0 +1,15 @@
+import type { EnqueuedBy } from '@ddd-ts-kit/kernel';
+/** A job handed to a worker, with what its run needs. */
+export interface ClaimedJob {
+    readonly id: string;
+    readonly name: string;
+    readonly queue: string;
+    readonly payload: unknown;
+    readonly enqueuedBy: EnqueuedBy;
+    readonly enqueuedAt: Date;
+    /** This claim: 1 the first time, counted at each claim. */
+    readonly attempt: number;
+    /** What an earlier attempt saved, absent on a fresh start. */
+    readonly checkpoint?: unknown;
+}
+//# sourceMappingURL=claimed-job.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimed-job.d.ts","sourceRoot":"","sources":["../../../src/queue/store/claimed-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B"}

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

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

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

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

package/dist/queue/store/in-memory-job-store.d.ts

@@ -0,0 +1,40 @@
+import { type EnqueuedJob, type QueuedJob } from '@ddd-ts-kit/kernel';
+import type { ClaimRequest } from './claim-request.js';
+import type { ClaimedJob } from './claimed-job.js';
+import type { JobFailure } from './job-failure.js';
+import type { JobLease } from './job-lease.js';
+import type { JobStoreStats } from './job-store-stats.js';
+import type { JobStore } from './job-store.js';
+import type { JobUpdate } from './job-update.js';
+import type { NewJob } from './new-job.js';
+/**
+ * The queue in the memory of the process, for tests and a single process without a database.
+ * Called inside a unit of work, `add`, `cancel` and `retryDead` answer from what the store holds
+ * and write once it committed (`whenCommitted`): a command that rolls back leaves no job and
+ * cancels none. Payloads and checkpoints go through JSON, as in every other store.
+ */
+export declare class InMemoryJobStore implements JobStore {
+    private readonly jobs;
+    private sequence;
+    add(job: NewJob): Promise<EnqueuedJob>;
+    claim({ queue, limit, now, leaseMs }: ClaimRequest): Promise<ClaimedJob[]>;
+    heartbeat(lease: JobLease, leaseUntil: Date): Promise<boolean>;
+    update(lease: JobLease, update: JobUpdate, leaseUntil: Date): Promise<boolean>;
+    complete(lease: JobLease, at: Date): Promise<boolean>;
+    fail(lease: JobLease, { errorCode, retryAt, at }: JobFailure): Promise<boolean>;
+    release(lease: JobLease, runAt: Date): Promise<boolean>;
+    cancel(id: string, at: Date): Promise<boolean>;
+    find(id: string): Promise<QueuedJob | undefined>;
+    retryDead(ids: readonly string[], now: Date): Promise<number>;
+    purgeFinished(before: Date): Promise<number>;
+    stats(queue: string): Promise<JobStoreStats>;
+    /** Every job in the order it was added, as the queue shows it: for assertions. */
+    list(): QueuedJob[];
+    private dead;
+    /** The key is scoped by the tenant: two tenants never share one. */
+    private withKey;
+    /** A job of the same key may have committed while this one waited for its own commit. */
+    private store;
+    private holding;
+}
+//# sourceMappingURL=in-memory-job-store.d.ts.map

package/dist/queue/store/in-memory-job-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-job-store.d.ts","sourceRoot":"","sources":["../../../src/queue/store/in-memory-job-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAO3C;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IAErD,OAAO,CAAC,QAAQ,CAAK;IAEf,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAY3C;IAEK,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAa/E;IAEK,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAInE;IAEK,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAMnF;IAEK,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAI1D;IAEK,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAYpF;IAEK,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5D;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAcnD;IAEK,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAIrD;IAEK,SAAS,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlE;IAEK,aAAa,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAUjD;IAEK,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAKjD;IAED,kFAAkF;IAClF,IAAI,IAAI,SAAS,EAAE,CAElB;IAED,OAAO,CAAC,IAAI;IAQZ,oEAAoE;IACpE,OAAO,CAAC,OAAO;IAWf,yFAAyF;IACzF,OAAO,CAAC,KAAK;IAwBb,OAAO,CAAC,OAAO;CAWhB"}

package/dist/queue/store/in-memory-job-store.js

@@ -0,0 +1,185 @@
+import { whenCommitted } from '@ddd-ts-kit/kernel';
+import { plainJson } from './plain-json.js';
+import { queuedJobOf } from './queued-job-of.js';
+const FINISHED = ['succeeded', 'cancelled'];
+/**
+ * The queue in the memory of the process, for tests and a single process without a database.
+ * Called inside a unit of work, `add`, `cancel` and `retryDead` answer from what the store holds
+ * and write once it committed (`whenCommitted`): a command that rolls back leaves no job and
+ * cancels none. Payloads and checkpoints go through JSON, as in every other store.
+ */
+export class InMemoryJobStore {
+    jobs = new Map();
+    sequence = 0;
+    async add(job) {
+        const existing = this.withKey(job);
+        if (existing !== undefined) {
+            return { id: existing.id, duplicate: true };
+        }
+        await whenCommitted(async () => {
+            this.store(job);
+        });
+        return { id: job.id, duplicate: false };
+    }
+    async claim({ queue, limit, now, leaseMs }) {
+        const due = [...this.jobs.values()]
+            .filter((job) => job.queue === queue && isDue(job, now))
+            .sort((left, right) => left.runAt.getTime() - right.runAt.getTime() || left.sequence - right.sequence)
+            .slice(0, Math.max(0, limit));
+        for (const job of due) {
+            job.status = 'running';
+            job.attempts += 1;
+            job.leaseUntil = new Date(now.getTime() + leaseMs);
+        }
+        return due.map(claimedOf);
+    }
+    async heartbeat(lease, leaseUntil) {
+        return this.holding(lease, (job) => {
+            job.leaseUntil = leaseUntil;
+        });
+    }
+    async update(lease, update, leaseUntil) {
+        return this.holding(lease, (job) => {
+            job.leaseUntil = leaseUntil;
+            job.progress = update.progress ?? job.progress;
+            job.checkpoint = 'checkpoint' in update ? plainJson(update.checkpoint) : job.checkpoint;
+        });
+    }
+    async complete(lease, at) {
+        return this.holding(lease, (job) => {
+            finish(job, 'succeeded', at);
+        });
+    }
+    async fail(lease, { errorCode, retryAt, at }) {
+        return this.holding(lease, (job) => {
+            job.lastErrorCode = errorCode;
+            if (retryAt === null) {
+                finish(job, 'dead', at);
+            }
+            else {
+                job.status = 'waiting';
+                job.runAt = retryAt;
+                job.leaseUntil = undefined;
+            }
+        });
+    }
+    async release(lease, runAt) {
+        return this.holding(lease, (job) => {
+            job.status = 'waiting';
+            job.attempts -= 1;
+            job.runAt = runAt;
+            job.leaseUntil = undefined;
+        });
+    }
+    async cancel(id, at) {
+        if (!isCancellable(this.jobs.get(id))) {
+            return false;
+        }
+        await whenCommitted(async () => {
+            const job = this.jobs.get(id);
+            if (isCancellable(job)) {
+                finish(job, 'cancelled', at);
+            }
+        });
+        return true;
+    }
+    async find(id) {
+        const job = this.jobs.get(id);
+        return job === undefined ? undefined : queuedJobOf(job);
+    }
+    async retryDead(ids, now) {
+        const dead = this.dead(ids);
+        await whenCommitted(async () => {
+            for (const job of this.dead(ids)) {
+                Object.assign(job, { status: 'waiting', attempts: 0, runAt: now, finishedAt: undefined });
+            }
+        });
+        return dead.length;
+    }
+    async purgeFinished(before) {
+        const purged = [...this.jobs.values()].filter((job) => FINISHED.includes(job.status) && job.finishedAt !== undefined && job.finishedAt < before);
+        for (const job of purged) {
+            this.jobs.delete(job.id);
+        }
+        return purged.length;
+    }
+    async stats(queue) {
+        const jobs = [...this.jobs.values()].filter((job) => job.queue === queue);
+        const counted = (status) => jobs.filter((job) => job.status === status).length;
+        return { waiting: counted('waiting'), running: counted('running'), dead: counted('dead') };
+    }
+    /** Every job in the order it was added, as the queue shows it: for assertions. */
+    list() {
+        return [...this.jobs.values()].map(queuedJobOf);
+    }
+    dead(ids) {
+        return ids.flatMap((id) => {
+            const job = this.jobs.get(id);
+            return job?.status === 'dead' ? [job] : [];
+        });
+    }
+    /** The key is scoped by the tenant: two tenants never share one. */
+    withKey({ name, idempotencyKey, enqueuedBy }) {
+        if (idempotencyKey === undefined) {
+            return undefined;
+        }
+        return [...this.jobs.values()].find((job) => job.name === name && job.idempotencyKey === idempotencyKey && job.enqueuedBy.tenantId === enqueuedBy.tenantId);
+    }
+    /** A job of the same key may have committed while this one waited for its own commit. */
+    store(job) {
+        if (this.withKey(job) !== undefined) {
+            return;
+        }
+        this.sequence += 1;
+        this.jobs.set(job.id, {
+            ...job,
+            payload: plainJson(job.payload),
+            enqueuedBy: structuredClone(job.enqueuedBy),
+            idempotencyKey: job.idempotencyKey,
+            subject: job.subject,
+            sequence: this.sequence,
+            status: 'waiting',
+            attempts: 0,
+            leaseUntil: undefined,
+            progress: undefined,
+            checkpoint: undefined,
+            lastErrorCode: undefined,
+            finishedAt: undefined,
+        });
+    }
+    holding(lease, change) {
+        const job = this.jobs.get(lease.id);
+        if (job?.status !== 'running' || job.attempts !== lease.attempt) {
+            return false;
+        }
+        change(job);
+        return true;
+    }
+}
+function isCancellable(job) {
+    return job?.status === 'waiting' || job?.status === 'running';
+}
+function isDue(job, now) {
+    if (job.status === 'waiting') {
+        return job.runAt <= now;
+    }
+    return job.status === 'running' && job.leaseUntil !== undefined && job.leaseUntil <= now;
+}
+function finish(job, status, at) {
+    job.status = status;
+    job.finishedAt = at;
+    job.leaseUntil = undefined;
+}
+function claimedOf(job) {
+    return {
+        id: job.id,
+        name: job.name,
+        queue: job.queue,
+        payload: plainJson(job.payload),
+        enqueuedBy: structuredClone(job.enqueuedBy),
+        enqueuedAt: job.enqueuedAt,
+        attempt: job.attempts,
+        ...(job.checkpoint === undefined ? {} : { checkpoint: plainJson(job.checkpoint) }),
+    };
+}
+//# sourceMappingURL=in-memory-job-store.js.map

package/dist/queue/store/in-memory-job-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-job-store.js","sourceRoot":"","sources":["../../../src/queue/store/in-memory-job-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoC,MAAM,oBAAoB,CAAC;AASrF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,QAAQ,GAAsB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACV,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE7C,QAAQ,GAAG,CAAC,CAAC;IAErB,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEnC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,aAAa,CAAC,KAAK,IAAI,EAAE;YAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAgB;QACtD,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aAChC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;aACvD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;aACrG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAEhC,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC;YACvB,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;YAClB,GAAG,CAAC,UAAU,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAe,EAAE,UAAgB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;YACjC,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAe,EAAE,MAAiB,EAAE,UAAgB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;YACjC,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;YAC5B,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC;YAC/C,GAAG,CAAC,UAAU,GAAG,YAAY,IAAI,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;QAC1F,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAe,EAAE,EAAQ;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;YACjC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAe,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAc;QAChE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;YACjC,GAAG,CAAC,aAAa,GAAG,SAAS,CAAC;YAE9B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC;gBACvB,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC;gBACpB,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAe,EAAE,KAAW;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;YACjC,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC;YACvB,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;YAClB,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;YAClB,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,EAAQ;QAC/B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,aAAa,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAE9B,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAU;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE9B,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAsB,EAAE,GAAS;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE5B,MAAM,aAAa,CAAC,KAAK,IAAI,EAAE;YAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAY;QAC9B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC3C,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,GAAG,MAAM,CAClG,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAa;QACvB,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QAEvF,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7F,CAAC;IAED,kFAAkF;IAClF,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAEO,IAAI,CAAC,GAAsB;QACjC,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAE9B,OAAO,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IAC5D,OAAO,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAU;QAC1D,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACjC,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,GAAG,CAAC,cAAc,KAAK,cAAc,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,UAAU,CAAC,QAAQ,CAChH,CAAC;IACJ,CAAC;IAED,yFAAyF;IACjF,KAAK,CAAC,GAAW;QACvB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QAEnB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE;YACpB,GAAG,GAAG;YACN,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;YAC/B,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;YAC3C,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,SAAS;YACnB,UAAU,EAAE,SAAS;YACrB,aAAa,EAAE,SAAS;YACxB,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC;IAEO,OAAO,CAAC,KAAe,EAAE,MAAgC;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAEpC,IAAI,GAAG,EAAE,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YAChE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,CAAC;QAEZ,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,SAAS,aAAa,CAAC,GAA0B;IAC/C,OAAO,GAAG,EAAE,MAAM,KAAK,SAAS,IAAI,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;AAChE,CAAC;AAED,SAAS,KAAK,CAAC,GAAc,EAAE,GAAS;IACtC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC;IAC1B,CAAC;IAED,OAAO,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC;AAC3F,CAAC;AAED,SAAS,MAAM,CAAC,GAAc,EAAE,MAA0C,EAAE,EAAQ;IAClF,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACpB,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC;IACpB,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC;AAC7B,CAAC;AAED,SAAS,SAAS,CAAC,GAAc;IAC/B,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;QAC/B,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;QAC3C,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,QAAQ;QACrB,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;KACnF,CAAC;AACJ,CAAC"}

package/dist/queue/store/job-failure.d.ts

@@ -0,0 +1,8 @@
+export interface JobFailure {
+    /** The `code` of what the run threw, never a message. */
+    readonly errorCode: string;
+    /** When to try again, or `null` to declare the job dead. */
+    readonly retryAt: Date | null;
+    readonly at: Date;
+}
+//# sourceMappingURL=job-failure.d.ts.map

package/dist/queue/store/job-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-failure.d.ts","sourceRoot":"","sources":["../../../src/queue/store/job-failure.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;CACnB"}

package/dist/queue/store/job-failure.js

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

package/dist/queue/store/job-failure.js.map

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