@amqp-contract/worker-nestjs 0.12.0 → 0.14.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { AmqpConnectionManagerOptions, ConnectionUrl } from "amqp-connection-manager";
 import { DynamicModule, ModuleMetadata, OnModuleDestroy, OnModuleInit, Type } from "@nestjs/common";
 import { WorkerInferSafeConsumerHandlers, WorkerInferSafeConsumerHandlers as WorkerInferSafeConsumerHandlers$1, defineHandler, defineHandlers } from "@amqp-contract/worker";
-import { ContractDefinition } from "@amqp-contract/contract";
+import { ContractDefinitionInput } from "@amqp-contract/contract";
 
 //#region src/worker.service.d.ts
 
@@ -27,7 +27,7 @@ import { ContractDefinition } from "@amqp-contract/contract";
  * };
  * ```
  */
-type AmqpWorkerModuleOptions<TContract extends ContractDefinition> = {
+type AmqpWorkerModuleOptions<TContract extends ContractDefinitionInput> = {
   /** The AMQP contract definition specifying consumers and their message schemas */
   contract: TContract;
   /** Message handlers for each consumer defined in the contract. Use defineHandlers to create type-safe handlers. */
@@ -71,7 +71,7 @@ type AmqpWorkerModuleOptions<TContract extends ContractDefinition> = {
  * // and stops gracefully when the application shuts down
  * ```
  */
-declare class AmqpWorkerService<TContract extends ContractDefinition> implements OnModuleInit, OnModuleDestroy {
+declare class AmqpWorkerService<TContract extends ContractDefinitionInput> implements OnModuleInit, OnModuleDestroy {
   private readonly options;
   private worker;
   constructor(options: AmqpWorkerModuleOptions<TContract>);
@@ -100,11 +100,11 @@ declare class AmqpWorkerService<TContract extends ContractDefinition> implements
 /**
  * Factory function return type for async module configuration
  */
-type AmqpWorkerModuleOptionsFactory<TContract extends ContractDefinition> = AmqpWorkerModuleOptions<TContract> | Promise<AmqpWorkerModuleOptions<TContract>>;
+type AmqpWorkerModuleOptionsFactory<TContract extends ContractDefinitionInput> = AmqpWorkerModuleOptions<TContract> | Promise<AmqpWorkerModuleOptions<TContract>>;
 /**
  * Options for async module configuration using factory pattern
  */
-type AmqpWorkerModuleAsyncOptions<TContract extends ContractDefinition> = {
+type AmqpWorkerModuleAsyncOptions<TContract extends ContractDefinitionInput> = {
   /**
    * Factory function that returns the module options.
    * Can use injected dependencies to create configuration.
@@ -174,14 +174,14 @@ declare class AmqpWorkerModule {
    * @param options - The worker configuration options with contract and handlers
    * @returns A dynamic module for NestJS
    */
-  static forRoot<TContract extends ContractDefinition>(options: AmqpWorkerModuleOptions<TContract>): DynamicModule;
+  static forRoot<TContract extends ContractDefinitionInput>(options: AmqpWorkerModuleOptions<TContract>): DynamicModule;
   /**
    * Register the AMQP worker module with asynchronous configuration
    *
    * @param options - Async configuration options with factory function
    * @returns A dynamic module for NestJS
    */
-  static forRootAsync<TContract extends ContractDefinition>(options: AmqpWorkerModuleAsyncOptions<TContract>): DynamicModule;
+  static forRootAsync<TContract extends ContractDefinitionInput>(options: AmqpWorkerModuleAsyncOptions<TContract>): DynamicModule;
 }
 //#endregion
 //#region src/worker.module-definition.d.ts

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/worker.service.ts","../src/worker.module.ts","../src/worker.module-definition.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AA4BA;;;;;;;;AA6CA;;;;;;;;;;;;AC3DK,KDcO,uBCdP,CAAA,kBDciD,kBCdnB,CAAA,GAAA;EAAmB;EAC1B,QAAA,EDehB,SCfgB;EAAxB;EACgC,QAAA,EDgBxB,iCChBwB,CDgBQ,SChBR,CAAA;EAAxB;EAAR,IAAA,EDkBI,aClBJ,EAAA;EAAO;EAKC,iBAAA,CAAA,EDeU,4BCfkB,GAAA,SAAA;CAAmB;;;;;;AAiE3D;;;;;;;;;;;;;AClFA;;;;;;;;;;;;;;;;cFsEa,oCAAoC,+BACpC,cAAc;;;uBAMG,wBAAwB;;;;;;;;;;;kBAa9B;;;;;;;;qBAWG;;;;;;;AA7E3B,KCdK,8BDc8B,CAAA,kBCdmB,kBDcnB,CAAA,GCb/B,uBDa+B,CCbP,SDaO,CAAA,GCZ/B,ODY+B,CCZvB,uBDYuB,CCZC,SDYD,CAAA,CAAA;;;;AAIvB,KCXA,4BDWA,CAAA,kBCX+C,kBDW/C,CAAA,GAAA;EAEJ;;;AAuCR;EACiD,UAAA,EAAA,CAAA,GAAA,IAAA,EAAA,GAAA,EAAA,EAAA,GC/Cf,8BD+Ce,CC/CgB,SD+ChB,CAAA;EAOK;;;;EANzC,MAAA,CAAA,EAAA,CAAA,MAAA,GAAA,MAAA,GC3CiB,ID2CjB,CAAA,OAAA,CAAA,CAAA,EAAA;EAAc;;;YCvCf;;AA5BsD;;;;;;;;AAalE;;;;;;;AAiEA;;;;;;;;;;;;;AClFA;;;;;;;;;;;;;;;;;;;cDmFa,gBAAA;;;;;;;mCAOsB,6BACtB,wBAAwB,aAChC;;;;;;;wCAoBmC,6BAC3B,6BAA6B,aACrC;;;;;;;;cClHQ"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/worker.service.ts","../src/worker.module.ts","../src/worker.module-definition.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AA4BA;;;;;;;;AA6CA;;;;;;;;;;;;AC3DK,KDcO,uBCdP,CAAA,kBDciD,uBCdnB,CAAA,GAAA;EAAmB;EAC1B,QAAA,EDehB,SCfgB;EAAxB;EACgC,QAAA,EDgBxB,iCChBwB,CDgBQ,SChBR,CAAA;EAAxB;EAAR,IAAA,EDkBI,aClBJ,EAAA;EAAO;EAKC,iBAAA,CAAA,EDeU,4BCfkB,GAAA,SAAA;CAAmB;;;;;;AAiE3D;;;;;;;;;;;;;AClFA;;;;;;;;;;;;;;;;cFsEa,oCAAoC,oCACpC,cAAc;;;uBAMG,wBAAwB;;;;;;;;;;;kBAa9B;;;;;;;;qBAWG;;;;;;;AA7E3B,KCdK,8BDc8B,CAAA,kBCdmB,uBDcnB,CAAA,GCb/B,uBDa+B,CCbP,SDaO,CAAA,GCZ/B,ODY+B,CCZvB,uBDYuB,CCZC,SDYD,CAAA,CAAA;;;;AAIvB,KCXA,4BDWA,CAAA,kBCX+C,uBDW/C,CAAA,GAAA;EAEJ;;;AAuCR;EACiD,UAAA,EAAA,CAAA,GAAA,IAAA,EAAA,GAAA,EAAA,EAAA,GC/Cf,8BD+Ce,CC/CgB,SD+ChB,CAAA;EAOK;;;;EANzC,MAAA,CAAA,EAAA,CAAA,MAAA,GAAA,MAAA,GC3CiB,ID2CjB,CAAA,OAAA,CAAA,CAAA,EAAA;EAAc;;;YCvCf;;AA5B2D;;;;;;;;AAavE;;;;;;;AAiEA;;;;;;;;;;;;;AClFA;;;;;;;;;;;;;;;;;;;cDmFa,gBAAA;;;;;;;mCAOsB,kCACtB,wBAAwB,aAChC;;;;;;;wCAoBmC,kCAC3B,6BAA6B,aACrC;;;;;;;;cClHQ"}

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { DynamicModule, ModuleMetadata, OnModuleDestroy, OnModuleInit, Type } from "@nestjs/common";
 import { WorkerInferSafeConsumerHandlers, WorkerInferSafeConsumerHandlers as WorkerInferSafeConsumerHandlers$1, defineHandler, defineHandlers } from "@amqp-contract/worker";
 import { AmqpConnectionManagerOptions, ConnectionUrl } from "amqp-connection-manager";
-import { ContractDefinition } from "@amqp-contract/contract";
+import { ContractDefinitionInput } from "@amqp-contract/contract";
 
 //#region src/worker.service.d.ts
 
@@ -27,7 +27,7 @@ import { ContractDefinition } from "@amqp-contract/contract";
  * };
  * ```
  */
-type AmqpWorkerModuleOptions<TContract extends ContractDefinition> = {
+type AmqpWorkerModuleOptions<TContract extends ContractDefinitionInput> = {
   /** The AMQP contract definition specifying consumers and their message schemas */
   contract: TContract;
   /** Message handlers for each consumer defined in the contract. Use defineHandlers to create type-safe handlers. */
@@ -71,7 +71,7 @@ type AmqpWorkerModuleOptions<TContract extends ContractDefinition> = {
  * // and stops gracefully when the application shuts down
  * ```
  */
-declare class AmqpWorkerService<TContract extends ContractDefinition> implements OnModuleInit, OnModuleDestroy {
+declare class AmqpWorkerService<TContract extends ContractDefinitionInput> implements OnModuleInit, OnModuleDestroy {
   private readonly options;
   private worker;
   constructor(options: AmqpWorkerModuleOptions<TContract>);
@@ -100,11 +100,11 @@ declare class AmqpWorkerService<TContract extends ContractDefinition> implements
 /**
  * Factory function return type for async module configuration
  */
-type AmqpWorkerModuleOptionsFactory<TContract extends ContractDefinition> = AmqpWorkerModuleOptions<TContract> | Promise<AmqpWorkerModuleOptions<TContract>>;
+type AmqpWorkerModuleOptionsFactory<TContract extends ContractDefinitionInput> = AmqpWorkerModuleOptions<TContract> | Promise<AmqpWorkerModuleOptions<TContract>>;
 /**
  * Options for async module configuration using factory pattern
  */
-type AmqpWorkerModuleAsyncOptions<TContract extends ContractDefinition> = {
+type AmqpWorkerModuleAsyncOptions<TContract extends ContractDefinitionInput> = {
   /**
    * Factory function that returns the module options.
    * Can use injected dependencies to create configuration.
@@ -174,14 +174,14 @@ declare class AmqpWorkerModule {
    * @param options - The worker configuration options with contract and handlers
    * @returns A dynamic module for NestJS
    */
-  static forRoot<TContract extends ContractDefinition>(options: AmqpWorkerModuleOptions<TContract>): DynamicModule;
+  static forRoot<TContract extends ContractDefinitionInput>(options: AmqpWorkerModuleOptions<TContract>): DynamicModule;
   /**
    * Register the AMQP worker module with asynchronous configuration
    *
    * @param options - Async configuration options with factory function
    * @returns A dynamic module for NestJS
    */
-  static forRootAsync<TContract extends ContractDefinition>(options: AmqpWorkerModuleAsyncOptions<TContract>): DynamicModule;
+  static forRootAsync<TContract extends ContractDefinitionInput>(options: AmqpWorkerModuleAsyncOptions<TContract>): DynamicModule;
 }
 //#endregion
 //#region src/worker.module-definition.d.ts

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/worker.service.ts","../src/worker.module.ts","../src/worker.module-definition.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AA4BA;;;;;;;;AA6CA;;;;;;;;;;;;AC3DK,KDcO,uBCdP,CAAA,kBDciD,kBCdnB,CAAA,GAAA;EAAmB;EAC1B,QAAA,EDehB,SCfgB;EAAxB;EACgC,QAAA,EDgBxB,iCChBwB,CDgBQ,SChBR,CAAA;EAAxB;EAAR,IAAA,EDkBI,aClBJ,EAAA;EAAO;EAKC,iBAAA,CAAA,EDeU,4BCfkB,GAAA,SAAA;CAAmB;;;;;;AAiE3D;;;;;;;;;;;;;AClFA;;;;;;;;;;;;;;;;cFsEa,oCAAoC,+BACpC,cAAc;;;uBAMG,wBAAwB;;;;;;;;;;;kBAa9B;;;;;;;;qBAWG;;;;;;;AA7E3B,KCdK,8BDc8B,CAAA,kBCdmB,kBDcnB,CAAA,GCb/B,uBDa+B,CCbP,SDaO,CAAA,GCZ/B,ODY+B,CCZvB,uBDYuB,CCZC,SDYD,CAAA,CAAA;;;;AAIvB,KCXA,4BDWA,CAAA,kBCX+C,kBDW/C,CAAA,GAAA;EAEJ;;;AAuCR;EACiD,UAAA,EAAA,CAAA,GAAA,IAAA,EAAA,GAAA,EAAA,EAAA,GC/Cf,8BD+Ce,CC/CgB,SD+ChB,CAAA;EAOK;;;;EANzC,MAAA,CAAA,EAAA,CAAA,MAAA,GAAA,MAAA,GC3CiB,ID2CjB,CAAA,OAAA,CAAA,CAAA,EAAA;EAAc;;;YCvCf;;AA5BsD;;;;;;;;AAalE;;;;;;;AAiEA;;;;;;;;;;;;;AClFA;;;;;;;;;;;;;;;;;;;cDmFa,gBAAA;;;;;;;mCAOsB,6BACtB,wBAAwB,aAChC;;;;;;;wCAoBmC,6BAC3B,6BAA6B,aACrC;;;;;;;;cClHQ"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/worker.service.ts","../src/worker.module.ts","../src/worker.module-definition.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AA4BA;;;;;;;;AA6CA;;;;;;;;;;;;AC3DK,KDcO,uBCdP,CAAA,kBDciD,uBCdnB,CAAA,GAAA;EAAmB;EAC1B,QAAA,EDehB,SCfgB;EAAxB;EACgC,QAAA,EDgBxB,iCChBwB,CDgBQ,SChBR,CAAA;EAAxB;EAAR,IAAA,EDkBI,aClBJ,EAAA;EAAO;EAKC,iBAAA,CAAA,EDeU,4BCfkB,GAAA,SAAA;CAAmB;;;;;;AAiE3D;;;;;;;;;;;;;AClFA;;;;;;;;;;;;;;;;cFsEa,oCAAoC,oCACpC,cAAc;;;uBAMG,wBAAwB;;;;;;;;;;;kBAa9B;;;;;;;;qBAWG;;;;;;;AA7E3B,KCdK,8BDc8B,CAAA,kBCdmB,uBDcnB,CAAA,GCb/B,uBDa+B,CCbP,SDaO,CAAA,GCZ/B,ODY+B,CCZvB,uBDYuB,CCZC,SDYD,CAAA,CAAA;;;;AAIvB,KCXA,4BDWA,CAAA,kBCX+C,uBDW/C,CAAA,GAAA;EAEJ;;;AAuCR;EACiD,UAAA,EAAA,CAAA,GAAA,IAAA,EAAA,GAAA,EAAA,EAAA,GC/Cf,8BD+Ce,CC/CgB,SD+ChB,CAAA;EAOK;;;;EANzC,MAAA,CAAA,EAAA,CAAA,MAAA,GAAA,MAAA,GC3CiB,ID2CjB,CAAA,OAAA,CAAA,CAAA,EAAA;EAAc;;;YCvCf;;AA5B2D;;;;;;;;AAavE;;;;;;;AAiEA;;;;;;;;;;;;;AClFA;;;;;;;;;;;;;;;;;;;cDmFa,gBAAA;;;;;;;mCAOsB,kCACtB,wBAAwB,aAChC;;;;;;;wCAoBmC,kCAC3B,6BAA6B,aACrC;;;;;;;;cClHQ"}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["AmqpWorkerService","AmqpWorkerModule"],"sources":["../src/worker.module-definition.ts","../src/worker.service.ts","../src/worker.module.ts"],"sourcesContent":["/**\n * Injection token for AMQP worker module options\n * Used by NestJS DI system to inject configuration into AmqpWorkerService\n */\nexport const MODULE_OPTIONS_TOKEN = Symbol(\"AMQP_WORKER_MODULE_OPTIONS\");\n","import type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\nimport { Inject, Injectable, type OnModuleDestroy, type OnModuleInit } from \"@nestjs/common\";\nimport { TypedAmqpWorker, type WorkerInferSafeConsumerHandlers } from \"@amqp-contract/worker\";\nimport type { ContractDefinition } from \"@amqp-contract/contract\";\nimport { MODULE_OPTIONS_TOKEN } from \"./worker.module-definition.js\";\n\n/**\n * Configuration options for the AMQP worker NestJS module.\n *\n * @typeParam TContract - The contract definition type\n *\n * @example\n * ```typescript\n * import { defineHandlers, RetryableError } from '@amqp-contract/worker';\n * import { Future } from '@swan-io/boxed';\n *\n * const options: AmqpWorkerModuleOptions<typeof contract> = {\n *   contract: myContract,\n *   handlers: defineHandlers(myContract, {\n *     processOrder: ({ payload }) =>\n *       Future.fromPromise(processPayment(payload))\n *         .mapOk(() => undefined)\n *         .mapError((error) => new RetryableError('Payment failed', error))\n *   }),\n *   urls: ['amqp://localhost'],\n * };\n * ```\n */\nexport type AmqpWorkerModuleOptions<TContract extends ContractDefinition> = {\n  /** The AMQP contract definition specifying consumers and their message schemas */\n  contract: TContract;\n  /** Message handlers for each consumer defined in the contract. Use defineHandlers to create type-safe handlers. */\n  handlers: WorkerInferSafeConsumerHandlers<TContract>;\n  /** AMQP broker URL(s). Multiple URLs provide failover support */\n  urls: ConnectionUrl[];\n  /** Optional connection configuration (heartbeat, reconnect settings, etc.) */\n  connectionOptions?: AmqpConnectionManagerOptions | undefined;\n};\n\n/**\n * Type-safe AMQP worker service for NestJS applications.\n *\n * This service wraps {@link TypedAmqpWorker} and integrates it with the NestJS\n * lifecycle, automatically starting message consumption on module init and\n * cleaning up resources on module destroy.\n *\n * @typeParam TContract - The contract definition type\n *\n * @example\n * ```typescript\n * // In your module\n * import { AmqpWorkerModule } from '@amqp-contract/worker-nestjs';\n *\n * @Module({\n *   imports: [\n *     AmqpWorkerModule.forRoot({\n *       contract: myContract,\n *       handlers: {\n *         processOrder: async (message) => {\n *           console.log('Received order:', message.orderId);\n *           // Process the order...\n *         }\n *       },\n *       urls: ['amqp://localhost']\n *     })\n *   ]\n * })\n * export class AppModule {}\n *\n * // The worker automatically starts consuming messages when the module initializes\n * // and stops gracefully when the application shuts down\n * ```\n */\n@Injectable()\nexport class AmqpWorkerService<TContract extends ContractDefinition>\n  implements OnModuleInit, OnModuleDestroy\n{\n  private worker: TypedAmqpWorker<TContract> | null = null;\n\n  constructor(\n    @Inject(MODULE_OPTIONS_TOKEN)\n    private readonly options: AmqpWorkerModuleOptions<TContract>,\n  ) {}\n\n  /**\n   * Initialize the AMQP worker when the NestJS module starts.\n   *\n   * This lifecycle hook automatically creates and starts the worker,\n   * beginning message consumption from all configured consumers.\n   * The connection will be established in the background with\n   * automatic reconnection handling.\n   *\n   * @throws Error if the worker fails to start\n   */\n  async onModuleInit(): Promise<void> {\n    this.worker = await TypedAmqpWorker.create(this.options).resultToPromise();\n  }\n\n  /**\n   * Close the AMQP worker when the NestJS module is destroyed.\n   *\n   * This lifecycle hook ensures proper cleanup of resources when the\n   * NestJS application shuts down, gracefully stopping message consumption\n   * and closing the connection.\n   */\n  async onModuleDestroy(): Promise<void> {\n    if (this.worker) {\n      await this.worker.close().resultToPromise();\n      this.worker = null;\n    }\n  }\n}\n","import { type AmqpWorkerModuleOptions, AmqpWorkerService } from \"./worker.service.js\";\nimport {\n  type DynamicModule,\n  Module,\n  type ModuleMetadata,\n  type Provider,\n  type Type,\n} from \"@nestjs/common\";\nimport type { ContractDefinition } from \"@amqp-contract/contract\";\nimport { MODULE_OPTIONS_TOKEN } from \"./worker.module-definition.js\";\n\n/**\n * Factory function return type for async module configuration\n */\ntype AmqpWorkerModuleOptionsFactory<TContract extends ContractDefinition> =\n  | AmqpWorkerModuleOptions<TContract>\n  | Promise<AmqpWorkerModuleOptions<TContract>>;\n\n/**\n * Options for async module configuration using factory pattern\n */\nexport type AmqpWorkerModuleAsyncOptions<TContract extends ContractDefinition> = {\n  /**\n   * Factory function that returns the module options.\n   * Can use injected dependencies to create configuration.\n   */\n  // oxlint-disable-next-line no-explicit-any\n  useFactory: (...args: any[]) => AmqpWorkerModuleOptionsFactory<TContract>;\n  /**\n   * Optional dependencies to inject into the factory function.\n   * Can be a token (string/symbol) a class or a reference to a provider.\n   */\n  inject?: (string | symbol | Type<unknown>)[];\n  /**\n   * Optional list of imported modules that export providers needed by the factory\n   */\n  imports?: ModuleMetadata[\"imports\"];\n};\n\n/**\n * NestJS module for AMQP worker integration\n * This module provides type-safe AMQP worker functionality using @amqp-contract/worker\n * without relying on NestJS decorators (except for dependency injection)\n *\n * @typeParam TContract - The contract definition type for type-safe handlers\n *\n * @example\n * ```typescript\n * // Synchronous configuration\n * @Module({\n *   imports: [\n *     AmqpWorkerModule.forRoot({\n *       contract: myContract,\n *       handlers: {\n *         processOrder: async (message) => {\n *           // message is fully typed based on the contract\n *           console.log('Order:', message.orderId);\n *         }\n *       },\n *       urls: ['amqp://localhost']\n *     })\n *   ]\n * })\n * export class AppModule {}\n *\n * // Asynchronous configuration\n * @Module({\n *   imports: [\n *     AmqpWorkerModule.forRootAsync({\n *       imports: [ConfigModule],\n *       useFactory: (configService: ConfigService) => ({\n *         contract: myContract,\n *         handlers: {\n *           processOrder: async (message) => {\n *             console.log('Order:', message.orderId);\n *           }\n *         },\n *         urls: configService.get('AMQP_URLS')\n *       }),\n *       inject: [ConfigService]\n *     })\n *   ]\n * })\n * export class AppModule {}\n * ```\n */\n@Module({})\nexport class AmqpWorkerModule {\n  /**\n   * Register the AMQP worker module with synchronous configuration\n   *\n   * @param options - The worker configuration options with contract and handlers\n   * @returns A dynamic module for NestJS\n   */\n  static forRoot<TContract extends ContractDefinition>(\n    options: AmqpWorkerModuleOptions<TContract>,\n  ): DynamicModule {\n    return {\n      module: AmqpWorkerModule,\n      providers: [\n        {\n          provide: MODULE_OPTIONS_TOKEN,\n          useValue: options,\n        },\n        AmqpWorkerService,\n      ],\n      exports: [AmqpWorkerService],\n    };\n  }\n\n  /**\n   * Register the AMQP worker module with asynchronous configuration\n   *\n   * @param options - Async configuration options with factory function\n   * @returns A dynamic module for NestJS\n   */\n  static forRootAsync<TContract extends ContractDefinition>(\n    options: AmqpWorkerModuleAsyncOptions<TContract>,\n  ): DynamicModule {\n    const providers: Provider[] = [\n      {\n        provide: MODULE_OPTIONS_TOKEN,\n        useFactory: options.useFactory,\n        inject: options.inject ?? [],\n      },\n      AmqpWorkerService,\n    ];\n\n    return {\n      module: AmqpWorkerModule,\n      imports: options.imports ?? [],\n      providers,\n      exports: [AmqpWorkerService],\n    };\n  }\n}\n"],"mappings":";;;;;;;;AAIA,MAAa,uBAAuB,OAAO,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;ACsEjE,8BAAMA,oBAEb;CACE,AAAQ,SAA4C;CAEpD,YACE,AACiB,SACjB;EADiB;;;;;;;;;;;;CAanB,MAAM,eAA8B;AAClC,OAAK,SAAS,MAAM,gBAAgB,OAAO,KAAK,QAAQ,CAAC,iBAAiB;;;;;;;;;CAU5E,MAAM,kBAAiC;AACrC,MAAI,KAAK,QAAQ;AACf,SAAM,KAAK,OAAO,OAAO,CAAC,iBAAiB;AAC3C,QAAK,SAAS;;;;;CAnCnB,YAAY;oBAOR,OAAO,qBAAqB;;;;;;;ACO1B,iDAAMC,mBAAiB;;;;;;;CAO5B,OAAO,QACL,SACe;AACf,SAAO;GACL;GACA,WAAW,CACT;IACE,SAAS;IACT,UAAU;IACX,EACD,kBACD;GACD,SAAS,CAAC,kBAAkB;GAC7B;;;;;;;;CASH,OAAO,aACL,SACe;EACf,MAAM,YAAwB,CAC5B;GACE,SAAS;GACT,YAAY,QAAQ;GACpB,QAAQ,QAAQ,UAAU,EAAE;GAC7B,EACD,kBACD;AAED,SAAO;GACL;GACA,SAAS,QAAQ,WAAW,EAAE;GAC9B;GACA,SAAS,CAAC,kBAAkB;GAC7B;;;mDA/CJ,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.mjs","names":["AmqpWorkerService","AmqpWorkerModule"],"sources":["../src/worker.module-definition.ts","../src/worker.service.ts","../src/worker.module.ts"],"sourcesContent":["/**\n * Injection token for AMQP worker module options\n * Used by NestJS DI system to inject configuration into AmqpWorkerService\n */\nexport const MODULE_OPTIONS_TOKEN = Symbol(\"AMQP_WORKER_MODULE_OPTIONS\");\n","import type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\nimport { Inject, Injectable, type OnModuleDestroy, type OnModuleInit } from \"@nestjs/common\";\nimport { TypedAmqpWorker, type WorkerInferSafeConsumerHandlers } from \"@amqp-contract/worker\";\nimport type { ContractDefinitionInput } from \"@amqp-contract/contract\";\nimport { MODULE_OPTIONS_TOKEN } from \"./worker.module-definition.js\";\n\n/**\n * Configuration options for the AMQP worker NestJS module.\n *\n * @typeParam TContract - The contract definition type\n *\n * @example\n * ```typescript\n * import { defineHandlers, RetryableError } from '@amqp-contract/worker';\n * import { Future } from '@swan-io/boxed';\n *\n * const options: AmqpWorkerModuleOptions<typeof contract> = {\n *   contract: myContract,\n *   handlers: defineHandlers(myContract, {\n *     processOrder: ({ payload }) =>\n *       Future.fromPromise(processPayment(payload))\n *         .mapOk(() => undefined)\n *         .mapError((error) => new RetryableError('Payment failed', error))\n *   }),\n *   urls: ['amqp://localhost'],\n * };\n * ```\n */\nexport type AmqpWorkerModuleOptions<TContract extends ContractDefinitionInput> = {\n  /** The AMQP contract definition specifying consumers and their message schemas */\n  contract: TContract;\n  /** Message handlers for each consumer defined in the contract. Use defineHandlers to create type-safe handlers. */\n  handlers: WorkerInferSafeConsumerHandlers<TContract>;\n  /** AMQP broker URL(s). Multiple URLs provide failover support */\n  urls: ConnectionUrl[];\n  /** Optional connection configuration (heartbeat, reconnect settings, etc.) */\n  connectionOptions?: AmqpConnectionManagerOptions | undefined;\n};\n\n/**\n * Type-safe AMQP worker service for NestJS applications.\n *\n * This service wraps {@link TypedAmqpWorker} and integrates it with the NestJS\n * lifecycle, automatically starting message consumption on module init and\n * cleaning up resources on module destroy.\n *\n * @typeParam TContract - The contract definition type\n *\n * @example\n * ```typescript\n * // In your module\n * import { AmqpWorkerModule } from '@amqp-contract/worker-nestjs';\n *\n * @Module({\n *   imports: [\n *     AmqpWorkerModule.forRoot({\n *       contract: myContract,\n *       handlers: {\n *         processOrder: async (message) => {\n *           console.log('Received order:', message.orderId);\n *           // Process the order...\n *         }\n *       },\n *       urls: ['amqp://localhost']\n *     })\n *   ]\n * })\n * export class AppModule {}\n *\n * // The worker automatically starts consuming messages when the module initializes\n * // and stops gracefully when the application shuts down\n * ```\n */\n@Injectable()\nexport class AmqpWorkerService<TContract extends ContractDefinitionInput>\n  implements OnModuleInit, OnModuleDestroy\n{\n  private worker: TypedAmqpWorker<TContract> | null = null;\n\n  constructor(\n    @Inject(MODULE_OPTIONS_TOKEN)\n    private readonly options: AmqpWorkerModuleOptions<TContract>,\n  ) {}\n\n  /**\n   * Initialize the AMQP worker when the NestJS module starts.\n   *\n   * This lifecycle hook automatically creates and starts the worker,\n   * beginning message consumption from all configured consumers.\n   * The connection will be established in the background with\n   * automatic reconnection handling.\n   *\n   * @throws Error if the worker fails to start\n   */\n  async onModuleInit(): Promise<void> {\n    this.worker = await TypedAmqpWorker.create(this.options).resultToPromise();\n  }\n\n  /**\n   * Close the AMQP worker when the NestJS module is destroyed.\n   *\n   * This lifecycle hook ensures proper cleanup of resources when the\n   * NestJS application shuts down, gracefully stopping message consumption\n   * and closing the connection.\n   */\n  async onModuleDestroy(): Promise<void> {\n    if (this.worker) {\n      await this.worker.close().resultToPromise();\n      this.worker = null;\n    }\n  }\n}\n","import { type AmqpWorkerModuleOptions, AmqpWorkerService } from \"./worker.service.js\";\nimport {\n  type DynamicModule,\n  Module,\n  type ModuleMetadata,\n  type Provider,\n  type Type,\n} from \"@nestjs/common\";\nimport type { ContractDefinitionInput } from \"@amqp-contract/contract\";\nimport { MODULE_OPTIONS_TOKEN } from \"./worker.module-definition.js\";\n\n/**\n * Factory function return type for async module configuration\n */\ntype AmqpWorkerModuleOptionsFactory<TContract extends ContractDefinitionInput> =\n  | AmqpWorkerModuleOptions<TContract>\n  | Promise<AmqpWorkerModuleOptions<TContract>>;\n\n/**\n * Options for async module configuration using factory pattern\n */\nexport type AmqpWorkerModuleAsyncOptions<TContract extends ContractDefinitionInput> = {\n  /**\n   * Factory function that returns the module options.\n   * Can use injected dependencies to create configuration.\n   */\n  // oxlint-disable-next-line no-explicit-any\n  useFactory: (...args: any[]) => AmqpWorkerModuleOptionsFactory<TContract>;\n  /**\n   * Optional dependencies to inject into the factory function.\n   * Can be a token (string/symbol) a class or a reference to a provider.\n   */\n  inject?: (string | symbol | Type<unknown>)[];\n  /**\n   * Optional list of imported modules that export providers needed by the factory\n   */\n  imports?: ModuleMetadata[\"imports\"];\n};\n\n/**\n * NestJS module for AMQP worker integration\n * This module provides type-safe AMQP worker functionality using @amqp-contract/worker\n * without relying on NestJS decorators (except for dependency injection)\n *\n * @typeParam TContract - The contract definition type for type-safe handlers\n *\n * @example\n * ```typescript\n * // Synchronous configuration\n * @Module({\n *   imports: [\n *     AmqpWorkerModule.forRoot({\n *       contract: myContract,\n *       handlers: {\n *         processOrder: async (message) => {\n *           // message is fully typed based on the contract\n *           console.log('Order:', message.orderId);\n *         }\n *       },\n *       urls: ['amqp://localhost']\n *     })\n *   ]\n * })\n * export class AppModule {}\n *\n * // Asynchronous configuration\n * @Module({\n *   imports: [\n *     AmqpWorkerModule.forRootAsync({\n *       imports: [ConfigModule],\n *       useFactory: (configService: ConfigService) => ({\n *         contract: myContract,\n *         handlers: {\n *           processOrder: async (message) => {\n *             console.log('Order:', message.orderId);\n *           }\n *         },\n *         urls: configService.get('AMQP_URLS')\n *       }),\n *       inject: [ConfigService]\n *     })\n *   ]\n * })\n * export class AppModule {}\n * ```\n */\n@Module({})\nexport class AmqpWorkerModule {\n  /**\n   * Register the AMQP worker module with synchronous configuration\n   *\n   * @param options - The worker configuration options with contract and handlers\n   * @returns A dynamic module for NestJS\n   */\n  static forRoot<TContract extends ContractDefinitionInput>(\n    options: AmqpWorkerModuleOptions<TContract>,\n  ): DynamicModule {\n    return {\n      module: AmqpWorkerModule,\n      providers: [\n        {\n          provide: MODULE_OPTIONS_TOKEN,\n          useValue: options,\n        },\n        AmqpWorkerService,\n      ],\n      exports: [AmqpWorkerService],\n    };\n  }\n\n  /**\n   * Register the AMQP worker module with asynchronous configuration\n   *\n   * @param options - Async configuration options with factory function\n   * @returns A dynamic module for NestJS\n   */\n  static forRootAsync<TContract extends ContractDefinitionInput>(\n    options: AmqpWorkerModuleAsyncOptions<TContract>,\n  ): DynamicModule {\n    const providers: Provider[] = [\n      {\n        provide: MODULE_OPTIONS_TOKEN,\n        useFactory: options.useFactory,\n        inject: options.inject ?? [],\n      },\n      AmqpWorkerService,\n    ];\n\n    return {\n      module: AmqpWorkerModule,\n      imports: options.imports ?? [],\n      providers,\n      exports: [AmqpWorkerService],\n    };\n  }\n}\n"],"mappings":";;;;;;;;AAIA,MAAa,uBAAuB,OAAO,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;ACsEjE,8BAAMA,oBAEb;CACE,AAAQ,SAA4C;CAEpD,YACE,AACiB,SACjB;EADiB;;;;;;;;;;;;CAanB,MAAM,eAA8B;AAClC,OAAK,SAAS,MAAM,gBAAgB,OAAO,KAAK,QAAQ,CAAC,iBAAiB;;;;;;;;;CAU5E,MAAM,kBAAiC;AACrC,MAAI,KAAK,QAAQ;AACf,SAAM,KAAK,OAAO,OAAO,CAAC,iBAAiB;AAC3C,QAAK,SAAS;;;;;CAnCnB,YAAY;oBAOR,OAAO,qBAAqB;;;;;;;ACO1B,iDAAMC,mBAAiB;;;;;;;CAO5B,OAAO,QACL,SACe;AACf,SAAO;GACL;GACA,WAAW,CACT;IACE,SAAS;IACT,UAAU;IACX,EACD,kBACD;GACD,SAAS,CAAC,kBAAkB;GAC7B;;;;;;;;CASH,OAAO,aACL,SACe;EACf,MAAM,YAAwB,CAC5B;GACE,SAAS;GACT,YAAY,QAAQ;GACpB,QAAQ,QAAQ,UAAU,EAAE;GAC7B,EACD,kBACD;AAED,SAAO;GACL;GACA,SAAS,QAAQ,WAAW,EAAE;GAC9B;GACA,SAAS,CAAC,kBAAkB;GAC7B;;;mDA/CJ,OAAO,EAAE,CAAC"}

package/docs/index.md

@@ -8,7 +8,7 @@
 
 ### AmqpWorkerModule
 
-Defined in: [worker-nestjs/src/worker.module.ts:88](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.module.ts#L88)
+Defined in: [worker-nestjs/src/worker.module.ts:88](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.module.ts#L88)
 
 NestJS module for AMQP worker integration
 This module provides type-safe AMQP worker functionality using @amqp-contract/worker
@@ -79,7 +79,7 @@ new AmqpWorkerModule(): AmqpWorkerModule;
 static forRoot<TContract>(options): DynamicModule;
 ```
 
-Defined in: [worker-nestjs/src/worker.module.ts:95](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.module.ts#L95)
+Defined in: [worker-nestjs/src/worker.module.ts:95](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.module.ts#L95)
 
 Register the AMQP worker module with synchronous configuration
 
@@ -87,7 +87,7 @@ Register the AMQP worker module with synchronous configuration
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinition` |
+| `TContract` *extends* `ContractDefinitionInput` |
 
 ###### Parameters
 
@@ -107,7 +107,7 @@ A dynamic module for NestJS
 static forRootAsync<TContract>(options): DynamicModule;
 ```
 
-Defined in: [worker-nestjs/src/worker.module.ts:117](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.module.ts#L117)
+Defined in: [worker-nestjs/src/worker.module.ts:117](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.module.ts#L117)
 
 Register the AMQP worker module with asynchronous configuration
 
@@ -115,7 +115,7 @@ Register the AMQP worker module with asynchronous configuration
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinition` |
+| `TContract` *extends* `ContractDefinitionInput` |
 
 ###### Parameters
 
@@ -133,7 +133,7 @@ A dynamic module for NestJS
 
 ### AmqpWorkerService
 
-Defined in: [worker-nestjs/src/worker.service.ts:75](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.service.ts#L75)
+Defined in: [worker-nestjs/src/worker.service.ts:75](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.service.ts#L75)
 
 Type-safe AMQP worker service for NestJS applications.
 
@@ -171,7 +171,7 @@ export class AppModule {}
 
 | Type Parameter | Description |
 | ------ | ------ |
-| `TContract` *extends* `ContractDefinition` | The contract definition type |
+| `TContract` *extends* `ContractDefinitionInput` | The contract definition type |
 
 #### Implements
 
@@ -186,7 +186,7 @@ export class AppModule {}
 new AmqpWorkerService<TContract>(options): AmqpWorkerService<TContract>;
 ```
 
-Defined in: [worker-nestjs/src/worker.service.ts:80](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.service.ts#L80)
+Defined in: [worker-nestjs/src/worker.service.ts:80](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.service.ts#L80)
 
 ###### Parameters
 
@@ -206,7 +206,7 @@ Defined in: [worker-nestjs/src/worker.service.ts:80](https://github.com/btravers
 onModuleDestroy(): Promise<void>;
 ```
 
-Defined in: [worker-nestjs/src/worker.service.ts:106](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.service.ts#L106)
+Defined in: [worker-nestjs/src/worker.service.ts:106](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.service.ts#L106)
 
 Close the AMQP worker when the NestJS module is destroyed.
 
@@ -230,7 +230,7 @@ OnModuleDestroy.onModuleDestroy
 onModuleInit(): Promise<void>;
 ```
 
-Defined in: [worker-nestjs/src/worker.service.ts:95](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.service.ts#L95)
+Defined in: [worker-nestjs/src/worker.service.ts:95](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.service.ts#L95)
 
 Initialize the AMQP worker when the NestJS module starts.
 
@@ -261,7 +261,7 @@ OnModuleInit.onModuleInit
 type AmqpWorkerModuleAsyncOptions<TContract> = object;
 ```
 
-Defined in: [worker-nestjs/src/worker.module.ts:22](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.module.ts#L22)
+Defined in: [worker-nestjs/src/worker.module.ts:22](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.module.ts#L22)
 
 Options for async module configuration using factory pattern
 
@@ -269,15 +269,15 @@ Options for async module configuration using factory pattern
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinition` |
+| `TContract` *extends* `ContractDefinitionInput` |
 
 #### Properties
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="imports"></a> `imports?` | `ModuleMetadata`\[`"imports"`\] | Optional list of imported modules that export providers needed by the factory | [worker-nestjs/src/worker.module.ts:37](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.module.ts#L37) |
-| <a id="inject"></a> `inject?` | (`string` \| `symbol` \| `Type`&lt;`unknown`&gt;)[] | Optional dependencies to inject into the factory function. Can be a token (string/symbol) a class or a reference to a provider. | [worker-nestjs/src/worker.module.ts:33](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.module.ts#L33) |
-| <a id="usefactory"></a> `useFactory` | (...`args`) => `AmqpWorkerModuleOptionsFactory`&lt;`TContract`&gt; | Factory function that returns the module options. Can use injected dependencies to create configuration. | [worker-nestjs/src/worker.module.ts:28](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.module.ts#L28) |
+| <a id="imports"></a> `imports?` | `ModuleMetadata`\[`"imports"`\] | Optional list of imported modules that export providers needed by the factory | [worker-nestjs/src/worker.module.ts:37](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.module.ts#L37) |
+| <a id="inject"></a> `inject?` | (`string` \| `symbol` \| `Type`&lt;`unknown`&gt;)[] | Optional dependencies to inject into the factory function. Can be a token (string/symbol) a class or a reference to a provider. | [worker-nestjs/src/worker.module.ts:33](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.module.ts#L33) |
+| <a id="usefactory"></a> `useFactory` | (...`args`) => `AmqpWorkerModuleOptionsFactory`&lt;`TContract`&gt; | Factory function that returns the module options. Can use injected dependencies to create configuration. | [worker-nestjs/src/worker.module.ts:28](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.module.ts#L28) |
 
 ***
 
@@ -287,7 +287,7 @@ Options for async module configuration using factory pattern
 type AmqpWorkerModuleOptions<TContract> = object;
 ```
 
-Defined in: [worker-nestjs/src/worker.service.ts:29](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.service.ts#L29)
+Defined in: [worker-nestjs/src/worker.service.ts:29](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.service.ts#L29)
 
 Configuration options for the AMQP worker NestJS module.
 
@@ -313,35 +313,36 @@ const options: AmqpWorkerModuleOptions<typeof contract> = {
 
 | Type Parameter | Description |
 | ------ | ------ |
-| `TContract` *extends* `ContractDefinition` | The contract definition type |
+| `TContract` *extends* `ContractDefinitionInput` | The contract definition type |
 
 #### Properties
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.) | [worker-nestjs/src/worker.service.ts:37](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.service.ts#L37) |
-| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [worker-nestjs/src/worker.service.ts:31](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.service.ts#L31) |
-| <a id="handlers"></a> `handlers` | [`WorkerInferSafeConsumerHandlers`](#workerinfersafeconsumerhandlers)&lt;`TContract`&gt; | Message handlers for each consumer defined in the contract. Use defineHandlers to create type-safe handlers. | [worker-nestjs/src/worker.service.ts:33](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.service.ts#L33) |
-| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [worker-nestjs/src/worker.service.ts:35](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.service.ts#L35) |
+| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.) | [worker-nestjs/src/worker.service.ts:37](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.service.ts#L37) |
+| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [worker-nestjs/src/worker.service.ts:31](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.service.ts#L31) |
+| <a id="handlers"></a> `handlers` | [`WorkerInferSafeConsumerHandlers`](#workerinfersafeconsumerhandlers)&lt;`TContract`&gt; | Message handlers for each consumer defined in the contract. Use defineHandlers to create type-safe handlers. | [worker-nestjs/src/worker.service.ts:33](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.service.ts#L33) |
+| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [worker-nestjs/src/worker.service.ts:35](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.service.ts#L35) |
 
 ***
 
-### WorkerInferSafeConsumerHandlers
+### ~~WorkerInferSafeConsumerHandlers~~
 
 ```ts
-type WorkerInferSafeConsumerHandlers<TContract> = { [K in InferConsumerNames<TContract>]: WorkerInferSafeConsumerHandlerEntry<TContract, K> };
+type WorkerInferSafeConsumerHandlers<TContract> = WorkerInferConsumerHandlers<TContract>;
 ```
 
-Defined in: worker/dist/index.d.mts:146
-
-Safe consumer handlers for a contract.
-All handlers return `Future<Result<void, HandlerError>>` for explicit error control.
+Defined in: worker/dist/index.d.mts:296
 
 #### Type Parameters
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinition` |
+| `TContract` *extends* `ContractDefinitionInput` |
+
+#### Deprecated
+
+Use `WorkerInferConsumerHandlers` instead. Will be removed in next major version.
 
 ## Variables
 
@@ -351,7 +352,7 @@ All handlers return `Future<Result<void, HandlerError>>` for explicit error cont
 const MODULE_OPTIONS_TOKEN: typeof MODULE_OPTIONS_TOKEN;
 ```
 
-Defined in: [worker-nestjs/src/worker.module-definition.ts:5](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker-nestjs/src/worker.module-definition.ts#L5)
+Defined in: [worker-nestjs/src/worker.module-definition.ts:5](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker-nestjs/src/worker.module-definition.ts#L5)
 
 Injection token for AMQP worker module options
 Used by NestJS DI system to inject configuration into AmqpWorkerService
@@ -366,10 +367,10 @@ Used by NestJS DI system to inject configuration into AmqpWorkerService
 function defineHandler<TContract, TName>(
    contract, 
    consumerName, 
-   handler): WorkerInferSafeConsumerHandlerEntry<TContract, TName>;
+   handler): WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: worker/dist/index.d.mts:460
+Defined in: worker/dist/index.d.mts:610
 
 Define a type-safe handler for a specific consumer in a contract.
 
@@ -384,7 +385,7 @@ Supports two patterns:
 
 | Type Parameter | Description |
 | ------ | ------ |
-| `TContract` *extends* `ContractDefinition` | The contract definition type |
+| `TContract` *extends* `ContractDefinitionInput` | The contract definition type |
 | `TName` *extends* `string` \| `number` \| `symbol` | The consumer name from the contract |
 
 ##### Parameters
@@ -393,11 +394,11 @@ Supports two patterns:
 | ------ | ------ | ------ |
 | `contract` | `TContract` | The contract definition containing the consumer |
 | `consumerName` | `TName` | The name of the consumer from the contract |
-| `handler` | `WorkerInferSafeConsumerHandler`&lt;`TContract`, `TName`&gt; | The handler function that returns `Future<Result<void, HandlerError>>` |
+| `handler` | `WorkerInferConsumerHandler`&lt;`TContract`, `TName`&gt; | The handler function that returns `Future<Result<void, HandlerError>>` |
 
 ##### Returns
 
-`WorkerInferSafeConsumerHandlerEntry`&lt;`TContract`, `TName`&gt;
+`WorkerInferConsumerHandlerEntry`&lt;`TContract`, `TName`&gt;
 
 A type-safe handler that can be used with TypedAmqpWorker
 
@@ -439,10 +440,10 @@ function defineHandler<TContract, TName>(
    contract, 
    consumerName, 
    handler, 
-   options): WorkerInferSafeConsumerHandlerEntry<TContract, TName>;
+   options): WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: worker/dist/index.d.mts:461
+Defined in: worker/dist/index.d.mts:611
 
 Define a type-safe handler for a specific consumer in a contract.
 
@@ -457,7 +458,7 @@ Supports two patterns:
 
 | Type Parameter | Description |
 | ------ | ------ |
-| `TContract` *extends* `ContractDefinition` | The contract definition type |
+| `TContract` *extends* `ContractDefinitionInput` | The contract definition type |
 | `TName` *extends* `string` \| `number` \| `symbol` | The consumer name from the contract |
 
 ##### Parameters
@@ -466,13 +467,13 @@ Supports two patterns:
 | ------ | ------ | ------ |
 | `contract` | `TContract` | The contract definition containing the consumer |
 | `consumerName` | `TName` | The name of the consumer from the contract |
-| `handler` | `WorkerInferSafeConsumerHandler`&lt;`TContract`, `TName`&gt; | The handler function that returns `Future<Result<void, HandlerError>>` |
+| `handler` | `WorkerInferConsumerHandler`&lt;`TContract`, `TName`&gt; | The handler function that returns `Future<Result<void, HandlerError>>` |
 | `options` | \{ `prefetch?`: `number`; \} | Optional consumer options (prefetch) |
 | `options.prefetch?` | `number` | - |
 
 ##### Returns
 
-`WorkerInferSafeConsumerHandlerEntry`&lt;`TContract`, `TName`&gt;
+`WorkerInferConsumerHandlerEntry`&lt;`TContract`, `TName`&gt;
 
 A type-safe handler that can be used with TypedAmqpWorker
 
@@ -512,10 +513,10 @@ const validateOrderHandler = defineHandler(
 ### defineHandlers()
 
 ```ts
-function defineHandlers<TContract>(contract, handlers): WorkerInferSafeConsumerHandlers<TContract>;
+function defineHandlers<TContract>(contract, handlers): WorkerInferConsumerHandlers<TContract>;
 ```
 
-Defined in: worker/dist/index.d.mts:493
+Defined in: worker/dist/index.d.mts:643
 
 Define multiple type-safe handlers for consumers in a contract.
 
@@ -526,18 +527,18 @@ providing explicit error handling and better control over retry behavior.
 
 | Type Parameter | Description |
 | ------ | ------ |
-| `TContract` *extends* `ContractDefinition` | The contract definition type |
+| `TContract` *extends* `ContractDefinitionInput` | The contract definition type |
 
 #### Parameters
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
 | `contract` | `TContract` | The contract definition containing the consumers |
-| `handlers` | [`WorkerInferSafeConsumerHandlers`](#workerinfersafeconsumerhandlers)&lt;`TContract`&gt; | An object with handler functions for each consumer |
+| `handlers` | `WorkerInferConsumerHandlers`&lt;`TContract`&gt; | An object with handler functions for each consumer |
 
 #### Returns
 
-[`WorkerInferSafeConsumerHandlers`](#workerinfersafeconsumerhandlers)&lt;`TContract`&gt;
+`WorkerInferConsumerHandlers`&lt;`TContract`&gt;
 
 A type-safe handlers object that can be used with TypedAmqpWorker
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amqp-contract/worker-nestjs",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "NestJS integration for @amqp-contract/worker",
   "keywords": [
     "amqp",
@@ -52,8 +52,8 @@
     "docs"
   ],
   "dependencies": {
-    "@amqp-contract/contract": "0.12.0",
-    "@amqp-contract/worker": "0.12.0"
+    "@amqp-contract/contract": "0.14.0",
+    "@amqp-contract/worker": "0.14.0"
   },
   "devDependencies": {
     "@nestjs/common": "11.1.12",
@@ -72,7 +72,7 @@
     "typescript": "5.9.3",
     "vitest": "4.0.17",
     "zod": "4.3.5",
-    "@amqp-contract/testing": "0.12.0",
+    "@amqp-contract/testing": "0.14.0",
     "@amqp-contract/tsconfig": "0.1.0",
     "@amqp-contract/typedoc": "0.1.0"
   },