@ddd-ts-kit/kernel 0.1.1 → 0.3.0

package/README.md

@@ -12,7 +12,7 @@ npm i @ddd-ts-kit/kernel
 
 | Area | Exports |
 |---|---|
-| Domain | `Entity`, `AggregateRoot` (version, recorded events), `ValueObject`, `DomainEvent`, `DomainError` with a stable `code` (`InvariantViolation`, `NotFoundError`, `ConflictError`, `ConcurrencyError`), `Result` with `ok`, `err`, `unwrap` |
+| Domain | `Entity`, `AggregateRoot` (version, recorded events), `ValueObject`, `DomainEvent`, `DomainError` with a stable `code`, `ConceptError` (the errors of one concept, each built by a static factory: see "Domain errors"), `isRefusal`, `CodeOf`, `RefusalOf`, `Refusal`, `RefusalFacts`, the generic `InvariantViolation`, `NotFoundError`, `ConflictError`, `ConcurrencyError`, `Result` with `ok`, `err`, `unwrap` |
 | Ports | `Clock`, `IdGenerator`, `UnitOfWork`, `Repository` (abstract classes: each one is its own injection token), `UseCase`, `DependencyKind` (the roles a binding declares, read by di, tracing and aspects: `repository`, `gateway`, `external`, `use-case`, `publisher`, `consumer`, `domain-event-handler`, `job`) |
 | Buses | `Command`, `Query`, `CommandBus`, `QueryBus`, `BusMiddleware`, the in-process `InMemoryCommandBus` and `InMemoryQueryBus` (`register(type, handler, { context })` names the bounded context in `MessageInfo`), `unitOfWorkMiddleware` |
 | Events | `IntegrationEvent`, `IntegrationEventPublisher`, `IntegrationEventSubscriber`, `EventBus` (both at once), `EventSubscribers` (the subscriber of each bounded context), `ProcessedEventStore`, `idempotent`, `InMemoryEventBus`, `DomainEventDispatcher`, `IntegrationEventCallback` and `DomainEventCallback` (the functions a subscriber and a dispatcher are given), `executionContextOfEvent`, `inEventScope`, `scopedPublisher`, `EventDelivery` (what a provider says of one delivery: attempt, last attempt, transport, source, consumer), `messagingSystemOf` |
@@ -24,10 +24,97 @@ npm i @ddd-ts-kit/kernel
 | Persistence helpers | `optimisticUpdate`, `schemaNameOf`, `stampCreation`, `stampUpdate`, `tenantScopeOf`, `encodeCursor`, `decodeCursor` |
 | Error reporting | `ErrorReporter`, `ErrorReport`, `errorReportOf`, `reportOnce`, `isUnexpectedError`, `errorReportingMiddleware`, `DeadLetterReports`, `reportProcessFailures`, `NoopErrorReporter` |
 | Doubles | `FixedClock`, `SequentialIdGenerator`, `InMemoryUnitOfWork`, `FixedActorContext`, `FixedExecutionScope`, `InMemoryLogger`, `InMemoryMetrics`, `InMemoryErrorReporter`, `InMemoryCache`, `InMemoryLock`, `InMemoryRateLimiter` |
-| Declarations (`@ddd-ts-kit/kernel/declarations`) | `Requires`, `Public`, `CommandHandler`, `QueryHandler`, `IntegrationEventHandler`, `DomainEventHandler`, `Scheduled`, `Projection`, `On`, `Repository`, `Gateway`, `Adapter`, `Policy`, `declarationOf`, `listDeclarations`, `Token`, `describeToken`, `tokenIdentity`, `portDefect` |
+| Declarations (`@ddd-ts-kit/kernel/declarations`) | `Requires`, `Public`, `CommandHandler`, `QueryHandler`, `IntegrationEventHandler`, `DomainEventHandler`, `Scheduled`, `Projection`, `On`, `Repository`, `Gateway`, `Adapter`, `Policy`, `injected`, `injectedDependencies`, `declarationOf`, `listDeclarations`, `Token`, `describeToken`, `tokenIdentity`, `portDefect` |
 
 The rules these blocks serve are in `docs/ARCHITECTURE.md`.
 
+## Domain errors
+
+A business refusal is a `DomainError`: an answer the code planned for, known everywhere by its
+`code`. A context has one error class per concept of its language, and each refusal is a static
+factory of that class, named in the words of the business:
+
+```ts
+import { ConceptError } from '@ddd-ts-kit/kernel';
+
+export class AppointmentError extends ConceptError {
+  static slotTaken(calendarId: string, startsAt: Date) {
+    return AppointmentError.refusal(
+      'SLOT_TAKEN',
+      `The slot starting at ${startsAt.toISOString()} on calendar ${calendarId} is already held.`,
+      { calendarId, startsAt },
+    ).exposing('startsAt');
+  }
+
+  static notFound(appointmentId: string) {
+    return AppointmentError.refusal('APPOINTMENT_NOT_FOUND', `Appointment ${appointmentId} does not exist.`, {
+      appointmentId,
+    });
+  }
+}
+
+throw AppointmentError.slotTaken(calendar.id, slot.startsAt);
+```
+
+| Member | What it does |
+|---|---|
+| `protected static refusal(code, message, facts?)` | builds the refusal of a factory: an instance of the class it is called on, typed with that code and those facts. The constructor is protected and a subclass declares none, so outside its class a refusal exists only through a factory |
+| `protected exposing(...names)` | called on the refusal by its factory: these facts may leave the process. None does by default |
+| `protected causedBy(cause)` | called by its factory: the error this refusal translates, as `cause` |
+| `code`, `message`, `name`, `cause` | as on any `DomainError`; `name` is the class, `code` the identity of the refusal |
+| `facts` | every fact the factory was given, as plain data (`RefusalFacts`: text, numbers, booleans, dates, `null`, lists of them), for the code that catches the error and for the tests |
+| `exposedFacts` | the facts a client may read: what `@ddd-ts-kit/http` writes under `facts` in the problem document |
+| `toJSON()` | `{ name, code, message }`, plus `facts` when some are exposed: never the stack, the cause or a private fact |
+| `static is(error, code?)` | narrows what was caught to a refusal of this class, of this code when one is given |
+
+The codes of a class are a closed vocabulary the compiler derives from its factories, so a
+`switch` is exhaustive and each case knows its facts:
+
+```ts
+import { isRefusal, type CodeOf } from '@ddd-ts-kit/kernel';
+
+type AppointmentErrorCode = CodeOf<typeof AppointmentError>; // 'SLOT_TAKEN' | 'APPOINTMENT_NOT_FOUND'
+
+if (AppointmentError.is(error)) {
+  switch (error.code) {
+    case 'SLOT_TAKEN':
+      return retryAfter(error.facts.startsAt); // a Date
+    case 'APPOINTMENT_NOT_FOUND':
+      return forget(error.facts.appointmentId);
+  }
+}
+
+if (AppointmentError.is(error, 'SLOT_TAKEN')) {
+  error.facts.calendarId; // a string
+}
+
+isRefusal(error, 'SLOT_TAKEN'); // whatever the class: the code is what everything downstream keys on
+```
+
+`error instanceof AppointmentError && error.code === 'SLOT_TAKEN'` works too, without the facts
+of that code. A factory lets its return type be inferred: an annotation `: AppointmentError`
+would hide its code from `CodeOf`.
+
+**Facts are private.** A message is written for a human and answered to the client as `detail`;
+the facts are data, and stay in the process unless the factory names the ones that may leave.
+Never expose what identifies a person. The audit trail and the spans record the code alone.
+
+**One class per error** is the form of 0.1 and 0.2, and keeps working: `DomainError` is still
+abstract over `code`, its constructor still public, and `InvariantViolation`, `NotFoundError`,
+`ConflictError` and `ConcurrencyError`, each one refusal under a fixed code, are still built
+with `new`.
+
+```ts
+export class SlotTakenError extends DomainError {
+  readonly code = 'SLOT_TAKEN';
+}
+```
+
+A project says which form it writes with `"stack.refusals"` in `ddd-ts-kit.config.json`
+(`factories`, what `init` writes, or `classes`, what a config without the key means); the
+`errors/*` rules hold the first, and `ddd-ts-kit error-factories` moves a project from the
+second. Both forms can live in one project.
+
 ## Domain events and the unit of work
 
 An effect of a domain event exists only if the state change that recorded it is committed.
@@ -72,7 +159,7 @@ a repository adapter never call it. An aggregate is recognised by what it does (
 | `after-commit` | `dispatcher.on(name, callback, { phase: 'after-commit' })` | once the transaction has committed, never when it rolled back, in dispatch order, awaited before the command answers | never fails the command: reported, and the other handlers still run |
 
 With declarations the phase is an option of the decorator:
-`@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid', phase: 'after-commit' }, [Cache])`.
+`@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid', phase: 'after-commit' })`.
 
 The `after-commit` phase is at most once: a crash between the commit and the run loses it. What
 must not be lost goes through the outbox as an integration event. A `before-commit` handler
@@ -131,7 +218,7 @@ declarations into bindings is the job of `@ddd-ts-kit/di` (`contextModule`,
 ```ts
 // contexts/ordering/domain/repositories/order.repository.ts
 import { Repository } from '@ddd-ts-kit/kernel';
-import type { Order } from '@/contexts/ordering/domain/aggregates/order.aggregate.js';
+import type { Order } from '@/contexts/ordering/domain/aggregates/order.aggregate';
 
 export abstract class OrderRepository extends Repository<Order> {
   abstract findOpenOf(customerId: string): Promise<readonly Order[]>;
@@ -142,10 +229,10 @@ export abstract class OrderRepository extends Repository<Order> {
 // contexts/ordering/application/commands/place-order/place-order.handler.ts
 import { Clock } from '@ddd-ts-kit/kernel';
 import { CommandHandler } from '@ddd-ts-kit/kernel/declarations';
-import { OrderRepository } from '@/contexts/ordering/domain/repositories/order.repository.js';
-import { PlaceOrder } from '@/contexts/ordering/application/commands/place-order/place-order.command.js';
+import { OrderRepository } from '@/contexts/ordering/domain/repositories/order.repository';
+import { PlaceOrder } from '@/contexts/ordering/application/commands/place-order/place-order.command';
 
-@CommandHandler(PlaceOrder, [OrderRepository, Clock])
+@CommandHandler(PlaceOrder)
 export class PlaceOrderHandler implements CommandHandler<PlaceOrder> {
   constructor(
     private readonly orders: OrderRepository,
@@ -160,10 +247,10 @@ export class PlaceOrderHandler implements CommandHandler<PlaceOrder> {
 // contexts/ordering/infrastructure/persistence/knex-order.repository.ts
 import { Clock, ExecutionScope } from '@ddd-ts-kit/kernel';
 import { Repository } from '@ddd-ts-kit/kernel/declarations';
-import { Database } from '@/contexts/ordering/application/ports/database.port.js';
-import { OrderRepository } from '@/contexts/ordering/domain/repositories/order.repository.js';
+import { Database } from '@/contexts/ordering/application/ports/database.port';
+import { OrderRepository } from '@/contexts/ordering/domain/repositories/order.repository';
 
-@Repository(OrderRepository, [Database, ExecutionScope, Clock])
+@Repository(OrderRepository)
 export class KnexOrderRepository implements OrderRepository {
   constructor(
     private readonly database: Database,
@@ -182,7 +269,7 @@ imported by the adapter). No file needs both.
 ### Ports and tokens
 
 **A port is an abstract class, and the class is the injection token.** The class names the
-dependency and carries its type: a dependency list is checked against a constructor, and
+dependency and carries its type: a constructor parameter typed by it names what is injected, and
 `app.resolve(Clock)` answers a `Clock`. `Token<T>` is that type: `abstract new (...args: never) => T`.
 There is no token constant and no token file. A port has one place, one abstract class per file:
 
@@ -270,14 +357,47 @@ export abstract class BusinessClock extends Clock {
 }
 ```
 
+**What a class depends on is said by its constructor.** A decorator lists nothing: each
+constructor parameter is typed by one class, its token, and `ddd-ts-kit docs` reads the
+signatures from the sources into the generated file of the context, which registers them with
+`injected`:
+
+```ts
+@CommandHandler(PlaceOrder)
+export class PlaceOrderHandler implements CommandHandler<PlaceOrder> {
+  constructor(
+    private readonly orders: OrderRepository,
+    private readonly clock: Clock,
+  ) {}
+}
+
+// contexts/ordering/ordering.declarations.ts, generated
+injected(PlaceOrderHandler, [OrderRepository, Clock]);
+```
+
+`injected(Class, [Tokens])` records one token per constructor parameter, in order, in a
+registry shared by every copy of the kernel a process loads; `injectedDependencies(Class)`
+reads it back, and a container (`@ddd-ts-kit/di`) is what uses it. Nothing here reads
+`design:paramtypes`: that metadata exists only with legacy decorators compiled by `tsc` or
+swc, not with standard decorators nor under `tsx` or esbuild. A decorator still accepts a list
+as its last argument, `@CommandHandler(PlaceOrder, [OrderRepository, Clock])`: the form 0.1
+projects wrote. A declaration then carries it in `dependencies`, which is `undefined` when
+the constructor is the statement, and a container gives it precedence.
+
 **What the compiler refuses**, in both decorator modes:
 
-- a dependency list that does not name one port per constructor parameter, each of the type of
-  its parameter, in order: a missing list, a missing or extra entry, a wrong type, a wrong order;
+- a list, of `injected` or of a decorator, that does not name one port per constructor
+  parameter, each of the type of its parameter, in order: a missing or extra entry, a wrong
+  type, a wrong order; `injected(Class)` without a list for a constructor that takes something;
 - a class that does not implement the port it is declared the adapter of, and an abstract class;
 - a concrete class named where its port is expected: `[InMemoryOrderRepository, Clock]` for a
   parameter typed `OrderRepository`. A list names ports, never what implements them.
 
+What changed with the list becoming optional: a decorator without a list accepts any
+constructor, so the compiler no longer tells, at the decorator, a class whose list was
+forgotten. It does not have to: the list is derived from the constructor, checked where it is
+generated, and a class left without one is refused by name when the application is composed.
+
 **What is refused when the file loads**, with a `DeclarationError` from `@Repository`,
 `@Gateway` and `@Adapter`, because the compiler cannot see it:
 
@@ -296,16 +416,16 @@ left alone.
 |---|---|---|
 | `Requires(permission, options?)` | a command or query that carries its actor | `@Requires(permissions['visit.schedule'], { resource: (c: ScheduleVisit) => ({ type: 'patient', id: c.patientId }), audited: ['startsAt'] })` |
 | `Public(options?)` | a command or query anybody may send | `@Public()` |
-| `CommandHandler(Message, [ports])` | the one handler of a command | `@CommandHandler(PlaceOrder, [OrderRepository, Clock])` |
-| `QueryHandler(Message, [ports])` | the one handler of a query | `@QueryHandler(GetOrder, [OrderReadModel])` |
-| `IntegrationEventHandler(definition, { consumer, actorOf? }, [ports])` | the handler of an integration event of another context | `@IntegrationEventHandler(OrderPlaced, { consumer: 'billing.invoice-on-order-placed' }, [CommandBus])` |
-| `DomainEventHandler(Event, { name }, [ports])` | a handler of a domain event of its own context | `@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid' }, [CommandBus])` |
-| `Scheduled(name, schedule and options, [ports])` | a job run by time, which triggers use cases | `@Scheduled('billing.send-reminders', { cron: '0 7 * * 1-5', timeZone: 'Europe/Paris' }, [CommandBus])` |
-| `Projection(name, [ports])` with `On(definition)` on its methods | a projector: the class that keeps one read model up to date | `@Projection('scheduling.appointment-list', [AppointmentList])`, `@On(PaymentCaptured)` |
-| `Repository(Port, options?, [ports])` | the adapter of a repository of the domain | `@Repository(OrderRepository, [Database, ExecutionScope, Clock])` |
-| `Gateway(Port, options?, [ports])` | the adapter of a port that calls another context | `@Gateway(StockGateway, [HttpClient])` |
-| `Adapter(Port, options?, [ports])` | the adapter of any other port | `@Adapter(PaymentGateway, { kind: 'external' }, [PaymentSettings])` |
-| `Policy(permission, { name }, [ports])` | a rule that needs the loaded element | `@Policy(permissions['invoice.void'], { name: 'billing.only-issuer-voids' })` |
+| `CommandHandler(Message)` | the one handler of a command | `@CommandHandler(PlaceOrder)` |
+| `QueryHandler(Message)` | the one handler of a query | `@QueryHandler(GetOrder)` |
+| `IntegrationEventHandler(definition, { consumer, actorOf? })` | the handler of an integration event of another context | `@IntegrationEventHandler(OrderPlaced, { consumer: 'billing.invoice-on-order-placed' })` |
+| `DomainEventHandler(Event, { name })` | a handler of a domain event of its own context | `@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid' })` |
+| `Scheduled(name, schedule and options)` | a job run by time, which triggers use cases | `@Scheduled('billing.send-reminders', { cron: '0 7 * * 1-5', timeZone: 'Europe/Paris' })` |
+| `Projection(name)` with `On(definition)` on its methods | a projector: the class that keeps one read model up to date | `@Projection('scheduling.appointment-list')`, `@On(PaymentCaptured)` |
+| `Repository(Port, options?)` | the adapter of a repository of the domain | `@Repository(OrderRepository)` |
+| `Gateway(Port, options?)` | the adapter of a port that calls another context | `@Gateway(StockGateway)` |
+| `Adapter(Port, options?)` | the adapter of any other port | `@Adapter(PaymentGateway, { kind: 'external' })` |
+| `Policy(permission, { name })` | a rule that needs the loaded element | `@Policy(permissions['invoice.void'], { name: 'billing.only-issuer-voids' })` |
 
 - **Access is said on the message.** A command extends `Command` or `AuthorizedCommand`, a
   query `Query` or `AuthorizedQuery`: the base class already says which of the two it is, so
@@ -365,7 +485,7 @@ the integration event handlers of a context on `EventSubscribers.forContext(<con
 
 ```ts
 // contexts/billing/application/scheduling/send-reminders.job.ts
-@Scheduled('billing.send-reminders', { cron: '0 7 * * 1-5', timeZone: 'Europe/Paris' }, [CommandBus])
+@Scheduled('billing.send-reminders', { cron: '0 7 * * 1-5', timeZone: 'Europe/Paris' })
 export class SendRemindersJob implements ScheduledJob {
   constructor(private readonly commands: CommandBus) {}
 
@@ -376,7 +496,7 @@ export class SendRemindersJob implements ScheduledJob {
 ```
 
 A job lives in `application/scheduling/`, in a `*.job.ts` file, and only triggers use cases:
-it receives buses and ports by its dependency list and typically sends one command. The second
+it receives buses and ports by its constructor and typically sends one command. The second
 argument is the schedule and, next to it, the options:
 
 | Key | Default | |
@@ -399,7 +519,9 @@ are in the README of `@ddd-ts-kit/scheduling`.
 ### Decorator modes
 
 Every decorator of this entry works under both decorator modes of TypeScript, and the same
-source line type-checks under both, checks of the role and of the dependency list included.
+source line type-checks under both, checks of the role and of a dependency list included.
+Neither needs `emitDecoratorMetadata`, and what a constructor takes is known in both the same
+way: read from the source, registered by `injected`.
 
 | Stack | `tsconfig.json` |
 |---|---|
@@ -910,7 +1032,7 @@ else: it sends no command and reads no other context.
 import { stampOf, type IntegrationEvent } from '@ddd-ts-kit/kernel';
 import { On, Projection } from '@ddd-ts-kit/kernel/declarations';
 
-@Projection('scheduling.appointment-list', [AppointmentList])
+@Projection('scheduling.appointment-list')
 export class AppointmentListProjection {
   constructor(private readonly appointments: AppointmentList) {}
 
@@ -933,8 +1055,8 @@ export class AppointmentListProjection {
 }
 ```
 
-`@Projection('<context>.<name>', [ports])` is a declaration like the others: both decorator
-modes, the dependency list checked by the compiler, one class per file, in
+`@Projection('<context>.<name>')` is a declaration like the others: both decorator
+modes, its dependencies stated by its constructor, one class per file, in
 `application/projections/`, in a `*.projection.ts` file. `@On(definition)` on a method says
 "this method applies that integration event"; `@On(EventClass, { name })` says it for a domain
 event of the projection's own context. A method that takes another event is refused by the
@@ -942,13 +1064,11 @@ compiler, a projection without any `@On` and an `@On` on a class without `@Proje
 when the file loads. A method answers what its store answered, which is how the application
 counts what was applied and what was stale.
 
-**Not known to the CLI yet.** The runtime packages hold projections; `ddd-ts-kit` has no
-generator for them and its canonical tree does not list `application/projections/`. In a
-project held by `ddd-ts-kit check`, the directory is refused by `tree/closed` until it is
-declared in `contexts.<name>.extraDirectories` with its decision record, and the generated
-barrel `<context>.declarations.ts` refuses a line for a `*.projection.ts` file
-(`declarations/barrel-current`): the projection is then registered by discovery or with
-`builder.include(...)`, see the README of `@ddd-ts-kit/di`.
+**A role of the CLI.** `application/projections/` is a directory of the canonical tree,
+`ddd-ts-kit generate projection <context> <Name> <event-type>` writes a projector with its
+spec, the generated barrel `<context>.declarations.ts` exports it and registers what its
+constructor takes, and `ddd-ts-kit describe` and the reference of `CONTEXT.md` list it with
+the events it applies.
 
 ### Idempotent and ordered by construction
 

package/dist/declarations/decorators/adapter.d.ts

@@ -1,5 +1,6 @@
 import type { ClassDeclarator } from '../dependencies/class-declarator.js';
-import type { Dependencies } from '../dependencies/dependencies.js';
+import type { DeclaredDependencies } from '../dependencies/declared-dependencies.js';
+import type { DependenciesFromSignature } from '../dependencies/dependencies-from-signature.js';
 import type { Token } from '../token/token.js';
 import type { PortOptions } from './port-options.js';
 export interface AdapterOptions extends PortOptions {
@@ -8,8 +9,8 @@ export interface AdapterOptions extends PortOptions {
 }
 /**
  * The adapter of any other port of the application layer:
- * `@Adapter(PaymentGateway, { kind: 'external' }, [PaymentSettings])`.
+ * `@Adapter(PaymentGateway, { kind: 'external' })`.
  */
-export declare function Adapter<T, const D extends Dependencies = readonly []>(port: Token<T>, dependencies?: D): ClassDeclarator<T, D>;
-export declare function Adapter<T, const D extends Dependencies = readonly []>(port: Token<T>, options: AdapterOptions, dependencies?: D): ClassDeclarator<T, D>;
+export declare function Adapter<T, const D extends DeclaredDependencies = DependenciesFromSignature>(port: Token<T>, dependencies?: D): ClassDeclarator<T, D>;
+export declare function Adapter<T, const D extends DeclaredDependencies = DependenciesFromSignature>(port: Token<T>, options: AdapterOptions, dependencies?: D): ClassDeclarator<T, D>;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/declarations/decorators/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,wFAAwF;IACxF,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,EAAE,EACnE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzB,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,EAAE,EACnE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,OAAO,EAAE,cAAc,EACvB,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAChG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,wFAAwF;IACxF,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,oBAAoB,GAAG,yBAAyB,EACzF,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzB,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,oBAAoB,GAAG,yBAAyB,EACzF,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,OAAO,EAAE,cAAc,EACvB,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/declarations/decorators/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/declarations/decorators/adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAuBtD,MAAM,UAAU,OAAO,CACrB,IAAc,EACd,GAAG,QAAqC;IAExC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;IACzB,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC;IAE7D,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,IAAI,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AACzF,CAAC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/declarations/decorators/adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAuBtD,MAAM,UAAU,OAAO,CACrB,IAAc,EACd,GAAG,QAAqC;IAExC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;IACzB,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC;IAE7D,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,IAAI,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AACzF,CAAC"}

package/dist/declarations/decorators/command-handler.d.ts

@@ -2,14 +2,16 @@ import type { CommandHandler as CommandHandlerPort } from '../../application/mes
 import type { Command } from '../../application/messaging/command.js';
 import type { MessageType } from '../../application/messaging/message-type.js';
 import type { ClassDeclarator } from '../dependencies/class-declarator.js';
-import type { Dependencies } from '../dependencies/dependencies.js';
+import type { DeclaredDependencies } from '../dependencies/declared-dependencies.js';
+import type { DependenciesFromSignature } from '../dependencies/dependencies-from-signature.js';
 import type { MessageHandler } from '../model/message-handler.js';
 /** The interface of the kernel under the name of its decorator, so one import serves both. */
 export type CommandHandler<C extends Command<unknown>> = CommandHandlerPort<C>;
 /**
- * The one handler of a command, with the ports of its constructor parameters in order:
- * `@CommandHandler(PlaceOrder, [OrderRepository, Clock])`. The list is left out for a constructor
- * without parameters.
+ * The one handler of a command: `@CommandHandler(PlaceOrder)`. Its dependencies are the ports
+ * that type its constructor parameters, read from the source by `ddd-ts-kit docs`. A list given
+ * as the last argument, `@CommandHandler(PlaceOrder, [OrderRepository, Clock])`, is the form
+ * 0.1 projects wrote: it is checked against the constructor and wins over the signature.
  */
-export declare function CommandHandler<C extends Command<unknown>, const D extends Dependencies = readonly []>(message: MessageType<C>, dependencies?: D): ClassDeclarator<MessageHandler<C>, D>;
+export declare function CommandHandler<C extends Command<unknown>, const D extends DeclaredDependencies = DependenciesFromSignature>(message: MessageType<C>, dependencies?: D): ClassDeclarator<MessageHandler<C>, D>;
 //# sourceMappingURL=command-handler.d.ts.map

package/dist/declarations/decorators/command-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/command-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAC3G,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,8FAA8F;AAC9F,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,EAAE,EACnG,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAIvC"}
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/command-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAC3G,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,8FAA8F;AAC9F,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAE/E;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,EAC1B,KAAK,CAAC,CAAC,SAAS,oBAAoB,GAAG,yBAAyB,EAChE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAIlF"}

package/dist/declarations/decorators/command-handler.js

@@ -1,9 +1,10 @@
 import { record } from '../registry/record.js';
 import { handling } from './handling.js';
 /**
- * The one handler of a command, with the ports of its constructor parameters in order:
- * `@CommandHandler(PlaceOrder, [OrderRepository, Clock])`. The list is left out for a constructor
- * without parameters.
+ * The one handler of a command: `@CommandHandler(PlaceOrder)`. Its dependencies are the ports
+ * that type its constructor parameters, read from the source by `ddd-ts-kit docs`. A list given
+ * as the last argument, `@CommandHandler(PlaceOrder, [OrderRepository, Clock])`, is the form
+ * 0.1 projects wrote: it is checked against the constructor and wins over the signature.
  */
 export function CommandHandler(message, dependencies) {
     return (target) => {

package/dist/declarations/decorators/command-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-handler.js","sourceRoot":"","sources":["../../../src/declarations/decorators/command-handler.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKzC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAuB,EACvB,YAAgB;IAEhB,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IACvG,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"command-handler.js","sourceRoot":"","sources":["../../../src/declarations/decorators/command-handler.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKzC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAG5B,OAAuB,EAAE,YAAgB;IACzC,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IACvG,CAAC,CAAC;AACJ,CAAC"}

package/dist/declarations/decorators/declaring.d.ts

@@ -1,6 +1,6 @@
 import type { DependencyKind } from '../../application/dependency-kind.js';
 import type { ClassDeclarator } from '../dependencies/class-declarator.js';
-import type { Dependencies } from '../dependencies/dependencies.js';
+import type { DeclaredDependencies } from '../dependencies/declared-dependencies.js';
 import type { PortDeclaration } from '../model/port-declaration.js';
 import type { Token } from '../token/token.js';
 import type { PortOptions } from './port-options.js';
@@ -10,6 +10,6 @@ interface Port<T> {
     readonly kind: DependencyKind;
     readonly token: Token<T>;
 }
-export declare function declaring<T, D extends Dependencies>(port: Port<T>, [first, second]: Settings<PortOptions, D>): ClassDeclarator<T, D>;
+export declare function declaring<T, D extends DeclaredDependencies>(port: Port<T>, [first, second]: Settings<PortOptions, D>): ClassDeclarator<T, D>;
 export {};
 //# sourceMappingURL=declaring.d.ts.map

package/dist/declarations/decorators/declaring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"declaring.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/declaring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,UAAU,IAAI,CAAC,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,YAAY,EACjD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,GACxC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAgBvB"}
+{"version":3,"file":"declaring.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/declaring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,UAAU,IAAI,CAAC,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,oBAAoB,EACzD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,GACxC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAgBvB"}

package/dist/declarations/decorators/declaring.js

@@ -3,8 +3,8 @@ import { record } from '../registry/record.js';
 import { portDefect } from '../token/port-defect.js';
 import { isDependencies } from './is-dependencies.js';
 export function declaring(port, [first, second]) {
-    const options = isDependencies(first) ? {} : (first ?? {});
-    const dependencies = isDependencies(first) ? first : (second ?? []);
+    const options = isOptions(first) ? first : {};
+    const dependencies = isDependencies(first) ? first : second;
     return (target) => {
         assertImplements(port.token, target);
         record(target, {
@@ -17,6 +17,9 @@ export function declaring(port, [first, second]) {
         });
     };
 }
+function isOptions(value) {
+    return typeof value === 'object' && value !== null && !isDependencies(value);
+}
 function assertImplements(port, adapter) {
     const defect = portDefect(port, adapter);
     if (defect !== undefined) {

package/dist/declarations/decorators/declaring.js.map

@@ -1 +1 @@
-{"version":3,"file":"declaring.js","sourceRoot":"","sources":["../../../src/declarations/decorators/declaring.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAUtD,MAAM,UAAU,SAAS,CACvB,IAAa,EACb,CAAC,KAAK,EAAE,MAAM,CAA2B;IAEzC,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAEpE,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAErC,MAAM,CAAC,MAAM,EAAE;YACb,GAAG,IAAI;YACP,QAAQ,EAAE,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW;YAChE,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI;YACnC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,cAAc,EAAE,MAAM;YACtB,YAAY;SACb,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAoB,EAAE,OAAuB;IACrE,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;AACH,CAAC"}
+{"version":3,"file":"declaring.js","sourceRoot":"","sources":["../../../src/declarations/decorators/declaring.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAUtD,MAAM,UAAU,SAAS,CACvB,IAAa,EACb,CAAC,KAAK,EAAE,MAAM,CAA2B;IAEzC,MAAM,OAAO,GAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,YAAY,GAAyB,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAElF,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAErC,MAAM,CAAC,MAAM,EAAE;YACb,GAAG,IAAI;YACP,QAAQ,EAAE,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW;YAChE,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI;YACnC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,cAAc,EAAE,MAAM;YACtB,YAAY;SACb,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAoB,EAAE,OAAuB;IACrE,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/declarations/decorators/domain-event-handler.d.ts

@@ -1,7 +1,8 @@
 import type { DomainEventPhase } from '../../application/events/domain-event-phase.js';
 import type { DomainEvent } from '../../domain/domain-event.js';
 import type { ClassDeclarator } from '../dependencies/class-declarator.js';
-import type { Dependencies } from '../dependencies/dependencies.js';
+import type { DeclaredDependencies } from '../dependencies/declared-dependencies.js';
+import type { DependenciesFromSignature } from '../dependencies/dependencies-from-signature.js';
 import type { DomainEventHandler as DomainEventHandlerShape } from '../model/domain-event-handler.js';
 import type { DomainEventType } from '../model/domain-event-type.js';
 import type { Named } from './named.js';
@@ -22,9 +23,9 @@ export type DomainEventHandler<E extends DomainEvent> = DomainEventHandlerShape<
 /**
  * A handler of a domain event of its own context, run at the end of the unit of work that
  * recorded the event, before the commit:
- * `@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid' }, [CommandBus])`. One whose
+ * `@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid' })`. One whose
  * effect is outside the transaction runs after it:
- * `@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid', phase: 'after-commit' }, [Cache])`.
+ * `@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid', phase: 'after-commit' })`.
  */
-export declare function DomainEventHandler<E extends DomainEvent, const Name extends string, const D extends Dependencies = readonly []>(event: DomainEventType<E>, options: DomainEventHandlerOptions<Name> & Named<Name, 'name'>, dependencies?: D): ClassDeclarator<DomainEventHandlerShape<E>, D>;
+export declare function DomainEventHandler<E extends DomainEvent, const Name extends string, const D extends DeclaredDependencies = DependenciesFromSignature>(event: DomainEventType<E>, options: DomainEventHandlerOptions<Name> & Named<Name, 'name'>, dependencies?: D): ClassDeclarator<DomainEventHandlerShape<E>, D>;
 //# sourceMappingURL=domain-event-handler.d.ts.map

package/dist/declarations/decorators/domain-event-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain-event-handler.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/domain-event-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACtG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,yBAAyB,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IACrE,+GAA+G;IAC/G,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,IAAI,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,WAAW,EACrB,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,EAAE,EAE1C,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EACzB,OAAO,EAAE,yBAAyB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,EAC9D,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAehD"}
+{"version":3,"file":"domain-event-handler.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/domain-event-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAChG,OAAO,KAAK,EAAE,kBAAkB,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACtG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,yBAAyB,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IACrE,+GAA+G;IAC/G,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,IAAI,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,WAAW,EACrB,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,CAAC,SAAS,oBAAoB,GAAG,yBAAyB,EAEhE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EACzB,OAAO,EAAE,yBAAyB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,EAC9D,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAehD"}

package/dist/declarations/decorators/domain-event-handler.js

@@ -3,9 +3,9 @@ import { assertNamed } from './assert-named.js';
 /**
  * A handler of a domain event of its own context, run at the end of the unit of work that
  * recorded the event, before the commit:
- * `@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid' }, [CommandBus])`. One whose
+ * `@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid' })`. One whose
  * effect is outside the transaction runs after it:
- * `@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid', phase: 'after-commit' }, [Cache])`.
+ * `@DomainEventHandler(OrderPaid, { name: 'ordering.order.paid', phase: 'after-commit' })`.
  */
 export function DomainEventHandler(event, options, dependencies) {
     const { name, phase = 'before-commit' } = options;
@@ -16,7 +16,7 @@ export function DomainEventHandler(event, options, dependencies) {
             name,
             phase,
             event,
-            dependencies: dependencies ?? [],
+            dependencies,
             pair: (use) => use(event, target),
         });
     };

package/dist/declarations/decorators/domain-event-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"domain-event-handler.js","sourceRoot":"","sources":["../../../src/declarations/decorators/domain-event-handler.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmBhD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAKhC,KAAyB,EACzB,OAA8D,EAC9D,YAAgB;IAEhB,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC;IAElD,WAAW,CAAC,IAAI,EAAE,gBAAgB,KAAK,CAAC,IAAI,kCAAkC,CAAC,CAAC;IAEhF,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,MAAM,CAAC,MAAM,EAAE;YACb,IAAI,EAAE,sBAAsB;YAC5B,IAAI;YACJ,KAAK;YACL,KAAK;YACL,YAAY,EAAE,YAAY,IAAI,EAAE;YAChC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"domain-event-handler.js","sourceRoot":"","sources":["../../../src/declarations/decorators/domain-event-handler.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmBhD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAKhC,KAAyB,EACzB,OAA8D,EAC9D,YAAgB;IAEhB,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC;IAElD,WAAW,CAAC,IAAI,EAAE,gBAAgB,KAAK,CAAC,IAAI,kCAAkC,CAAC,CAAC;IAEhF,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,MAAM,CAAC,MAAM,EAAE;YACb,IAAI,EAAE,sBAAsB;YAC5B,IAAI;YACJ,KAAK;YACL,KAAK;YACL,YAAY;YACZ,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/declarations/decorators/gateway.d.ts

@@ -1,11 +1,12 @@
 import type { ClassDeclarator } from '../dependencies/class-declarator.js';
-import type { Dependencies } from '../dependencies/dependencies.js';
+import type { DeclaredDependencies } from '../dependencies/declared-dependencies.js';
+import type { DependenciesFromSignature } from '../dependencies/dependencies-from-signature.js';
 import type { Token } from '../token/token.js';
 import type { PortOptions } from './port-options.js';
 /**
  * The adapter of a port through which this context calls another one synchronously: in
- * process today, a remote client tomorrow. `@Gateway(StockGateway, [HttpClient])`.
+ * process today, a remote client tomorrow. `@Gateway(StockGateway)`.
  */
-export declare function Gateway<T, const D extends Dependencies = readonly []>(port: Token<T>, dependencies?: D): ClassDeclarator<T, D>;
-export declare function Gateway<T, const D extends Dependencies = readonly []>(port: Token<T>, options: PortOptions, dependencies?: D): ClassDeclarator<T, D>;
+export declare function Gateway<T, const D extends DeclaredDependencies = DependenciesFromSignature>(port: Token<T>, dependencies?: D): ClassDeclarator<T, D>;
+export declare function Gateway<T, const D extends DeclaredDependencies = DependenciesFromSignature>(port: Token<T>, options: PortOptions, dependencies?: D): ClassDeclarator<T, D>;
 //# sourceMappingURL=gateway.d.ts.map

package/dist/declarations/decorators/gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,EAAE,EACnE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzB,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,EAAE,EACnE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,OAAO,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAChG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,oBAAoB,GAAG,yBAAyB,EACzF,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzB,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,oBAAoB,GAAG,yBAAyB,EACzF,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,OAAO,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,CAAC,GACf,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/declarations/decorators/gateway.js.map

@@ -1 +1 @@
-{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../../src/declarations/decorators/gateway.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAkB3C,MAAM,UAAU,OAAO,CACrB,IAAc,EACd,GAAG,QAAkC;IAErC,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AAChF,CAAC"}
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../../src/declarations/decorators/gateway.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAkB3C,MAAM,UAAU,OAAO,CACrB,IAAc,EACd,GAAG,QAAkC;IAErC,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AAChF,CAAC"}

package/dist/declarations/decorators/handling.d.ts

@@ -1,10 +1,10 @@
 import type { MessageType } from '../../application/messaging/message-type.js';
 import type { Message } from '../../application/messaging/message.js';
-import type { Dependencies } from '../dependencies/dependencies.js';
+import type { DeclaredDependencies } from '../dependencies/declared-dependencies.js';
 import type { HandlerDeclaration } from '../model/handler-declaration.js';
 type Handling = Omit<HandlerDeclaration, 'dependencies' | 'message'> & {
     readonly message: MessageType<Message>;
 };
-export declare function handling(declared: Handling, dependencies?: Dependencies): HandlerDeclaration;
+export declare function handling(declared: Handling, dependencies: DeclaredDependencies): HandlerDeclaration;
 export {};
 //# sourceMappingURL=handling.d.ts.map

package/dist/declarations/decorators/handling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handling.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/handling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,KAAK,QAAQ,GAAG,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,SAAS,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAElH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,GAAE,YAAiB,GAAG,kBAAkB,CAEhG"}
+{"version":3,"file":"handling.d.ts","sourceRoot":"","sources":["../../../src/declarations/decorators/handling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,KAAK,QAAQ,GAAG,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,SAAS,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAElH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,oBAAoB,GAAG,kBAAkB,CAEnG"}

package/dist/declarations/decorators/handling.js

@@ -1,4 +1,4 @@
-export function handling(declared, dependencies = []) {
+export function handling(declared, dependencies) {
     return { ...declared, dependencies };
 }
 //# sourceMappingURL=handling.js.map

package/dist/declarations/decorators/handling.js.map

@@ -1 +1 @@
-{"version":3,"file":"handling.js","sourceRoot":"","sources":["../../../src/declarations/decorators/handling.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,QAAQ,CAAC,QAAkB,EAAE,YAAY,GAAiB,EAAE;IAC1E,OAAO,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"handling.js","sourceRoot":"","sources":["../../../src/declarations/decorators/handling.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,QAAQ,CAAC,QAAkB,EAAE,YAAkC;IAC7E,OAAO,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,CAAC;AACvC,CAAC"}

package/dist/declarations/decorators/integration-event-handler.d.ts

@@ -1,7 +1,8 @@
 import type { Actor } from '../../application/actor/actor.js';
 import type { IntegrationEvent } from '../../application/events/integration-event.js';
 import type { ClassDeclarator } from '../dependencies/class-declarator.js';
-import type { Dependencies } from '../dependencies/dependencies.js';
+import type { DeclaredDependencies } from '../dependencies/declared-dependencies.js';
+import type { DependenciesFromSignature } from '../dependencies/dependencies-from-signature.js';
 import type { EventContract } from '../model/event-contract.js';
 import type { IntegrationEventHandler as IntegrationEventHandlerShape } from '../model/integration-event-handler.js';
 import type { Named } from './named.js';
@@ -24,7 +25,7 @@ export interface IntegrationEventHandlerOptions<Name extends string = string> {
 export type IntegrationEventHandler<Payload> = IntegrationEventHandlerShape<Payload>;
 /**
  * The handler of an integration event of another context, subscribed under a stable consumer name:
- * `@IntegrationEventHandler(OrderPlaced, { consumer: 'billing.invoice-on-order-placed' }, [CommandBus])`.
+ * `@IntegrationEventHandler(OrderPlaced, { consumer: 'billing.invoice-on-order-placed' })`.
  */
-export declare function IntegrationEventHandler<Payload, const Name extends string, const D extends Dependencies = readonly []>(contract: EventContract<Payload>, options: IntegrationEventHandlerOptions<Name> & Named<Name, 'consumer'>, dependencies?: D): ClassDeclarator<IntegrationEventHandlerShape<Payload>, D>;
+export declare function IntegrationEventHandler<Payload, const Name extends string, const D extends DeclaredDependencies = DependenciesFromSignature>(contract: EventContract<Payload>, options: IntegrationEventHandlerOptions<Name> & Named<Name, 'consumer'>, dependencies?: D): ClassDeclarator<IntegrationEventHandlerShape<Payload>, D>;
 //# sourceMappingURL=integration-event-handler.d.ts.map