@ddd-ts-kit/testing 0.0.0-stage → 0.1.0

package/dist/contracts/criteria-contract.js

@@ -0,0 +1,94 @@
+import { Criteria, cursorPage, offsetPage, scoped, } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from './contract-suite.js';
+import { criteriaContractRows } from './criteria/criteria-contract-rows.js';
+import { GROUP_CASES } from './criteria/group-cases.js';
+import { OPERATOR_CASES } from './criteria/operator-cases.js';
+import { SCOPE_CASES } from './criteria/scope-cases.js';
+import { SORT_CASES } from './criteria/sort-cases.js';
+const MAPPING = {
+    ids: 'id',
+    filter: { tenantId: 'tenantId', remote: 'remote' },
+};
+const CASES = [...OPERATOR_CASES, ...GROUP_CASES, ...SORT_CASES, ...SCOPE_CASES];
+/**
+ * What every translator of criteria guarantees, the in-memory evaluator included: the same
+ * criteria answer the same rows in the same order, page by page, on every store.
+ */
+export function criteriaContract(runner, options) {
+    new CriteriaSuite(runner, options).describe(`${options.name} (criteria contract)`);
+}
+class CriteriaSuite extends ContractSuite {
+    constructor(runner, options) {
+        super(runner, () => options.createReadModel(criteriaContractRows()));
+    }
+    tests() {
+        this.afterEach(async () => {
+            await this.subject.close?.();
+        });
+        for (const example of CASES) {
+            this.answers(example);
+        }
+        this.pagesByOffset();
+        this.pagesByCursor();
+    }
+    answers(example) {
+        this.it(example.name, async () => {
+            const page = await this.subject.search(read(example).refine((criteria) => criteria.page(offsetPage({ limit: 50 }))));
+            this.expect(idsOf(page)).toEqual(example.ids);
+            this.expect(page.total).toBe(example.ids.length);
+        });
+    }
+    pagesByOffset() {
+        this.it('an offset page holds its slice and the total of the filtered rows', async () => {
+            const acme = (offset) => this.subject.search(scoped(Criteria.of()
+                .where('tenantId', 'eq', 'acme')
+                .page(offsetPage({ offset, limit: 2 })), { kind: 'all' }));
+            this.expect((await acme(0)).items.map(({ id }) => id)).toEqual(['a1', 'a2']);
+            this.expect((await acme(2)).items.map(({ id }) => id)).toEqual(['a3', 'a6']);
+            this.expect(await acme(4).then(summary)).toEqual({ ids: ['a7'], total: 5, more: false });
+            this.expect(await acme(6).then(summary)).toEqual({ ids: [], total: 5, more: false });
+        });
+        this.it('a read without a page answers the first page of the default size', async () => {
+            const page = await this.subject.search(scoped(Criteria.of(), { kind: 'all' }));
+            this.expect(summary(page)).toEqual({ ids: OPERATOR_CASES[0]?.ids, total: 8, more: false });
+        });
+    }
+    pagesByCursor() {
+        for (const example of [...SORT_CASES, ...OPERATOR_CASES.slice(0, 2), ...SCOPE_CASES.slice(0, 2)]) {
+            this.it(`walked by cursor, two rows at a time: ${example.name}`, async () => {
+                this.expect(await this.walked(example, 2)).toEqual(example.ids);
+            });
+        }
+        this.it('walked by cursor one row at a time, every row comes once, ties and nulls included', async () => {
+            for (const example of SORT_CASES) {
+                this.expect(await this.walked(example, 1)).toEqual(example.ids);
+            }
+        });
+        this.it('a cursor page carries no total, and no cursor when it is the last', async () => {
+            const page = await this.subject.search(scoped(Criteria.of().page(cursorPage({ limit: 8 })), { kind: 'all' }));
+            this.expect(summary(page)).toEqual({ ids: OPERATOR_CASES[0]?.ids, total: undefined, more: false });
+        });
+    }
+    /** Follows `nextCursor` from the first page to the last and answers the ids met, in order. */
+    async walked(example, limit) {
+        const ids = [];
+        let cursor;
+        do {
+            const request = cursorPage({ limit, ...(cursor === undefined ? {} : { cursor }) });
+            const page = await this.subject.search(read(example).refine((criteria) => criteria.page(request)));
+            ids.push(...idsOf(page));
+            cursor = page.nextCursor;
+        } while (cursor !== undefined && ids.length <= 2 * CASES.length);
+        return ids;
+    }
+}
+function read(example) {
+    return scoped(example.read(Criteria.of()), example.scope ?? { kind: 'all' }, MAPPING);
+}
+function idsOf(page) {
+    return page.items.map(({ id }) => id);
+}
+function summary(page) {
+    return { ids: idsOf(page), total: page.total, more: page.nextCursor !== undefined };
+}
+//# sourceMappingURL=criteria-contract.js.map

package/dist/contracts/criteria-contract.js.map

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

package/dist/contracts/event-bus-contract.d.ts

@@ -0,0 +1,23 @@
+import type { EventBus } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+export interface EventBusUnderContract {
+    readonly bus: EventBus;
+    /**
+     * Resolves once everything published so far has been delivered (or given up on). Needed by
+     * providers that deliver asynchronously; in-process buses leave it out.
+     */
+    settle?(): Promise<void>;
+    close?(): Promise<void>;
+}
+export interface EventBusContractOptions {
+    readonly name: string;
+    /** A fresh bus with no subscriber; called before each test. */
+    createBus(): Awaitable<EventBusUnderContract>;
+}
+/**
+ * What every integration event provider guarantees. Delivery is at-least-once: the suite
+ * accepts redeliveries everywhere and never relies on the order of arrival.
+ */
+export declare function eventBusContract(runner: ContractRunner, options: EventBusContractOptions): void;
+//# sourceMappingURL=event-bus-contract.d.ts.map

package/dist/contracts/event-bus-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/event-bus-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAoB,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,SAAS,IAAI,SAAS,CAAC,qBAAqB,CAAC,CAAC;CAC/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAE/F"}

package/dist/contracts/event-bus-contract.js

@@ -0,0 +1,122 @@
+import { ContractSuite } from './contract-suite.js';
+import { failureOf } from './failure-of.js';
+import { fullEnvelope } from './full-envelope.js';
+/**
+ * What every integration event provider guarantees. Delivery is at-least-once: the suite
+ * accepts redeliveries everywhere and never relies on the order of arrival.
+ */
+export function eventBusContract(runner, options) {
+    new EventBusSuite(runner, options).describe(`${options.name} (event bus contract)`);
+}
+const HAPPENED = 'contract.thing.happened';
+const IGNORED = 'contract.thing.ignored';
+class EventBusSuite extends ContractSuite {
+    constructor(runner, options) {
+        super(runner, () => options.createBus());
+    }
+    tests() {
+        this.afterEach(async () => {
+            await this.subject.close?.();
+        });
+        this.deliversToTheSubscribersOfTheType();
+        this.stopsDeliveringOnceUnsubscribed();
+        this.handsTheEnvelopeOverUntouched();
+        this.survivesAFailingHandler();
+    }
+    deliversToTheSubscribersOfTheType() {
+        this.it('delivers an event to the subscribers of its type only', async () => {
+            const happened = this.collect(HAPPENED);
+            const ignored = this.collect(IGNORED);
+            this.expect(await this.publish([busEvent('evt-1')])).toBe(undefined);
+            this.expect(happened.ids()).toEqual(['evt-1']);
+            this.expect(ignored.ids()).toEqual([]);
+        });
+        this.it('delivers to every subscriber of the type', async () => {
+            const first = this.collect(HAPPENED);
+            const second = this.collect(HAPPENED);
+            await this.publish([busEvent('evt-1')]);
+            this.expect(first.ids()).toEqual(['evt-1']);
+            this.expect(second.ids()).toEqual(['evt-1']);
+        });
+        this.it('delivers every event of a batch', async () => {
+            const happened = this.collect(HAPPENED);
+            const ignored = this.collect(IGNORED);
+            await this.publish([busEvent('evt-1'), busEvent('evt-2', IGNORED), busEvent('evt-3')]);
+            this.expect(happened.ids()).toEqual(['evt-1', 'evt-3']);
+            this.expect(ignored.ids()).toEqual(['evt-2']);
+        });
+        this.it('accepts an event nobody subscribed to', async () => {
+            this.expect(await this.publish([busEvent('evt-1')])).toBe(undefined);
+        });
+    }
+    stopsDeliveringOnceUnsubscribed() {
+        this.it('stops delivering to a handler once it is unsubscribed', async () => {
+            const kept = this.collect(HAPPENED);
+            const removed = [];
+            const subscription = this.subject.bus.subscribe(HAPPENED, async (received) => {
+                removed.push(received.id);
+            });
+            await this.publish([busEvent('evt-1')]);
+            subscription.unsubscribe();
+            const before = removed.length;
+            await this.publish([busEvent('evt-2')]);
+            this.expect(kept.ids()).toEqual(['evt-1', 'evt-2']);
+            this.expect(removed.includes('evt-2')).toBe(false);
+            this.expect(before > 0).toBe(true);
+        });
+    }
+    handsTheEnvelopeOverUntouched() {
+        this.it('hands the envelope over exactly as published, trace and correlation included', async () => {
+            const happened = this.collect(HAPPENED);
+            const published = fullEnvelope(busEvent('evt-1'));
+            await this.publish([published]);
+            this.expect(happened.events[0]).toEqual(published);
+        });
+        this.it('does not invent a trace or a correlation when none was published', async () => {
+            const happened = this.collect(HAPPENED);
+            await this.publish([busEvent('evt-1')]);
+            this.expect(happened.events[0]).toEqual(busEvent('evt-1'));
+            this.expect(happened.events[0]?.traceparent).toBe(undefined);
+            this.expect(happened.events[0]?.correlationId).toBe(undefined);
+        });
+    }
+    survivesAFailingHandler() {
+        this.it('surfaces the failure of a handler without starving the other subscribers', async () => {
+            let attempts = 0;
+            this.subject.bus.subscribe(HAPPENED, async () => {
+                attempts += 1;
+                if (attempts === 1) {
+                    throw new Error('handler failed');
+                }
+            });
+            const healthy = this.collect(HAPPENED);
+            const failure = await this.publish([busEvent('evt-1')]);
+            // Either the publication is rejected (in-process) or the event comes back (broker).
+            this.expect(failure !== undefined || attempts > 1).toBe(true);
+            this.expect(healthy.ids()).toEqual(['evt-1']);
+        });
+    }
+    /** Subscribes and returns the distinct ids received, which is what at-least-once allows to assert. */
+    collect(type) {
+        const events = [];
+        this.subject.bus.subscribe(type, async (received) => {
+            events.push(received);
+        });
+        return { events, ids: () => [...new Set(events.map((received) => received.id))].sort() };
+    }
+    async publish(events) {
+        const failure = await failureOf(() => this.subject.bus.publish(events));
+        await this.subject.settle?.();
+        return failure;
+    }
+}
+function busEvent(id, type = HAPPENED) {
+    return {
+        id,
+        type,
+        version: 1,
+        occurredAt: '2026-03-01T10:00:00.000Z',
+        payload: { thingId: `thing-${id}` },
+    };
+}
+//# sourceMappingURL=event-bus-contract.js.map

package/dist/contracts/event-bus-contract.js.map

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

package/dist/contracts/failure-of.d.ts

@@ -0,0 +1,3 @@
+/** What the work rejected with, or `undefined` when it went through. */
+export declare function failureOf(work: () => Promise<unknown>): Promise<unknown>;
+//# sourceMappingURL=failure-of.d.ts.map

package/dist/contracts/failure-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-of.d.ts","sourceRoot":"","sources":["../../src/contracts/failure-of.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAS9E"}

package/dist/contracts/failure-of.js

@@ -0,0 +1,12 @@
+/** What the work rejected with, or `undefined` when it went through. */
+export async function failureOf(work) {
+    try {
+        await work();
+    }
+    catch (error) {
+        // A thrown `undefined` would read as "no failure".
+        return error ?? new Error('rejected without a reason');
+    }
+    return undefined;
+}
+//# sourceMappingURL=failure-of.js.map

package/dist/contracts/failure-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-of.js","sourceRoot":"","sources":["../../src/contracts/failure-of.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAA4B;IAC1D,IAAI,CAAC;QACH,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mDAAmD;QACnD,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/contracts/full-envelope.d.ts

@@ -0,0 +1,4 @@
+import type { IntegrationEvent } from '@ddd-ts-kit/kernel';
+/** An envelope using everything a provider has to carry: nesting, null, offset, trace. */
+export declare function fullEnvelope(event: IntegrationEvent): IntegrationEvent;
+//# sourceMappingURL=full-envelope.d.ts.map

package/dist/contracts/full-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-envelope.d.ts","sourceRoot":"","sources":["../../src/contracts/full-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAStE"}

package/dist/contracts/full-envelope.js

@@ -0,0 +1,12 @@
+/** An envelope using everything a provider has to carry: nesting, null, offset, trace. */
+export function fullEnvelope(event) {
+    return {
+        ...event,
+        version: 3,
+        occurredAt: '2026-03-01T11:30:00.123+01:00',
+        payload: { thingId: 'thing-1', lines: [{ sku: 'sku-1', quantity: 2 }], note: null },
+        traceparent: '00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01',
+        correlationId: 'corr-7f3a',
+    };
+}
+//# sourceMappingURL=full-envelope.js.map

package/dist/contracts/full-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-envelope.js","sourceRoot":"","sources":["../../src/contracts/full-envelope.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,KAAuB;IAClD,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,+BAA+B;QAC3C,OAAO,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;QACnF,WAAW,EAAE,yDAAyD;QACtE,aAAa,EAAE,WAAW;KAC3B,CAAC;AACJ,CAAC"}

package/dist/contracts/job-scheduler-contract.d.ts

@@ -0,0 +1,21 @@
+import type { ExecutionScope, JobScheduler } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+export interface JobSchedulerUnderContract {
+    readonly scheduler: JobScheduler;
+    /** The scope the scheduler runs its jobs in. */
+    readonly scope: ExecutionScope;
+    /**
+     * Makes the time of the scheduler pass and lets the runs that became due finish: advances its
+     * clock and timers, or really waits. The suite asks for a few seconds at most.
+     */
+    elapse(ms: number): Awaitable<void>;
+}
+export interface JobSchedulerContractOptions {
+    readonly name: string;
+    /** A scheduler without job, not started; called before each test. */
+    createScheduler(): Awaitable<JobSchedulerUnderContract>;
+}
+/** What every adapter of the kernel `JobScheduler` port guarantees, the in-process one included. */
+export declare function jobSchedulerContract(runner: ContractRunner, options: JobSchedulerContractOptions): void;
+//# sourceMappingURL=job-scheduler-contract.d.ts.map

package/dist/contracts/job-scheduler-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-scheduler-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/job-scheduler-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,cAAc,EAAgB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,eAAe,IAAI,SAAS,CAAC,yBAAyB,CAAC,CAAC;CACzD;AAED,oGAAoG;AACpG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAEvG"}

package/dist/contracts/job-scheduler-contract.js

@@ -0,0 +1,181 @@
+import { ContractSuite } from './contract-suite.js';
+/** What every adapter of the kernel `JobScheduler` port guarantees, the in-process one included. */
+export function jobSchedulerContract(runner, options) {
+    new JobSchedulerSuite(runner, options).describe(`${options.name} (job scheduler contract)`);
+}
+const EVERY_SECOND = { every: '1s' };
+const REMINDERS = 'billing.send-reminders';
+const EXPORT = 'billing.export-ledger';
+class CodedFailure extends Error {
+    code = 'LEDGER_CLOSED';
+}
+class JobSchedulerSuite extends ContractSuite {
+    constructor(runner, options) {
+        super(runner, () => options.createScheduler());
+    }
+    tests() {
+        this.afterEach(async () => {
+            await this.scheduler.stop();
+        });
+        this.registers();
+        this.runsOnDemand();
+        this.runsOnDemandOnly();
+        this.runsByTime();
+        this.doesNotOverlap();
+        this.isolatesFailures();
+        this.opensAScope();
+    }
+    get scheduler() {
+        return this.subject.scheduler;
+    }
+    registers() {
+        this.it('describes a registered job by its name and its schedule, before any run', async () => {
+            this.scheduler.register({
+                name: REMINDERS,
+                schedule: { cron: '0 7 * * 1-5', timeZone: 'Europe/Paris' },
+                run: async () => undefined,
+            });
+            this.expect(this.scheduler.describe()).toEqual([
+                { name: REMINDERS, schedule: 'cron 0 7 * * 1-5 (Europe/Paris)', enabled: true, running: false },
+            ]);
+        });
+        this.it('refuses a second job under a name already registered', async () => {
+            this.scheduler.register({ name: REMINDERS, schedule: EVERY_SECOND, run: async () => undefined });
+            this.expect(codeOf(() => this.scheduler.register({ name: REMINDERS, schedule: EVERY_SECOND, run: async () => undefined }))).toBe('DUPLICATE_JOB');
+        });
+        this.it('refuses a schedule it cannot read', async () => {
+            this.expect(codeOf(() => this.scheduler.register({ name: REMINDERS, schedule: { cron: 'every day' }, run: async () => undefined }))).toBe('INVALID_JOB_SCHEDULE');
+        });
+    }
+    runsOnDemand() {
+        this.it('runs a job at once when asked, started or not, and says what became of it', async () => {
+            const executions = [];
+            this.scheduler.register({
+                name: REMINDERS,
+                schedule: EVERY_SECOND,
+                run: async (execution) => void executions.push(execution),
+            });
+            const run = await this.scheduler.runNow(REMINDERS);
+            this.expect([run.job, run.outcome, executions.length]).toEqual([REMINDERS, 'succeeded', 1]);
+            this.expect(executions[0]?.scheduledAt.getTime()).toBe(run.scheduledAt.getTime());
+            this.expect([executions[0]?.attempt, executions[0]?.signal.aborted]).toEqual([1, false]);
+            this.expect(this.scheduler.describe()[0]?.lastRun?.outcome).toBe('succeeded');
+        });
+    }
+    runsOnDemandOnly() {
+        this.it('runs a disabled job when asked, and never by time', async () => {
+            let runs = 0;
+            this.scheduler.register({
+                name: REMINDERS,
+                schedule: EVERY_SECOND,
+                enabled: false,
+                run: async () => void (runs += 1),
+            });
+            await this.scheduler.start();
+            await this.subject.elapse(2_500);
+            this.expect([runs, this.scheduler.describe()[0]?.enabled]).toEqual([0, false]);
+            await this.scheduler.runNow(REMINDERS);
+            this.expect(runs).toBe(1);
+        });
+        this.it('rejects the run of a job nobody registered', async () => {
+            const failure = await this.scheduler.runNow('billing.unknown').then(() => undefined, (error) => error);
+            this.expect(codeOf(() => rethrow(failure))).toBe('UNKNOWN_JOB');
+        });
+    }
+    runsByTime() {
+        this.it('runs nothing until it is started, then each job when it is due', async () => {
+            let runs = 0;
+            this.scheduler.register({ name: REMINDERS, schedule: EVERY_SECOND, run: async () => void (runs += 1) });
+            await this.subject.elapse(1_500);
+            this.expect(runs).toBe(0);
+            await this.scheduler.start();
+            await this.subject.elapse(2_500);
+            this.expect(runs >= 2).toBe(true);
+            this.expect(this.scheduler.describe()[0]?.nextRunAt instanceof Date).toBe(true);
+        });
+        this.it('runs nothing more once stopped', async () => {
+            let runs = 0;
+            this.scheduler.register({ name: REMINDERS, schedule: EVERY_SECOND, run: async () => void (runs += 1) });
+            await this.scheduler.start();
+            await this.subject.elapse(1_500);
+            await this.scheduler.stop();
+            const before = runs;
+            await this.subject.elapse(2_500);
+            this.expect(runs).toBe(before);
+        });
+    }
+    doesNotOverlap() {
+        this.it('does not start a job again while its previous run is in progress', async () => {
+            let started = 0;
+            let finish = () => undefined;
+            const blocked = new Promise((resolve) => {
+                finish = resolve;
+            });
+            this.scheduler.register({ name: EXPORT, schedule: EVERY_SECOND, run: () => ((started += 1), blocked) });
+            await this.scheduler.start();
+            await this.subject.elapse(3_500);
+            this.expect([started, this.scheduler.describe()[0]?.running]).toEqual([1, true]);
+            finish();
+        });
+    }
+    isolatesFailures() {
+        this.it('answers failed with the code of the error, never rejecting, and keeps running the other jobs', async () => {
+            let runs = 0;
+            this.scheduler.register({
+                name: EXPORT,
+                schedule: EVERY_SECOND,
+                run: () => Promise.reject(new CodedFailure('the ledger of ACME is closed')),
+            });
+            this.scheduler.register({ name: REMINDERS, schedule: EVERY_SECOND, run: async () => void (runs += 1) });
+            await this.scheduler.start();
+            await this.subject.elapse(2_500);
+            const run = await this.scheduler.runNow(EXPORT);
+            this.expect([run.outcome, run.errorCode]).toEqual(['failed', 'LEDGER_CLOSED']);
+            this.expect(JSON.stringify(this.scheduler.describe()).includes('ACME')).toBe(false);
+            this.expect(runs >= 2).toBe(true);
+        });
+        this.it('answers failed for a job that throws before it answers a promise', async () => {
+            this.scheduler.register({
+                name: EXPORT,
+                schedule: EVERY_SECOND,
+                run: () => {
+                    throw new TypeError('not a function');
+                },
+            });
+            this.expect((await this.scheduler.runNow(EXPORT)).outcome).toBe('failed');
+        });
+    }
+    opensAScope() {
+        this.it('runs each job in an execution context of its own: origin schedule, the system actor of the job', async () => {
+            const seen = [];
+            this.scheduler.register({
+                name: REMINDERS,
+                schedule: EVERY_SECOND,
+                run: async () => void seen.push(this.subject.scope.current()),
+            });
+            const first = await this.scheduler.runNow(REMINDERS);
+            await this.scheduler.runNow(REMINDERS);
+            const [context, next] = seen;
+            this.expect([context?.origin, context?.actor.id, context?.actor.type]).toEqual([
+                'schedule',
+                `system:${REMINDERS}`,
+                'system',
+            ]);
+            this.expect(context?.scheduledAt?.getTime()).toBe(first.scheduledAt.getTime());
+            this.expect(typeof context?.correlationId === 'string' && context.correlationId !== next?.correlationId).toBe(true);
+        });
+    }
+}
+function codeOf(attempt) {
+    try {
+        attempt();
+        return undefined;
+    }
+    catch (error) {
+        return typeof error === 'object' && error !== null && 'code' in error ? error.code : error;
+    }
+}
+function rethrow(failure) {
+    throw failure;
+}
+//# sourceMappingURL=job-scheduler-contract.js.map

package/dist/contracts/job-scheduler-contract.js.map

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

package/dist/contracts/lock-contract.d.ts

@@ -0,0 +1,13 @@
+import type { Lock } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+export interface LockContractOptions {
+    readonly name: string;
+    /** A lock nobody holds; called before each test. */
+    createLock(): Awaitable<Lock>;
+    /** Makes the time of the lock pass: advances its clock, or really waits. */
+    elapse(ms: number): Awaitable<void>;
+}
+/** What every adapter of the kernel `Lock` port guarantees, the in-memory one included. */
+export declare function lockContract(runner: ContractRunner, options: LockContractOptions): void;
+//# sourceMappingURL=lock-contract.d.ts.map

package/dist/contracts/lock-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/lock-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAEvF"}