@amqp-contract/worker 0.11.0 → 0.13.0

package/docs/index.md

@@ -8,13 +8,13 @@
 
 ### MessageValidationError
 
-Defined in: [packages/worker/src/errors.ts:35](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L35)
+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
 
 #### Extends
 
-- `WorkerError`
+- `Error`
 
 #### Constructors
 
@@ -24,7 +24,7 @@ Error thrown when message validation fails
 new MessageValidationError(consumerName, issues): MessageValidationError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:36](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L36)
+Defined in: [packages/worker/src/errors.ts:5](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L5)
 
 ###### Parameters
 
@@ -40,20 +40,20 @@ Defined in: [packages/worker/src/errors.ts:36](https://github.com/btravers/amqp-
 ###### Overrides
 
 ```ts
-WorkerError.constructor
+Error.constructor
 ```
 
 #### Properties
 
 | Property | Modifier | Type | Description | Inherited from | Defined in |
 | ------ | ------ | ------ | ------ | ------ | ------ |
-| <a id="cause"></a> `cause?` | `public` | `unknown` | - | `WorkerError.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:37](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L37) |
-| <a id="issues"></a> `issues` | `readonly` | `unknown` | - | - | [packages/worker/src/errors.ts:38](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L38) |
-| <a id="message"></a> `message` | `public` | `string` | - | `WorkerError.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
-| <a id="name"></a> `name` | `public` | `string` | - | `WorkerError.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
-| <a id="stack"></a> `stack?` | `public` | `string` | - | `WorkerError.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. | `WorkerError.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:67 |
+| <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/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 |
+| <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 |
 
 #### Methods
 
@@ -123,7 +123,7 @@ a();
 ###### Inherited from
 
 ```ts
-WorkerError.captureStackTrace
+Error.captureStackTrace
 ```
 
 ##### prepareStackTrace()
@@ -152,14 +152,14 @@ https://v8.dev/docs/stack-trace-api#customizing-stack-traces
 ###### Inherited from
 
 ```ts
-WorkerError.prepareStackTrace
+Error.prepareStackTrace
 ```
 
 ***
 
 ### NonRetryableError
 
-Defined in: [packages/worker/src/errors.ts:69](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L69)
+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
@@ -169,7 +169,7 @@ immediately sent to the dead letter queue (DLQ) if configured.
 
 #### Extends
 
-- `WorkerError`
+- `Error`
 
 #### Constructors
 
@@ -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:70](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L70)
+Defined in: [packages/worker/src/errors.ts:53](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L53)
 
 ###### Parameters
 
@@ -195,18 +195,18 @@ Defined in: [packages/worker/src/errors.ts:70](https://github.com/btravers/amqp-
 ###### Overrides
 
 ```ts
-WorkerError.constructor
+Error.constructor
 ```
 
 #### Properties
 
 | Property | Modifier | Type | Description | Inherited from | Defined in |
 | ------ | ------ | ------ | ------ | ------ | ------ |
-| <a id="cause-1"></a> `cause?` | `readonly` | `unknown` | - | `WorkerError.cause` | [packages/worker/src/errors.ts:72](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L72) |
-| <a id="message-1"></a> `message` | `public` | `string` | - | `WorkerError.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` | - | `WorkerError.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` | - | `WorkerError.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. | `WorkerError.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:67 |
+| <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 |
+| <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 |
 
 #### Methods
 
@@ -276,7 +276,7 @@ a();
 ###### Inherited from
 
 ```ts
-WorkerError.captureStackTrace
+Error.captureStackTrace
 ```
 
 ##### prepareStackTrace()
@@ -305,14 +305,14 @@ https://v8.dev/docs/stack-trace-api#customizing-stack-traces
 ###### Inherited from
 
 ```ts
-WorkerError.prepareStackTrace
+Error.prepareStackTrace
 ```
 
 ***
 
 ### RetryableError
 
-Defined in: [packages/worker/src/errors.ts:52](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L52)
+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
@@ -322,7 +322,7 @@ The worker will apply exponential backoff and retry the message.
 
 #### Extends
 
-- `WorkerError`
+- `Error`
 
 #### Constructors
 
@@ -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:53](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L53)
+Defined in: [packages/worker/src/errors.ts:29](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/errors.ts#L29)
 
 ###### Parameters
 
@@ -348,18 +348,18 @@ Defined in: [packages/worker/src/errors.ts:53](https://github.com/btravers/amqp-
 ###### Overrides
 
 ```ts
-WorkerError.constructor
+Error.constructor
 ```
 
 #### Properties
 
 | Property | Modifier | Type | Description | Inherited from | Defined in |
 | ------ | ------ | ------ | ------ | ------ | ------ |
-| <a id="cause-2"></a> `cause?` | `readonly` | `unknown` | - | `WorkerError.cause` | [packages/worker/src/errors.ts:55](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L55) |
-| <a id="message-2"></a> `message` | `public` | `string` | - | `WorkerError.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` | - | `WorkerError.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` | - | `WorkerError.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. | `WorkerError.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:67 |
+| <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 |
+| <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 |
 
 #### Methods
 
@@ -429,7 +429,7 @@ a();
 ###### Inherited from
 
 ```ts
-WorkerError.captureStackTrace
+Error.captureStackTrace
 ```
 
 ##### prepareStackTrace()
@@ -458,164 +458,14 @@ https://v8.dev/docs/stack-trace-api#customizing-stack-traces
 ###### Inherited from
 
 ```ts
-WorkerError.prepareStackTrace
-```
-
-***
-
-### TechnicalError
-
-Defined in: [packages/worker/src/errors.ts:22](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L22)
-
-Error for technical/runtime failures in worker operations
-This includes validation failures, parsing failures, and processing failures
-
-#### Extends
-
-- `WorkerError`
-
-#### Constructors
-
-##### Constructor
-
-```ts
-new TechnicalError(message, cause?): TechnicalError;
-```
-
-Defined in: [packages/worker/src/errors.ts:23](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L23)
-
-###### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `message` | `string` |
-| `cause?` | `unknown` |
-
-###### Returns
-
-[`TechnicalError`](#technicalerror)
-
-###### Overrides
-
-```ts
-WorkerError.constructor
-```
-
-#### Properties
-
-| Property | Modifier | Type | Description | Inherited from | Defined in |
-| ------ | ------ | ------ | ------ | ------ | ------ |
-| <a id="cause-3"></a> `cause?` | `readonly` | `unknown` | - | `WorkerError.cause` | [packages/worker/src/errors.ts:25](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L25) |
-| <a id="message-3"></a> `message` | `public` | `string` | - | `WorkerError.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
-| <a id="name-3"></a> `name` | `public` | `string` | - | `WorkerError.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
-| <a id="stack-3"></a> `stack?` | `public` | `string` | - | `WorkerError.stack` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1078 |
-| <a id="stacktracelimit-3"></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. | `WorkerError.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:67 |
-
-#### Methods
-
-##### captureStackTrace()
-
-```ts
-static captureStackTrace(targetObject, constructorOpt?): void;
-```
-
-Defined in: node\_modules/.pnpm/@types+node@25.0.9/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
-`Error.captureStackTrace()` was called.
-
-```js
-const myObject = {};
-Error.captureStackTrace(myObject);
-myObject.stack;  // Similar to `new Error().stack`
-```
-
-The first line of the trace will be prefixed with
-`${myObject.name}: ${myObject.message}`.
-
-The optional `constructorOpt` argument accepts a function. If given, all frames
-above `constructorOpt`, including `constructorOpt`, will be omitted from the
-generated stack trace.
-
-The `constructorOpt` argument is useful for hiding implementation
-details of error generation from the user. For instance:
-
-```js
-function a() {
-  b();
-}
-
-function b() {
-  c();
-}
-
-function c() {
-  // Create an error without stack trace to avoid calculating the stack trace twice.
-  const { stackTraceLimit } = Error;
-  Error.stackTraceLimit = 0;
-  const error = new Error();
-  Error.stackTraceLimit = stackTraceLimit;
-
-  // Capture the stack trace above function b
-  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
-  throw error;
-}
-
-a();
-```
-
-###### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `targetObject` | `object` |
-| `constructorOpt?` | `Function` |
-
-###### Returns
-
-`void`
-
-###### Inherited from
-
-```ts
-WorkerError.captureStackTrace
-```
-
-##### prepareStackTrace()
-
-```ts
-static prepareStackTrace(err, stackTraces): any;
-```
-
-Defined in: node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:55
-
-###### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `err` | `Error` |
-| `stackTraces` | `CallSite`[] |
-
-###### Returns
-
-`any`
-
-###### See
-
-https://v8.dev/docs/stack-trace-api#customizing-stack-traces
-
-###### Inherited from
-
-```ts
-WorkerError.prepareStackTrace
+Error.prepareStackTrace
 ```
 
 ***
 
 ### TypedAmqpWorker
 
-Defined in: [packages/worker/src/worker.ts:178](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/worker.ts#L178)
+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.
 
@@ -669,7 +519,7 @@ await worker.close().resultToPromise();
 close(): Future<Result<void, TechnicalError>>;
 ```
 
-Defined in: [packages/worker/src/worker.ts:299](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/worker.ts#L299)
+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.
 
@@ -678,7 +528,7 @@ stopping all message consumption and cleaning up resources.
 
 ###### Returns
 
-`Future`\<`Result`\<`void`, [`TechnicalError`](#technicalerror)\>\>
+`Future`&lt;`Result`&lt;`void`, `TechnicalError`&gt;&gt;
 
 A Future that resolves to a Result indicating success or failure
 
@@ -697,7 +547,7 @@ if (closeResult.isOk()) {
 static create<TContract>(options): Future<Result<TypedAmqpWorker<TContract>, TechnicalError>>;
 ```
 
-Defined in: [packages/worker/src/worker.ts:255](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/worker.ts#L255)
+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.
 
@@ -719,11 +569,11 @@ URLs and connection options, following RabbitMQ best practices.
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `options` | [`CreateWorkerOptions`](#createworkeroptions)\<`TContract`\> | Configuration options for the worker |
+| `options` | [`CreateWorkerOptions`](#createworkeroptions)&lt;`TContract`&gt; | Configuration options for the worker |
 
 ###### Returns
 
-`Future`\<`Result`\<[`TypedAmqpWorker`](#typedamqpworker)\<`TContract`\>, [`TechnicalError`](#technicalerror)\>\>
+`Future`&lt;`Result`&lt;[`TypedAmqpWorker`](#typedamqpworker)&lt;`TContract`&gt;, `TechnicalError`&gt;&gt;
 
 A Future that resolves to a Result containing the worker or an error
 
@@ -747,7 +597,7 @@ const worker = await TypedAmqpWorker.create({
 type CreateWorkerOptions<TContract> = object;
 ```
 
-Defined in: [packages/worker/src/worker.ts:115](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/worker.ts#L115)
+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.
 
@@ -792,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:127](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/worker.ts#L127) |
-| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [packages/worker/src/worker.ts:117](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/worker.ts#L117) |
-| <a id="handlers"></a> `handlers` | [`WorkerInferSafeConsumerHandlers`](#workerinfersafeconsumerhandlers)\<`TContract`\> | 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:123](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/worker.ts#L123) |
-| <a id="logger"></a> `logger?` | `Logger` | Optional logger for logging message consumption and errors | [packages/worker/src/worker.ts:129](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/worker.ts#L129) |
-| <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:135](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/worker.ts#L135) |
-| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [packages/worker/src/worker.ts:125](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/worker.ts#L125) |
+| <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) |
 
 ***
 
@@ -809,7 +659,7 @@ type HandlerError =
   | NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:83](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/errors.ts#L83)
+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.
@@ -822,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/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/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.
 
@@ -852,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/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/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/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/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) |
 
 ***
 
@@ -863,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/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/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).
@@ -873,67 +723,50 @@ Includes both payload and headers (if defined).
 | Type Parameter |
 | ------ |
 | `TContract` *extends* `ContractDefinition` |
-| `TName` *extends* `InferConsumerNames`\<`TContract`\> |
-
-***
-
-### 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/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/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`\<`TContract`\> |
+| `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
 
 ***
 
-### WorkerInferSafeConsumerHandler()
+### WorkerInferConsumerHandler()
 
 ```ts
-type WorkerInferSafeConsumerHandler<TContract, TName> = (message, rawMessage) => Future<Result<void, HandlerError>>;
+type WorkerInferConsumerHandler<TContract, TName> = (message, rawMessage) => Future<Result<void, HandlerError>>;
 ```
 
-Defined in: [packages/worker/src/types.ts:133](https://github.com/btravers/amqp-contract/blob/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/packages/worker/src/types.ts#L133)
+Defined in: [packages/worker/src/types.ts:136](https://github.com/btravers/amqp-contract/blob/69a6467d137997be809af2ea5c4332c378579b49/packages/worker/src/types.ts#L136)
 
-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 |
 | ------ |
 | `TContract` *extends* `ContractDefinition` |
-| `TName` *extends* `InferConsumerNames`\<`TContract`\> |
+| `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
 
 #### Parameters
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `message` | [`WorkerInferConsumedMessage`](#workerinferconsumedmessage)\<`TContract`, `TName`\> | The parsed message containing validated payload and headers |
+| `message` | [`WorkerInferConsumedMessage`](#workerinferconsumedmessage)&lt;`TContract`, `TName`&gt; | The parsed message containing validated payload and headers |
 | `rawMessage` | `ConsumeMessage` | The raw AMQP message with all metadata (fields, properties, content) |
 
 #### Returns
 
-`Future`\<`Result`\<`void`, [`HandlerError`](#handlererror)\>\>
+`Future`&lt;`Result`&lt;`void`, [`HandlerError`](#handlererror)&gt;&gt;
 
 #### 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
@@ -943,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/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/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))`
@@ -969,19 +802,19 @@ not at the handler level. See `QueueDefinition.retry` for configuration options.
 | Type Parameter |
 | ------ |
 | `TContract` *extends* `ContractDefinition` |
-| `TName` *extends* `InferConsumerNames`\<`TContract`\> |
+| `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
 
 ***
 
-### 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/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/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
@@ -990,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()
@@ -1000,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/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/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.
 
@@ -1012,7 +938,7 @@ providing explicit error handling and better control over retry behavior.
 
 Supports two patterns:
 1. Simple handler: just the function
-2. Handler with options: [handler, { prefetch: 10 }]
+2. Handler with options: [handler, \{ prefetch: 10 \}]
 
 ##### Type Parameters
 
@@ -1027,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)\<`TContract`, `TName`\> | 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)\<`TContract`, `TName`\>
+[`WorkerInferConsumerHandlerEntry`](#workerinferconsumerhandlerentry)&lt;`TContract`, `TName`&gt;
 
 A type-safe handler that can be used with TypedAmqpWorker
 
@@ -1073,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/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/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.
 
@@ -1085,7 +1011,7 @@ providing explicit error handling and better control over retry behavior.
 
 Supports two patterns:
 1. Simple handler: just the function
-2. Handler with options: [handler, { prefetch: 10 }]
+2. Handler with options: [handler, \{ prefetch: 10 \}]
 
 ##### Type Parameters
 
@@ -1100,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)\<`TContract`, `TName`\> | 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)\<`TContract`, `TName`\>
+[`WorkerInferConsumerHandlerEntry`](#workerinferconsumerhandlerentry)&lt;`TContract`, `TName`&gt;
 
 A type-safe handler that can be used with TypedAmqpWorker
 
@@ -1146,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/ed05e43c04fa526b751d45622ccc1ac53b2e96f9/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.
 
@@ -1167,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)\<`TContract`\> | 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)\<`TContract`\>
+[`WorkerInferConsumerHandlers`](#workerinferconsumerhandlers)&lt;`TContract`&gt;
 
 A type-safe handlers object that can be used with TypedAmqpWorker
 
@@ -1193,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));
+```