@saga-bus/nestjs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dean Foran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# @saga-bus/nestjs
+
+NestJS module for saga-bus integration.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/nestjs
+```
+
+## Usage
+
+### Basic Setup
+
+```typescript
+// app.module.ts
+import { Module } from "@nestjs/common";
+import { SagaBusModule } from "@saga-bus/nestjs";
+import { InMemoryTransport } from "@saga-bus/transport-inmemory";
+import { InMemorySagaStore } from "@saga-bus/store-inmemory";
+
+@Module({
+  imports: [
+    SagaBusModule.forRoot({
+      transport: new InMemoryTransport(),
+      store: new InMemorySagaStore(),
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### Async Configuration
+
+```typescript
+SagaBusModule.forRootAsync({
+  imports: [ConfigModule],
+  useFactory: (config: ConfigService) => ({
+    transport: new RabbitMqTransport({
+      uri: config.get("RABBITMQ_URI"),
+    }),
+    store: new PostgresSagaStore({
+      pool: new Pool({ connectionString: config.get("DATABASE_URL") }),
+    }),
+  }),
+  inject: [ConfigService],
+});
+```
+
+## Decorators
+
+### @MessageHandler
+
+Handle specific message types:
+
+```typescript
+import { Injectable } from "@nestjs/common";
+import { MessageHandler } from "@saga-bus/nestjs";
+
+@Injectable()
+export class OrderHandlers {
+  @MessageHandler("OrderCreated")
+  async handleOrderCreated(message: OrderCreated) {
+    console.log("Order created:", message.payload);
+  }
+
+  @MessageHandler("OrderShipped")
+  async handleOrderShipped(message: OrderShipped) {
+    console.log("Order shipped:", message.payload);
+  }
+}
+```
+
+### @InjectSagaBus
+
+Inject the saga bus service:
+
+```typescript
+import { Injectable } from "@nestjs/common";
+import { InjectSagaBus, SagaBusService } from "@saga-bus/nestjs";
+
+@Injectable()
+export class OrderService {
+  constructor(@InjectSagaBus() private readonly sagaBus: SagaBusService) {}
+
+  async createOrder(data: CreateOrderDto) {
+    await this.sagaBus.publish(
+      { type: "OrderCreated", payload: data },
+      { endpoint: "orders" }
+    );
+  }
+}
+```
+
+## SagaBusService API
+
+```typescript
+// Publish a message
+await sagaBus.publish(message, options);
+
+// Get underlying transport
+const transport = sagaBus.getTransport();
+
+// Get underlying store
+const store = sagaBus.getStore();
+
+// Get middleware pipeline
+const middleware = sagaBus.getMiddleware();
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `transport` | `Transport` | required | Transport implementation |
+| `store` | `SagaStore` | required | Saga store implementation |
+| `middleware` | `SagaMiddleware[]` | `[]` | Middleware pipeline |
+| `autoStart` | `boolean` | `true` | Auto-start transport |
+| `autoStop` | `boolean` | `true` | Auto-stop on destroy |
+
+## Lifecycle
+
+The module automatically:
+
+- Starts the transport on module init (if `autoStart: true`)
+- Discovers and registers all `@MessageHandler` decorated methods
+- Stops the transport on module destroy (if `autoStop: true`)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,313 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  InjectSagaBus: () => InjectSagaBus,
+  MESSAGE_HANDLER_METADATA: () => MESSAGE_HANDLER_METADATA,
+  MessageExplorer: () => MessageExplorer,
+  MessageHandler: () => MessageHandler,
+  SAGA_BUS_TOKEN: () => SAGA_BUS_TOKEN,
+  SagaBusModule: () => SagaBusModule,
+  SagaBusService: () => SagaBusService
+});
+module.exports = __toCommonJS(index_exports);
+var import_reflect_metadata2 = require("reflect-metadata");
+
+// src/SagaBusModule.ts
+var import_common4 = require("@nestjs/common");
+var import_core2 = require("@nestjs/core");
+
+// src/SagaBusService.ts
+var import_common = require("@nestjs/common");
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+function _ts_param(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param, "_ts_param");
+var SAGA_BUS_OPTIONS = "SAGA_BUS_OPTIONS";
+var SagaBusService = class {
+  static {
+    __name(this, "SagaBusService");
+  }
+  transport;
+  store;
+  middleware;
+  autoStart;
+  autoStop;
+  constructor(options) {
+    this.transport = options.transport;
+    this.store = options.store;
+    this.middleware = options.middleware ?? [];
+    this.autoStart = options.autoStart ?? true;
+    this.autoStop = options.autoStop ?? true;
+  }
+  async onModuleInit() {
+    if (this.autoStart) {
+      await this.transport.start();
+    }
+  }
+  async onModuleDestroy() {
+    if (this.autoStop) {
+      await this.transport.stop();
+    }
+  }
+  /**
+  * Publish a message to the transport.
+  */
+  async publish(message, options) {
+    await this.transport.publish(message, options);
+  }
+  /**
+  * Get the underlying transport.
+  */
+  getTransport() {
+    return this.transport;
+  }
+  /**
+  * Get the underlying store.
+  */
+  getStore() {
+    return this.store;
+  }
+  /**
+  * Get the middleware pipeline.
+  */
+  getMiddleware() {
+    return this.middleware;
+  }
+};
+SagaBusService = _ts_decorate([
+  (0, import_common.Injectable)(),
+  _ts_param(0, (0, import_common.Inject)(SAGA_BUS_OPTIONS)),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof SagaBusModuleOptions === "undefined" ? Object : SagaBusModuleOptions
+  ])
+], SagaBusService);
+
+// src/MessageExplorer.ts
+var import_common2 = require("@nestjs/common");
+var import_core = require("@nestjs/core");
+
+// src/decorators/MessageHandler.decorator.ts
+var import_reflect_metadata = require("reflect-metadata");
+var MESSAGE_HANDLER_METADATA = "saga-bus:message-handler";
+function MessageHandler(messageType) {
+  return (target, propertyKey, _descriptor) => {
+    const handlers = Reflect.getMetadata(MESSAGE_HANDLER_METADATA, target.constructor) || [];
+    handlers.push({
+      messageType,
+      methodName: propertyKey
+    });
+    Reflect.defineMetadata(MESSAGE_HANDLER_METADATA, handlers, target.constructor);
+  };
+}
+__name(MessageHandler, "MessageHandler");
+
+// src/MessageExplorer.ts
+function _ts_decorate2(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate2, "_ts_decorate");
+function _ts_metadata2(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata2, "_ts_metadata");
+var MessageExplorer = class {
+  static {
+    __name(this, "MessageExplorer");
+  }
+  discoveryService;
+  sagaBusService;
+  constructor(discoveryService, sagaBusService) {
+    this.discoveryService = discoveryService;
+    this.sagaBusService = sagaBusService;
+  }
+  onModuleInit() {
+    this.exploreMessageHandlers();
+  }
+  exploreMessageHandlers() {
+    const providers = this.discoveryService.getProviders();
+    for (const wrapper of providers) {
+      const { instance, metatype } = wrapper;
+      if (!instance || !metatype) continue;
+      const handlers = Reflect.getMetadata(MESSAGE_HANDLER_METADATA, metatype) || [];
+      for (const handler of handlers) {
+        this.registerMessageHandler(handler, instance);
+      }
+    }
+  }
+  registerMessageHandler(handler, instance) {
+    const transport = this.sagaBusService.getTransport();
+    const method = instance[handler.methodName];
+    if (typeof method !== "function") {
+      return;
+    }
+    void transport.subscribe({
+      endpoint: handler.messageType
+    }, async (envelope) => {
+      await method.call(instance, envelope.payload, envelope);
+    });
+  }
+};
+MessageExplorer = _ts_decorate2([
+  (0, import_common2.Injectable)(),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    typeof import_core.DiscoveryService === "undefined" ? Object : import_core.DiscoveryService,
+    typeof SagaBusService === "undefined" ? Object : SagaBusService
+  ])
+], MessageExplorer);
+
+// src/decorators/InjectSagaBus.decorator.ts
+var import_common3 = require("@nestjs/common");
+var SAGA_BUS_TOKEN = "SAGA_BUS";
+function InjectSagaBus() {
+  return (0, import_common3.Inject)(SAGA_BUS_TOKEN);
+}
+__name(InjectSagaBus, "InjectSagaBus");
+
+// src/SagaBusModule.ts
+function _ts_decorate3(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate3, "_ts_decorate");
+var SagaBusModule = class _SagaBusModule {
+  static {
+    __name(this, "SagaBusModule");
+  }
+  /**
+  * Configure the module with static options.
+  */
+  static forRoot(options) {
+    return {
+      module: _SagaBusModule,
+      imports: [
+        import_core2.DiscoveryModule
+      ],
+      providers: [
+        {
+          provide: SAGA_BUS_OPTIONS,
+          useValue: options
+        },
+        SagaBusService,
+        {
+          provide: SAGA_BUS_TOKEN,
+          useExisting: SagaBusService
+        },
+        MessageExplorer
+      ],
+      exports: [
+        SagaBusService,
+        SAGA_BUS_TOKEN
+      ]
+    };
+  }
+  /**
+  * Configure the module with async options.
+  */
+  static forRootAsync(options) {
+    return {
+      module: _SagaBusModule,
+      imports: [
+        ...options.imports || [],
+        import_core2.DiscoveryModule
+      ],
+      providers: [
+        ...this.createAsyncProviders(options),
+        SagaBusService,
+        {
+          provide: SAGA_BUS_TOKEN,
+          useExisting: SagaBusService
+        },
+        MessageExplorer
+      ],
+      exports: [
+        SagaBusService,
+        SAGA_BUS_TOKEN
+      ]
+    };
+  }
+  static createAsyncProviders(options) {
+    if (options.useFactory) {
+      return [
+        {
+          provide: SAGA_BUS_OPTIONS,
+          useFactory: options.useFactory,
+          inject: options.inject || []
+        }
+      ];
+    }
+    const useClass = options.useClass || options.useExisting;
+    if (!useClass) {
+      throw new Error("Invalid async options: provide useFactory or useClass");
+    }
+    return [
+      {
+        provide: SAGA_BUS_OPTIONS,
+        useFactory: /* @__PURE__ */ __name(async (factory) => factory.createSagaBusOptions(), "useFactory"),
+        inject: [
+          useClass
+        ]
+      },
+      ...options.useClass ? [
+        {
+          provide: options.useClass,
+          useClass: options.useClass
+        }
+      ] : []
+    ];
+  }
+};
+SagaBusModule = _ts_decorate3([
+  (0, import_common4.Global)(),
+  (0, import_common4.Module)({})
+], SagaBusModule);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InjectSagaBus,
+  MESSAGE_HANDLER_METADATA,
+  MessageExplorer,
+  MessageHandler,
+  SAGA_BUS_TOKEN,
+  SagaBusModule,
+  SagaBusService
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/SagaBusModule.ts","../src/SagaBusService.ts","../src/MessageExplorer.ts","../src/decorators/MessageHandler.decorator.ts","../src/decorators/InjectSagaBus.decorator.ts"],"sourcesContent":["import \"reflect-metadata\";\n\nexport { SagaBusModule } from \"./SagaBusModule.js\";\nexport { SagaBusService } from \"./SagaBusService.js\";\nexport { MessageExplorer } from \"./MessageExplorer.js\";\nexport {\n  MessageHandler,\n  MESSAGE_HANDLER_METADATA,\n  type MessageHandlerMetadata,\n} from \"./decorators/MessageHandler.decorator.js\";\nexport {\n  InjectSagaBus,\n  SAGA_BUS_TOKEN,\n} from \"./decorators/InjectSagaBus.decorator.js\";\nexport type {\n  SagaBusModuleOptions,\n  SagaBusModuleAsyncOptions,\n  SagaBusOptionsFactory,\n} from \"./interfaces/index.js\";\n","import {\n  Module,\n  DynamicModule,\n  Global,\n  type Provider,\n  type Type,\n} from \"@nestjs/common\";\nimport { DiscoveryModule } from \"@nestjs/core\";\nimport type {\n  SagaBusModuleOptions,\n  SagaBusModuleAsyncOptions,\n  SagaBusOptionsFactory,\n} from \"./interfaces/module-options.interface.js\";\nimport { SagaBusService, SAGA_BUS_OPTIONS } from \"./SagaBusService.js\";\nimport { MessageExplorer } from \"./MessageExplorer.js\";\nimport { SAGA_BUS_TOKEN } from \"./decorators/InjectSagaBus.decorator.js\";\n\n/**\n * NestJS module for saga-bus integration.\n *\n * @example\n * ```typescript\n * @Module({\n *   imports: [\n *     SagaBusModule.forRoot({\n *       transport: new InMemoryTransport(),\n *       store: new InMemorySagaStore(),\n *     }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n */\n@Global()\n@Module({})\nexport class SagaBusModule {\n  /**\n   * Configure the module with static options.\n   */\n  static forRoot(options: SagaBusModuleOptions): DynamicModule {\n    return {\n      module: SagaBusModule,\n      imports: [DiscoveryModule],\n      providers: [\n        {\n          provide: SAGA_BUS_OPTIONS,\n          useValue: options,\n        },\n        SagaBusService,\n        {\n          provide: SAGA_BUS_TOKEN,\n          useExisting: SagaBusService,\n        },\n        MessageExplorer,\n      ],\n      exports: [SagaBusService, SAGA_BUS_TOKEN],\n    };\n  }\n\n  /**\n   * Configure the module with async options.\n   */\n  static forRootAsync(options: SagaBusModuleAsyncOptions): DynamicModule {\n    return {\n      module: SagaBusModule,\n      imports: [...(options.imports || []), DiscoveryModule],\n      providers: [\n        ...this.createAsyncProviders(options),\n        SagaBusService,\n        {\n          provide: SAGA_BUS_TOKEN,\n          useExisting: SagaBusService,\n        },\n        MessageExplorer,\n      ],\n      exports: [SagaBusService, SAGA_BUS_TOKEN],\n    };\n  }\n\n  private static createAsyncProviders(\n    options: SagaBusModuleAsyncOptions\n  ): Provider[] {\n    if (options.useFactory) {\n      return [\n        {\n          provide: SAGA_BUS_OPTIONS,\n          useFactory: options.useFactory,\n          inject: options.inject || [],\n        },\n      ];\n    }\n\n    const useClass = options.useClass || options.useExisting;\n    if (!useClass) {\n      throw new Error(\n        \"Invalid async options: provide useFactory or useClass\"\n      );\n    }\n\n    return [\n      {\n        provide: SAGA_BUS_OPTIONS,\n        useFactory: async (factory: SagaBusOptionsFactory) =>\n          factory.createSagaBusOptions(),\n        inject: [useClass as Type<SagaBusOptionsFactory>],\n      },\n      ...(options.useClass\n        ? [{ provide: options.useClass, useClass: options.useClass }]\n        : []),\n    ];\n  }\n}\n","import {\n  Injectable,\n  OnModuleInit,\n  OnModuleDestroy,\n  Inject,\n} from \"@nestjs/common\";\nimport type {\n  Transport,\n  SagaStore,\n  SagaMiddleware,\n  SagaState,\n  BaseMessage,\n  TransportPublishOptions,\n} from \"@saga-bus/core\";\nimport type { SagaBusModuleOptions } from \"./interfaces/module-options.interface.js\";\n\nexport const SAGA_BUS_OPTIONS = \"SAGA_BUS_OPTIONS\";\n\n/**\n * Service for interacting with the saga bus.\n *\n * Provides access to transport and store, and handles\n * lifecycle management (auto start/stop).\n */\n@Injectable()\nexport class SagaBusService implements OnModuleInit, OnModuleDestroy {\n  private readonly transport: Transport;\n  private readonly store: SagaStore<SagaState>;\n  private readonly middleware: SagaMiddleware[];\n  private readonly autoStart: boolean;\n  private readonly autoStop: boolean;\n\n  constructor(@Inject(SAGA_BUS_OPTIONS) options: SagaBusModuleOptions) {\n    this.transport = options.transport;\n    this.store = options.store;\n    this.middleware = options.middleware ?? [];\n    this.autoStart = options.autoStart ?? true;\n    this.autoStop = options.autoStop ?? true;\n  }\n\n  async onModuleInit(): Promise<void> {\n    if (this.autoStart) {\n      await this.transport.start();\n    }\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    if (this.autoStop) {\n      await this.transport.stop();\n    }\n  }\n\n  /**\n   * Publish a message to the transport.\n   */\n  async publish<TMessage extends BaseMessage>(\n    message: TMessage,\n    options: TransportPublishOptions\n  ): Promise<void> {\n    await this.transport.publish(message, options);\n  }\n\n  /**\n   * Get the underlying transport.\n   */\n  getTransport(): Transport {\n    return this.transport;\n  }\n\n  /**\n   * Get the underlying store.\n   */\n  getStore(): SagaStore<SagaState> {\n    return this.store;\n  }\n\n  /**\n   * Get the middleware pipeline.\n   */\n  getMiddleware(): SagaMiddleware[] {\n    return this.middleware;\n  }\n}\n","import { Injectable, OnModuleInit } from \"@nestjs/common\";\nimport { DiscoveryService } from \"@nestjs/core\";\nimport type { MessageEnvelope } from \"@saga-bus/core\";\nimport {\n  MESSAGE_HANDLER_METADATA,\n  type MessageHandlerMetadata,\n} from \"./decorators/MessageHandler.decorator.js\";\nimport { SagaBusService } from \"./SagaBusService.js\";\n\n/**\n * Discovers and registers message handlers marked with @MessageHandler.\n */\n@Injectable()\nexport class MessageExplorer implements OnModuleInit {\n  constructor(\n    private readonly discoveryService: DiscoveryService,\n    private readonly sagaBusService: SagaBusService\n  ) {}\n\n  onModuleInit(): void {\n    this.exploreMessageHandlers();\n  }\n\n  private exploreMessageHandlers(): void {\n    const providers = this.discoveryService.getProviders();\n\n    for (const wrapper of providers) {\n      const { instance, metatype } = wrapper;\n      if (!instance || !metatype) continue;\n\n      const handlers: MessageHandlerMetadata[] =\n        Reflect.getMetadata(MESSAGE_HANDLER_METADATA, metatype) || [];\n\n      for (const handler of handlers) {\n        this.registerMessageHandler(handler, instance);\n      }\n    }\n  }\n\n  private registerMessageHandler(\n    handler: MessageHandlerMetadata,\n    instance: object\n  ): void {\n    const transport = this.sagaBusService.getTransport();\n    const method = (\n      instance as Record<string | symbol, (...args: unknown[]) => unknown>\n    )[handler.methodName];\n\n    if (typeof method !== \"function\") {\n      return;\n    }\n\n    // Subscribe to the message type\n    void transport.subscribe(\n      { endpoint: handler.messageType },\n      async (envelope: MessageEnvelope) => {\n        await method.call(instance, envelope.payload, envelope);\n      }\n    );\n  }\n}\n","import \"reflect-metadata\";\n\nexport const MESSAGE_HANDLER_METADATA = \"saga-bus:message-handler\";\n\n/**\n * Metadata for a message handler.\n */\nexport interface MessageHandlerMetadata {\n  messageType: string;\n  methodName: string | symbol;\n}\n\n/**\n * Decorator to mark a method as a message handler.\n *\n * @example\n * ```typescript\n * @Injectable()\n * export class NotificationService {\n *   @MessageHandler(\"OrderCreated\")\n *   async onOrderCreated(payload: OrderCreatedPayload): Promise<void> {\n *     // Handle message\n *   }\n * }\n * ```\n */\nexport function MessageHandler(messageType: string): MethodDecorator {\n  return (\n    target: object,\n    propertyKey: string | symbol,\n    _descriptor: PropertyDescriptor\n  ) => {\n    const handlers: MessageHandlerMetadata[] =\n      Reflect.getMetadata(MESSAGE_HANDLER_METADATA, target.constructor) || [];\n    handlers.push({\n      messageType,\n      methodName: propertyKey,\n    });\n    Reflect.defineMetadata(\n      MESSAGE_HANDLER_METADATA,\n      handlers,\n      target.constructor\n    );\n  };\n}\n","import { Inject } from \"@nestjs/common\";\n\nexport const SAGA_BUS_TOKEN = \"SAGA_BUS\";\n\n/**\n * Decorator to inject the SagaBusService.\n */\nexport function InjectSagaBus(): ParameterDecorator {\n  return Inject(SAGA_BUS_TOKEN);\n}\n"],"mappings":"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","names":["import_reflect_metadata","import_common","import_core","SAGA_BUS_OPTIONS","SagaBusService","transport","store","middleware","autoStart","autoStop","options","onModuleInit","start","onModuleDestroy","stop","publish","message","getTransport","getStore","getMiddleware","import_common","MESSAGE_HANDLER_METADATA","MessageHandler","messageType","target","propertyKey","_descriptor","handlers","Reflect","getMetadata","push","methodName","defineMetadata","MessageExplorer","discoveryService","sagaBusService","onModuleInit","exploreMessageHandlers","providers","getProviders","wrapper","instance","metatype","handlers","Reflect","getMetadata","MESSAGE_HANDLER_METADATA","handler","registerMessageHandler","transport","getTransport","method","methodName","subscribe","endpoint","messageType","envelope","call","payload","import_common","SAGA_BUS_TOKEN","InjectSagaBus","Inject","SagaBusModule","forRoot","options","module","imports","DiscoveryModule","providers","provide","SAGA_BUS_OPTIONS","useValue","SagaBusService","SAGA_BUS_TOKEN","useExisting","MessageExplorer","exports","forRootAsync","createAsyncProviders","useFactory","inject","useClass","Error","factory","createSagaBusOptions"]}

package/dist/index.d.cts

@@ -0,0 +1,163 @@
+import { ModuleMetadata, InjectionToken, Type, DynamicModule, OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { Transport, SagaStore, SagaState, SagaMiddleware, BaseMessage, TransportPublishOptions } from '@saga-bus/core';
+import { DiscoveryService } from '@nestjs/core';
+
+/**
+ * Options for configuring the SagaBusModule.
+ */
+interface SagaBusModuleOptions {
+    /**
+     * Transport implementation for message delivery.
+     */
+    transport: Transport;
+    /**
+     * Saga store implementation for state persistence.
+     */
+    store: SagaStore<SagaState>;
+    /**
+     * Middleware pipeline for message processing.
+     */
+    middleware?: SagaMiddleware[];
+    /**
+     * Whether to automatically start the transport.
+     * @default true
+     */
+    autoStart?: boolean;
+    /**
+     * Whether to automatically stop the transport on module destroy.
+     * @default true
+     */
+    autoStop?: boolean;
+}
+/**
+ * Factory for creating module options asynchronously.
+ */
+interface SagaBusOptionsFactory {
+    createSagaBusOptions(): Promise<SagaBusModuleOptions> | SagaBusModuleOptions;
+}
+/**
+ * Async options for configuring the SagaBusModule.
+ */
+interface SagaBusModuleAsyncOptions extends Pick<ModuleMetadata, "imports"> {
+    /**
+     * Factory function for creating options.
+     */
+    useFactory?: (...args: unknown[]) => Promise<SagaBusModuleOptions> | SagaBusModuleOptions;
+    /**
+     * Dependencies to inject into the factory.
+     */
+    inject?: InjectionToken[];
+    /**
+     * Class that implements SagaBusOptionsFactory.
+     */
+    useClass?: Type<SagaBusOptionsFactory>;
+    /**
+     * Existing provider to use.
+     */
+    useExisting?: Type<SagaBusOptionsFactory>;
+}
+
+/**
+ * NestJS module for saga-bus integration.
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     SagaBusModule.forRoot({
+ *       transport: new InMemoryTransport(),
+ *       store: new InMemorySagaStore(),
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+declare class SagaBusModule {
+    /**
+     * Configure the module with static options.
+     */
+    static forRoot(options: SagaBusModuleOptions): DynamicModule;
+    /**
+     * Configure the module with async options.
+     */
+    static forRootAsync(options: SagaBusModuleAsyncOptions): DynamicModule;
+    private static createAsyncProviders;
+}
+
+/**
+ * Service for interacting with the saga bus.
+ *
+ * Provides access to transport and store, and handles
+ * lifecycle management (auto start/stop).
+ */
+declare class SagaBusService implements OnModuleInit, OnModuleDestroy {
+    private readonly transport;
+    private readonly store;
+    private readonly middleware;
+    private readonly autoStart;
+    private readonly autoStop;
+    constructor(options: SagaBusModuleOptions);
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    /**
+     * Publish a message to the transport.
+     */
+    publish<TMessage extends BaseMessage>(message: TMessage, options: TransportPublishOptions): Promise<void>;
+    /**
+     * Get the underlying transport.
+     */
+    getTransport(): Transport;
+    /**
+     * Get the underlying store.
+     */
+    getStore(): SagaStore<SagaState>;
+    /**
+     * Get the middleware pipeline.
+     */
+    getMiddleware(): SagaMiddleware[];
+}
+
+/**
+ * Discovers and registers message handlers marked with @MessageHandler.
+ */
+declare class MessageExplorer implements OnModuleInit {
+    private readonly discoveryService;
+    private readonly sagaBusService;
+    constructor(discoveryService: DiscoveryService, sagaBusService: SagaBusService);
+    onModuleInit(): void;
+    private exploreMessageHandlers;
+    private registerMessageHandler;
+}
+
+declare const MESSAGE_HANDLER_METADATA = "saga-bus:message-handler";
+/**
+ * Metadata for a message handler.
+ */
+interface MessageHandlerMetadata {
+    messageType: string;
+    methodName: string | symbol;
+}
+/**
+ * Decorator to mark a method as a message handler.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class NotificationService {
+ *   @MessageHandler("OrderCreated")
+ *   async onOrderCreated(payload: OrderCreatedPayload): Promise<void> {
+ *     // Handle message
+ *   }
+ * }
+ * ```
+ */
+declare function MessageHandler(messageType: string): MethodDecorator;
+
+declare const SAGA_BUS_TOKEN = "SAGA_BUS";
+/**
+ * Decorator to inject the SagaBusService.
+ */
+declare function InjectSagaBus(): ParameterDecorator;
+
+export { InjectSagaBus, MESSAGE_HANDLER_METADATA, MessageExplorer, MessageHandler, type MessageHandlerMetadata, SAGA_BUS_TOKEN, SagaBusModule, type SagaBusModuleAsyncOptions, type SagaBusModuleOptions, type SagaBusOptionsFactory, SagaBusService };

package/dist/index.d.ts

@@ -0,0 +1,163 @@
+import { ModuleMetadata, InjectionToken, Type, DynamicModule, OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { Transport, SagaStore, SagaState, SagaMiddleware, BaseMessage, TransportPublishOptions } from '@saga-bus/core';
+import { DiscoveryService } from '@nestjs/core';
+
+/**
+ * Options for configuring the SagaBusModule.
+ */
+interface SagaBusModuleOptions {
+    /**
+     * Transport implementation for message delivery.
+     */
+    transport: Transport;
+    /**
+     * Saga store implementation for state persistence.
+     */
+    store: SagaStore<SagaState>;
+    /**
+     * Middleware pipeline for message processing.
+     */
+    middleware?: SagaMiddleware[];
+    /**
+     * Whether to automatically start the transport.
+     * @default true
+     */
+    autoStart?: boolean;
+    /**
+     * Whether to automatically stop the transport on module destroy.
+     * @default true
+     */
+    autoStop?: boolean;
+}
+/**
+ * Factory for creating module options asynchronously.
+ */
+interface SagaBusOptionsFactory {
+    createSagaBusOptions(): Promise<SagaBusModuleOptions> | SagaBusModuleOptions;
+}
+/**
+ * Async options for configuring the SagaBusModule.
+ */
+interface SagaBusModuleAsyncOptions extends Pick<ModuleMetadata, "imports"> {
+    /**
+     * Factory function for creating options.
+     */
+    useFactory?: (...args: unknown[]) => Promise<SagaBusModuleOptions> | SagaBusModuleOptions;
+    /**
+     * Dependencies to inject into the factory.
+     */
+    inject?: InjectionToken[];
+    /**
+     * Class that implements SagaBusOptionsFactory.
+     */
+    useClass?: Type<SagaBusOptionsFactory>;
+    /**
+     * Existing provider to use.
+     */
+    useExisting?: Type<SagaBusOptionsFactory>;
+}
+
+/**
+ * NestJS module for saga-bus integration.
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     SagaBusModule.forRoot({
+ *       transport: new InMemoryTransport(),
+ *       store: new InMemorySagaStore(),
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+declare class SagaBusModule {
+    /**
+     * Configure the module with static options.
+     */
+    static forRoot(options: SagaBusModuleOptions): DynamicModule;
+    /**
+     * Configure the module with async options.
+     */
+    static forRootAsync(options: SagaBusModuleAsyncOptions): DynamicModule;
+    private static createAsyncProviders;
+}
+
+/**
+ * Service for interacting with the saga bus.
+ *
+ * Provides access to transport and store, and handles
+ * lifecycle management (auto start/stop).
+ */
+declare class SagaBusService implements OnModuleInit, OnModuleDestroy {
+    private readonly transport;
+    private readonly store;
+    private readonly middleware;
+    private readonly autoStart;
+    private readonly autoStop;
+    constructor(options: SagaBusModuleOptions);
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    /**
+     * Publish a message to the transport.
+     */
+    publish<TMessage extends BaseMessage>(message: TMessage, options: TransportPublishOptions): Promise<void>;
+    /**
+     * Get the underlying transport.
+     */
+    getTransport(): Transport;
+    /**
+     * Get the underlying store.
+     */
+    getStore(): SagaStore<SagaState>;
+    /**
+     * Get the middleware pipeline.
+     */
+    getMiddleware(): SagaMiddleware[];
+}
+
+/**
+ * Discovers and registers message handlers marked with @MessageHandler.
+ */
+declare class MessageExplorer implements OnModuleInit {
+    private readonly discoveryService;
+    private readonly sagaBusService;
+    constructor(discoveryService: DiscoveryService, sagaBusService: SagaBusService);
+    onModuleInit(): void;
+    private exploreMessageHandlers;
+    private registerMessageHandler;
+}
+
+declare const MESSAGE_HANDLER_METADATA = "saga-bus:message-handler";
+/**
+ * Metadata for a message handler.
+ */
+interface MessageHandlerMetadata {
+    messageType: string;
+    methodName: string | symbol;
+}
+/**
+ * Decorator to mark a method as a message handler.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class NotificationService {
+ *   @MessageHandler("OrderCreated")
+ *   async onOrderCreated(payload: OrderCreatedPayload): Promise<void> {
+ *     // Handle message
+ *   }
+ * }
+ * ```
+ */
+declare function MessageHandler(messageType: string): MethodDecorator;
+
+declare const SAGA_BUS_TOKEN = "SAGA_BUS";
+/**
+ * Decorator to inject the SagaBusService.
+ */
+declare function InjectSagaBus(): ParameterDecorator;
+
+export { InjectSagaBus, MESSAGE_HANDLER_METADATA, MessageExplorer, MessageHandler, type MessageHandlerMetadata, SAGA_BUS_TOKEN, SagaBusModule, type SagaBusModuleAsyncOptions, type SagaBusModuleOptions, type SagaBusOptionsFactory, SagaBusService };

package/dist/index.js

@@ -0,0 +1,284 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/index.ts
+import "reflect-metadata";
+
+// src/SagaBusModule.ts
+import { Module, Global } from "@nestjs/common";
+import { DiscoveryModule } from "@nestjs/core";
+
+// src/SagaBusService.ts
+import { Injectable, Inject } from "@nestjs/common";
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+function _ts_param(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param, "_ts_param");
+var SAGA_BUS_OPTIONS = "SAGA_BUS_OPTIONS";
+var SagaBusService = class {
+  static {
+    __name(this, "SagaBusService");
+  }
+  transport;
+  store;
+  middleware;
+  autoStart;
+  autoStop;
+  constructor(options) {
+    this.transport = options.transport;
+    this.store = options.store;
+    this.middleware = options.middleware ?? [];
+    this.autoStart = options.autoStart ?? true;
+    this.autoStop = options.autoStop ?? true;
+  }
+  async onModuleInit() {
+    if (this.autoStart) {
+      await this.transport.start();
+    }
+  }
+  async onModuleDestroy() {
+    if (this.autoStop) {
+      await this.transport.stop();
+    }
+  }
+  /**
+  * Publish a message to the transport.
+  */
+  async publish(message, options) {
+    await this.transport.publish(message, options);
+  }
+  /**
+  * Get the underlying transport.
+  */
+  getTransport() {
+    return this.transport;
+  }
+  /**
+  * Get the underlying store.
+  */
+  getStore() {
+    return this.store;
+  }
+  /**
+  * Get the middleware pipeline.
+  */
+  getMiddleware() {
+    return this.middleware;
+  }
+};
+SagaBusService = _ts_decorate([
+  Injectable(),
+  _ts_param(0, Inject(SAGA_BUS_OPTIONS)),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof SagaBusModuleOptions === "undefined" ? Object : SagaBusModuleOptions
+  ])
+], SagaBusService);
+
+// src/MessageExplorer.ts
+import { Injectable as Injectable2 } from "@nestjs/common";
+import { DiscoveryService } from "@nestjs/core";
+
+// src/decorators/MessageHandler.decorator.ts
+import "reflect-metadata";
+var MESSAGE_HANDLER_METADATA = "saga-bus:message-handler";
+function MessageHandler(messageType) {
+  return (target, propertyKey, _descriptor) => {
+    const handlers = Reflect.getMetadata(MESSAGE_HANDLER_METADATA, target.constructor) || [];
+    handlers.push({
+      messageType,
+      methodName: propertyKey
+    });
+    Reflect.defineMetadata(MESSAGE_HANDLER_METADATA, handlers, target.constructor);
+  };
+}
+__name(MessageHandler, "MessageHandler");
+
+// src/MessageExplorer.ts
+function _ts_decorate2(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate2, "_ts_decorate");
+function _ts_metadata2(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata2, "_ts_metadata");
+var MessageExplorer = class {
+  static {
+    __name(this, "MessageExplorer");
+  }
+  discoveryService;
+  sagaBusService;
+  constructor(discoveryService, sagaBusService) {
+    this.discoveryService = discoveryService;
+    this.sagaBusService = sagaBusService;
+  }
+  onModuleInit() {
+    this.exploreMessageHandlers();
+  }
+  exploreMessageHandlers() {
+    const providers = this.discoveryService.getProviders();
+    for (const wrapper of providers) {
+      const { instance, metatype } = wrapper;
+      if (!instance || !metatype) continue;
+      const handlers = Reflect.getMetadata(MESSAGE_HANDLER_METADATA, metatype) || [];
+      for (const handler of handlers) {
+        this.registerMessageHandler(handler, instance);
+      }
+    }
+  }
+  registerMessageHandler(handler, instance) {
+    const transport = this.sagaBusService.getTransport();
+    const method = instance[handler.methodName];
+    if (typeof method !== "function") {
+      return;
+    }
+    void transport.subscribe({
+      endpoint: handler.messageType
+    }, async (envelope) => {
+      await method.call(instance, envelope.payload, envelope);
+    });
+  }
+};
+MessageExplorer = _ts_decorate2([
+  Injectable2(),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
+    typeof SagaBusService === "undefined" ? Object : SagaBusService
+  ])
+], MessageExplorer);
+
+// src/decorators/InjectSagaBus.decorator.ts
+import { Inject as Inject2 } from "@nestjs/common";
+var SAGA_BUS_TOKEN = "SAGA_BUS";
+function InjectSagaBus() {
+  return Inject2(SAGA_BUS_TOKEN);
+}
+__name(InjectSagaBus, "InjectSagaBus");
+
+// src/SagaBusModule.ts
+function _ts_decorate3(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate3, "_ts_decorate");
+var SagaBusModule = class _SagaBusModule {
+  static {
+    __name(this, "SagaBusModule");
+  }
+  /**
+  * Configure the module with static options.
+  */
+  static forRoot(options) {
+    return {
+      module: _SagaBusModule,
+      imports: [
+        DiscoveryModule
+      ],
+      providers: [
+        {
+          provide: SAGA_BUS_OPTIONS,
+          useValue: options
+        },
+        SagaBusService,
+        {
+          provide: SAGA_BUS_TOKEN,
+          useExisting: SagaBusService
+        },
+        MessageExplorer
+      ],
+      exports: [
+        SagaBusService,
+        SAGA_BUS_TOKEN
+      ]
+    };
+  }
+  /**
+  * Configure the module with async options.
+  */
+  static forRootAsync(options) {
+    return {
+      module: _SagaBusModule,
+      imports: [
+        ...options.imports || [],
+        DiscoveryModule
+      ],
+      providers: [
+        ...this.createAsyncProviders(options),
+        SagaBusService,
+        {
+          provide: SAGA_BUS_TOKEN,
+          useExisting: SagaBusService
+        },
+        MessageExplorer
+      ],
+      exports: [
+        SagaBusService,
+        SAGA_BUS_TOKEN
+      ]
+    };
+  }
+  static createAsyncProviders(options) {
+    if (options.useFactory) {
+      return [
+        {
+          provide: SAGA_BUS_OPTIONS,
+          useFactory: options.useFactory,
+          inject: options.inject || []
+        }
+      ];
+    }
+    const useClass = options.useClass || options.useExisting;
+    if (!useClass) {
+      throw new Error("Invalid async options: provide useFactory or useClass");
+    }
+    return [
+      {
+        provide: SAGA_BUS_OPTIONS,
+        useFactory: /* @__PURE__ */ __name(async (factory) => factory.createSagaBusOptions(), "useFactory"),
+        inject: [
+          useClass
+        ]
+      },
+      ...options.useClass ? [
+        {
+          provide: options.useClass,
+          useClass: options.useClass
+        }
+      ] : []
+    ];
+  }
+};
+SagaBusModule = _ts_decorate3([
+  Global(),
+  Module({})
+], SagaBusModule);
+export {
+  InjectSagaBus,
+  MESSAGE_HANDLER_METADATA,
+  MessageExplorer,
+  MessageHandler,
+  SAGA_BUS_TOKEN,
+  SagaBusModule,
+  SagaBusService
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/SagaBusModule.ts","../src/SagaBusService.ts","../src/MessageExplorer.ts","../src/decorators/MessageHandler.decorator.ts","../src/decorators/InjectSagaBus.decorator.ts"],"sourcesContent":["import \"reflect-metadata\";\n\nexport { SagaBusModule } from \"./SagaBusModule.js\";\nexport { SagaBusService } from \"./SagaBusService.js\";\nexport { MessageExplorer } from \"./MessageExplorer.js\";\nexport {\n  MessageHandler,\n  MESSAGE_HANDLER_METADATA,\n  type MessageHandlerMetadata,\n} from \"./decorators/MessageHandler.decorator.js\";\nexport {\n  InjectSagaBus,\n  SAGA_BUS_TOKEN,\n} from \"./decorators/InjectSagaBus.decorator.js\";\nexport type {\n  SagaBusModuleOptions,\n  SagaBusModuleAsyncOptions,\n  SagaBusOptionsFactory,\n} from \"./interfaces/index.js\";\n","import {\n  Module,\n  DynamicModule,\n  Global,\n  type Provider,\n  type Type,\n} from \"@nestjs/common\";\nimport { DiscoveryModule } from \"@nestjs/core\";\nimport type {\n  SagaBusModuleOptions,\n  SagaBusModuleAsyncOptions,\n  SagaBusOptionsFactory,\n} from \"./interfaces/module-options.interface.js\";\nimport { SagaBusService, SAGA_BUS_OPTIONS } from \"./SagaBusService.js\";\nimport { MessageExplorer } from \"./MessageExplorer.js\";\nimport { SAGA_BUS_TOKEN } from \"./decorators/InjectSagaBus.decorator.js\";\n\n/**\n * NestJS module for saga-bus integration.\n *\n * @example\n * ```typescript\n * @Module({\n *   imports: [\n *     SagaBusModule.forRoot({\n *       transport: new InMemoryTransport(),\n *       store: new InMemorySagaStore(),\n *     }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n */\n@Global()\n@Module({})\nexport class SagaBusModule {\n  /**\n   * Configure the module with static options.\n   */\n  static forRoot(options: SagaBusModuleOptions): DynamicModule {\n    return {\n      module: SagaBusModule,\n      imports: [DiscoveryModule],\n      providers: [\n        {\n          provide: SAGA_BUS_OPTIONS,\n          useValue: options,\n        },\n        SagaBusService,\n        {\n          provide: SAGA_BUS_TOKEN,\n          useExisting: SagaBusService,\n        },\n        MessageExplorer,\n      ],\n      exports: [SagaBusService, SAGA_BUS_TOKEN],\n    };\n  }\n\n  /**\n   * Configure the module with async options.\n   */\n  static forRootAsync(options: SagaBusModuleAsyncOptions): DynamicModule {\n    return {\n      module: SagaBusModule,\n      imports: [...(options.imports || []), DiscoveryModule],\n      providers: [\n        ...this.createAsyncProviders(options),\n        SagaBusService,\n        {\n          provide: SAGA_BUS_TOKEN,\n          useExisting: SagaBusService,\n        },\n        MessageExplorer,\n      ],\n      exports: [SagaBusService, SAGA_BUS_TOKEN],\n    };\n  }\n\n  private static createAsyncProviders(\n    options: SagaBusModuleAsyncOptions\n  ): Provider[] {\n    if (options.useFactory) {\n      return [\n        {\n          provide: SAGA_BUS_OPTIONS,\n          useFactory: options.useFactory,\n          inject: options.inject || [],\n        },\n      ];\n    }\n\n    const useClass = options.useClass || options.useExisting;\n    if (!useClass) {\n      throw new Error(\n        \"Invalid async options: provide useFactory or useClass\"\n      );\n    }\n\n    return [\n      {\n        provide: SAGA_BUS_OPTIONS,\n        useFactory: async (factory: SagaBusOptionsFactory) =>\n          factory.createSagaBusOptions(),\n        inject: [useClass as Type<SagaBusOptionsFactory>],\n      },\n      ...(options.useClass\n        ? [{ provide: options.useClass, useClass: options.useClass }]\n        : []),\n    ];\n  }\n}\n","import {\n  Injectable,\n  OnModuleInit,\n  OnModuleDestroy,\n  Inject,\n} from \"@nestjs/common\";\nimport type {\n  Transport,\n  SagaStore,\n  SagaMiddleware,\n  SagaState,\n  BaseMessage,\n  TransportPublishOptions,\n} from \"@saga-bus/core\";\nimport type { SagaBusModuleOptions } from \"./interfaces/module-options.interface.js\";\n\nexport const SAGA_BUS_OPTIONS = \"SAGA_BUS_OPTIONS\";\n\n/**\n * Service for interacting with the saga bus.\n *\n * Provides access to transport and store, and handles\n * lifecycle management (auto start/stop).\n */\n@Injectable()\nexport class SagaBusService implements OnModuleInit, OnModuleDestroy {\n  private readonly transport: Transport;\n  private readonly store: SagaStore<SagaState>;\n  private readonly middleware: SagaMiddleware[];\n  private readonly autoStart: boolean;\n  private readonly autoStop: boolean;\n\n  constructor(@Inject(SAGA_BUS_OPTIONS) options: SagaBusModuleOptions) {\n    this.transport = options.transport;\n    this.store = options.store;\n    this.middleware = options.middleware ?? [];\n    this.autoStart = options.autoStart ?? true;\n    this.autoStop = options.autoStop ?? true;\n  }\n\n  async onModuleInit(): Promise<void> {\n    if (this.autoStart) {\n      await this.transport.start();\n    }\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    if (this.autoStop) {\n      await this.transport.stop();\n    }\n  }\n\n  /**\n   * Publish a message to the transport.\n   */\n  async publish<TMessage extends BaseMessage>(\n    message: TMessage,\n    options: TransportPublishOptions\n  ): Promise<void> {\n    await this.transport.publish(message, options);\n  }\n\n  /**\n   * Get the underlying transport.\n   */\n  getTransport(): Transport {\n    return this.transport;\n  }\n\n  /**\n   * Get the underlying store.\n   */\n  getStore(): SagaStore<SagaState> {\n    return this.store;\n  }\n\n  /**\n   * Get the middleware pipeline.\n   */\n  getMiddleware(): SagaMiddleware[] {\n    return this.middleware;\n  }\n}\n","import { Injectable, OnModuleInit } from \"@nestjs/common\";\nimport { DiscoveryService } from \"@nestjs/core\";\nimport type { MessageEnvelope } from \"@saga-bus/core\";\nimport {\n  MESSAGE_HANDLER_METADATA,\n  type MessageHandlerMetadata,\n} from \"./decorators/MessageHandler.decorator.js\";\nimport { SagaBusService } from \"./SagaBusService.js\";\n\n/**\n * Discovers and registers message handlers marked with @MessageHandler.\n */\n@Injectable()\nexport class MessageExplorer implements OnModuleInit {\n  constructor(\n    private readonly discoveryService: DiscoveryService,\n    private readonly sagaBusService: SagaBusService\n  ) {}\n\n  onModuleInit(): void {\n    this.exploreMessageHandlers();\n  }\n\n  private exploreMessageHandlers(): void {\n    const providers = this.discoveryService.getProviders();\n\n    for (const wrapper of providers) {\n      const { instance, metatype } = wrapper;\n      if (!instance || !metatype) continue;\n\n      const handlers: MessageHandlerMetadata[] =\n        Reflect.getMetadata(MESSAGE_HANDLER_METADATA, metatype) || [];\n\n      for (const handler of handlers) {\n        this.registerMessageHandler(handler, instance);\n      }\n    }\n  }\n\n  private registerMessageHandler(\n    handler: MessageHandlerMetadata,\n    instance: object\n  ): void {\n    const transport = this.sagaBusService.getTransport();\n    const method = (\n      instance as Record<string | symbol, (...args: unknown[]) => unknown>\n    )[handler.methodName];\n\n    if (typeof method !== \"function\") {\n      return;\n    }\n\n    // Subscribe to the message type\n    void transport.subscribe(\n      { endpoint: handler.messageType },\n      async (envelope: MessageEnvelope) => {\n        await method.call(instance, envelope.payload, envelope);\n      }\n    );\n  }\n}\n","import \"reflect-metadata\";\n\nexport const MESSAGE_HANDLER_METADATA = \"saga-bus:message-handler\";\n\n/**\n * Metadata for a message handler.\n */\nexport interface MessageHandlerMetadata {\n  messageType: string;\n  methodName: string | symbol;\n}\n\n/**\n * Decorator to mark a method as a message handler.\n *\n * @example\n * ```typescript\n * @Injectable()\n * export class NotificationService {\n *   @MessageHandler(\"OrderCreated\")\n *   async onOrderCreated(payload: OrderCreatedPayload): Promise<void> {\n *     // Handle message\n *   }\n * }\n * ```\n */\nexport function MessageHandler(messageType: string): MethodDecorator {\n  return (\n    target: object,\n    propertyKey: string | symbol,\n    _descriptor: PropertyDescriptor\n  ) => {\n    const handlers: MessageHandlerMetadata[] =\n      Reflect.getMetadata(MESSAGE_HANDLER_METADATA, target.constructor) || [];\n    handlers.push({\n      messageType,\n      methodName: propertyKey,\n    });\n    Reflect.defineMetadata(\n      MESSAGE_HANDLER_METADATA,\n      handlers,\n      target.constructor\n    );\n  };\n}\n","import { Inject } from \"@nestjs/common\";\n\nexport const SAGA_BUS_TOKEN = \"SAGA_BUS\";\n\n/**\n * Decorator to inject the SagaBusService.\n */\nexport function InjectSagaBus(): ParameterDecorator {\n  return Inject(SAGA_BUS_TOKEN);\n}\n"],"mappings":"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","names":["Module","Global","DiscoveryModule","Injectable","Inject","SAGA_BUS_OPTIONS","SagaBusService","transport","store","middleware","autoStart","autoStop","options","onModuleInit","start","onModuleDestroy","stop","publish","message","getTransport","getStore","getMiddleware","Injectable","DiscoveryService","MESSAGE_HANDLER_METADATA","MessageHandler","messageType","target","propertyKey","_descriptor","handlers","Reflect","getMetadata","push","methodName","defineMetadata","MessageExplorer","discoveryService","sagaBusService","onModuleInit","exploreMessageHandlers","providers","getProviders","wrapper","instance","metatype","handlers","Reflect","getMetadata","MESSAGE_HANDLER_METADATA","handler","registerMessageHandler","transport","getTransport","method","methodName","subscribe","endpoint","messageType","envelope","call","payload","Inject","SAGA_BUS_TOKEN","InjectSagaBus","Inject","SagaBusModule","forRoot","options","module","imports","DiscoveryModule","providers","provide","SAGA_BUS_OPTIONS","useValue","SagaBusService","SAGA_BUS_TOKEN","useExisting","MessageExplorer","exports","forRootAsync","createAsyncProviders","useFactory","inject","useClass","Error","factory","createSagaBusOptions"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@saga-bus/nestjs",
+  "version": "0.1.0",
+  "description": "NestJS module for saga-bus",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deanforan/saga-bus.git",
+    "directory": "packages/nestjs"
+  },
+  "keywords": [
+    "saga",
+    "message-bus",
+    "nestjs",
+    "module",
+    "dependency-injection"
+  ],
+  "dependencies": {
+    "@saga-bus/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.4.0",
+    "@nestjs/core": "^10.4.0",
+    "@nestjs/testing": "^10.4.0",
+    "@swc/core": "^1.15.3",
+    "@types/node": "^20.0.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.8.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.0.0",
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0",
+    "@saga-bus/store-inmemory": "1.0.0",
+    "@saga-bus/transport-inmemory": "1.0.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/core": ">=10.0.0",
+    "reflect-metadata": ">=0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}