@ddd-ts-kit/scheduling 0.9.0 → 0.11.0

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

@@ -0,0 +1,9 @@
+/**
+ * Who may still report on a claimed job: the claim of that attempt. A worker whose lease expired
+ * and whose job was claimed again holds an older attempt, and the store ignores it.
+ */
+export interface JobLease {
+    readonly id: string;
+    readonly attempt: number;
+}
+//# sourceMappingURL=job-lease.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-lease.d.ts","sourceRoot":"","sources":["../../../src/queue/store/job-lease.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

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

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

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

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

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

@@ -0,0 +1,7 @@
+/** What a queue holds, for a dashboard: alert on `dead` above zero and on `waiting` growing. */
+export interface JobStoreStats {
+    readonly waiting: number;
+    readonly running: number;
+    readonly dead: number;
+}
+//# sourceMappingURL=job-store-stats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-store-stats.d.ts","sourceRoot":"","sources":["../../../src/queue/store/job-store-stats.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

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

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

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

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

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

@@ -0,0 +1,53 @@
+import type { EnqueuedJob, 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 { JobUpdate } from './job-update.js';
+import type { NewJob } from './new-job.js';
+/**
+ * Where background jobs wait between `enqueue` and their run, and what a worker reports of them.
+ *
+ * A claim is a lease: a job claimed and not heard of before its lease ends is claimed again,
+ * which is how the jobs of a worker that died come back. Every report names the attempt it
+ * holds (`JobLease`): once the job was claimed again, or cancelled, the store answers false and
+ * the worker stops. Every write answers false when it changed nothing.
+ */
+export declare abstract class JobStore {
+    static readonly tokenKey = "scheduling.JobStore";
+    /**
+     * Adds the job, in the transaction of the caller when the store is transactional. A job of the
+     * same name, tenant and idempotency key already kept is answered instead, `duplicate: true`.
+     * A store that writes after the commit checks the key before: two jobs of one key staged
+     * before either committed both answer their own id, and only the first is kept.
+     */
+    abstract add(job: NewJob): Promise<EnqueuedJob>;
+    /**
+     * Claims up to `limit` jobs of the queue that are due (waiting with `runAt` passed, or running
+     * with an expired lease), the earliest first, and counts the attempt. Two concurrent claims
+     * never return the same job.
+     */
+    abstract claim(request: ClaimRequest): Promise<ClaimedJob[]>;
+    /** Extends the lease while the run goes on. False: the job was cancelled or claimed again. */
+    abstract heartbeat(lease: JobLease, leaseUntil: Date): Promise<boolean>;
+    /** Stores the progress or the checkpoint of the run, and extends the lease. */
+    abstract update(lease: JobLease, update: JobUpdate, leaseUntil: Date): Promise<boolean>;
+    abstract complete(lease: JobLease, at: Date): Promise<boolean>;
+    /** Schedules the next attempt, or declares the job dead when `retryAt` is null. */
+    abstract fail(lease: JobLease, failure: JobFailure): Promise<boolean>;
+    /** Gives a job back without counting the attempt: the worker stops before the run could end. */
+    abstract release(lease: JobLease, runAt: Date): Promise<boolean>;
+    /**
+     * A waiting or running job is cancelled: a running one learns it at its next heartbeat. In
+     * the transaction of the caller, or once it committed for a store that cannot share it.
+     */
+    abstract cancel(id: string, at: Date): Promise<boolean>;
+    abstract find(id: string): Promise<QueuedJob | undefined>;
+    /** Puts dead jobs back with a fresh attempt budget. Answers how many. */
+    abstract retryDead(ids: readonly string[], now: Date): Promise<number>;
+    /** Housekeeping: drops the jobs that succeeded or were cancelled before `before`. Dead jobs stay. */
+    abstract purgeFinished(before: Date): Promise<number>;
+    abstract stats(queue: string): Promise<JobStoreStats>;
+}
+//# sourceMappingURL=job-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-store.d.ts","sourceRoot":"","sources":["../../../src/queue/store/job-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjE,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,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;;GAOG;AACH,8BAAsB,QAAQ;IAC5B,MAAM,CAAC,QAAQ,CAAC,QAAQ,yBAAyB;IAEjD;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEhD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE7D,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExE,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExF,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/D,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtE,gGAAgG;IAChG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExD,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAE1D,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvE,qGAAqG;IACrG,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtD,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACvD"}

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

@@ -0,0 +1,12 @@
+/**
+ * Where background jobs wait between `enqueue` and their run, and what a worker reports of them.
+ *
+ * A claim is a lease: a job claimed and not heard of before its lease ends is claimed again,
+ * which is how the jobs of a worker that died come back. Every report names the attempt it
+ * holds (`JobLease`): once the job was claimed again, or cancelled, the store answers false and
+ * the worker stops. Every write answers false when it changed nothing.
+ */
+export class JobStore {
+    static tokenKey = 'scheduling.JobStore';
+}
+//# sourceMappingURL=job-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-store.js","sourceRoot":"","sources":["../../../src/queue/store/job-store.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,MAAM,OAAgB,QAAQ;IAC5B,MAAM,CAAU,QAAQ,GAAG,qBAAqB,CAAC;CA8ClD"}

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

@@ -0,0 +1,7 @@
+import type { JobProgress } from '@ddd-ts-kit/kernel';
+/** What a run stores while it goes on: either or both. */
+export interface JobUpdate {
+    readonly progress?: JobProgress;
+    readonly checkpoint?: unknown;
+}
+//# sourceMappingURL=job-update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-update.d.ts","sourceRoot":"","sources":["../../../src/queue/store/job-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B"}

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

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

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

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

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

@@ -0,0 +1,17 @@
+import type { EnqueuedBy } from '@ddd-ts-kit/kernel';
+/** A job as `enqueue` hands it to the store. */
+export interface NewJob {
+    readonly id: string;
+    readonly name: string;
+    readonly queue: string;
+    /** Plain JSON. */
+    readonly payload: unknown;
+    /** Its `tenantId`, when present, scopes the idempotency key: two tenants never share one. */
+    readonly enqueuedBy: EnqueuedBy;
+    readonly enqueuedAt: Date;
+    readonly runAt: Date;
+    readonly idempotencyKey?: string;
+    /** What the job works on, answered by `find`. */
+    readonly subject?: string;
+}
+//# sourceMappingURL=new-job.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"new-job.d.ts","sourceRoot":"","sources":["../../../src/queue/store/new-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,gDAAgD;AAChD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B"}

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

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

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

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

package/dist/queue/store/plain-json.d.ts

@@ -0,0 +1,3 @@
+/** A value as it comes back from JSON, the way every store of the queue hands it back: a date becomes its text. */
+export declare function plainJson(value: unknown): unknown;
+//# sourceMappingURL=plain-json.d.ts.map

package/dist/queue/store/plain-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-json.d.ts","sourceRoot":"","sources":["../../../src/queue/store/plain-json.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEjD"}

package/dist/queue/store/plain-json.js

@@ -0,0 +1,5 @@
+/** A value as it comes back from JSON, the way every store of the queue hands it back: a date becomes its text. */
+export function plainJson(value) {
+    return value === undefined ? undefined : JSON.parse(JSON.stringify(value));
+}
+//# sourceMappingURL=plain-json.js.map

package/dist/queue/store/plain-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-json.js","sourceRoot":"","sources":["../../../src/queue/store/plain-json.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/queue/store/queued-job-of.d.ts

@@ -0,0 +1,5 @@
+import type { QueuedJob } from '@ddd-ts-kit/kernel';
+import type { StoredJob } from './stored-job.js';
+/** What a stored job shows of itself: never its payload, its checkpoint or its actor. */
+export declare function queuedJobOf(job: StoredJob): QueuedJob;
+//# sourceMappingURL=queued-job-of.d.ts.map

package/dist/queue/store/queued-job-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queued-job-of.d.ts","sourceRoot":"","sources":["../../../src/queue/store/queued-job-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAerD"}

package/dist/queue/store/queued-job-of.js

@@ -0,0 +1,18 @@
+/** What a stored job shows of itself: never its payload, its checkpoint or its actor. */
+export function queuedJobOf(job) {
+    return {
+        id: job.id,
+        name: job.name,
+        queue: job.queue,
+        status: job.status,
+        attempts: job.attempts,
+        enqueuedAt: job.enqueuedAt,
+        runAt: job.runAt,
+        ...(job.enqueuedBy.tenantId === undefined ? {} : { tenantId: job.enqueuedBy.tenantId }),
+        ...(job.subject === undefined ? {} : { subject: job.subject }),
+        ...(job.progress === undefined ? {} : { progress: job.progress }),
+        ...(job.lastErrorCode === undefined ? {} : { lastErrorCode: job.lastErrorCode }),
+        ...(job.finishedAt === undefined ? {} : { finishedAt: job.finishedAt }),
+    };
+}
+//# sourceMappingURL=queued-job-of.js.map

package/dist/queue/store/queued-job-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queued-job-of.js","sourceRoot":"","sources":["../../../src/queue/store/queued-job-of.ts"],"names":[],"mappings":"AAGA,yFAAyF;AACzF,MAAM,UAAU,WAAW,CAAC,GAAc;IACxC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACvF,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAC9D,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjE,GAAG,CAAC,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC;QAChF,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { EnqueuedBy, JobProgress, QueuedJobStatus } from '@ddd-ts-kit/kernel';
+/** A job as the in-memory store keeps it. */
+export interface StoredJob {
+    readonly id: string;
+    readonly name: string;
+    readonly queue: string;
+    readonly payload: unknown;
+    readonly enqueuedBy: EnqueuedBy;
+    readonly enqueuedAt: Date;
+    readonly idempotencyKey: string | undefined;
+    readonly subject: string | undefined;
+    readonly sequence: number;
+    status: QueuedJobStatus;
+    attempts: number;
+    runAt: Date;
+    leaseUntil: Date | undefined;
+    progress: JobProgress | undefined;
+    checkpoint: unknown;
+    lastErrorCode: string | undefined;
+    finishedAt: Date | undefined;
+}
+//# sourceMappingURL=stored-job.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stored-job.d.ts","sourceRoot":"","sources":["../../../src/queue/store/stored-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEnF,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,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,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,IAAI,CAAC;IACZ,UAAU,EAAE,IAAI,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,EAAE,IAAI,GAAG,SAAS,CAAC;CAC9B"}

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

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

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

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

package/dist/queue/store/tenant-key-of.d.ts

@@ -0,0 +1,8 @@
+import type { EnqueuedBy } from '@ddd-ts-kit/kernel';
+/**
+ * The tenant part of the idempotency key of a job, for a store that keeps it in a column of a
+ * unique index: the tenant, or the empty text for a job enqueued outside any tenant, because a
+ * null would make every such key distinct on PostgreSQL before 15.
+ */
+export declare function tenantKeyOf(enqueuedBy: EnqueuedBy): string;
+//# sourceMappingURL=tenant-key-of.d.ts.map

package/dist/queue/store/tenant-key-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-key-of.d.ts","sourceRoot":"","sources":["../../../src/queue/store/tenant-key-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE1D"}

package/dist/queue/store/tenant-key-of.js

@@ -0,0 +1,9 @@
+/**
+ * The tenant part of the idempotency key of a job, for a store that keeps it in a column of a
+ * unique index: the tenant, or the empty text for a job enqueued outside any tenant, because a
+ * null would make every such key distinct on PostgreSQL before 15.
+ */
+export function tenantKeyOf(enqueuedBy) {
+    return enqueuedBy.tenantId ?? '';
+}
+//# sourceMappingURL=tenant-key-of.js.map

package/dist/queue/store/tenant-key-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-key-of.js","sourceRoot":"","sources":["../../../src/queue/store/tenant-key-of.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,UAAsB;IAChD,OAAO,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,27 @@
+import { type BackgroundJobType, type Clock, type EnqueuedJob, type EnqueueOptions, type ExecutionScope, type IdGenerator, type JobQueue, type QueuedJob } from '@ddd-ts-kit/kernel';
+import type { JobStore } from './store/job-store.js';
+export interface StoredJobQueueOptions {
+    readonly store: JobStore;
+    readonly clock: Clock;
+    readonly ids: IdGenerator;
+    /** Where the correlation, the actor and the tenant of the work that enqueues are read. */
+    readonly scope: ExecutionScope;
+    /** The `traceparent` of the active span, stored with the job: `captureTraceparent` of `@ddd-ts-kit/tracing`. */
+    readonly traceparent?: () => string | undefined;
+}
+/**
+ * The `JobQueue` of the kernel on a `JobStore`: it names the job, captures what travels with it
+ * and adds it to the store, in the transaction of the caller when the store shares it. `find`
+ * and `cancel` reach the jobs of the tenant of the work in progress only (the tenants of its
+ * elevation), every job when the work has no tenant.
+ */
+export declare class StoredJobQueue implements JobQueue {
+    private readonly options;
+    constructor(options: StoredJobQueueOptions);
+    enqueue<Payload>(job: BackgroundJobType<Payload>, payload: NoInfer<Payload>, options?: EnqueueOptions): Promise<EnqueuedJob>;
+    cancel(id: string): Promise<boolean>;
+    find(id: string): Promise<QueuedJob | undefined>;
+    /** Outside of any execution scope (a script, a test), the job acts as itself, under a correlation of its own. */
+    private enqueuedBy;
+}
+//# sourceMappingURL=stored-job-queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stored-job-queue.d.ts","sourceRoot":"","sources":["../../src/queue/stored-job-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,KAAK,EAEV,KAAK,WAAW,EAChB,KAAK,cAAc,EAEnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,gHAAgH;IAChH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACjD;AAED;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,QAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,qBAAqB,EAAI;IAEzD,OAAO,CAAC,OAAO,EACnB,GAAG,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAC/B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAgBtB;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMzC;IAEK,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAIrD;IAED,iHAAiH;IACjH,OAAO,CAAC,UAAU;CAanB"}

package/dist/queue/stored-job-queue.js

@@ -0,0 +1,78 @@
+import { isJobName, parseDuration, systemActor, } from '@ddd-ts-kit/kernel';
+import { InvalidEnqueueError } from './errors/invalid-enqueue-error.js';
+/**
+ * The `JobQueue` of the kernel on a `JobStore`: it names the job, captures what travels with it
+ * and adds it to the store, in the transaction of the caller when the store shares it. `find`
+ * and `cancel` reach the jobs of the tenant of the work in progress only (the tenants of its
+ * elevation), every job when the work has no tenant.
+ */
+export class StoredJobQueue {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async enqueue(job, payload, options = {}) {
+        const name = nameOf(job);
+        const enqueuedAt = this.options.clock.now();
+        const { idempotencyKey, subject } = options;
+        return this.options.store.add({
+            id: this.options.ids.next(),
+            name,
+            queue: queueOf(name),
+            payload,
+            enqueuedBy: this.enqueuedBy(name),
+            enqueuedAt,
+            runAt: runAtOf(options, enqueuedAt),
+            ...(idempotencyKey === undefined ? {} : { idempotencyKey }),
+            ...(subject === undefined ? {} : { subject }),
+        });
+    }
+    async cancel(id) {
+        if ((await this.find(id)) === undefined) {
+            return false;
+        }
+        return this.options.store.cancel(id, this.options.clock.now());
+    }
+    async find(id) {
+        const job = await this.options.store.find(id);
+        return job !== undefined && isInReach(job, this.options.scope.current()) ? job : undefined;
+    }
+    /** Outside of any execution scope (a script, a test), the job acts as itself, under a correlation of its own. */
+    enqueuedBy(name) {
+        const context = this.options.scope.current();
+        const traceparent = this.options.traceparent?.();
+        const traced = traceparent === undefined ? {} : { traceparent };
+        if (context === undefined) {
+            return { correlationId: this.options.ids.next(), actor: systemActor(name), ...traced };
+        }
+        const { correlationId, actor, tenantId } = context;
+        return { correlationId, actor, ...(tenantId === undefined ? {} : { tenantId }), ...traced };
+    }
+}
+function isInReach(job, context) {
+    const elevated = context?.elevation?.tenants;
+    if (elevated !== undefined) {
+        return elevated === 'all' || (job.tenantId !== undefined && elevated.includes(job.tenantId));
+    }
+    return context?.tenantId === undefined || job.tenantId === context.tenantId;
+}
+function nameOf(job) {
+    if (!isJobName(job.jobName)) {
+        throw InvalidEnqueueError.unnamed(job.jobName);
+    }
+    return job.jobName;
+}
+/** The queue of a job is its context: the first part of its name. */
+function queueOf(name) {
+    return name.split('.', 1).join('');
+}
+function runAtOf({ delay, runAt }, now) {
+    if (delay !== undefined && runAt !== undefined) {
+        throw InvalidEnqueueError.twoInstants();
+    }
+    if (delay !== undefined) {
+        return new Date(now.getTime() + parseDuration(delay));
+    }
+    return runAt ?? now;
+}
+//# sourceMappingURL=stored-job-queue.js.map

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

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

package/dist/unless-aborted.d.ts

@@ -0,0 +1,3 @@
+/** A job that ignores its signal is left behind: the run ends when the signal is aborted, with its reason. */
+export declare function unlessAborted(signal: AbortSignal, work: Promise<void>): Promise<void>;
+//# sourceMappingURL=unless-aborted.d.ts.map

package/dist/unless-aborted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unless-aborted.d.ts","sourceRoot":"","sources":["../src/unless-aborted.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAYrF"}

package/dist/unless-aborted.js

@@ -0,0 +1,14 @@
+/** A job that ignores its signal is left behind: the run ends when the signal is aborted, with its reason. */
+export 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=unless-aborted.js.map

package/dist/unless-aborted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unless-aborted.js","sourceRoot":"","sources":["../src/unless-aborted.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,MAAM,UAAU,aAAa,CAAC,MAAmB,EAAE,IAAmB;IACpE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EAAE;YACH,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3B,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,MAAmB;IACnC,MAAM,MAAM,GAAY,MAAM,CAAC,MAAM,CAAC;IAEtC,OAAO,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAC9E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ddd-ts-kit/scheduling",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Scheduled jobs that only trigger use cases: interval and cron schedules, one run across instances, no overlap, each run in its own execution scope.",
   "license": "MIT",
   "repository": {
@@ -30,9 +30,9 @@
     "dist"
   ],
   "dependencies": {
-    "@ddd-ts-kit/kernel": "0.9.0"
+    "@ddd-ts-kit/kernel": "0.11.0"
   },
   "devDependencies": {
-    "@ddd-ts-kit/testing": "0.9.0"
+    "@ddd-ts-kit/testing": "0.11.0"
   }
 }