@amqp-contract/worker 0.14.0 → 0.16.0

package/docs/index.md

@@ -8,7 +8,7 @@
 
 ### MessageValidationError
 
-Defined in: [packages/worker/src/errors.ts:4](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L4)
+Defined in: [packages/worker/src/errors.ts:4](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L4)
 
 Error thrown when message validation fails
 
@@ -24,7 +24,7 @@ Error thrown when message validation fails
 new MessageValidationError(consumerName, issues): MessageValidationError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:5](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L5)
+Defined in: [packages/worker/src/errors.ts:5](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L5)
 
 ###### Parameters
 
@@ -48,12 +48,12 @@ Error.constructor
 | Property | Modifier | Type | Description | Inherited from | Defined in |
 | ------ | ------ | ------ | ------ | ------ | ------ |
 | <a id="cause"></a> `cause?` | `public` | `unknown` | - | `Error.cause` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es2022.error.d.ts:26 |
-| <a id="consumername"></a> `consumerName` | `readonly` | `string` | - | - | [packages/worker/src/errors.ts:6](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L6) |
-| <a id="issues"></a> `issues` | `readonly` | `unknown` | - | - | [packages/worker/src/errors.ts:7](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L7) |
+| <a id="consumername"></a> `consumerName` | `readonly` | `string` | - | - | [packages/worker/src/errors.ts:6](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L6) |
+| <a id="issues"></a> `issues` | `readonly` | `unknown` | - | - | [packages/worker/src/errors.ts:7](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L7) |
 | <a id="message"></a> `message` | `public` | `string` | - | `Error.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
 | <a id="name"></a> `name` | `public` | `string` | - | `Error.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
 | <a id="stack"></a> `stack?` | `public` | `string` | - | `Error.stack` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1078 |
-| <a id="stacktracelimit"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:67 |
+| <a id="stacktracelimit"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:67 |
 
 #### Methods
 
@@ -63,7 +63,7 @@ Error.constructor
 static captureStackTrace(targetObject, constructorOpt?): void;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:51
+Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:51
 
 Creates a `.stack` property on `targetObject`, which when accessed returns
 a string representing the location in the code at which
@@ -132,7 +132,7 @@ Error.captureStackTrace
 static prepareStackTrace(err, stackTraces): any;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:55
+Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:55
 
 ###### Parameters
 
@@ -159,7 +159,7 @@ Error.prepareStackTrace
 
 ### NonRetryableError
 
-Defined in: [packages/worker/src/errors.ts:52](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L52)
+Defined in: [packages/worker/src/errors.ts:52](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L52)
 
 Non-retryable errors - permanent failures that should not be retried
 Examples: invalid data, business rule violations, permanent external failures
@@ -179,7 +179,7 @@ immediately sent to the dead letter queue (DLQ) if configured.
 new NonRetryableError(message, cause?): NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:53](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L53)
+Defined in: [packages/worker/src/errors.ts:53](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L53)
 
 ###### Parameters
 
@@ -202,11 +202,11 @@ Error.constructor
 
 | Property | Modifier | Type | Description | Inherited from | Defined in |
 | ------ | ------ | ------ | ------ | ------ | ------ |
-| <a id="cause-1"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/worker/src/errors.ts:55](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L55) |
+| <a id="cause-1"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/worker/src/errors.ts:55](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L55) |
 | <a id="message-1"></a> `message` | `public` | `string` | - | `Error.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
 | <a id="name-1"></a> `name` | `public` | `string` | - | `Error.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
 | <a id="stack-1"></a> `stack?` | `public` | `string` | - | `Error.stack` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1078 |
-| <a id="stacktracelimit-1"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:67 |
+| <a id="stacktracelimit-1"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:67 |
 
 #### Methods
 
@@ -216,7 +216,7 @@ Error.constructor
 static captureStackTrace(targetObject, constructorOpt?): void;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:51
+Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:51
 
 Creates a `.stack` property on `targetObject`, which when accessed returns
 a string representing the location in the code at which
@@ -285,7 +285,7 @@ Error.captureStackTrace
 static prepareStackTrace(err, stackTraces): any;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:55
+Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:55
 
 ###### Parameters
 
@@ -312,7 +312,7 @@ Error.prepareStackTrace
 
 ### RetryableError
 
-Defined in: [packages/worker/src/errors.ts:28](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L28)
+Defined in: [packages/worker/src/errors.ts:28](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L28)
 
 Retryable errors - transient failures that may succeed on retry
 Examples: network timeouts, rate limiting, temporary service unavailability
@@ -332,7 +332,7 @@ The worker will apply exponential backoff and retry the message.
 new RetryableError(message, cause?): RetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:29](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L29)
+Defined in: [packages/worker/src/errors.ts:29](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L29)
 
 ###### Parameters
 
@@ -355,11 +355,11 @@ Error.constructor
 
 | Property | Modifier | Type | Description | Inherited from | Defined in |
 | ------ | ------ | ------ | ------ | ------ | ------ |
-| <a id="cause-2"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/worker/src/errors.ts:31](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L31) |
+| <a id="cause-2"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/worker/src/errors.ts:31](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L31) |
 | <a id="message-2"></a> `message` | `public` | `string` | - | `Error.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
 | <a id="name-2"></a> `name` | `public` | `string` | - | `Error.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
 | <a id="stack-2"></a> `stack?` | `public` | `string` | - | `Error.stack` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1078 |
-| <a id="stacktracelimit-2"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:67 |
+| <a id="stacktracelimit-2"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:67 |
 
 #### Methods
 
@@ -369,7 +369,7 @@ Error.constructor
 static captureStackTrace(targetObject, constructorOpt?): void;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:51
+Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:51
 
 Creates a `.stack` property on `targetObject`, which when accessed returns
 a string representing the location in the code at which
@@ -438,7 +438,7 @@ Error.captureStackTrace
 static prepareStackTrace(err, stackTraces): any;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:55
+Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:55
 
 ###### Parameters
 
@@ -465,7 +465,7 @@ Error.prepareStackTrace
 
 ### TypedAmqpWorker
 
-Defined in: [packages/worker/src/worker.ts:157](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/worker.ts#L157)
+Defined in: [packages/worker/src/worker.ts:158](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/worker.ts#L158)
 
 Type-safe AMQP worker for consuming messages from RabbitMQ.
 
@@ -476,17 +476,18 @@ and error handling for consuming messages based on a contract definition.
 
 ```typescript
 import { TypedAmqpWorker } from '@amqp-contract/worker';
+import { defineQueue, defineMessage, defineContract, defineConsumer } from '@amqp-contract/contract';
 import { z } from 'zod';
 
+const orderQueue = defineQueue('order-processing', { durable: true });
+const orderMessage = defineMessage(z.object({
+  orderId: z.string(),
+  amount: z.number()
+}));
+
 const contract = defineContract({
-  queues: {
-    orderProcessing: defineQueue('order-processing', { durable: true })
-  },
   consumers: {
-    processOrder: defineConsumer('order-processing', z.object({
-      orderId: z.string(),
-      amount: z.number()
-    }))
+    processOrder: defineConsumer(orderQueue, orderMessage)
   }
 });
 
@@ -509,7 +510,7 @@ await worker.close().resultToPromise();
 
 | Type Parameter | Description |
 | ------ | ------ |
-| `TContract` *extends* `ContractDefinitionInput` | The contract definition type |
+| `TContract` *extends* `ContractDefinition` | The contract definition type |
 
 #### Methods
 
@@ -519,7 +520,7 @@ await worker.close().resultToPromise();
 close(): Future<Result<void, TechnicalError>>;
 ```
 
-Defined in: [packages/worker/src/worker.ts:277](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/worker.ts#L277)
+Defined in: [packages/worker/src/worker.ts:278](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/worker.ts#L278)
 
 Close the AMQP channel and connection.
 
@@ -547,7 +548,7 @@ if (closeResult.isOk()) {
 static create<TContract>(options): Future<Result<TypedAmqpWorker<TContract>, TechnicalError>>;
 ```
 
-Defined in: [packages/worker/src/worker.ts:234](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/worker.ts#L234)
+Defined in: [packages/worker/src/worker.ts:235](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/worker.ts#L235)
 
 Create a type-safe AMQP worker from a contract.
 
@@ -563,7 +564,7 @@ URLs and connection options, following RabbitMQ best practices.
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinitionInput` |
+| `TContract` *extends* `ContractDefinition` |
 
 ###### Parameters
 
@@ -597,7 +598,7 @@ const worker = await TypedAmqpWorker.create({
 type CreateWorkerOptions<TContract> = object;
 ```
 
-Defined in: [packages/worker/src/worker.ts:94](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/worker.ts#L94)
+Defined in: [packages/worker/src/worker.ts:94](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/worker.ts#L94)
 
 Options for creating a type-safe AMQP worker.
 
@@ -636,18 +637,18 @@ not at the handler level. See `QueueDefinition.retry` for configuration options.
 
 | Type Parameter | Description |
 | ------ | ------ |
-| `TContract` *extends* `ContractDefinitionInput` | The contract definition type |
+| `TContract` *extends* `ContractDefinition` | The contract definition type |
 
 #### Properties
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.) | [packages/worker/src/worker.ts:106](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/worker.ts#L106) |
-| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [packages/worker/src/worker.ts:96](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/worker.ts#L96) |
-| <a id="handlers"></a> `handlers` | [`WorkerInferConsumerHandlers`](#workerinferconsumerhandlers)&lt;`TContract`&gt; | Handlers for each consumer defined in the contract. Handlers must return `Future<Result<void, HandlerError>>` for explicit error handling. Use defineHandler() to create handlers. | [packages/worker/src/worker.ts:102](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/worker.ts#L102) |
-| <a id="logger"></a> `logger?` | `Logger` | Optional logger for logging message consumption and errors | [packages/worker/src/worker.ts:108](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/worker.ts#L108) |
-| <a id="telemetry"></a> `telemetry?` | `TelemetryProvider` | Optional telemetry provider for tracing and metrics. If not provided, uses the default provider which attempts to load OpenTelemetry. OpenTelemetry instrumentation is automatically enabled if @opentelemetry/api is installed. | [packages/worker/src/worker.ts:114](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/worker.ts#L114) |
-| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [packages/worker/src/worker.ts:104](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/worker.ts#L104) |
+| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.) | [packages/worker/src/worker.ts:106](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/worker.ts#L106) |
+| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [packages/worker/src/worker.ts:96](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/worker.ts#L96) |
+| <a id="handlers"></a> `handlers` | [`WorkerInferConsumerHandlers`](#workerinferconsumerhandlers)&lt;`TContract`&gt; | Handlers for each consumer defined in the contract. Handlers must return `Future<Result<void, HandlerError>>` for explicit error handling. Use defineHandler() to create handlers. | [packages/worker/src/worker.ts:102](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/worker.ts#L102) |
+| <a id="logger"></a> `logger?` | `Logger` | Optional logger for logging message consumption and errors | [packages/worker/src/worker.ts:108](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/worker.ts#L108) |
+| <a id="telemetry"></a> `telemetry?` | `TelemetryProvider` | Optional telemetry provider for tracing and metrics. If not provided, uses the default provider which attempts to load OpenTelemetry. OpenTelemetry instrumentation is automatically enabled if @opentelemetry/api is installed. | [packages/worker/src/worker.ts:114](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/worker.ts#L114) |
+| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [packages/worker/src/worker.ts:104](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/worker.ts#L104) |
 
 ***
 
@@ -659,7 +660,7 @@ type HandlerError =
   | NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:73](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L73)
+Defined in: [packages/worker/src/errors.ts:73](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L73)
 
 Union type representing all handler errors.
 Use this type when defining handlers that explicitly signal error outcomes.
@@ -672,7 +673,7 @@ Use this type when defining handlers that explicitly signal error outcomes.
 type WorkerConsumedMessage<TPayload, THeaders> = object;
 ```
 
-Defined in: [packages/worker/src/types.ts:106](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L106)
+Defined in: [packages/worker/src/types.ts:104](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L104)
 
 A consumed message containing parsed payload and headers.
 
@@ -702,8 +703,8 @@ const handler = defineHandler(contract, 'processOrder', (message, rawMessage) =>
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="headers"></a> `headers` | `THeaders` *extends* `undefined` ? `undefined` : `THeaders` | The validated message headers (present only when headers schema is defined) | [packages/worker/src/types.ts:110](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L110) |
-| <a id="payload"></a> `payload` | `TPayload` | The validated message payload | [packages/worker/src/types.ts:108](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L108) |
+| <a id="headers"></a> `headers` | `THeaders` *extends* `undefined` ? `undefined` : `THeaders` | The validated message headers (present only when headers schema is defined) | [packages/worker/src/types.ts:108](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L108) |
+| <a id="payload"></a> `payload` | `TPayload` | The validated message payload | [packages/worker/src/types.ts:106](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L106) |
 
 ***
 
@@ -713,7 +714,7 @@ const handler = defineHandler(contract, 'processOrder', (message, rawMessage) =>
 type WorkerInferConsumedMessage<TContract, TName> = WorkerConsumedMessage<WorkerInferConsumerPayload<TContract, TName>, WorkerInferConsumerHeaders<TContract, TName>>;
 ```
 
-Defined in: [packages/worker/src/types.ts:117](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L117)
+Defined in: [packages/worker/src/types.ts:115](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L115)
 
 Infer the full consumed message type for a specific consumer.
 Includes both payload and headers (if defined).
@@ -722,7 +723,7 @@ Includes both payload and headers (if defined).
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinitionInput` |
+| `TContract` *extends* `ContractDefinition` |
 | `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
 
 ***
@@ -733,7 +734,7 @@ Includes both payload and headers (if defined).
 type WorkerInferConsumerHandler<TContract, TName> = (message, rawMessage) => Future<Result<void, HandlerError>>;
 ```
 
-Defined in: [packages/worker/src/types.ts:156](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L156)
+Defined in: [packages/worker/src/types.ts:154](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L154)
 
 Consumer handler type for a specific consumer.
 Returns a `Future<Result<void, HandlerError>>` for explicit error handling.
@@ -749,7 +750,7 @@ types from a contract definition at compile time.
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinitionInput` |
+| `TContract` *extends* `ContractDefinition` |
 | `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
 
 #### Parameters
@@ -786,7 +787,7 @@ type WorkerInferConsumerHandlerEntry<TContract, TName> =
 }];
 ```
 
-Defined in: [packages/worker/src/types.ts:174](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L174)
+Defined in: [packages/worker/src/types.ts:172](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L172)
 
 Handler entry for a consumer - either a function or a tuple of [handler, options].
 
@@ -801,7 +802,7 @@ not at the handler level. See `QueueDefinition.retry` for configuration options.
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinitionInput` |
+| `TContract` *extends* `ContractDefinition` |
 | `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
 
 ***
@@ -812,7 +813,7 @@ not at the handler level. See `QueueDefinition.retry` for configuration options.
 type WorkerInferConsumerHandlers<TContract> = { [K in InferConsumerNames<TContract>]: WorkerInferConsumerHandlerEntry<TContract, K> };
 ```
 
-Defined in: [packages/worker/src/types.ts:195](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L195)
+Defined in: [packages/worker/src/types.ts:193](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L193)
 
 Consumer handlers for a contract.
 All handlers return `Future<Result<void, HandlerError>>` for explicit error control.
@@ -821,7 +822,7 @@ All handlers return `Future<Result<void, HandlerError>>` for explicit error cont
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinitionInput` |
+| `TContract` *extends* `ContractDefinition` |
 
 #### Example
 
@@ -842,7 +843,7 @@ const handlers: WorkerInferConsumerHandlers<typeof contract> = {
 type WorkerInferConsumerHeaders<TContract, TName> = ConsumerInferHeadersInput<InferConsumer<TContract, TName>>;
 ```
 
-Defined in: [packages/worker/src/types.ts:81](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L81)
+Defined in: [packages/worker/src/types.ts:79](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L79)
 
 Infer the headers type for a specific consumer
 Returns undefined if no headers schema is defined
@@ -851,7 +852,7 @@ Returns undefined if no headers schema is defined
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinitionInput` |
+| `TContract` *extends* `ContractDefinition` |
 | `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
 
 ***
@@ -862,13 +863,13 @@ Returns undefined if no headers schema is defined
 type WorkerInferSafeConsumerHandler<TContract, TName> = WorkerInferConsumerHandler<TContract, TName>;
 ```
 
-Defined in: [packages/worker/src/types.ts:207](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L207)
+Defined in: [packages/worker/src/types.ts:205](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L205)
 
 #### Type Parameters
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinitionInput` |
+| `TContract` *extends* `ContractDefinition` |
 | `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
 
 #### Deprecated
@@ -883,13 +884,13 @@ Use `WorkerInferConsumerHandler` instead. Will be removed in next major version.
 type WorkerInferSafeConsumerHandlerEntry<TContract, TName> = WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: [packages/worker/src/types.ts:215](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L215)
+Defined in: [packages/worker/src/types.ts:213](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L213)
 
 #### Type Parameters
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinitionInput` |
+| `TContract` *extends* `ContractDefinition` |
 | `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
 
 #### Deprecated
@@ -904,13 +905,13 @@ Use `WorkerInferConsumerHandlerEntry` instead. Will be removed in next major ver
 type WorkerInferSafeConsumerHandlers<TContract> = WorkerInferConsumerHandlers<TContract>;
 ```
 
-Defined in: [packages/worker/src/types.ts:223](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/types.ts#L223)
+Defined in: [packages/worker/src/types.ts:221](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/types.ts#L221)
 
 #### Type Parameters
 
 | Type Parameter |
 | ------ |
-| `TContract` *extends* `ContractDefinitionInput` |
+| `TContract` *extends* `ContractDefinition` |
 
 #### Deprecated
 
@@ -929,7 +930,7 @@ function defineHandler<TContract, TName>(
    handler): WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:103](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/handlers.ts#L103)
+Defined in: [packages/worker/src/handlers.ts:103](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/handlers.ts#L103)
 
 Define a type-safe handler for a specific consumer in a contract.
 
@@ -944,7 +945,7 @@ Supports two patterns:
 
 | Type Parameter | Description |
 | ------ | ------ |
-| `TContract` *extends* `ContractDefinitionInput` | The contract definition type |
+| `TContract` *extends* `ContractDefinition` | The contract definition type |
 | `TName` *extends* `string` \| `number` \| `symbol` | The consumer name from the contract |
 
 ##### Parameters
@@ -1002,7 +1003,7 @@ function defineHandler<TContract, TName>(
    options): WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:111](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/handlers.ts#L111)
+Defined in: [packages/worker/src/handlers.ts:111](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/handlers.ts#L111)
 
 Define a type-safe handler for a specific consumer in a contract.
 
@@ -1017,7 +1018,7 @@ Supports two patterns:
 
 | Type Parameter | Description |
 | ------ | ------ |
-| `TContract` *extends* `ContractDefinitionInput` | The contract definition type |
+| `TContract` *extends* `ContractDefinition` | The contract definition type |
 | `TName` *extends* `string` \| `number` \| `symbol` | The consumer name from the contract |
 
 ##### Parameters
@@ -1075,7 +1076,7 @@ const validateOrderHandler = defineHandler(
 function defineHandlers<TContract>(contract, handlers): WorkerInferConsumerHandlers<TContract>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:166](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/handlers.ts#L166)
+Defined in: [packages/worker/src/handlers.ts:166](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/handlers.ts#L166)
 
 Define multiple type-safe handlers for consumers in a contract.
 
@@ -1086,7 +1087,7 @@ providing explicit error handling and better control over retry behavior.
 
 | Type Parameter | Description |
 | ------ | ------ |
-| `TContract` *extends* `ContractDefinitionInput` | The contract definition type |
+| `TContract` *extends* `ContractDefinition` | The contract definition type |
 
 #### Parameters
 
@@ -1128,7 +1129,7 @@ const handlers = defineHandlers(orderContract, {
 function isHandlerError(error): error is HandlerError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:149](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L149)
+Defined in: [packages/worker/src/errors.ts:149](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L149)
 
 Type guard to check if an error is any HandlerError (RetryableError or NonRetryableError).
 
@@ -1165,7 +1166,7 @@ function handleError(error: unknown) {
 function isNonRetryableError(error): error is NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:127](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L127)
+Defined in: [packages/worker/src/errors.ts:127](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L127)
 
 Type guard to check if an error is a NonRetryableError.
 
@@ -1205,7 +1206,7 @@ try {
 function isRetryableError(error): error is RetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:102](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L102)
+Defined in: [packages/worker/src/errors.ts:102](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L102)
 
 Type guard to check if an error is a RetryableError.
 
@@ -1247,7 +1248,7 @@ try {
 function nonRetryable(message, cause?): NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:211](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L211)
+Defined in: [packages/worker/src/errors.ts:211](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L211)
 
 Create a NonRetryableError with less verbosity.
 
@@ -1292,7 +1293,7 @@ const handler = ({ payload }) => {
 function retryable(message, cause?): RetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:181](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/worker/src/errors.ts#L181)
+Defined in: [packages/worker/src/errors.ts:181](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/worker/src/errors.ts#L181)
 
 Create a RetryableError with less verbosity.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amqp-contract/worker",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Worker utilities for consuming messages using amqp-contract",
   "keywords": [
     "amqp",
@@ -52,22 +52,22 @@
   "dependencies": {
     "@standard-schema/spec": "1.1.0",
     "@swan-io/boxed": "3.2.1",
-    "@amqp-contract/contract": "0.14.0",
-    "@amqp-contract/core": "0.14.0"
+    "@amqp-contract/contract": "0.16.0",
+    "@amqp-contract/core": "0.16.0"
   },
   "devDependencies": {
     "@types/amqplib": "0.10.8",
-    "@types/node": "25.0.9",
-    "@vitest/coverage-v8": "4.0.17",
+    "@types/node": "25.2.1",
+    "@vitest/coverage-v8": "4.0.18",
     "amqp-connection-manager": "5.0.0",
     "amqplib": "0.10.9",
-    "tsdown": "0.19.0",
+    "tsdown": "0.20.3",
     "typedoc": "0.28.16",
     "typedoc-plugin-markdown": "4.9.0",
     "typescript": "5.9.3",
-    "vitest": "4.0.17",
-    "zod": "4.3.5",
-    "@amqp-contract/testing": "0.14.0",
+    "vitest": "4.0.18",
+    "zod": "4.3.6",
+    "@amqp-contract/testing": "0.16.0",
     "@amqp-contract/tsconfig": "0.1.0",
     "@amqp-contract/typedoc": "0.1.0"
   },