@amqp-contract/core 0.24.0 → 1.0.0

package/docs/index.md

@@ -8,7 +8,7 @@
 
 ### AmqpClient
 
-Defined in: [packages/core/src/amqp-client.ts:129](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L129)
+Defined in: [packages/core/src/amqp-client.ts:141](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L141)
 
 AMQP client that manages connections and channels with automatic topology setup.
 
@@ -18,7 +18,7 @@ This class handles:
 - Automatic AMQP topology setup (exchanges, queues, bindings) from contract
 - Channel creation with JSON serialization enabled by default
 
-All operations return `ResultAsync<T, TechnicalError>` for consistent error handling.
+All operations return `AsyncResult<T, TechnicalError>` for consistent error handling.
 
 #### Example
 
@@ -28,7 +28,7 @@ const client = new AmqpClient(contract, {
   connectionOptions: { heartbeatIntervalInSeconds: 30 }
 });
 
-// Wait for connection (ResultAsync is thenable)
+// Wait for connection (AsyncResult is thenable)
 await client.waitForConnect();
 
 // Publish a message
@@ -46,7 +46,7 @@ await client.close();
 new AmqpClient(contract, options): AmqpClient;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:148](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L148)
+Defined in: [packages/core/src/amqp-client.ts:169](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L169)
 
 Create a new AMQP client instance.
 
@@ -74,7 +74,7 @@ The client will automatically:
 ack(msg, allUpTo?): void;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:315](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L315)
+Defined in: [packages/core/src/amqp-client.ts:426](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L426)
 
 Acknowledge a message.
 
@@ -95,7 +95,7 @@ Acknowledge a message.
 addSetup(setup): void;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:337](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L337)
+Defined in: [packages/core/src/amqp-client.ts:448](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L448)
 
 Add a setup function to be called when the channel is created or reconnected.
 
@@ -114,10 +114,10 @@ This is useful for setting up channel-level configuration like prefetch.
 ##### cancel()
 
 ```ts
-cancel(consumerTag): ResultAsync<void, TechnicalError>;
+cancel(consumerTag): AsyncResult<void, TechnicalError>;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:302](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L302)
+Defined in: [packages/core/src/amqp-client.ts:395](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L395)
 
 Cancel a consumer by its consumer tag.
 
@@ -129,15 +129,15 @@ Cancel a consumer by its consumer tag.
 
 ###### Returns
 
-`ResultAsync`&lt;`void`, [`TechnicalError`](#technicalerror)&gt;
+`AsyncResult`&lt;`void`, [`TechnicalError`](#technicalerror)&gt;
 
 ##### close()
 
 ```ts
-close(): ResultAsync<void, TechnicalError>;
+close(): AsyncResult<void, TechnicalError>;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:367](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L367)
+Defined in: [packages/core/src/amqp-client.ts:478](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L478)
 
 Close the channel and release the connection reference.
 
@@ -151,7 +151,7 @@ errors are wrapped in an AggregateError.
 
 ###### Returns
 
-`ResultAsync`&lt;`void`, [`TechnicalError`](#technicalerror)&gt;
+`AsyncResult`&lt;`void`, [`TechnicalError`](#technicalerror)&gt;
 
 ##### consume()
 
@@ -159,13 +159,25 @@ errors are wrapped in an AggregateError.
 consume(
    queue, 
    callback, 
-   options?): ResultAsync<string, TechnicalError>;
+   options?): AsyncResult<string, TechnicalError>;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:288](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L288)
+Defined in: [packages/core/src/amqp-client.ts:321](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L321)
 
 Start consuming messages from a queue.
 
+If `options.prefetch` is set, a per-consumer prefetch count is applied via
+`channel.prefetch(count, false)` registered as a setup function on the
+channel wrapper *before* the underlying `consume` call. Registering it via
+`addSetup` ensures the prefetch is reapplied automatically on channel
+reconnect; using `global=false` scopes it to subsequent consumers on the
+channel (RabbitMQ semantics — opposite of intuition: `false` is per-
+consumer, `true` is channel-wide).
+
+`prefetch` is stripped from the options handed to `channelWrapper.consume`
+because it is not a valid `amqplib` `Options.Consume` field — leaving it
+in would just travel as a no-op key-value pair on the consume frame.
+
 ###### Parameters
 
 | Parameter | Type |
@@ -176,9 +188,9 @@ Start consuming messages from a queue.
 
 ###### Returns
 
-`ResultAsync`&lt;`string`, [`TechnicalError`](#technicalerror)&gt;
+`AsyncResult`&lt;`string`, [`TechnicalError`](#technicalerror)&gt;
 
-ResultAsync resolving to the consumer tag.
+AsyncResult resolving to the consumer tag.
 
 ##### getConnection()
 
@@ -186,7 +198,7 @@ ResultAsync resolving to the consumer tag.
 getConnection(): IAmqpConnectionManager;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:203](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L203)
+Defined in: [packages/core/src/amqp-client.ts:224](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L224)
 
 Get the underlying connection manager
 
@@ -209,7 +221,7 @@ nack(
    requeue?): void;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:326](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L326)
+Defined in: [packages/core/src/amqp-client.ts:437](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L437)
 
 Negative acknowledge a message.
 
@@ -231,7 +243,7 @@ Negative acknowledge a message.
 on(event, listener): void;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:352](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L352)
+Defined in: [packages/core/src/amqp-client.ts:463](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L463)
 
 Register an event listener on the channel wrapper.
 
@@ -258,10 +270,10 @@ publish(
    exchange, 
    routingKey, 
    content, 
-   options?): ResultAsync<boolean, TechnicalError>;
+   options?): AsyncResult<boolean, TechnicalError>;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:255](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L255)
+Defined in: [packages/core/src/amqp-client.ts:276](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L276)
 
 Publish a message to an exchange.
 
@@ -272,13 +284,13 @@ Publish a message to an exchange.
 | `exchange` | `string` |
 | `routingKey` | `string` |
 | `content` | `unknown` |
-| `options?` | [`PublishOptions`](#publishoptions) |
+| `options?` | `Publish` |
 
 ###### Returns
 
-`ResultAsync`&lt;`boolean`, [`TechnicalError`](#technicalerror)&gt;
+`AsyncResult`&lt;`boolean`, [`TechnicalError`](#technicalerror)&gt;
 
-ResultAsync resolving to `true` if the message was sent, `false` if the channel buffer is full.
+AsyncResult resolving to `true` if the message was sent, `false` if the channel buffer is full.
 
 ##### sendToQueue()
 
@@ -286,10 +298,10 @@ ResultAsync resolving to `true` if the message was sent, `false` if the channel
 sendToQueue(
    queue, 
    content, 
-   options?): ResultAsync<boolean, TechnicalError>;
+   options?): AsyncResult<boolean, TechnicalError>;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:272](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L272)
+Defined in: [packages/core/src/amqp-client.ts:293](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L293)
 
 Publish a message directly to a queue.
 
@@ -299,26 +311,26 @@ Publish a message directly to a queue.
 | ------ | ------ |
 | `queue` | `string` |
 | `content` | `unknown` |
-| `options?` | [`PublishOptions`](#publishoptions) |
+| `options?` | `Publish` |
 
 ###### Returns
 
-`ResultAsync`&lt;`boolean`, [`TechnicalError`](#technicalerror)&gt;
+`AsyncResult`&lt;`boolean`, [`TechnicalError`](#technicalerror)&gt;
 
-ResultAsync resolving to `true` if the message was sent, `false` if the channel buffer is full.
+AsyncResult resolving to `true` if the message was sent, `false` if the channel buffer is full.
 
 ##### waitForConnect()
 
 ```ts
-waitForConnect(): ResultAsync<void, TechnicalError>;
+waitForConnect(): AsyncResult<void, TechnicalError>;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:221](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L221)
+Defined in: [packages/core/src/amqp-client.ts:242](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L242)
 
 Wait for the channel to be connected and ready.
 
 If `connectTimeoutMs` was provided in the constructor options, the returned
-ResultAsync resolves to `err(TechnicalError)` once the timeout elapses.
+AsyncResult resolves to `err(TechnicalError)` once the timeout elapses.
 Without a timeout, this waits forever — amqp-connection-manager retries
 connections indefinitely and never errors on its own.
 
@@ -330,30 +342,40 @@ automatically. The typed factories handle this cleanup for you.
 
 ###### Returns
 
-`ResultAsync`&lt;`void`, [`TechnicalError`](#technicalerror)&gt;
+`AsyncResult`&lt;`void`, [`TechnicalError`](#technicalerror)&gt;
 
 ***
 
 ### MessageValidationError
 
-Defined in: [packages/core/src/errors.ts:33](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/errors.ts#L33)
+Defined in: [packages/core/src/errors.ts:38](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/errors.ts#L38)
 
 Error thrown when message validation fails (payload or headers).
 
 Used by both the client (publish-time payload validation) and the worker
-(consume-time payload and headers validation).
+(consume-time payload and headers validation). Carries a `_tag` of
+`"@amqp-contract/MessageValidationError"` (namespaced to avoid collisions);
+the `Error.name` is kept bare (`"MessageValidationError"`).
 
 #### Param
 
+**source**
+
 The name of the publisher or consumer that triggered the validation
 
 #### Param
 
+**issues**
+
 The validation issues from the Standard Schema validation
 
 #### Extends
 
-- `Error`
+- `TaggedErrorInstance`&lt;`"@amqp-contract/MessageValidationError"`, \{
+  `issues`: `unknown`;
+  `message`: `string`;
+  `source`: `string`;
+\}&gt;
 
 #### Constructors
 
@@ -363,7 +385,7 @@ The validation issues from the Standard Schema validation
 new MessageValidationError(source, issues): MessageValidationError;
 ```
 
-Defined in: [packages/core/src/errors.ts:34](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/errors.ts#L34)
+Defined in: [packages/core/src/errors.ts:45](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/errors.ts#L45)
 
 ###### Parameters
 
@@ -379,237 +401,51 @@ Defined in: [packages/core/src/errors.ts:34](https://github.com/btravers/amqp-co
 ###### Overrides
 
 ```ts
-Error.constructor
+TaggedError("@amqp-contract/MessageValidationError", {
+  name: "MessageValidationError",
+})<{
+  message: string;
+  source: string;
+  issues: unknown;
+}>.constructor
 ```
 
 #### Properties
 
-| Property | Modifier | Type | Description | Inherited from | Defined in |
-| ------ | ------ | ------ | ------ | ------ | ------ |
-| <a id="cause"></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="issues"></a> `issues` | `readonly` | `unknown` | - | - | [packages/core/src/errors.ts:36](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/errors.ts#L36) |
-| <a id="message"></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"></a> `name` | `public` | `string` | - | `Error.name` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1074 |
-| <a id="source"></a> `source` | `readonly` | `string` | - | - | [packages/core/src/errors.ts:35](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/errors.ts#L35) |
-| <a id="stack"></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"></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.6.0/node\_modules/@types/node/globals.d.ts:67 |
-
-#### Methods
-
-##### captureStackTrace()
-
-###### Call Signature
-
-```ts
-static captureStackTrace(targetObject, constructorOpt?): void;
-```
-
-Defined in: node\_modules/.pnpm/@types+node@25.6.0/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
-Error.captureStackTrace
-```
-
-###### Call Signature
-
-```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()
-
-###### Call Signature
-
-```ts
-static prepareStackTrace(err, stackTraces): any;
-```
-
-Defined in: node\_modules/.pnpm/@types+node@25.6.0/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
-Error.prepareStackTrace
-```
-
-###### Call Signature
-
-```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
-```
+| Property | Modifier | Type | Inherited from | Defined in |
+| ------ | ------ | ------ | ------ | ------ |
+| <a id="_tag"></a> `_tag` | `readonly` | `"@amqp-contract/MessageValidationError"` | `TaggedError("@amqp-contract/MessageValidationError", { name: "MessageValidationError", })._tag` | node\_modules/.pnpm/unthrown@0.2.0/node\_modules/unthrown/dist/index.d.mts:638 |
+| <a id="cause"></a> `cause?` | `public` | `unknown` | `TaggedError("@amqp-contract/MessageValidationError", { name: "MessageValidationError", }).cause` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es2022.error.d.ts:24 |
+| <a id="issues"></a> `issues` | `readonly` | `unknown` | `TaggedError("@amqp-contract/MessageValidationError", { name: "MessageValidationError", }).issues` | [packages/core/src/errors.ts:43](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/errors.ts#L43) |
+| <a id="message"></a> `message` | `public` | `string` | `TaggedError("@amqp-contract/MessageValidationError", { name: "MessageValidationError", }).message` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1075 |
+| <a id="name"></a> `name` | `public` | `string` | `TaggedError("@amqp-contract/MessageValidationError", { name: "MessageValidationError", }).name` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1074 |
+| <a id="source"></a> `source` | `readonly` | `string` | `TaggedError("@amqp-contract/MessageValidationError", { name: "MessageValidationError", }).source` | [packages/core/src/errors.ts:42](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/errors.ts#L42) |
+| <a id="stack"></a> `stack?` | `public` | `string` | `TaggedError("@amqp-contract/MessageValidationError", { name: "MessageValidationError", }).stack` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
 
 ***
 
 ### TechnicalError
 
-Defined in: [packages/core/src/errors.ts:7](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/errors.ts#L7)
+Defined in: [packages/core/src/errors.ts:16](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/errors.ts#L16)
 
 Error for technical/runtime failures that cannot be prevented by TypeScript.
 
 This includes AMQP connection failures, channel issues, validation failures,
 and other runtime errors. This error is shared across core, worker, and client packages.
 
+Built on unthrown's [TaggedError](https://github.com/btravstack/unthrown), so it carries a `_tag` of
+`"@amqp-contract/TechnicalError"` for exhaustive dispatch via `matchTags`. The
+tag is namespaced to avoid colliding with other libraries' tags in a shared
+`matchTags`; the human-facing `Error.name` is kept bare (`"TechnicalError"`).
+Remains a real `Error` (and a *modeled* error — it lives in the `E` channel of
+a `Result`, never the `Defect` channel).
+
 #### Extends
 
-- `Error`
+- `TaggedErrorInstance`&lt;`"@amqp-contract/TechnicalError"`, \{
+  `cause?`: `unknown`;
+  `message`: `string`;
+\}&gt;
 
 #### Constructors
 
@@ -619,7 +455,7 @@ and other runtime errors. This error is shared across core, worker, and client p
 new TechnicalError(message, cause?): TechnicalError;
 ```
 
-Defined in: [packages/core/src/errors.ts:8](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/errors.ts#L8)
+Defined in: [packages/core/src/errors.ts:22](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/errors.ts#L22)
 
 ###### Parameters
 
@@ -635,220 +471,23 @@ Defined in: [packages/core/src/errors.ts:8](https://github.com/btravers/amqp-con
 ###### Overrides
 
 ```ts
-Error.constructor
+TaggedError("@amqp-contract/TechnicalError", {
+  name: "TechnicalError",
+})<{
+  message: string;
+  cause?: unknown;
+}>.constructor
 ```
 
 #### Properties
 
-| Property | Modifier | Type | Description | Inherited from | Defined in |
-| ------ | ------ | ------ | ------ | ------ | ------ |
-| <a id="cause-1"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/core/src/errors.ts:10](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/errors.ts#L10) |
-| <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 |
-| <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.6.0/node\_modules/@types/node/globals.d.ts:67 |
-
-#### Methods
-
-##### captureStackTrace()
-
-###### Call Signature
-
-```ts
-static captureStackTrace(targetObject, constructorOpt?): void;
-```
-
-Defined in: node\_modules/.pnpm/@types+node@25.6.0/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
-Error.captureStackTrace
-```
-
-###### Call Signature
-
-```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()
-
-###### Call Signature
-
-```ts
-static prepareStackTrace(err, stackTraces): any;
-```
-
-Defined in: node\_modules/.pnpm/@types+node@25.6.0/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
-Error.prepareStackTrace
-```
-
-###### Call Signature
-
-```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
-```
+| Property | Modifier | Type | Inherited from | Defined in |
+| ------ | ------ | ------ | ------ | ------ |
+| <a id="_tag-1"></a> `_tag` | `readonly` | `"@amqp-contract/TechnicalError"` | `TaggedError("@amqp-contract/TechnicalError", { name: "TechnicalError", })._tag` | node\_modules/.pnpm/unthrown@0.2.0/node\_modules/unthrown/dist/index.d.mts:638 |
+| <a id="cause-1"></a> `cause?` | `public` | `unknown` | [`MessageValidationError`](#messagevalidationerror).[`cause`](#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` | `TaggedError("@amqp-contract/TechnicalError", { name: "TechnicalError", }).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` | `TaggedError("@amqp-contract/TechnicalError", { name: "TechnicalError", }).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` | `TaggedError("@amqp-contract/TechnicalError", { name: "TechnicalError", }).stack` | node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
 
 ## Type Aliases
 
@@ -858,7 +497,7 @@ Error.prepareStackTrace
 type AmqpClientOptions = object;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:73](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L73)
+Defined in: [packages/core/src/amqp-client.ts:73](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L73)
 
 Options for creating an AMQP client.
 
@@ -866,10 +505,10 @@ Options for creating an AMQP client.
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="channeloptions"></a> `channelOptions?` | `Partial`&lt;`CreateChannelOpts`&gt; | Optional channel configuration options. | [packages/core/src/amqp-client.ts:76](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L76) |
-| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.). | [packages/core/src/amqp-client.ts:75](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L75) |
-| <a id="connecttimeoutms"></a> `connectTimeoutMs?` | `number` \| `null` | Maximum time in ms to wait for the channel to become ready in `waitForConnect`. Defaults to [DEFAULT\_CONNECT\_TIMEOUT\_MS](#default_connect_timeout_ms). Pass `null` to disable the timeout entirely (amqp-connection-manager will retry indefinitely). | [packages/core/src/amqp-client.ts:77](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L77) |
-| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support. | [packages/core/src/amqp-client.ts:74](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L74) |
+| <a id="channeloptions"></a> `channelOptions?` | `Partial`&lt;`CreateChannelOpts`&gt; | Optional channel configuration options. | [packages/core/src/amqp-client.ts:76](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L76) |
+| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.). | [packages/core/src/amqp-client.ts:75](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L75) |
+| <a id="connecttimeoutms"></a> `connectTimeoutMs?` | `number` \| `null` | Maximum time in ms to wait for the channel to become ready in `waitForConnect`. Defaults to [DEFAULT\_CONNECT\_TIMEOUT\_MS](#default_connect_timeout_ms). Pass `null` to disable the timeout entirely (amqp-connection-manager will retry indefinitely). | [packages/core/src/amqp-client.ts:77](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L77) |
+| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support. | [packages/core/src/amqp-client.ts:74](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L74) |
 
 ***
 
@@ -879,7 +518,7 @@ Options for creating an AMQP client.
 type ConsumeCallback = (msg) => void | Promise<void>;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:83](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L83)
+Defined in: [packages/core/src/amqp-client.ts:83](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L83)
 
 Callback type for consuming messages.
 
@@ -901,15 +540,23 @@ Callback type for consuming messages.
 type ConsumerOptions = Options.Consume & object;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:96](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L96)
+Defined in: [packages/core/src/amqp-client.ts:108](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L108)
+
+Consume options that extend amqplib's `Options.Consume` with an optional
+per-consumer prefetch count.
 
-Consume options that extend amqplib's Options.Consume with optional prefetch support.
+`prefetch` is intercepted by [AmqpClient.consume](#consume): it is stripped from
+the options handed to the underlying `channelWrapper.consume(...)` call
+(since amqplib's `Options.Consume` does not include it) and applied via
+`channel.prefetch(count, false)` registered through `addSetup` *before* the
+consume so the value is in effect when the consumer starts and is reapplied
+automatically on channel reconnect.
 
 #### Type Declaration
 
 | Name | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| `prefetch?` | `number` | Number of messages to prefetch | [packages/core/src/amqp-client.ts:98](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L98) |
+| `prefetch?` | `number` | Per-consumer prefetch count. Applied before `channel.consume(...)`. | [packages/core/src/amqp-client.ts:110](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L110) |
 
 ***
 
@@ -919,7 +566,7 @@ Consume options that extend amqplib's Options.Consume with optional prefetch sup
 type Logger = object;
 ```
 
-Defined in: [packages/core/src/logger.ts:30](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/logger.ts#L30)
+Defined in: [packages/core/src/logger.ts:30](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/logger.ts#L30)
 
 Logger interface for amqp-contract packages.
 
@@ -946,7 +593,7 @@ const logger: Logger = {
 debug(message, context?): void;
 ```
 
-Defined in: [packages/core/src/logger.ts:36](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/logger.ts#L36)
+Defined in: [packages/core/src/logger.ts:36](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/logger.ts#L36)
 
 Log debug level messages
 
@@ -967,7 +614,7 @@ Log debug level messages
 error(message, context?): void;
 ```
 
-Defined in: [packages/core/src/logger.ts:57](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/logger.ts#L57)
+Defined in: [packages/core/src/logger.ts:57](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/logger.ts#L57)
 
 Log error level messages
 
@@ -988,7 +635,7 @@ Log error level messages
 info(message, context?): void;
 ```
 
-Defined in: [packages/core/src/logger.ts:43](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/logger.ts#L43)
+Defined in: [packages/core/src/logger.ts:43](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/logger.ts#L43)
 
 Log info level messages
 
@@ -1009,7 +656,7 @@ Log info level messages
 warn(message, context?): void;
 ```
 
-Defined in: [packages/core/src/logger.ts:50](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/logger.ts#L50)
+Defined in: [packages/core/src/logger.ts:50](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/logger.ts#L50)
 
 Log warning level messages
 
@@ -1032,7 +679,7 @@ Log warning level messages
 type LoggerContext = Record<string, unknown> & object;
 ```
 
-Defined in: [packages/core/src/logger.ts:9](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/logger.ts#L9)
+Defined in: [packages/core/src/logger.ts:9](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/logger.ts#L9)
 
 Context object for logger methods.
 
@@ -1043,25 +690,26 @@ for common logging context properties.
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `error?` | `unknown` | [packages/core/src/logger.ts:10](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/logger.ts#L10) |
+| `error?` | `unknown` | [packages/core/src/logger.ts:10](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/logger.ts#L10) |
 
 ***
 
 ### PublishOptions
 
 ```ts
-type PublishOptions = Options.Publish & object;
+type PublishOptions = Options.Publish;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:88](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L88)
+Defined in: [packages/core/src/amqp-client.ts:95](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L95)
 
-Publish options that extend amqplib's Options.Publish with optional timeout support.
+Publish options for `AmqpClient.publish` / `AmqpClient.sendToQueue`.
 
-#### Type Declaration
-
-| Name | Type | Description | Defined in |
-| ------ | ------ | ------ | ------ |
-| `timeout?` | `number` | Message will be rejected after timeout ms | [packages/core/src/amqp-client.ts:90](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L90) |
+Currently a re-export of amqplib's `Options.Publish`. A previous version of
+this type also exposed a `timeout` field, but that field never had a
+meaningful AMQP-level effect in this codebase and has been removed to avoid
+suggesting behaviour we do not provide. (`amqp-connection-manager`'s own
+`publishTimeout` channel option is unrelated and is configured at channel
+creation, not per-publish.)
 
 ***
 
@@ -1071,7 +719,7 @@ Publish options that extend amqplib's Options.Publish with optional timeout supp
 type TelemetryProvider = object;
 ```
 
-Defined in: [packages/core/src/telemetry.ts:54](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L54)
+Defined in: [packages/core/src/telemetry.ts:54](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L54)
 
 Telemetry provider for AMQP operations.
 Uses lazy loading to gracefully handle cases where OpenTelemetry is not installed.
@@ -1080,12 +728,12 @@ Uses lazy loading to gracefully handle cases where OpenTelemetry is not installe
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="getconsumecounter"></a> `getConsumeCounter` | () => `Counter` \| `undefined` | Get a counter for messages consumed. Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:71](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L71) |
-| <a id="getconsumelatencyhistogram"></a> `getConsumeLatencyHistogram` | () => `Histogram` \| `undefined` | Get a histogram for consume/process latency. Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:83](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L83) |
-| <a id="getlaterpcreplycounter"></a> `getLateRpcReplyCounter` | () => `Counter` \| `undefined` | Get a counter for RPC replies that arrive after the caller has gone away (timeout, cancellation, or unknown correlationId). Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:90](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L90) |
-| <a id="getpublishcounter"></a> `getPublishCounter` | () => `Counter` \| `undefined` | Get a counter for messages published. Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:65](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L65) |
-| <a id="getpublishlatencyhistogram"></a> `getPublishLatencyHistogram` | () => `Histogram` \| `undefined` | Get a histogram for publish latency. Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:77](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L77) |
-| <a id="gettracer"></a> `getTracer` | () => `Tracer` \| `undefined` | Get a tracer instance for creating spans. Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:59](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L59) |
+| <a id="getconsumecounter"></a> `getConsumeCounter` | () => `Counter` \| `undefined` | Get a counter for messages consumed. Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:71](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L71) |
+| <a id="getconsumelatencyhistogram"></a> `getConsumeLatencyHistogram` | () => `Histogram` \| `undefined` | Get a histogram for consume/process latency. Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:83](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L83) |
+| <a id="getlaterpcreplycounter"></a> `getLateRpcReplyCounter` | () => `Counter` \| `undefined` | Get a counter for RPC replies that arrive after the caller has gone away (timeout, cancellation, or unknown correlationId). Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:90](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L90) |
+| <a id="getpublishcounter"></a> `getPublishCounter` | () => `Counter` \| `undefined` | Get a counter for messages published. Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:65](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L65) |
+| <a id="getpublishlatencyhistogram"></a> `getPublishLatencyHistogram` | () => `Histogram` \| `undefined` | Get a histogram for publish latency. Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:77](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L77) |
+| <a id="gettracer"></a> `getTracer` | () => `Tracer` \| `undefined` | Get a tracer instance for creating spans. Returns undefined if OpenTelemetry is not available. | [packages/core/src/telemetry.ts:59](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L59) |
 
 ## Variables
 
@@ -1095,7 +743,7 @@ Uses lazy loading to gracefully handle cases where OpenTelemetry is not installe
 const DEFAULT_CONNECT_TIMEOUT_MS: 30000 = 30_000;
 ```
 
-Defined in: [packages/core/src/amqp-client.ts:47](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/amqp-client.ts#L47)
+Defined in: [packages/core/src/amqp-client.ts:47](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/amqp-client.ts#L47)
 
 Default time `waitForConnect` will wait for the broker before erroring out.
 Defaulting to a finite value (rather than waiting forever) means a fail-fast
@@ -1113,7 +761,7 @@ delays to ~24.8 days and silently fires near-immediately on `Infinity`.
 const defaultTelemetryProvider: TelemetryProvider;
 ```
 
-Defined in: [packages/core/src/telemetry.ts:229](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L229)
+Defined in: [packages/core/src/telemetry.ts:229](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L229)
 
 Default telemetry provider that uses OpenTelemetry API if available.
 
@@ -1125,7 +773,7 @@ Default telemetry provider that uses OpenTelemetry API if available.
 const MessagingSemanticConventions: object;
 ```
 
-Defined in: [packages/core/src/telemetry.ts:26](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L26)
+Defined in: [packages/core/src/telemetry.ts:26](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L26)
 
 Semantic conventions for AMQP messaging following OpenTelemetry standards.
 
@@ -1133,20 +781,20 @@ Semantic conventions for AMQP messaging following OpenTelemetry standards.
 
 | Name | Type | Default value | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="property-amqp_consumer_name"></a> `AMQP_CONSUMER_NAME` | `"amqp.consumer.name"` | `"amqp.consumer.name"` | [packages/core/src/telemetry.ts:37](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L37) |
-| <a id="property-amqp_publisher_name"></a> `AMQP_PUBLISHER_NAME` | `"amqp.publisher.name"` | `"amqp.publisher.name"` | [packages/core/src/telemetry.ts:36](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L36) |
-| <a id="property-error_type"></a> `ERROR_TYPE` | `"error.type"` | `"error.type"` | [packages/core/src/telemetry.ts:40](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L40) |
-| <a id="property-messaging_destination"></a> `MESSAGING_DESTINATION` | `"messaging.destination.name"` | `"messaging.destination.name"` | [packages/core/src/telemetry.ts:29](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L29) |
-| <a id="property-messaging_destination_kind"></a> `MESSAGING_DESTINATION_KIND` | `"messaging.destination.kind"` | `"messaging.destination.kind"` | [packages/core/src/telemetry.ts:30](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L30) |
-| <a id="property-messaging_destination_kind_exchange"></a> `MESSAGING_DESTINATION_KIND_EXCHANGE` | `"exchange"` | `"exchange"` | [packages/core/src/telemetry.ts:44](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L44) |
-| <a id="property-messaging_destination_kind_queue"></a> `MESSAGING_DESTINATION_KIND_QUEUE` | `"queue"` | `"queue"` | [packages/core/src/telemetry.ts:45](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L45) |
-| <a id="property-messaging_operation"></a> `MESSAGING_OPERATION` | `"messaging.operation"` | `"messaging.operation"` | [packages/core/src/telemetry.ts:31](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L31) |
-| <a id="property-messaging_operation_process"></a> `MESSAGING_OPERATION_PROCESS` | `"process"` | `"process"` | [packages/core/src/telemetry.ts:47](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L47) |
-| <a id="property-messaging_operation_publish"></a> `MESSAGING_OPERATION_PUBLISH` | `"publish"` | `"publish"` | [packages/core/src/telemetry.ts:46](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L46) |
-| <a id="property-messaging_rabbitmq_message_delivery_tag"></a> `MESSAGING_RABBITMQ_MESSAGE_DELIVERY_TAG` | `"messaging.rabbitmq.message.delivery_tag"` | `"messaging.rabbitmq.message.delivery_tag"` | [packages/core/src/telemetry.ts:35](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L35) |
-| <a id="property-messaging_rabbitmq_routing_key"></a> `MESSAGING_RABBITMQ_ROUTING_KEY` | `"messaging.rabbitmq.destination.routing_key"` | `"messaging.rabbitmq.destination.routing_key"` | [packages/core/src/telemetry.ts:34](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L34) |
-| <a id="property-messaging_system"></a> `MESSAGING_SYSTEM` | `"messaging.system"` | `"messaging.system"` | [packages/core/src/telemetry.ts:28](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L28) |
-| <a id="property-messaging_system_rabbitmq"></a> `MESSAGING_SYSTEM_RABBITMQ` | `"rabbitmq"` | `"rabbitmq"` | [packages/core/src/telemetry.ts:43](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L43) |
+| <a id="property-amqp_consumer_name"></a> `AMQP_CONSUMER_NAME` | `"amqp.consumer.name"` | `"amqp.consumer.name"` | [packages/core/src/telemetry.ts:37](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L37) |
+| <a id="property-amqp_publisher_name"></a> `AMQP_PUBLISHER_NAME` | `"amqp.publisher.name"` | `"amqp.publisher.name"` | [packages/core/src/telemetry.ts:36](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L36) |
+| <a id="property-error_type"></a> `ERROR_TYPE` | `"error.type"` | `"error.type"` | [packages/core/src/telemetry.ts:40](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L40) |
+| <a id="property-messaging_destination"></a> `MESSAGING_DESTINATION` | `"messaging.destination.name"` | `"messaging.destination.name"` | [packages/core/src/telemetry.ts:29](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L29) |
+| <a id="property-messaging_destination_kind"></a> `MESSAGING_DESTINATION_KIND` | `"messaging.destination.kind"` | `"messaging.destination.kind"` | [packages/core/src/telemetry.ts:30](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L30) |
+| <a id="property-messaging_destination_kind_exchange"></a> `MESSAGING_DESTINATION_KIND_EXCHANGE` | `"exchange"` | `"exchange"` | [packages/core/src/telemetry.ts:44](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L44) |
+| <a id="property-messaging_destination_kind_queue"></a> `MESSAGING_DESTINATION_KIND_QUEUE` | `"queue"` | `"queue"` | [packages/core/src/telemetry.ts:45](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L45) |
+| <a id="property-messaging_operation"></a> `MESSAGING_OPERATION` | `"messaging.operation"` | `"messaging.operation"` | [packages/core/src/telemetry.ts:31](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L31) |
+| <a id="property-messaging_operation_process"></a> `MESSAGING_OPERATION_PROCESS` | `"process"` | `"process"` | [packages/core/src/telemetry.ts:47](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L47) |
+| <a id="property-messaging_operation_publish"></a> `MESSAGING_OPERATION_PUBLISH` | `"publish"` | `"publish"` | [packages/core/src/telemetry.ts:46](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L46) |
+| <a id="property-messaging_rabbitmq_message_delivery_tag"></a> `MESSAGING_RABBITMQ_MESSAGE_DELIVERY_TAG` | `"messaging.rabbitmq.message.delivery_tag"` | `"messaging.rabbitmq.message.delivery_tag"` | [packages/core/src/telemetry.ts:35](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L35) |
+| <a id="property-messaging_rabbitmq_routing_key"></a> `MESSAGING_RABBITMQ_ROUTING_KEY` | `"messaging.rabbitmq.destination.routing_key"` | `"messaging.rabbitmq.destination.routing_key"` | [packages/core/src/telemetry.ts:34](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L34) |
+| <a id="property-messaging_system"></a> `MESSAGING_SYSTEM` | `"messaging.system"` | `"messaging.system"` | [packages/core/src/telemetry.ts:28](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L28) |
+| <a id="property-messaging_system_rabbitmq"></a> `MESSAGING_SYSTEM_RABBITMQ` | `"rabbitmq"` | `"rabbitmq"` | [packages/core/src/telemetry.ts:43](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L43) |
 
 #### See
 
@@ -1160,7 +808,7 @@ https://opentelemetry.io/docs/specs/semconv/messaging/messaging-spans/
 function endSpanError(span, error): void;
 ```
 
-Defined in: [packages/core/src/telemetry.ts:324](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L324)
+Defined in: [packages/core/src/telemetry.ts:324](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L324)
 
 End a span with error status.
 
@@ -1183,7 +831,7 @@ End a span with error status.
 function endSpanSuccess(span): void;
 ```
 
-Defined in: [packages/core/src/telemetry.ts:309](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L309)
+Defined in: [packages/core/src/telemetry.ts:309](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L309)
 
 End a span with success status.
 
@@ -1210,7 +858,7 @@ function recordConsumeMetric(
    durationMs): void;
 ```
 
-Defined in: [packages/core/src/telemetry.ts:368](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L368)
+Defined in: [packages/core/src/telemetry.ts:368](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L368)
 
 Record a consume metric.
 
@@ -1236,7 +884,7 @@ Record a consume metric.
 function recordLateRpcReply(provider, reason): void;
 ```
 
-Defined in: [packages/core/src/telemetry.ts:398](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L398)
+Defined in: [packages/core/src/telemetry.ts:398](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L398)
 
 Record an RPC reply that arrived after the caller stopped waiting.
 
@@ -1264,7 +912,7 @@ function recordPublishMetric(
    durationMs): void;
 ```
 
-Defined in: [packages/core/src/telemetry.ts:341](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L341)
+Defined in: [packages/core/src/telemetry.ts:341](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L341)
 
 Record a publish metric.
 
@@ -1284,13 +932,58 @@ Record a publish metric.
 
 ***
 
+### safeJsonParse()
+
+```ts
+function safeJsonParse<E>(buffer, errorFn): Result<unknown, E>;
+```
+
+Defined in: [packages/core/src/parsing.ts:24](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/parsing.ts#L24)
+
+Parse a `Buffer` as JSON, mapping any `JSON.parse` exception to the
+caller-supplied error type.
+
+Use this in consume / reply paths where a parse failure is a typed value,
+not a thrown exception — the caller decides how to translate the raw error
+into a domain-level error (e.g. [TechnicalError](#technicalerror)).
+
+#### Type Parameters
+
+| Type Parameter | Description |
+| ------ | ------ |
+| `E` | The error type produced by `errorFn`. |
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `buffer` | `Buffer` | The raw message body to parse. |
+| `errorFn` | (`raw`) => `E` | Callback invoked with the underlying `JSON.parse` error. |
+
+#### Returns
+
+`Result`&lt;`unknown`, `E`&gt;
+
+A `Result` containing the parsed `unknown` value or the mapped error.
+
+#### Example
+
+```typescript
+const parsed = safeJsonParse(
+  msg.content,
+  (error) => new TechnicalError("Failed to parse JSON", error),
+);
+```
+
+***
+
 ### setupAmqpTopology()
 
 ```ts
 function setupAmqpTopology(channel, contract): Promise<void>;
 ```
 
-Defined in: [packages/core/src/setup.ts:26](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/setup.ts#L26)
+Defined in: [packages/core/src/setup.ts:26](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/setup.ts#L26)
 
 Setup AMQP topology (exchanges, queues, and bindings) from a contract definition.
 
@@ -1338,7 +1031,7 @@ function startConsumeSpan(
    attributes?): Span | undefined;
 ```
 
-Defined in: [packages/core/src/telemetry.ts:277](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L277)
+Defined in: [packages/core/src/telemetry.ts:277](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L277)
 
 Create a span for a consume/process operation.
 Returns undefined if OpenTelemetry is not available.
@@ -1368,7 +1061,7 @@ function startPublishSpan(
    attributes?): Span | undefined;
 ```
 
-Defined in: [packages/core/src/telemetry.ts:242](https://github.com/btravers/amqp-contract/blob/1ba3d51bb1d4a09c356afad101dc9e6e6d605185/packages/core/src/telemetry.ts#L242)
+Defined in: [packages/core/src/telemetry.ts:242](https://github.com/btravstack/amqp-contract/blob/5bdec81d9ab13131c5b7f699c426616cfbed2b5f/packages/core/src/telemetry.ts#L242)
 
 Create a span for a publish operation.
 Returns undefined if OpenTelemetry is not available.