@amqp-contract/client 0.21.0 → 0.23.0

package/docs/index.md

@@ -168,9 +168,316 @@ 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)
+
+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)`.
+
+#### Extends
+
+- `Error`
+
+#### Constructors
+
+##### Constructor
+
+```ts
+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)
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `rpcName` | `string` |
+
+###### Returns
+
+[`RpcCancelledError`](#rpccancellederror)
+
+###### Overrides
+
+```ts
+Error.constructor
+```
+
+#### Properties
+
+| Property | Modifier | Type | Description | Inherited from | Defined in |
+| ------ | ------ | ------ | ------ | ------ | ------ |
+| <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="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 |
+
+#### Methods
+
+##### captureStackTrace()
+
+```ts
+static captureStackTrace(targetObject, constructorOpt?): void;
+```
+
+Defined in: node\_modules/.pnpm/@types+node@24.12.2/node\_modules/@types/node/globals.d.ts:52
+
+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
+Error.captureStackTrace
+```
+
+##### prepareStackTrace()
+
+```ts
+static prepareStackTrace(err, stackTraces): any;
+```
+
+Defined in: node\_modules/.pnpm/@types+node@24.12.2/node\_modules/@types/node/globals.d.ts:56
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `err` | `Error` |
+| `stackTraces` | `CallSite`[] |
+
+###### Returns
+
+`any`
+
+###### See
+
+https://v8.dev/docs/stack-trace-api#customizing-stack-traces
+
+###### Inherited from
+
+```ts
+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)
+
+Returned from `TypedAmqpClient.call()` when the configured `timeoutMs` elapses
+before the RPC server publishes a reply with the matching `correlationId`.
+
+The pending call is removed from the in-memory correlation map; if a reply
+arrives after the timeout it is dropped (and a debug log is emitted by the
+client if a logger is configured).
+
+#### Extends
+
+- `Error`
+
+#### Constructors
+
+##### Constructor
+
+```ts
+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)
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `rpcName` | `string` |
+| `timeoutMs` | `number` |
+
+###### Returns
+
+[`RpcTimeoutError`](#rpctimeouterror)
+
+###### Overrides
+
+```ts
+Error.constructor
+```
+
+#### Properties
+
+| Property | Modifier | Type | Description | Inherited from | Defined in |
+| ------ | ------ | ------ | ------ | ------ | ------ |
+| <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="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="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
+
+##### captureStackTrace()
+
+```ts
+static captureStackTrace(targetObject, constructorOpt?): void;
+```
+
+Defined in: node\_modules/.pnpm/@types+node@24.12.2/node\_modules/@types/node/globals.d.ts:52
+
+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
+Error.captureStackTrace
+```
+
+##### prepareStackTrace()
+
+```ts
+static prepareStackTrace(err, stackTraces): any;
+```
+
+Defined in: node\_modules/.pnpm/@types+node@24.12.2/node\_modules/@types/node/globals.d.ts:56
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `err` | `Error` |
+| `stackTraces` | `CallSite`[] |
+
+###### Returns
+
+`any`
+
+###### See
+
+https://v8.dev/docs/stack-trace-api#customizing-stack-traces
+
+###### Inherited from
+
+```ts
+Error.prepareStackTrace
+```
+
+***
+
 ### TypedAmqpClient
 
-Defined in: [packages/client/src/client.ts:62](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L62)
+Defined in: [packages/client/src/client.ts:124](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L124)
 
 Type-safe AMQP client for publishing messages
 
@@ -182,15 +489,74 @@ Type-safe AMQP client for publishing messages
 
 #### Methods
 
+##### call()
+
+```ts
+call<TName>(
+   rpcName, 
+   request, 
+   options): Future<Result<ClientInferRpcResponseOutput<TContract, TName>, 
+  | TechnicalError
+  | MessageValidationError
+  | RpcTimeoutError
+  | RpcCancelledError>>;
+```
+
+Defined in: [packages/client/src/client.ts:429](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L429)
+
+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
+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`. |
+
+###### 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. |
+
+###### Returns
+
+`Future`&lt;`Result`&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.
+
+###### Example
+
+```typescript
+const result = await client
+  .call('calculate', { a: 1, b: 2 }, { timeoutMs: 5_000 })
+  .toPromise();
+if (result.isOk()) console.log(result.value.sum); // 3
+```
+
 ##### close()
 
 ```ts
 close(): Future<Result<void, TechnicalError>>;
 ```
 
-Defined in: [packages/client/src/client.ts:215](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L215)
+Defined in: [packages/client/src/client.ts:581](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L581)
 
-Close the channel and connection
+Close the channel and connection. Cancels the reply consumer (if any) and
+rejects every in-flight RPC call with `RpcCancelledError`.
 
 ###### Returns
 
@@ -205,7 +571,7 @@ publish<TName>(
    options?): Future<Result<void, TechnicalError | MessageValidationError>>;
 ```
 
-Defined in: [packages/client/src/client.ts:118](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L118)
+Defined in: [packages/client/src/client.ts:309](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L309)
 
 Publish a message using a defined publisher.
 TypeScript guarantees publisher exists for valid publisher names.
@@ -222,7 +588,7 @@ TypeScript guarantees publisher exists for valid publisher names.
 | ------ | ------ |
 | `publisherName` | `TName` |
 | `message` | [`ClientInferPublisherInput`](#clientinferpublisherinput)&lt;`TContract`, `TName`&gt; |
-| `options?` | [`PublishOptions`](#publishoptions) |
+| `options?` | [`PublishOptions`](#publishoptions-1) |
 
 ###### Returns
 
@@ -234,7 +600,7 @@ TypeScript guarantees publisher exists for valid publisher names.
 static create<TContract>(__namedParameters): Future<Result<TypedAmqpClient<TContract>, TechnicalError>>;
 ```
 
-Defined in: [packages/client/src/client.ts:81](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L81)
+Defined in: [packages/client/src/client.ts:155](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L155)
 
 Create a type-safe AMQP client from a contract.
 
@@ -263,15 +629,34 @@ connection options, following RabbitMQ best practices.
 
 ## Type Aliases
 
+### CallOptions
+
+```ts
+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)
+
+Per-call options for `client.call()`.
+
+#### Properties
+
+| 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) |
+
+***
+
 ### ClientInferPublisherInput
 
 ```ts
 type ClientInferPublisherInput<TContract, TName> = PublisherInferInput<InferPublisher<TContract, TName>>;
 ```
 
-Defined in: [packages/client/src/types.ts:41](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/types.ts#L41)
+Defined in: [packages/client/src/types.ts:43](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/types.ts#L43)
 
-Infer publisher input type (message payload) for a specific publisher in a contract
+Input type accepted by `client.publish(name, ...)` for a specific publisher.
 
 #### Type Parameters
 
@@ -282,13 +667,51 @@ Infer publisher input type (message payload) for a specific publisher in a contr
 
 ***
 
+### ClientInferRpcRequestInput
+
+```ts
+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)
+
+Input type accepted by `client.call(name, request, ...)`.
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TContract` *extends* `ContractDefinition` |
+| `TName` *extends* `InferRpcNames`&lt;`TContract`&gt; |
+
+***
+
+### ClientInferRpcResponseOutput
+
+```ts
+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)
+
+Output (validated) response type returned by `client.call(name, ...)`.
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TContract` *extends* `ContractDefinition` |
+| `TName` *extends* `InferRpcNames`&lt;`TContract`&gt; |
+
+***
+
 ### CreateClientOptions
 
 ```ts
 type CreateClientOptions<TContract> = object;
 ```
 
-Defined in: [packages/client/src/client.ts:40](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L40)
+Defined in: [packages/client/src/client.ts:75](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L75)
 
 Options for creating a client
 
@@ -302,12 +725,13 @@ Options for creating a client
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | - | [packages/client/src/client.ts:43](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L43) |
-| <a id="contract"></a> `contract` | `TContract` | - | [packages/client/src/client.ts:41](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L41) |
-| <a id="defaultpublishoptions"></a> `defaultPublishOptions?` | [`PublishOptions`](#publishoptions) | 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:56](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L56) |
-| <a id="logger"></a> `logger?` | `Logger` | - | [packages/client/src/client.ts:44](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L44) |
-| <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:50](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L50) |
-| <a id="urls"></a> `urls` | `ConnectionUrl`[] | - | [packages/client/src/client.ts:42](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L42) |
+| <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) |
 
 ***
 
@@ -317,7 +741,7 @@ Options for creating a client
 type PublishOptions = AmqpClientPublishOptions & object;
 ```
 
-Defined in: [packages/client/src/client.ts:28](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L28)
+Defined in: [packages/client/src/client.ts:63](https://github.com/btravers/amqp-contract/blob/cb947e699b512bf57d7ddfcc5ae6e2531e8dfa43/packages/client/src/client.ts#L63)
 
 Publish options that extend amqp-client's PublishOptions with optional compression support.
 
@@ -325,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:34](https://github.com/btravers/amqp-contract/blob/c4431c816689353f677718608623c58fd1757388/packages/client/src/client.ts#L34) |
+| `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) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amqp-contract/client",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "Client utilities for publishing messages using amqp-contract",
   "keywords": [
     "amqp",
@@ -53,8 +53,8 @@
     "@standard-schema/spec": "1.1.0",
     "@swan-io/boxed": "3.2.1",
     "ts-pattern": "5.9.0",
-    "@amqp-contract/contract": "0.21.0",
-    "@amqp-contract/core": "0.21.0"
+    "@amqp-contract/contract": "0.23.0",
+    "@amqp-contract/core": "0.23.0"
   },
   "devDependencies": {
     "@types/amqplib": "0.10.8",
@@ -62,13 +62,13 @@
     "@vitest/coverage-v8": "4.1.5",
     "amqp-connection-manager": "5.0.0",
     "amqplib": "1.0.3",
-    "tsdown": "0.21.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.21.0",
+    "@amqp-contract/testing": "0.23.0",
     "@amqp-contract/tsconfig": "0.1.0",
     "@amqp-contract/typedoc": "0.1.0"
   },