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

package/dist/application/ports/audit-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-reader.d.ts","sourceRoot":"","sources":["../../../src/application/ports/audit-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;GAIG;AACH,8BAAsB,WAAW;IAK/B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;CACpG"}

package/dist/application/ports/audit-reader.js

@@ -0,0 +1,11 @@
+/**
+ * The read side, a port of its own: who may read the trail is a decision of the application,
+ * and most code that records never reads. The first sort of the request decides the order
+ * (default `occurredAt` ascending). An offset page carries `total`, a cursor page `nextCursor`.
+ */
+export class AuditReader {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.AuditReader' });
+    }
+}
+//# sourceMappingURL=audit-reader.js.map

package/dist/application/ports/audit-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-reader.js","sourceRoot":"","sources":["../../../src/application/ports/audit-reader.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,OAAgB,WAAW;IAC/B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC3E,CAAC;CAGF"}

package/dist/application/ports/audit-trail.d.ts

@@ -0,0 +1,10 @@
+import type { AuditRecord } from '../audit/audit-record.js';
+/**
+ * The write side of the audit trail: append only. There is no update and no delete, here or
+ * in any adapter: an entry that turns out to be wrong is corrected by another entry. Fed by
+ * infrastructure and cross-cutting code, never by a use case or an aggregate.
+ */
+export declare abstract class AuditTrail {
+    abstract record(record: AuditRecord): Promise<void>;
+}
+//# sourceMappingURL=audit-trail.d.ts.map

package/dist/application/ports/audit-trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-trail.d.ts","sourceRoot":"","sources":["../../../src/application/ports/audit-trail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;GAIG;AACH,8BAAsB,UAAU;IAK9B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD"}

package/dist/application/ports/audit-trail.js

@@ -0,0 +1,11 @@
+/**
+ * The write side of the audit trail: append only. There is no update and no delete, here or
+ * in any adapter: an entry that turns out to be wrong is corrected by another entry. Fed by
+ * infrastructure and cross-cutting code, never by a use case or an aggregate.
+ */
+export class AuditTrail {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.AuditTrail' });
+    }
+}
+//# sourceMappingURL=audit-trail.js.map

package/dist/application/ports/audit-trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-trail.js","sourceRoot":"","sources":["../../../src/application/ports/audit-trail.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAgB,UAAU;IAC9B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC1E,CAAC;CAGF"}

package/dist/application/ports/cache.d.ts

@@ -0,0 +1,16 @@
+import type { CacheKey } from '../cache/cache-key.js';
+export interface CacheEntryOptions {
+    /** Time to live. Without it the entry stays until deleted or evicted. */
+    readonly ttlMs?: number;
+}
+/**
+ * A place for values that can be computed again. A miss and an expired entry both answer
+ * `undefined`. Never the source of truth, never behind a repository: see `cached` of
+ * `@ddd-ts-kit/aspects`.
+ */
+export declare abstract class Cache {
+    abstract get<T>(key: CacheKey<T>): Promise<T | undefined>;
+    abstract set<T>(key: CacheKey<T>, value: T, options?: CacheEntryOptions): Promise<void>;
+    abstract delete(key: CacheKey<unknown>): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/application/ports/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/application/ports/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,8BAAsB,KAAK;IAKzB,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE1D,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExF,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD"}

package/dist/application/ports/cache.js

@@ -0,0 +1,11 @@
+/**
+ * A place for values that can be computed again. A miss and an expired entry both answer
+ * `undefined`. Never the source of truth, never behind a repository: see `cached` of
+ * `@ddd-ts-kit/aspects`.
+ */
+export class Cache {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.Cache' });
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/application/ports/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/application/ports/cache.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,OAAgB,KAAK;IACzB;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;IACrE,CAAC;CAOF"}

package/dist/application/ports/clock.d.ts

@@ -0,0 +1,4 @@
+export declare abstract class Clock {
+    abstract now(): Date;
+}
+//# sourceMappingURL=clock.d.ts.map

package/dist/application/ports/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../../src/application/ports/clock.ts"],"names":[],"mappings":"AAAA,8BAAsB,KAAK;IAKzB,QAAQ,CAAC,GAAG,IAAI,IAAI,CAAC;CACtB"}

package/dist/application/ports/clock.js

@@ -0,0 +1,6 @@
+export class Clock {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.Clock' });
+    }
+}
+//# sourceMappingURL=clock.js.map

package/dist/application/ports/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../../src/application/ports/clock.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,KAAK;IACzB;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;IACrE,CAAC;CAGF"}

package/dist/application/ports/command-bus.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from '../messaging/command.js';
+import type { ResultOf } from '../messaging/result-of.js';
+/**
+ * Driving ports of the application layer. Presentation and consumers depend on these,
+ * never on a handler class, so the transport behind (in-process, queue, RPC) is a wiring choice.
+ */
+export declare abstract class CommandBus {
+    abstract execute<C extends Command<unknown>>(command: C): Promise<ResultOf<C>>;
+}
+//# sourceMappingURL=command-bus.d.ts.map

package/dist/application/ports/command-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.d.ts","sourceRoot":"","sources":["../../../src/application/ports/command-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,8BAAsB,UAAU;IAK9B,QAAQ,CAAC,OAAO,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAChF"}

package/dist/application/ports/command-bus.js

@@ -0,0 +1,10 @@
+/**
+ * Driving ports of the application layer. Presentation and consumers depend on these,
+ * never on a handler class, so the transport behind (in-process, queue, RPC) is a wiring choice.
+ */
+export class CommandBus {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.CommandBus' });
+    }
+}
+//# sourceMappingURL=command-bus.js.map

package/dist/application/ports/command-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.js","sourceRoot":"","sources":["../../../src/application/ports/command-bus.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAgB,UAAU;IAC9B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC1E,CAAC;CAGF"}

package/dist/application/ports/domain-event-dispatcher.d.ts

@@ -0,0 +1,19 @@
+import type { DomainEvent } from '../../domain/domain-event.js';
+import type { DomainEventCallback } from '../events/domain-event-callback.js';
+import type { DomainEventPhase } from '../events/domain-event-phase.js';
+import type { DomainEventSubscription } from '../events/domain-event-subscription.js';
+/**
+ * In-context reactions to what the aggregates recorded. Cross-context reactions use
+ * IntegrationEvents. Use cases do not depend on it: the save of a repository hands over what the
+ * aggregate recorded, and the unit of work dispatches it at its end (`withinUnitOfWork`).
+ */
+export declare abstract class DomainEventDispatcher {
+    /**
+     * Runs the handlers of one phase, `before-commit` by default, event after event. Before the
+     * commit the first failure rejects. After the commit it never rejects: a failing handler is
+     * reported and the next ones still run.
+     */
+    abstract dispatch(events: readonly DomainEvent[], phase?: DomainEventPhase): Promise<void>;
+    abstract on(name: string, handler: DomainEventCallback, subscription?: DomainEventSubscription): void;
+}
+//# sourceMappingURL=domain-event-dispatcher.d.ts.map

package/dist/application/ports/domain-event-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/application/ports/domain-event-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEtF;;;;GAIG;AACH,8BAAsB,qBAAqB;IAKzC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3F,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,YAAY,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACvG"}

package/dist/application/ports/domain-event-dispatcher.js

@@ -0,0 +1,11 @@
+/**
+ * In-context reactions to what the aggregates recorded. Cross-context reactions use
+ * IntegrationEvents. Use cases do not depend on it: the save of a repository hands over what the
+ * aggregate recorded, and the unit of work dispatches it at its end (`withinUnitOfWork`).
+ */
+export class DomainEventDispatcher {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.DomainEventDispatcher' });
+    }
+}
+//# sourceMappingURL=domain-event-dispatcher.js.map

package/dist/application/ports/domain-event-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-dispatcher.js","sourceRoot":"","sources":["../../../src/application/ports/domain-event-dispatcher.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,OAAgB,qBAAqB;IACzC;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;IACrF,CAAC;CAUF"}

package/dist/application/ports/error-reporter.d.ts

@@ -0,0 +1,17 @@
+import type { ErrorReport } from '../error-reporting/error-report.js';
+/**
+ * Where unexpected failures go to be looked at: an error tracker. Called by what stands around
+ * the use cases (a bus middleware, the route pipeline, the job scheduler, the hooks of an event
+ * provider, the process), never by a handler, an aggregate or a repository: they throw, and that
+ * is all they say. A business refusal (`DomainError`) is not reported.
+ */
+export declare abstract class ErrorReporter {
+    /** Queues the failure and returns at once: never throws, never waits for the tracker. */
+    abstract report(error: unknown, report: ErrorReport): void;
+    /**
+     * Waits until nothing queued is left to send, `timeoutMs` at most, before the process stops.
+     * Answers `false` when something was still waiting. Never rejects.
+     */
+    abstract flush(timeoutMs: number): Promise<boolean>;
+}
+//# sourceMappingURL=error-reporter.d.ts.map

package/dist/application/ports/error-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporter.d.ts","sourceRoot":"","sources":["../../../src/application/ports/error-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE;;;;;GAKG;AACH,8BAAsB,aAAa;IAKjC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAE3D;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrD"}

package/dist/application/ports/error-reporter.js

@@ -0,0 +1,12 @@
+/**
+ * Where unexpected failures go to be looked at: an error tracker. Called by what stands around
+ * the use cases (a bus middleware, the route pipeline, the job scheduler, the hooks of an event
+ * provider, the process), never by a handler, an aggregate or a repository: they throw, and that
+ * is all they say. A business refusal (`DomainError`) is not reported.
+ */
+export class ErrorReporter {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.ErrorReporter' });
+    }
+}
+//# sourceMappingURL=error-reporter.js.map

package/dist/application/ports/error-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporter.js","sourceRoot":"","sources":["../../../src/application/ports/error-reporter.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAgB,aAAa;IACjC;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAC7E,CAAC;CAUF"}

package/dist/application/ports/event-bus.d.ts

@@ -0,0 +1,11 @@
+import type { IntegrationEventCallback } from '../events/integration-event-callback.js';
+import type { IntegrationEvent } from '../events/integration-event.js';
+import type { Subscription } from '../events/subscription.js';
+import type { IntegrationEventPublisher } from './integration-event-publisher.js';
+import type { IntegrationEventSubscriber } from './integration-event-subscriber.js';
+/** Any provider is an EventBus: in-memory, outbox and broker, queue service. */
+export declare abstract class EventBus implements IntegrationEventPublisher, IntegrationEventSubscriber {
+    abstract publish(events: readonly IntegrationEvent[]): Promise<void>;
+    abstract subscribe(type: string, handler: IntegrationEventCallback): Subscription;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/application/ports/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../../src/application/ports/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,gFAAgF;AAChF,8BAAsB,QAAS,YAAW,yBAAyB,EAAE,0BAA0B;IAK7F,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,YAAY,CAAC;CACnF"}

package/dist/application/ports/event-bus.js

@@ -0,0 +1,7 @@
+/** Any provider is an EventBus: in-memory, outbox and broker, queue service. */
+export class EventBus {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.EventBus' });
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/application/ports/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../../src/application/ports/event-bus.ts"],"names":[],"mappings":"AAMA,gFAAgF;AAChF,MAAM,OAAgB,QAAQ;IAC5B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACxE,CAAC;CAKF"}

package/dist/application/ports/event-subscribers.d.ts

@@ -0,0 +1,9 @@
+import type { IntegrationEventSubscriber } from './integration-event-subscriber.js';
+/**
+ * The subscriber of each bounded context. One bus serves them all by default; a broker gives
+ * every consuming context its own, so that an extracted context keeps its queues.
+ */
+export declare abstract class EventSubscribers {
+    abstract forContext(name: string): IntegrationEventSubscriber;
+}
+//# sourceMappingURL=event-subscribers.d.ts.map

package/dist/application/ports/event-subscribers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-subscribers.d.ts","sourceRoot":"","sources":["../../../src/application/ports/event-subscribers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEpF;;;GAGG;AACH,8BAAsB,gBAAgB;IAKpC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,CAAC;CAC/D"}

package/dist/application/ports/event-subscribers.js

@@ -0,0 +1,10 @@
+/**
+ * The subscriber of each bounded context. One bus serves them all by default; a broker gives
+ * every consuming context its own, so that an extracted context keeps its queues.
+ */
+export class EventSubscribers {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.EventSubscribers' });
+    }
+}
+//# sourceMappingURL=event-subscribers.js.map

package/dist/application/ports/event-subscribers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-subscribers.js","sourceRoot":"","sources":["../../../src/application/ports/event-subscribers.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAgB,gBAAgB;IACpC;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC,CAAC;IAChF,CAAC;CAGF"}

package/dist/application/ports/execution-scope.d.ts

@@ -0,0 +1,14 @@
+import type { ExecutionContext } from '../execution/execution-context.js';
+/**
+ * The execution context of the work in progress, for infrastructure and cross-cutting code
+ * that is not handed it: loggers, audit columns, tenant scoping, outgoing headers. Set once at
+ * the boundary with `run`. Use cases and the domain never read it: they receive what they need
+ * in the command or query.
+ */
+export declare abstract class ExecutionScope {
+    abstract current(): ExecutionContext | undefined;
+    /** Throws `NoExecutionContextError` outside of `run`. */
+    abstract require(): ExecutionContext;
+    abstract run<T>(context: ExecutionContext, work: () => T): T;
+}
+//# sourceMappingURL=execution-scope.d.ts.map

package/dist/application/ports/execution-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-scope.d.ts","sourceRoot":"","sources":["../../../src/application/ports/execution-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E;;;;;GAKG;AACH,8BAAsB,cAAc;IAKlC,QAAQ,CAAC,OAAO,IAAI,gBAAgB,GAAG,SAAS,CAAC;IAEjD,yDAAyD;IACzD,QAAQ,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAErC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CAC9D"}

package/dist/application/ports/execution-scope.js

@@ -0,0 +1,12 @@
+/**
+ * The execution context of the work in progress, for infrastructure and cross-cutting code
+ * that is not handed it: loggers, audit columns, tenant scoping, outgoing headers. Set once at
+ * the boundary with `run`. Use cases and the domain never read it: they receive what they need
+ * in the command or query.
+ */
+export class ExecutionScope {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.ExecutionScope' });
+    }
+}
+//# sourceMappingURL=execution-scope.js.map

package/dist/application/ports/execution-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-scope.js","sourceRoot":"","sources":["../../../src/application/ports/execution-scope.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAgB,cAAc;IAClC;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;IAC9E,CAAC;CAQF"}

package/dist/application/ports/id-generator.d.ts

@@ -0,0 +1,4 @@
+export declare abstract class IdGenerator {
+    abstract next(): string;
+}
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/application/ports/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../../src/application/ports/id-generator.ts"],"names":[],"mappings":"AAAA,8BAAsB,WAAW;IAK/B,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC;CACzB"}

package/dist/application/ports/id-generator.js

@@ -0,0 +1,6 @@
+export class IdGenerator {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.IdGenerator' });
+    }
+}
+//# sourceMappingURL=id-generator.js.map

package/dist/application/ports/id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.js","sourceRoot":"","sources":["../../../src/application/ports/id-generator.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,WAAW;IAC/B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC3E,CAAC;CAGF"}

package/dist/application/ports/integration-event-publisher.d.ts

@@ -0,0 +1,6 @@
+import type { IntegrationEvent } from '../events/integration-event.js';
+/** What use cases publish through, for any provider: in-memory, outbox and broker, SQS, Kafka, NATS, RabbitMQ. */
+export declare abstract class IntegrationEventPublisher {
+    abstract publish(events: readonly IntegrationEvent[]): Promise<void>;
+}
+//# sourceMappingURL=integration-event-publisher.d.ts.map

package/dist/application/ports/integration-event-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-event-publisher.d.ts","sourceRoot":"","sources":["../../../src/application/ports/integration-event-publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,kHAAkH;AAClH,8BAAsB,yBAAyB;IAK7C,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE"}

package/dist/application/ports/integration-event-publisher.js

@@ -0,0 +1,7 @@
+/** What use cases publish through, for any provider: in-memory, outbox and broker, SQS, Kafka, NATS, RabbitMQ. */
+export class IntegrationEventPublisher {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.IntegrationEventPublisher' });
+    }
+}
+//# sourceMappingURL=integration-event-publisher.js.map

package/dist/application/ports/integration-event-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-event-publisher.js","sourceRoot":"","sources":["../../../src/application/ports/integration-event-publisher.ts"],"names":[],"mappings":"AAEA,kHAAkH;AAClH,MAAM,OAAgB,yBAAyB;IAC7C;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC,CAAC;IACzF,CAAC;CAGF"}

package/dist/application/ports/integration-event-subscriber.d.ts

@@ -0,0 +1,7 @@
+import type { IntegrationEventCallback } from '../events/integration-event-callback.js';
+import type { Subscription } from '../events/subscription.js';
+/** What integration event handlers are subscribed to: the event bus by default, a broker adapter otherwise. */
+export declare abstract class IntegrationEventSubscriber {
+    abstract subscribe(type: string, handler: IntegrationEventCallback): Subscription;
+}
+//# sourceMappingURL=integration-event-subscriber.d.ts.map

package/dist/application/ports/integration-event-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-event-subscriber.d.ts","sourceRoot":"","sources":["../../../src/application/ports/integration-event-subscriber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,+GAA+G;AAC/G,8BAAsB,0BAA0B;IAK9C,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,YAAY,CAAC;CACnF"}

package/dist/application/ports/integration-event-subscriber.js

@@ -0,0 +1,7 @@
+/** What integration event handlers are subscribed to: the event bus by default, a broker adapter otherwise. */
+export class IntegrationEventSubscriber {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.IntegrationEventSubscriber' });
+    }
+}
+//# sourceMappingURL=integration-event-subscriber.js.map

package/dist/application/ports/integration-event-subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-event-subscriber.js","sourceRoot":"","sources":["../../../src/application/ports/integration-event-subscriber.ts"],"names":[],"mappings":"AAGA,+GAA+G;AAC/G,MAAM,OAAgB,0BAA0B;IAC9C;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC;IAC1F,CAAC;CAGF"}

package/dist/application/ports/job-scheduler.d.ts

@@ -0,0 +1,22 @@
+import type { JobDefinition } from '../scheduling/job-definition.js';
+import type { JobDescription } from '../scheduling/job-description.js';
+import type { JobRun } from '../scheduling/job-run.js';
+/**
+ * Runs jobs when they are due. Not the timer of `@ddd-ts-kit/aspects`: this one knows jobs,
+ * schedules and instances. A failing job stops neither the scheduler nor the other jobs.
+ */
+export declare abstract class JobScheduler {
+    /** Throws `DuplicateJobError` for a name already registered, `InvalidJobScheduleError` for a schedule it cannot read. */
+    abstract register(job: JobDefinition): void;
+    /** Starts running the enabled jobs by time. Starting twice does nothing. */
+    abstract start(): Promise<void>;
+    /** Stops starting runs, waits for those in progress up to a grace period, then aborts them through their signal. */
+    abstract stop(): Promise<void>;
+    /**
+     * Runs a job at once, enabled or not, for an operation or a test, and answers what became of
+     * it. A job that fails answers `failed`: only an unknown name rejects, with `UnknownJobError`.
+     */
+    abstract runNow(name: string): Promise<JobRun>;
+    abstract describe(): readonly JobDescription[];
+}
+//# sourceMappingURL=job-scheduler.d.ts.map

package/dist/application/ports/job-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-scheduler.d.ts","sourceRoot":"","sources":["../../../src/application/ports/job-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;;GAGG;AACH,8BAAsB,YAAY;IAKhC,yHAAyH;IACzH,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;IAE5C,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC,oHAAoH;IACpH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C,QAAQ,CAAC,QAAQ,IAAI,SAAS,cAAc,EAAE,CAAC;CAChD"}

package/dist/application/ports/job-scheduler.js

@@ -0,0 +1,10 @@
+/**
+ * Runs jobs when they are due. Not the timer of `@ddd-ts-kit/aspects`: this one knows jobs,
+ * schedules and instances. A failing job stops neither the scheduler nor the other jobs.
+ */
+export class JobScheduler {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.JobScheduler' });
+    }
+}
+//# sourceMappingURL=job-scheduler.js.map

package/dist/application/ports/job-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-scheduler.js","sourceRoot":"","sources":["../../../src/application/ports/job-scheduler.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAgB,YAAY;IAChC;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC5E,CAAC;CAkBF"}

package/dist/application/ports/lock.d.ts

@@ -0,0 +1,16 @@
+import type { LockHandle } from '../lock/lock-handle.js';
+export interface AcquireOptions {
+    /** After it the lock frees itself: the holder crashed, or took longer than it promised. */
+    readonly ttlMs: number;
+    /** How long to wait for a lock somebody else holds. Default 0: answer at once. */
+    readonly waitMs?: number;
+}
+/**
+ * A mutex between processes, to avoid doing the same work twice: `undefined` when somebody
+ * else holds the key. An efficiency tool, never the guard of an invariant: what must not
+ * happen twice is refused by a database constraint.
+ */
+export declare abstract class Lock {
+    abstract acquire(key: string, options: AcquireOptions): Promise<LockHandle | undefined>;
+}
+//# sourceMappingURL=lock.d.ts.map

package/dist/application/ports/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/application/ports/lock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,8BAAsB,IAAI;IAKxB,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;CACzF"}

package/dist/application/ports/lock.js

@@ -0,0 +1,11 @@
+/**
+ * A mutex between processes, to avoid doing the same work twice: `undefined` when somebody
+ * else holds the key. An efficiency tool, never the guard of an invariant: what must not
+ * happen twice is refused by a database constraint.
+ */
+export class Lock {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.Lock' });
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/application/ports/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/application/ports/lock.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,OAAgB,IAAI;IACxB;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;IACpE,CAAC;CAGF"}

package/dist/application/ports/logger.d.ts

@@ -0,0 +1,41 @@
+import type { LogFields } from '../logging/log-fields.js';
+import type { LogLevel } from '../logging/log-level.js';
+/**
+ * Structured logging, for infrastructure, presentation and cross-cutting code. The domain and
+ * use cases do not log: what they have to say is an event or an error.
+ *
+ * A call never throws, whatever the fields: an entry whose fields cannot be read or serialized
+ * is written with `UNWRITABLE_FIELDS` in their place.
+ *
+ * An `Error` directly under a key of the fields is written as `describeError` describes it:
+ * `type` (its class name), `code` when it is a `DomainError`, `message`, its own `stack`, then
+ * `cause` the same way, eight errors deep at most. Deeper in the fields an error is left to the
+ * serializer of the adapter. A logger built with `scrubMessages: true` writes
+ * `SCRUBBED_MESSAGE` for the message of every unexpected error, anything but a `DomainError`,
+ * and drops the first line of its stack, which repeats it.
+ *
+ * The kit never hands an error to a logger: its aspects, middlewares and scheduler write
+ * `errorType` and `errorCode` only (`identifyError`), and the error goes to the `ErrorReporter`.
+ * The full description is for the error a project chooses to log.
+ */
+export declare abstract class Logger {
+    abstract debug(message: string, fields?: LogFields): void;
+    abstract info(message: string, fields?: LogFields): void;
+    abstract warn(message: string, fields?: LogFields): void;
+    abstract error(message: string, fields?: LogFields): void;
+    /** A logger adding the fields to every entry it writes, with the level and the destination of this one. */
+    abstract child(fields: LogFields): Logger;
+    /**
+     * Whether an entry of that level would be written, for this logger and its children. Asked
+     * before building fields that cost; a logger that writes nothing answers `false`.
+     */
+    abstract isLevelEnabled(level: LogLevel): boolean;
+    /**
+     * Resolves once every entry logged so far, through this logger or a child, was handed to its
+     * destination. Never rejects. Called once, when the process stops, after the last entry: an
+     * entry logged afterwards may be written or dropped, depending on the adapter, and never
+     * throws; a second call resolves too.
+     */
+    abstract flush(): Promise<void>;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/application/ports/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/application/ports/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,MAAM;IAK1B,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAE1D,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAEzD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAEzD,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAE1D,2GAA2G;IAC3G,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAE1C;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IAElD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC"}

package/dist/application/ports/logger.js

@@ -0,0 +1,24 @@
+/**
+ * Structured logging, for infrastructure, presentation and cross-cutting code. The domain and
+ * use cases do not log: what they have to say is an event or an error.
+ *
+ * A call never throws, whatever the fields: an entry whose fields cannot be read or serialized
+ * is written with `UNWRITABLE_FIELDS` in their place.
+ *
+ * An `Error` directly under a key of the fields is written as `describeError` describes it:
+ * `type` (its class name), `code` when it is a `DomainError`, `message`, its own `stack`, then
+ * `cause` the same way, eight errors deep at most. Deeper in the fields an error is left to the
+ * serializer of the adapter. A logger built with `scrubMessages: true` writes
+ * `SCRUBBED_MESSAGE` for the message of every unexpected error, anything but a `DomainError`,
+ * and drops the first line of its stack, which repeats it.
+ *
+ * The kit never hands an error to a logger: its aspects, middlewares and scheduler write
+ * `errorType` and `errorCode` only (`identifyError`), and the error goes to the `ErrorReporter`.
+ * The full description is for the error a project chooses to log.
+ */
+export class Logger {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.Logger' });
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/application/ports/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/application/ports/logger.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAgB,MAAM;IAC1B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;IACtE,CAAC;CA0BF"}

package/dist/application/ports/metrics.d.ts

@@ -0,0 +1,10 @@
+import type { Counter } from '../metrics/counter.js';
+import type { Gauge } from '../metrics/gauge.js';
+import type { Histogram } from '../metrics/histogram.js';
+/** Asking twice for the same name feeds the same series. */
+export declare abstract class Metrics {
+    abstract counter(name: string): Counter;
+    abstract histogram(name: string): Histogram;
+    abstract gauge(name: string): Gauge;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/application/ports/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/application/ports/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,4DAA4D;AAC5D,8BAAsB,OAAO;IAK3B,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAExC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5C,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;CACrC"}

package/dist/application/ports/metrics.js

@@ -0,0 +1,7 @@
+/** Asking twice for the same name feeds the same series. */
+export class Metrics {
+    static {
+        Object.defineProperty(this, 'tokenKey', { value: 'kernel.Metrics' });
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/application/ports/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/application/ports/metrics.ts"],"names":[],"mappings":"AAIA,4DAA4D;AAC5D,MAAM,OAAgB,OAAO;IAC3B;QACE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACvE,CAAC;CAOF"}

package/dist/application/ports/processed-event-store.d.ts

@@ -0,0 +1,12 @@
+/** Idempotency guard: at-least-once delivery is the rule, so every consumer needs one. */
+export declare abstract class ProcessedEventStore {
+    /** Returns true the first time `(consumer, eventId)` is seen, false afterwards. */
+    abstract markProcessed(consumer: string, eventId: string): Promise<boolean>;
+    /**
+     * Forgets a mark taken by a delivery whose handler then failed, so the redelivery is
+     * handled. Stores whose mark shares the handler's transaction do not need it: the
+     * rollback already removes the mark.
+     */
+    abstract release?(consumer: string, eventId: string): Promise<void>;
+}
+//# sourceMappingURL=processed-event-store.d.ts.map

package/dist/application/ports/processed-event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processed-event-store.d.ts","sourceRoot":"","sources":["../../../src/application/ports/processed-event-store.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,8BAAsB,mBAAmB;IAKvC,mFAAmF;IACnF,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5E;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE"}