@zdavison/matador-nest 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/dist/constants.d.ts +13 -0
  2. package/dist/constants.d.ts.map +1 -0
  3. package/dist/constants.js +12 -0
  4. package/dist/decorators/index.d.ts +3 -0
  5. package/dist/decorators/index.d.ts.map +1 -0
  6. package/dist/decorators/index.js +2 -0
  7. package/dist/decorators/matador-subscriber.decorator.d.ts +20 -0
  8. package/dist/decorators/matador-subscriber.decorator.d.ts.map +1 -0
  9. package/dist/decorators/matador-subscriber.decorator.js +26 -0
  10. package/dist/decorators/on-matador-event.decorator.d.ts +24 -0
  11. package/dist/decorators/on-matador-event.decorator.d.ts.map +1 -0
  12. package/dist/decorators/on-matador-event.decorator.js +38 -0
  13. package/dist/discovery/index.d.ts +2 -0
  14. package/dist/discovery/index.d.ts.map +1 -0
  15. package/dist/discovery/index.js +1 -0
  16. package/dist/discovery/subscriber-discovery.service.d.ts +37 -0
  17. package/dist/discovery/subscriber-discovery.service.d.ts.map +1 -0
  18. package/dist/discovery/subscriber-discovery.service.js +144 -0
  19. package/dist/index.cjs +495 -0
  20. package/dist/index.cjs.map +1 -0
  21. package/dist/index.d.cts +7 -0
  22. package/dist/index.d.ts +7 -0
  23. package/dist/index.d.ts.map +1 -0
  24. package/dist/index.js +10 -0
  25. package/dist/index.js.map +1 -0
  26. package/dist/module/index.d.ts +2 -0
  27. package/dist/module/index.d.ts.map +1 -0
  28. package/dist/module/index.js +1 -0
  29. package/dist/module/matador.module.d.ts +71 -0
  30. package/dist/module/matador.module.d.ts.map +1 -0
  31. package/dist/module/matador.module.js +146 -0
  32. package/dist/services/index.d.ts +2 -0
  33. package/dist/services/index.d.ts.map +1 -0
  34. package/dist/services/index.js +1 -0
  35. package/dist/services/matador.service.d.ts +105 -0
  36. package/dist/services/matador.service.d.ts.map +1 -0
  37. package/dist/services/matador.service.js +209 -0
  38. package/dist/testing/index.d.ts +2 -0
  39. package/dist/testing/index.d.ts.map +1 -0
  40. package/dist/testing/index.js +1 -0
  41. package/dist/testing/matador-testing.module.d.ts +53 -0
  42. package/dist/testing/matador-testing.module.d.ts.map +1 -0
  43. package/dist/testing/matador-testing.module.js +77 -0
  44. package/dist/testing.cjs +498 -0
  45. package/dist/testing.cjs.map +1 -0
  46. package/dist/testing.d.cts +2 -0
  47. package/dist/testing.d.ts +2 -0
  48. package/dist/testing.d.ts.map +1 -0
  49. package/dist/testing.js +2 -0
  50. package/dist/testing.js.map +1 -0
  51. package/dist/types.d.ts +88 -0
  52. package/dist/types.d.ts.map +1 -0
  53. package/dist/types.js +1 -0
  54. package/package.json +61 -0
  55. package/src/constants.ts +14 -0
  56. package/src/decorators/index.ts +2 -0
  57. package/src/decorators/matador-subscriber.decorator.ts +27 -0
  58. package/src/decorators/on-matador-event.decorator.ts +68 -0
  59. package/src/discovery/index.ts +1 -0
  60. package/src/discovery/subscriber-discovery.service.ts +181 -0
  61. package/src/index.ts +28 -0
  62. package/src/module/index.ts +1 -0
  63. package/src/module/matador.module.ts +162 -0
  64. package/src/services/index.ts +1 -0
  65. package/src/services/matador.service.ts +283 -0
  66. package/src/testing/index.ts +1 -0
  67. package/src/testing/matador-testing.module.ts +71 -0
  68. package/src/testing.ts +2 -0
  69. package/src/types.ts +119 -0
  70. package/test/decorators.test.ts +132 -0
  71. package/test/discovery.test.ts +278 -0
  72. package/tsconfig.json +32 -0
  73. package/tsconfig.tsbuildinfo +1 -0
  74. package/tsup.config.ts +23 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/constants.ts","../src/discovery/subscriber-discovery.service.ts","../src/services/matador.service.ts","../src/module/matador.module.ts","../src/testing/matador-testing.module.ts"],"names":["MATADOR_EVENT_HANDLERS","MATADOR_OPTIONS","SubscriberDiscoveryService","schema","discovered","discoveryService","onModuleInit","discoverSubscribers","providers","getProviders","wrapper","instance","handlers","Reflect","getMetadata","length","handler","registerHandler","metadata","eventClass","options","methodName","className","name","subscriberName","isResumable","idempotent","boundMethod","bind","subscriber","createSubscriber","description","importance","targetQueue","enabled","callback","envelope","context","addToSchema","eventKey","key","existing","existingEventClass","existingSubscribers","getSchema","getMergedSchema","mergedSchema","additionalEvents","subscribers","MatadorService","logger","Logger","matador","isShuttingDown","isStarted","initializeMatador","shouldAutoStart","startOn","doStart","onApplicationBootstrap","onModuleDestroy","shutdownOn","doShutdown","beforeApplicationShutdown","onApplicationShutdown","send","eventOrClass","dataOrOptions","Error","isEventClass","getMatador","start","isConnected","isShutdownInProgress","waitForIdle","timeoutMs","registry","SchemaRegistry","entry","Object","values","isSchemaEntryTuple","register","validation","validate","valid","errors","issues","filter","i","severity","map","message","join","Matador","transport","topology","consumeFrom","undefined","codec","retryPolicy","checkpointStore","shutdownConfig","hooks","log","autoStart","gracefulShutdownTimeout","drained","warn","shutdown","MatadorModule","forRoot","module","imports","DiscoveryModule","provide","useValue","DiscoveryService","exports","forRootAsync","asyncProviders","createAsyncProviders","useFactory","inject","useClass","factory","createMatadorOptions","useExisting","MatadorTestingModule","forTest","overrides","defaultOptions","LocalTransport","TopologyBuilder","create","withNamespace","addQueue","build"],"mappings":"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","file":"testing.cjs","sourcesContent":["/**\n * Metadata key for storing event handler metadata on methods.\n */\nexport const MATADOR_EVENT_HANDLER = Symbol('MATADOR_EVENT_HANDLER');\n\n/**\n * Metadata key for storing a list of all event handlers on a class.\n */\nexport const MATADOR_EVENT_HANDLERS = Symbol('MATADOR_EVENT_HANDLERS');\n\n/**\n * Injection token for module options.\n */\nexport const MATADOR_OPTIONS = Symbol('MATADOR_OPTIONS');\n","import { Injectable, type OnModuleInit } from '@nestjs/common';\nimport { DiscoveryService } from '@nestjs/core';\nimport {\n type AnySubscriber,\n type Envelope,\n type EventClass,\n type MatadorSchema,\n type SubscriberContext,\n createSubscriber,\n} from '@zdavison/matador';\nimport { MATADOR_EVENT_HANDLERS } from '../constants.js';\nimport type {\n MatadorEventHandlerMetadata,\n MatadorModuleOptions,\n} from '../types.js';\n\n/**\n * Schema entry tuple type for building the schema.\n */\ntype SchemaEntryTuple = [EventClass<unknown>, AnySubscriber[]];\n\n/**\n * Mutable schema type for building during discovery.\n */\ntype MutableSchema = Record<string, SchemaEntryTuple>;\n\n/**\n * Service that discovers all @OnMatadorEvent decorated methods in the application\n * and builds a Matador schema from them.\n */\n@Injectable()\nexport class SubscriberDiscoveryService implements OnModuleInit {\n private schema: MutableSchema = {};\n private discovered = false;\n\n constructor(private readonly discoveryService: DiscoveryService) {}\n\n onModuleInit(): void {\n this.discoverSubscribers();\n }\n\n /**\n * Discovers all @OnMatadorEvent decorated methods and builds the schema.\n */\n private discoverSubscribers(): void {\n if (this.discovered) {\n return;\n }\n\n const providers = this.discoveryService.getProviders();\n\n for (const wrapper of providers) {\n const { instance } = wrapper;\n if (!instance || typeof instance !== 'object') {\n continue;\n }\n\n const handlers: MatadorEventHandlerMetadata[] | undefined =\n Reflect.getMetadata(MATADOR_EVENT_HANDLERS, instance.constructor);\n\n if (!handlers || handlers.length === 0) {\n continue;\n }\n\n for (const handler of handlers) {\n this.registerHandler(instance, handler);\n }\n }\n\n this.discovered = true;\n }\n\n /**\n * Registers a single handler method as a subscriber.\n */\n private registerHandler(\n instance: object,\n metadata: MatadorEventHandlerMetadata,\n ): void {\n const { eventClass, options, methodName } = metadata;\n const className = instance.constructor.name;\n\n // Auto-generate name if not provided: ClassName.methodName\n const subscriberName = options.name ?? `${className}.${methodName}`;\n\n // Determine if this is a resumable subscriber\n const isResumable = options.idempotent === 'resumable';\n\n // Create the callback that calls the instance method\n // biome-ignore lint/suspicious/noExplicitAny: Instance methods may have various signatures\n const boundMethod = (instance as Record<string, any>)[methodName].bind(\n instance,\n );\n\n // Create a subscriber that calls the instance method\n const subscriber: AnySubscriber = isResumable\n ? createSubscriber({\n name: subscriberName,\n description: options.description,\n idempotent: 'resumable',\n importance: options.importance,\n targetQueue: options.targetQueue,\n enabled: options.enabled,\n callback: async (\n envelope: Envelope<unknown>,\n context: SubscriberContext,\n ) => {\n await boundMethod(envelope, context);\n },\n })\n : createSubscriber({\n name: subscriberName,\n description: options.description,\n idempotent: options.idempotent,\n importance: options.importance,\n targetQueue: options.targetQueue,\n enabled: options.enabled,\n callback: async (envelope: Envelope<unknown>) => {\n await boundMethod(envelope);\n },\n });\n\n // Add to schema\n this.addToSchema(eventClass, subscriber);\n }\n\n /**\n * Adds a subscriber to the schema for an event.\n */\n private addToSchema(\n eventClass: EventClass<unknown>,\n subscriber: AnySubscriber,\n ): void {\n const eventKey = eventClass.key;\n const existing = this.schema[eventKey];\n\n if (existing) {\n // Add subscriber to existing event entry\n const [existingEventClass, existingSubscribers] = existing;\n this.schema[eventKey] = [\n existingEventClass,\n [...existingSubscribers, subscriber],\n ];\n } else {\n // Create new entry\n this.schema[eventKey] = [eventClass, [subscriber]];\n }\n }\n\n /**\n * Gets the discovered schema.\n * Must be called after onModuleInit has run.\n */\n getSchema(): MatadorSchema {\n return this.schema;\n }\n\n /**\n * Gets the schema merged with additional events from options.\n */\n getMergedSchema(options: MatadorModuleOptions): MatadorSchema {\n const mergedSchema: MutableSchema = { ...this.schema };\n\n if (options.additionalEvents) {\n for (const [eventClass, subscribers] of options.additionalEvents) {\n const existing = mergedSchema[eventClass.key];\n if (existing) {\n const [existingEventClass, existingSubscribers] = existing;\n mergedSchema[eventClass.key] = [\n existingEventClass,\n [...existingSubscribers, ...subscribers],\n ];\n } else {\n mergedSchema[eventClass.key] = [eventClass, subscribers];\n }\n }\n }\n\n return mergedSchema;\n }\n}\n","import {\n type BeforeApplicationShutdown,\n Inject,\n Injectable,\n Logger,\n type OnApplicationBootstrap,\n type OnApplicationShutdown,\n type OnModuleDestroy,\n type OnModuleInit,\n} from '@nestjs/common';\nimport {\n type Event,\n type EventClass,\n type EventOptions,\n Matador,\n SchemaRegistry,\n type SendResult,\n isSchemaEntryTuple,\n} from '@zdavison/matador';\nimport { MATADOR_OPTIONS } from '../constants.js';\nimport { SubscriberDiscoveryService } from '../discovery/subscriber-discovery.service.js';\nimport type { MatadorModuleOptions } from '../types.js';\n\n/**\n * Injectable service that wraps Matador and integrates with NestJS lifecycle.\n *\n * This service handles:\n * - Building the Matador instance with discovered subscribers\n * - Starting Matador at the configured lifecycle hook\n * - Graceful shutdown with drain timeout\n * - Preventing event sending during shutdown\n *\n * @example\n * ```typescript\n * @Injectable()\n * export class OrderService {\n * constructor(private readonly matador: MatadorService) {}\n *\n * async createOrder(data: CreateOrderDto) {\n * // ... create order logic ...\n * await this.matador.send(OrderCreatedEvent, { orderId: order.id });\n * }\n * }\n * ```\n */\n@Injectable()\nexport class MatadorService\n implements\n OnModuleInit,\n OnApplicationBootstrap,\n OnModuleDestroy,\n BeforeApplicationShutdown,\n OnApplicationShutdown\n{\n private readonly logger = new Logger(MatadorService.name);\n private matador!: Matador;\n private isShuttingDown = false;\n private isStarted = false;\n\n constructor(\n @Inject(MATADOR_OPTIONS) private readonly options: MatadorModuleOptions,\n private readonly discoveryService: SubscriberDiscoveryService,\n ) {}\n\n /**\n * Called when MatadorModule is initialized.\n * Builds Matador instance and starts if startOn === 'onModuleInit'.\n */\n async onModuleInit(): Promise<void> {\n this.initializeMatador();\n\n if (this.shouldAutoStart() && this.options.startOn === 'onModuleInit') {\n await this.doStart();\n }\n }\n\n /**\n * Called after all modules are initialized and the app is ready to start.\n * Starts Matador if startOn === 'onApplicationBootstrap' (default).\n */\n async onApplicationBootstrap(): Promise<void> {\n const startOn = this.options.startOn ?? 'onApplicationBootstrap';\n if (this.shouldAutoStart() && startOn === 'onApplicationBootstrap') {\n await this.doStart();\n }\n }\n\n /**\n * Called when MatadorModule is destroyed.\n * Shuts down Matador if shutdownOn === 'onModuleDestroy'.\n */\n async onModuleDestroy(): Promise<void> {\n if (this.options.shutdownOn === 'onModuleDestroy') {\n await this.doShutdown();\n }\n }\n\n /**\n * Called when the application receives a shutdown signal (SIGTERM, etc).\n * Shuts down Matador if shutdownOn === 'beforeApplicationShutdown' (default).\n */\n async beforeApplicationShutdown(): Promise<void> {\n const shutdownOn = this.options.shutdownOn ?? 'beforeApplicationShutdown';\n if (shutdownOn === 'beforeApplicationShutdown') {\n await this.doShutdown();\n }\n }\n\n /**\n * Called after beforeApplicationShutdown completes.\n * Shuts down Matador if shutdownOn === 'onApplicationShutdown'.\n */\n async onApplicationShutdown(): Promise<void> {\n if (this.options.shutdownOn === 'onApplicationShutdown') {\n await this.doShutdown();\n }\n }\n\n /**\n * Sends an event to all registered subscribers.\n *\n * @throws Error if called during shutdown\n *\n * @example\n * ```typescript\n * // Pass the event class and data directly\n * await matadorService.send(UserCreatedEvent, { userId: '123' });\n *\n * // Or pass an event instance\n * const event = new UserCreatedEvent({ userId: '123' });\n * await matadorService.send(event);\n * ```\n */\n async send<T>(\n eventClass: EventClass<T>,\n data: T,\n options?: EventOptions,\n ): Promise<SendResult>;\n async send<T>(event: Event<T>, options?: EventOptions): Promise<SendResult>;\n async send<T>(\n eventOrClass: EventClass<T> | Event<T>,\n dataOrOptions?: T | EventOptions,\n options?: EventOptions,\n ): Promise<SendResult> {\n if (this.isShuttingDown) {\n throw new Error('Cannot send events during shutdown');\n }\n\n // Determine if first arg is an event instance or event class\n const isEventClass =\n typeof eventOrClass === 'function' && 'key' in eventOrClass;\n\n if (isEventClass) {\n return this.matador.send(\n eventOrClass as EventClass<T>,\n dataOrOptions as T,\n options,\n );\n }\n return this.matador.send(\n eventOrClass as Event<T>,\n dataOrOptions as EventOptions | undefined,\n );\n }\n\n /**\n * Gets the underlying Matador instance for advanced operations.\n */\n getMatador(): Matador {\n return this.matador;\n }\n\n /**\n * Starts consuming (if autoStart was false).\n */\n async start(): Promise<void> {\n return this.doStart();\n }\n\n /**\n * Checks if connected to transport.\n */\n isConnected(): boolean {\n return this.matador?.isConnected() ?? false;\n }\n\n /**\n * Checks if shutdown is in progress.\n */\n isShutdownInProgress(): boolean {\n return this.isShuttingDown;\n }\n\n /**\n * Waits for all pending messages to be processed.\n */\n async waitForIdle(timeoutMs?: number): Promise<boolean> {\n return this.matador.waitForIdle(timeoutMs);\n }\n\n /**\n * Initializes the Matador instance with discovered schema.\n */\n private initializeMatador(): void {\n const mergedSchema = this.discoveryService.getMergedSchema(this.options);\n\n // Validate schema at startup\n const registry = new SchemaRegistry();\n for (const entry of Object.values(mergedSchema)) {\n if (isSchemaEntryTuple(entry)) {\n const [eventClass, subscribers] = entry;\n registry.register(eventClass, subscribers);\n } else {\n registry.register(entry.eventClass, entry.subscribers);\n }\n }\n\n const validation = registry.validate();\n if (!validation.valid) {\n const errors = validation.issues.filter((i) => i.severity === 'error');\n if (errors.length > 0) {\n throw new Error(\n `Invalid Matador schema: ${errors.map((i) => i.message).join(', ')}`,\n );\n }\n }\n\n this.matador = new Matador(\n {\n transport: this.options.transport,\n topology: this.options.topology,\n schema: mergedSchema,\n consumeFrom: this.options.consumeFrom\n ? [...this.options.consumeFrom]\n : undefined,\n codec: this.options.codec,\n retryPolicy: this.options.retryPolicy,\n checkpointStore: this.options.checkpointStore,\n shutdownConfig: this.options.shutdownConfig,\n },\n this.options.hooks,\n );\n\n this.logger.log('Matador instance initialized');\n }\n\n private shouldAutoStart(): boolean {\n return this.options.autoStart !== false;\n }\n\n private async doStart(): Promise<void> {\n if (this.isStarted) {\n return;\n }\n\n await this.matador.start();\n this.isStarted = true;\n this.logger.log('Matador started');\n }\n\n private async doShutdown(): Promise<void> {\n if (!this.isStarted || this.isShuttingDown) {\n return;\n }\n\n this.isShuttingDown = true;\n this.logger.log('Graceful shutdown initiated, draining in-flight messages');\n\n // Wait for in-flight messages to complete (with configurable timeout)\n const timeoutMs =\n this.options.shutdownConfig?.gracefulShutdownTimeout ?? 30000;\n const drained = await this.matador.waitForIdle(timeoutMs);\n\n if (!drained) {\n this.logger.warn(\n `Shutdown timeout reached after ${timeoutMs}ms, some messages may not have completed`,\n );\n }\n\n await this.matador.shutdown();\n this.logger.log('Matador shutdown complete');\n }\n}\n","import {\n type DynamicModule,\n Global,\n type InjectionToken,\n Module,\n type Provider,\n} from '@nestjs/common';\nimport { DiscoveryModule, DiscoveryService } from '@nestjs/core';\nimport { MATADOR_OPTIONS } from '../constants.js';\nimport { SubscriberDiscoveryService } from '../discovery/subscriber-discovery.service.js';\nimport { MatadorService } from '../services/matador.service.js';\nimport type {\n MatadorModuleAsyncOptions,\n MatadorModuleOptions,\n MatadorOptionsFactory,\n} from '../types.js';\n\n/**\n * NestJS module for integrating Matador event processing.\n *\n * Use `MatadorModule.forRoot()` for synchronous configuration or\n * `MatadorModule.forRootAsync()` for async configuration with dependency injection.\n *\n * @example Synchronous configuration\n * ```typescript\n * @Module({\n * imports: [\n * MatadorModule.forRoot({\n * transport: new RabbitMQTransport({ url: 'amqp://localhost' }),\n * topology: TopologyBuilder.create()\n * .withNamespace('myapp')\n * .addQueue('events', { concurrency: 10 })\n * .build(),\n * consumeFrom: ['events'],\n * }),\n * ],\n * })\n * export class AppModule {}\n * ```\n *\n * @example Async configuration with ConfigService\n * ```typescript\n * @Module({\n * imports: [\n * ConfigModule.forRoot(),\n * MatadorModule.forRootAsync({\n * imports: [ConfigModule],\n * inject: [ConfigService],\n * useFactory: (config: ConfigService) => ({\n * transport: new RabbitMQTransport({\n * url: config.get('RABBITMQ_URL'),\n * }),\n * topology: TopologyBuilder.create()\n * .withNamespace(config.get('APP_NAME'))\n * .addQueue('events')\n * .build(),\n * consumeFrom: ['events'],\n * }),\n * }),\n * ],\n * })\n * export class AppModule {}\n * ```\n */\n@Global()\n@Module({})\nexport class MatadorModule {\n /**\n * Configures the MatadorModule with static options.\n *\n * @param options - Module configuration options\n * @returns Dynamic module configuration\n */\n static forRoot(options: MatadorModuleOptions): DynamicModule {\n return {\n module: MatadorModule,\n imports: [DiscoveryModule],\n providers: [\n {\n provide: MATADOR_OPTIONS,\n useValue: options,\n },\n DiscoveryService,\n SubscriberDiscoveryService,\n MatadorService,\n ],\n exports: [MatadorService],\n };\n }\n\n /**\n * Configures the MatadorModule with async options.\n * Use this when you need to inject dependencies like ConfigService.\n *\n * @param options - Async module configuration options\n * @returns Dynamic module configuration\n */\n static forRootAsync(options: MatadorModuleAsyncOptions): DynamicModule {\n const asyncProviders = this.createAsyncProviders(options);\n\n return {\n module: MatadorModule,\n imports: [DiscoveryModule, ...(options.imports ?? [])],\n providers: [\n ...asyncProviders,\n DiscoveryService,\n SubscriberDiscoveryService,\n MatadorService,\n ],\n exports: [MatadorService],\n };\n }\n\n /**\n * Creates async providers for the module options.\n */\n private static createAsyncProviders(\n options: MatadorModuleAsyncOptions,\n ): Provider[] {\n if (options.useFactory) {\n return [\n {\n provide: MATADOR_OPTIONS,\n useFactory: options.useFactory,\n inject: (options.inject ?? []) as InjectionToken[],\n },\n ];\n }\n\n if (options.useClass) {\n return [\n {\n provide: options.useClass,\n useClass: options.useClass,\n },\n {\n provide: MATADOR_OPTIONS,\n useFactory: async (\n factory: MatadorOptionsFactory,\n ): Promise<MatadorModuleOptions> => factory.createMatadorOptions(),\n inject: [options.useClass],\n },\n ];\n }\n\n if (options.useExisting) {\n return [\n {\n provide: MATADOR_OPTIONS,\n useFactory: async (\n factory: MatadorOptionsFactory,\n ): Promise<MatadorModuleOptions> => factory.createMatadorOptions(),\n inject: [options.useExisting],\n },\n ];\n }\n\n throw new Error(\n 'MatadorModule.forRootAsync() requires useFactory, useClass, or useExisting',\n );\n }\n}\n","import { type DynamicModule, Module } from '@nestjs/common';\nimport { LocalTransport, TopologyBuilder } from '@zdavison/matador';\nimport { MatadorModule } from '../module/matador.module.js';\nimport type { MatadorModuleOptions } from '../types.js';\n\n/**\n * Testing module for Matador with sensible defaults for unit/integration tests.\n *\n * Uses LocalTransport by default, which processes messages synchronously\n * in-memory without requiring external infrastructure.\n *\n * @example Basic usage\n * ```typescript\n * describe('NotificationService', () => {\n * let module: TestingModule;\n * let matadorService: MatadorService;\n *\n * beforeEach(async () => {\n * module = await Test.createTestingModule({\n * imports: [MatadorTestingModule.forTest()],\n * providers: [NotificationService],\n * }).compile();\n *\n * matadorService = module.get(MatadorService);\n * await module.init();\n * });\n *\n * it('processes events', async () => {\n * await matadorService.send(UserCreatedEvent, { userId: '123' });\n * await matadorService.waitForIdle();\n * // Assert expected behavior\n * });\n * });\n * ```\n *\n * @example With custom overrides\n * ```typescript\n * MatadorTestingModule.forTest({\n * topology: TopologyBuilder.create()\n * .withNamespace('custom-test')\n * .addQueue('my-queue')\n * .build(),\n * consumeFrom: ['my-queue'],\n * })\n * ```\n */\n@Module({})\nexport class MatadorTestingModule {\n /**\n * Creates a testing module with LocalTransport and default configuration.\n *\n * @param overrides - Optional overrides for the default configuration\n * @returns Dynamic module configuration\n */\n static forTest(overrides?: Partial<MatadorModuleOptions>): DynamicModule {\n const defaultOptions: MatadorModuleOptions = {\n transport: new LocalTransport(),\n topology: TopologyBuilder.create()\n .withNamespace('test')\n .addQueue('events')\n .build(),\n consumeFrom: ['events'],\n autoStart: true,\n };\n\n return MatadorModule.forRoot({\n ...defaultOptions,\n ...overrides,\n });\n }\n}\n"]}
@@ -0,0 +1,2 @@
1
+ export { MatadorTestingModule } from './testing/index.js';
2
+ //# sourceMappingURL=testing.d.ts.map
@@ -0,0 +1,2 @@
1
+ export { MatadorTestingModule } from './testing/index.js';
2
+ //# sourceMappingURL=testing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,2 @@
1
+ // Testing utilities
2
+ export { MatadorTestingModule } from './testing/index.js';
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/constants.ts","../src/discovery/subscriber-discovery.service.ts","../src/services/matador.service.ts","../src/module/matador.module.ts","../src/testing/matador-testing.module.ts"],"names":["MATADOR_EVENT_HANDLERS","MATADOR_OPTIONS","SubscriberDiscoveryService","schema","discovered","discoveryService","onModuleInit","discoverSubscribers","providers","getProviders","wrapper","instance","handlers","Reflect","getMetadata","length","handler","registerHandler","metadata","eventClass","options","methodName","className","name","subscriberName","isResumable","idempotent","boundMethod","bind","subscriber","createSubscriber","description","importance","targetQueue","enabled","callback","envelope","context","addToSchema","eventKey","key","existing","existingEventClass","existingSubscribers","getSchema","getMergedSchema","mergedSchema","additionalEvents","subscribers","MatadorService","logger","Logger","matador","isShuttingDown","isStarted","initializeMatador","shouldAutoStart","startOn","doStart","onApplicationBootstrap","onModuleDestroy","shutdownOn","doShutdown","beforeApplicationShutdown","onApplicationShutdown","send","eventOrClass","dataOrOptions","Error","isEventClass","getMatador","start","isConnected","isShutdownInProgress","waitForIdle","timeoutMs","registry","SchemaRegistry","entry","Object","values","isSchemaEntryTuple","register","validation","validate","valid","errors","issues","filter","i","severity","map","message","join","Matador","transport","topology","consumeFrom","undefined","codec","retryPolicy","checkpointStore","shutdownConfig","hooks","log","autoStart","gracefulShutdownTimeout","drained","warn","shutdown","MatadorModule","forRoot","module","imports","DiscoveryModule","provide","useValue","DiscoveryService","exports","forRootAsync","asyncProviders","createAsyncProviders","useFactory","inject","useClass","factory","createMatadorOptions","useExisting","MatadorTestingModule","forTest","overrides","defaultOptions","LocalTransport","TopologyBuilder","create","withNamespace","addQueue","build"],"mappings":"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","file":"testing.js","sourcesContent":["/**\n * Metadata key for storing event handler metadata on methods.\n */\nexport const MATADOR_EVENT_HANDLER = Symbol('MATADOR_EVENT_HANDLER');\n\n/**\n * Metadata key for storing a list of all event handlers on a class.\n */\nexport const MATADOR_EVENT_HANDLERS = Symbol('MATADOR_EVENT_HANDLERS');\n\n/**\n * Injection token for module options.\n */\nexport const MATADOR_OPTIONS = Symbol('MATADOR_OPTIONS');\n","import { Injectable, type OnModuleInit } from '@nestjs/common';\nimport { DiscoveryService } from '@nestjs/core';\nimport {\n type AnySubscriber,\n type Envelope,\n type EventClass,\n type MatadorSchema,\n type SubscriberContext,\n createSubscriber,\n} from '@zdavison/matador';\nimport { MATADOR_EVENT_HANDLERS } from '../constants.js';\nimport type {\n MatadorEventHandlerMetadata,\n MatadorModuleOptions,\n} from '../types.js';\n\n/**\n * Schema entry tuple type for building the schema.\n */\ntype SchemaEntryTuple = [EventClass<unknown>, AnySubscriber[]];\n\n/**\n * Mutable schema type for building during discovery.\n */\ntype MutableSchema = Record<string, SchemaEntryTuple>;\n\n/**\n * Service that discovers all @OnMatadorEvent decorated methods in the application\n * and builds a Matador schema from them.\n */\n@Injectable()\nexport class SubscriberDiscoveryService implements OnModuleInit {\n private schema: MutableSchema = {};\n private discovered = false;\n\n constructor(private readonly discoveryService: DiscoveryService) {}\n\n onModuleInit(): void {\n this.discoverSubscribers();\n }\n\n /**\n * Discovers all @OnMatadorEvent decorated methods and builds the schema.\n */\n private discoverSubscribers(): void {\n if (this.discovered) {\n return;\n }\n\n const providers = this.discoveryService.getProviders();\n\n for (const wrapper of providers) {\n const { instance } = wrapper;\n if (!instance || typeof instance !== 'object') {\n continue;\n }\n\n const handlers: MatadorEventHandlerMetadata[] | undefined =\n Reflect.getMetadata(MATADOR_EVENT_HANDLERS, instance.constructor);\n\n if (!handlers || handlers.length === 0) {\n continue;\n }\n\n for (const handler of handlers) {\n this.registerHandler(instance, handler);\n }\n }\n\n this.discovered = true;\n }\n\n /**\n * Registers a single handler method as a subscriber.\n */\n private registerHandler(\n instance: object,\n metadata: MatadorEventHandlerMetadata,\n ): void {\n const { eventClass, options, methodName } = metadata;\n const className = instance.constructor.name;\n\n // Auto-generate name if not provided: ClassName.methodName\n const subscriberName = options.name ?? `${className}.${methodName}`;\n\n // Determine if this is a resumable subscriber\n const isResumable = options.idempotent === 'resumable';\n\n // Create the callback that calls the instance method\n // biome-ignore lint/suspicious/noExplicitAny: Instance methods may have various signatures\n const boundMethod = (instance as Record<string, any>)[methodName].bind(\n instance,\n );\n\n // Create a subscriber that calls the instance method\n const subscriber: AnySubscriber = isResumable\n ? createSubscriber({\n name: subscriberName,\n description: options.description,\n idempotent: 'resumable',\n importance: options.importance,\n targetQueue: options.targetQueue,\n enabled: options.enabled,\n callback: async (\n envelope: Envelope<unknown>,\n context: SubscriberContext,\n ) => {\n await boundMethod(envelope, context);\n },\n })\n : createSubscriber({\n name: subscriberName,\n description: options.description,\n idempotent: options.idempotent,\n importance: options.importance,\n targetQueue: options.targetQueue,\n enabled: options.enabled,\n callback: async (envelope: Envelope<unknown>) => {\n await boundMethod(envelope);\n },\n });\n\n // Add to schema\n this.addToSchema(eventClass, subscriber);\n }\n\n /**\n * Adds a subscriber to the schema for an event.\n */\n private addToSchema(\n eventClass: EventClass<unknown>,\n subscriber: AnySubscriber,\n ): void {\n const eventKey = eventClass.key;\n const existing = this.schema[eventKey];\n\n if (existing) {\n // Add subscriber to existing event entry\n const [existingEventClass, existingSubscribers] = existing;\n this.schema[eventKey] = [\n existingEventClass,\n [...existingSubscribers, subscriber],\n ];\n } else {\n // Create new entry\n this.schema[eventKey] = [eventClass, [subscriber]];\n }\n }\n\n /**\n * Gets the discovered schema.\n * Must be called after onModuleInit has run.\n */\n getSchema(): MatadorSchema {\n return this.schema;\n }\n\n /**\n * Gets the schema merged with additional events from options.\n */\n getMergedSchema(options: MatadorModuleOptions): MatadorSchema {\n const mergedSchema: MutableSchema = { ...this.schema };\n\n if (options.additionalEvents) {\n for (const [eventClass, subscribers] of options.additionalEvents) {\n const existing = mergedSchema[eventClass.key];\n if (existing) {\n const [existingEventClass, existingSubscribers] = existing;\n mergedSchema[eventClass.key] = [\n existingEventClass,\n [...existingSubscribers, ...subscribers],\n ];\n } else {\n mergedSchema[eventClass.key] = [eventClass, subscribers];\n }\n }\n }\n\n return mergedSchema;\n }\n}\n","import {\n type BeforeApplicationShutdown,\n Inject,\n Injectable,\n Logger,\n type OnApplicationBootstrap,\n type OnApplicationShutdown,\n type OnModuleDestroy,\n type OnModuleInit,\n} from '@nestjs/common';\nimport {\n type Event,\n type EventClass,\n type EventOptions,\n Matador,\n SchemaRegistry,\n type SendResult,\n isSchemaEntryTuple,\n} from '@zdavison/matador';\nimport { MATADOR_OPTIONS } from '../constants.js';\nimport { SubscriberDiscoveryService } from '../discovery/subscriber-discovery.service.js';\nimport type { MatadorModuleOptions } from '../types.js';\n\n/**\n * Injectable service that wraps Matador and integrates with NestJS lifecycle.\n *\n * This service handles:\n * - Building the Matador instance with discovered subscribers\n * - Starting Matador at the configured lifecycle hook\n * - Graceful shutdown with drain timeout\n * - Preventing event sending during shutdown\n *\n * @example\n * ```typescript\n * @Injectable()\n * export class OrderService {\n * constructor(private readonly matador: MatadorService) {}\n *\n * async createOrder(data: CreateOrderDto) {\n * // ... create order logic ...\n * await this.matador.send(OrderCreatedEvent, { orderId: order.id });\n * }\n * }\n * ```\n */\n@Injectable()\nexport class MatadorService\n implements\n OnModuleInit,\n OnApplicationBootstrap,\n OnModuleDestroy,\n BeforeApplicationShutdown,\n OnApplicationShutdown\n{\n private readonly logger = new Logger(MatadorService.name);\n private matador!: Matador;\n private isShuttingDown = false;\n private isStarted = false;\n\n constructor(\n @Inject(MATADOR_OPTIONS) private readonly options: MatadorModuleOptions,\n private readonly discoveryService: SubscriberDiscoveryService,\n ) {}\n\n /**\n * Called when MatadorModule is initialized.\n * Builds Matador instance and starts if startOn === 'onModuleInit'.\n */\n async onModuleInit(): Promise<void> {\n this.initializeMatador();\n\n if (this.shouldAutoStart() && this.options.startOn === 'onModuleInit') {\n await this.doStart();\n }\n }\n\n /**\n * Called after all modules are initialized and the app is ready to start.\n * Starts Matador if startOn === 'onApplicationBootstrap' (default).\n */\n async onApplicationBootstrap(): Promise<void> {\n const startOn = this.options.startOn ?? 'onApplicationBootstrap';\n if (this.shouldAutoStart() && startOn === 'onApplicationBootstrap') {\n await this.doStart();\n }\n }\n\n /**\n * Called when MatadorModule is destroyed.\n * Shuts down Matador if shutdownOn === 'onModuleDestroy'.\n */\n async onModuleDestroy(): Promise<void> {\n if (this.options.shutdownOn === 'onModuleDestroy') {\n await this.doShutdown();\n }\n }\n\n /**\n * Called when the application receives a shutdown signal (SIGTERM, etc).\n * Shuts down Matador if shutdownOn === 'beforeApplicationShutdown' (default).\n */\n async beforeApplicationShutdown(): Promise<void> {\n const shutdownOn = this.options.shutdownOn ?? 'beforeApplicationShutdown';\n if (shutdownOn === 'beforeApplicationShutdown') {\n await this.doShutdown();\n }\n }\n\n /**\n * Called after beforeApplicationShutdown completes.\n * Shuts down Matador if shutdownOn === 'onApplicationShutdown'.\n */\n async onApplicationShutdown(): Promise<void> {\n if (this.options.shutdownOn === 'onApplicationShutdown') {\n await this.doShutdown();\n }\n }\n\n /**\n * Sends an event to all registered subscribers.\n *\n * @throws Error if called during shutdown\n *\n * @example\n * ```typescript\n * // Pass the event class and data directly\n * await matadorService.send(UserCreatedEvent, { userId: '123' });\n *\n * // Or pass an event instance\n * const event = new UserCreatedEvent({ userId: '123' });\n * await matadorService.send(event);\n * ```\n */\n async send<T>(\n eventClass: EventClass<T>,\n data: T,\n options?: EventOptions,\n ): Promise<SendResult>;\n async send<T>(event: Event<T>, options?: EventOptions): Promise<SendResult>;\n async send<T>(\n eventOrClass: EventClass<T> | Event<T>,\n dataOrOptions?: T | EventOptions,\n options?: EventOptions,\n ): Promise<SendResult> {\n if (this.isShuttingDown) {\n throw new Error('Cannot send events during shutdown');\n }\n\n // Determine if first arg is an event instance or event class\n const isEventClass =\n typeof eventOrClass === 'function' && 'key' in eventOrClass;\n\n if (isEventClass) {\n return this.matador.send(\n eventOrClass as EventClass<T>,\n dataOrOptions as T,\n options,\n );\n }\n return this.matador.send(\n eventOrClass as Event<T>,\n dataOrOptions as EventOptions | undefined,\n );\n }\n\n /**\n * Gets the underlying Matador instance for advanced operations.\n */\n getMatador(): Matador {\n return this.matador;\n }\n\n /**\n * Starts consuming (if autoStart was false).\n */\n async start(): Promise<void> {\n return this.doStart();\n }\n\n /**\n * Checks if connected to transport.\n */\n isConnected(): boolean {\n return this.matador?.isConnected() ?? false;\n }\n\n /**\n * Checks if shutdown is in progress.\n */\n isShutdownInProgress(): boolean {\n return this.isShuttingDown;\n }\n\n /**\n * Waits for all pending messages to be processed.\n */\n async waitForIdle(timeoutMs?: number): Promise<boolean> {\n return this.matador.waitForIdle(timeoutMs);\n }\n\n /**\n * Initializes the Matador instance with discovered schema.\n */\n private initializeMatador(): void {\n const mergedSchema = this.discoveryService.getMergedSchema(this.options);\n\n // Validate schema at startup\n const registry = new SchemaRegistry();\n for (const entry of Object.values(mergedSchema)) {\n if (isSchemaEntryTuple(entry)) {\n const [eventClass, subscribers] = entry;\n registry.register(eventClass, subscribers);\n } else {\n registry.register(entry.eventClass, entry.subscribers);\n }\n }\n\n const validation = registry.validate();\n if (!validation.valid) {\n const errors = validation.issues.filter((i) => i.severity === 'error');\n if (errors.length > 0) {\n throw new Error(\n `Invalid Matador schema: ${errors.map((i) => i.message).join(', ')}`,\n );\n }\n }\n\n this.matador = new Matador(\n {\n transport: this.options.transport,\n topology: this.options.topology,\n schema: mergedSchema,\n consumeFrom: this.options.consumeFrom\n ? [...this.options.consumeFrom]\n : undefined,\n codec: this.options.codec,\n retryPolicy: this.options.retryPolicy,\n checkpointStore: this.options.checkpointStore,\n shutdownConfig: this.options.shutdownConfig,\n },\n this.options.hooks,\n );\n\n this.logger.log('Matador instance initialized');\n }\n\n private shouldAutoStart(): boolean {\n return this.options.autoStart !== false;\n }\n\n private async doStart(): Promise<void> {\n if (this.isStarted) {\n return;\n }\n\n await this.matador.start();\n this.isStarted = true;\n this.logger.log('Matador started');\n }\n\n private async doShutdown(): Promise<void> {\n if (!this.isStarted || this.isShuttingDown) {\n return;\n }\n\n this.isShuttingDown = true;\n this.logger.log('Graceful shutdown initiated, draining in-flight messages');\n\n // Wait for in-flight messages to complete (with configurable timeout)\n const timeoutMs =\n this.options.shutdownConfig?.gracefulShutdownTimeout ?? 30000;\n const drained = await this.matador.waitForIdle(timeoutMs);\n\n if (!drained) {\n this.logger.warn(\n `Shutdown timeout reached after ${timeoutMs}ms, some messages may not have completed`,\n );\n }\n\n await this.matador.shutdown();\n this.logger.log('Matador shutdown complete');\n }\n}\n","import {\n type DynamicModule,\n Global,\n type InjectionToken,\n Module,\n type Provider,\n} from '@nestjs/common';\nimport { DiscoveryModule, DiscoveryService } from '@nestjs/core';\nimport { MATADOR_OPTIONS } from '../constants.js';\nimport { SubscriberDiscoveryService } from '../discovery/subscriber-discovery.service.js';\nimport { MatadorService } from '../services/matador.service.js';\nimport type {\n MatadorModuleAsyncOptions,\n MatadorModuleOptions,\n MatadorOptionsFactory,\n} from '../types.js';\n\n/**\n * NestJS module for integrating Matador event processing.\n *\n * Use `MatadorModule.forRoot()` for synchronous configuration or\n * `MatadorModule.forRootAsync()` for async configuration with dependency injection.\n *\n * @example Synchronous configuration\n * ```typescript\n * @Module({\n * imports: [\n * MatadorModule.forRoot({\n * transport: new RabbitMQTransport({ url: 'amqp://localhost' }),\n * topology: TopologyBuilder.create()\n * .withNamespace('myapp')\n * .addQueue('events', { concurrency: 10 })\n * .build(),\n * consumeFrom: ['events'],\n * }),\n * ],\n * })\n * export class AppModule {}\n * ```\n *\n * @example Async configuration with ConfigService\n * ```typescript\n * @Module({\n * imports: [\n * ConfigModule.forRoot(),\n * MatadorModule.forRootAsync({\n * imports: [ConfigModule],\n * inject: [ConfigService],\n * useFactory: (config: ConfigService) => ({\n * transport: new RabbitMQTransport({\n * url: config.get('RABBITMQ_URL'),\n * }),\n * topology: TopologyBuilder.create()\n * .withNamespace(config.get('APP_NAME'))\n * .addQueue('events')\n * .build(),\n * consumeFrom: ['events'],\n * }),\n * }),\n * ],\n * })\n * export class AppModule {}\n * ```\n */\n@Global()\n@Module({})\nexport class MatadorModule {\n /**\n * Configures the MatadorModule with static options.\n *\n * @param options - Module configuration options\n * @returns Dynamic module configuration\n */\n static forRoot(options: MatadorModuleOptions): DynamicModule {\n return {\n module: MatadorModule,\n imports: [DiscoveryModule],\n providers: [\n {\n provide: MATADOR_OPTIONS,\n useValue: options,\n },\n DiscoveryService,\n SubscriberDiscoveryService,\n MatadorService,\n ],\n exports: [MatadorService],\n };\n }\n\n /**\n * Configures the MatadorModule with async options.\n * Use this when you need to inject dependencies like ConfigService.\n *\n * @param options - Async module configuration options\n * @returns Dynamic module configuration\n */\n static forRootAsync(options: MatadorModuleAsyncOptions): DynamicModule {\n const asyncProviders = this.createAsyncProviders(options);\n\n return {\n module: MatadorModule,\n imports: [DiscoveryModule, ...(options.imports ?? [])],\n providers: [\n ...asyncProviders,\n DiscoveryService,\n SubscriberDiscoveryService,\n MatadorService,\n ],\n exports: [MatadorService],\n };\n }\n\n /**\n * Creates async providers for the module options.\n */\n private static createAsyncProviders(\n options: MatadorModuleAsyncOptions,\n ): Provider[] {\n if (options.useFactory) {\n return [\n {\n provide: MATADOR_OPTIONS,\n useFactory: options.useFactory,\n inject: (options.inject ?? []) as InjectionToken[],\n },\n ];\n }\n\n if (options.useClass) {\n return [\n {\n provide: options.useClass,\n useClass: options.useClass,\n },\n {\n provide: MATADOR_OPTIONS,\n useFactory: async (\n factory: MatadorOptionsFactory,\n ): Promise<MatadorModuleOptions> => factory.createMatadorOptions(),\n inject: [options.useClass],\n },\n ];\n }\n\n if (options.useExisting) {\n return [\n {\n provide: MATADOR_OPTIONS,\n useFactory: async (\n factory: MatadorOptionsFactory,\n ): Promise<MatadorModuleOptions> => factory.createMatadorOptions(),\n inject: [options.useExisting],\n },\n ];\n }\n\n throw new Error(\n 'MatadorModule.forRootAsync() requires useFactory, useClass, or useExisting',\n );\n }\n}\n","import { type DynamicModule, Module } from '@nestjs/common';\nimport { LocalTransport, TopologyBuilder } from '@zdavison/matador';\nimport { MatadorModule } from '../module/matador.module.js';\nimport type { MatadorModuleOptions } from '../types.js';\n\n/**\n * Testing module for Matador with sensible defaults for unit/integration tests.\n *\n * Uses LocalTransport by default, which processes messages synchronously\n * in-memory without requiring external infrastructure.\n *\n * @example Basic usage\n * ```typescript\n * describe('NotificationService', () => {\n * let module: TestingModule;\n * let matadorService: MatadorService;\n *\n * beforeEach(async () => {\n * module = await Test.createTestingModule({\n * imports: [MatadorTestingModule.forTest()],\n * providers: [NotificationService],\n * }).compile();\n *\n * matadorService = module.get(MatadorService);\n * await module.init();\n * });\n *\n * it('processes events', async () => {\n * await matadorService.send(UserCreatedEvent, { userId: '123' });\n * await matadorService.waitForIdle();\n * // Assert expected behavior\n * });\n * });\n * ```\n *\n * @example With custom overrides\n * ```typescript\n * MatadorTestingModule.forTest({\n * topology: TopologyBuilder.create()\n * .withNamespace('custom-test')\n * .addQueue('my-queue')\n * .build(),\n * consumeFrom: ['my-queue'],\n * })\n * ```\n */\n@Module({})\nexport class MatadorTestingModule {\n /**\n * Creates a testing module with LocalTransport and default configuration.\n *\n * @param overrides - Optional overrides for the default configuration\n * @returns Dynamic module configuration\n */\n static forTest(overrides?: Partial<MatadorModuleOptions>): DynamicModule {\n const defaultOptions: MatadorModuleOptions = {\n transport: new LocalTransport(),\n topology: TopologyBuilder.create()\n .withNamespace('test')\n .addQueue('events')\n .build(),\n consumeFrom: ['events'],\n autoStart: true,\n };\n\n return MatadorModule.forRoot({\n ...defaultOptions,\n ...overrides,\n });\n }\n}\n"]}
@@ -0,0 +1,88 @@
1
+ import type { ModuleMetadata, Type } from '@nestjs/common';
2
+ import type { AnySubscriber, BaseSubscriberOptions, EventClass, Idempotency, MatadorConfig, MatadorHooks } from '@zdavison/matador';
3
+ /**
4
+ * Options for the @OnMatadorEvent decorator.
5
+ * Derived from BaseSubscriberOptions with additional NestJS-specific fields.
6
+ */
7
+ export interface OnMatadorEventOptions extends BaseSubscriberOptions {
8
+ /** Optional: override auto-generated name (default: ClassName.methodName) */
9
+ readonly name?: string | undefined;
10
+ /** Idempotency declaration for retry handling */
11
+ readonly idempotent?: Idempotency | undefined;
12
+ }
13
+ /**
14
+ * Metadata stored on methods decorated with @OnMatadorEvent.
15
+ */
16
+ export interface MatadorEventHandlerMetadata {
17
+ readonly eventClass: EventClass<unknown>;
18
+ readonly options: OnMatadorEventOptions;
19
+ readonly methodName: string;
20
+ }
21
+ /**
22
+ * NestJS-specific options that extend MatadorConfig.
23
+ */
24
+ export interface NestMatadorOptions {
25
+ /** Optional lifecycle hooks */
26
+ readonly hooks?: MatadorHooks | undefined;
27
+ /**
28
+ * Additional events to register (for events without decorated subscribers).
29
+ * Maps event class to subscriber stubs or external subscribers.
30
+ */
31
+ readonly additionalEvents?: Map<EventClass<unknown>, AnySubscriber[]> | undefined;
32
+ /**
33
+ * Whether to auto-start consuming.
34
+ * Default: true
35
+ */
36
+ readonly autoStart?: boolean | undefined;
37
+ /**
38
+ * Which NestJS lifecycle hook to start Matador on.
39
+ * - 'onModuleInit': Start when MatadorModule initializes (earliest)
40
+ * - 'onApplicationBootstrap': Start after all modules init (default, recommended)
41
+ *
42
+ * Use 'onModuleInit' if other modules depend on Matador being connected
43
+ * during their own onModuleInit/onApplicationBootstrap hooks.
44
+ *
45
+ * Default: 'onApplicationBootstrap'
46
+ */
47
+ readonly startOn?: 'onModuleInit' | 'onApplicationBootstrap' | undefined;
48
+ /**
49
+ * Which NestJS lifecycle hook to shutdown Matador on.
50
+ * - 'onModuleDestroy': Shutdown when MatadorModule is destroyed (earliest)
51
+ * - 'beforeApplicationShutdown': Shutdown before app closes (default, recommended)
52
+ * - 'onApplicationShutdown': Shutdown when app closes (latest)
53
+ *
54
+ * Use 'beforeApplicationShutdown' to ensure Matador finishes processing
55
+ * before other modules start their shutdown.
56
+ *
57
+ * Default: 'beforeApplicationShutdown'
58
+ */
59
+ readonly shutdownOn?: 'onModuleDestroy' | 'beforeApplicationShutdown' | 'onApplicationShutdown' | undefined;
60
+ /**
61
+ * Global subscriber options applied to all discovered subscribers.
62
+ */
63
+ readonly globalSubscriberDefaults?: Pick<BaseSubscriberOptions, 'importance'> & {
64
+ readonly idempotent?: Idempotency | undefined;
65
+ } | undefined;
66
+ }
67
+ /**
68
+ * Configuration options for MatadorModule.
69
+ * Derived from MatadorConfig (minus schema which is auto-generated) plus NestJS-specific options.
70
+ */
71
+ export interface MatadorModuleOptions extends Omit<MatadorConfig, 'schema'>, NestMatadorOptions {
72
+ }
73
+ /**
74
+ * Factory interface for creating MatadorModuleOptions.
75
+ */
76
+ export interface MatadorOptionsFactory {
77
+ createMatadorOptions(): Promise<MatadorModuleOptions> | MatadorModuleOptions;
78
+ }
79
+ /**
80
+ * Async configuration options for MatadorModule.forRootAsync().
81
+ */
82
+ export interface MatadorModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
83
+ readonly inject?: readonly unknown[] | undefined;
84
+ readonly useFactory?: (...args: any[]) => Promise<MatadorModuleOptions> | MatadorModuleOptions;
85
+ readonly useClass?: Type<MatadorOptionsFactory> | undefined;
86
+ readonly useExisting?: Type<MatadorOptionsFactory> | undefined;
87
+ }
88
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAE1C;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EACtB,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC,GACzC,SAAS,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEzC;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,wBAAwB,GAAG,SAAS,CAAC;IAEzE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,UAAU,CAAC,EAChB,iBAAiB,GACjB,2BAA2B,GAC3B,uBAAuB,GACvB,SAAS,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAC9B,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,GAAG;QAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;KAC/C,GACD,SAAS,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,oBACf,SAAQ,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,EACnC,kBAAkB;CAAG;AAEzB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oBAAoB,IAAI,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;CAC9E;AAED;;GAEG;AACH,MAAM,WAAW,yBACf,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAEpB,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC,GAAG,SAAS,CAAC;CAChE"}
package/dist/types.js ADDED
@@ -0,0 +1 @@
1
+ export {};
package/package.json ADDED
@@ -0,0 +1,61 @@
1
+ {
2
+ "name": "@zdavison/matador-nest",
3
+ "version": "2.0.1",
4
+ "description": "NestJS integration for Matador event processing library",
5
+ "type": "module",
6
+ "main": "./dist/index.cjs",
7
+ "module": "./dist/index.js",
8
+ "types": "./dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "import": {
12
+ "types": "./dist/index.d.ts",
13
+ "default": "./dist/index.js"
14
+ },
15
+ "require": {
16
+ "types": "./dist/index.d.cts",
17
+ "default": "./dist/index.cjs"
18
+ }
19
+ },
20
+ "./testing": {
21
+ "import": {
22
+ "types": "./dist/testing.d.ts",
23
+ "default": "./dist/testing.js"
24
+ },
25
+ "require": {
26
+ "types": "./dist/testing.d.cts",
27
+ "default": "./dist/testing.cjs"
28
+ }
29
+ }
30
+ },
31
+ "scripts": {
32
+ "build": "rm -rf dist *.tsbuildinfo && tsup && tsc --build && cp dist/index.d.ts dist/index.d.cts && cp dist/testing.d.ts dist/testing.d.cts",
33
+ "test": "bun test",
34
+ "test:watch": "bun test --watch",
35
+ "lint": "bunx biome check .",
36
+ "lint:fix": "bunx biome check . --fix",
37
+ "typecheck": "tsc --noEmit",
38
+ "clean": "rm -rf dist"
39
+ },
40
+ "peerDependencies": {
41
+ "@nestjs/common": "^10.0.0 || ^11.0.0",
42
+ "@nestjs/core": "^10.0.0 || ^11.0.0",
43
+ "@zdavison/matador": "^2.0.1",
44
+ "reflect-metadata": "^0.1.13 || ^0.2.0"
45
+ },
46
+ "devDependencies": {
47
+ "@nestjs/common": "^10.0.0",
48
+ "@nestjs/core": "^10.0.0",
49
+ "@nestjs/testing": "^10.0.0",
50
+ "@swc/core": "^1.15.3",
51
+ "@zdavison/matador": "2.0.0",
52
+ "reflect-metadata": "^0.2.0",
53
+ "rxjs": "^7.0.0",
54
+ "tsup": "^8.3.5"
55
+ },
56
+ "engines": {
57
+ "node": ">=18.0.0"
58
+ },
59
+ "keywords": ["nestjs", "events", "messaging", "queue", "rabbitmq", "matador"],
60
+ "license": "MIT"
61
+ }
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Metadata key for storing event handler metadata on methods.
3
+ */
4
+ export const MATADOR_EVENT_HANDLER = Symbol('MATADOR_EVENT_HANDLER');
5
+
6
+ /**
7
+ * Metadata key for storing a list of all event handlers on a class.
8
+ */
9
+ export const MATADOR_EVENT_HANDLERS = Symbol('MATADOR_EVENT_HANDLERS');
10
+
11
+ /**
12
+ * Injection token for module options.
13
+ */
14
+ export const MATADOR_OPTIONS = Symbol('MATADOR_OPTIONS');
@@ -0,0 +1,2 @@
1
+ export { OnMatadorEvent } from './on-matador-event.decorator.js';
2
+ export { MatadorSubscriber } from './matador-subscriber.decorator.js';
@@ -0,0 +1,27 @@
1
+ import { Injectable, type Type } from '@nestjs/common';
2
+
3
+ /**
4
+ * Optional class decorator that marks a class as a Matador subscriber.
5
+ * Classes with @OnMatadorEvent methods are auto-discovered, so this decorator
6
+ * is optional. Use it for explicit documentation or when you want to ensure
7
+ * a class is treated as a subscriber even if it has no decorated methods yet.
8
+ *
9
+ * @example
10
+ * ```typescript
11
+ * @MatadorSubscriber()
12
+ * @Injectable()
13
+ * export class NotificationService {
14
+ * @OnMatadorEvent(UserCreatedEvent, { description: '...' })
15
+ * async onUserCreated(envelope: Envelope<...>) {
16
+ * // ...
17
+ * }
18
+ * }
19
+ * ```
20
+ */
21
+ export function MatadorSubscriber(): ClassDecorator {
22
+ return (target: object): void => {
23
+ // Ensure the class is injectable (apply @Injectable if not already)
24
+ // This is a no-op if @Injectable was already applied
25
+ Injectable()(target as Type<unknown>);
26
+ };
27
+ }
@@ -0,0 +1,68 @@
1
+ import type { EventClass } from '@zdavison/matador';
2
+ import { MATADOR_EVENT_HANDLER, MATADOR_EVENT_HANDLERS } from '../constants.js';
3
+ import type {
4
+ MatadorEventHandlerMetadata,
5
+ OnMatadorEventOptions,
6
+ } from '../types.js';
7
+
8
+ /**
9
+ * Method decorator that marks a method as a Matador event subscriber.
10
+ *
11
+ * @param eventClass - The event class to subscribe to
12
+ * @param options - Subscriber options (description is required)
13
+ *
14
+ * @example
15
+ * ```typescript
16
+ * @Injectable()
17
+ * export class NotificationService {
18
+ * @OnMatadorEvent(UserCreatedEvent, {
19
+ * description: 'Sends welcome email to new users',
20
+ * idempotent: 'yes',
21
+ * })
22
+ * async onUserCreated(envelope: Envelope<UserCreatedEvent['data']>) {
23
+ * await this.emailService.sendWelcome(envelope.data.email);
24
+ * }
25
+ * }
26
+ * ```
27
+ */
28
+ export function OnMatadorEvent<T>(
29
+ eventClass: EventClass<T>,
30
+ options: OnMatadorEventOptions,
31
+ ): (
32
+ target: object,
33
+ propertyKey: string | symbol,
34
+ descriptor: PropertyDescriptor,
35
+ ) => PropertyDescriptor {
36
+ return (
37
+ target: object,
38
+ propertyKey: string | symbol,
39
+ descriptor: PropertyDescriptor,
40
+ ): PropertyDescriptor => {
41
+ const metadata: MatadorEventHandlerMetadata = {
42
+ eventClass: eventClass as EventClass<unknown>,
43
+ options,
44
+ methodName: String(propertyKey),
45
+ };
46
+
47
+ // Store metadata on the method itself
48
+ if (descriptor.value != null) {
49
+ Reflect.defineMetadata(
50
+ MATADOR_EVENT_HANDLER,
51
+ metadata,
52
+ descriptor.value as object,
53
+ );
54
+ }
55
+
56
+ // Maintain a list of all handlers on the class for discovery
57
+ const existingHandlers: MatadorEventHandlerMetadata[] =
58
+ Reflect.getMetadata(MATADOR_EVENT_HANDLERS, target.constructor) ?? [];
59
+
60
+ Reflect.defineMetadata(
61
+ MATADOR_EVENT_HANDLERS,
62
+ [...existingHandlers, metadata],
63
+ target.constructor,
64
+ );
65
+
66
+ return descriptor;
67
+ };
68
+ }
@@ -0,0 +1 @@
1
+ export { SubscriberDiscoveryService } from './subscriber-discovery.service.js';
@@ -0,0 +1,181 @@
1
+ import { Injectable, type OnModuleInit } from '@nestjs/common';
2
+ import { DiscoveryService } from '@nestjs/core';
3
+ import {
4
+ type AnySubscriber,
5
+ type Envelope,
6
+ type EventClass,
7
+ type MatadorSchema,
8
+ type SubscriberContext,
9
+ createSubscriber,
10
+ } from '@zdavison/matador';
11
+ import { MATADOR_EVENT_HANDLERS } from '../constants.js';
12
+ import type {
13
+ MatadorEventHandlerMetadata,
14
+ MatadorModuleOptions,
15
+ } from '../types.js';
16
+
17
+ /**
18
+ * Schema entry tuple type for building the schema.
19
+ */
20
+ type SchemaEntryTuple = [EventClass<unknown>, AnySubscriber[]];
21
+
22
+ /**
23
+ * Mutable schema type for building during discovery.
24
+ */
25
+ type MutableSchema = Record<string, SchemaEntryTuple>;
26
+
27
+ /**
28
+ * Service that discovers all @OnMatadorEvent decorated methods in the application
29
+ * and builds a Matador schema from them.
30
+ */
31
+ @Injectable()
32
+ export class SubscriberDiscoveryService implements OnModuleInit {
33
+ private schema: MutableSchema = {};
34
+ private discovered = false;
35
+
36
+ constructor(private readonly discoveryService: DiscoveryService) {}
37
+
38
+ onModuleInit(): void {
39
+ this.discoverSubscribers();
40
+ }
41
+
42
+ /**
43
+ * Discovers all @OnMatadorEvent decorated methods and builds the schema.
44
+ */
45
+ private discoverSubscribers(): void {
46
+ if (this.discovered) {
47
+ return;
48
+ }
49
+
50
+ const providers = this.discoveryService.getProviders();
51
+
52
+ for (const wrapper of providers) {
53
+ const { instance } = wrapper;
54
+ if (!instance || typeof instance !== 'object') {
55
+ continue;
56
+ }
57
+
58
+ const handlers: MatadorEventHandlerMetadata[] | undefined =
59
+ Reflect.getMetadata(MATADOR_EVENT_HANDLERS, instance.constructor);
60
+
61
+ if (!handlers || handlers.length === 0) {
62
+ continue;
63
+ }
64
+
65
+ for (const handler of handlers) {
66
+ this.registerHandler(instance, handler);
67
+ }
68
+ }
69
+
70
+ this.discovered = true;
71
+ }
72
+
73
+ /**
74
+ * Registers a single handler method as a subscriber.
75
+ */
76
+ private registerHandler(
77
+ instance: object,
78
+ metadata: MatadorEventHandlerMetadata,
79
+ ): void {
80
+ const { eventClass, options, methodName } = metadata;
81
+ const className = instance.constructor.name;
82
+
83
+ // Auto-generate name if not provided: ClassName.methodName
84
+ const subscriberName = options.name ?? `${className}.${methodName}`;
85
+
86
+ // Determine if this is a resumable subscriber
87
+ const isResumable = options.idempotent === 'resumable';
88
+
89
+ // Create the callback that calls the instance method
90
+ // biome-ignore lint/suspicious/noExplicitAny: Instance methods may have various signatures
91
+ const boundMethod = (instance as Record<string, any>)[methodName].bind(
92
+ instance,
93
+ );
94
+
95
+ // Create a subscriber that calls the instance method
96
+ const subscriber: AnySubscriber = isResumable
97
+ ? createSubscriber({
98
+ name: subscriberName,
99
+ description: options.description,
100
+ idempotent: 'resumable',
101
+ importance: options.importance,
102
+ targetQueue: options.targetQueue,
103
+ enabled: options.enabled,
104
+ callback: async (
105
+ envelope: Envelope<unknown>,
106
+ context: SubscriberContext,
107
+ ) => {
108
+ await boundMethod(envelope, context);
109
+ },
110
+ })
111
+ : createSubscriber({
112
+ name: subscriberName,
113
+ description: options.description,
114
+ idempotent: options.idempotent,
115
+ importance: options.importance,
116
+ targetQueue: options.targetQueue,
117
+ enabled: options.enabled,
118
+ callback: async (envelope: Envelope<unknown>) => {
119
+ await boundMethod(envelope);
120
+ },
121
+ });
122
+
123
+ // Add to schema
124
+ this.addToSchema(eventClass, subscriber);
125
+ }
126
+
127
+ /**
128
+ * Adds a subscriber to the schema for an event.
129
+ */
130
+ private addToSchema(
131
+ eventClass: EventClass<unknown>,
132
+ subscriber: AnySubscriber,
133
+ ): void {
134
+ const eventKey = eventClass.key;
135
+ const existing = this.schema[eventKey];
136
+
137
+ if (existing) {
138
+ // Add subscriber to existing event entry
139
+ const [existingEventClass, existingSubscribers] = existing;
140
+ this.schema[eventKey] = [
141
+ existingEventClass,
142
+ [...existingSubscribers, subscriber],
143
+ ];
144
+ } else {
145
+ // Create new entry
146
+ this.schema[eventKey] = [eventClass, [subscriber]];
147
+ }
148
+ }
149
+
150
+ /**
151
+ * Gets the discovered schema.
152
+ * Must be called after onModuleInit has run.
153
+ */
154
+ getSchema(): MatadorSchema {
155
+ return this.schema;
156
+ }
157
+
158
+ /**
159
+ * Gets the schema merged with additional events from options.
160
+ */
161
+ getMergedSchema(options: MatadorModuleOptions): MatadorSchema {
162
+ const mergedSchema: MutableSchema = { ...this.schema };
163
+
164
+ if (options.additionalEvents) {
165
+ for (const [eventClass, subscribers] of options.additionalEvents) {
166
+ const existing = mergedSchema[eventClass.key];
167
+ if (existing) {
168
+ const [existingEventClass, existingSubscribers] = existing;
169
+ mergedSchema[eventClass.key] = [
170
+ existingEventClass,
171
+ [...existingSubscribers, ...subscribers],
172
+ ];
173
+ } else {
174
+ mergedSchema[eventClass.key] = [eventClass, subscribers];
175
+ }
176
+ }
177
+ }
178
+
179
+ return mergedSchema;
180
+ }
181
+ }