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

package/dist/module/module-builder.d.ts

@@ -0,0 +1,50 @@
+import type { Actored, Command, DependencyKind, MessageType, Query, ScheduledJob } from '@ddd-ts-kit/kernel';
+import type { BindingAspect, EventContract, IntegrationEventHandler, ScheduledOptions, Token } from '@ddd-ts-kit/kernel/declarations';
+import type { ConsumerOptions } from '../consumer/consumer-options.js';
+import type { DeclaredSource } from '../declared/declared-source.js';
+import type { Resolve } from '../wiring/resolve.js';
+import type { BindingTarget } from './binding-target.js';
+import type { HandlerTarget } from './handler-target.js';
+import type { ProtectedUseCaseTarget } from './protected-use-case-target.js';
+import type { UseCaseTarget } from './use-case-target.js';
+export interface ModuleBuilder {
+    /** Binds a port, or the abstract class that types a value: `builder.bind(OrderRepository)`. */
+    bind<T>(port: Token<T>): BindingTarget<T>;
+    /**
+     * Replaces the binding of a module listed earlier, typically a default of `kernelModule()`
+     * (a database unit of work, an outbox publisher). `bind` refuses a port bound twice.
+     */
+    rebind<T>(port: Token<T>): BindingTarget<T>;
+    /** Declares the one handler of a command: bound as a use case and registered on the `CommandBus`. */
+    command<C extends Command<unknown> & Actored>(type: MessageType<C>): ProtectedUseCaseTarget<C>;
+    command<C extends Command<unknown>>(type: MessageType<C>): UseCaseTarget<C>;
+    /** Declares the one handler of a query: bound as a use case and registered on the `QueryBus`. */
+    query<Q extends Query<unknown> & Actored>(type: MessageType<Q>): ProtectedUseCaseTarget<Q>;
+    query<Q extends Query<unknown>>(type: MessageType<Q>): UseCaseTarget<Q>;
+    /**
+     * Declares the handler of an integration event, under a consumer name: subscribed to the
+     * subscriber of the module when the application starts, unsubscribed when it stops. Each
+     * event is handled inside the `ExecutionScope`, in a context of origin `event` that
+     * continues its correlation, its idempotency mark and its work in one `UnitOfWork`.
+     */
+    on<Payload>(contract: EventContract<Payload>, options: ConsumerOptions): HandlerTarget<IntegrationEventHandler<Payload>>;
+    /**
+     * Declares a job run by time, under its name: bound as a singleton and registered on
+     * the `JobScheduler`. `builder.job('billing.send-reminders', { every: '15m' }).handledBy(SendReminders, [CommandBus])`.
+     */
+    job(name: string, settings: ScheduledOptions): HandlerTarget<ScheduledJob>;
+    /**
+     * Adds classes that declare themselves with the decorators of `@ddd-ts-kit/kernel/declarations`:
+     * a class, a list of them, or a namespace import of a barrel. `contextModule` is this call
+     * alone; here it mixes with the explicit statements of one module.
+     */
+    include(declared: DeclaredSource): void;
+    /**
+     * Puts an aspect around every instance the application creates for a binding of one of the
+     * kinds, whichever module declares the binding: outside the aspects of the binding itself
+     * (`.with`), inside the `decorate` hook, the first one declared outermost. This is how
+     * `kernelModule()` makes every repository dispatch domain events with its save.
+     */
+    around(kinds: readonly DependencyKind[], aspect: (resolve: Resolve) => BindingAspect): void;
+}
+//# sourceMappingURL=module-builder.d.ts.map

package/dist/module/module-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-builder.d.ts","sourceRoot":"","sources":["../../src/module/module-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7G,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,EACN,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B,+FAA+F;IAC/F,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAE1C;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAE5C,qGAAqG;IACrG,OAAO,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC/F,OAAO,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAE5E,iGAAiG;IACjG,KAAK,CAAC,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC3F,KAAK,CAAC,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAExE;;;;;OAKG;IACH,EAAE,CAAC,OAAO,EACR,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAChC,OAAO,EAAE,eAAe,GACvB,aAAa,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEnD;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAE3E;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAExC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,aAAa,GAAG,IAAI,CAAC;CAC7F"}

package/dist/module/module-builder.js

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

package/dist/module/module-builder.js.map

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

package/dist/module/module-context.d.ts

@@ -0,0 +1,5 @@
+import type { Resolve } from '../wiring/resolve.js';
+export interface ModuleContext {
+    readonly resolve: Resolve;
+}
+//# sourceMappingURL=module-context.d.ts.map

package/dist/module/module-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-context.d.ts","sourceRoot":"","sources":["../../src/module/module-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B"}

package/dist/module/module-context.js

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

package/dist/module/module-context.js.map

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

package/dist/module/module-recorder.d.ts

@@ -0,0 +1,31 @@
+import type { Command, MessageType, Query, ScheduledJob } from '@ddd-ts-kit/kernel';
+import { type EventContract, type IntegrationEventHandler, type ScheduledOptions, type Token } from '@ddd-ts-kit/kernel/declarations';
+import type { ConsumerOptions } from '../consumer/consumer-options.js';
+import type { DeclaredSource } from '../declared/declared-source.js';
+import type { WiringDraft } from '../wiring/wiring-draft.js';
+import type { BindingTarget } from './binding-target.js';
+import type { HandlerTarget } from './handler-target.js';
+import type { ModuleBuilder } from './module-builder.js';
+import type { ProtectedUseCaseTarget } from './protected-use-case-target.js';
+/** The builder a module registers on: every statement goes to the draft, under the name of the module. */
+export declare class ModuleRecorder implements ModuleBuilder {
+    private readonly module;
+    private readonly draft;
+    private readonly unfinished;
+    constructor(module: string, draft: WiringDraft);
+    readonly bind: <T>(port: Token<T>) => BindingTarget<T>;
+    readonly rebind: <T>(port: Token<T>) => BindingTarget<T>;
+    readonly command: <C extends Command<unknown>>(type: MessageType<C>) => ProtectedUseCaseTarget<C>;
+    readonly query: <Q extends Query<unknown>>(type: MessageType<Q>) => ProtectedUseCaseTarget<Q>;
+    readonly on: <Payload>(contract: EventContract<Payload>, options: ConsumerOptions) => HandlerTarget<IntegrationEventHandler<Payload>>;
+    readonly job: (name: string, settings: ScheduledOptions) => HandlerTarget<ScheduledJob>;
+    readonly include: (declared: DeclaredSource) => void;
+    readonly around: ModuleBuilder['around'];
+    assertNothingLeftUnfinished(): void;
+    private bindingTarget;
+    private begin;
+    private bindingOf;
+    private useCase;
+    private handlerTarget;
+}
+//# sourceMappingURL=module-recorder.d.ts.map

package/dist/module/module-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-recorder.d.ts","sourceRoot":"","sources":["../../src/module/module-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAIP,WAAW,EACX,KAAK,EACL,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAE5B,KAAK,gBAAgB,EACrB,KAAK,KAAK,EACX,MAAM,iCAAiC,CAAC;AAIzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAQrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAW7E,0GAA0G;AAC1G,qBAAa,cAAe,YAAW,aAAa;IAIhD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,YACmB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EACjC;IAGJ,QAAQ,CAAC,IAAI,GAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAG,aAAa,CAAC,CAAC,CAAC,CAAqC;IAE1F,QAAQ,CAAC,MAAM,GAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAG,aAAa,CAAC,CAAC,CAAC,CAAuC;IAE9F,QAAQ,CAAC,OAAO,GAAI,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,QAAQ,WAAW,CAAC,CAAC,CAAC,KAAG,sBAAsB,CAAC,CAAC,CAAC,CAChE;IAEhC,QAAQ,CAAC,KAAK,GAAI,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,QAAQ,WAAW,CAAC,CAAC,CAAC,KAAG,sBAAsB,CAAC,CAAC,CAAC,CAC9D;IAE9B,QAAQ,CAAC,EAAE,GAAI,OAAO,YACV,aAAa,CAAC,OAAO,CAAC,WACvB,eAAe,KACvB,aAAa,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAQ7C;IAEL,QAAQ,CAAC,GAAG,SAAU,MAAM,YAAY,gBAAgB,KAAG,aAAa,CAAC,YAAY,CAAC,CAQjF;IAEL,QAAQ,CAAC,OAAO,aAAc,cAAc,KAAG,IAAI,CAEjD;IAEF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAEtC;IAEF,2BAA2B,IAAI,IAAI,CAMlC;IAED,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,aAAa;CAmBtB"}

package/dist/module/module-recorder.js

@@ -0,0 +1,133 @@
+import { describeToken, } from '@ddd-ts-kit/kernel/declarations';
+import { declaredRequirement } from '../authorization/declared-requirement.js';
+import { protectedRequirement } from '../authorization/protected-requirement.js';
+import { PUBLIC_REQUIREMENT } from '../authorization/requirement.js';
+import { consumptionOf } from '../declared/consumption-of.js';
+import { includeDeclared } from '../declared/include-declared.js';
+import { WiringError } from '../errors/wiring-error.js';
+import { writtenJob } from '../jobs/written-job.js';
+import { assertPort } from '../wiring/assert-port.js';
+import { naturalKind } from '../wiring/natural-kind.js';
+import { classRecipe, factoryRecipe, valueRecipe } from '../wiring/recipe.js';
+import { bindingOptionsOf } from './binding-options-of.js';
+import { integrationEventHandlerOf, jobOf, messageHandlerOf } from './factory-made-handlers.js';
+/** The builder a module registers on: every statement goes to the draft, under the name of the module. */
+export class ModuleRecorder {
+    module;
+    draft;
+    unfinished = new Set();
+    constructor(module, draft) {
+        this.module = module;
+        this.draft = draft;
+    }
+    // The builder methods are arrow properties: a `register` function may destructure them.
+    bind = (port) => this.bindingTarget('bind', port);
+    rebind = (port) => this.bindingTarget('rebind', port);
+    command = (type) => this.useCase('command', type);
+    query = (type) => this.useCase('query', type);
+    on = (contract, options) => this.handlerTarget({
+        statement: `on(${contract.type})`,
+        kind: 'consumer',
+        factoryMade: integrationEventHandlerOf(`on(${contract.type})`),
+        record: (handler) => {
+            this.draft.addConsumption(consumptionOf({ contract, options, handler, module: this.module }));
+        },
+    });
+    job = (name, settings) => this.handlerTarget({
+        statement: `job(${name})`,
+        kind: 'job',
+        factoryMade: jobOf(`job(${name})`),
+        record: (job) => {
+            this.draft.addJob(writtenJob(name, settings, { job, module: this.module }));
+        },
+    });
+    include = (declared) => {
+        includeDeclared({ draft: this.draft, module: this.module }, declared);
+    };
+    around = (kinds, aspect) => {
+        this.draft.addKindAspect({ kinds, aspect, module: this.module });
+    };
+    assertNothingLeftUnfinished() {
+        const [statement] = this.unfinished;
+        if (statement !== undefined) {
+            throw new WiringError('INCOMPLETE_BINDING', `Module "${this.module}" calls ${statement.description}.`);
+        }
+    }
+    bindingTarget(verb, port) {
+        const finish = this.begin(`${verb}(${describeToken(port)}) without toClass, toFactory or toValue`);
+        const add = (recipe) => {
+            finish();
+            const binding = this.bindingOf(port, recipe);
+            if (verb === 'bind') {
+                this.draft.addBinding(binding);
+            }
+            else {
+                this.draft.replaceBinding(binding);
+            }
+            return bindingOptionsOf(binding);
+        };
+        return {
+            toClass: (implementation, ...rest) => {
+                assertPort(port, implementation, this.module);
+                return add(classRecipe(implementation, rest[0]));
+            },
+            toFactory: (factory) => add(factoryRecipe(factory)),
+            toValue: (value) => add(valueRecipe(value)),
+        };
+    }
+    begin(statement) {
+        const unfinished = Symbol(statement);
+        this.unfinished.add(unfinished);
+        return () => void this.unfinished.delete(unfinished);
+    }
+    bindingOf(target, recipe) {
+        const kind = naturalKind(target);
+        return {
+            token: target,
+            module: this.module,
+            lifetime: 'singleton',
+            aspects: [],
+            ...recipe,
+            ...(kind === undefined ? {} : { kind }),
+        };
+    }
+    useCase(kind, message) {
+        let requirement = declaredRequirement(message);
+        const statement = `${kind}(${message.name})`;
+        const target = this.handlerTarget({
+            statement,
+            kind: 'use-case',
+            factoryMade: messageHandlerOf(statement),
+            record: (handler) => {
+                this.draft.addHandling({ kind, message, handler, module: this.module, requirement });
+            },
+        });
+        const declaring = (declared) => {
+            requirement = declared;
+            return target;
+        };
+        return {
+            ...target,
+            requires: (permission, options) => declaring(protectedRequirement(message, permission, options)),
+            public: () => declaring(PUBLIC_REQUIREMENT),
+        };
+    }
+    handlerTarget(declaration) {
+        const { statement, kind, factoryMade } = declaration;
+        const finish = this.begin(`${statement} without handledBy or handledByFactory`);
+        const add = (handler, recipe) => {
+            finish();
+            declaration.record(handler);
+            this.draft.addBinding({ ...this.bindingOf(handler, recipe), kind });
+        };
+        return {
+            handledBy: (implementation, ...rest) => {
+                add(implementation, classRecipe(implementation, rest[0]));
+            },
+            handledByFactory: (factory) => {
+                add(factoryMade, factoryRecipe(factory));
+            },
+        };
+    }
+}
+//# sourceMappingURL=module-recorder.js.map

package/dist/module/module-recorder.js.map

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

package/dist/module/protected-use-case-target.d.ts

@@ -0,0 +1,14 @@
+import type { Message } from '@ddd-ts-kit/kernel';
+import type { MessageHandler, PermissionRef } from '@ddd-ts-kit/kernel/declarations';
+import type { RequirementOptions } from '../authorization/requirement-options.js';
+import type { HandlerTarget } from './handler-target.js';
+import type { UseCaseTarget } from './use-case-target.js';
+/**
+ * Offered only for a message that carries its actor (`AuthorizedCommand`, `AuthorizedQuery`,
+ * or any message declaring `readonly actor: Actor`): a right is always somebody's.
+ */
+export interface ProtectedUseCaseTarget<M extends Message> extends UseCaseTarget<M> {
+    /** Only an actor holding the permission reaches the handler. */
+    requires(permission: PermissionRef, options?: RequirementOptions<M>): HandlerTarget<MessageHandler<M>>;
+}
+//# sourceMappingURL=protected-use-case-target.d.ts.map

package/dist/module/protected-use-case-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protected-use-case-target.d.ts","sourceRoot":"","sources":["../../src/module/protected-use-case-target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,OAAO,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IACjF,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;CACxG"}

package/dist/module/protected-use-case-target.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protected-use-case-target.js.map

package/dist/module/protected-use-case-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protected-use-case-target.js","sourceRoot":"","sources":["../../src/module/protected-use-case-target.ts"],"names":[],"mappings":""}

package/dist/module/use-case-target.d.ts

@@ -0,0 +1,8 @@
+import type { Message } from '@ddd-ts-kit/kernel';
+import type { MessageHandler } from '@ddd-ts-kit/kernel/declarations';
+import type { HandlerTarget } from './handler-target.js';
+export interface UseCaseTarget<M extends Message> extends HandlerTarget<MessageHandler<M>> {
+    /** Anybody reaches the handler, the anonymous caller included. Said, never implied. */
+    public(): HandlerTarget<MessageHandler<M>>;
+}
+//# sourceMappingURL=use-case-target.d.ts.map

package/dist/module/use-case-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case-target.d.ts","sourceRoot":"","sources":["../../src/module/use-case-target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,OAAO,CAAE,SAAQ,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACxF,uFAAuF;IACvF,MAAM,IAAI,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5C"}

package/dist/module/use-case-target.js

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

package/dist/module/use-case-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case-target.js","sourceRoot":"","sources":["../../src/module/use-case-target.ts"],"names":[],"mappings":""}

package/dist/module/value-binding-options.d.ts

@@ -0,0 +1,13 @@
+import type { DependencyKind } from '@ddd-ts-kit/kernel';
+import type { BindingAspect } from '@ddd-ts-kit/kernel/declarations';
+export interface ValueBindingOptions {
+    /** Role passed to the `decorate` hook of the application. */
+    as(kind: DependencyKind): this;
+    /**
+     * Wraps every instance of this binding, the first aspect outermost:
+     * `.with(retry(...), timeout(2000))` bounds each attempt. The `decorate` hook of the
+     * application comes around them. A value that is not an object is left alone.
+     */
+    with(...aspects: readonly BindingAspect[]): this;
+}
+//# sourceMappingURL=value-binding-options.d.ts.map

package/dist/module/value-binding-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-binding-options.d.ts","sourceRoot":"","sources":["../../src/module/value-binding-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAE/B;;;;OAIG;IACH,IAAI,CAAC,GAAG,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAAC;CAClD"}

package/dist/module/value-binding-options.js

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

package/dist/module/value-binding-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-binding-options.js","sourceRoot":"","sources":["../../src/module/value-binding-options.ts"],"names":[],"mappings":""}

package/dist/testing/create-test-application.d.ts

@@ -0,0 +1,12 @@
+import type { TestApplicationOptions } from './test-application-options.js';
+import type { TestApplication } from './test-application.js';
+/**
+ * The modules on a deterministic, in-memory kernel (frozen clock, sequential identifiers,
+ * in-process buses, idempotent consumers), with the fakes in place of the adapters. A repository,
+ * the adapter of a module or the fake given for its port, dispatches domain events with its save
+ * to `domainEvents`, as it does in the application, whether `kernelModule()` is listed or not. Consumers
+ * declared with `builder.on(...)` receive events once `start()` was awaited. Every use case is
+ * allowed unless a listed module binds the use case guard, as an authorization module does.
+ */
+export declare function createTestApplication(options: TestApplicationOptions): TestApplication;
+//# sourceMappingURL=create-test-application.d.ts.map

package/dist/testing/create-test-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-test-application.d.ts","sourceRoot":"","sources":["../../src/testing/create-test-application.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAkBtF"}

package/dist/testing/create-test-application.js

@@ -0,0 +1,89 @@
+import { ActorContext, Cache, Clock, CommandBus, DomainEventDispatcher, ErrorReporter, EventBus, EventSubscribers, ExecutionScope, IdGenerator, InMemoryProcessedEventStore, InMemoryUnitOfWork, IntegrationEventPublisher, IntegrationEventSubscriber, JobScheduler, Lock, Logger, Metrics, ProcessedEventStore, QueryBus, RateLimiter, UnitOfWork, dispatchingOnSave, } from '@ddd-ts-kit/kernel';
+import { describeToken } from '@ddd-ts-kit/kernel/declarations';
+import { assemble } from '../application/assemble.js';
+import { override } from '../application/override.js';
+import { passEveryMessage } from '../authorization/pass-every-message.js';
+import { UseCaseGuard } from '../authorization/use-case-guard.js';
+import { WiringError } from '../errors/wiring-error.js';
+import { KERNEL_PORTS } from '../kernel/kernel-ports.js';
+import { collectWiring } from '../module/collect-wiring.js';
+import { TokenSet } from '../token/token-set.js';
+import { naturalKind } from '../wiring/natural-kind.js';
+import { createTestKernel } from './create-test-kernel.js';
+import { testApplicationOf } from './test-application-of.js';
+/**
+ * The modules on a deterministic, in-memory kernel (frozen clock, sequential identifiers,
+ * in-process buses, idempotent consumers), with the fakes in place of the adapters. A repository,
+ * the adapter of a module or the fake given for its port, dispatches domain events with its save
+ * to `domainEvents`, as it does in the application, whether `kernelModule()` is listed or not. Consumers
+ * declared with `builder.on(...)` receive events once `start()` was awaited. Every use case is
+ * allowed unless a listed module binds the use case guard, as an authorization module does.
+ */
+export function createTestApplication(options) {
+    const declared = collectWiring(options.modules);
+    const fakes = options.fakes ?? [];
+    assertFakesAreUsed(declared, fakes);
+    const kernel = createTestKernel(options, (target) => application.resolve(target));
+    const dispatching = (repository) => dispatchingOnSave(repository, () => kernel.domainEvents);
+    const wiring = { ...declared, kindAspects: [...declared.kindAspects, repositoriesAround(dispatching)] };
+    const application = assemble(wiring, {
+        modules: options.modules,
+        overrides: [...kernelOverrides(kernel), ...guardOverride(wiring), ...fakes.map(savingFake(wiring, dispatching))],
+        ...(options.authorization === undefined ? {} : { authorization: options.authorization }),
+        jobs: { start: false, ...(options.jobs === undefined ? {} : { settings: options.jobs }) },
+    });
+    return testApplicationOf(application, kernel);
+}
+function assertFakesAreUsed(wiring, fakes) {
+    const used = new TokenSet([
+        ...KERNEL_PORTS,
+        ...wiring.bindings.keys(),
+        ...wiring.bindings.values().flatMap((binding) => binding.dependencies),
+    ]);
+    for (const [target] of fakes) {
+        if (used.has(target)) {
+            continue;
+        }
+        throw new WiringError('UNKNOWN_FAKE', `A fake is given for "${describeToken(target)}", which no module binds and no class depends on. Check that it is the port the module uses; a port resolved only inside a factory is replaced with overrideForTests.`);
+    }
+}
+/** Wrapping twice is a no-op, so a listed `kernelModule()` changes nothing. */
+function repositoriesAround(dispatching) {
+    return { kinds: ['repository'], module: 'test', aspect: () => dispatching };
+}
+/** A fake stands for an adapter: the one of a repository port dispatches as the adapter would. */
+function savingFake(wiring, dispatching) {
+    return ([target, value]) => {
+        const kind = wiring.bindings.get(target)?.kind ?? naturalKind(target);
+        const repository = kind === 'repository' && typeof value === 'object' && value !== null;
+        return repository ? [target, dispatching(value)] : [target, value];
+    };
+}
+function kernelOverrides(kernel) {
+    return [
+        override(Clock, kernel.clock),
+        override(IdGenerator, kernel.ids),
+        override(UnitOfWork, new InMemoryUnitOfWork()),
+        override(CommandBus, kernel.commandBus),
+        override(QueryBus, kernel.queryBus),
+        override(EventBus, kernel.eventBus),
+        override(IntegrationEventPublisher, kernel.eventBus),
+        override(IntegrationEventSubscriber, kernel.eventBus),
+        override(EventSubscribers, { forContext: () => kernel.eventBus }),
+        override(ProcessedEventStore, new InMemoryProcessedEventStore()),
+        override(DomainEventDispatcher, kernel.domainEvents),
+        override(ActorContext, kernel.actorContext),
+        override(ExecutionScope, kernel.executionScope),
+        override(Logger, kernel.logger),
+        override(Metrics, kernel.metrics),
+        override(ErrorReporter, kernel.errors),
+        override(Cache, kernel.cache),
+        override(Lock, kernel.lock),
+        override(RateLimiter, kernel.rateLimiter),
+        override(JobScheduler, kernel.jobs.scheduler),
+    ];
+}
+function guardOverride(wiring) {
+    return wiring.bindings.has(UseCaseGuard) ? [] : [override(UseCaseGuard, passEveryMessage)];
+}
+//# sourceMappingURL=create-test-application.js.map

package/dist/testing/create-test-application.js.map

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

package/dist/testing/create-test-kernel.d.ts

@@ -0,0 +1,6 @@
+import type { Resolve } from '../wiring/resolve.js';
+import type { TestApplicationOptions } from './test-application-options.js';
+import type { TestKernel } from './test-kernel.js';
+/** The deterministic stand-ins of the kernel ports, which a spec reads and moves. */
+export declare function createTestKernel(options: TestApplicationOptions, resolve: Resolve): TestKernel;
+//# sourceMappingURL=create-test-kernel.d.ts.map

package/dist/testing/create-test-kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-test-kernel.d.ts","sourceRoot":"","sources":["../../src/testing/create-test-kernel.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CA+B9F"}

package/dist/testing/create-test-kernel.js

@@ -0,0 +1,65 @@
+import { FixedActorContext, FixedClock, FixedExecutionScope, InMemoryCache, InMemoryDomainEventDispatcher, reportAfterCommitFailures, InMemoryErrorReporter, InMemoryEventBus, InMemoryLock, InMemoryLogger, InMemoryMetrics, InMemoryRateLimiter, SequentialIdGenerator, executionContext, } from '@ddd-ts-kit/kernel';
+import { reportFailedRuns } from '@ddd-ts-kit/scheduling';
+import { ManualJobScheduler } from '@ddd-ts-kit/scheduling/testing';
+import { guardedQueryBus } from '../kernel/guarded-query-bus.js';
+import { transactionalCommandBus } from '../kernel/transactional-command-bus.js';
+const DEFAULT_NOW = new Date('2026-01-01T00:00:00.000Z');
+const DEFAULT_ACTOR = { id: 'test-user', type: 'user', roles: [], attributes: {} };
+/** The deterministic stand-ins of the kernel ports, which a spec reads and moves. */
+export function createTestKernel(options, resolve) {
+    const clock = new FixedClock(options.now ?? DEFAULT_NOW);
+    const context = options.executionContext ?? defaultExecutionContext(options);
+    const actorContext = new FixedActorContext(context.actor);
+    const executionScope = new FixedExecutionScope(context, actorContext);
+    const observability = { logger: new InMemoryLogger(), metrics: new InMemoryMetrics(), lock: new InMemoryLock(clock) };
+    const errors = new InMemoryErrorReporter();
+    const afterCommitFailed = reportAfterCommitFailures({
+        reporter: errors,
+        logger: observability.logger,
+        scope: executionScope,
+    });
+    const scheduler = manualScheduler({ clock, scope: executionScope, ...observability }, errors);
+    return {
+        commandBus: transactionalCommandBus(resolve),
+        queryBus: guardedQueryBus(resolve),
+        eventBus: new InMemoryEventBus(),
+        domainEvents: new InMemoryDomainEventDispatcher(afterCommitFailed),
+        clock,
+        ids: new SequentialIdGenerator(options.idPrefix),
+        actorContext,
+        executionScope,
+        ...observability,
+        errors,
+        cache: new InMemoryCache(clock),
+        rateLimiter: new InMemoryRateLimiter(clock),
+        jobs: testJobs(scheduler),
+    };
+}
+function defaultExecutionContext({ session, actor }) {
+    return executionContext({
+        correlationId: 'test-correlation',
+        actor: session?.actor ?? actor ?? DEFAULT_ACTOR,
+        origin: 'test',
+        ...(session === undefined ? {} : { session }),
+    });
+}
+function manualScheduler(parts, errors) {
+    return new ManualJobScheduler({
+        ...parts,
+        ids: new SequentialIdGenerator('job-run'),
+        onRun: reportFailedRuns(errors),
+    });
+}
+function testJobs(scheduler) {
+    return {
+        scheduler,
+        async runNow(name) {
+            const run = await scheduler.runNow(name);
+            if (run.outcome === 'failed') {
+                throw scheduler.failures.at(-1);
+            }
+            return run;
+        },
+    };
+}
+//# sourceMappingURL=create-test-kernel.js.map

package/dist/testing/create-test-kernel.js.map

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

package/dist/testing/fake.d.ts

@@ -0,0 +1,5 @@
+import type { Token } from '@ddd-ts-kit/kernel/declarations';
+import { type Override } from '../application/override.js';
+/** A type-checked fake for `createTestApplication({ fakes })`: `fake(OrderRepository, new InMemoryOrderRepository())`. */
+export declare function fake<T>(target: Token<T>, value: T): Override;
+//# sourceMappingURL=fake.d.ts.map

package/dist/testing/fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../../src/testing/fake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAErE,0HAA0H;AAC1H,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAE5D"}

package/dist/testing/fake.js

@@ -0,0 +1,6 @@
+import { override } from '../application/override.js';
+/** A type-checked fake for `createTestApplication({ fakes })`: `fake(OrderRepository, new InMemoryOrderRepository())`. */
+export function fake(target, value) {
+    return override(target, value);
+}
+//# sourceMappingURL=fake.js.map

package/dist/testing/fake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.js","sourceRoot":"","sources":["../../src/testing/fake.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAiB,MAAM,4BAA4B,CAAC;AAErE,0HAA0H;AAC1H,MAAM,UAAU,IAAI,CAAI,MAAgB,EAAE,KAAQ;IAChD,OAAO,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/dist/testing/test-application-of.d.ts

@@ -0,0 +1,10 @@
+import type { Application } from '../application/application.js';
+import type { TestApplication } from './test-application.js';
+import type { TestKernel } from './test-kernel.js';
+/**
+ * The test application as an object of its own, in front of the application: it calls the
+ * application and names each member of the test kernel. Nothing is written on the application,
+ * so no member of the kernel can replace one of its fields, whatever their names.
+ */
+export declare function testApplicationOf(application: Application, kernel: TestKernel): TestApplication;
+//# sourceMappingURL=test-application-of.d.ts.map

package/dist/testing/test-application-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-application-of.d.ts","sourceRoot":"","sources":["../../src/testing/test-application-of.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,eAAe,CAe/F"}