@amqp-contract/worker 0.12.0 → 0.13.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/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/errors.ts#L4)
+Defined in: [packages/worker/src/errors.ts:4](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/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/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/errors.ts#L5)
+Defined in: [packages/worker/src/errors.ts:5](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L5)
 
 ###### Parameters
 
@@ -48,8 +48,8 @@ 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/c50b9d5f661ce899d34d7eebcfafa47844bd1087/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/c50b9d5f661ce899d34d7eebcfafa47844bd1087/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/69a6467d137997be809af2ea5c4332c378579b49/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/69a6467d137997be809af2ea5c4332c378579b49/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 |
@@ -159,7 +159,7 @@ Error.prepareStackTrace
 
 ### NonRetryableError
 
-Defined in: [packages/worker/src/errors.ts:52](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/errors.ts#L52)
+Defined in: [packages/worker/src/errors.ts:52](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/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/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/errors.ts#L53)
+Defined in: [packages/worker/src/errors.ts:53](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L53)
 
 ###### Parameters
 
@@ -202,7 +202,7 @@ 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/c50b9d5f661ce899d34d7eebcfafa47844bd1087/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/69a6467d137997be809af2ea5c4332c378579b49/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 |
@@ -312,7 +312,7 @@ Error.prepareStackTrace
 
 ### RetryableError
 
-Defined in: [packages/worker/src/errors.ts:28](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/errors.ts#L28)
+Defined in: [packages/worker/src/errors.ts:28](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/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/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/errors.ts#L29)
+Defined in: [packages/worker/src/errors.ts:29](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L29)
 
 ###### Parameters
 
@@ -355,7 +355,7 @@ 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/c50b9d5f661ce899d34d7eebcfafa47844bd1087/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/69a6467d137997be809af2ea5c4332c378579b49/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 |
@@ -465,7 +465,7 @@ Error.prepareStackTrace
 
 ### TypedAmqpWorker
 
-Defined in: [packages/worker/src/worker.ts:156](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/worker.ts#L156)
+Defined in: [packages/worker/src/worker.ts:156](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/worker.ts#L156)
 
 Type-safe AMQP worker for consuming messages from RabbitMQ.
 
@@ -519,7 +519,7 @@ await worker.close().resultToPromise();
 close(): Future<Result<void, TechnicalError>>;
 ```
 
-Defined in: [packages/worker/src/worker.ts:276](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/worker.ts#L276)
+Defined in: [packages/worker/src/worker.ts:276](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/worker.ts#L276)
 
 Close the AMQP channel and connection.
 
@@ -547,7 +547,7 @@ if (closeResult.isOk()) {
 static create<TContract>(options): Future<Result<TypedAmqpWorker<TContract>, TechnicalError>>;
 ```
 
-Defined in: [packages/worker/src/worker.ts:233](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/worker.ts#L233)
+Defined in: [packages/worker/src/worker.ts:233](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/worker.ts#L233)
 
 Create a type-safe AMQP worker from a contract.
 
@@ -597,7 +597,7 @@ const worker = await TypedAmqpWorker.create({
 type CreateWorkerOptions<TContract> = object;
 ```
 
-Defined in: [packages/worker/src/worker.ts:93](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/worker.ts#L93)
+Defined in: [packages/worker/src/worker.ts:93](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/worker.ts#L93)
 
 Options for creating a type-safe AMQP worker.
 
@@ -642,12 +642,12 @@ not at the handler level. See `QueueDefinition.retry` for configuration options.
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.) | [packages/worker/src/worker.ts:105](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/worker.ts#L105) |
-| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [packages/worker/src/worker.ts:95](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/worker.ts#L95) |
-| <a id="handlers"></a> `handlers` | [`WorkerInferSafeConsumerHandlers`](#workerinfersafeconsumerhandlers)&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:101](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/worker.ts#L101) |
-| <a id="logger"></a> `logger?` | `Logger` | Optional logger for logging message consumption and errors | [packages/worker/src/worker.ts:107](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/worker.ts#L107) |
-| <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:113](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/worker.ts#L113) |
-| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [packages/worker/src/worker.ts:103](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/worker.ts#L103) |
+| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.) | [packages/worker/src/worker.ts:105](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/worker.ts#L105) |
+| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [packages/worker/src/worker.ts:95](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/worker.ts#L95) |
+| <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:101](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/worker.ts#L101) |
+| <a id="logger"></a> `logger?` | `Logger` | Optional logger for logging message consumption and errors | [packages/worker/src/worker.ts:107](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/worker.ts#L107) |
+| <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:113](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/worker.ts#L113) |
+| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [packages/worker/src/worker.ts:103](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/worker.ts#L103) |
 
 ***
 
@@ -659,7 +659,7 @@ type HandlerError =
   | NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:73](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/errors.ts#L73)
+Defined in: [packages/worker/src/errors.ts:73](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/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 +672,7 @@ Use this type when defining handlers that explicitly signal error outcomes.
 type WorkerConsumedMessage<TPayload, THeaders> = object;
 ```
 
-Defined in: [packages/worker/src/types.ts:86](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/types.ts#L86)
+Defined in: [packages/worker/src/types.ts:86](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L86)
 
 A consumed message containing parsed payload and headers.
 
@@ -702,8 +702,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:90](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/types.ts#L90) |
-| <a id="payload"></a> `payload` | `TPayload` | The validated message payload | [packages/worker/src/types.ts:88](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/types.ts#L88) |
+| <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:90](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L90) |
+| <a id="payload"></a> `payload` | `TPayload` | The validated message payload | [packages/worker/src/types.ts:88](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L88) |
 
 ***
 
@@ -713,7 +713,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:97](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/types.ts#L97)
+Defined in: [packages/worker/src/types.ts:97](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L97)
 
 Infer the full consumed message type for a specific consumer.
 Includes both payload and headers (if defined).
@@ -727,41 +727,24 @@ Includes both payload and headers (if defined).
 
 ***
 
-### WorkerInferConsumerHeaders
+### WorkerInferConsumerHandler()
 
 ```ts
-type WorkerInferConsumerHeaders<TContract, TName> = ConsumerInferHeadersInput<InferConsumer<TContract, TName>>;
+type WorkerInferConsumerHandler<TContract, TName> = (message, rawMessage) => Future<Result<void, HandlerError>>;
 ```
 
-Defined in: [packages/worker/src/types.ts:61](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/types.ts#L61)
-
-Infer the headers type for a specific consumer
-Returns undefined if no headers schema is defined
-
-#### Type Parameters
-
-| Type Parameter |
-| ------ |
-| `TContract` *extends* `ContractDefinition` |
-| `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
-
-***
-
-### WorkerInferSafeConsumerHandler()
+Defined in: [packages/worker/src/types.ts:136](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L136)
 
-```ts
-type WorkerInferSafeConsumerHandler<TContract, TName> = (message, rawMessage) => Future<Result<void, HandlerError>>;
-```
-
-Defined in: [packages/worker/src/types.ts:133](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/types.ts#L133)
-
-Safe consumer handler type for a specific consumer.
+Consumer handler type for a specific consumer.
 Returns a `Future<Result<void, HandlerError>>` for explicit error handling.
 
-**Recommended over unsafe handlers** for better error control:
+Error handling:
 - RetryableError: Message will be retried with exponential backoff
 - NonRetryableError: Message will be immediately sent to DLQ
 
+The `WorkerInfer*` naming pattern indicates type inference helpers that extract
+types from a contract definition at compile time.
+
 #### Type Parameters
 
 | Type Parameter |
@@ -783,7 +766,7 @@ Returns a `Future<Result<void, HandlerError>>` for explicit error handling.
 #### Example
 
 ```typescript
-const handler: WorkerInferSafeConsumerHandler<typeof contract, 'processOrder'> =
+const handler: WorkerInferConsumerHandler<typeof contract, 'processOrder'> =
   ({ payload }, rawMessage) => {
     console.log(payload.orderId);  // Typed payload
     console.log(rawMessage.fields.deliveryTag); // Raw AMQP message
@@ -793,19 +776,19 @@ const handler: WorkerInferSafeConsumerHandler<typeof contract, 'processOrder'> =
 
 ***
 
-### WorkerInferSafeConsumerHandlerEntry
+### WorkerInferConsumerHandlerEntry
 
 ```ts
-type WorkerInferSafeConsumerHandlerEntry<TContract, TName> = 
-  | WorkerInferSafeConsumerHandler<TContract, TName>
-  | readonly [WorkerInferSafeConsumerHandler<TContract, TName>, {
+type WorkerInferConsumerHandlerEntry<TContract, TName> = 
+  | WorkerInferConsumerHandler<TContract, TName>
+  | readonly [WorkerInferConsumerHandler<TContract, TName>, {
   prefetch?: number;
 }];
 ```
 
-Defined in: [packages/worker/src/types.ts:151](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/types.ts#L151)
+Defined in: [packages/worker/src/types.ts:154](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L154)
 
-Safe handler entry for a consumer - either a function or a tuple of [handler, options].
+Handler entry for a consumer - either a function or a tuple of [handler, options].
 
 Two patterns are supported:
 1. Simple handler: `({ payload }, rawMessage) => Future.value(Result.Ok(undefined))`
@@ -823,15 +806,15 @@ not at the handler level. See `QueueDefinition.retry` for configuration options.
 
 ***
 
-### WorkerInferSafeConsumerHandlers
+### WorkerInferConsumerHandlers
 
 ```ts
-type WorkerInferSafeConsumerHandlers<TContract> = { [K in InferConsumerNames<TContract>]: WorkerInferSafeConsumerHandlerEntry<TContract, K> };
+type WorkerInferConsumerHandlers<TContract> = { [K in InferConsumerNames<TContract>]: WorkerInferConsumerHandlerEntry<TContract, K> };
 ```
 
-Defined in: [packages/worker/src/types.ts:162](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/types.ts#L162)
+Defined in: [packages/worker/src/types.ts:175](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L175)
 
-Safe consumer handlers for a contract.
+Consumer handlers for a contract.
 All handlers return `Future<Result<void, HandlerError>>` for explicit error control.
 
 #### Type Parameters
@@ -840,6 +823,99 @@ All handlers return `Future<Result<void, HandlerError>>` for explicit error cont
 | ------ |
 | `TContract` *extends* `ContractDefinition` |
 
+#### Example
+
+```typescript
+const handlers: WorkerInferConsumerHandlers<typeof contract> = {
+  processOrder: ({ payload }) =>
+    Future.fromPromise(processPayment(payload))
+      .mapOk(() => undefined)
+      .mapError((error) => new RetryableError('Payment failed', error)),
+};
+```
+
+***
+
+### WorkerInferConsumerHeaders
+
+```ts
+type WorkerInferConsumerHeaders<TContract, TName> = ConsumerInferHeadersInput<InferConsumer<TContract, TName>>;
+```
+
+Defined in: [packages/worker/src/types.ts:61](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L61)
+
+Infer the headers type for a specific consumer
+Returns undefined if no headers schema is defined
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TContract` *extends* `ContractDefinition` |
+| `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
+
+***
+
+### ~~WorkerInferSafeConsumerHandler~~
+
+```ts
+type WorkerInferSafeConsumerHandler<TContract, TName> = WorkerInferConsumerHandler<TContract, TName>;
+```
+
+Defined in: [packages/worker/src/types.ts:187](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L187)
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TContract` *extends* `ContractDefinition` |
+| `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
+
+#### Deprecated
+
+Use `WorkerInferConsumerHandler` instead. Will be removed in next major version.
+
+***
+
+### ~~WorkerInferSafeConsumerHandlerEntry~~
+
+```ts
+type WorkerInferSafeConsumerHandlerEntry<TContract, TName> = WorkerInferConsumerHandlerEntry<TContract, TName>;
+```
+
+Defined in: [packages/worker/src/types.ts:195](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L195)
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TContract` *extends* `ContractDefinition` |
+| `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
+
+#### Deprecated
+
+Use `WorkerInferConsumerHandlerEntry` instead. Will be removed in next major version.
+
+***
+
+### ~~WorkerInferSafeConsumerHandlers~~
+
+```ts
+type WorkerInferSafeConsumerHandlers<TContract> = WorkerInferConsumerHandlers<TContract>;
+```
+
+Defined in: [packages/worker/src/types.ts:203](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L203)
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TContract` *extends* `ContractDefinition` |
+
+#### Deprecated
+
+Use `WorkerInferConsumerHandlers` instead. Will be removed in next major version.
+
 ## Functions
 
 ### defineHandler()
@@ -850,10 +926,10 @@ All handlers return `Future<Result<void, HandlerError>>` for explicit error cont
 function defineHandler<TContract, TName>(
    contract, 
    consumerName, 
-   handler): WorkerInferSafeConsumerHandlerEntry<TContract, TName>;
+   handler): WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:103](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/handlers.ts#L103)
+Defined in: [packages/worker/src/handlers.ts:103](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/handlers.ts#L103)
 
 Define a type-safe handler for a specific consumer in a contract.
 
@@ -877,11 +953,11 @@ Supports two patterns:
 | ------ | ------ | ------ |
 | `contract` | `TContract` | The contract definition containing the consumer |
 | `consumerName` | `TName` | The name of the consumer from the contract |
-| `handler` | [`WorkerInferSafeConsumerHandler`](#workerinfersafeconsumerhandler)&lt;`TContract`, `TName`&gt; | The handler function that returns `Future<Result<void, HandlerError>>` |
+| `handler` | [`WorkerInferConsumerHandler`](#workerinferconsumerhandler)&lt;`TContract`, `TName`&gt; | The handler function that returns `Future<Result<void, HandlerError>>` |
 
 ##### Returns
 
-[`WorkerInferSafeConsumerHandlerEntry`](#workerinfersafeconsumerhandlerentry)&lt;`TContract`, `TName`&gt;
+[`WorkerInferConsumerHandlerEntry`](#workerinferconsumerhandlerentry)&lt;`TContract`, `TName`&gt;
 
 A type-safe handler that can be used with TypedAmqpWorker
 
@@ -923,10 +999,10 @@ function defineHandler<TContract, TName>(
    contract, 
    consumerName, 
    handler, 
-   options): WorkerInferSafeConsumerHandlerEntry<TContract, TName>;
+   options): WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:111](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/handlers.ts#L111)
+Defined in: [packages/worker/src/handlers.ts:111](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/handlers.ts#L111)
 
 Define a type-safe handler for a specific consumer in a contract.
 
@@ -950,13 +1026,13 @@ Supports two patterns:
 | ------ | ------ | ------ |
 | `contract` | `TContract` | The contract definition containing the consumer |
 | `consumerName` | `TName` | The name of the consumer from the contract |
-| `handler` | [`WorkerInferSafeConsumerHandler`](#workerinfersafeconsumerhandler)&lt;`TContract`, `TName`&gt; | The handler function that returns `Future<Result<void, HandlerError>>` |
+| `handler` | [`WorkerInferConsumerHandler`](#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`](#workerinfersafeconsumerhandlerentry)&lt;`TContract`, `TName`&gt;
+[`WorkerInferConsumerHandlerEntry`](#workerinferconsumerhandlerentry)&lt;`TContract`, `TName`&gt;
 
 A type-safe handler that can be used with TypedAmqpWorker
 
@@ -996,10 +1072,10 @@ const validateOrderHandler = defineHandler(
 ### defineHandlers()
 
 ```ts
-function defineHandlers<TContract>(contract, handlers): WorkerInferSafeConsumerHandlers<TContract>;
+function defineHandlers<TContract>(contract, handlers): WorkerInferConsumerHandlers<TContract>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:166](https://github.com/btravers/amqp-contract/blob/c50b9d5f661ce899d34d7eebcfafa47844bd1087/packages/worker/src/handlers.ts#L166)
+Defined in: [packages/worker/src/handlers.ts:166](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/handlers.ts#L166)
 
 Define multiple type-safe handlers for consumers in a contract.
 
@@ -1017,11 +1093,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`](#workerinferconsumerhandlers)&lt;`TContract`&gt; | An object with handler functions for each consumer |
 
 #### Returns
 
-[`WorkerInferSafeConsumerHandlers`](#workerinfersafeconsumerhandlers)&lt;`TContract`&gt;
+[`WorkerInferConsumerHandlers`](#workerinferconsumerhandlers)&lt;`TContract`&gt;
 
 A type-safe handlers object that can be used with TypedAmqpWorker
 
@@ -1043,3 +1119,210 @@ const handlers = defineHandlers(orderContract, {
       .mapError((error) => new RetryableError('Notification failed', error)),
 });
 ```
+
+***
+
+### isHandlerError()
+
+```ts
+function isHandlerError(error): error is HandlerError;
+```
+
+Defined in: [packages/worker/src/errors.ts:149](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L149)
+
+Type guard to check if an error is any HandlerError (RetryableError or NonRetryableError).
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `error` | `unknown` | The error to check |
+
+#### Returns
+
+`error is HandlerError`
+
+True if the error is a HandlerError
+
+#### Example
+
+```typescript
+import { isHandlerError } from '@amqp-contract/worker';
+
+function handleError(error: unknown) {
+  if (isHandlerError(error)) {
+    // error is RetryableError | NonRetryableError
+    console.log('Handler error:', error.name, error.message);
+  }
+}
+```
+
+***
+
+### isNonRetryableError()
+
+```ts
+function isNonRetryableError(error): error is NonRetryableError;
+```
+
+Defined in: [packages/worker/src/errors.ts:127](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L127)
+
+Type guard to check if an error is a NonRetryableError.
+
+Use this to check error types in catch blocks or error handlers.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `error` | `unknown` | The error to check |
+
+#### Returns
+
+`error is NonRetryableError`
+
+True if the error is a NonRetryableError
+
+#### Example
+
+```typescript
+import { isNonRetryableError } from '@amqp-contract/worker';
+
+try {
+  await processMessage();
+} catch (error) {
+  if (isNonRetryableError(error)) {
+    console.log('Will not retry:', error.message);
+  }
+}
+```
+
+***
+
+### isRetryableError()
+
+```ts
+function isRetryableError(error): error is RetryableError;
+```
+
+Defined in: [packages/worker/src/errors.ts:102](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L102)
+
+Type guard to check if an error is a RetryableError.
+
+Use this to check error types in catch blocks or error handlers.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `error` | `unknown` | The error to check |
+
+#### Returns
+
+`error is RetryableError`
+
+True if the error is a RetryableError
+
+#### Example
+
+```typescript
+import { isRetryableError } from '@amqp-contract/worker';
+
+try {
+  await processMessage();
+} catch (error) {
+  if (isRetryableError(error)) {
+    console.log('Will retry:', error.message);
+  } else {
+    console.log('Permanent failure:', error);
+  }
+}
+```
+
+***
+
+### nonRetryable()
+
+```ts
+function nonRetryable(message, cause?): NonRetryableError;
+```
+
+Defined in: [packages/worker/src/errors.ts:211](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L211)
+
+Create a NonRetryableError with less verbosity.
+
+This is a shorthand factory function for creating NonRetryableError instances.
+Use it for cleaner error creation in handlers.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `message` | `string` | Error message describing the failure |
+| `cause?` | `unknown` | Optional underlying error that caused this failure |
+
+#### Returns
+
+[`NonRetryableError`](#nonretryableerror)
+
+A new NonRetryableError instance
+
+#### Example
+
+```typescript
+import { nonRetryable } from '@amqp-contract/worker';
+import { Future, Result } from '@swan-io/boxed';
+
+const handler = ({ payload }) => {
+  if (!isValidPayload(payload)) {
+    return Future.value(Result.Error(nonRetryable('Invalid payload format')));
+  }
+  return Future.value(Result.Ok(undefined));
+};
+
+// Equivalent to:
+// return Future.value(Result.Error(new NonRetryableError('Invalid payload format')));
+```
+
+***
+
+### retryable()
+
+```ts
+function retryable(message, cause?): RetryableError;
+```
+
+Defined in: [packages/worker/src/errors.ts:181](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L181)
+
+Create a RetryableError with less verbosity.
+
+This is a shorthand factory function for creating RetryableError instances.
+Use it for cleaner error creation in handlers.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `message` | `string` | Error message describing the failure |
+| `cause?` | `unknown` | Optional underlying error that caused this failure |
+
+#### Returns
+
+[`RetryableError`](#retryableerror)
+
+A new RetryableError instance
+
+#### Example
+
+```typescript
+import { retryable } from '@amqp-contract/worker';
+import { Future, Result } from '@swan-io/boxed';
+
+const handler = ({ payload }) =>
+  Future.fromPromise(processPayment(payload))
+    .mapOk(() => undefined)
+    .mapError((e) => retryable('Payment service unavailable', e));
+
+// Equivalent to:
+// .mapError((e) => new RetryableError('Payment service unavailable', e));
+```