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

package/dist/application/error-reporting/error-report-of.js

@@ -0,0 +1,24 @@
+import { identifyError } from '../logging/identify-error.js';
+/**
+ * The report of a failure: what the capture point says, completed from the execution context
+ * of the unit of work (origin, correlation, actor and tenant ids) and from the error (its code).
+ * The severity defaults to `error`.
+ */
+export function errorReportOf(error, source, execution) {
+    const errorCode = source.errorCode ?? identifyError(error).errorCode;
+    return {
+        severity: 'error',
+        ...source,
+        ...(errorCode === undefined ? {} : { errorCode }),
+        ...(execution === undefined ? {} : identifiersOf(execution)),
+    };
+}
+function identifiersOf(execution) {
+    return {
+        origin: execution.origin,
+        correlationId: execution.correlationId,
+        actorId: execution.actor.id,
+        ...(execution.tenantId === undefined ? {} : { tenantId: execution.tenantId }),
+    };
+}
+//# sourceMappingURL=error-report-of.js.map

package/dist/application/error-reporting/error-report-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-report-of.js","sourceRoot":"","sources":["../../../src/application/error-reporting/error-report-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAO7D;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,MAAyB,EAAE,SAA4B;IACnG,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC;IAErE,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,GAAG,MAAM;QACT,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;QACjD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,SAA2B;IAChD,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE;QAC3B,GAAG,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC;KAC9E,CAAC;AACJ,CAAC"}

package/dist/application/error-reporting/error-report.d.ts

@@ -0,0 +1,24 @@
+import type { ErrorOrigin } from './error-origin.js';
+import type { ErrorReportExtensionValues } from './error-report-extension-values.js';
+import type { ErrorSeverity } from './error-severity.js';
+/**
+ * Where and for whom an unexpected failure happened, as plain data: identifiers only, never
+ * the content of a message, a request or an answer. The error itself travels next to it.
+ */
+export interface ErrorReport {
+    readonly origin: ErrorOrigin;
+    /** What was running: a route operation id, a command or query name, an event type and its consumer, a job name. */
+    readonly operation: string;
+    /** Bounded context, when the capture point knows it. */
+    readonly context?: string;
+    readonly correlationId?: string;
+    /** Leads to the trace of the unit of work. An adapter may read it from the active span instead. */
+    readonly traceId?: string;
+    readonly actorId?: string;
+    readonly tenantId?: string;
+    /** The `code` of the error, when it carries a short one. */
+    readonly errorCode?: string;
+    readonly severity: ErrorSeverity;
+    readonly extensions?: ErrorReportExtensionValues;
+}
+//# sourceMappingURL=error-report.d.ts.map

package/dist/application/error-reporting/error-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-report.d.ts","sourceRoot":"","sources":["../../../src/application/error-reporting/error-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,mHAAmH;IACnH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,mGAAmG;IACnG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,0BAA0B,CAAC;CAClD"}

package/dist/application/error-reporting/error-report.js

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

package/dist/application/error-reporting/error-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-report.js","sourceRoot":"","sources":["../../../src/application/error-reporting/error-report.ts"],"names":[],"mappings":""}

package/dist/application/error-reporting/error-severity.d.ts

@@ -0,0 +1,7 @@
+/**
+ * - `fatal`: the process is going down with it.
+ * - `error`: a unit of work failed for a reason nobody planned.
+ * - `warning`: nothing crashed, yet someone has to look, such as an event buried after a business refusal.
+ */
+export type ErrorSeverity = 'fatal' | 'error' | 'warning';
+//# sourceMappingURL=error-severity.d.ts.map

package/dist/application/error-reporting/error-severity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-severity.d.ts","sourceRoot":"","sources":["../../../src/application/error-reporting/error-severity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC"}

package/dist/application/error-reporting/error-severity.js

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

package/dist/application/error-reporting/error-severity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-severity.js","sourceRoot":"","sources":["../../../src/application/error-reporting/error-severity.ts"],"names":[],"mappings":""}

package/dist/application/error-reporting/is-unexpected-error.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A `DomainError` is a business refusal the code planned for: an answer, not an incident.
+ * Everything else thrown is a fault somebody has to look at.
+ */
+export declare function isUnexpectedError(error: unknown): boolean;
+//# sourceMappingURL=is-unexpected-error.d.ts.map

package/dist/application/error-reporting/is-unexpected-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-unexpected-error.d.ts","sourceRoot":"","sources":["../../../src/application/error-reporting/is-unexpected-error.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD"}

package/dist/application/error-reporting/is-unexpected-error.js

@@ -0,0 +1,9 @@
+import { DomainError } from '../../domain/errors/domain-error.js';
+/**
+ * A `DomainError` is a business refusal the code planned for: an answer, not an incident.
+ * Everything else thrown is a fault somebody has to look at.
+ */
+export function isUnexpectedError(error) {
+    return !(error instanceof DomainError);
+}
+//# sourceMappingURL=is-unexpected-error.js.map

package/dist/application/error-reporting/is-unexpected-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-unexpected-error.js","sourceRoot":"","sources":["../../../src/application/error-reporting/is-unexpected-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC,CAAC;AACzC,CAAC"}

package/dist/application/error-reporting/report-once.d.ts

@@ -0,0 +1,11 @@
+import type { ErrorReporter } from '../ports/error-reporter.js';
+import type { ErrorReport } from './error-report.js';
+/**
+ * Hands a failure to the reporter unless a capture point closer to it already did. The first
+ * one to see an error object reports it and marks it; the boundaries it then crosses (a bus,
+ * a route, a job, the process) recognise it, also as the `cause` of the error that wraps it or
+ * among the `errors` of an `AggregateError`. A thrown value that is not an object cannot be
+ * marked. Never throws: a failing reporter must not turn into a second failure.
+ */
+export declare function reportOnce(reporter: ErrorReporter, error: unknown, report: ErrorReport): void;
+//# sourceMappingURL=report-once.d.ts.map

package/dist/application/error-reporting/report-once.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-once.d.ts","sourceRoot":"","sources":["../../../src/application/error-reporting/report-once.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAc7F"}

package/dist/application/error-reporting/report-once.js

@@ -0,0 +1,38 @@
+const REPORTED = new WeakSet();
+const DEEPEST_CAUSE = 8;
+/**
+ * Hands a failure to the reporter unless a capture point closer to it already did. The first
+ * one to see an error object reports it and marks it; the boundaries it then crosses (a bus,
+ * a route, a job, the process) recognise it, also as the `cause` of the error that wraps it or
+ * among the `errors` of an `AggregateError`. A thrown value that is not an object cannot be
+ * marked. Never throws: a failing reporter must not turn into a second failure.
+ */
+export function reportOnce(reporter, error, report) {
+    if (wasReported(error, DEEPEST_CAUSE)) {
+        return;
+    }
+    if (typeof error === 'object' && error !== null) {
+        REPORTED.add(error);
+    }
+    try {
+        reporter.report(error, report);
+    }
+    catch {
+        return;
+    }
+}
+function wasReported(error, depth) {
+    if (typeof error !== 'object' || error === null || depth === 0) {
+        return false;
+    }
+    if (REPORTED.has(error)) {
+        return true;
+    }
+    const inner = innerErrors(error);
+    return inner.length > 0 && inner.every((one) => wasReported(one, depth - 1));
+}
+function innerErrors(error) {
+    const aggregated = error instanceof AggregateError ? error.errors : [];
+    return 'cause' in error ? [error.cause, ...aggregated] : aggregated;
+}
+//# sourceMappingURL=report-once.js.map

package/dist/application/error-reporting/report-once.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-once.js","sourceRoot":"","sources":["../../../src/application/error-reporting/report-once.ts"],"names":[],"mappings":"AAGA,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAU,CAAC;AACvC,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,QAAuB,EAAE,KAAc,EAAE,MAAmB;IACrF,IAAI,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,KAAa;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAEjC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,UAAU,GAAc,KAAK,YAAY,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAElF,OAAO,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AACtE,CAAC"}

package/dist/application/events/after-commit-failure.d.ts

@@ -0,0 +1,4 @@
+import type { DomainEvent } from '../../domain/domain-event.js';
+/** Told each failure of an `after-commit` handler, with the event it was handling. Never throws. */
+export type AfterCommitFailure = (error: unknown, event: DomainEvent) => void;
+//# sourceMappingURL=after-commit-failure.d.ts.map

package/dist/application/events/after-commit-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-commit-failure.d.ts","sourceRoot":"","sources":["../../../src/application/events/after-commit-failure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,oGAAoG;AACpG,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC"}

package/dist/application/events/after-commit-failure.js

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

package/dist/application/events/after-commit-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-commit-failure.js","sourceRoot":"","sources":["../../../src/application/events/after-commit-failure.ts"],"names":[],"mappings":""}

package/dist/application/events/domain-event-callback.d.ts

@@ -0,0 +1,4 @@
+import type { DomainEvent } from '../../domain/domain-event.js';
+/** What a dispatcher is given for one event name: the function it calls with each event. */
+export type DomainEventCallback<E extends DomainEvent = DomainEvent> = (event: E) => Promise<void>;
+//# sourceMappingURL=domain-event-callback.d.ts.map

package/dist/application/events/domain-event-callback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-callback.d.ts","sourceRoot":"","sources":["../../../src/application/events/domain-event-callback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/application/events/domain-event-callback.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domain-event-callback.js.map

package/dist/application/events/domain-event-callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-callback.js","sourceRoot":"","sources":["../../../src/application/events/domain-event-callback.ts"],"names":[],"mappings":""}

package/dist/application/events/domain-event-phase.d.ts

@@ -0,0 +1,14 @@
+/**
+ * When a handler of a domain event runs, relative to the commit of the unit of work that
+ * recorded the event.
+ *
+ * `before-commit`, the default: at the end of the unit of work, inside its transaction. What the
+ * handler writes commits or rolls back with the state change, and its failure fails the command.
+ *
+ * `after-commit`: once the transaction has committed, never when it rolled back. For a local
+ * effect no transaction covers (a cache, a remote call). At most once: a crash between the commit
+ * and the run loses it, and its failure is reported without failing the command. What must not be
+ * lost goes through the outbox as an integration event.
+ */
+export type DomainEventPhase = 'before-commit' | 'after-commit';
+//# sourceMappingURL=domain-event-phase.d.ts.map

package/dist/application/events/domain-event-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-phase.d.ts","sourceRoot":"","sources":["../../../src/application/events/domain-event-phase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,cAAc,CAAC"}

package/dist/application/events/domain-event-phase.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domain-event-phase.js.map

package/dist/application/events/domain-event-phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-phase.js","sourceRoot":"","sources":["../../../src/application/events/domain-event-phase.ts"],"names":[],"mappings":""}

package/dist/application/events/domain-event-subscription.d.ts

@@ -0,0 +1,7 @@
+import type { DomainEventPhase } from './domain-event-phase.js';
+/** How a callback is attached to a dispatcher. */
+export interface DomainEventSubscription {
+    /** Default `before-commit`. */
+    readonly phase?: DomainEventPhase;
+}
+//# sourceMappingURL=domain-event-subscription.d.ts.map

package/dist/application/events/domain-event-subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-subscription.d.ts","sourceRoot":"","sources":["../../../src/application/events/domain-event-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACnC"}

package/dist/application/events/domain-event-subscription.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domain-event-subscription.js.map

package/dist/application/events/domain-event-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-subscription.js","sourceRoot":"","sources":["../../../src/application/events/domain-event-subscription.ts"],"names":[],"mappings":""}

package/dist/application/events/event-delivery.d.ts

@@ -0,0 +1,17 @@
+/**
+ * What a provider says of one delivery, next to the event: identifiers of the transport only,
+ * for what observes the consumers from outside (a trace, a metric). Handlers never read it.
+ */
+export interface EventDelivery {
+    /** Which delivery of the event to this consumer this is, starting at 1. */
+    readonly attempt: number;
+    /** The delivery after which the provider gives the event up. Absent when it never does. */
+    readonly maxAttempts?: number;
+    /** The transport: `rabbitmq`, `kafka`, `nats`, `redis`, `in-memory`. */
+    readonly system?: string;
+    /** What the event was read from: a queue, a topic, a stream, a subject. */
+    readonly destination?: string;
+    /** The queue consumer, consumer group or durable the delivery belongs to. */
+    readonly consumer?: string;
+}
+//# sourceMappingURL=event-delivery.d.ts.map

package/dist/application/events/event-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-delivery.d.ts","sourceRoot":"","sources":["../../../src/application/events/event-delivery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/application/events/event-delivery.js

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

package/dist/application/events/event-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-delivery.js","sourceRoot":"","sources":["../../../src/application/events/event-delivery.ts"],"names":[],"mappings":""}

package/dist/application/events/event-execution-options.d.ts

@@ -0,0 +1,12 @@
+import type { Actor } from '../actor/actor.js';
+import type { IntegrationEvent } from './integration-event.js';
+export interface EventExecutionOptions {
+    /** Stable name of the consumer: the handler runs as `systemActor(consumer)`. */
+    readonly consumer: string;
+    /**
+     * The actor an event names, for a project whose envelopes carry a reference to one. The
+     * standard envelope carries none, so that no personal data travels by default.
+     */
+    readonly actorOf?: (event: IntegrationEvent) => Actor | undefined;
+}
+//# sourceMappingURL=event-execution-options.d.ts.map

package/dist/application/events/event-execution-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-execution-options.d.ts","sourceRoot":"","sources":["../../../src/application/events/event-execution-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,KAAK,GAAG,SAAS,CAAC;CACnE"}

package/dist/application/events/event-execution-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-execution-options.js.map

package/dist/application/events/event-execution-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-execution-options.js","sourceRoot":"","sources":["../../../src/application/events/event-execution-options.ts"],"names":[],"mappings":""}

package/dist/application/events/execution-context-of-event.d.ts

@@ -0,0 +1,9 @@
+import { type ExecutionContext } from '../execution/execution-context.js';
+import type { EventExecutionOptions } from './event-execution-options.js';
+import type { IntegrationEvent } from './integration-event.js';
+/**
+ * The execution context of a consumed event: origin `event`, the correlation of the event (its
+ * own id when it names none, which starts a new chain), and the event as the direct cause.
+ */
+export declare function executionContextOfEvent(event: IntegrationEvent, options: EventExecutionOptions): ExecutionContext;
+//# sourceMappingURL=execution-context-of-event.d.ts.map

package/dist/application/events/execution-context-of-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-of-event.d.ts","sourceRoot":"","sources":["../../../src/application/events/execution-context-of-event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,mCAAmC,CAAC;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CAOjH"}

package/dist/application/events/execution-context-of-event.js

@@ -0,0 +1,15 @@
+import { systemActor } from '../actor/system-actor.js';
+import { executionContext } from '../execution/execution-context.js';
+/**
+ * The execution context of a consumed event: origin `event`, the correlation of the event (its
+ * own id when it names none, which starts a new chain), and the event as the direct cause.
+ */
+export function executionContextOfEvent(event, options) {
+    return executionContext({
+        correlationId: event.correlationId ?? event.id,
+        causationId: event.id,
+        actor: options.actorOf?.(event) ?? systemActor(options.consumer),
+        origin: 'event',
+    });
+}
+//# sourceMappingURL=execution-context-of-event.js.map

package/dist/application/events/execution-context-of-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-of-event.js","sourceRoot":"","sources":["../../../src/application/events/execution-context-of-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAyB,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAI5F;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAuB,EAAE,OAA8B;IAC7F,OAAO,gBAAgB,CAAC;QACtB,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,EAAE;QAC9C,WAAW,EAAE,KAAK,CAAC,EAAE;QACrB,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC;QAChE,MAAM,EAAE,OAAO;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/application/events/in-event-scope.d.ts

@@ -0,0 +1,6 @@
+import type { ExecutionScope } from '../ports/execution-scope.js';
+import type { EventExecutionOptions } from './event-execution-options.js';
+import type { IntegrationEventCallback } from './integration-event-callback.js';
+/** Wraps a handler so that every event it receives is handled inside `scope.run`. */
+export declare function inEventScope(scope: ExecutionScope, options: EventExecutionOptions, handler: IntegrationEventCallback): IntegrationEventCallback;
+//# sourceMappingURL=in-event-scope.d.ts.map

package/dist/application/events/in-event-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-event-scope.d.ts","sourceRoot":"","sources":["../../../src/application/events/in-event-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,qFAAqF;AACrF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAE1B"}

package/dist/application/events/in-event-scope.js

@@ -0,0 +1,6 @@
+import { executionContextOfEvent } from './execution-context-of-event.js';
+/** Wraps a handler so that every event it receives is handled inside `scope.run`. */
+export function inEventScope(scope, options, handler) {
+    return (event, delivery) => scope.run(executionContextOfEvent(event, options), () => handler(event, delivery));
+}
+//# sourceMappingURL=in-event-scope.js.map

package/dist/application/events/in-event-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-event-scope.js","sourceRoot":"","sources":["../../../src/application/events/in-event-scope.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG1E,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAC1B,KAAqB,EACrB,OAA8B,EAC9B,OAAiC;IAEjC,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AACjH,CAAC"}

package/dist/application/events/integration-event-callback.d.ts

@@ -0,0 +1,8 @@
+import type { EventDelivery } from './event-delivery.js';
+import type { IntegrationEvent } from './integration-event.js';
+/**
+ * What a subscriber is given for one event type: the function a provider calls with each
+ * delivery, and with what it knows of that delivery.
+ */
+export type IntegrationEventCallback<E extends IntegrationEvent = IntegrationEvent> = (event: E, delivery?: EventDelivery) => Promise<void>;
+//# sourceMappingURL=integration-event-callback.d.ts.map

package/dist/application/events/integration-event-callback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-event-callback.d.ts","sourceRoot":"","sources":["../../../src/application/events/integration-event-callback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;GAGG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,CACpF,KAAK,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,aAAa,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/application/events/integration-event-callback.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=integration-event-callback.js.map

package/dist/application/events/integration-event-callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-event-callback.js","sourceRoot":"","sources":["../../../src/application/events/integration-event-callback.ts"],"names":[],"mappings":""}

package/dist/application/events/integration-event.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The only thing that crosses a bounded-context boundary: a versioned, serializable,
+ * backward-compatible contract owned by the producer (its published language).
+ */
+export interface IntegrationEvent<Payload = unknown> {
+    readonly id: string;
+    /** Routing key, `<context>.<aggregate>.<fact>`. */
+    readonly type: string;
+    /** Bumped on every breaking change of `payload`; old versions keep being served. */
+    readonly version: number;
+    readonly occurredAt: string;
+    readonly payload: Payload;
+    /** W3C traceparent captured at publication so consumers continue the same trace. */
+    readonly traceparent?: string;
+    readonly correlationId?: string;
+}
+//# sourceMappingURL=integration-event.d.ts.map

package/dist/application/events/integration-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-event.d.ts","sourceRoot":"","sources":["../../../src/application/events/integration-event.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,OAAO;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC"}

package/dist/application/events/integration-event.js

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

package/dist/application/events/integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-event.js","sourceRoot":"","sources":["../../../src/application/events/integration-event.ts"],"names":[],"mappings":""}

package/dist/application/events/messaging-system-of.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The transport a publisher or a subscriber names itself after, read structurally: the event
+ * buses carry `messagingSystem` (`rabbitmq`, `kafka`, `nats`, `redis`, `in-memory`), and a
+ * publisher that only stores for a relay says `outbox`. What observes them from outside (a
+ * trace) reads it; a decorator of a publisher passes it on.
+ */
+export declare function messagingSystemOf(provider: object): string | undefined;
+//# sourceMappingURL=messaging-system-of.d.ts.map

package/dist/application/events/messaging-system-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-system-of.d.ts","sourceRoot":"","sources":["../../../src/application/events/messaging-system-of.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAItE"}

package/dist/application/events/messaging-system-of.js

@@ -0,0 +1,11 @@
+/**
+ * The transport a publisher or a subscriber names itself after, read structurally: the event
+ * buses carry `messagingSystem` (`rabbitmq`, `kafka`, `nats`, `redis`, `in-memory`), and a
+ * publisher that only stores for a relay says `outbox`. What observes them from outside (a
+ * trace) reads it; a decorator of a publisher passes it on.
+ */
+export function messagingSystemOf(provider) {
+    const system = Reflect.get(provider, 'messagingSystem');
+    return typeof system === 'string' ? system : undefined;
+}
+//# sourceMappingURL=messaging-system-of.js.map

package/dist/application/events/messaging-system-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-system-of.js","sourceRoot":"","sources":["../../../src/application/events/messaging-system-of.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,MAAM,GAAY,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAEjE,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC"}

package/dist/application/events/scoped-publisher.d.ts

@@ -0,0 +1,10 @@
+import type { ExecutionScope } from '../ports/execution-scope.js';
+import type { IntegrationEventPublisher } from '../ports/integration-event-publisher.js';
+/**
+ * Decorates a publisher: an event published without `correlationId` takes the one of the work
+ * in progress, so everything one stimulus causes can be found again. An event that names its
+ * correlation keeps it, and outside of any execution context nothing is stamped. The name of
+ * the transport (`messagingSystem`) is passed on.
+ */
+export declare function scopedPublisher(publisher: IntegrationEventPublisher, scope: ExecutionScope): IntegrationEventPublisher;
+//# sourceMappingURL=scoped-publisher.d.ts.map

package/dist/application/events/scoped-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-publisher.d.ts","sourceRoot":"","sources":["../../../src/application/events/scoped-publisher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAIzF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,yBAAyB,EACpC,KAAK,EAAE,cAAc,GACpB,yBAAyB,CAO3B"}

package/dist/application/events/scoped-publisher.js

@@ -0,0 +1,21 @@
+import { messagingSystemOf } from './messaging-system-of.js';
+/**
+ * Decorates a publisher: an event published without `correlationId` takes the one of the work
+ * in progress, so everything one stimulus causes can be found again. An event that names its
+ * correlation keeps it, and outside of any execution context nothing is stamped. The name of
+ * the transport (`messagingSystem`) is passed on.
+ */
+export function scopedPublisher(publisher, scope) {
+    const messagingSystem = messagingSystemOf(publisher);
+    return {
+        publish: (events) => publisher.publish(events.map((event) => correlated(event, scope.current()))),
+        ...(messagingSystem === undefined ? {} : { messagingSystem }),
+    };
+}
+function correlated(event, context) {
+    if (event.correlationId !== undefined || context === undefined) {
+        return event;
+    }
+    return { ...event, correlationId: context.correlationId };
+}
+//# sourceMappingURL=scoped-publisher.js.map

package/dist/application/events/scoped-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-publisher.js","sourceRoot":"","sources":["../../../src/application/events/scoped-publisher.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAoC,EACpC,KAAqB;IAErB,MAAM,eAAe,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAErD,OAAO;QACL,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACjG,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAuB,EAAE,OAAqC;IAChF,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;AAC5D,CAAC"}

package/dist/application/events/subscription.d.ts

@@ -0,0 +1,4 @@
+export interface Subscription {
+    unsubscribe(): void;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/application/events/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/application/events/subscription.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,IAAI,CAAC;CACrB"}

package/dist/application/events/subscription.js

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

package/dist/application/events/subscription.js.map

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

package/dist/application/execution/execution-context-extension-values.d.ts

@@ -0,0 +1,6 @@
+import type { ExecutionContextExtensions } from './execution-context-extensions.js';
+/** The extensions as a context carries them: each one optional. */
+export type ExecutionContextExtensionValues = {
+    readonly [Key in keyof ExecutionContextExtensions]?: ExecutionContextExtensions[Key];
+};
+//# sourceMappingURL=execution-context-extension-values.d.ts.map

package/dist/application/execution/execution-context-extension-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-extension-values.d.ts","sourceRoot":"","sources":["../../../src/application/execution/execution-context-extension-values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,mEAAmE;AACnE,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,GAAG,IAAI,MAAM,0BAA0B,CAAC,CAAC,EAAE,0BAA0B,CAAC,GAAG,CAAC;CACrF,CAAC"}

package/dist/application/execution/execution-context-extension-values.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execution-context-extension-values.js.map

package/dist/application/execution/execution-context-extension-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-extension-values.js","sourceRoot":"","sources":["../../../src/application/execution/execution-context-extension-values.ts"],"names":[],"mappings":""}

package/dist/application/execution/execution-context-extensions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * What a project adds to every execution context, by declaration merging:
+ *
+ *     declare module '@ddd-ts-kit/kernel' {
+ *       interface ExecutionContextExtensions { readonly region: string }
+ *     }
+ */
+export interface ExecutionContextExtensions {
+}
+//# sourceMappingURL=execution-context-extensions.d.ts.map

package/dist/application/execution/execution-context-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-extensions.d.ts","sourceRoot":"","sources":["../../../src/application/execution/execution-context-extensions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;CAAG"}

package/dist/application/execution/execution-context-extensions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execution-context-extensions.js.map

package/dist/application/execution/execution-context-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-extensions.js","sourceRoot":"","sources":["../../../src/application/execution/execution-context-extensions.ts"],"names":[],"mappings":""}

package/dist/application/execution/execution-context.d.ts

@@ -0,0 +1,28 @@
+import type { Actor } from '../actor/actor.js';
+import type { Session } from '../session/session.js';
+import type { ExecutionContextExtensionValues } from './execution-context-extension-values.js';
+import type { ExecutionOrigin } from './execution-origin.js';
+/**
+ * What every unit of work carries, whatever started it: an HTTP request, a consumed event, a
+ * scheduled job, a CLI command. Plain data, set once at the boundary.
+ */
+export interface ExecutionContext {
+    /** The same for everything one external stimulus causes, across processes. */
+    readonly correlationId: string;
+    /** Id of the message or request that directly caused this unit of work. */
+    readonly causationId?: string;
+    readonly actor: Actor;
+    readonly session?: Session;
+    readonly tenantId?: string;
+    readonly locale?: string;
+    /** The instant after which the result is useless to the caller. */
+    readonly deadline?: Date;
+    /** For the origin `schedule`: the instant the job was due, which is not the instant it started. */
+    readonly scheduledAt?: Date;
+    readonly origin: ExecutionOrigin;
+    readonly extensions: ExecutionContextExtensionValues;
+}
+export type ExecutionContextInit = Omit<ExecutionContext, 'extensions' | 'tenantId'> & Partial<Pick<ExecutionContext, 'extensions' | 'tenantId'>>;
+/** Fills what can be derived: the tenant of the actor, no extension. */
+export declare function executionContext(init: ExecutionContextInit): ExecutionContext;
+//# sourceMappingURL=execution-context.d.ts.map