@ddd-ts-kit/kernel 0.0.0-stage → 0.1.1

package/dist/infrastructure/domain-events/unit-of-work-stage.js

@@ -0,0 +1,9 @@
+import { unitOfWorkScope } from './unit-of-work-scope.js';
+export function unitOfWorkStage() {
+    const scope = unitOfWorkScope.getStore();
+    if (scope === undefined || scope.kind === 'save' || scope.stage === 'closed') {
+        return 'outside';
+    }
+    return scope.stage;
+}
+//# sourceMappingURL=unit-of-work-stage.js.map

package/dist/infrastructure/domain-events/unit-of-work-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-of-work-stage.js","sourceRoot":"","sources":["../../../src/infrastructure/domain-events/unit-of-work-stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAS1D,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC;IAEzC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC;AACrB,CAAC"}

package/dist/infrastructure/domain-events/within-unit-of-work.d.ts

@@ -0,0 +1,17 @@
+/**
+ * What every `UnitOfWork.run` is made of. `transaction` runs what it is given atomically: it
+ * begins, calls it, and commits when it resolved or rolls back when it rejected.
+ *
+ * The domain events of the aggregates saved by `work` wait in the scope of this unit of work,
+ * in recording order across the saves. Once `work` has returned they are dispatched, still
+ * inside `transaction`: the handlers see every save, and what they save or append to the outbox
+ * commits with the rest. A handler that fails, like `work` that fails, rejects the whole: the
+ * transaction rolls back, the waiting events are dropped and never come back on the aggregates.
+ * Once `transaction` has resolved, and only then, the `after-commit` handlers run.
+ *
+ * Called inside a unit of work already running on the same asynchronous call chain it joins it:
+ * `transaction(work)` and nothing else, so one dispatch, at the end of the outermost. Two
+ * concurrent calls never share a scope.
+ */
+export declare function withinUnitOfWork<T>(work: () => Promise<T>, transaction: (work: () => Promise<T>) => Promise<T>): Promise<T>;
+//# sourceMappingURL=within-unit-of-work.d.ts.map

package/dist/infrastructure/domain-events/within-unit-of-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"within-unit-of-work.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/domain-events/within-unit-of-work.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

package/dist/infrastructure/domain-events/within-unit-of-work.js

@@ -0,0 +1,41 @@
+import { dispatchAfterCommit } from './dispatch-after-commit.js';
+import { dispatchBeforeCommit } from './dispatch-before-commit.js';
+import { unitOfWorkScope } from './unit-of-work-scope.js';
+/**
+ * What every `UnitOfWork.run` is made of. `transaction` runs what it is given atomically: it
+ * begins, calls it, and commits when it resolved or rolls back when it rejected.
+ *
+ * The domain events of the aggregates saved by `work` wait in the scope of this unit of work,
+ * in recording order across the saves. Once `work` has returned they are dispatched, still
+ * inside `transaction`: the handlers see every save, and what they save or append to the outbox
+ * commits with the rest. A handler that fails, like `work` that fails, rejects the whole: the
+ * transaction rolls back, the waiting events are dropped and never come back on the aggregates.
+ * Once `transaction` has resolved, and only then, the `after-commit` handlers run.
+ *
+ * Called inside a unit of work already running on the same asynchronous call chain it joins it:
+ * `transaction(work)` and nothing else, so one dispatch, at the end of the outermost. Two
+ * concurrent calls never share a scope.
+ */
+export async function withinUnitOfWork(work, transaction) {
+    if (isRunning(unitOfWorkScope.getStore())) {
+        return transaction(work);
+    }
+    const scope = { kind: 'unit-of-work', stage: 'open', queue: [], dispatched: [] };
+    const result = await unitOfWorkScope
+        .run(scope, () => transaction(() => thenDispatched(work, scope)))
+        .finally(() => {
+        scope.stage = 'closed';
+        scope.queue.length = 0;
+    });
+    await dispatchAfterCommit(scope);
+    return result;
+}
+function isRunning(scope) {
+    return scope?.kind === 'unit-of-work' && (scope.stage === 'open' || scope.stage === 'before-commit');
+}
+async function thenDispatched(work, scope) {
+    const result = await work();
+    await dispatchBeforeCommit(scope);
+    return result;
+}
+//# sourceMappingURL=within-unit-of-work.js.map

package/dist/infrastructure/domain-events/within-unit-of-work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"within-unit-of-work.js","sourceRoot":"","sources":["../../../src/infrastructure/domain-events/within-unit-of-work.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAwB,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAsB,EACtB,WAAmD;IAEnD,IAAI,SAAS,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAoB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAElG,MAAM,MAAM,GAAG,MAAM,eAAe;SACjC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;SAChE,OAAO,CAAC,GAAG,EAAE;QACZ,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC;QACvB,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEL,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAEjC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,KAAkC;IACnD,OAAO,KAAK,EAAE,IAAI,KAAK,cAAc,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,eAAe,CAAC,CAAC;AACvG,CAAC;AAED,KAAK,UAAU,cAAc,CAAI,IAAsB,EAAE,KAAsB;IAC7E,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IAE5B,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/infrastructure/error-reporting/dead-letter-error.d.ts

@@ -0,0 +1,11 @@
+/**
+ * An event was given up by its provider and nothing remembered what its handler threw: a
+ * poison message, a publication that never succeeded, a failure seen by another process.
+ * It names the provider's code, never the content of the event.
+ */
+export declare class DeadLetterError extends Error {
+    readonly kind: string;
+    readonly code: string;
+    constructor(kind: string, code: string);
+}
+//# sourceMappingURL=dead-letter-error.d.ts.map

package/dist/infrastructure/error-reporting/dead-letter-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-error.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/error-reporting/dead-letter-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAEtC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFvB,YACW,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAItB;CACF"}

package/dist/infrastructure/error-reporting/dead-letter-error.js

@@ -0,0 +1,16 @@
+/**
+ * An event was given up by its provider and nothing remembered what its handler threw: a
+ * poison message, a publication that never succeeded, a failure seen by another process.
+ * It names the provider's code, never the content of the event.
+ */
+export class DeadLetterError extends Error {
+    kind;
+    code;
+    constructor(kind, code) {
+        super(`An event was given up after a ${kind} failure: ${code}`);
+        this.kind = kind;
+        this.code = code;
+        this.name = 'DeadLetterError';
+    }
+}
+//# sourceMappingURL=dead-letter-error.js.map

package/dist/infrastructure/error-reporting/dead-letter-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-error.js","sourceRoot":"","sources":["../../../src/infrastructure/error-reporting/dead-letter-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAE7B,IAAI;IACJ,IAAI;IAFf,YACW,IAAY,EACZ,IAAY;QAErB,KAAK,CAAC,iCAAiC,IAAI,aAAa,IAAI,EAAE,CAAC,CAAC;oBAHvD,IAAI;oBACJ,IAAI;QAGb,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/infrastructure/error-reporting/dead-letter-reports.d.ts

@@ -0,0 +1,46 @@
+import type { ErrorReporter } from '../../application/ports/error-reporter.js';
+import type { IntegrationEventSubscriber } from '../../application/ports/integration-event-subscriber.js';
+/**
+ * What the `onFailure` hook of every provider says, read structurally: the broker adapters
+ * (`handler`, `poison`, `connection`) and the outbox relay (`publish`, `tick`) all fit.
+ */
+export interface DeliveryFailure {
+    readonly kind: string;
+    readonly code: string;
+    /** The provider gave the event up: retries exhausted, sent to the dead-letter destination. */
+    readonly dead?: boolean;
+    /** Which delivery failed, counted from 1. */
+    readonly attempt?: number;
+    readonly eventId?: string;
+    readonly eventType?: string;
+    readonly consumer?: string;
+    readonly queue?: string;
+    readonly stream?: string;
+    readonly topic?: string;
+}
+export interface DeadLetterReportsOptions {
+    /** How many failed deliveries are remembered while their provider decides. Default 1 000. */
+    readonly capacity?: number;
+}
+/**
+ * Reports the events a provider gives up, and only those: a delivery that fails and is retried
+ * is the normal life of an at-least-once consumer. The hooks of the providers say codes only,
+ * so `observing` remembers what each handler threw until `onFailure` hears what became of the
+ * event; the report of a buried event then carries the real error and its stack. A business
+ * refusal that buries an event is reported as a `warning`: the event is lost to its consumer
+ * all the same. One memory per event id: of two consumers failing the same event in the same
+ * process, the last one is remembered.
+ */
+export declare class DeadLetterReports {
+    private readonly reporter;
+    private readonly thrown;
+    private readonly capacity;
+    constructor(reporter: ErrorReporter, options?: DeadLetterReportsOptions);
+    /** The subscriber to hand to the application in place of the provider's. */
+    observing(subscriber: IntegrationEventSubscriber): IntegrationEventSubscriber;
+    /** The `onFailure` hook of the provider: `onFailure: (failure) => deadLetters.onFailure(failure)`. */
+    onFailure(failure: DeliveryFailure): void;
+    private watched;
+    private remember;
+}
+//# sourceMappingURL=dead-letter-reports.d.ts.map

package/dist/infrastructure/error-reporting/dead-letter-reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-reports.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/error-reporting/dead-letter-reports.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AAG1G;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAUD;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAM1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,YACmB,QAAQ,EAAE,aAAa,EACxC,OAAO,GAAE,wBAA6B,EAGvC;IAED,4EAA4E;IAC5E,SAAS,CAAC,UAAU,EAAE,0BAA0B,GAAG,0BAA0B,CAI5E;IAED,sGAAsG;IACtG,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAcxC;YAEa,OAAO;IAUrB,OAAO,CAAC,QAAQ;CAmBjB"}

package/dist/infrastructure/error-reporting/dead-letter-reports.js

@@ -0,0 +1,83 @@
+import { errorReportOf } from '../../application/error-reporting/error-report-of.js';
+import { isUnexpectedError } from '../../application/error-reporting/is-unexpected-error.js';
+import { reportOnce } from '../../application/error-reporting/report-once.js';
+import { DeadLetterError } from './dead-letter-error.js';
+const TRACEPARENT = /^[0-9a-f]{2}-([0-9a-f]{32})-[0-9a-f]{16}-[0-9a-f]{2}$/;
+/**
+ * Reports the events a provider gives up, and only those: a delivery that fails and is retried
+ * is the normal life of an at-least-once consumer. The hooks of the providers say codes only,
+ * so `observing` remembers what each handler threw until `onFailure` hears what became of the
+ * event; the report of a buried event then carries the real error and its stack. A business
+ * refusal that buries an event is reported as a `warning`: the event is lost to its consumer
+ * all the same. One memory per event id: of two consumers failing the same event in the same
+ * process, the last one is remembered.
+ */
+export class DeadLetterReports {
+    reporter;
+    thrown = new Map();
+    capacity;
+    constructor(reporter, options = {}) {
+        this.reporter = reporter;
+        this.capacity = options.capacity ?? 1_000;
+    }
+    /** The subscriber to hand to the application in place of the provider's. */
+    observing(subscriber) {
+        return {
+            subscribe: (type, handler) => subscriber.subscribe(type, (event) => this.watched(event, handler)),
+        };
+    }
+    /** The `onFailure` hook of the provider: `onFailure: (failure) => deadLetters.onFailure(failure)`. */
+    onFailure(failure) {
+        if (failure.dead !== true && failure.kind !== 'poison') {
+            return;
+        }
+        const thrown = failure.eventId === undefined ? undefined : this.thrown.get(failure.eventId);
+        if (failure.eventId !== undefined) {
+            this.thrown.delete(failure.eventId);
+        }
+        const error = thrown?.error ?? new DeadLetterError(failure.kind, failure.code);
+        reportOnce(this.reporter, error, reportOf(failure, error, thrown));
+    }
+    async watched(event, handler) {
+        try {
+            await handler(event);
+        }
+        catch (error) {
+            this.remember(event, error);
+            throw error;
+        }
+    }
+    remember(event, error) {
+        const traceId = TRACEPARENT.exec(event.traceparent ?? '')?.[1];
+        this.thrown.delete(event.id);
+        this.thrown.set(event.id, {
+            error,
+            correlationId: event.correlationId ?? event.id,
+            ...(traceId === undefined ? {} : { traceId }),
+        });
+        for (const oldest of this.thrown.keys()) {
+            if (this.thrown.size <= this.capacity) {
+                break;
+            }
+            this.thrown.delete(oldest);
+        }
+    }
+}
+function reportOf(failure, error, thrown) {
+    const correlationId = thrown?.correlationId ?? failure.eventId;
+    return errorReportOf(error, {
+        origin: 'event',
+        operation: operationOf(failure),
+        errorCode: failure.code,
+        severity: isUnexpectedError(error) ? 'error' : 'warning',
+        ...(failure.consumer === undefined ? {} : { context: failure.consumer.split('.', 1).join('') }),
+        ...(correlationId === undefined ? {} : { correlationId }),
+        ...(thrown?.traceId === undefined ? {} : { traceId: thrown.traceId }),
+    });
+}
+/** The event type and where it was going: the consumer when the provider names it, else its queue, stream or topic. */
+function operationOf(failure) {
+    const destination = failure.consumer ?? failure.queue ?? failure.stream ?? failure.topic;
+    return [failure.eventType ?? failure.kind, destination].filter((part) => part !== undefined).join(' ');
+}
+//# sourceMappingURL=dead-letter-reports.js.map

package/dist/infrastructure/error-reporting/dead-letter-reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-reports.js","sourceRoot":"","sources":["../../../src/infrastructure/error-reporting/dead-letter-reports.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/error-reporting/report-process-failures.d.ts

@@ -0,0 +1,26 @@
+import type { ErrorReporter } from '../../application/ports/error-reporter.js';
+type ProcessFailure = 'uncaughtException' | 'unhandledRejection';
+/** The part of `process` this needs, so a test hands it something else. */
+export interface CrashingProcess {
+    on(event: ProcessFailure, listener: (reason: unknown) => void): unknown;
+    off(event: ProcessFailure, listener: (reason: unknown) => void): unknown;
+    exit(code: number): unknown;
+    readonly stderr: {
+        write(text: string): unknown;
+    };
+}
+export interface ProcessFailureOptions {
+    /** How long the reporter is given to send the report before the process exits. Default 2 000. */
+    readonly flushTimeoutMs?: number;
+    /** Default: the process itself. */
+    readonly target?: CrashingProcess;
+}
+/**
+ * Reports what nothing caught, as `fatal`, then ends the process the way Node would have
+ * without a listener: the stack on the standard error, exit code 1. The only difference is
+ * the time given to the reporter to send. Call it once, in the composition root; the answer
+ * removes the listeners.
+ */
+export declare function reportProcessFailures(reporter: ErrorReporter, options?: ProcessFailureOptions): () => void;
+export {};
+//# sourceMappingURL=report-process-failures.d.ts.map

package/dist/infrastructure/error-reporting/report-process-failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-process-failures.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/error-reporting/report-process-failures.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE/E,KAAK,cAAc,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;AAEjE,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;IACxE,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;IACzE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC,iGAAiG;IACjG,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,mCAAmC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,IAAI,CAqB9G"}

package/dist/infrastructure/error-reporting/report-process-failures.js

@@ -0,0 +1,40 @@
+import { errorReportOf } from '../../application/error-reporting/error-report-of.js';
+import { reportOnce } from '../../application/error-reporting/report-once.js';
+const FAILURES = ['uncaughtException', 'unhandledRejection'];
+/**
+ * Reports what nothing caught, as `fatal`, then ends the process the way Node would have
+ * without a listener: the stack on the standard error, exit code 1. The only difference is
+ * the time given to the reporter to send. Call it once, in the composition root; the answer
+ * removes the listeners.
+ */
+export function reportProcessFailures(reporter, options = {}) {
+    const target = options.target ?? process;
+    const flushTimeoutMs = options.flushTimeoutMs ?? 2_000;
+    const listeners = FAILURES.map((operation) => {
+        const crash = (reason) => {
+            reportOnce(reporter, reason, errorReportOf(reason, { origin: 'process', operation, severity: 'fatal' }));
+            target.stderr.write(`${stackOf(reason)}\n`);
+            void exitAfterFlush(reporter, flushTimeoutMs, target);
+        };
+        target.on(operation, crash);
+        return { operation, crash };
+    });
+    return () => {
+        for (const { operation, crash } of listeners) {
+            target.off(operation, crash);
+        }
+    };
+}
+function stackOf(reason) {
+    return reason instanceof Error ? (reason.stack ?? reason.message) : `Uncaught ${String(reason)}`;
+}
+async function exitAfterFlush(reporter, timeoutMs, target) {
+    try {
+        await reporter.flush(timeoutMs);
+    }
+    catch {
+        // A reporter that cannot send must not keep a crashed process alive.
+    }
+    target.exit(1);
+}
+//# sourceMappingURL=report-process-failures.js.map

package/dist/infrastructure/error-reporting/report-process-failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-process-failures.js","sourceRoot":"","sources":["../../../src/infrastructure/error-reporting/report-process-failures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAC;AAoB9E,MAAM,QAAQ,GAA8B,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,CAAC;AAExF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAuB,EAAE,OAAO,GAA0B,EAAE;IAChG,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC;IACzC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;IAEvD,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,CAAC,MAAe,EAAQ,EAAE;YACtC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YACzG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5C,KAAK,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC;QAEF,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAE5B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,SAAS,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,MAAe;IAC9B,OAAO,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACnG,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,QAAuB,EAAE,SAAiB,EAAE,MAAuB;IAC/F,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;IACvE,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/dist/infrastructure/events/idempotent.d.ts

@@ -0,0 +1,8 @@
+import type { IntegrationEventCallback } from '../../application/events/integration-event-callback.js';
+import type { ProcessedEventStore } from '../../application/ports/processed-event-store.js';
+/**
+ * Wraps a handler so a redelivered event is processed once per consumer. A failed handler
+ * gives its mark back, otherwise the redelivery would be skipped and the event lost.
+ */
+export declare function idempotent(consumer: string, store: ProcessedEventStore, handler: IntegrationEventCallback): IntegrationEventCallback;
+//# sourceMappingURL=idempotent.d.ts.map

package/dist/infrastructure/events/idempotent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotent.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/events/idempotent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AACvG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAE5F;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAa1B"}

package/dist/infrastructure/events/idempotent.js

@@ -0,0 +1,19 @@
+/**
+ * Wraps a handler so a redelivered event is processed once per consumer. A failed handler
+ * gives its mark back, otherwise the redelivery would be skipped and the event lost.
+ */
+export function idempotent(consumer, store, handler) {
+    return async (event, delivery) => {
+        if (!(await store.markProcessed(consumer, event.id))) {
+            return;
+        }
+        try {
+            await handler(event, delivery);
+        }
+        catch (error) {
+            await store.release?.(consumer, event.id);
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=idempotent.js.map

package/dist/infrastructure/events/idempotent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotent.js","sourceRoot":"","sources":["../../../src/infrastructure/events/idempotent.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,KAA0B,EAC1B,OAAiC;IAEjC,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC/B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACrD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1C,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/infrastructure/id/sequential-id-generator.d.ts

@@ -0,0 +1,8 @@
+import type { IdGenerator } from '../../application/ports/id-generator.js';
+export declare class SequentialIdGenerator implements IdGenerator {
+    private readonly prefix;
+    private n;
+    constructor(prefix?: string);
+    next(): string;
+}
+//# sourceMappingURL=sequential-id-generator.d.ts.map

package/dist/infrastructure/id/sequential-id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequential-id-generator.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/id/sequential-id-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E,qBAAa,qBAAsB,YAAW,WAAW;IAG3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,CAAC,CAAK;IAEd,YAA6B,MAAM,SAAO,EAAI;IAE9C,IAAI,IAAI,MAAM,CAIb;CACF"}

package/dist/infrastructure/id/sequential-id-generator.js

@@ -0,0 +1,12 @@
+export class SequentialIdGenerator {
+    prefix;
+    n = 0;
+    constructor(prefix = 'id') {
+        this.prefix = prefix;
+    }
+    next() {
+        this.n += 1;
+        return `${this.prefix}-${this.n}`;
+    }
+}
+//# sourceMappingURL=sequential-id-generator.js.map

package/dist/infrastructure/id/sequential-id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequential-id-generator.js","sourceRoot":"","sources":["../../../src/infrastructure/id/sequential-id-generator.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAqB;IAGH,MAAM;IAF3B,CAAC,GAAG,CAAC,CAAC;IAEd,YAA6B,MAAM,GAAG,IAAI;sBAAb,MAAM;IAAU,CAAC;IAE9C,IAAI;QACF,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAEZ,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/infrastructure/id/uuid-generator.d.ts

@@ -0,0 +1,5 @@
+import type { IdGenerator } from '../../application/ports/id-generator.js';
+export declare class UuidGenerator implements IdGenerator {
+    next(): string;
+}
+//# sourceMappingURL=uuid-generator.d.ts.map

package/dist/infrastructure/id/uuid-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid-generator.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/id/uuid-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E,qBAAa,aAAc,YAAW,WAAW;IAC/C,IAAI,IAAI,MAAM,CAEb;CACF"}

package/dist/infrastructure/id/uuid-generator.js

@@ -0,0 +1,7 @@
+import { randomUUID } from 'node:crypto';
+export class UuidGenerator {
+    next() {
+        return randomUUID();
+    }
+}
+//# sourceMappingURL=uuid-generator.js.map

package/dist/infrastructure/id/uuid-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid-generator.js","sourceRoot":"","sources":["../../../src/infrastructure/id/uuid-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,OAAO,aAAa;IACxB,IAAI;QACF,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/infrastructure/in-memory/any-handler.d.ts

@@ -0,0 +1,9 @@
+import type { Message } from '../../application/messaging/message.js';
+/**
+ * Declared with method syntax on purpose: a method parameter is compared bivariantly, so a
+ * handler of one message type can be stored next to the handlers of every other type.
+ */
+export interface AnyHandler {
+    execute(message: Message): Promise<unknown>;
+}
+//# sourceMappingURL=any-handler.d.ts.map

package/dist/infrastructure/in-memory/any-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"any-handler.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/any-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7C"}

package/dist/infrastructure/in-memory/any-handler.js

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

package/dist/infrastructure/in-memory/any-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"any-handler.js","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/any-handler.ts"],"names":[],"mappings":""}

package/dist/infrastructure/in-memory/error-reporting-middleware.d.ts

@@ -0,0 +1,12 @@
+import type { BusMiddleware } from '../../application/messaging/bus-middleware.js';
+import type { ErrorReporter } from '../../application/ports/error-reporter.js';
+import type { ExecutionScope } from '../../application/ports/execution-scope.js';
+/**
+ * Reports the command or query that fails with something else than a `DomainError`, named
+ * after the message class, then lets the failure go on. Put it first on the bus, outside the
+ * unit of work, so a failed commit is seen too. Inside a unit of work of origin `event` it stays
+ * silent: a failed delivery is retried, which is expected, and the hook of the provider reports
+ * the event once it is given up (`DeadLetterReports`).
+ */
+export declare function errorReportingMiddleware(reporter: ErrorReporter, scope?: Pick<ExecutionScope, 'current'>): BusMiddleware;
+//# sourceMappingURL=error-reporting-middleware.d.ts.map

package/dist/infrastructure/in-memory/error-reporting-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporting-middleware.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/error-reporting-middleware.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAEjF;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GACtC,aAAa,CAcf"}

package/dist/infrastructure/in-memory/error-reporting-middleware.js

@@ -0,0 +1,25 @@
+import { errorReportOf } from '../../application/error-reporting/error-report-of.js';
+import { isUnexpectedError } from '../../application/error-reporting/is-unexpected-error.js';
+import { reportOnce } from '../../application/error-reporting/report-once.js';
+/**
+ * Reports the command or query that fails with something else than a `DomainError`, named
+ * after the message class, then lets the failure go on. Put it first on the bus, outside the
+ * unit of work, so a failed commit is seen too. Inside a unit of work of origin `event` it stays
+ * silent: a failed delivery is retried, which is expected, and the hook of the provider reports
+ * the event once it is given up (`DeadLetterReports`).
+ */
+export function errorReportingMiddleware(reporter, scope) {
+    return async (_message, next, info) => {
+        try {
+            return await next();
+        }
+        catch (error) {
+            const execution = scope?.current();
+            if (isUnexpectedError(error) && execution?.origin !== 'event') {
+                reportOnce(reporter, error, errorReportOf(error, { origin: info.kind, operation: info.name }, execution));
+            }
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=error-reporting-middleware.js.map

package/dist/infrastructure/in-memory/error-reporting-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporting-middleware.js","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/error-reporting-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAC;AAK9E;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAuB,EACvB,KAAuC;IAEvC,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC;YAEnC,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC9D,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;YAC5G,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/infrastructure/in-memory/in-memory-cache.d.ts

@@ -0,0 +1,23 @@
+import type { CacheKey } from '../../application/cache/cache-key.js';
+import type { Cache, CacheEntryOptions } from '../../application/ports/cache.js';
+import type { Clock } from '../../application/ports/clock.js';
+export interface InMemoryCacheOptions {
+    /** Beyond it the oldest entry goes. Default 1000. */
+    readonly maxEntries?: number;
+}
+/**
+ * A bounded map in the memory of the process, with expiry read from the `Clock`. Fine for one
+ * instance and for tests; several instances share nothing.
+ */
+export declare class InMemoryCache implements Cache {
+    private readonly clock;
+    private readonly entries;
+    private readonly maxEntries;
+    constructor(clock: Clock, options?: InMemoryCacheOptions);
+    get size(): number;
+    get<T>(key: CacheKey<T>): Promise<T | undefined>;
+    set<T>(key: CacheKey<T>, value: T, options?: CacheEntryOptions): Promise<void>;
+    delete(key: CacheKey<unknown>): Promise<void>;
+    private evictBeyondCapacity;
+}
+//# sourceMappingURL=in-memory-cache.d.ts.map

package/dist/infrastructure/in-memory/in-memory-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-cache.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/in-memory-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AASD;;;GAGG;AACH,qBAAa,aAAc,YAAW,KAAK;IAMvC,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,YACmB,KAAK,EAAE,KAAK,EAC7B,OAAO,GAAE,oBAAyB,EAGnC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAerD;IAEK,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CASvF;IAEK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAElD;IAED,OAAO,CAAC,mBAAmB;CAS5B"}

package/dist/infrastructure/in-memory/in-memory-cache.js

@@ -0,0 +1,49 @@
+const DEFAULT_MAX_ENTRIES = 1000;
+/**
+ * A bounded map in the memory of the process, with expiry read from the `Clock`. Fine for one
+ * instance and for tests; several instances share nothing.
+ */
+export class InMemoryCache {
+    clock;
+    entries = new Map();
+    maxEntries;
+    constructor(clock, options = {}) {
+        this.clock = clock;
+        this.maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    }
+    get size() {
+        return this.entries.size;
+    }
+    async get(key) {
+        const entry = this.entries.get(key.name);
+        if (entry === undefined) {
+            return undefined;
+        }
+        if (entry.expiresAt !== undefined && entry.expiresAt <= this.clock.now().getTime()) {
+            this.entries.delete(key.name);
+            return undefined;
+        }
+        // eslint-disable-next-line ddd-ts-kit/clean-no-escape-hatch -- entries of every type share one map: the link between a key and the type of its value is only known to the CacheKey that wrote it
+        return entry.value;
+    }
+    async set(key, value, options = {}) {
+        this.entries.delete(key.name);
+        this.entries.set(key.name, {
+            value,
+            ...(options.ttlMs === undefined ? {} : { expiresAt: this.clock.now().getTime() + options.ttlMs }),
+        });
+        this.evictBeyondCapacity();
+    }
+    async delete(key) {
+        this.entries.delete(key.name);
+    }
+    evictBeyondCapacity() {
+        for (const name of this.entries.keys()) {
+            if (this.entries.size <= this.maxEntries) {
+                return;
+            }
+            this.entries.delete(name);
+        }
+    }
+}
+//# sourceMappingURL=in-memory-cache.js.map

package/dist/infrastructure/in-memory/in-memory-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-cache.js","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/in-memory-cache.ts"],"names":[],"mappings":"AAcA,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;;GAGG;AACH,MAAM,OAAO,aAAa;IAML,KAAK;IALP,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEnC,UAAU,CAAS;IAEpC,YACmB,KAAY,EAC7B,OAAO,GAAyB,EAAE;qBADjB,KAAK;QAGtB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC9D,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAgB;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YACnF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAE9B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,iMAAiM;QACjM,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAgB,EAAE,KAAQ,EAAE,OAAO,GAAsB,EAAE;QACtE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE;YACzB,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;SAClG,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAsB;QACjC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAEO,mBAAmB;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACzC,OAAO;YACT,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/infrastructure/in-memory/in-memory-command-bus.d.ts

@@ -0,0 +1,14 @@
+import type { CommandHandler } from '../../application/messaging/command-handler.js';
+import type { Command } from '../../application/messaging/command.js';
+import type { HandlerRegistration } from '../../application/messaging/handler-registration.js';
+import type { MessageType } from '../../application/messaging/message-type.js';
+import type { ResultOf } from '../../application/messaging/result-of.js';
+import type { CommandBus } from '../../application/ports/command-bus.js';
+import { InProcessBus } from './in-process-bus.js';
+/** One handler per command type, resolved in process. The default CommandBus. */
+export declare class InMemoryCommandBus extends InProcessBus implements CommandBus {
+    constructor();
+    register<C extends Command<unknown>>(type: MessageType<C>, handler: CommandHandler<C>, registration?: HandlerRegistration): this;
+    execute<C extends Command<unknown>>(command: C): Promise<ResultOf<C>>;
+}
+//# sourceMappingURL=in-memory-command-bus.d.ts.map

package/dist/infrastructure/in-memory/in-memory-command-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-command-bus.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/in-memory/in-memory-command-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,iFAAiF;AACjF,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,UAAU;IACxE,cAEC;IAED,QAAQ,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,EACjC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,YAAY,CAAC,EAAE,mBAAmB,GACjC,IAAI,CAIN;IAED,OAAO,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAEpE;CACF"}