@amqp-contract/worker-nestjs 0.12.0 → 0.13.0

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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/packages/worker-nestjs/src/worker.module.ts#L95)
 
 Register the AMQP worker module with synchronous configuration
 
@@ -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/69a6467d137997be809af2ea5c4332c378579b49/packages/worker-nestjs/src/worker.module.ts#L117)
 
 Register the AMQP worker module with asynchronous configuration
 
@@ -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/69a6467d137997be809af2ea5c4332c378579b49/packages/worker-nestjs/src/worker.service.ts#L75)
 
 Type-safe AMQP worker service for NestJS applications.
 
@@ -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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/packages/worker-nestjs/src/worker.module.ts#L22)
 
 Options for async module configuration using factory pattern
 
@@ -275,9 +275,9 @@ Options for async module configuration using factory pattern
 
 | 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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/packages/worker-nestjs/src/worker.service.ts#L29)
 
 Configuration options for the AMQP worker NestJS module.
 
@@ -319,23 +319,20 @@ const options: AmqpWorkerModuleOptions<typeof contract> = {
 
 | 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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/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:288
 
 #### Type Parameters
 
@@ -343,6 +340,10 @@ All handlers return `Future<Result<void, HandlerError>>` for explicit error cont
 | ------ |
 | `TContract` *extends* `ContractDefinition` |
 
+#### Deprecated
+
+Use `WorkerInferConsumerHandlers` instead. Will be removed in next major version.
+
 ## Variables
 
 ### MODULE\_OPTIONS\_TOKEN
@@ -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/69a6467d137997be809af2ea5c4332c378579b49/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:602
 
 Define a type-safe handler for a specific consumer in a contract.
 
@@ -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:603
 
 Define a type-safe handler for a specific consumer in a contract.
 
@@ -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:635
 
 Define multiple type-safe handlers for consumers in a contract.
 
@@ -533,11 +534,11 @@ providing explicit error handling and better control over retry behavior.
 | 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.13.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.13.0",
+    "@amqp-contract/worker": "0.13.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.13.0",
     "@amqp-contract/tsconfig": "0.1.0",
     "@amqp-contract/typedoc": "0.1.0"
   },