@relaybus/nestjs 0.2.0 → 0.3.1

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/event-consumer.decorator.ts","../src/subscribe.decorator.ts","../src/handler-explorer.ts","../src/module-options.ts","../src/relay-bus-health.ts","../src/relay-bus-lifecycle.ts","../src/relay-bus.module.ts"],"names":["describeCatalog","consume","ConfigurationError","RelayBusHandlerExplorer","Injectable","DiscoveryService","MetadataScanner","RelayBus","ConfigurableModuleBuilder","RelayBusHealth","systemClock","Inject","RelayBusLifecycle","RelayBusModule","Module","DiscoveryModule","Logger"],"mappings":"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","file":"index.cjs","sourcesContent":["import 'reflect-metadata';\nimport {\n  ConfigurationError,\n  consume,\n  describeCatalog,\n  type Catalog,\n  type CatalogEntry,\n  type CatalogEventSelection,\n  type EventOf,\n  type HandlerContext,\n  type SubscribeOptions,\n} from '@relaybus/core';\n\n/**\n * Options of {@link EventConsumer}: the core {@link SubscribeOptions} applied to\n * every handler of the class, except `id`, which is always\n * `${ClassName}.on${EventName}`, and optionally the events the class consumes.\n */\nexport type EventConsumerOptions<\n  TCatalog extends Catalog = Catalog,\n  TName extends keyof TCatalog = keyof TCatalog,\n> = Omit<SubscribeOptions, 'id'> & CatalogEventSelection<TName>;\n\n/** What one `@EventConsumer` decorator recorded on a class. */\nexport interface EventConsumerMetadata {\n  readonly catalog: Catalog;\n  /** Subscribe options applied to every handler of the class. */\n  readonly options: Omit<SubscribeOptions, 'id'>;\n  /**\n   * Entries named by `options.events`, whose methods are all required;\n   * undefined when the class consumes whichever handler methods it defines.\n   */\n  readonly selectedEntries: readonly CatalogEntry[] | undefined;\n}\n\n/**\n * A class whose instances have a handler method for each of the named catalog\n * events. The event parameter is checked strictly; the context is typed\n * `HandlerContext<never>` so a method may declare any transaction type.\n */\nexport type EventConsumerClass<\n  TCatalog extends Catalog,\n  TName extends keyof TCatalog,\n> = abstract new (...args: never[]) => {\n  readonly [TKey in TName & string as `on${TKey}`]: (\n    event: EventOf<TCatalog[TKey]>,\n    context: HandlerContext<never>,\n  ) => unknown;\n};\n\nconst EVENT_CONSUMER_METADATA_KEY = Symbol.for('relaybus.nestjs.event-consumer');\n\n/**\n * Subscribes a provider class to the events of a catalog: its\n * `on${EventName}` methods are registered when the module initialises, under\n * the stable id `${ClassName}.on${EventName}`, with `this` bound to the\n * provider instance.\n *\n * - Without `events`, every handler method the class defines is registered; a\n *   class that defines none fails the boot, which catches misspelled names.\n *   `implements HandlersOf<typeof Catalog>` makes the compiler require all of them.\n * - With `events`, exactly the methods of those events are registered (methods\n *   of other events are ignored), and a class missing one of them fails to\n *   compile and fails the boot. This is how a service consumes its part of a\n *   catalog shared between services.\n *\n * `catalogs: [consume(Catalog, { events })]` in the module options makes the\n * application fail to boot if no provider handles a consumed event. Works next\n * to `@Subscribe` in the same class (give a method that carries both a\n * distinct `@Subscribe` id). The provider must be a singleton. Declarations\n * are inherited; a subclass that declares the same catalog again replaces the\n * inherited declaration of that catalog, and declaring one catalog twice on\n * the same class throws a {@link ConfigurationError}.\n *\n * ```ts\n * @Injectable()\n * @EventConsumer(OrderEvents, { events: ['OrderPlaced'], transactional: true })\n * export class BillingHandlers {\n *   onOrderPlaced(event: EventOf<typeof OrderPlaced>) {}\n * }\n * ```\n */\nexport function EventConsumer<TCatalog extends Catalog>(\n  catalog: TCatalog,\n  options?: Omit<SubscribeOptions, 'id'> & { readonly events?: undefined },\n): ClassDecorator;\nexport function EventConsumer<TCatalog extends Catalog, const TName extends keyof TCatalog>(\n  catalog: TCatalog,\n  options: Omit<SubscribeOptions, 'id'> & { readonly events: readonly TName[] },\n): (target: EventConsumerClass<TCatalog, TName>) => void;\n/**\n * With options whose `events` are not statically known (a variable typed\n * {@link EventConsumerOptions}), the selection is checked when the module\n * initialises instead of at compile time.\n */\nexport function EventConsumer<TCatalog extends Catalog>(\n  catalog: TCatalog,\n  options: EventConsumerOptions<TCatalog>,\n): ClassDecorator;\nexport function EventConsumer(\n  catalog: Catalog,\n  {\n    events,\n    ...options\n  }: Omit<SubscribeOptions, 'id'> & {\n    readonly events?: readonly PropertyKey[] | undefined;\n  } = {},\n): ClassDecorator {\n  const { name } = describeCatalog(catalog);\n  const selectedEntries =\n    events === undefined\n      ? undefined\n      : consume(catalog, { events: events as readonly (keyof Catalog)[] }).entries;\n  return (target) => {\n    const existing =\n      (Reflect.getOwnMetadata(EVENT_CONSUMER_METADATA_KEY, target) as\n        EventConsumerMetadata[] | undefined) ?? [];\n    if (existing.some((metadata) => metadata.catalog === catalog)) {\n      throw new ConfigurationError(\n        `@EventConsumer(${name ?? 'catalog'}) is declared twice on ${target.name}; ` +\n          `merge the declarations into one`,\n      );\n    }\n    Reflect.defineMetadata(\n      EVENT_CONSUMER_METADATA_KEY,\n      [...existing, { catalog, options, selectedEntries }],\n      target,\n    );\n  };\n}\n\n/**\n * Reads the `@EventConsumer` declarations of a class and of its ancestors,\n * ancestors first, each in declaration order. When a class and an ancestor\n * both declare a catalog, the declaration nearest to the class wins.\n */\nexport function readEventConsumerMetadata(target: object): readonly EventConsumerMetadata[] {\n  const lineage: object[] = [];\n  for (let current = target; current !== Function.prototype;) {\n    lineage.unshift(current);\n    current = Object.getPrototypeOf(current) as object;\n  }\n  const byCatalog = new Map<Catalog, EventConsumerMetadata>();\n  for (const type of lineage) {\n    const own =\n      (Reflect.getOwnMetadata(EVENT_CONSUMER_METADATA_KEY, type) as\n        EventConsumerMetadata[] | undefined) ?? [];\n    for (const metadata of own) {\n      byCatalog.set(metadata.catalog, metadata);\n    }\n  }\n  return [...byCatalog.values()];\n}\n","import 'reflect-metadata';\nimport type { EventClass, EventEnvelope, HandlerContext, SubscribeOptions } from '@relaybus/core';\n\n/**\n * Options of {@link Subscribe}: the core {@link SubscribeOptions}, except that\n * `id` is optional and defaults to `ClassName.methodName`.\n */\nexport type SubscribeDecoratorOptions = Omit<SubscribeOptions, 'id'> & {\n  /**\n   * Stable id of the handler. Deliveries are recorded under it, so renaming it\n   * (or the class or method it is derived from) orphans pending deliveries.\n   * Default: `${ClassName}.${methodName}`. Required when one method carries\n   * several `@Subscribe` decorators.\n   */\n  readonly id?: string;\n};\n\n/** What one `@Subscribe` decorator recorded on a method. */\nexport interface SubscribeMetadata {\n  readonly event: EventClass<unknown> | string;\n  readonly options: SubscribeDecoratorOptions;\n}\n\nconst SUBSCRIBE_METADATA_KEY = Symbol.for('relaybus.nestjs.subscribe');\n\ntype HandlerMethod<TPayload> = (\n  event: EventEnvelope<TPayload>,\n  context: HandlerContext<never>,\n) => unknown;\n\ntype SubscribeDecorator<TPayload> = <TMethod extends HandlerMethod<TPayload>>(\n  target: object,\n  propertyKey: string | symbol,\n  descriptor: TypedPropertyDescriptor<TMethod>,\n) => void;\n\n/**\n * Subscribes a provider method to an event class or type. The method is\n * registered with `bus.subscribe` when the module initialises, with `this`\n * bound to the provider instance, and receives `(envelope, context)`.\n *\n * The provider must be a singleton (default scope) and belong to any module of\n * the application. The decorator name differs from `@nestjs/event-emitter`'s\n * `@OnEvent` so both can be used in one application.\n *\n * ```ts\n * @Injectable()\n * export class ShippingHandlers {\n *   @Subscribe(OrderPlaced, { transactional: true })\n *   async onOrderPlaced(event: EventEnvelope<{ orderId: string }>, context: HandlerContext) {}\n * }\n * ```\n */\nexport function Subscribe<TPayload>(\n  event: EventClass<TPayload>,\n  options?: SubscribeDecoratorOptions,\n): SubscribeDecorator<TPayload>;\nexport function Subscribe(\n  eventType: string,\n  options?: SubscribeDecoratorOptions,\n): SubscribeDecorator<never>;\nexport function Subscribe(\n  event: EventClass<unknown> | string,\n  options: SubscribeDecoratorOptions = {},\n): (target: object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void {\n  return (target, propertyKey) => {\n    // Keyed by (prototype, property) rather than stored on the method function, so a\n    // decorator that later replaces the method does not drop the subscription.\n    const existing =\n      (Reflect.getOwnMetadata(SUBSCRIBE_METADATA_KEY, target, propertyKey) as\n        SubscribeMetadata[] | undefined) ?? [];\n    Reflect.defineMetadata(\n      SUBSCRIBE_METADATA_KEY,\n      [...existing, { event, options }],\n      target,\n      propertyKey,\n    );\n  };\n}\n\n/**\n * Reads the `@Subscribe` declarations of a method, in declaration order. The\n * prototype chain is searched, so a subclass inherits the declarations of the\n * nearest ancestor that declares them.\n */\nexport function readSubscribeMetadata(\n  prototype: object,\n  propertyKey: string | symbol,\n): readonly SubscribeMetadata[] {\n  return (\n    (Reflect.getMetadata(SUBSCRIBE_METADATA_KEY, prototype, propertyKey) as\n      SubscribeMetadata[] | undefined) ?? []\n  );\n}\n","import { Inject, Injectable, type OnModuleInit } from '@nestjs/common';\nimport { DiscoveryService, MetadataScanner } from '@nestjs/core';\nimport type { InstanceWrapper } from '@nestjs/core/injector/instance-wrapper.js';\nimport {\n  ConfigurationError,\n  RelayBus,\n  describeCatalog,\n  type CatalogEntry,\n  type EventHandler,\n} from '@relaybus/core';\nimport { readEventConsumerMetadata } from './event-consumer.decorator.js';\nimport { readSubscribeMetadata, type SubscribeMetadata } from './subscribe.decorator.js';\n\ninterface SubscribedMethod {\n  readonly methodName: string;\n  readonly declarations: readonly SubscribeMetadata[];\n}\n\n/**\n * Finds every `@Subscribe` method and every `@EventConsumer` class among the\n * singleton providers of the application and registers them on the bus before\n * the bus starts. Providers that are request-scoped or transient, directly or\n * through a dependency, and use either decorator fail the boot. A request-scoped provider whose\n * token is neither a class nor an instance carrying the decorated prototype\n * (for example a string-token factory) cannot be inspected and is skipped.\n */\n@Injectable()\nexport class RelayBusHandlerExplorer implements OnModuleInit {\n  constructor(\n    @Inject(DiscoveryService) private readonly discovery: DiscoveryService,\n    @Inject(MetadataScanner) private readonly metadataScanner: MetadataScanner,\n    @Inject(RelayBus) private readonly bus: RelayBus,\n  ) {}\n\n  onModuleInit(): void {\n    const registeredBy = new Map<string, string>();\n    const visited = new Map<object, Set<string>>();\n    const consumers = new WeakSet<object>();\n    for (const wrapper of this.discovery.getProviders()) {\n      if (wrapper.isTransient || !wrapper.isDependencyTreeStatic()) {\n        this.assertNoHandlers(wrapper);\n        continue;\n      }\n      const instance = wrapper.instance as unknown;\n      if (typeof instance !== 'object' || instance === null) {\n        continue;\n      }\n      const prototype = Object.getPrototypeOf(instance) as object | null;\n      if (prototype === null) {\n        continue;\n      }\n      const className = instance.constructor.name;\n      for (const { methodName, declarations } of this.subscribedMethods(prototype)) {\n        // A `useExisting` alias exposes the same instance under another token.\n        const seen = visited.get(instance) ?? new Set<string>();\n        visited.set(instance, seen);\n        if (seen.has(methodName)) {\n          continue;\n        }\n        seen.add(methodName);\n        const method = (instance as Record<string, unknown>)[methodName] as (\n          ...args: Parameters<EventHandler>\n        ) => unknown;\n        const location = `${className}.${methodName}`;\n        for (const { event, options } of declarations) {\n          const id = options.id ?? location;\n          const previous = registeredBy.get(id);\n          if (previous !== undefined) {\n            throw new ConfigurationError(\n              `Handler id '${id}' is used by both ${previous} and ${location}; ` +\n                `pass a unique { id } to @Subscribe`,\n            );\n          }\n          registeredBy.set(id, location);\n          // Core resolves both classes and type strings; the overloads cannot express the union.\n          this.bus.subscribe(\n            event as never,\n            (envelope, context) => method.call(instance, envelope, context),\n            { ...options, id },\n          );\n        }\n      }\n      if (!consumers.has(instance)) {\n        consumers.add(instance);\n        this.registerEventConsumers(instance, className, registeredBy);\n      }\n    }\n  }\n\n  private registerEventConsumers(\n    instance: object,\n    className: string,\n    registeredBy: Map<string, string>,\n  ): void {\n    const lookup = instance as Record<string, unknown>;\n    for (const { catalog, options, selectedEntries } of readEventConsumerMetadata(\n      instance.constructor,\n    )) {\n      const { name, entries } = describeCatalog(catalog);\n      const label = name ?? 'catalog';\n      const handlers = selectedEntries ?? entries.filter((entry) => isMethod(lookup, entry));\n      const missing = handlers.filter((entry) => !isMethod(lookup, entry));\n      if (missing.length > 0) {\n        throw new ConfigurationError(\n          `${className} uses @EventConsumer(${label}) but lacks the handler methods of events ` +\n            `it consumes: ${missing.map((entry) => entry.handlerName).join(', ')}`,\n        );\n      }\n      if (handlers.length === 0) {\n        throw new ConfigurationError(\n          `${className} uses @EventConsumer(${label}) but defines none of its handler ` +\n            `methods (${entries.map((entry) => entry.handlerName).join(', ')})`,\n        );\n      }\n      for (const entry of handlers) {\n        const id = `${className}.${entry.handlerName}`;\n        const previous = registeredBy.get(id);\n        if (previous !== undefined) {\n          throw new ConfigurationError(\n            `Handler id '${id}' of @EventConsumer(${label}) is already used by ${previous}; ` +\n              `give the @Subscribe a unique { id } or drop it`,\n          );\n        }\n        registeredBy.set(id, `${className}.${entry.handlerName}`);\n        const method = lookup[entry.handlerName] as (...args: Parameters<EventHandler>) => unknown;\n        this.bus.subscribe(\n          entry.eventClass as never,\n          (envelope, context) => method.call(instance, envelope, context),\n          { ...options, id },\n        );\n      }\n    }\n  }\n\n  private subscribedMethods(prototype: object): SubscribedMethod[] {\n    const methods: SubscribedMethod[] = [];\n    for (const methodName of this.metadataScanner.getAllMethodNames(prototype)) {\n      const declarations = readSubscribeMetadata(prototype, methodName);\n      if (declarations.length > 0) {\n        methods.push({ methodName, declarations });\n      }\n    }\n    return methods;\n  }\n\n  /**\n   * Request-scoped and transient wrappers have no usable instance (a factory\n   * wrapper has none at all), so the decorated prototype is taken from the\n   * provider class, or from the provider token for factories when it is a class.\n   */\n  private assertNoHandlers(wrapper: InstanceWrapper): void {\n    const type = (wrapper.isFactory ? wrapper.token : wrapper.metatype) as unknown;\n    if (typeof type === 'function' && readEventConsumerMetadata(type).length > 0) {\n      throw new ConfigurationError(\n        `${type.name} uses @EventConsumer but its provider is request-scoped or transient ` +\n          `(directly or through a dependency); handlers must be singleton providers`,\n      );\n    }\n    const prototype = typeof type === 'function' ? (type.prototype as object) : null;\n    const [first] = prototype === null ? [] : this.subscribedMethods(prototype);\n    if (first !== undefined) {\n      throw new ConfigurationError(\n        `${(prototype as { constructor: { name: string } }).constructor.name}.${first.methodName} ` +\n          `uses @Subscribe but its provider is request-scoped or transient ` +\n          `(directly or through a dependency); handlers must be singleton providers`,\n      );\n    }\n  }\n}\n\nfunction isMethod(instance: Record<string, unknown>, entry: CatalogEntry): boolean {\n  return typeof instance[entry.handlerName] === 'function';\n}\n","import { ConfigurableModuleBuilder } from '@nestjs/common';\nimport type { RelayBusOptions } from '@relaybus/core';\n\n/**\n * Options of {@link RelayBusModule}: everything {@link RelayBusOptions} accepts\n * except `logger`, which is always a Nest `Logger` with context `RelayBus`\n * (configure it with `app.useLogger`). Only `store` is required.\n */\nexport type RelayBusModuleOptions<TTransaction = unknown> = Omit<\n  RelayBusOptions<TTransaction>,\n  'logger'\n>;\n\n/** Module-level extras accepted next to the options by `forRoot` and `forRootAsync`. */\nexport interface RelayBusModuleExtras {\n  /** Make `RelayBus` and `RelayBusHealth` injectable everywhere. Default true. */\n  readonly isGlobal?: boolean;\n}\n\n/** Implemented by classes passed as `useClass` / `useExisting` to `forRootAsync`. */\nexport interface RelayBusModuleOptionsFactory {\n  create(): Promise<RelayBusModuleOptions> | RelayBusModuleOptions;\n}\n\nexport const {\n  ConfigurableModuleClass: RelayBusConfigurableModule,\n  MODULE_OPTIONS_TOKEN: RELAYBUS_MODULE_OPTIONS,\n} = new ConfigurableModuleBuilder<RelayBusModuleOptions>()\n  .setClassMethodName('forRoot')\n  .setExtras<RelayBusModuleExtras>({ isGlobal: true }, (definition, extras) => ({\n    ...definition,\n    global: extras.isGlobal === true,\n  }))\n  .build();\n","import { Inject, Injectable } from '@nestjs/common';\nimport { RelayBus, systemClock, type EventStoreStatistics } from '@relaybus/core';\nimport { RELAYBUS_MODULE_OPTIONS, type RelayBusModuleOptions } from './module-options.js';\n\n/** Result of {@link RelayBusHealth.check}. */\nexport interface RelayBusHealthReport {\n  /**\n   * `down` when the bus is not running, a transport reports itself not ready\n   * (dead Kafka consumer, disconnected RabbitMQ) or the store cannot be queried.\n   */\n  readonly status: 'up' | 'down';\n  readonly running: boolean;\n  /** `bus.isReady()`: running and every transport ready. */\n  readonly ready: boolean;\n  /** Number of registered handlers and routes. */\n  readonly handlers: number;\n  /** Delivery counts; absent when the bus is not running or the store failed. */\n  readonly statistics?: EventStoreStatistics;\n  /** Milliseconds the oldest due delivery has waited; 0 when nothing is due. */\n  readonly lagMilliseconds?: number;\n  /** Message of the store error, when the statistics query failed. */\n  readonly error?: string;\n}\n\n/**\n * Health probe of the bus without a dependency on `@nestjs/terminus`. Wrap\n * {@link check} in a terminus indicator (see the README). The lag is measured\n * with the `clock` given to the module options (the system clock by default),\n * the same clock the bus uses.\n */\n@Injectable()\nexport class RelayBusHealth {\n  constructor(\n    @Inject(RelayBus) private readonly bus: RelayBus,\n    @Inject(RELAYBUS_MODULE_OPTIONS) private readonly options: RelayBusModuleOptions,\n  ) {}\n\n  async check(): Promise<RelayBusHealthReport> {\n    const running = this.bus.isRunning;\n    const ready = this.bus.isReady();\n    const handlers = this.bus.handlers().length;\n    if (!running) {\n      return { status: 'down', running, ready, handlers };\n    }\n    try {\n      const statistics = await this.bus.statistics();\n      const clock = this.options.clock ?? systemClock;\n      const lagMilliseconds =\n        statistics.oldestDueAt === null\n          ? 0\n          : Math.max(0, clock.now().getTime() - statistics.oldestDueAt.getTime());\n      return {\n        status: ready ? 'up' : 'down',\n        running,\n        ready,\n        handlers,\n        statistics,\n        lagMilliseconds,\n      };\n    } catch (error) {\n      return {\n        status: 'down',\n        running,\n        ready,\n        handlers,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n","import {\n  Inject,\n  Injectable,\n  type BeforeApplicationShutdown,\n  type OnApplicationBootstrap,\n} from '@nestjs/common';\nimport { RelayBus } from '@relaybus/core';\n\n/**\n * Starts the bus once every handler is registered and the application has\n * bootstrapped, and stops it (draining running handlers) on shutdown. A start\n * failure rejects the hook, so the application does not boot.\n */\n@Injectable()\nexport class RelayBusLifecycle implements OnApplicationBootstrap, BeforeApplicationShutdown {\n  constructor(@Inject(RelayBus) private readonly bus: RelayBus) {}\n\n  async onApplicationBootstrap(): Promise<void> {\n    await this.bus.start();\n  }\n\n  async beforeApplicationShutdown(): Promise<void> {\n    await this.bus.stop();\n  }\n}\n","import { Logger, Module } from '@nestjs/common';\nimport { DiscoveryModule } from '@nestjs/core';\nimport { RelayBus } from '@relaybus/core';\nimport { RelayBusHandlerExplorer } from './handler-explorer.js';\nimport {\n  RELAYBUS_MODULE_OPTIONS,\n  RelayBusConfigurableModule,\n  type RelayBusModuleOptions,\n} from './module-options.js';\nimport { RelayBusHealth } from './relay-bus-health.js';\nimport { RelayBusLifecycle } from './relay-bus-lifecycle.js';\n\n/**\n * Registers one {@link RelayBus} for the application, discovers `@Subscribe`\n * handlers in every module, starts the bus after bootstrap and stops it on\n * shutdown. Global unless `isGlobal: false`.\n *\n * ```ts\n * RelayBusModule.forRoot({ store: new PostgresEventStore({ pool }), source: 'orders' })\n * ```\n */\n@Module({\n  imports: [DiscoveryModule],\n  providers: [\n    {\n      provide: RelayBus,\n      inject: [RELAYBUS_MODULE_OPTIONS],\n      useFactory: (options: RelayBusModuleOptions) =>\n        new RelayBus({ ...options, logger: new Logger('RelayBus') }),\n    },\n    RelayBusHandlerExplorer,\n    RelayBusLifecycle,\n    RelayBusHealth,\n  ],\n  exports: [RelayBus, RelayBusHealth],\n})\nexport class RelayBusModule extends RelayBusConfigurableModule {}\n"]}
+{"version":3,"sources":["../src/relay-bus-catalog-consumer.decorator.ts","../src/relay-bus-feature-contract.ts","../src/relay-bus-registry.ts","../src/relay-bus-consumer.decorator.ts","../src/handler-explorer.ts","../src/module-options.ts","../src/relay-bus-health.ts","../src/relay-bus-lifecycle.ts","../src/relay-bus-feature.module.ts","../src/relay-bus-transaction-host.ts","../src/relay-bus.module.ts","../src/relay-bus-transaction.decorator.ts"],"names":["describeCatalog","consume","ConfigurationError","produce","RelayBusHandlerExplorer","Injectable","DiscoveryService","MetadataScanner","RelayBus","ModulesContainer","ConfigurableModuleBuilder","RelayBusHealth","systemClock","Inject","RelayBusLifecycle","RelayBusFeatureModule","Module","RelayBusTransactionHost","TransactionRequiredError","RelayBusModule","DiscoveryModule","Logger"],"mappings":"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","file":"index.cjs","sourcesContent":["import 'reflect-metadata';\nimport {\n  ConfigurationError,\n  consume,\n  describeCatalog,\n  type Catalog,\n  type CatalogEntry,\n  type CatalogEventSelection,\n  type EventOf,\n  type HandlerContext,\n  type SubscribeOptions,\n} from '@relaybus/core';\n\n/**\n * Options of {@link RelayBusCatalogConsumer}: the core {@link SubscribeOptions} applied to\n * every handler of the class, except `id`, which is always\n * `${ClassName}.on${EventName}`, and optionally the events the class consumes.\n */\nexport type RelayBusCatalogConsumerOptions<\n  TCatalog extends Catalog = Catalog,\n  TName extends keyof TCatalog = keyof TCatalog,\n> = Omit<SubscribeOptions, 'id'> & CatalogEventSelection<TName>;\n\n/** What one `@RelayBusCatalogConsumer` decorator recorded on a class. */\nexport interface RelayBusCatalogConsumerMetadata {\n  readonly catalog: Catalog;\n  /** Subscribe options applied to every handler of the class. */\n  readonly options: Omit<SubscribeOptions, 'id'>;\n  /**\n   * Entries named by `options.events`, whose methods are all required;\n   * undefined when the class consumes whichever handler methods it defines.\n   */\n  readonly selectedEntries: readonly CatalogEntry[] | undefined;\n}\n\n/**\n * A class whose instances have a handler method for each of the named catalog\n * events. The event parameter is checked strictly; the context is typed\n * `HandlerContext<never>` so a method may declare any transaction type.\n */\nexport type RelayBusCatalogConsumerClass<\n  TCatalog extends Catalog,\n  TName extends keyof TCatalog,\n> = abstract new (...args: never[]) => {\n  readonly [TKey in TName & string as `on${TKey}`]: (\n    event: EventOf<TCatalog[TKey]>,\n    context: HandlerContext<never>,\n  ) => unknown;\n};\n\nconst EVENT_CONSUMER_METADATA_KEY = Symbol.for('relaybus.nestjs.event-consumer');\n\n/**\n * Subscribes a provider class to the events of a catalog: its\n * `on${EventName}` methods are registered when the module initialises, under\n * the stable id `${ClassName}.on${EventName}`, with `this` bound to the\n * provider instance.\n *\n * - Without `events`, every handler method the class defines is registered; a\n *   class that defines none fails the boot, which catches misspelled names.\n *   `implements HandlersOf<typeof Catalog>` makes the compiler require all of them.\n * - With `events`, exactly the methods of those events are registered (methods\n *   of other events are ignored), and a class missing one of them fails to\n *   compile and fails the boot. This is how a service consumes its part of a\n *   catalog shared between services.\n *\n * `catalogs: [consume(Catalog, { events })]` in the module options makes the\n * application fail to boot if no provider handles a consumed event. Works next\n * to `@RelayBusConsumer` in the same class (give a method that carries both a\n * distinct `@RelayBusConsumer` id). The provider must be a singleton. Declarations\n * are inherited; a subclass that declares the same catalog again replaces the\n * inherited declaration of that catalog, and declaring one catalog twice on\n * the same class throws a {@link ConfigurationError}.\n *\n * ```ts\n * @Injectable()\n * @RelayBusCatalogConsumer(OrderEvents, { events: ['OrderPlaced'], transactional: true })\n * export class BillingHandlers {\n *   onOrderPlaced(event: EventOf<typeof OrderPlaced>) {}\n * }\n * ```\n */\nexport function RelayBusCatalogConsumer<TCatalog extends Catalog>(\n  catalog: TCatalog,\n  options?: Omit<SubscribeOptions, 'id'> & { readonly events?: undefined },\n): ClassDecorator;\nexport function RelayBusCatalogConsumer<\n  TCatalog extends Catalog,\n  const TName extends keyof TCatalog,\n>(\n  catalog: TCatalog,\n  options: Omit<SubscribeOptions, 'id'> & { readonly events: readonly TName[] },\n): (target: RelayBusCatalogConsumerClass<TCatalog, TName>) => void;\n/**\n * With options whose `events` are not statically known (a variable typed\n * {@link RelayBusCatalogConsumerOptions}), the selection is checked when the module\n * initialises instead of at compile time.\n */\nexport function RelayBusCatalogConsumer<TCatalog extends Catalog>(\n  catalog: TCatalog,\n  options: RelayBusCatalogConsumerOptions<TCatalog>,\n): ClassDecorator;\nexport function RelayBusCatalogConsumer(\n  catalog: Catalog,\n  {\n    events,\n    ...options\n  }: Omit<SubscribeOptions, 'id'> & {\n    readonly events?: readonly PropertyKey[] | undefined;\n  } = {},\n): ClassDecorator {\n  const { name } = describeCatalog(catalog);\n  const selectedEntries =\n    events === undefined\n      ? undefined\n      : consume(catalog, { events: events as readonly (keyof Catalog)[] }).entries;\n  return (target) => {\n    const existing =\n      (Reflect.getOwnMetadata(EVENT_CONSUMER_METADATA_KEY, target) as\n        RelayBusCatalogConsumerMetadata[] | undefined) ?? [];\n    if (existing.some((metadata) => metadata.catalog === catalog)) {\n      throw new ConfigurationError(\n        `@RelayBusCatalogConsumer(${name ?? 'catalog'}) is declared twice on ${target.name}; ` +\n          `merge the declarations into one`,\n      );\n    }\n    Reflect.defineMetadata(\n      EVENT_CONSUMER_METADATA_KEY,\n      [...existing, { catalog, options, selectedEntries }],\n      target,\n    );\n  };\n}\n\n/**\n * @deprecated Renamed to {@link RelayBusCatalogConsumer}, which behaves identically; this alias is\n * removed in 1.0.0.\n */\nexport const EventConsumer: typeof RelayBusCatalogConsumer = RelayBusCatalogConsumer;\n\n/** @deprecated Renamed to {@link RelayBusCatalogConsumerOptions}; this alias is removed in 1.0.0. */\nexport type EventConsumerOptions<\n  TCatalog extends Catalog = Catalog,\n  TName extends keyof TCatalog = keyof TCatalog,\n> = RelayBusCatalogConsumerOptions<TCatalog, TName>;\n\n/** @deprecated Renamed to {@link RelayBusCatalogConsumerMetadata}; this alias is removed in 1.0.0. */\nexport type EventConsumerMetadata = RelayBusCatalogConsumerMetadata;\n\n/** @deprecated Renamed to {@link RelayBusCatalogConsumerClass}; this alias is removed in 1.0.0. */\nexport type EventConsumerClass<\n  TCatalog extends Catalog,\n  TName extends keyof TCatalog,\n> = RelayBusCatalogConsumerClass<TCatalog, TName>;\n\n/**\n * Reads the `@RelayBusCatalogConsumer` declarations of a class and of its ancestors,\n * ancestors first, each in declaration order. When a class and an ancestor\n * both declare a catalog, the declaration nearest to the class wins.\n */\nexport function readCatalogConsumerMetadata(\n  target: object,\n): readonly RelayBusCatalogConsumerMetadata[] {\n  const lineage: object[] = [];\n  for (let current = target; current !== Function.prototype;) {\n    lineage.unshift(current);\n    current = Object.getPrototypeOf(current) as object;\n  }\n  const byCatalog = new Map<Catalog, RelayBusCatalogConsumerMetadata>();\n  for (const type of lineage) {\n    const own =\n      (Reflect.getOwnMetadata(EVENT_CONSUMER_METADATA_KEY, type) as\n        RelayBusCatalogConsumerMetadata[] | undefined) ?? [];\n    for (const metadata of own) {\n      byCatalog.set(metadata.catalog, metadata);\n    }\n  }\n  return [...byCatalog.values()];\n}\n","import {\n  ConfigurationError,\n  consume,\n  describeCatalog,\n  produce,\n  type Catalog,\n  type CatalogDeclaration,\n  type CatalogRole,\n} from '@relaybus/core';\n\n/**\n * What one feature module consumes and produces, given to `RelayBusModule.forFeature`. Each item is\n * a whole catalog or a `consume(...)` / `produce(...)` declaration of some of its events.\n */\nexport interface RelayBusFeatureOptions {\n  /** Events the importing module handles: each needs a `@RelayBusConsumer` method (or a catalog consumer) among its providers. */\n  readonly consumes?: readonly (Catalog | CatalogDeclaration)[];\n  /** Events the importing module publishes for other services: each needs a route to a transport. */\n  readonly produces?: readonly (Catalog | CatalogDeclaration)[];\n}\n\n/** One event of a feature contract, named for error messages. */\nexport type ContractEvent = {\n  /** `Catalog.EventName`. */\n  readonly label: string;\n  readonly type: string;\n};\n\n/**\n * The contract of the module that imports `RelayBusModule.forFeature(...)`, checked when the\n * application initialises.\n */\nexport class RelayBusFeatureContract {\n  readonly consumes: readonly ContractEvent[];\n  readonly produces: readonly ContractEvent[];\n\n  /** @throws ConfigurationError for a `produce(...)` in `consumes`, a `consume(...)` in `produces`, or something that is not a catalog. */\n  constructor(options: RelayBusFeatureOptions) {\n    this.consumes = contractEvents(options.consumes ?? [], 'consume');\n    this.produces = contractEvents(options.produces ?? [], 'produce');\n  }\n}\n\nfunction contractEvents(\n  items: readonly (Catalog | CatalogDeclaration)[],\n  role: CatalogRole,\n): ContractEvent[] {\n  return items.flatMap((item) => {\n    const declaration = isDeclaration(item)\n      ? item\n      : role === 'consume'\n        ? consume(item)\n        : produce(item);\n    const name = describeCatalog(declaration.catalog).name ?? 'catalog';\n    if (declaration.role !== role) {\n      throw new ConfigurationError(\n        `RelayBusModule.forFeature ${role}s takes catalogs and ${role}(...) declarations, ` +\n          `received ${declaration.role}(${name})`,\n      );\n    }\n    return declaration.entries.map((entry) => ({\n      label: `${name}.${entry.name}`,\n      type: entry.eventClass.type,\n    }));\n  });\n}\n\nfunction isDeclaration(item: Catalog | CatalogDeclaration): item is CatalogDeclaration {\n  return typeof item['role'] === 'string' && Array.isArray(item['entries']);\n}\n","import { ConfigurationError, type RelayBus } from '@relaybus/core';\n\n/**\n * Buses of the applications that are running in this process, so `@RelayBusTransaction()` finds\n * its bus without the class injecting it. A module registers its bus when it initialises and\n * removes it after the application shut down.\n */\nconst runningBuses = new Set<RelayBus>();\n\n/** Provider instances of a running application with the bus of that application. */\nconst busOfInstance = new WeakMap<object, RelayBus>();\n\nexport function registerBus(bus: RelayBus): void {\n  runningBuses.add(bus);\n}\n\nexport function unregisterBus(bus: RelayBus): void {\n  runningBuses.delete(bus);\n}\n\n/** Ties a provider instance to the bus of its application, which wins when several applications run. */\nexport function bindInstance(instance: object, bus: RelayBus): void {\n  busOfInstance.set(instance, bus);\n}\n\n/**\n * The bus a `@RelayBusTransaction()` method of `instance` uses: the bus of the instance's\n * application, else the only running bus.\n *\n * @throws ConfigurationError when no RelayBusModule runs, its application was closed, or several\n * applications run and `instance` is not a provider of any of them.\n */\nexport function resolveBus(instance: unknown, method: string): RelayBus {\n  const bound =\n    typeof instance === 'object' && instance !== null ? busOfInstance.get(instance) : undefined;\n  if (bound !== undefined) {\n    if (!runningBuses.has(bound)) {\n      throw new ConfigurationError(\n        `@RelayBusTransaction() ${method} was called after its application shut down`,\n      );\n    }\n    return bound;\n  }\n  const [only, ...others] = runningBuses;\n  if (only === undefined) {\n    throw new ConfigurationError(\n      `@RelayBusTransaction() ${method} found no running RelayBusModule: import RelayBusModule.forRoot(...) ` +\n        `and call the method after the application initialised (app.init() or app.listen())`,\n    );\n  }\n  if (others.length > 0) {\n    throw new ConfigurationError(\n      `@RelayBusTransaction() ${method} cannot tell which of ${runningBuses.size} running applications ` +\n        `it belongs to; call it on a singleton provider of one of them`,\n    );\n  }\n  return only;\n}\n","import 'reflect-metadata';\nimport type { EventClass, EventEnvelope, HandlerContext, SubscribeOptions } from '@relaybus/core';\n\n/**\n * Options of {@link RelayBusConsumer}: the core {@link SubscribeOptions}, except that\n * `id` is optional and defaults to `ClassName.methodName`.\n */\nexport type RelayBusConsumerOptions = Omit<SubscribeOptions, 'id'> & {\n  /**\n   * Stable id of the handler. Deliveries are recorded under it, so renaming it\n   * (or the class or method it is derived from) orphans pending deliveries.\n   * Default: `${ClassName}.${methodName}`. Required when one method carries\n   * several `@RelayBusConsumer` decorators.\n   */\n  readonly id?: string;\n};\n\n/** What one `@RelayBusConsumer` decorator recorded on a method. */\nexport interface RelayBusConsumerMetadata {\n  readonly event: EventClass<unknown> | string;\n  readonly options: RelayBusConsumerOptions;\n}\n\n/** @deprecated Renamed to {@link RelayBusConsumerOptions}; this alias is removed in 1.0.0. */\nexport type SubscribeDecoratorOptions = RelayBusConsumerOptions;\n\n/** @deprecated Renamed to {@link RelayBusConsumerMetadata}; this alias is removed in 1.0.0. */\nexport type SubscribeMetadata = RelayBusConsumerMetadata;\n\nconst SUBSCRIBE_METADATA_KEY = Symbol.for('relaybus.nestjs.subscribe');\n\ntype HandlerMethod<TPayload> = (\n  event: EventEnvelope<TPayload>,\n  context: HandlerContext<never>,\n) => unknown;\n\ntype HandlerDecorator<TPayload> = <TMethod extends HandlerMethod<TPayload>>(\n  target: object,\n  propertyKey: string | symbol,\n  descriptor: TypedPropertyDescriptor<TMethod>,\n) => void;\n\n/**\n * Subscribes a provider method to an event class or type. The method is\n * registered with `bus.subscribe` when the module initialises, with `this`\n * bound to the provider instance, and receives `(envelope, context)`.\n *\n * The provider must be a singleton (default scope) and belong to any module of\n * the application. The decorator name differs from `@nestjs/event-emitter`'s\n * `@OnEvent` so both can be used in one application.\n *\n * ```ts\n * @Injectable()\n * export class ShippingHandlers {\n *   @RelayBusConsumer(OrderPlaced, { transactional: true })\n *   async onOrderPlaced(event: EventEnvelope<{ orderId: string }>, context: HandlerContext) {}\n * }\n * ```\n */\nexport function RelayBusConsumer<TPayload>(\n  event: EventClass<TPayload>,\n  options?: RelayBusConsumerOptions,\n): HandlerDecorator<TPayload>;\nexport function RelayBusConsumer(\n  eventType: string,\n  options?: RelayBusConsumerOptions,\n): HandlerDecorator<never>;\nexport function RelayBusConsumer(\n  event: EventClass<unknown> | string,\n  options: RelayBusConsumerOptions = {},\n): (target: object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void {\n  return (target, propertyKey) => {\n    // Keyed by (prototype, property) rather than stored on the method function, so a\n    // decorator that later replaces the method does not drop the subscription.\n    const existing =\n      (Reflect.getOwnMetadata(SUBSCRIBE_METADATA_KEY, target, propertyKey) as\n        RelayBusConsumerMetadata[] | undefined) ?? [];\n    Reflect.defineMetadata(\n      SUBSCRIBE_METADATA_KEY,\n      [...existing, { event, options }],\n      target,\n      propertyKey,\n    );\n  };\n}\n\n/**\n * @deprecated Renamed to {@link RelayBusConsumer}, which behaves identically; this alias is\n * removed in 1.0.0.\n */\nexport const Subscribe: typeof RelayBusConsumer = RelayBusConsumer;\n\n/**\n * Reads the `@RelayBusConsumer` declarations of a method, in declaration order. The\n * prototype chain is searched, so a subclass inherits the declarations of the\n * nearest ancestor that declares them.\n */\nexport function readConsumerMetadata(\n  prototype: object,\n  propertyKey: string | symbol,\n): readonly RelayBusConsumerMetadata[] {\n  return (\n    (Reflect.getMetadata(SUBSCRIBE_METADATA_KEY, prototype, propertyKey) as\n      RelayBusConsumerMetadata[] | undefined) ?? []\n  );\n}\n","import { Inject, Injectable, type OnModuleInit } from '@nestjs/common';\nimport { DiscoveryService, MetadataScanner, ModulesContainer } from '@nestjs/core';\nimport type { InstanceWrapper } from '@nestjs/core/injector/instance-wrapper.js';\nimport type { Module } from '@nestjs/core/injector/module.js';\nimport {\n  ConfigurationError,\n  RelayBus,\n  describeCatalog,\n  type CatalogEntry,\n  type EventHandler,\n} from '@relaybus/core';\nimport { readCatalogConsumerMetadata } from './relay-bus-catalog-consumer.decorator.js';\nimport { RelayBusFeatureContract } from './relay-bus-feature-contract.js';\nimport { bindInstance } from './relay-bus-registry.js';\nimport {\n  readConsumerMetadata,\n  type RelayBusConsumerMetadata,\n} from './relay-bus-consumer.decorator.js';\n\n/** What one discovery pass has registered so far. */\ntype Discovery = {\n  /** Where each handler id was registered, to report duplicates. */\n  readonly registeredBy: Map<string, string>;\n  /** Methods already registered per instance: a `useExisting` alias shows an instance twice. */\n  readonly visited: Map<object, Set<string>>;\n  readonly consumers: WeakSet<object>;\n  /** Event types the providers of each module consume, for the `forFeature` contracts. */\n  readonly consumedByModule: Map<Module | undefined, Set<string>>;\n};\n\ninterface SubscribedMethod {\n  readonly methodName: string;\n  readonly declarations: readonly RelayBusConsumerMetadata[];\n}\n\n/**\n * Finds every `@RelayBusConsumer` method and every `@RelayBusCatalogConsumer` class among the\n * singleton providers of the application and registers them on the bus before\n * the bus starts. Providers that are request-scoped or transient, directly or\n * through a dependency, and use either decorator fail the boot. A request-scoped provider whose\n * token is neither a class nor an instance carrying the decorated prototype\n * (for example a string-token factory) cannot be inspected and is skipped.\n */\n@Injectable()\nexport class RelayBusHandlerExplorer implements OnModuleInit {\n  constructor(\n    @Inject(DiscoveryService) private readonly discovery: DiscoveryService,\n    @Inject(MetadataScanner) private readonly metadataScanner: MetadataScanner,\n    @Inject(RelayBus) private readonly bus: RelayBus,\n    @Inject(ModulesContainer) private readonly modules: ModulesContainer,\n  ) {}\n\n  onModuleInit(): void {\n    const discovery: Discovery = {\n      registeredBy: new Map<string, string>(),\n      visited: new Map<object, Set<string>>(),\n      consumers: new WeakSet<object>(),\n      consumedByModule: new Map<Module | undefined, Set<string>>(),\n    };\n    for (const wrapper of this.discovery.getProviders()) {\n      this.registerProvider(wrapper, discovery);\n    }\n    this.assertModuleContracts(discovery.consumedByModule);\n  }\n\n  /** Checks the `RelayBusModule.forFeature` contract of every module that imports one. */\n  private assertModuleContracts(consumedByModule: Map<Module | undefined, Set<string>>): void {\n    const routed = new Set(\n      this.bus\n        .handlers()\n        .filter((handler) => handler.forwardsToTransport)\n        .map((handler) => handler.eventType),\n    );\n    const violations: string[] = [];\n    for (const wrapper of this.discovery.getProviders()) {\n      const contract = wrapper.instance as unknown;\n      if (!(contract instanceof RelayBusFeatureContract)) {\n        continue;\n      }\n      for (const module of this.importersOf(wrapper.host)) {\n        // Every module has a set: Nest registers the module class as one of its providers.\n        const consumed = consumedByModule.get(module)!;\n        for (const event of contract.consumes.filter(({ type }) => !consumed.has(type))) {\n          violations.push(`${module.name}: ${event.label} (${event.type}) has no consumer`);\n        }\n        for (const event of contract.produces.filter(({ type }) => !routed.has(type))) {\n          violations.push(\n            `${module.name}: ${event.label} (${event.type}) has no route to a transport`,\n          );\n        }\n      }\n    }\n    if (violations.length > 0) {\n      throw new ConfigurationError(\n        `[RelayBusHandlerExplorer](assertModuleContracts) ${violations.join('; ')}`,\n      );\n    }\n  }\n\n  private importersOf(contractModule: Module | undefined): Module[] {\n    // A provider always has a host module; `has(undefined)` is false for the type's sake.\n    return [...this.modules.values()].filter((module) => module.imports.has(contractModule!));\n  }\n\n  /** Records the event types the provider of `wrapper` consumes under the provider's module. */\n  private recordConsumedTypes(\n    wrapper: InstanceWrapper,\n    { instance, discovery }: { readonly instance: object; readonly discovery: Discovery },\n  ): void {\n    const types = discovery.consumedByModule.get(wrapper.host) ?? new Set<string>();\n    discovery.consumedByModule.set(wrapper.host, types);\n    const lookup = instance as Record<string, unknown>;\n    for (const { declarations } of this.subscribedMethods(\n      Object.getPrototypeOf(instance) as object,\n    )) {\n      for (const { event } of declarations) {\n        types.add(typeof event === 'string' ? event : event.type);\n      }\n    }\n    for (const { catalog, selectedEntries } of readCatalogConsumerMetadata(instance.constructor)) {\n      const entries =\n        selectedEntries ??\n        describeCatalog(catalog).entries.filter((entry) => isMethod(lookup, entry));\n      for (const entry of entries) {\n        types.add(entry.eventClass.type);\n      }\n    }\n  }\n\n  private registerProvider(wrapper: InstanceWrapper, discovery: Discovery): void {\n    if (wrapper.isTransient || !wrapper.isDependencyTreeStatic()) {\n      this.assertNoHandlers(wrapper);\n      return;\n    }\n    const instance = wrapper.instance as unknown;\n    if (typeof instance !== 'object' || instance === null) {\n      return;\n    }\n    const prototype = Object.getPrototypeOf(instance) as object | null;\n    if (prototype === null) {\n      return;\n    }\n    bindInstance(instance, this.bus);\n    this.recordConsumedTypes(wrapper, { instance, discovery });\n    const className = instance.constructor.name;\n    for (const subscribed of this.subscribedMethods(prototype)) {\n      this.registerSubscribedMethod(instance, { subscribedMethod: subscribed, discovery });\n    }\n    if (!discovery.consumers.has(instance)) {\n      discovery.consumers.add(instance);\n      this.registerEventConsumers(instance, { className, registeredBy: discovery.registeredBy });\n    }\n  }\n\n  private registerSubscribedMethod(\n    instance: object,\n    {\n      subscribedMethod: { methodName, declarations },\n      discovery: { registeredBy, visited },\n    }: { readonly subscribedMethod: SubscribedMethod; readonly discovery: Discovery },\n  ): void {\n    // A `useExisting` alias exposes the same instance under another token.\n    const seen = visited.get(instance) ?? new Set<string>();\n    visited.set(instance, seen);\n    if (seen.has(methodName)) {\n      return;\n    }\n    seen.add(methodName);\n    const method = (instance as Record<string, unknown>)[methodName] as (\n      ...args: Parameters<EventHandler>\n    ) => unknown;\n    const location = `${instance.constructor.name}.${methodName}`;\n    for (const { event, options } of declarations) {\n      const id = options.id ?? location;\n      const previous = registeredBy.get(id);\n      if (previous !== undefined) {\n        throw new ConfigurationError(\n          `Handler id '${id}' is used by both ${previous} and ${location}; ` +\n            `pass a unique { id } to @RelayBusConsumer`,\n        );\n      }\n      registeredBy.set(id, location);\n      // Core resolves both classes and type strings; the overloads cannot express the union.\n      this.bus.subscribe(\n        event as never,\n        (envelope, context) => method.call(instance, envelope, context),\n        { ...options, id },\n      );\n    }\n  }\n\n  private registerEventConsumers(\n    instance: object,\n    {\n      className,\n      registeredBy,\n    }: { readonly className: string; readonly registeredBy: Map<string, string> },\n  ): void {\n    const lookup = instance as Record<string, unknown>;\n    for (const { catalog, options, selectedEntries } of readCatalogConsumerMetadata(\n      instance.constructor,\n    )) {\n      const { name, entries } = describeCatalog(catalog);\n      const label = name ?? 'catalog';\n      const handlers = this.catalogHandlers(lookup, {\n        className,\n        label,\n        entries,\n        selected: selectedEntries,\n      });\n      for (const entry of handlers) {\n        const id = `${className}.${entry.handlerName}`;\n        const previous = registeredBy.get(id);\n        if (previous !== undefined) {\n          throw new ConfigurationError(\n            `Handler id '${id}' of @RelayBusCatalogConsumer(${label}) is already used by ${previous}; ` +\n              `give the @RelayBusConsumer a unique { id } or drop it`,\n          );\n        }\n        registeredBy.set(id, `${className}.${entry.handlerName}`);\n        const method = lookup[entry.handlerName] as (...args: Parameters<EventHandler>) => unknown;\n        this.bus.subscribe(\n          entry.eventClass as never,\n          (envelope, context) => method.call(instance, envelope, context),\n          { ...options, id },\n        );\n      }\n    }\n  }\n\n  /** The catalog entries `lookup` handles: the selected ones, else every entry it has a method for. */\n  private catalogHandlers(\n    lookup: Record<string, unknown>,\n    {\n      className,\n      label,\n      entries,\n      selected,\n    }: {\n      readonly className: string;\n      readonly label: string;\n      readonly entries: readonly CatalogEntry[];\n      readonly selected: readonly CatalogEntry[] | undefined;\n    },\n  ): readonly CatalogEntry[] {\n    const handlers = selected ?? entries.filter((entry) => isMethod(lookup, entry));\n    const missing = handlers.filter((entry) => !isMethod(lookup, entry));\n    if (missing.length > 0) {\n      throw new ConfigurationError(\n        `${className} uses @RelayBusCatalogConsumer(${label}) but lacks the handler methods of events ` +\n          `it consumes: ${missing.map((entry) => entry.handlerName).join(', ')}`,\n      );\n    }\n    if (handlers.length === 0) {\n      throw new ConfigurationError(\n        `${className} uses @RelayBusCatalogConsumer(${label}) but defines none of its handler ` +\n          `methods (${entries.map((entry) => entry.handlerName).join(', ')})`,\n      );\n    }\n    return handlers;\n  }\n\n  private subscribedMethods(prototype: object): SubscribedMethod[] {\n    const methods: SubscribedMethod[] = [];\n    for (const methodName of this.metadataScanner.getAllMethodNames(prototype)) {\n      const declarations = readConsumerMetadata(prototype, methodName);\n      if (declarations.length > 0) {\n        methods.push({ methodName, declarations });\n      }\n    }\n    return methods;\n  }\n\n  /**\n   * Request-scoped and transient wrappers have no usable instance (a factory\n   * wrapper has none at all), so the decorated prototype is taken from the\n   * provider class, or from the provider token for factories when it is a class.\n   */\n  private assertNoHandlers(wrapper: InstanceWrapper): void {\n    const type = (wrapper.isFactory ? wrapper.token : wrapper.metatype) as unknown;\n    if (typeof type === 'function' && readCatalogConsumerMetadata(type).length > 0) {\n      throw new ConfigurationError(\n        `${type.name} uses @RelayBusCatalogConsumer but its provider is request-scoped or transient ` +\n          `(directly or through a dependency); handlers must be singleton providers`,\n      );\n    }\n    const prototype = typeof type === 'function' ? (type.prototype as object) : null;\n    const [first] = prototype === null ? [] : this.subscribedMethods(prototype);\n    if (first !== undefined) {\n      throw new ConfigurationError(\n        `${(prototype as { constructor: { name: string } }).constructor.name}.${first.methodName} ` +\n          `uses @RelayBusConsumer but its provider is request-scoped or transient ` +\n          `(directly or through a dependency); handlers must be singleton providers`,\n      );\n    }\n  }\n}\n\nfunction isMethod(instance: Record<string, unknown>, entry: CatalogEntry): boolean {\n  return typeof instance[entry.handlerName] === 'function';\n}\n","import { ConfigurableModuleBuilder } from '@nestjs/common';\nimport type { RelayBusOptions } from '@relaybus/core';\n\n/**\n * Options of {@link RelayBusModule}: everything {@link RelayBusOptions} accepts\n * except `logger`, which is always a Nest `Logger` with context `RelayBus`\n * (configure it with `app.useLogger`). Only `store` is required.\n */\nexport type RelayBusModuleOptions<TTransaction = unknown> = Omit<\n  RelayBusOptions<TTransaction>,\n  'logger'\n>;\n\n/** Module-level extras accepted next to the options by `forRoot` and `forRootAsync`. */\nexport interface RelayBusModuleExtras {\n  /** Make `RelayBus` and `RelayBusHealth` injectable everywhere. Default true. */\n  readonly isGlobal?: boolean;\n}\n\n/** Implemented by classes passed as `useClass` / `useExisting` to `forRootAsync`. */\nexport interface RelayBusModuleOptionsFactory {\n  create(): Promise<RelayBusModuleOptions> | RelayBusModuleOptions;\n}\n\nexport const {\n  ConfigurableModuleClass: RelayBusConfigurableModule,\n  MODULE_OPTIONS_TOKEN: RELAYBUS_MODULE_OPTIONS,\n} = new ConfigurableModuleBuilder<RelayBusModuleOptions>()\n  .setClassMethodName('forRoot')\n  .setExtras<RelayBusModuleExtras>({ isGlobal: true }, (definition, extras) => ({\n    ...definition,\n    global: extras.isGlobal === true,\n  }))\n  .build();\n","import { Inject, Injectable } from '@nestjs/common';\nimport { RelayBus, systemClock, type EventStoreStatistics } from '@relaybus/core';\nimport { RELAYBUS_MODULE_OPTIONS, type RelayBusModuleOptions } from './module-options.js';\n\n/** Result of {@link RelayBusHealth.check}. */\nexport interface RelayBusHealthReport {\n  /**\n   * `down` when the bus is not running, a transport reports itself not ready\n   * (dead Kafka consumer, disconnected RabbitMQ) or the store cannot be queried.\n   */\n  readonly status: 'up' | 'down';\n  readonly running: boolean;\n  /** `bus.isReady()`: running and every transport ready. */\n  readonly ready: boolean;\n  /** Number of registered handlers and routes. */\n  readonly handlers: number;\n  /** Delivery counts; absent when the bus is not running or the store failed. */\n  readonly statistics?: EventStoreStatistics;\n  /** Milliseconds the oldest due delivery has waited; 0 when nothing is due. */\n  readonly lagMilliseconds?: number;\n  /** Message of the store error, when the statistics query failed. */\n  readonly error?: string;\n}\n\n/**\n * Health probe of the bus without a dependency on `@nestjs/terminus`. Wrap\n * {@link check} in a terminus indicator (see the README). The lag is measured\n * with the `clock` given to the module options (the system clock by default),\n * the same clock the bus uses.\n */\n@Injectable()\nexport class RelayBusHealth {\n  constructor(\n    @Inject(RelayBus) private readonly bus: RelayBus,\n    @Inject(RELAYBUS_MODULE_OPTIONS) private readonly options: RelayBusModuleOptions,\n  ) {}\n\n  async check(): Promise<RelayBusHealthReport> {\n    const running = this.bus.isRunning;\n    const ready = this.bus.isReady();\n    const handlers = this.bus.handlers().length;\n    if (!running) {\n      return { status: 'down', running, ready, handlers };\n    }\n    try {\n      const statistics = await this.bus.statistics();\n      const clock = this.options.clock ?? systemClock;\n      const lagMilliseconds =\n        statistics.oldestDueAt === null\n          ? 0\n          : Math.max(0, clock.now().getTime() - statistics.oldestDueAt.getTime());\n      return {\n        status: ready ? 'up' : 'down',\n        running,\n        ready,\n        handlers,\n        statistics,\n        lagMilliseconds,\n      };\n    } catch (error) {\n      return {\n        status: 'down',\n        running,\n        ready,\n        handlers,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n","import {\n  Inject,\n  Injectable,\n  type BeforeApplicationShutdown,\n  type OnApplicationBootstrap,\n  type OnApplicationShutdown,\n  type OnModuleInit,\n} from '@nestjs/common';\nimport { RelayBus } from '@relaybus/core';\nimport { registerBus, unregisterBus } from './relay-bus-registry.js';\n\n/**\n * Starts the bus once every handler is registered and the application has\n * bootstrapped, and stops it (draining running handlers, within `dispatcher.shutdownTimeout`) on\n * shutdown: `bus.stop()` resolves at that deadline at the latest, so a hung query or broker cannot\n * hold `app.close()` until the platform kills the process. A start\n * failure rejects the hook, so the application does not boot. `@RelayBusTransaction()`\n * methods find the bus from module initialisation until the application has shut down.\n */\n@Injectable()\nexport class RelayBusLifecycle\n  implements OnModuleInit, OnApplicationBootstrap, BeforeApplicationShutdown, OnApplicationShutdown\n{\n  constructor(@Inject(RelayBus) private readonly bus: RelayBus) {}\n\n  onModuleInit(): void {\n    registerBus(this.bus);\n  }\n\n  async onApplicationBootstrap(): Promise<void> {\n    await this.bus.start();\n  }\n\n  async beforeApplicationShutdown(): Promise<void> {\n    await this.bus.stop();\n  }\n\n  /** After the bus stopped, so handlers still draining at shutdown can open transactions. */\n  onApplicationShutdown(): void {\n    unregisterBus(this.bus);\n  }\n}\n","import { Module } from '@nestjs/common';\n\n/**\n * Carries the contract of `RelayBusModule.forFeature(...)` into the module that imports it. The\n * contract is checked against that module's providers when the application initialises.\n */\n@Module({})\nexport class RelayBusFeatureModule {}\n","import { Inject, Injectable } from '@nestjs/common';\nimport { RelayBus, TransactionRequiredError } from '@relaybus/core';\n\n/**\n * Hands repositories the transaction of the enclosing `@RelayBusTransaction()` method (or\n * `bus.transaction`, transactional handler, `transactionResolver`), typed as the store's\n * transaction handle: `PoolClient` for `pg`, a Kysely `Transaction`, a TypeORM `EntityManager`,\n * a Prisma transaction client, a MongoDB `ClientSession`.\n *\n * ```ts\n * @Injectable()\n * export class OrderRepository {\n *   constructor(private readonly transactions: RelayBusTransactionHost<PoolClient>) {}\n *\n *   async insert(orderId: string): Promise<void> {\n *     await this.transactions.current().query('INSERT INTO orders (id) VALUES ($1)', [orderId]);\n *   }\n * }\n * ```\n */\n@Injectable()\nexport class RelayBusTransactionHost<TTransaction = unknown> {\n  constructor(@Inject(RelayBus) private readonly bus: RelayBus<TTransaction>) {}\n\n  /**\n   * The active transaction.\n   *\n   * @throws TransactionRequiredError when the caller runs outside every transaction.\n   */\n  current(): TTransaction {\n    const transaction = this.bus.currentTransaction();\n    if (transaction === undefined) {\n      throw new TransactionRequiredError(\n        'No relaybus transaction is active: call the repository from a @RelayBusTransaction() method or inside bus.transaction()',\n      );\n    }\n    return transaction;\n  }\n\n  /** The active transaction, or undefined outside every transaction. */\n  find(): TTransaction | undefined {\n    return this.bus.currentTransaction();\n  }\n}\n","import { Logger, Module, type DynamicModule } from '@nestjs/common';\nimport { DiscoveryModule } from '@nestjs/core';\nimport { RelayBus } from '@relaybus/core';\nimport { RelayBusHandlerExplorer } from './handler-explorer.js';\nimport {\n  RELAYBUS_MODULE_OPTIONS,\n  RelayBusConfigurableModule,\n  type RelayBusModuleOptions,\n} from './module-options.js';\nimport {\n  RelayBusFeatureContract,\n  type RelayBusFeatureOptions,\n} from './relay-bus-feature-contract.js';\nimport { RelayBusFeatureModule } from './relay-bus-feature.module.js';\nimport { RelayBusHealth } from './relay-bus-health.js';\nimport { RelayBusLifecycle } from './relay-bus-lifecycle.js';\nimport { RelayBusTransactionHost } from './relay-bus-transaction-host.js';\n\n/**\n * Registers one {@link RelayBus} for the application, discovers `@RelayBusConsumer` and `@RelayBusCatalogConsumer`\n * handlers in every module, runs `@RelayBusTransaction()` methods on the bus, starts the bus after bootstrap and stops it on\n * shutdown. Global unless `isGlobal: false`.\n *\n * ```ts\n * RelayBusModule.forRoot({ store: new PostgresEventStore({ pool }), source: 'orders' })\n * ```\n */\n@Module({\n  imports: [DiscoveryModule],\n  providers: [\n    {\n      provide: RelayBus,\n      inject: [RELAYBUS_MODULE_OPTIONS],\n      useFactory: (options: RelayBusModuleOptions) =>\n        new RelayBus({ ...options, logger: new Logger('RelayBus') }),\n    },\n    RelayBusHandlerExplorer,\n    RelayBusLifecycle,\n    RelayBusHealth,\n    RelayBusTransactionHost,\n  ],\n  exports: [RelayBus, RelayBusHealth, RelayBusTransactionHost],\n})\nexport class RelayBusModule extends RelayBusConfigurableModule {\n  /**\n   * The relaybus contract of a feature module: import it in the module whose providers consume\n   * and produce the events. When the application initialises, every consumed event needs a\n   * `@RelayBusConsumer` method (or a `@RelayBusCatalogConsumer` class) among the providers of\n   * that module, spread over any classes and method names, and every produced event needs a\n   * route to a transport; otherwise the application fails to start naming the module and each\n   * missing event. Needs `RelayBusModule.forRoot` in the application.\n   *\n   * ```ts\n   * @Module({\n   *   imports: [RelayBusModule.forFeature({ consumes: [OrderEvents], produces: [produce(BillingEvents)] })],\n   *   providers: [OrderPlacedHandlers, OrderCancelledHandlers],\n   * })\n   * export class BillingModule {}\n   * ```\n   *\n   * @throws ConfigurationError for a `produce(...)` in `consumes` or a `consume(...)` in `produces`.\n   */\n  static forFeature(options: RelayBusFeatureOptions): DynamicModule {\n    return {\n      module: RelayBusFeatureModule,\n      providers: [\n        { provide: RelayBusFeatureContract, useValue: new RelayBusFeatureContract(options) },\n      ],\n    };\n  }\n}\n","import 'reflect-metadata';\nimport { resolveBus } from './relay-bus-registry.js';\n\n/** The compile error a `@RelayBusTransaction()` on a method that does not return a Promise reads. */\nexport type RelayBusTransactionNeedsAsyncMethod =\n  '@RelayBusTransaction() needs a method that returns a Promise: make the method async';\n\n/**\n * Accepts the descriptor of a method that returns a Promise; any other method fails to compile\n * with {@link RelayBusTransactionNeedsAsyncMethod} in the message.\n */\nexport type AsyncMethodDescriptor<TMethod> = TypedPropertyDescriptor<TMethod> &\n  (TMethod extends (...args: never[]) => PromiseLike<unknown>\n    ? unknown\n    : RelayBusTransactionNeedsAsyncMethod);\n\n/** What `@RelayBusTransaction()` returns: a method decorator for async methods only. */\nexport type RelayBusTransactionDecorator = <TMethod extends (...args: never[]) => unknown>(\n  target: object,\n  propertyKey: string | symbol,\n  descriptor: AsyncMethodDescriptor<TMethod>,\n) => void;\n\ntype AsyncMethod = (this: unknown, ...args: unknown[]) => Promise<unknown>;\n\n/**\n * Runs the method in a relaybus transaction: `bus.publish(...)` inside it, and in everything it\n * awaits, joins the transaction without passing `{ transaction }`, and a repository reads it with\n * `bus.currentTransaction()` or {@link RelayBusTransactionHost}. The transaction commits when the\n * method resolves and rolls back when it rejects; it is held to the bus `transactionTimeout`.\n *\n * - The method itself is replaced, so `this.other()` calls of decorated methods are transactional\n *   too, unlike interceptor-based decorators.\n * - A decorated method called while a transaction is active (another decorated method,\n *   `bus.transaction`, a transactional handler, or the `transactionResolver`, for example\n *   `@nestjs-cls/transactional`) joins it instead of opening a second one.\n * - The bus is the one of the application's `RelayBusModule`; the class does not inject it.\n * - Only methods that return a Promise compile.\n *\n * ```ts\n * @Injectable()\n * export class OrderService {\n *   @RelayBusTransaction()\n *   async place(orderId: string): Promise<void> {\n *     await this.orders.insert(orderId);\n *     await this.bus.publish(new OrderPlaced({ orderId }));\n *   }\n * }\n * ```\n */\nexport function RelayBusTransaction(): RelayBusTransactionDecorator {\n  // eslint-disable-next-line relaybus/max-two-params -- TypeScript calls a method decorator with three arguments\n  return (target, propertyKey, descriptor) => {\n    const original = descriptor.value as unknown as AsyncMethod;\n    const label = `${target.constructor.name}.${String(propertyKey)}`;\n    const transactional: AsyncMethod = async function (this: unknown, ...args: unknown[]) {\n      const bus = resolveBus(this, label);\n      if (bus.currentTransaction() !== undefined) {\n        return original.apply(this, args);\n      }\n      return bus.transaction(() => original.apply(this, args));\n    };\n    Object.defineProperty(transactional, 'name', { value: original.name });\n    // Decorators applied before this one (route, guard, interceptor metadata) keep their metadata.\n    for (const key of Reflect.getOwnMetadataKeys(original)) {\n      Reflect.defineMetadata(key, Reflect.getOwnMetadata(key, original), transactional);\n    }\n    descriptor.value = transactional as never;\n  };\n}\n"]}

package/dist/index.d.cts

@@ -1,17 +1,17 @@
-import { Catalog, SubscribeOptions, EventOf, HandlerContext, CatalogEventSelection, CatalogEntry, RelayBus, RelayBusOptions, EventStoreStatistics, EventClass, EventEnvelope } from '@relaybus/core';
+import { Catalog, SubscribeOptions, EventOf, HandlerContext, CatalogEventSelection, CatalogEntry, RelayBus, RelayBusOptions, EventStoreStatistics, CatalogDeclaration, EventClass, EventEnvelope } from '@relaybus/core';
 export { RelayBus } from '@relaybus/core';
 import * as _nestjs_common from '@nestjs/common';
-import { OnModuleInit, OnApplicationBootstrap, BeforeApplicationShutdown } from '@nestjs/common';
-import { DiscoveryService, MetadataScanner } from '@nestjs/core';
+import { OnModuleInit, OnApplicationBootstrap, BeforeApplicationShutdown, OnApplicationShutdown, DynamicModule } from '@nestjs/common';
+import { DiscoveryService, MetadataScanner, ModulesContainer } from '@nestjs/core';
 
 /**
- * Options of {@link EventConsumer}: the core {@link SubscribeOptions} applied to
+ * Options of {@link RelayBusCatalogConsumer}: the core {@link SubscribeOptions} applied to
  * every handler of the class, except `id`, which is always
  * `${ClassName}.on${EventName}`, and optionally the events the class consumes.
  */
-type EventConsumerOptions<TCatalog extends Catalog = Catalog, TName extends keyof TCatalog = keyof TCatalog> = Omit<SubscribeOptions, 'id'> & CatalogEventSelection<TName>;
-/** What one `@EventConsumer` decorator recorded on a class. */
-interface EventConsumerMetadata {
+type RelayBusCatalogConsumerOptions<TCatalog extends Catalog = Catalog, TName extends keyof TCatalog = keyof TCatalog> = Omit<SubscribeOptions, 'id'> & CatalogEventSelection<TName>;
+/** What one `@RelayBusCatalogConsumer` decorator recorded on a class. */
+interface RelayBusCatalogConsumerMetadata {
     readonly catalog: Catalog;
     /** Subscribe options applied to every handler of the class. */
     readonly options: Omit<SubscribeOptions, 'id'>;
@@ -26,7 +26,7 @@ interface EventConsumerMetadata {
  * events. The event parameter is checked strictly; the context is typed
  * `HandlerContext<never>` so a method may declare any transaction type.
  */
-type EventConsumerClass<TCatalog extends Catalog, TName extends keyof TCatalog> = abstract new (...args: never[]) => {
+type RelayBusCatalogConsumerClass<TCatalog extends Catalog, TName extends keyof TCatalog> = abstract new (...args: never[]) => {
     readonly [TKey in TName & string as `on${TKey}`]: (event: EventOf<TCatalog[TKey]>, context: HandlerContext<never>) => unknown;
 };
 /**
@@ -45,35 +45,46 @@ type EventConsumerClass<TCatalog extends Catalog, TName extends keyof TCatalog>
  *
  * `catalogs: [consume(Catalog, { events })]` in the module options makes the
  * application fail to boot if no provider handles a consumed event. Works next
- * to `@Subscribe` in the same class (give a method that carries both a
- * distinct `@Subscribe` id). The provider must be a singleton. Declarations
+ * to `@RelayBusConsumer` in the same class (give a method that carries both a
+ * distinct `@RelayBusConsumer` id). The provider must be a singleton. Declarations
  * are inherited; a subclass that declares the same catalog again replaces the
  * inherited declaration of that catalog, and declaring one catalog twice on
  * the same class throws a {@link ConfigurationError}.
  *
  * ```ts
  * @Injectable()
- * @EventConsumer(OrderEvents, { events: ['OrderPlaced'], transactional: true })
+ * @RelayBusCatalogConsumer(OrderEvents, { events: ['OrderPlaced'], transactional: true })
  * export class BillingHandlers {
  *   onOrderPlaced(event: EventOf<typeof OrderPlaced>) {}
  * }
  * ```
  */
-declare function EventConsumer<TCatalog extends Catalog>(catalog: TCatalog, options?: Omit<SubscribeOptions, 'id'> & {
+declare function RelayBusCatalogConsumer<TCatalog extends Catalog>(catalog: TCatalog, options?: Omit<SubscribeOptions, 'id'> & {
     readonly events?: undefined;
 }): ClassDecorator;
-declare function EventConsumer<TCatalog extends Catalog, const TName extends keyof TCatalog>(catalog: TCatalog, options: Omit<SubscribeOptions, 'id'> & {
+declare function RelayBusCatalogConsumer<TCatalog extends Catalog, const TName extends keyof TCatalog>(catalog: TCatalog, options: Omit<SubscribeOptions, 'id'> & {
     readonly events: readonly TName[];
-}): (target: EventConsumerClass<TCatalog, TName>) => void;
+}): (target: RelayBusCatalogConsumerClass<TCatalog, TName>) => void;
 /**
  * With options whose `events` are not statically known (a variable typed
- * {@link EventConsumerOptions}), the selection is checked when the module
+ * {@link RelayBusCatalogConsumerOptions}), the selection is checked when the module
  * initialises instead of at compile time.
  */
-declare function EventConsumer<TCatalog extends Catalog>(catalog: TCatalog, options: EventConsumerOptions<TCatalog>): ClassDecorator;
+declare function RelayBusCatalogConsumer<TCatalog extends Catalog>(catalog: TCatalog, options: RelayBusCatalogConsumerOptions<TCatalog>): ClassDecorator;
+/**
+ * @deprecated Renamed to {@link RelayBusCatalogConsumer}, which behaves identically; this alias is
+ * removed in 1.0.0.
+ */
+declare const EventConsumer: typeof RelayBusCatalogConsumer;
+/** @deprecated Renamed to {@link RelayBusCatalogConsumerOptions}; this alias is removed in 1.0.0. */
+type EventConsumerOptions<TCatalog extends Catalog = Catalog, TName extends keyof TCatalog = keyof TCatalog> = RelayBusCatalogConsumerOptions<TCatalog, TName>;
+/** @deprecated Renamed to {@link RelayBusCatalogConsumerMetadata}; this alias is removed in 1.0.0. */
+type EventConsumerMetadata = RelayBusCatalogConsumerMetadata;
+/** @deprecated Renamed to {@link RelayBusCatalogConsumerClass}; this alias is removed in 1.0.0. */
+type EventConsumerClass<TCatalog extends Catalog, TName extends keyof TCatalog> = RelayBusCatalogConsumerClass<TCatalog, TName>;
 
 /**
- * Finds every `@Subscribe` method and every `@EventConsumer` class among the
+ * Finds every `@RelayBusConsumer` method and every `@RelayBusCatalogConsumer` class among the
  * singleton providers of the application and registers them on the bus before
  * the bus starts. Providers that are request-scoped or transient, directly or
  * through a dependency, and use either decorator fail the boot. A request-scoped provider whose
@@ -84,9 +95,19 @@ declare class RelayBusHandlerExplorer implements OnModuleInit {
     private readonly discovery;
     private readonly metadataScanner;
     private readonly bus;
-    constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner, bus: RelayBus);
+    private readonly modules;
+    constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner, bus: RelayBus, modules: ModulesContainer);
     onModuleInit(): void;
+    /** Checks the `RelayBusModule.forFeature` contract of every module that imports one. */
+    private assertModuleContracts;
+    private importersOf;
+    /** Records the event types the provider of `wrapper` consumes under the provider's module. */
+    private recordConsumedTypes;
+    private registerProvider;
+    private registerSubscribedMethod;
     private registerEventConsumers;
+    /** The catalog entries `lookup` handles: the selected ones, else every entry it has a method for. */
+    private catalogHandlers;
     private subscribedMethods;
     /**
      * Request-scoped and transient wrappers have no usable instance (a factory
@@ -147,19 +168,52 @@ declare class RelayBusHealth {
 
 /**
  * Starts the bus once every handler is registered and the application has
- * bootstrapped, and stops it (draining running handlers) on shutdown. A start
- * failure rejects the hook, so the application does not boot.
+ * bootstrapped, and stops it (draining running handlers, within `dispatcher.shutdownTimeout`) on
+ * shutdown: `bus.stop()` resolves at that deadline at the latest, so a hung query or broker cannot
+ * hold `app.close()` until the platform kills the process. A start
+ * failure rejects the hook, so the application does not boot. `@RelayBusTransaction()`
+ * methods find the bus from module initialisation until the application has shut down.
  */
-declare class RelayBusLifecycle implements OnApplicationBootstrap, BeforeApplicationShutdown {
+declare class RelayBusLifecycle implements OnModuleInit, OnApplicationBootstrap, BeforeApplicationShutdown, OnApplicationShutdown {
     private readonly bus;
     constructor(bus: RelayBus);
+    onModuleInit(): void;
     onApplicationBootstrap(): Promise<void>;
     beforeApplicationShutdown(): Promise<void>;
+    /** After the bus stopped, so handlers still draining at shutdown can open transactions. */
+    onApplicationShutdown(): void;
+}
+
+/**
+ * What one feature module consumes and produces, given to `RelayBusModule.forFeature`. Each item is
+ * a whole catalog or a `consume(...)` / `produce(...)` declaration of some of its events.
+ */
+interface RelayBusFeatureOptions {
+    /** Events the importing module handles: each needs a `@RelayBusConsumer` method (or a catalog consumer) among its providers. */
+    readonly consumes?: readonly (Catalog | CatalogDeclaration)[];
+    /** Events the importing module publishes for other services: each needs a route to a transport. */
+    readonly produces?: readonly (Catalog | CatalogDeclaration)[];
+}
+/** One event of a feature contract, named for error messages. */
+type ContractEvent = {
+    /** `Catalog.EventName`. */
+    readonly label: string;
+    readonly type: string;
+};
+/**
+ * The contract of the module that imports `RelayBusModule.forFeature(...)`, checked when the
+ * application initialises.
+ */
+declare class RelayBusFeatureContract {
+    readonly consumes: readonly ContractEvent[];
+    readonly produces: readonly ContractEvent[];
+    /** @throws ConfigurationError for a `produce(...)` in `consumes`, a `consume(...)` in `produces`, or something that is not a catalog. */
+    constructor(options: RelayBusFeatureOptions);
 }
 
 /**
- * Registers one {@link RelayBus} for the application, discovers `@Subscribe`
- * handlers in every module, starts the bus after bootstrap and stops it on
+ * Registers one {@link RelayBus} for the application, discovers `@RelayBusConsumer` and `@RelayBusCatalogConsumer`
+ * handlers in every module, runs `@RelayBusTransaction()` methods on the bus, starts the bus after bootstrap and stops it on
  * shutdown. Global unless `isGlobal: false`.
  *
  * ```ts
@@ -167,28 +221,124 @@ declare class RelayBusLifecycle implements OnApplicationBootstrap, BeforeApplica
  * ```
  */
 declare class RelayBusModule extends RelayBusConfigurableModule {
+    /**
+     * The relaybus contract of a feature module: import it in the module whose providers consume
+     * and produce the events. When the application initialises, every consumed event needs a
+     * `@RelayBusConsumer` method (or a `@RelayBusCatalogConsumer` class) among the providers of
+     * that module, spread over any classes and method names, and every produced event needs a
+     * route to a transport; otherwise the application fails to start naming the module and each
+     * missing event. Needs `RelayBusModule.forRoot` in the application.
+     *
+     * ```ts
+     * @Module({
+     *   imports: [RelayBusModule.forFeature({ consumes: [OrderEvents], produces: [produce(BillingEvents)] })],
+     *   providers: [OrderPlacedHandlers, OrderCancelledHandlers],
+     * })
+     * export class BillingModule {}
+     * ```
+     *
+     * @throws ConfigurationError for a `produce(...)` in `consumes` or a `consume(...)` in `produces`.
+     */
+    static forFeature(options: RelayBusFeatureOptions): DynamicModule;
+}
+
+/**
+ * Carries the contract of `RelayBusModule.forFeature(...)` into the module that imports it. The
+ * contract is checked against that module's providers when the application initialises.
+ */
+declare class RelayBusFeatureModule {
 }
 
 /**
- * Options of {@link Subscribe}: the core {@link SubscribeOptions}, except that
+ * Hands repositories the transaction of the enclosing `@RelayBusTransaction()` method (or
+ * `bus.transaction`, transactional handler, `transactionResolver`), typed as the store's
+ * transaction handle: `PoolClient` for `pg`, a Kysely `Transaction`, a TypeORM `EntityManager`,
+ * a Prisma transaction client, a MongoDB `ClientSession`.
+ *
+ * ```ts
+ * @Injectable()
+ * export class OrderRepository {
+ *   constructor(private readonly transactions: RelayBusTransactionHost<PoolClient>) {}
+ *
+ *   async insert(orderId: string): Promise<void> {
+ *     await this.transactions.current().query('INSERT INTO orders (id) VALUES ($1)', [orderId]);
+ *   }
+ * }
+ * ```
+ */
+declare class RelayBusTransactionHost<TTransaction = unknown> {
+    private readonly bus;
+    constructor(bus: RelayBus<TTransaction>);
+    /**
+     * The active transaction.
+     *
+     * @throws TransactionRequiredError when the caller runs outside every transaction.
+     */
+    current(): TTransaction;
+    /** The active transaction, or undefined outside every transaction. */
+    find(): TTransaction | undefined;
+}
+
+/** The compile error a `@RelayBusTransaction()` on a method that does not return a Promise reads. */
+type RelayBusTransactionNeedsAsyncMethod = '@RelayBusTransaction() needs a method that returns a Promise: make the method async';
+/**
+ * Accepts the descriptor of a method that returns a Promise; any other method fails to compile
+ * with {@link RelayBusTransactionNeedsAsyncMethod} in the message.
+ */
+type AsyncMethodDescriptor<TMethod> = TypedPropertyDescriptor<TMethod> & (TMethod extends (...args: never[]) => PromiseLike<unknown> ? unknown : RelayBusTransactionNeedsAsyncMethod);
+/** What `@RelayBusTransaction()` returns: a method decorator for async methods only. */
+type RelayBusTransactionDecorator = <TMethod extends (...args: never[]) => unknown>(target: object, propertyKey: string | symbol, descriptor: AsyncMethodDescriptor<TMethod>) => void;
+/**
+ * Runs the method in a relaybus transaction: `bus.publish(...)` inside it, and in everything it
+ * awaits, joins the transaction without passing `{ transaction }`, and a repository reads it with
+ * `bus.currentTransaction()` or {@link RelayBusTransactionHost}. The transaction commits when the
+ * method resolves and rolls back when it rejects; it is held to the bus `transactionTimeout`.
+ *
+ * - The method itself is replaced, so `this.other()` calls of decorated methods are transactional
+ *   too, unlike interceptor-based decorators.
+ * - A decorated method called while a transaction is active (another decorated method,
+ *   `bus.transaction`, a transactional handler, or the `transactionResolver`, for example
+ *   `@nestjs-cls/transactional`) joins it instead of opening a second one.
+ * - The bus is the one of the application's `RelayBusModule`; the class does not inject it.
+ * - Only methods that return a Promise compile.
+ *
+ * ```ts
+ * @Injectable()
+ * export class OrderService {
+ *   @RelayBusTransaction()
+ *   async place(orderId: string): Promise<void> {
+ *     await this.orders.insert(orderId);
+ *     await this.bus.publish(new OrderPlaced({ orderId }));
+ *   }
+ * }
+ * ```
+ */
+declare function RelayBusTransaction(): RelayBusTransactionDecorator;
+
+/**
+ * Options of {@link RelayBusConsumer}: the core {@link SubscribeOptions}, except that
  * `id` is optional and defaults to `ClassName.methodName`.
  */
-type SubscribeDecoratorOptions = Omit<SubscribeOptions, 'id'> & {
+type RelayBusConsumerOptions = Omit<SubscribeOptions, 'id'> & {
     /**
      * Stable id of the handler. Deliveries are recorded under it, so renaming it
      * (or the class or method it is derived from) orphans pending deliveries.
      * Default: `${ClassName}.${methodName}`. Required when one method carries
-     * several `@Subscribe` decorators.
+     * several `@RelayBusConsumer` decorators.
      */
     readonly id?: string;
 };
-/** What one `@Subscribe` decorator recorded on a method. */
-interface SubscribeMetadata {
+/** What one `@RelayBusConsumer` decorator recorded on a method. */
+interface RelayBusConsumerMetadata {
     readonly event: EventClass<unknown> | string;
-    readonly options: SubscribeDecoratorOptions;
+    readonly options: RelayBusConsumerOptions;
 }
+/** @deprecated Renamed to {@link RelayBusConsumerOptions}; this alias is removed in 1.0.0. */
+type SubscribeDecoratorOptions = RelayBusConsumerOptions;
+/** @deprecated Renamed to {@link RelayBusConsumerMetadata}; this alias is removed in 1.0.0. */
+type SubscribeMetadata = RelayBusConsumerMetadata;
 type HandlerMethod<TPayload> = (event: EventEnvelope<TPayload>, context: HandlerContext<never>) => unknown;
-type SubscribeDecorator<TPayload> = <TMethod extends HandlerMethod<TPayload>>(target: object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<TMethod>) => void;
+type HandlerDecorator<TPayload> = <TMethod extends HandlerMethod<TPayload>>(target: object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<TMethod>) => void;
 /**
  * Subscribes a provider method to an event class or type. The method is
  * registered with `bus.subscribe` when the module initialises, with `this`
@@ -201,12 +351,17 @@ type SubscribeDecorator<TPayload> = <TMethod extends HandlerMethod<TPayload>>(ta
  * ```ts
  * @Injectable()
  * export class ShippingHandlers {
- *   @Subscribe(OrderPlaced, { transactional: true })
+ *   @RelayBusConsumer(OrderPlaced, { transactional: true })
  *   async onOrderPlaced(event: EventEnvelope<{ orderId: string }>, context: HandlerContext) {}
  * }
  * ```
  */
-declare function Subscribe<TPayload>(event: EventClass<TPayload>, options?: SubscribeDecoratorOptions): SubscribeDecorator<TPayload>;
-declare function Subscribe(eventType: string, options?: SubscribeDecoratorOptions): SubscribeDecorator<never>;
+declare function RelayBusConsumer<TPayload>(event: EventClass<TPayload>, options?: RelayBusConsumerOptions): HandlerDecorator<TPayload>;
+declare function RelayBusConsumer(eventType: string, options?: RelayBusConsumerOptions): HandlerDecorator<never>;
+/**
+ * @deprecated Renamed to {@link RelayBusConsumer}, which behaves identically; this alias is
+ * removed in 1.0.0.
+ */
+declare const Subscribe: typeof RelayBusConsumer;
 
-export { EventConsumer, type EventConsumerClass, type EventConsumerMetadata, type EventConsumerOptions, RelayBusHandlerExplorer, RelayBusHealth, type RelayBusHealthReport, RelayBusLifecycle, RelayBusModule, type RelayBusModuleExtras, type RelayBusModuleOptions, type RelayBusModuleOptionsFactory, Subscribe, type SubscribeDecoratorOptions, type SubscribeMetadata };
+export { type AsyncMethodDescriptor, type ContractEvent, EventConsumer, type EventConsumerClass, type EventConsumerMetadata, type EventConsumerOptions, RelayBusCatalogConsumer, type RelayBusCatalogConsumerClass, type RelayBusCatalogConsumerMetadata, type RelayBusCatalogConsumerOptions, RelayBusConsumer, type RelayBusConsumerMetadata, type RelayBusConsumerOptions, RelayBusFeatureContract, RelayBusFeatureModule, type RelayBusFeatureOptions, RelayBusHandlerExplorer, RelayBusHealth, type RelayBusHealthReport, RelayBusLifecycle, RelayBusModule, type RelayBusModuleExtras, type RelayBusModuleOptions, type RelayBusModuleOptionsFactory, RelayBusTransaction, type RelayBusTransactionDecorator, RelayBusTransactionHost, type RelayBusTransactionNeedsAsyncMethod, Subscribe, type SubscribeDecoratorOptions, type SubscribeMetadata };