@amqp-contract/client 0.23.0 → 0.24.0

package/docs/index.md

@@ -170,11 +170,11 @@ Error.prepareStackTrace
 
 ### RpcCancelledError
 
-Defined in: [packages/client/src/errors.ts:39](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/errors.ts#L39)
+Defined in: [packages/client/src/errors.ts:39](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/errors.ts#L39)
 
 Returned from any in-flight RPC call when the client is closed before the
 reply is received. The correlation map is cleared on close and every pending
-caller's promise resolves with `Result.Error(RpcCancelledError)`.
+caller's promise resolves with `err(RpcCancelledError)`.
 
 #### Extends
 
@@ -188,7 +188,7 @@ caller's promise resolves with `Result.Error(RpcCancelledError)`.
 new RpcCancelledError(rpcName): RpcCancelledError;
 ```
 
-Defined in: [packages/client/src/errors.ts:40](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/errors.ts#L40)
+Defined in: [packages/client/src/errors.ts:40](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/errors.ts#L40)
 
 ###### Parameters
 
@@ -213,7 +213,7 @@ Error.constructor
 | <a id="cause-1"></a> `cause?` | `public` | `unknown` | - | `Error.cause` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es2022.error.d.ts:24 |
 | <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="rpcname"></a> `rpcName` | `readonly` | `string` | - | - | [packages/client/src/errors.ts:40](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/errors.ts#L40) |
+| <a id="rpcname"></a> `rpcName` | `readonly` | `string` | - | - | [packages/client/src/errors.ts:40](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/errors.ts#L40) |
 | <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 |
 | <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@24.12.2/node\_modules/@types/node/globals.d.ts:68 |
 
@@ -321,7 +321,7 @@ Error.prepareStackTrace
 
 ### RpcTimeoutError
 
-Defined in: [packages/client/src/errors.ts:23](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/errors.ts#L23)
+Defined in: [packages/client/src/errors.ts:23](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/errors.ts#L23)
 
 Returned from `TypedAmqpClient.call()` when the configured `timeoutMs` elapses
 before the RPC server publishes a reply with the matching `correlationId`.
@@ -342,7 +342,7 @@ client if a logger is configured).
 new RpcTimeoutError(rpcName, timeoutMs): RpcTimeoutError;
 ```
 
-Defined in: [packages/client/src/errors.ts:24](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/errors.ts#L24)
+Defined in: [packages/client/src/errors.ts:24](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/errors.ts#L24)
 
 ###### Parameters
 
@@ -368,9 +368,9 @@ Error.constructor
 | <a id="cause-2"></a> `cause?` | `public` | `unknown` | - | `Error.cause` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es2022.error.d.ts:24 |
 | <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="rpcname-1"></a> `rpcName` | `readonly` | `string` | - | - | [packages/client/src/errors.ts:25](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/errors.ts#L25) |
+| <a id="rpcname-1"></a> `rpcName` | `readonly` | `string` | - | - | [packages/client/src/errors.ts:25](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/errors.ts#L25) |
 | <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 |
-| <a id="timeoutms"></a> `timeoutMs` | `readonly` | `number` | - | - | [packages/client/src/errors.ts:26](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/errors.ts#L26) |
+| <a id="timeoutms"></a> `timeoutMs` | `readonly` | `number` | - | - | [packages/client/src/errors.ts:26](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/errors.ts#L26) |
 | <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@24.12.2/node\_modules/@types/node/globals.d.ts:68 |
 
 #### Methods
@@ -477,7 +477,7 @@ Error.prepareStackTrace
 
 ### TypedAmqpClient
 
-Defined in: [packages/client/src/client.ts:124](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L124)
+Defined in: [packages/client/src/client.ts:124](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L124)
 
 Type-safe AMQP client for publishing messages
 
@@ -495,72 +495,67 @@ Type-safe AMQP client for publishing messages
 call<TName>(
    rpcName, 
    request, 
-   options): Future<Result<ClientInferRpcResponseOutput<TContract, TName>, 
+   options): ResultAsync<ClientInferRpcResponseOutput<TContract, TName>, 
   | TechnicalError
   | MessageValidationError
   | RpcTimeoutError
-  | RpcCancelledError>>;
+  | RpcCancelledError>;
 ```
 
-Defined in: [packages/client/src/client.ts:429](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L429)
+Defined in: [packages/client/src/client.ts:404](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L404)
 
 Invoke an RPC defined via `defineRpc` and await the typed response.
 
 The request payload is validated against the RPC's request schema, then
 published to the AMQP default exchange with the server's queue name as
 routing key, `replyTo` set to `amq.rabbitmq.reply-to`, and a fresh UUID
-`correlationId`. The returned Future resolves once a matching reply
+`correlationId`. The returned ResultAsync resolves once a matching reply
 arrives and validates against the response schema, or once `timeoutMs`
 elapses (whichever comes first).
 
 ###### Type Parameters
 
-| Type Parameter | Description |
-| ------ | ------ |
-| `TName` *extends* `string` \| `number` \| `symbol` | An RPC name from `contract.rpcs`. |
+| Type Parameter |
+| ------ |
+| `TName` *extends* `string` \| `number` \| `symbol` |
 
 ###### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `rpcName` | `TName` | The RPC name from the contract. |
-| `request` | [`ClientInferRpcRequestInput`](#clientinferrpcrequestinput)&lt;`TContract`, `TName`&gt; | The request payload, validated against the request schema. |
-| `options` | [`CallOptions`](#calloptions) | Per-call options. `timeoutMs` is required. |
+| Parameter | Type |
+| ------ | ------ |
+| `rpcName` | `TName` |
+| `request` | [`ClientInferRpcRequestInput`](#clientinferrpcrequestinput)&lt;`TContract`, `TName`&gt; |
+| `options` | [`CallOptions`](#calloptions) |
 
 ###### Returns
 
-`Future`&lt;`Result`&lt;[`ClientInferRpcResponseOutput`](#clientinferrpcresponseoutput)&lt;`TContract`, `TName`&gt;, 
+`ResultAsync`&lt;[`ClientInferRpcResponseOutput`](#clientinferrpcresponseoutput)&lt;`TContract`, `TName`&gt;, 
   \| `TechnicalError`
   \| [`MessageValidationError`](#messagevalidationerror)
   \| [`RpcTimeoutError`](#rpctimeouterror)
-  \| [`RpcCancelledError`](#rpccancellederror)&gt;&gt;
-
-`Result.Ok(response)` on a successful round-trip; `Result.Error`
-  on validation, transport, timeout, or cancel.
+  \| [`RpcCancelledError`](#rpccancellederror)&gt;
 
 ###### Example
 
 ```typescript
-const result = await client
-  .call('calculate', { a: 1, b: 2 }, { timeoutMs: 5_000 })
-  .toPromise();
+const result = await client.call('calculate', { a: 1, b: 2 }, { timeoutMs: 5_000 });
 if (result.isOk()) console.log(result.value.sum); // 3
 ```
 
 ##### close()
 
 ```ts
-close(): Future<Result<void, TechnicalError>>;
+close(): ResultAsync<void, TechnicalError>;
 ```
 
-Defined in: [packages/client/src/client.ts:581](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L581)
+Defined in: [packages/client/src/client.ts:554](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L554)
 
 Close the channel and connection. Cancels the reply consumer (if any) and
 rejects every in-flight RPC call with `RpcCancelledError`.
 
 ###### Returns
 
-`Future`&lt;`Result`&lt;`void`, `TechnicalError`&gt;&gt;
+`ResultAsync`&lt;`void`, `TechnicalError`&gt;
 
 ##### publish()
 
@@ -568,13 +563,12 @@ rejects every in-flight RPC call with `RpcCancelledError`.
 publish<TName>(
    publisherName, 
    message, 
-   options?): Future<Result<void, TechnicalError | MessageValidationError>>;
+   options?): ResultAsync<void, TechnicalError | MessageValidationError>;
 ```
 
-Defined in: [packages/client/src/client.ts:309](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L309)
+Defined in: [packages/client/src/client.ts:296](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L296)
 
 Publish a message using a defined publisher.
-TypeScript guarantees publisher exists for valid publisher names.
 
 ###### Type Parameters
 
@@ -584,23 +578,29 @@ TypeScript guarantees publisher exists for valid publisher names.
 
 ###### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `publisherName` | `TName` |
-| `message` | [`ClientInferPublisherInput`](#clientinferpublisherinput)&lt;`TContract`, `TName`&gt; |
-| `options?` | [`PublishOptions`](#publishoptions-1) |
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `publisherName` | `TName` | The name of the publisher to use |
+| `message` | [`ClientInferPublisherInput`](#clientinferpublisherinput)&lt;`TContract`, `TName`&gt; | The message to publish |
+| `options?` | [`PublishOptions`](#publishoptions-1) | Optional publish options including compression, headers, priority, etc. |
 
 ###### Returns
 
-`Future`&lt;`Result`&lt;`void`, `TechnicalError` \| [`MessageValidationError`](#messagevalidationerror)&gt;&gt;
+`ResultAsync`&lt;`void`, `TechnicalError` \| [`MessageValidationError`](#messagevalidationerror)&gt;
+
+###### Remarks
+
+If `options.compression` is specified, the message will be compressed before publishing
+and the `contentEncoding` property will be set automatically. Any `contentEncoding`
+value already in options will be overwritten by the compression algorithm.
 
 ##### create()
 
 ```ts
-static create<TContract>(__namedParameters): Future<Result<TypedAmqpClient<TContract>, TechnicalError>>;
+static create<TContract>(__namedParameters): ResultAsync<TypedAmqpClient<TContract>, TechnicalError>;
 ```
 
-Defined in: [packages/client/src/client.ts:155](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L155)
+Defined in: [packages/client/src/client.ts:155](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L155)
 
 Create a type-safe AMQP client from a contract.
 
@@ -625,7 +625,7 @@ connection options, following RabbitMQ best practices.
 
 ###### Returns
 
-`Future`&lt;`Result`&lt;[`TypedAmqpClient`](#typedamqpclient)&lt;`TContract`&gt;, `TechnicalError`&gt;&gt;
+`ResultAsync`&lt;[`TypedAmqpClient`](#typedamqpclient)&lt;`TContract`&gt;, `TechnicalError`&gt;
 
 ## Type Aliases
 
@@ -635,7 +635,7 @@ connection options, following RabbitMQ best practices.
 type CallOptions = object;
 ```
 
-Defined in: [packages/client/src/client.ts:104](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L104)
+Defined in: [packages/client/src/client.ts:104](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L104)
 
 Per-call options for `client.call()`.
 
@@ -643,8 +643,8 @@ Per-call options for `client.call()`.
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="publishoptions"></a> `publishOptions?` | `Omit`&lt;`AmqpClientPublishOptions`, `"replyTo"` \| `"correlationId"`&gt; | Optional AMQP message properties to merge into the request. `replyTo` and `correlationId` are managed by the client and cannot be overridden. | [packages/client/src/client.ts:118](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L118) |
-| <a id="timeoutms-1"></a> `timeoutMs` | `number` | Maximum time in ms to wait for an RPC reply. If exceeded, the call resolves to `Result.Error<RpcTimeoutError>` and the in-memory correlation entry is cleared. A late reply arriving after the timeout is silently dropped. Required: RPC without a timeout is a footgun. | [packages/client/src/client.ts:112](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L112) |
+| <a id="publishoptions"></a> `publishOptions?` | `Omit`&lt;`AmqpClientPublishOptions`, `"replyTo"` \| `"correlationId"`&gt; | Optional AMQP message properties to merge into the request. `replyTo` and `correlationId` are managed by the client and cannot be overridden. | [packages/client/src/client.ts:118](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L118) |
+| <a id="timeoutms-1"></a> `timeoutMs` | `number` | Maximum time in ms to wait for an RPC reply. If exceeded, the call resolves to `err(RpcTimeoutError)` and the in-memory correlation entry is cleared. A late reply arriving after the timeout is silently dropped. Required: RPC without a timeout is a footgun. | [packages/client/src/client.ts:112](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L112) |
 
 ***
 
@@ -654,7 +654,7 @@ Per-call options for `client.call()`.
 type ClientInferPublisherInput<TContract, TName> = PublisherInferInput<InferPublisher<TContract, TName>>;
 ```
 
-Defined in: [packages/client/src/types.ts:43](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/types.ts#L43)
+Defined in: [packages/client/src/types.ts:43](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/types.ts#L43)
 
 Input type accepted by `client.publish(name, ...)` for a specific publisher.
 
@@ -673,7 +673,7 @@ Input type accepted by `client.publish(name, ...)` for a specific publisher.
 type ClientInferRpcRequestInput<TContract, TName> = InferRpc<TContract, TName> extends RpcDefinition<infer TRequest, MessageDefinition> ? TRequest extends MessageDefinition ? InferSchemaInput<TRequest["payload"]> : never : never;
 ```
 
-Defined in: [packages/client/src/types.ts:61](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/types.ts#L61)
+Defined in: [packages/client/src/types.ts:61](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/types.ts#L61)
 
 Input type accepted by `client.call(name, request, ...)`.
 
@@ -692,7 +692,7 @@ Input type accepted by `client.call(name, request, ...)`.
 type ClientInferRpcResponseOutput<TContract, TName> = InferRpc<TContract, TName> extends RpcDefinition<MessageDefinition, infer TResponse> ? TResponse extends MessageDefinition ? InferSchemaOutput<TResponse["payload"]> : never : never;
 ```
 
-Defined in: [packages/client/src/types.ts:74](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/types.ts#L74)
+Defined in: [packages/client/src/types.ts:74](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/types.ts#L74)
 
 Output (validated) response type returned by `client.call(name, ...)`.
 
@@ -711,7 +711,7 @@ Output (validated) response type returned by `client.call(name, ...)`.
 type CreateClientOptions<TContract> = object;
 ```
 
-Defined in: [packages/client/src/client.ts:75](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L75)
+Defined in: [packages/client/src/client.ts:75](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L75)
 
 Options for creating a client
 
@@ -725,13 +725,13 @@ Options for creating a client
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | - | [packages/client/src/client.ts:78](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L78) |
-| <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/client/src/client.ts:98](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L98) |
-| <a id="contract"></a> `contract` | `TContract` | - | [packages/client/src/client.ts:76](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L76) |
-| <a id="defaultpublishoptions"></a> `defaultPublishOptions?` | [`PublishOptions`](#publishoptions-1) | Default publish options that will be applied to all publish operations. These can be overridden by options passed to the publish method. By default, persistent is set to true for message durability. | [packages/client/src/client.ts:91](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L91) |
-| <a id="logger"></a> `logger?` | `Logger` | - | [packages/client/src/client.ts:79](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L79) |
-| <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/client/src/client.ts:85](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L85) |
-| <a id="urls"></a> `urls` | `ConnectionUrl`[] | - | [packages/client/src/client.ts:77](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L77) |
+| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | - | [packages/client/src/client.ts:78](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L78) |
+| <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/client/src/client.ts:98](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L98) |
+| <a id="contract"></a> `contract` | `TContract` | - | [packages/client/src/client.ts:76](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L76) |
+| <a id="defaultpublishoptions"></a> `defaultPublishOptions?` | [`PublishOptions`](#publishoptions-1) | Default publish options that will be applied to all publish operations. These can be overridden by options passed to the publish method. By default, persistent is set to true for message durability. | [packages/client/src/client.ts:91](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L91) |
+| <a id="logger"></a> `logger?` | `Logger` | - | [packages/client/src/client.ts:79](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L79) |
+| <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/client/src/client.ts:85](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L85) |
+| <a id="urls"></a> `urls` | `ConnectionUrl`[] | - | [packages/client/src/client.ts:77](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L77) |
 
 ***
 
@@ -741,7 +741,7 @@ Options for creating a client
 type PublishOptions = AmqpClientPublishOptions & object;
 ```
 
-Defined in: [packages/client/src/client.ts:63](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L63)
+Defined in: [packages/client/src/client.ts:63](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L63)
 
 Publish options that extend amqp-client's PublishOptions with optional compression support.
 
@@ -749,4 +749,4 @@ Publish options that extend amqp-client's PublishOptions with optional compressi
 
 | Name | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| `compression?` | `CompressionAlgorithm` | Optional compression algorithm to use for the message payload. When specified, the message will be compressed using the chosen algorithm and the contentEncoding header will be set automatically. | [packages/client/src/client.ts:69](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L69) |
+| `compression?` | `CompressionAlgorithm` | Optional compression algorithm to use for the message payload. When specified, the message will be compressed using the chosen algorithm and the contentEncoding header will be set automatically. | [packages/client/src/client.ts:69](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/client/src/client.ts#L69) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amqp-contract/client",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Client utilities for publishing messages using amqp-contract",
   "keywords": [
     "amqp",
@@ -51,26 +51,26 @@
   },
   "dependencies": {
     "@standard-schema/spec": "1.1.0",
-    "@swan-io/boxed": "3.2.1",
+    "neverthrow": "8.2.0",
     "ts-pattern": "5.9.0",
-    "@amqp-contract/contract": "0.23.0",
-    "@amqp-contract/core": "0.23.0"
+    "@amqp-contract/contract": "0.24.0",
+    "@amqp-contract/core": "0.24.0"
   },
   "devDependencies": {
     "@types/amqplib": "0.10.8",
     "@types/node": "24.12.2",
     "@vitest/coverage-v8": "4.1.5",
     "amqp-connection-manager": "5.0.0",
-    "amqplib": "1.0.3",
+    "amqplib": "0.10.9",
     "tsdown": "0.21.10",
     "typedoc": "0.28.19",
     "typedoc-plugin-markdown": "4.11.0",
     "typescript": "6.0.3",
     "vitest": "4.1.5",
-    "zod": "4.3.6",
-    "@amqp-contract/testing": "0.23.0",
-    "@amqp-contract/tsconfig": "0.1.0",
-    "@amqp-contract/typedoc": "0.1.0"
+    "zod": "4.4.3",
+    "@amqp-contract/testing": "0.24.0",
+    "@amqp-contract/typedoc": "0.1.0",
+    "@amqp-contract/tsconfig": "0.1.0"
   },
   "scripts": {
     "build": "tsdown src/index.ts --format cjs,esm --dts --clean",