@amqp-contract/worker 0.23.1 → 0.24.0

package/docs/index.md

@@ -170,7 +170,7 @@ Error.prepareStackTrace
 
 ### NonRetryableError
 
-Defined in: [packages/worker/src/errors.ts:34](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L34)
+Defined in: [packages/worker/src/errors.ts:34](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L34)
 
 Non-retryable errors - permanent failures that should not be retried
 Examples: invalid data, business rule violations, permanent external failures
@@ -190,7 +190,7 @@ immediately sent to the dead letter queue (DLQ) if configured.
 new NonRetryableError(message, cause?): NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:35](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L35)
+Defined in: [packages/worker/src/errors.ts:35](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L35)
 
 ###### Parameters
 
@@ -213,7 +213,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:37](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L37) |
+| <a id="cause-1"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/worker/src/errors.ts:37](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L37) |
 | <a id="message-1"></a> `message` | `public` | `string` | - | `Error.message` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1075 |
 | <a id="name-1"></a> `name` | `public` | `string` | - | `Error.name` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1074 |
 | <a id="stack-1"></a> `stack?` | `public` | `string` | - | `Error.stack` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
@@ -323,7 +323,7 @@ Error.prepareStackTrace
 
 ### RetryableError
 
-Defined in: [packages/worker/src/errors.ts:10](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L10)
+Defined in: [packages/worker/src/errors.ts:10](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L10)
 
 Retryable errors - transient failures that may succeed on retry
 Examples: network timeouts, rate limiting, temporary service unavailability
@@ -343,7 +343,7 @@ The worker will apply exponential backoff and retry the message.
 new RetryableError(message, cause?): RetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:11](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L11)
+Defined in: [packages/worker/src/errors.ts:11](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L11)
 
 ###### Parameters
 
@@ -366,7 +366,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:13](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L13) |
+| <a id="cause-2"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/worker/src/errors.ts:13](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L13) |
 | <a id="message-2"></a> `message` | `public` | `string` | - | `Error.message` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1075 |
 | <a id="name-2"></a> `name` | `public` | `string` | - | `Error.name` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1074 |
 | <a id="stack-2"></a> `stack?` | `public` | `string` | - | `Error.stack` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
@@ -476,7 +476,7 @@ Error.prepareStackTrace
 
 ### TypedAmqpWorker
 
-Defined in: [packages/worker/src/worker.ts:177](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L177)
+Defined in: [packages/worker/src/worker.ts:181](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L181)
 
 Type-safe AMQP worker for consuming messages from RabbitMQ.
 
@@ -488,6 +488,7 @@ 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 { okAsync } from 'neverthrow';
 import { z } from 'zod';
 
 const orderQueue = defineQueue('order-processing');
@@ -502,19 +503,22 @@ const contract = defineContract({
   }
 });
 
-const worker = await TypedAmqpWorker.create({
+const result = await TypedAmqpWorker.create({
   contract,
   handlers: {
-    processOrder: async (message) => {
-      console.log('Processing order', message.orderId);
-      // Process the order...
-    }
+    processOrder: ({ payload }) => {
+      console.log('Processing order', payload.orderId);
+      return okAsync(undefined);
+    },
   },
-  urls: ['amqp://localhost']
-}).resultToPromise();
+  urls: ['amqp://localhost'],
+});
+
+if (result.isErr()) throw result.error;
+const worker = result.value;
 
 // Close when done
-await worker.close().resultToPromise();
+await worker.close();
 ```
 
 #### Type Parameters
@@ -528,10 +532,10 @@ await worker.close().resultToPromise();
 ##### close()
 
 ```ts
-close(): Future<Result<void, TechnicalError>>;
+close(): ResultAsync<void, TechnicalError>;
 ```
 
-Defined in: [packages/worker/src/worker.ts:339](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L339)
+Defined in: [packages/worker/src/worker.ts:341](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L341)
 
 Close the AMQP channel and connection.
 
@@ -540,14 +544,12 @@ stopping all message consumption and cleaning up resources.
 
 ###### Returns
 
-`Future`&lt;`Result`&lt;`void`, `TechnicalError`&gt;&gt;
-
-A Future that resolves to a Result indicating success or failure
+`ResultAsync`&lt;`void`, `TechnicalError`&gt;
 
 ###### Example
 
 ```typescript
-const closeResult = await worker.close().resultToPromise();
+const closeResult = await worker.close();
 if (closeResult.isOk()) {
   console.log('Worker closed successfully');
 }
@@ -556,10 +558,10 @@ if (closeResult.isOk()) {
 ##### create()
 
 ```ts
-static create<TContract>(options): Future<Result<TypedAmqpWorker<TContract>, TechnicalError>>;
+static create<TContract>(__namedParameters): ResultAsync<TypedAmqpWorker<TContract>, TechnicalError>;
 ```
 
-Defined in: [packages/worker/src/worker.ts:277](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L277)
+Defined in: [packages/worker/src/worker.ts:280](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L280)
 
 Create a type-safe AMQP worker from a contract.
 
@@ -579,26 +581,26 @@ URLs and connection options, following RabbitMQ best practices.
 
 ###### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `options` | [`CreateWorkerOptions`](#createworkeroptions)&lt;`TContract`&gt; | Configuration options for the worker |
+| Parameter | Type |
+| ------ | ------ |
+| `__namedParameters` | [`CreateWorkerOptions`](#createworkeroptions)&lt;`TContract`&gt; |
 
 ###### Returns
 
-`Future`&lt;`Result`&lt;[`TypedAmqpWorker`](#typedamqpworker)&lt;`TContract`&gt;, `TechnicalError`&gt;&gt;
+`ResultAsync`&lt;[`TypedAmqpWorker`](#typedamqpworker)&lt;`TContract`&gt;, `TechnicalError`&gt;
 
-A Future that resolves to a Result containing the worker or an error
+A ResultAsync that resolves to the worker or a TechnicalError.
 
 ###### Example
 
 ```typescript
-const worker = await TypedAmqpWorker.create({
+const result = await TypedAmqpWorker.create({
   contract: myContract,
   handlers: {
-    processOrder: async ({ payload }) => console.log('Order:', payload.orderId)
+    processOrder: ({ payload }) => okAsync(undefined),
   },
-  urls: ['amqp://localhost']
-}).resultToPromise();
+  urls: ['amqp://localhost'],
+});
 ```
 
 ## Type Aliases
@@ -609,7 +611,7 @@ const worker = await TypedAmqpWorker.create({
 type ConsumerOptions = AmqpClientConsumerOptions;
 ```
 
-Defined in: [packages/worker/src/worker.ts:49](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L49)
+Defined in: [packages/worker/src/worker.ts:49](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L49)
 
 ***
 
@@ -619,7 +621,7 @@ Defined in: [packages/worker/src/worker.ts:49](https://github.com/btravers/amqp-
 type CreateWorkerOptions<TContract> = object;
 ```
 
-Defined in: [packages/worker/src/worker.ts:96](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L96)
+Defined in: [packages/worker/src/worker.ts:96](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L96)
 
 Options for creating a type-safe AMQP worker.
 
@@ -632,13 +634,13 @@ const options: CreateWorkerOptions<typeof contract> = {
     // Simple handler
     processOrder: ({ payload }) => {
       console.log('Processing order:', payload.orderId);
-      return Future.value(Result.Ok(undefined));
+      return okAsync(undefined);
     },
     // Handler with prefetch configuration
     processPayment: [
       ({ payload }) => {
         console.log('Processing payment:', payload.paymentId);
-        return Future.value(Result.Ok(undefined));
+        return okAsync(undefined);
       },
       { prefetch: 10 }
     ]
@@ -667,14 +669,14 @@ 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:113](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L113) |
-| <a id="connecttimeoutms"></a> `connectTimeoutMs?` | `number` \| `null` | Maximum time in ms to wait for the AMQP connection to become ready before `create()` resolves to `Result.Error<TechnicalError>`. Defaults to 30s (the [AmqpClient](https://btravers.github.io/amqp-contract/api/core#amqpclient)'s `DEFAULT_CONNECT_TIMEOUT_MS`). Pass `null` to disable the timeout and let amqp-connection-manager retry indefinitely. | [packages/worker/src/worker.ts:133](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L133) |
-| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [packages/worker/src/worker.ts:98](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L98) |
-| <a id="defaultconsumeroptions"></a> `defaultConsumerOptions?` | [`ConsumerOptions`](#consumeroptions) | Optional default consumer options applied to all consumer handlers. Handler-specific options provided in tuple form override these defaults. | [packages/worker/src/worker.ts:126](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L126) |
-| <a id="handlers"></a> `handlers` | `WorkerInferHandlers`&lt;`TContract`&gt; | Handlers for each `consumers` and `rpcs` entry in the contract. - Regular consumers return `Future<Result<void, HandlerError>>`. - RPC handlers return `Future<Result<TResponse, HandlerError>>` where `TResponse` is inferred from the RPC's response message schema. Use `defineHandler` / `defineHandlers` to create handlers with full type inference. | [packages/worker/src/worker.ts:109](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L109) |
-| <a id="logger"></a> `logger?` | `Logger` | Optional logger for logging message consumption and errors | [packages/worker/src/worker.ts:115](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L115) |
-| <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:121](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L121) |
-| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [packages/worker/src/worker.ts:111](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/worker.ts#L111) |
+| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.) | [packages/worker/src/worker.ts:113](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L113) |
+| <a id="connecttimeoutms"></a> `connectTimeoutMs?` | `number` \| `null` | Maximum time in ms to wait for the AMQP connection to become ready before `create()` resolves to an `err(TechnicalError)`. Defaults to 30s (the [AmqpClient](https://btravers.github.io/amqp-contract/api/core#amqpclient)'s `DEFAULT_CONNECT_TIMEOUT_MS`). Pass `null` to disable the timeout and let amqp-connection-manager retry indefinitely. | [packages/worker/src/worker.ts:133](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L133) |
+| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [packages/worker/src/worker.ts:98](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L98) |
+| <a id="defaultconsumeroptions"></a> `defaultConsumerOptions?` | [`ConsumerOptions`](#consumeroptions) | Optional default consumer options applied to all consumer handlers. Handler-specific options provided in tuple form override these defaults. | [packages/worker/src/worker.ts:126](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L126) |
+| <a id="handlers"></a> `handlers` | `WorkerInferHandlers`&lt;`TContract`&gt; | Handlers for each `consumers` and `rpcs` entry in the contract. - Regular consumers return `ResultAsync<void, HandlerError>`. - RPC handlers return `ResultAsync<TResponse, HandlerError>` where `TResponse` is inferred from the RPC's response message schema. Use `defineHandler` / `defineHandlers` to create handlers with full type inference. | [packages/worker/src/worker.ts:109](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L109) |
+| <a id="logger"></a> `logger?` | `Logger` | Optional logger for logging message consumption and errors | [packages/worker/src/worker.ts:115](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L115) |
+| <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:121](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L121) |
+| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [packages/worker/src/worker.ts:111](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/worker.ts#L111) |
 
 ***
 
@@ -686,7 +688,7 @@ type HandlerError =
   | NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:55](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L55)
+Defined in: [packages/worker/src/errors.ts:55](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L55)
 
 Union type representing all handler errors.
 Use this type when defining handlers that explicitly signal error outcomes.
@@ -699,7 +701,7 @@ Use this type when defining handlers that explicitly signal error outcomes.
 type WorkerConsumedMessage<TPayload, THeaders> = object;
 ```
 
-Defined in: [packages/worker/src/types.ts:156](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/types.ts#L156)
+Defined in: [packages/worker/src/types.ts:156](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/types.ts#L156)
 
 A consumed message containing parsed payload and headers.
 
@@ -713,7 +715,7 @@ const handler = defineHandler(contract, 'processOrder', (message, rawMessage) =>
   console.log(message.payload.orderId);  // Typed payload
   console.log(message.headers?.priority); // Typed headers (if defined)
   console.log(rawMessage.fields.deliveryTag); // Raw AMQP message
-  return Future.value(Result.Ok(undefined));
+  return okAsync(undefined);
 });
 ```
 
@@ -728,8 +730,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:160](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/types.ts#L160) |
-| <a id="payload"></a> `payload` | `TPayload` | The validated message payload | [packages/worker/src/types.ts:158](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/types.ts#L158) |
+| <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:160](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/types.ts#L160) |
+| <a id="payload"></a> `payload` | `TPayload` | The validated message payload | [packages/worker/src/types.ts:158](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/types.ts#L158) |
 
 ***
 
@@ -739,7 +741,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:166](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/types.ts#L166)
+Defined in: [packages/worker/src/types.ts:166](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/types.ts#L166)
 
 Infer the full consumed message type for a regular consumer.
 
@@ -755,13 +757,13 @@ Infer the full consumed message type for a regular consumer.
 ### WorkerInferConsumerHandler
 
 ```ts
-type WorkerInferConsumerHandler<TContract, TName> = (message, rawMessage) => Future<Result<void, HandlerError>>;
+type WorkerInferConsumerHandler<TContract, TName> = (message, rawMessage) => ResultAsync<void, HandlerError>;
 ```
 
-Defined in: [packages/worker/src/types.ts:197](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/types.ts#L197)
+Defined in: [packages/worker/src/types.ts:197](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/types.ts#L197)
 
 Handler signature for a regular consumer (event/command). Returns
-`Future<Result<void, HandlerError>>` — there is no response message.
+`ResultAsync<void, HandlerError>` — there is no response message.
 
 #### Type Parameters
 
@@ -779,7 +781,7 @@ Handler signature for a regular consumer (event/command). Returns
 
 #### Returns
 
-`Future`&lt;`Result`&lt;`void`, [`HandlerError`](#handlererror)&gt;&gt;
+`ResultAsync`&lt;`void`, [`HandlerError`](#handlererror)&gt;
 
 ***
 
@@ -791,7 +793,7 @@ type WorkerInferConsumerHandlerEntry<TContract, TName> =
   | readonly [WorkerInferConsumerHandler<TContract, TName>, ConsumerOptions];
 ```
 
-Defined in: [packages/worker/src/types.ts:223](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/types.ts#L223)
+Defined in: [packages/worker/src/types.ts:223](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/types.ts#L223)
 
 Handler entry for a regular consumer — function or `[handler, options]`.
 
@@ -810,7 +812,7 @@ Handler entry for a regular consumer — function or `[handler, options]`.
 type WorkerInferConsumerHandlers<TContract> = WorkerInferHandlers<TContract>;
 ```
 
-Defined in: [packages/worker/src/types.ts:269](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/types.ts#L269)
+Defined in: [packages/worker/src/types.ts:269](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/types.ts#L269)
 
 #### Type Parameters
 
@@ -830,7 +832,7 @@ Use `WorkerInferHandlers` — handlers now span consumers ∪ rpcs.
 type WorkerInferConsumerHeaders<TContract, TName> = ConsumerInferHeadersOutput<InferConsumer<TContract, TName>>;
 ```
 
-Defined in: [packages/worker/src/types.ts:85](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/types.ts#L85)
+Defined in: [packages/worker/src/types.ts:85](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/types.ts#L85)
 
 Infer the headers type for a regular consumer.
 Returns undefined if no headers schema is defined.
@@ -855,11 +857,11 @@ function defineHandler<TContract, TName>(
    handler): WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:104](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/handlers.ts#L104)
+Defined in: [packages/worker/src/handlers.ts:105](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/handlers.ts#L105)
 
 Define a type-safe handler for a specific consumer in a contract.
 
-**Recommended:** This function creates handlers that return `Future<Result<void, HandlerError>>`,
+**Recommended:** This function creates handlers that return `ResultAsync<void, HandlerError>`,
 providing explicit error handling and better control over retry behavior.
 
 Supports two patterns:
@@ -879,7 +881,7 @@ Supports two patterns:
 | ------ | ------ | ------ |
 | `contract` | `TContract` | The contract definition containing the consumer |
 | `consumerName` | `TName` | The name of the consumer from the contract |
-| `handler` | [`WorkerInferConsumerHandler`](#workerinferconsumerhandler)&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 `ResultAsync<void, HandlerError>` |
 
 ##### Returns
 
@@ -891,17 +893,18 @@ A type-safe handler that can be used with TypedAmqpWorker
 
 ```typescript
 import { defineHandler, RetryableError, NonRetryableError } from '@amqp-contract/worker';
-import { Future, Result } from '@swan-io/boxed';
+import { errAsync, okAsync, ResultAsync } from 'neverthrow';
 import { orderContract } from './contract';
 
-// Simple handler with explicit error handling using mapError
+// Simple handler with explicit error handling
 const processOrderHandler = defineHandler(
   orderContract,
   'processOrder',
   ({ payload }) =>
-    Future.fromPromise(processPayment(payload))
-      .mapOk(() => undefined)
-      .mapError((error) => new RetryableError('Payment failed', error))
+    ResultAsync.fromPromise(
+      processPayment(payload),
+      (error) => new RetryableError('Payment failed', error),
+    ).map(() => undefined),
 );
 
 // Handler with validation (non-retryable error)
@@ -911,10 +914,10 @@ const validateOrderHandler = defineHandler(
   ({ payload }) => {
     if (payload.amount < 1) {
       // Won't be retried - goes directly to DLQ
-      return Future.value(Result.Error(new NonRetryableError('Invalid order amount')));
+      return errAsync(new NonRetryableError('Invalid order amount'));
     }
-    return Future.value(Result.Ok(undefined));
-  }
+    return okAsync(undefined);
+  },
 );
 ```
 
@@ -928,11 +931,11 @@ function defineHandler<TContract, TName>(
    options): WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:112](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/handlers.ts#L112)
+Defined in: [packages/worker/src/handlers.ts:113](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/handlers.ts#L113)
 
 Define a type-safe handler for a specific consumer in a contract.
 
-**Recommended:** This function creates handlers that return `Future<Result<void, HandlerError>>`,
+**Recommended:** This function creates handlers that return `ResultAsync<void, HandlerError>`,
 providing explicit error handling and better control over retry behavior.
 
 Supports two patterns:
@@ -952,7 +955,7 @@ Supports two patterns:
 | ------ | ------ | ------ |
 | `contract` | `TContract` | The contract definition containing the consumer |
 | `consumerName` | `TName` | The name of the consumer from the contract |
-| `handler` | [`WorkerInferConsumerHandler`](#workerinferconsumerhandler)&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 `ResultAsync<void, HandlerError>` |
 | `options` | `ConsumerOptions` | Optional consumer options (prefetch) |
 
 ##### Returns
@@ -965,17 +968,18 @@ A type-safe handler that can be used with TypedAmqpWorker
 
 ```typescript
 import { defineHandler, RetryableError, NonRetryableError } from '@amqp-contract/worker';
-import { Future, Result } from '@swan-io/boxed';
+import { errAsync, okAsync, ResultAsync } from 'neverthrow';
 import { orderContract } from './contract';
 
-// Simple handler with explicit error handling using mapError
+// Simple handler with explicit error handling
 const processOrderHandler = defineHandler(
   orderContract,
   'processOrder',
   ({ payload }) =>
-    Future.fromPromise(processPayment(payload))
-      .mapOk(() => undefined)
-      .mapError((error) => new RetryableError('Payment failed', error))
+    ResultAsync.fromPromise(
+      processPayment(payload),
+      (error) => new RetryableError('Payment failed', error),
+    ).map(() => undefined),
 );
 
 // Handler with validation (non-retryable error)
@@ -985,10 +989,10 @@ const validateOrderHandler = defineHandler(
   ({ payload }) => {
     if (payload.amount < 1) {
       // Won't be retried - goes directly to DLQ
-      return Future.value(Result.Error(new NonRetryableError('Invalid order amount')));
+      return errAsync(new NonRetryableError('Invalid order amount'));
     }
-    return Future.value(Result.Ok(undefined));
-  }
+    return okAsync(undefined);
+  },
 );
 ```
 
@@ -1000,11 +1004,11 @@ const validateOrderHandler = defineHandler(
 function defineHandlers<TContract>(contract, handlers): WorkerInferConsumerHandlers<TContract>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:167](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/handlers.ts#L167)
+Defined in: [packages/worker/src/handlers.ts:170](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/handlers.ts#L170)
 
 Define multiple type-safe handlers for consumers in a contract.
 
-**Recommended:** This function creates handlers that return `Future<Result<void, HandlerError>>`,
+**Recommended:** This function creates handlers that return `ResultAsync<void, HandlerError>`,
 providing explicit error handling and better control over retry behavior.
 
 #### Type Parameters
@@ -1030,18 +1034,20 @@ A type-safe handlers object that can be used with TypedAmqpWorker
 
 ```typescript
 import { defineHandlers, RetryableError } from '@amqp-contract/worker';
-import { Future } from '@swan-io/boxed';
+import { ResultAsync } from 'neverthrow';
 import { orderContract } from './contract';
 
 const handlers = defineHandlers(orderContract, {
   processOrder: ({ payload }) =>
-    Future.fromPromise(processPayment(payload))
-      .mapOk(() => undefined)
-      .mapError((error) => new RetryableError('Payment failed', error)),
+    ResultAsync.fromPromise(
+      processPayment(payload),
+      (error) => new RetryableError('Payment failed', error),
+    ).map(() => undefined),
   notifyOrder: ({ payload }) =>
-    Future.fromPromise(sendNotification(payload))
-      .mapOk(() => undefined)
-      .mapError((error) => new RetryableError('Notification failed', error)),
+    ResultAsync.fromPromise(
+      sendNotification(payload),
+      (error) => new RetryableError('Notification failed', error),
+    ).map(() => undefined),
 });
 ```
 
@@ -1053,7 +1059,7 @@ const handlers = defineHandlers(orderContract, {
 function isHandlerError(error): error is HandlerError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:131](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L131)
+Defined in: [packages/worker/src/errors.ts:131](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L131)
 
 Type guard to check if an error is any HandlerError (RetryableError or NonRetryableError).
 
@@ -1090,7 +1096,7 @@ function handleError(error: unknown) {
 function isNonRetryableError(error): error is NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:109](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L109)
+Defined in: [packages/worker/src/errors.ts:109](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L109)
 
 Type guard to check if an error is a NonRetryableError.
 
@@ -1130,7 +1136,7 @@ try {
 function isRetryableError(error): error is RetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:84](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L84)
+Defined in: [packages/worker/src/errors.ts:84](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L84)
 
 Type guard to check if an error is a RetryableError.
 
@@ -1172,7 +1178,7 @@ try {
 function nonRetryable(message, cause?): NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:193](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L193)
+Defined in: [packages/worker/src/errors.ts:194](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L194)
 
 Create a NonRetryableError with less verbosity.
 
@@ -1196,17 +1202,17 @@ A new NonRetryableError instance
 
 ```typescript
 import { nonRetryable } from '@amqp-contract/worker';
-import { Future, Result } from '@swan-io/boxed';
+import { errAsync, okAsync } from 'neverthrow';
 
 const handler = ({ payload }) => {
   if (!isValidPayload(payload)) {
-    return Future.value(Result.Error(nonRetryable('Invalid payload format')));
+    return errAsync(nonRetryable('Invalid payload format'));
   }
-  return Future.value(Result.Ok(undefined));
+  return okAsync(undefined);
 };
 
 // Equivalent to:
-// return Future.value(Result.Error(new NonRetryableError('Invalid payload format')));
+// return errAsync(new NonRetryableError('Invalid payload format'));
 ```
 
 ***
@@ -1217,7 +1223,7 @@ const handler = ({ payload }) => {
 function retryable(message, cause?): RetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:163](https://github.com/btravers/amqp-contract/blob/dc096282cd7249a6b8148d35c3dfad011c9e9753/packages/worker/src/errors.ts#L163)
+Defined in: [packages/worker/src/errors.ts:164](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/worker/src/errors.ts#L164)
 
 Create a RetryableError with less verbosity.
 
@@ -1241,13 +1247,14 @@ A new RetryableError instance
 
 ```typescript
 import { retryable } from '@amqp-contract/worker';
-import { Future, Result } from '@swan-io/boxed';
+import { ResultAsync } from 'neverthrow';
 
 const handler = ({ payload }) =>
-  Future.fromPromise(processPayment(payload))
-    .mapOk(() => undefined)
-    .mapError((e) => retryable('Payment service unavailable', e));
+  ResultAsync.fromPromise(
+    processPayment(payload),
+    (e) => retryable('Payment service unavailable', e),
+  ).map(() => undefined);
 
 // Equivalent to:
-// .mapError((e) => new RetryableError('Payment service unavailable', e));
+// ResultAsync.fromPromise(processPayment(payload), (e) => new RetryableError('...', e))
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amqp-contract/worker",
-  "version": "0.23.1",
+  "version": "0.24.0",
   "description": "Worker utilities for consuming messages using amqp-contract",
   "keywords": [
     "amqp",
@@ -51,9 +51,9 @@
   },
   "dependencies": {
     "@standard-schema/spec": "1.1.0",
-    "@swan-io/boxed": "3.2.1",
-    "@amqp-contract/contract": "0.23.1",
-    "@amqp-contract/core": "0.23.1"
+    "neverthrow": "8.2.0",
+    "@amqp-contract/contract": "0.24.0",
+    "@amqp-contract/core": "0.24.0"
   },
   "devDependencies": {
     "@types/amqplib": "0.10.8",
@@ -67,7 +67,7 @@
     "typescript": "6.0.3",
     "vitest": "4.1.5",
     "zod": "4.4.3",
-    "@amqp-contract/testing": "0.23.1",
+    "@amqp-contract/testing": "0.24.0",
     "@amqp-contract/tsconfig": "0.1.0",
     "@amqp-contract/typedoc": "0.1.0"
   },