@ddd-ts-kit/testing 0.10.0 → 0.11.0

package/README.md

@@ -200,6 +200,24 @@ givenEvents((id, history) => AttendanceRecord.rehydrate(id, history), [opened, n
 aggregate: for every version of the history, the aggregate rebuilt from the snapshot its policy
 would store and the events after it has the state and the version of the full replay.
 
+## Process steps
+
+```ts
+import { givenProcess } from '@ddd-ts-kit/testing';
+
+givenProcess<DeadlineState>(undefined)
+  .when((current) => deadlines.requested(booked, current))
+  .thenState({ appointmentId: 'appointment-1', confirmBefore: '2026-03-01T12:00:00.000Z' })
+  .thenTimeouts([{ name: 'deadline', at: deadline }])
+  .thenCommands([]);
+```
+
+A step of a process manager is a function of its state and of what happened: `givenProcess(state)`
+(or `undefined` for an instance that does not exist) runs it and asserts its decision without a
+store, a queue or a bus. `thenIgnored()`, `thenState(state)`, `thenCommands([...])` (each by its
+class or by the properties that matter), `thenTimeouts([...])`, `thenCancelled([...])` and
+`thenEnded()` chain; a failure is an `AssertionError` that says what differs.
+
 ## Refusals
 
 A business refusal is known by its code, and carries its facts as data: a test asserts both,
@@ -454,6 +472,8 @@ repositoryContract(runner, { ...options, name: 'DrizzleOrderRepository', createR
 | `processedEventStoreContract` | any `ProcessedEventStore`: once per consumer and event, also under concurrent deliveries |
 | `eventStoreContract` | any `EventStore`: a stream created at version 0 and read back in order, numbered from 1, with its type, shape version, data, metadata and instant; an append at a version the stream no longer has (behind or ahead) refused with `CONCURRENCY_CONFLICT` and nothing kept of it; one of two appends at the same version through; streams numbered apart; the whole store read in the order of the appends, positions rising from 1, after a position and within a limit; `head()` |
 | `eventStoreUnitOfWorkContract` | a transactional `EventStore` with the outbox of its database under one `UnitOfWork`: the stream and the outbox records published for its events commit together; nothing left in the outbox for an append rolled back, nor for one refused by a concurrency conflict. `createSubject()` answers `{ unitOfWork, store, outbox }` |
+| `processStoreContract` | any `ProcessStore` of process managers: an instance as saved (JSON state, armed timeouts, end), a version that is not the next one refused with `CONCURRENCY_CONFLICT`, one of two first saves winning, and with `unitOfWork` nothing left by a rolled back save |
+| `jobStoreContract` | any `JobStore` of background jobs: due jobs earliest first and each to one claim, delayed jobs, idempotency keys scoped by tenant (two tenants never share one), the tenant and the subject `find` shows, the lease and its heartbeats, reports heard only from the attempt that holds the job (progress, checkpoint handed to the next attempt, success, retry, dead and revived, release), cancellation of a waiting and of a running job, purge. With `unitOfWork` (over the same context as the store just created), a job added, cancelled or revived in a unit of work that rolls back is left as it was, and one that commits is added, cancelled or revived. The claims ask for a lease of 30 s |
 | `cacheContract` | any `Cache`: round trip of every shape of value, isolation of entries, deletion, time to live |
 | `lockContract` | any `Lock`: one holder at a time also under concurrent requests, release, expiry, a late release ignored, growing fencing token, `waitMs` |
 | `jobSchedulerContract` | any `JobScheduler`: registration and description, a duplicate name and an unreadable schedule refused, `runNow` (also for a disabled job, an unknown name rejected), nothing by time before `start` or after `stop`, no overlap by default, a failing job answered `failed` with its code while the others go on, the execution context of a run |

package/dist/contracts/job-store/a-job.d.ts

@@ -0,0 +1,24 @@
+import type { EnqueuedBy } from '@ddd-ts-kit/kernel';
+export interface JobOverrides {
+    readonly name?: string;
+    readonly queue?: string;
+    readonly runAt?: Date;
+    readonly idempotencyKey?: string;
+    readonly payload?: unknown;
+    /** The tenant of the work that enqueues it: `tenant-3` by default, `null` for none. */
+    readonly tenantId?: string | null;
+    readonly subject?: string;
+}
+/** A job of the contract: `billing.compile-statements`, due at `NOW` unless told otherwise. */
+export declare function aJob(id: string, overrides?: JobOverrides): {
+    id: string;
+    name: string;
+    queue: string;
+    payload: {};
+    enqueuedBy: EnqueuedBy;
+    enqueuedAt: Date;
+    runAt: Date;
+    idempotencyKey?: string;
+    subject?: string;
+};
+//# sourceMappingURL=a-job.d.ts.map

package/dist/contracts/job-store/a-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a-job.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/a-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOrD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,+FAA+F;AAC/F,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,YAAiB;;;;;;;;;;EAc5D"}

package/dist/contracts/job-store/a-job.js

@@ -0,0 +1,28 @@
+import { NOW, QUEUE } from './job-fixtures.js';
+const TENANT = 'tenant-3';
+const TRACEPARENT = '00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01';
+/** A job of the contract: `billing.compile-statements`, due at `NOW` unless told otherwise. */
+export function aJob(id, overrides = {}) {
+    const { name = 'billing.compile-statements', queue = QUEUE, runAt = NOW, idempotencyKey, subject } = overrides;
+    return {
+        id,
+        name,
+        queue,
+        payload: overrides.payload ?? { month: '2026-02', customers: ['c-1', 'c-2'], draft: false, total: 12.5 },
+        enqueuedBy: enqueuedBy(overrides.tenantId === undefined ? TENANT : overrides.tenantId),
+        enqueuedAt: NOW,
+        runAt,
+        ...(idempotencyKey === undefined ? {} : { idempotencyKey }),
+        ...(subject === undefined ? {} : { subject }),
+    };
+}
+function enqueuedBy(tenantId) {
+    const tenant = tenantId === null ? {} : { tenantId };
+    return {
+        correlationId: 'corr-1',
+        actor: { id: 'user-7', type: 'user', ...tenant, roles: ['accountant'], attributes: {} },
+        ...tenant,
+        traceparent: TRACEPARENT,
+    };
+}
+//# sourceMappingURL=a-job.js.map

package/dist/contracts/job-store/a-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a-job.js","sourceRoot":"","sources":["../../../src/contracts/job-store/a-job.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,MAAM,WAAW,GAAG,yDAAyD,CAAC;AAa9E,+FAA+F;AAC/F,MAAM,UAAU,IAAI,CAAC,EAAU,EAAE,SAAS,GAAiB,EAAE;IAC3D,MAAM,EAAE,IAAI,GAAG,4BAA4B,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAE/G,OAAO;QACL,EAAE;QACF,IAAI;QACJ,KAAK;QACL,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;QACxG,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;QACtF,UAAU,EAAE,GAAG;QACf,KAAK;QACL,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,QAAuB;IACzC,MAAM,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;IAErD,OAAO;QACL,aAAa,EAAE,QAAQ;QACvB,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;QACvF,GAAG,MAAM;QACT,WAAW,EAAE,WAAW;KACzB,CAAC;AACJ,CAAC"}

package/dist/contracts/job-store/claim-suite.d.ts

@@ -0,0 +1,15 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { JobStoreUnderContract } from './job-store-under-contract.js';
+/** What `add` keeps and what `claim` hands out: due jobs of the queue, earliest first, each to one claim. */
+export declare class ClaimSuite extends ContractSuite<JobStoreUnderContract> {
+    protected tests(): void;
+    private handsOutWhatWasAdded;
+    private respectsTheInstant;
+    private dropsDuplicates;
+    private keepsTheKeysOfTenantsApart;
+    private leasesWhatItHandsOut;
+    private addMany;
+    private claim;
+    private claimedIds;
+}
+//# sourceMappingURL=claim-suite.d.ts.map

package/dist/contracts/job-store/claim-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/claim-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,6GAA6G;AAC7G,qBAAa,UAAW,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IAClE,SAAS,CAAC,KAAK,IAAI,IAAI,CAMtB;IAED,OAAO,CAAC,oBAAoB;IAsC5B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,0BAA0B;IA+BlC,OAAO,CAAC,oBAAoB;YA+Bd,OAAO;IAMrB,OAAO,CAAC,KAAK;YAIC,UAAU;CAGzB"}

package/dist/contracts/job-store/claim-suite.js

@@ -0,0 +1,126 @@
+import { ContractSuite } from '../contract-suite.js';
+import { aJob } from './a-job.js';
+import { LEASE_MS, NOW, QUEUE } from './job-fixtures.js';
+import { later } from './later.js';
+/** What `add` keeps and what `claim` hands out: due jobs of the queue, earliest first, each to one claim. */
+export class ClaimSuite extends ContractSuite {
+    tests() {
+        this.handsOutWhatWasAdded();
+        this.respectsTheInstant();
+        this.dropsDuplicates();
+        this.keepsTheKeysOfTenantsApart();
+        this.leasesWhatItHandsOut();
+    }
+    handsOutWhatWasAdded() {
+        this.it('starts empty', async () => {
+            this.expect(await this.subject.stats(QUEUE)).toEqual({ waiting: 0, running: 0, dead: 0 });
+            this.expect(await this.claimedIds(10, NOW)).toEqual([]);
+            this.expect(await this.subject.find('unknown')).toBe(undefined);
+        });
+        this.it('hands out the job exactly as added, the attempt counted, and shows it running', async () => {
+            const added = await this.subject.add(aJob('job-1'));
+            const [claimed] = await this.claim(10, NOW);
+            const { enqueuedBy, payload, name } = aJob('job-1');
+            this.expect(added).toEqual({ id: 'job-1', duplicate: false });
+            this.expect(claimed).toEqual({
+                id: 'job-1',
+                name,
+                queue: QUEUE,
+                payload,
+                enqueuedBy,
+                enqueuedAt: NOW,
+                attempt: 1,
+            });
+            this.expect((await this.subject.find('job-1'))?.status).toBe('running');
+            this.expect(await this.subject.stats(QUEUE)).toEqual({ waiting: 0, running: 1, dead: 0 });
+        });
+        this.it('hands out the earliest first and only the jobs of the queue asked', async () => {
+            await this.subject.add(aJob('job-1', { runAt: later(-1_000) }));
+            await this.subject.add(aJob('job-2', { runAt: later(-3_000) }));
+            await this.subject.add(aJob('job-3', { name: 'audit.verify-chain', queue: 'audit' }));
+            await this.subject.add(aJob('job-4', { runAt: later(-1_000) }));
+            this.expect(await this.claimedIds(10, NOW)).toEqual(['job-2', 'job-1', 'job-4']);
+        });
+    }
+    respectsTheInstant() {
+        this.it('keeps a job due later until its instant', async () => {
+            await this.subject.add(aJob('job-1', { runAt: later(60_000) }));
+            this.expect(await this.claimedIds(10, later(59_999))).toEqual([]);
+            this.expect(await this.claimedIds(10, later(60_000))).toEqual(['job-1']);
+        });
+        this.it('honours the limit and leaves the rest to the next claim', async () => {
+            await this.addMany(['job-1', 'job-2', 'job-3']);
+            this.expect(await this.claimedIds(2, NOW)).toEqual(['job-1', 'job-2']);
+            this.expect(await this.claimedIds(2, NOW)).toEqual(['job-3']);
+        });
+    }
+    dropsDuplicates() {
+        this.it('answers the job already kept for the same name and idempotency key, and adds nothing', async () => {
+            await this.subject.add(aJob('job-1', { idempotencyKey: 'feb' }));
+            const again = await this.subject.add(aJob('job-2', { idempotencyKey: 'feb' }));
+            const otherName = await this.subject.add(aJob('job-3', { idempotencyKey: 'feb', name: 'billing.send-statements' }));
+            this.expect(again).toEqual({ id: 'job-1', duplicate: true });
+            this.expect(otherName).toEqual({ id: 'job-3', duplicate: false });
+            this.expect(await this.subject.find('job-2')).toBe(undefined);
+        });
+    }
+    keepsTheKeysOfTenantsApart() {
+        this.it('keeps the idempotency keys of two tenants, and of work without a tenant, apart', async () => {
+            await this.subject.add(aJob('job-1', { idempotencyKey: 'feb' }));
+            const otherTenant = await this.subject.add(aJob('job-2', { idempotencyKey: 'feb', tenantId: 'tenant-4' }));
+            const noTenant = await this.subject.add(aJob('job-3', { idempotencyKey: 'feb', tenantId: null }));
+            const noTenantAgain = await this.subject.add(aJob('job-4', { idempotencyKey: 'feb', tenantId: null }));
+            this.expect([otherTenant, noTenant, noTenantAgain]).toEqual([
+                { id: 'job-2', duplicate: false },
+                { id: 'job-3', duplicate: false },
+                { id: 'job-3', duplicate: true },
+            ]);
+        });
+        this.it('shows the tenant and the subject of a job, never its payload', async () => {
+            await this.subject.add(aJob('job-1', { subject: 'customer-9' }));
+            await this.subject.add(aJob('job-2', { tenantId: null }));
+            const [first, second] = [await this.subject.find('job-1'), await this.subject.find('job-2')];
+            this.expect([first?.tenantId, first?.subject, first !== undefined && 'payload' in first]).toEqual([
+                'tenant-3',
+                'customer-9',
+                false,
+            ]);
+            this.expect([second?.tenantId, second?.subject]).toEqual([undefined, undefined]);
+        });
+    }
+    leasesWhatItHandsOut() {
+        this.it('hides a claimed job until its lease ends, then hands it out again, one attempt more', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(10, NOW);
+            this.expect(await this.claimedIds(10, later(LEASE_MS - 1))).toEqual([]);
+            const [again] = await this.claim(10, later(LEASE_MS));
+            this.expect(again?.attempt).toBe(2);
+        });
+        this.it('keeps a job hidden while its heartbeats extend the lease', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(10, NOW);
+            this.expect(await this.subject.heartbeat({ id: 'job-1', attempt: 1 }, later(LEASE_MS * 2))).toBe(true);
+            this.expect(await this.claimedIds(10, later(LEASE_MS))).toEqual([]);
+            this.expect(await this.subject.heartbeat({ id: 'job-1', attempt: 2 }, later(LEASE_MS * 3))).toBe(false);
+        });
+        this.it('never hands the same job to two concurrent claims', async () => {
+            await this.addMany(['job-1', 'job-2', 'job-3', 'job-4', 'job-5', 'job-6']);
+            const batches = await Promise.all([this.claimedIds(4, NOW), this.claimedIds(4, NOW)]);
+            const ids = batches.flat();
+            this.expect(ids.length).toBe(6);
+            this.expect(new Set(ids).size).toBe(6);
+        });
+    }
+    async addMany(ids) {
+        for (const id of ids) {
+            await this.subject.add(aJob(id));
+        }
+    }
+    claim(limit, now) {
+        return this.subject.claim({ queue: QUEUE, limit, now, leaseMs: LEASE_MS });
+    }
+    async claimedIds(limit, now) {
+        return (await this.claim(limit, now)).map((job) => job.id);
+    }
+}
+//# sourceMappingURL=claim-suite.js.map

package/dist/contracts/job-store/claim-suite.js.map

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

package/dist/contracts/job-store/job-fixtures.d.ts

@@ -0,0 +1,5 @@
+/** The instants and the queue every job of the contract uses. */
+export declare const NOW: Date;
+export declare const LEASE_MS = 30000;
+export declare const QUEUE = "billing";
+//# sourceMappingURL=job-fixtures.d.ts.map

package/dist/contracts/job-store/job-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-fixtures.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/job-fixtures.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,eAAO,MAAM,GAAG,MAAuC,CAAC;AAExD,eAAO,MAAM,QAAQ,QAAS,CAAC;AAE/B,eAAO,MAAM,KAAK,YAAY,CAAC"}

package/dist/contracts/job-store/job-fixtures.js

@@ -0,0 +1,5 @@
+/** The instants and the queue every job of the contract uses. */
+export const NOW = new Date('2026-03-01T10:00:00.000Z');
+export const LEASE_MS = 30_000;
+export const QUEUE = 'billing';
+//# sourceMappingURL=job-fixtures.js.map

package/dist/contracts/job-store/job-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-fixtures.js","sourceRoot":"","sources":["../../../src/contracts/job-store/job-fixtures.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE/B,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC"}

package/dist/contracts/job-store/job-store-under-contract.d.ts

@@ -0,0 +1,61 @@
+import type { EnqueuedBy, EnqueuedJob, JobProgress, QueuedJob } from '@ddd-ts-kit/kernel';
+interface Lease {
+    readonly id: string;
+    readonly attempt: number;
+}
+interface Claimed {
+    readonly id: string;
+    readonly name: string;
+    readonly queue: string;
+    readonly payload: unknown;
+    readonly enqueuedBy: EnqueuedBy;
+    readonly enqueuedAt: Date;
+    readonly attempt: number;
+    readonly checkpoint?: unknown;
+}
+/**
+ * The job store port of `@ddd-ts-kit/scheduling`, restated structurally so that this package
+ * does not depend on it. Any `JobStore` fits.
+ */
+export interface JobStoreUnderContract {
+    add(job: {
+        readonly id: string;
+        readonly name: string;
+        readonly queue: string;
+        readonly payload: unknown;
+        readonly enqueuedBy: EnqueuedBy;
+        readonly enqueuedAt: Date;
+        readonly runAt: Date;
+        readonly idempotencyKey?: string;
+        readonly subject?: string;
+    }): Promise<EnqueuedJob>;
+    claim(request: {
+        queue: string;
+        limit: number;
+        now: Date;
+        leaseMs: number;
+    }): Promise<Claimed[]>;
+    heartbeat(lease: Lease, leaseUntil: Date): Promise<boolean>;
+    update(lease: Lease, update: {
+        progress?: JobProgress;
+        checkpoint?: unknown;
+    }, leaseUntil: Date): Promise<boolean>;
+    complete(lease: Lease, at: Date): Promise<boolean>;
+    fail(lease: Lease, failure: {
+        errorCode: string;
+        retryAt: Date | null;
+        at: Date;
+    }): Promise<boolean>;
+    release(lease: Lease, 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<{
+        readonly waiting: number;
+        readonly running: number;
+        readonly dead: number;
+    }>;
+}
+export {};
+//# sourceMappingURL=job-store-under-contract.d.ts.map

package/dist/contracts/job-store/job-store-under-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-store-under-contract.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/job-store-under-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE1F,UAAU,KAAK;IACb,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,OAAO;IACf,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,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,GAAG,EAAE;QACP,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;QAChC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;QACrB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzB,KAAK,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACjG,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnH,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrG,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACjD,SAAS,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,aAAa,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9G"}

package/dist/contracts/job-store/job-store-under-contract.js

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

package/dist/contracts/job-store/job-store-under-contract.js.map

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

package/dist/contracts/job-store/keep-suite.d.ts

@@ -0,0 +1,11 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { JobStoreUnderContract } from './job-store-under-contract.js';
+/** Cancellation and housekeeping. */
+export declare class KeepSuite extends ContractSuite<JobStoreUnderContract> {
+    protected tests(): void;
+    private cancels;
+    private purges;
+    private finished;
+    private claim;
+}
+//# sourceMappingURL=keep-suite.d.ts.map

package/dist/contracts/job-store/keep-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/keep-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,qCAAqC;AACrC,qBAAa,SAAU,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IACjE,SAAS,CAAC,KAAK,IAAI,IAAI,CAGtB;IAED,OAAO,CAAC,OAAO;IA+Bf,OAAO,CAAC,MAAM;YAcA,QAAQ;IAMtB,OAAO,CAAC,KAAK;CAGd"}

package/dist/contracts/job-store/keep-suite.js

@@ -0,0 +1,55 @@
+import { ContractSuite } from '../contract-suite.js';
+import { aJob } from './a-job.js';
+import { LEASE_MS, NOW, QUEUE } from './job-fixtures.js';
+import { later } from './later.js';
+/** Cancellation and housekeeping. */
+export class KeepSuite extends ContractSuite {
+    tests() {
+        this.cancels();
+        this.purges();
+    }
+    cancels() {
+        this.it('cancels a waiting job: it is never handed out', async () => {
+            await this.subject.add(aJob('job-1', { runAt: later(60_000) }));
+            this.expect(await this.subject.cancel('job-1', NOW)).toBe(true);
+            const job = await this.subject.find('job-1');
+            this.expect([job?.status, job?.finishedAt]).toEqual(['cancelled', NOW]);
+            this.expect(await this.claim(later(60_000))).toEqual([]);
+        });
+        this.it('cancels a running job: its next report is refused', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(NOW);
+            this.expect(await this.subject.cancel('job-1', NOW)).toBe(true);
+            this.expect(await this.subject.heartbeat({ id: 'job-1', attempt: 1 }, later(LEASE_MS))).toBe(false);
+            this.expect(await this.subject.complete({ id: 'job-1', attempt: 1 }, NOW)).toBe(false);
+        });
+        this.it('cannot cancel what is over or unknown', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(NOW);
+            await this.subject.complete({ id: 'job-1', attempt: 1 }, NOW);
+            this.expect(await this.subject.cancel('job-1', NOW)).toBe(false);
+            this.expect(await this.subject.cancel('unknown', NOW)).toBe(false);
+        });
+    }
+    purges() {
+        this.it('purges what succeeded or was cancelled before the instant, and keeps the dead', async () => {
+            await this.finished('job-1', (lease) => this.subject.complete(lease, NOW));
+            await this.finished('job-2', (lease) => this.subject.fail(lease, { errorCode: 'X', retryAt: null, at: NOW }));
+            await this.subject.add(aJob('job-3', { runAt: later(60_000) }));
+            await this.subject.cancel('job-3', later(1_000));
+            this.expect(await this.subject.purgeFinished(NOW)).toBe(0);
+            this.expect(await this.subject.purgeFinished(later(1_001))).toBe(2);
+            this.expect(await this.subject.find('job-1')).toBe(undefined);
+            this.expect((await this.subject.find('job-2'))?.status).toBe('dead');
+        });
+    }
+    async finished(id, finish) {
+        await this.subject.add(aJob(id));
+        await this.claim(NOW);
+        await finish({ id, attempt: 1 });
+    }
+    claim(now) {
+        return this.subject.claim({ queue: QUEUE, limit: 10, now, leaseMs: LEASE_MS });
+    }
+}
+//# sourceMappingURL=keep-suite.js.map

package/dist/contracts/job-store/keep-suite.js.map

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

package/dist/contracts/job-store/later.d.ts

@@ -0,0 +1,3 @@
+/** That many milliseconds after `NOW`. */
+export declare function later(ms: number): Date;
+//# sourceMappingURL=later.d.ts.map

package/dist/contracts/job-store/later.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"later.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/later.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtC"}

package/dist/contracts/job-store/later.js

@@ -0,0 +1,6 @@
+import { NOW } from './job-fixtures.js';
+/** That many milliseconds after `NOW`. */
+export function later(ms) {
+    return new Date(NOW.getTime() + ms);
+}
+//# sourceMappingURL=later.js.map

package/dist/contracts/job-store/later.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"later.js","sourceRoot":"","sources":["../../../src/contracts/job-store/later.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAExC,0CAA0C;AAC1C,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/contracts/job-store/report-suite.d.ts

@@ -0,0 +1,12 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { JobStoreUnderContract } from './job-store-under-contract.js';
+/** What a worker reports of an attempt: progress and checkpoint, success, failure, release. Only the attempt that holds the job is heard. */
+export declare class ReportSuite extends ContractSuite<JobStoreUnderContract> {
+    protected tests(): void;
+    private progressAndOutcomes;
+    private deadAndRevived;
+    private releasedAndStale;
+    private claimFirst;
+    private claim;
+}
+//# sourceMappingURL=report-suite.d.ts.map

package/dist/contracts/job-store/report-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/report-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAI3E,6IAA6I;AAC7I,qBAAa,WAAY,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IACnE,SAAS,CAAC,KAAK,IAAI,IAAI,CAItB;IAED,OAAO,CAAC,mBAAmB;IA6C3B,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,gBAAgB;YAsBV,UAAU;IAKxB,OAAO,CAAC,KAAK;CAGd"}

package/dist/contracts/job-store/report-suite.js

@@ -0,0 +1,82 @@
+import { ContractSuite } from '../contract-suite.js';
+import { aJob } from './a-job.js';
+import { LEASE_MS, NOW, QUEUE } from './job-fixtures.js';
+import { later } from './later.js';
+const FIRST = { id: 'job-1', attempt: 1 };
+/** What a worker reports of an attempt: progress and checkpoint, success, failure, release. Only the attempt that holds the job is heard. */
+export class ReportSuite extends ContractSuite {
+    tests() {
+        this.progressAndOutcomes();
+        this.deadAndRevived();
+        this.releasedAndStale();
+    }
+    progressAndOutcomes() {
+        this.it('shows the progress and hands the checkpoint to the next attempt', async () => {
+            await this.claimFirst();
+            this.expect(await this.subject.update(FIRST, { progress: { done: 40, total: 120 } }, later(LEASE_MS))).toBe(true);
+            this.expect(await this.subject.update(FIRST, { checkpoint: { after: 'c-1' } }, later(LEASE_MS))).toBe(true);
+            this.expect((await this.subject.find('job-1'))?.progress).toEqual({ done: 40, total: 120 });
+            const [resumed] = await this.claim(later(LEASE_MS));
+            this.expect([resumed?.attempt, resumed?.checkpoint]).toEqual([2, { after: 'c-1' }]);
+        });
+        this.it('finishes a job that succeeded: never handed out again', async () => {
+            await this.claimFirst();
+            this.expect(await this.subject.complete(FIRST, later(5_000))).toBe(true);
+            const job = await this.subject.find('job-1');
+            this.expect([job?.status, job?.finishedAt]).toEqual(['succeeded', later(5_000)]);
+            this.expect(await this.claim(later(LEASE_MS * 10))).toEqual([]);
+            this.expect(await this.subject.stats(QUEUE)).toEqual({ waiting: 0, running: 0, dead: 0 });
+        });
+        this.it('retries a failed job at its instant, not before, with its error code', async () => {
+            await this.claimFirst();
+            this.expect(await this.subject.fail(FIRST, { errorCode: 'LEDGER_DOWN', retryAt: later(5_000), at: NOW })).toBe(true);
+            const waiting = await this.subject.find('job-1');
+            this.expect([waiting?.status, waiting?.lastErrorCode, waiting?.runAt]).toEqual([
+                'waiting',
+                'LEDGER_DOWN',
+                later(5_000),
+            ]);
+            this.expect(await this.claim(later(4_999))).toEqual([]);
+            this.expect((await this.claim(later(5_000)))[0]?.attempt).toBe(2);
+        });
+    }
+    deadAndRevived() {
+        this.it('sets a dead job aside, then revives it with a fresh attempt budget', async () => {
+            await this.claimFirst();
+            await this.subject.fail(FIRST, { errorCode: 'LEDGER_DOWN', retryAt: null, at: NOW });
+            this.expect((await this.subject.find('job-1'))?.status).toBe('dead');
+            this.expect(await this.subject.stats(QUEUE)).toEqual({ waiting: 0, running: 0, dead: 1 });
+            this.expect(await this.claim(later(LEASE_MS * 10))).toEqual([]);
+            this.expect(await this.subject.retryDead([], later(1_000))).toBe(0);
+            this.expect(await this.subject.retryDead(['job-1', 'unknown'], later(1_000))).toBe(1);
+            const [revived] = await this.claim(later(1_000));
+            this.expect(revived?.attempt).toBe(1);
+        });
+    }
+    releasedAndStale() {
+        this.it('takes a released job back without counting the attempt', async () => {
+            await this.claimFirst();
+            this.expect(await this.subject.release(FIRST, NOW)).toBe(true);
+            this.expect((await this.subject.find('job-1'))?.status).toBe('waiting');
+            this.expect((await this.claim(NOW))[0]?.attempt).toBe(1);
+        });
+        this.it('ignores an attempt whose lease was taken over', async () => {
+            await this.claimFirst();
+            await this.claim(later(LEASE_MS));
+            this.expect(await this.subject.update(FIRST, { progress: { done: 1 } }, later(LEASE_MS * 2))).toBe(false);
+            this.expect(await this.subject.complete(FIRST, later(LEASE_MS))).toBe(false);
+            this.expect(await this.subject.fail(FIRST, { errorCode: 'X', retryAt: null, at: NOW })).toBe(false);
+            this.expect(await this.subject.release(FIRST, NOW)).toBe(false);
+            this.expect((await this.subject.find('job-1'))?.status).toBe('running');
+            this.expect(await this.subject.complete({ id: 'job-1', attempt: 2 }, later(LEASE_MS))).toBe(true);
+        });
+    }
+    async claimFirst() {
+        await this.subject.add(aJob('job-1'));
+        await this.claim(NOW);
+    }
+    claim(now) {
+        return this.subject.claim({ queue: QUEUE, limit: 10, now, leaseMs: LEASE_MS });
+    }
+}
+//# sourceMappingURL=report-suite.js.map

package/dist/contracts/job-store/report-suite.js.map

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

package/dist/contracts/job-store/transaction-suite.d.ts

@@ -0,0 +1,23 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { JobStoreUnderContract } from './job-store-under-contract.js';
+/** The unit of work the store is used in, as the kernel port states it. */
+export interface UnitOfWorkOfTheStore {
+    run<T>(work: () => Promise<T>): Promise<T>;
+}
+interface StoreInUnitOfWork {
+    readonly store: JobStoreUnderContract;
+    readonly unitOfWork: UnitOfWorkOfTheStore;
+}
+/**
+ * A job added inside a unit of work exists if and only if the unit of work committed; a job
+ * cancelled or revived inside one is cancelled or revived if and only if it committed.
+ */
+export declare class TransactionSuite extends ContractSuite<StoreInUnitOfWork> {
+    protected tests(): void;
+    private adds;
+    private cancels;
+    private revives;
+    private claimed;
+}
+export {};
+//# sourceMappingURL=transaction-suite.d.ts.map

package/dist/contracts/job-store/transaction-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/transaction-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5C;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;CAC3C;AAID;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,aAAa,CAAC,iBAAiB,CAAC;IACpE,SAAS,CAAC,KAAK,IAAI,IAAI,CAItB;IAED,OAAO,CAAC,IAAI;IAqBZ,OAAO,CAAC,OAAO;IAyBf,OAAO,CAAC,OAAO;YAmBD,OAAO;CAKtB"}