@amqp-contract/worker 0.17.0 → 0.19.0

package/dist/index.cjs

@@ -7,19 +7,6 @@ let node_util = require("node:util");
 
 //#region src/errors.ts
 /**
-* Error thrown when message validation fails
-*/
-var MessageValidationError = class extends Error {
-	constructor(consumerName, issues) {
-		super(`Message validation failed for consumer "${consumerName}"`);
-		this.consumerName = consumerName;
-		this.issues = issues;
-		this.name = "MessageValidationError";
-		const ErrorConstructor = Error;
-		if (typeof ErrorConstructor.captureStackTrace === "function") ErrorConstructor.captureStackTrace(this, this.constructor);
-	}
-};
-/**
 * Retryable errors - transient failures that may succeed on retry
 * Examples: network timeouts, rate limiting, temporary service unavailability
 *
@@ -389,7 +376,7 @@ var TypedAmqpWorker = class TypedAmqpWorker {
 		const rawValidation = schema["~standard"].validate(data);
 		const validationPromise = rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);
 		return _swan_io_boxed.Future.fromPromise(validationPromise).mapError((error) => new _amqp_contract_core.TechnicalError(`Error validating ${context.field}`, error)).mapOkToResult((result) => {
-			if (result.issues) return _swan_io_boxed.Result.Error(new _amqp_contract_core.TechnicalError(`${context.field} validation failed`, new MessageValidationError(context.consumerName, result.issues)));
+			if (result.issues) return _swan_io_boxed.Result.Error(new _amqp_contract_core.TechnicalError(`${context.field} validation failed`, new _amqp_contract_core.MessageValidationError(context.consumerName, result.issues)));
 			return _swan_io_boxed.Result.Ok(result.value);
 		}).tapError((error) => {
 			this.logger?.error(`${context.field} validation failed`, {
@@ -737,7 +724,12 @@ function defineHandlers(contract, handlers) {
 }
 
 //#endregion
-exports.MessageValidationError = MessageValidationError;
+Object.defineProperty(exports, 'MessageValidationError', {
+  enumerable: true,
+  get: function () {
+    return _amqp_contract_core.MessageValidationError;
+  }
+});
 exports.NonRetryableError = NonRetryableError;
 exports.RetryableError = RetryableError;
 exports.TypedAmqpWorker = TypedAmqpWorker;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Logger, TechnicalError, TelemetryProvider } from "@amqp-contract/core";
+import { Logger, MessageValidationError, TechnicalError, TelemetryProvider } from "@amqp-contract/core";
 import * as amqp from "amqplib";
 import { ConsumeMessage } from "amqplib";
 import { TcpSocketConnectOpts } from "net";
@@ -49,14 +49,6 @@ interface AmqpConnectionManagerOptions {
 }
 //#endregion
 //#region src/errors.d.ts
-/**
- * Error thrown when message validation fails
- */
-declare class MessageValidationError extends Error {
-  readonly consumerName: string;
-  readonly issues: unknown;
-  constructor(consumerName: string, issues: unknown);
-}
 /**
  * Retryable errors - transient failures that may succeed on retry
  * Examples: network timeouts, rate limiting, temporary service unavailability
@@ -323,18 +315,6 @@ type WorkerInferConsumerHandlerEntry<TContract extends ContractDefinition, TName
  * ```
  */
 type WorkerInferConsumerHandlers<TContract extends ContractDefinition> = { [K in InferConsumerNames<TContract>]: WorkerInferConsumerHandlerEntry<TContract, K> };
-/**
- * @deprecated Use `WorkerInferConsumerHandler` instead. Will be removed in next major version.
- */
-type WorkerInferSafeConsumerHandler<TContract extends ContractDefinition, TName extends InferConsumerNames<TContract>> = WorkerInferConsumerHandler<TContract, TName>;
-/**
- * @deprecated Use `WorkerInferConsumerHandlerEntry` instead. Will be removed in next major version.
- */
-type WorkerInferSafeConsumerHandlerEntry<TContract extends ContractDefinition, TName extends InferConsumerNames<TContract>> = WorkerInferConsumerHandlerEntry<TContract, TName>;
-/**
- * @deprecated Use `WorkerInferConsumerHandlers` instead. Will be removed in next major version.
- */
-type WorkerInferSafeConsumerHandlers<TContract extends ContractDefinition> = WorkerInferConsumerHandlers<TContract>;
 //#endregion
 //#region src/worker.d.ts
 /**
@@ -680,5 +660,5 @@ declare function defineHandler<TContract extends ContractDefinition, TName exten
  */
 declare function defineHandlers<TContract extends ContractDefinition>(contract: TContract, handlers: WorkerInferConsumerHandlers<TContract>): WorkerInferConsumerHandlers<TContract>;
 //#endregion
-export { type CreateWorkerOptions, type HandlerError, MessageValidationError, NonRetryableError, RetryableError, TypedAmqpWorker, type WorkerConsumedMessage, type WorkerInferConsumedMessage, type WorkerInferConsumerHandler, type WorkerInferConsumerHandlerEntry, type WorkerInferConsumerHandlers, type WorkerInferConsumerHeaders, type WorkerInferSafeConsumerHandler, type WorkerInferSafeConsumerHandlerEntry, type WorkerInferSafeConsumerHandlers, defineHandler, defineHandlers, isHandlerError, isNonRetryableError, isRetryableError, nonRetryable, retryable };
+export { type CreateWorkerOptions, type HandlerError, MessageValidationError, NonRetryableError, RetryableError, TypedAmqpWorker, type WorkerConsumedMessage, type WorkerInferConsumedMessage, type WorkerInferConsumerHandler, type WorkerInferConsumerHandlerEntry, type WorkerInferConsumerHandlers, type WorkerInferConsumerHeaders, defineHandler, defineHandlers, isHandlerError, isNonRetryableError, isRetryableError, nonRetryable, retryable };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":["amqp","EventEmitter","TcpSocketConnectOpts","ConnectionOptions","ChannelWrapper","CreateChannelOpts","ConnectionUrl","Options","Connect","AmqpConnectionOptions","url","connectionOptions","ConnectListener","Connection","connection","arg","ConnectFailedListener","Error","err","Buffer","noDelay","timeout","keepAlive","keepAliveDelay","clientProperties","credentials","mechanism","username","password","response","AmqpConnectionManagerOptions","Promise","heartbeatIntervalInSeconds","reconnectTimeInSeconds","findServers","urls","callback","IAmqpConnectionManager","Function","ChannelModel","addListener","event","args","listener","reason","listeners","eventName","on","once","prependListener","prependOnceListener","removeListener","connect","options","reconnect","createChannel","close","isConnected","channelCount","AmqpConnectionManager","_channels","_currentUrl","_closed","_cancelRetriesHandler","_connectPromise","_currentConnection","_findServers","_urls","constructor","_connect","default"],"sources":["../../../node_modules/.pnpm/amqp-connection-manager@5.0.0_amqplib@0.10.9/node_modules/amqp-connection-manager/dist/types/AmqpConnectionManager.d.ts","../src/errors.ts","../src/types.ts","../src/worker.ts","../src/handlers.ts"],"x_google_ignoreList":[0],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":["amqp","EventEmitter","TcpSocketConnectOpts","ConnectionOptions","ChannelWrapper","CreateChannelOpts","ConnectionUrl","Options","Connect","AmqpConnectionOptions","url","connectionOptions","ConnectListener","Connection","connection","arg","ConnectFailedListener","Error","err","Buffer","noDelay","timeout","keepAlive","keepAliveDelay","clientProperties","credentials","mechanism","username","password","response","AmqpConnectionManagerOptions","Promise","heartbeatIntervalInSeconds","reconnectTimeInSeconds","findServers","urls","callback","IAmqpConnectionManager","Function","ChannelModel","addListener","event","args","listener","reason","listeners","eventName","on","once","prependListener","prependOnceListener","removeListener","connect","options","reconnect","createChannel","close","isConnected","channelCount","AmqpConnectionManager","_channels","_currentUrl","_closed","_cancelRetriesHandler","_connectPromise","_currentConnection","_findServers","_urls","constructor","_connect","default"],"sources":["../../../node_modules/.pnpm/amqp-connection-manager@5.0.0_amqplib@0.10.9/node_modules/amqp-connection-manager/dist/types/AmqpConnectionManager.d.ts","../src/errors.ts","../src/types.ts","../src/worker.ts","../src/handlers.ts"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Logger, TechnicalError, TelemetryProvider } from "@amqp-contract/core";
+import { Logger, MessageValidationError, TechnicalError, TelemetryProvider } from "@amqp-contract/core";
 import { ConsumerDefinition, ConsumerEntry, ContractDefinition, InferConsumerNames, MessageDefinition } from "@amqp-contract/contract";
 import { Future, Result } from "@swan-io/boxed";
 import * as amqp from "amqplib";
@@ -49,14 +49,6 @@ interface AmqpConnectionManagerOptions {
 }
 //#endregion
 //#region src/errors.d.ts
-/**
- * Error thrown when message validation fails
- */
-declare class MessageValidationError extends Error {
-  readonly consumerName: string;
-  readonly issues: unknown;
-  constructor(consumerName: string, issues: unknown);
-}
 /**
  * Retryable errors - transient failures that may succeed on retry
  * Examples: network timeouts, rate limiting, temporary service unavailability
@@ -323,18 +315,6 @@ type WorkerInferConsumerHandlerEntry<TContract extends ContractDefinition, TName
  * ```
  */
 type WorkerInferConsumerHandlers<TContract extends ContractDefinition> = { [K in InferConsumerNames<TContract>]: WorkerInferConsumerHandlerEntry<TContract, K> };
-/**
- * @deprecated Use `WorkerInferConsumerHandler` instead. Will be removed in next major version.
- */
-type WorkerInferSafeConsumerHandler<TContract extends ContractDefinition, TName extends InferConsumerNames<TContract>> = WorkerInferConsumerHandler<TContract, TName>;
-/**
- * @deprecated Use `WorkerInferConsumerHandlerEntry` instead. Will be removed in next major version.
- */
-type WorkerInferSafeConsumerHandlerEntry<TContract extends ContractDefinition, TName extends InferConsumerNames<TContract>> = WorkerInferConsumerHandlerEntry<TContract, TName>;
-/**
- * @deprecated Use `WorkerInferConsumerHandlers` instead. Will be removed in next major version.
- */
-type WorkerInferSafeConsumerHandlers<TContract extends ContractDefinition> = WorkerInferConsumerHandlers<TContract>;
 //#endregion
 //#region src/worker.d.ts
 /**
@@ -680,5 +660,5 @@ declare function defineHandler<TContract extends ContractDefinition, TName exten
  */
 declare function defineHandlers<TContract extends ContractDefinition>(contract: TContract, handlers: WorkerInferConsumerHandlers<TContract>): WorkerInferConsumerHandlers<TContract>;
 //#endregion
-export { type CreateWorkerOptions, type HandlerError, MessageValidationError, NonRetryableError, RetryableError, TypedAmqpWorker, type WorkerConsumedMessage, type WorkerInferConsumedMessage, type WorkerInferConsumerHandler, type WorkerInferConsumerHandlerEntry, type WorkerInferConsumerHandlers, type WorkerInferConsumerHeaders, type WorkerInferSafeConsumerHandler, type WorkerInferSafeConsumerHandlerEntry, type WorkerInferSafeConsumerHandlers, defineHandler, defineHandlers, isHandlerError, isNonRetryableError, isRetryableError, nonRetryable, retryable };
+export { type CreateWorkerOptions, type HandlerError, MessageValidationError, NonRetryableError, RetryableError, TypedAmqpWorker, type WorkerConsumedMessage, type WorkerInferConsumedMessage, type WorkerInferConsumerHandler, type WorkerInferConsumerHandlerEntry, type WorkerInferConsumerHandlers, type WorkerInferConsumerHeaders, defineHandler, defineHandlers, isHandlerError, isNonRetryableError, isRetryableError, nonRetryable, retryable };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":["amqp","EventEmitter","TcpSocketConnectOpts","ConnectionOptions","ChannelWrapper","CreateChannelOpts","ConnectionUrl","Options","Connect","AmqpConnectionOptions","url","connectionOptions","ConnectListener","Connection","connection","arg","ConnectFailedListener","Error","err","Buffer","noDelay","timeout","keepAlive","keepAliveDelay","clientProperties","credentials","mechanism","username","password","response","AmqpConnectionManagerOptions","Promise","heartbeatIntervalInSeconds","reconnectTimeInSeconds","findServers","urls","callback","IAmqpConnectionManager","Function","ChannelModel","addListener","event","args","listener","reason","listeners","eventName","on","once","prependListener","prependOnceListener","removeListener","connect","options","reconnect","createChannel","close","isConnected","channelCount","AmqpConnectionManager","_channels","_currentUrl","_closed","_cancelRetriesHandler","_connectPromise","_currentConnection","_findServers","_urls","constructor","_connect","default"],"sources":["../../../node_modules/.pnpm/amqp-connection-manager@5.0.0_amqplib@0.10.9/node_modules/amqp-connection-manager/dist/types/AmqpConnectionManager.d.ts","../src/errors.ts","../src/types.ts","../src/worker.ts","../src/handlers.ts"],"x_google_ignoreList":[0],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":["amqp","EventEmitter","TcpSocketConnectOpts","ConnectionOptions","ChannelWrapper","CreateChannelOpts","ConnectionUrl","Options","Connect","AmqpConnectionOptions","url","connectionOptions","ConnectListener","Connection","connection","arg","ConnectFailedListener","Error","err","Buffer","noDelay","timeout","keepAlive","keepAliveDelay","clientProperties","credentials","mechanism","username","password","response","AmqpConnectionManagerOptions","Promise","heartbeatIntervalInSeconds","reconnectTimeInSeconds","findServers","urls","callback","IAmqpConnectionManager","Function","ChannelModel","addListener","event","args","listener","reason","listeners","eventName","on","once","prependListener","prependOnceListener","removeListener","connect","options","reconnect","createChannel","close","isConnected","channelCount","AmqpConnectionManager","_channels","_currentUrl","_closed","_cancelRetriesHandler","_connectPromise","_currentConnection","_findServers","_urls","constructor","_connect","default"],"sources":["../../../node_modules/.pnpm/amqp-connection-manager@5.0.0_amqplib@0.10.9/node_modules/amqp-connection-manager/dist/types/AmqpConnectionManager.d.ts","../src/errors.ts","../src/types.ts","../src/worker.ts","../src/handlers.ts"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { AmqpClient, TechnicalError, defaultTelemetryProvider, endSpanError, endSpanSuccess, recordConsumeMetric, startConsumeSpan } from "@amqp-contract/core";
+import { AmqpClient, MessageValidationError, TechnicalError, defaultTelemetryProvider, endSpanError, endSpanSuccess, recordConsumeMetric, startConsumeSpan } from "@amqp-contract/core";
 import { extractConsumer } from "@amqp-contract/contract";
 import { Future, Result } from "@swan-io/boxed";
 import { gunzip, inflate } from "node:zlib";
@@ -6,19 +6,6 @@ import { promisify } from "node:util";
 
 //#region src/errors.ts
 /**
-* Error thrown when message validation fails
-*/
-var MessageValidationError = class extends Error {
-	constructor(consumerName, issues) {
-		super(`Message validation failed for consumer "${consumerName}"`);
-		this.consumerName = consumerName;
-		this.issues = issues;
-		this.name = "MessageValidationError";
-		const ErrorConstructor = Error;
-		if (typeof ErrorConstructor.captureStackTrace === "function") ErrorConstructor.captureStackTrace(this, this.constructor);
-	}
-};
-/**
 * Retryable errors - transient failures that may succeed on retry
 * Examples: network timeouts, rate limiting, temporary service unavailability
 *

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/decompression.ts","../src/worker.ts","../src/handlers.ts"],"sourcesContent":["/**\n * Error thrown when message validation fails\n */\nexport class MessageValidationError extends Error {\n  constructor(\n    public readonly consumerName: string,\n    public readonly issues: unknown,\n  ) {\n    super(`Message validation failed for consumer \"${consumerName}\"`);\n    this.name = \"MessageValidationError\";\n    // Node.js specific stack trace capture\n    const ErrorConstructor = Error as unknown as {\n      captureStackTrace?: (target: object, constructor: Function) => void;\n    };\n    if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n      ErrorConstructor.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Retryable errors - transient failures that may succeed on retry\n * Examples: network timeouts, rate limiting, temporary service unavailability\n *\n * Use this error type when the operation might succeed if retried.\n * The worker will apply exponential backoff and retry the message.\n */\nexport class RetryableError extends Error {\n  constructor(\n    message: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"RetryableError\";\n    // Node.js specific stack trace capture\n    const ErrorConstructor = Error as unknown as {\n      captureStackTrace?: (target: object, constructor: Function) => void;\n    };\n    if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n      ErrorConstructor.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Non-retryable errors - permanent failures that should not be retried\n * Examples: invalid data, business rule violations, permanent external failures\n *\n * Use this error type when retrying would not help - the message will be\n * immediately sent to the dead letter queue (DLQ) if configured.\n */\nexport class NonRetryableError extends Error {\n  constructor(\n    message: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"NonRetryableError\";\n    // Node.js specific stack trace capture\n    const ErrorConstructor = Error as unknown as {\n      captureStackTrace?: (target: object, constructor: Function) => void;\n    };\n    if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n      ErrorConstructor.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Union type representing all handler errors.\n * Use this type when defining handlers that explicitly signal error outcomes.\n */\nexport type HandlerError = RetryableError | NonRetryableError;\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Type guard to check if an error is a RetryableError.\n *\n * Use this to check error types in catch blocks or error handlers.\n *\n * @param error - The error to check\n * @returns True if the error is a RetryableError\n *\n * @example\n * ```typescript\n * import { isRetryableError } from '@amqp-contract/worker';\n *\n * try {\n *   await processMessage();\n * } catch (error) {\n *   if (isRetryableError(error)) {\n *     console.log('Will retry:', error.message);\n *   } else {\n *     console.log('Permanent failure:', error);\n *   }\n * }\n * ```\n */\nexport function isRetryableError(error: unknown): error is RetryableError {\n  return error instanceof RetryableError;\n}\n\n/**\n * Type guard to check if an error is a NonRetryableError.\n *\n * Use this to check error types in catch blocks or error handlers.\n *\n * @param error - The error to check\n * @returns True if the error is a NonRetryableError\n *\n * @example\n * ```typescript\n * import { isNonRetryableError } from '@amqp-contract/worker';\n *\n * try {\n *   await processMessage();\n * } catch (error) {\n *   if (isNonRetryableError(error)) {\n *     console.log('Will not retry:', error.message);\n *   }\n * }\n * ```\n */\nexport function isNonRetryableError(error: unknown): error is NonRetryableError {\n  return error instanceof NonRetryableError;\n}\n\n/**\n * Type guard to check if an error is any HandlerError (RetryableError or NonRetryableError).\n *\n * @param error - The error to check\n * @returns True if the error is a HandlerError\n *\n * @example\n * ```typescript\n * import { isHandlerError } from '@amqp-contract/worker';\n *\n * function handleError(error: unknown) {\n *   if (isHandlerError(error)) {\n *     // error is RetryableError | NonRetryableError\n *     console.log('Handler error:', error.name, error.message);\n *   }\n * }\n * ```\n */\nexport function isHandlerError(error: unknown): error is HandlerError {\n  return isRetryableError(error) || isNonRetryableError(error);\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Create a RetryableError with less verbosity.\n *\n * This is a shorthand factory function for creating RetryableError instances.\n * Use it for cleaner error creation in handlers.\n *\n * @param message - Error message describing the failure\n * @param cause - Optional underlying error that caused this failure\n * @returns A new RetryableError instance\n *\n * @example\n * ```typescript\n * import { retryable } from '@amqp-contract/worker';\n * import { Future, Result } from '@swan-io/boxed';\n *\n * const handler = ({ payload }) =>\n *   Future.fromPromise(processPayment(payload))\n *     .mapOk(() => undefined)\n *     .mapError((e) => retryable('Payment service unavailable', e));\n *\n * // Equivalent to:\n * // .mapError((e) => new RetryableError('Payment service unavailable', e));\n * ```\n */\nexport function retryable(message: string, cause?: unknown): RetryableError {\n  return new RetryableError(message, cause);\n}\n\n/**\n * Create a NonRetryableError with less verbosity.\n *\n * This is a shorthand factory function for creating NonRetryableError instances.\n * Use it for cleaner error creation in handlers.\n *\n * @param message - Error message describing the failure\n * @param cause - Optional underlying error that caused this failure\n * @returns A new NonRetryableError instance\n *\n * @example\n * ```typescript\n * import { nonRetryable } from '@amqp-contract/worker';\n * import { Future, Result } from '@swan-io/boxed';\n *\n * const handler = ({ payload }) => {\n *   if (!isValidPayload(payload)) {\n *     return Future.value(Result.Error(nonRetryable('Invalid payload format')));\n *   }\n *   return Future.value(Result.Ok(undefined));\n * };\n *\n * // Equivalent to:\n * // return Future.value(Result.Error(new NonRetryableError('Invalid payload format')));\n * ```\n */\nexport function nonRetryable(message: string, cause?: unknown): NonRetryableError {\n  return new NonRetryableError(message, cause);\n}\n","import { Future, Result } from \"@swan-io/boxed\";\nimport { gunzip, inflate } from \"node:zlib\";\nimport { TechnicalError } from \"@amqp-contract/core\";\nimport { promisify } from \"node:util\";\n\nconst gunzipAsync = promisify(gunzip);\nconst inflateAsync = promisify(inflate);\n\n/**\n * Supported content encodings for message decompression.\n */\nconst SUPPORTED_ENCODINGS = [\"gzip\", \"deflate\"] as const;\n\n/**\n * Type for supported content encodings.\n */\ntype SupportedEncoding = (typeof SUPPORTED_ENCODINGS)[number];\n\n/**\n * Type guard to check if a string is a supported encoding.\n */\nfunction isSupportedEncoding(encoding: string): encoding is SupportedEncoding {\n  return SUPPORTED_ENCODINGS.includes(encoding.toLowerCase() as SupportedEncoding);\n}\n\n/**\n * Decompress a buffer based on the content-encoding header.\n *\n * @param buffer - The buffer to decompress\n * @param contentEncoding - The content-encoding header value (e.g., 'gzip', 'deflate')\n * @returns A Future with the decompressed buffer or a TechnicalError\n *\n * @internal\n */\nexport function decompressBuffer(\n  buffer: Buffer,\n  contentEncoding: string | undefined,\n): Future<Result<Buffer, TechnicalError>> {\n  if (!contentEncoding) {\n    return Future.value(Result.Ok(buffer));\n  }\n\n  const normalizedEncoding = contentEncoding.toLowerCase();\n\n  if (!isSupportedEncoding(normalizedEncoding)) {\n    return Future.value(\n      Result.Error(\n        new TechnicalError(\n          `Unsupported content-encoding: \"${contentEncoding}\". ` +\n            `Supported encodings are: ${SUPPORTED_ENCODINGS.join(\", \")}. ` +\n            `Please check your publisher configuration.`,\n        ),\n      ),\n    );\n  }\n\n  switch (normalizedEncoding) {\n    case \"gzip\":\n      return Future.fromPromise(gunzipAsync(buffer)).mapError(\n        (error) => new TechnicalError(\"Failed to decompress gzip\", error),\n      );\n    case \"deflate\":\n      return Future.fromPromise(inflateAsync(buffer)).mapError(\n        (error) => new TechnicalError(\"Failed to decompress deflate\", error),\n      );\n  }\n}\n","import {\n  AmqpClient,\n  type Logger,\n  TechnicalError,\n  type TelemetryProvider,\n  defaultTelemetryProvider,\n  endSpanError,\n  endSpanSuccess,\n  recordConsumeMetric,\n  startConsumeSpan,\n} from \"@amqp-contract/core\";\nimport type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\nimport type { Channel, ConsumeMessage } from \"amqplib\";\nimport {\n  type ConsumerDefinition,\n  type ContractDefinition,\n  type InferConsumerNames,\n  type ResolvedRetryOptions,\n  type ResolvedTtlBackoffRetryOptions,\n  extractConsumer,\n} from \"@amqp-contract/contract\";\nimport { Future, Result } from \"@swan-io/boxed\";\nimport { MessageValidationError, NonRetryableError } from \"./errors.js\";\nimport type {\n  WorkerInferConsumedMessage,\n  WorkerInferConsumerHandler,\n  WorkerInferConsumerHandlers,\n} from \"./types.js\";\nimport type { HandlerError } from \"./errors.js\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { decompressBuffer } from \"./decompression.js\";\n\n/**\n * Internal type for consumer options extracted from handler tuples.\n * Not exported - options are specified inline in the handler tuple types.\n *\n * Note: Retry configuration is now defined at the queue level in the contract,\n * not at the handler level. See `QueueDefinition.retry` for configuration options.\n */\ntype ConsumerOptions = {\n  /** Number of messages to prefetch */\n  prefetch?: number;\n};\n\n/**\n * Retry configuration from the contract with all values resolved.\n * This is a discriminated union on `mode` - TTL-backoff has the config fields,\n * quorum-native does not.\n */\ntype ResolvedRetryConfig = ResolvedRetryOptions;\n\n/**\n * Type guard to check if a handler entry is a tuple format [handler, options].\n */\nfunction isHandlerTuple(entry: unknown): entry is [unknown, ConsumerOptions] {\n  return Array.isArray(entry) && entry.length === 2;\n}\n\n/**\n * Options for creating a type-safe AMQP worker.\n *\n * @typeParam TContract - The contract definition type\n *\n * @example\n * ```typescript\n * const options: CreateWorkerOptions<typeof contract> = {\n *   contract: myContract,\n *   handlers: {\n *     // Simple handler\n *     processOrder: ({ payload }) => {\n *       console.log('Processing order:', payload.orderId);\n *       return Future.value(Result.Ok(undefined));\n *     },\n *     // Handler with prefetch configuration\n *     processPayment: [\n *       ({ payload }) => {\n *         console.log('Processing payment:', payload.paymentId);\n *         return Future.value(Result.Ok(undefined));\n *       },\n *       { prefetch: 10 }\n *     ]\n *   },\n *   urls: ['amqp://localhost'],\n *   connectionOptions: {\n *     heartbeatIntervalInSeconds: 30\n *   },\n *   logger: myLogger\n * };\n * ```\n *\n * Note: Retry configuration is defined at the queue level in the contract,\n * not at the handler level. See `QueueDefinition.retry` for configuration options.\n */\nexport type CreateWorkerOptions<TContract extends ContractDefinition> = {\n  /** The AMQP contract definition specifying consumers and their message schemas */\n  contract: TContract;\n  /**\n   * Handlers for each consumer defined in the contract.\n   * Handlers must return `Future<Result<void, HandlerError>>` for explicit error handling.\n   * Use defineHandler() to create handlers.\n   */\n  handlers: WorkerInferConsumerHandlers<TContract>;\n  /** AMQP broker URL(s). Multiple URLs provide failover support */\n  urls: ConnectionUrl[];\n  /** Optional connection configuration (heartbeat, reconnect settings, etc.) */\n  connectionOptions?: AmqpConnectionManagerOptions | undefined;\n  /** Optional logger for logging message consumption and errors */\n  logger?: Logger | undefined;\n  /**\n   * Optional telemetry provider for tracing and metrics.\n   * If not provided, uses the default provider which attempts to load OpenTelemetry.\n   * OpenTelemetry instrumentation is automatically enabled if @opentelemetry/api is installed.\n   */\n  telemetry?: TelemetryProvider | undefined;\n};\n\n/**\n * Type-safe AMQP worker for consuming messages from RabbitMQ.\n *\n * This class provides automatic message validation, connection management,\n * and error handling for consuming messages based on a contract definition.\n *\n * @typeParam TContract - The contract definition type\n *\n * @example\n * ```typescript\n * import { TypedAmqpWorker } from '@amqp-contract/worker';\n * import { defineQueue, defineMessage, defineContract, defineConsumer } from '@amqp-contract/contract';\n * import { z } from 'zod';\n *\n * const orderQueue = defineQueue('order-processing', { durable: true });\n * const orderMessage = defineMessage(z.object({\n *   orderId: z.string(),\n *   amount: z.number()\n * }));\n *\n * const contract = defineContract({\n *   consumers: {\n *     processOrder: defineConsumer(orderQueue, orderMessage)\n *   }\n * });\n *\n * const worker = await TypedAmqpWorker.create({\n *   contract,\n *   handlers: {\n *     processOrder: async (message) => {\n *       console.log('Processing order', message.orderId);\n *       // Process the order...\n *     }\n *   },\n *   urls: ['amqp://localhost']\n * }).resultToPromise();\n *\n * // Close when done\n * await worker.close().resultToPromise();\n * ```\n */\nexport class TypedAmqpWorker<TContract extends ContractDefinition> {\n  /**\n   * Internal handler storage - handlers returning `Future<Result>`.\n   */\n  private readonly actualHandlers: Partial<\n    Record<\n      InferConsumerNames<TContract>,\n      WorkerInferConsumerHandler<TContract, InferConsumerNames<TContract>>\n    >\n  >;\n  private readonly consumerOptions: Partial<Record<InferConsumerNames<TContract>, ConsumerOptions>>;\n  private readonly consumerTags: Set<string> = new Set();\n  private readonly telemetry: TelemetryProvider;\n\n  private constructor(\n    private readonly contract: TContract,\n    private readonly amqpClient: AmqpClient,\n    handlers: WorkerInferConsumerHandlers<TContract>,\n    private readonly logger?: Logger,\n    telemetry?: TelemetryProvider,\n  ) {\n    this.telemetry = telemetry ?? defaultTelemetryProvider;\n\n    // Extract handlers and options from the handlers object\n    this.actualHandlers = {};\n    this.consumerOptions = {};\n\n    // Cast handlers to a generic record for iteration\n    const handlersRecord = handlers as Record<string, unknown>;\n\n    for (const consumerName of Object.keys(handlersRecord)) {\n      const handlerEntry = handlersRecord[consumerName];\n      const typedConsumerName = consumerName as InferConsumerNames<TContract>;\n\n      if (isHandlerTuple(handlerEntry)) {\n        // Tuple format: [handler, options]\n        const [handler, options] = handlerEntry;\n        this.actualHandlers[typedConsumerName] = handler as WorkerInferConsumerHandler<\n          TContract,\n          InferConsumerNames<TContract>\n        >;\n        this.consumerOptions[typedConsumerName] = options;\n      } else {\n        // Direct function format\n        this.actualHandlers[typedConsumerName] = handlerEntry as WorkerInferConsumerHandler<\n          TContract,\n          InferConsumerNames<TContract>\n        >;\n      }\n    }\n  }\n\n  /**\n   * Create a type-safe AMQP worker from a contract.\n   *\n   * Connection management (including automatic reconnection) is handled internally\n   * by amqp-connection-manager via the {@link AmqpClient}. The worker will set up\n   * consumers for all contract-defined handlers asynchronously in the background\n   * once the underlying connection and channels are ready.\n   *\n   * Connections are automatically shared across clients and workers with the same\n   * URLs and connection options, following RabbitMQ best practices.\n   *\n   * @param options - Configuration options for the worker\n   * @returns A Future that resolves to a Result containing the worker or an error\n   *\n   * @example\n   * ```typescript\n   * const worker = await TypedAmqpWorker.create({\n   *   contract: myContract,\n   *   handlers: {\n   *     processOrder: async ({ payload }) => console.log('Order:', payload.orderId)\n   *   },\n   *   urls: ['amqp://localhost']\n   * }).resultToPromise();\n   * ```\n   */\n  static create<TContract extends ContractDefinition>({\n    contract,\n    handlers,\n    urls,\n    connectionOptions,\n    logger,\n    telemetry,\n  }: CreateWorkerOptions<TContract>): Future<Result<TypedAmqpWorker<TContract>, TechnicalError>> {\n    const worker = new TypedAmqpWorker(\n      contract,\n      new AmqpClient(contract, {\n        urls,\n        connectionOptions,\n      }),\n      handlers,\n      logger,\n      telemetry,\n    );\n\n    // Note: Wait queues are now created by the core package in setupAmqpTopology\n    // when the queue's retry mode is \"ttl-backoff\"\n    return worker\n      .waitForConnectionReady()\n      .flatMapOk(() => worker.consumeAll())\n      .mapOk(() => worker);\n  }\n\n  /**\n   * Close the AMQP channel and connection.\n   *\n   * This gracefully closes the connection to the AMQP broker,\n   * stopping all message consumption and cleaning up resources.\n   *\n   * @returns A Future that resolves to a Result indicating success or failure\n   *\n   * @example\n   * ```typescript\n   * const closeResult = await worker.close().resultToPromise();\n   * if (closeResult.isOk()) {\n   *   console.log('Worker closed successfully');\n   * }\n   * ```\n   */\n  close(): Future<Result<void, TechnicalError>> {\n    return Future.all(\n      Array.from(this.consumerTags).map((consumerTag) =>\n        this.amqpClient.cancel(consumerTag).mapErrorToResult((error) => {\n          this.logger?.warn(\"Failed to cancel consumer during close\", { consumerTag, error });\n          return Result.Ok(undefined);\n        }),\n      ),\n    )\n      .map(Result.all)\n      .tapOk(() => {\n        // Clear consumer tags after successful cancellation\n        this.consumerTags.clear();\n      })\n      .flatMapOk(() => this.amqpClient.close())\n      .mapOk(() => undefined);\n  }\n\n  /**\n   * Get the retry configuration for a consumer's queue.\n   * Defaults are applied in the contract's defineQueue, so we just return the config.\n   */\n  private getRetryConfigForConsumer(consumer: ConsumerDefinition): ResolvedRetryConfig {\n    return consumer.queue.retry;\n  }\n\n  /**\n   * Start consuming messages for all consumers.\n   * TypeScript guarantees consumers exist (handlers require matching consumers).\n   */\n  private consumeAll(): Future<Result<void, TechnicalError>> {\n    const consumers = this.contract.consumers!;\n    const consumerNames = Object.keys(consumers) as InferConsumerNames<TContract>[];\n\n    // Calculate max prefetch (AMQP 0.9.1 prefetch is per-channel)\n    const maxPrefetch = consumerNames.reduce((max, name) => {\n      const prefetch = this.consumerOptions[name]?.prefetch;\n      return prefetch ? Math.max(max, prefetch) : max;\n    }, 0);\n\n    if (maxPrefetch > 0) {\n      this.amqpClient.addSetup(async (channel: Channel) => {\n        await channel.prefetch(maxPrefetch);\n      });\n    }\n\n    return Future.all(consumerNames.map((name) => this.consume(name)))\n      .map(Result.all)\n      .mapOk(() => undefined);\n  }\n\n  private waitForConnectionReady(): Future<Result<void, TechnicalError>> {\n    return this.amqpClient.waitForConnect();\n  }\n\n  /**\n   * Start consuming messages for a specific consumer.\n   * TypeScript guarantees consumer and handler exist for valid consumer names.\n   */\n  private consume<TName extends InferConsumerNames<TContract>>(\n    consumerName: TName,\n  ): Future<Result<void, TechnicalError>> {\n    // Non-null assertions safe: TypeScript guarantees these exist for valid TName\n    const consumerEntry = this.contract.consumers![consumerName as string]!;\n    const consumer = extractConsumer(consumerEntry);\n    const handler = this.actualHandlers[consumerName]!;\n\n    return this.consumeSingle(\n      consumerName,\n      consumer,\n      handler as Parameters<typeof this.consumeSingle<TName>>[2],\n    );\n  }\n\n  /**\n   * Validate data against a Standard Schema and handle errors.\n   */\n  private validateSchema(\n    schema: StandardSchemaV1,\n    data: unknown,\n    context: { consumerName: string; queueName: string; field: string },\n    msg: ConsumeMessage,\n  ): Future<Result<unknown, TechnicalError>> {\n    const rawValidation = schema[\"~standard\"].validate(data);\n    const validationPromise =\n      rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);\n\n    return Future.fromPromise(validationPromise)\n      .mapError((error) => new TechnicalError(`Error validating ${context.field}`, error))\n      .mapOkToResult((result) => {\n        if (result.issues) {\n          return Result.Error(\n            new TechnicalError(\n              `${context.field} validation failed`,\n              new MessageValidationError(context.consumerName, result.issues),\n            ),\n          );\n        }\n        return Result.Ok(result.value);\n      })\n      .tapError((error) => {\n        this.logger?.error(`${context.field} validation failed`, {\n          consumerName: context.consumerName,\n          queueName: context.queueName,\n          error,\n        });\n        this.amqpClient.nack(msg, false, false);\n      });\n  }\n\n  /**\n   * Parse and validate a message from AMQP.\n   * @returns Ok with validated message (payload + headers), or Error (message already nacked)\n   */\n  private parseAndValidateMessage<TName extends InferConsumerNames<TContract>>(\n    msg: ConsumeMessage,\n    consumer: ConsumerDefinition,\n    consumerName: TName,\n  ): Future<Result<WorkerInferConsumedMessage<TContract, TName>, TechnicalError>> {\n    const context = {\n      consumerName: String(consumerName),\n      queueName: consumer.queue.name,\n    };\n\n    const nackAndError = (message: string, error?: unknown): TechnicalError => {\n      this.logger?.error(message, { ...context, error });\n      this.amqpClient.nack(msg, false, false);\n      return new TechnicalError(message, error);\n    };\n\n    // Decompress → Parse JSON → Validate payload\n    const parsePayload = decompressBuffer(msg.content, msg.properties.contentEncoding)\n      .tapError((error) => {\n        this.logger?.error(\"Failed to decompress message\", { ...context, error });\n        this.amqpClient.nack(msg, false, false);\n      })\n      .mapOkToResult((buffer) =>\n        Result.fromExecution(() => JSON.parse(buffer.toString()) as unknown).mapError((error) =>\n          nackAndError(\"Failed to parse JSON\", error),\n        ),\n      )\n      .flatMapOk((parsed) =>\n        this.validateSchema(\n          consumer.message.payload as StandardSchemaV1,\n          parsed,\n          { ...context, field: \"payload\" },\n          msg,\n        ),\n      );\n\n    // Validate headers (if schema defined)\n    const parseHeaders = consumer.message.headers\n      ? this.validateSchema(\n          consumer.message.headers as StandardSchemaV1,\n          msg.properties.headers ?? {},\n          { ...context, field: \"headers\" },\n          msg,\n        )\n      : Future.value(Result.Ok<unknown, TechnicalError>(undefined));\n\n    return Future.allFromDict({ payload: parsePayload, headers: parseHeaders }).map(\n      Result.allFromDict,\n    ) as Future<Result<WorkerInferConsumedMessage<TContract, TName>, TechnicalError>>;\n  }\n\n  /**\n   * Consume messages one at a time\n   */\n  private consumeSingle<TName extends InferConsumerNames<TContract>>(\n    consumerName: TName,\n    consumer: ConsumerDefinition,\n    handler: (\n      message: WorkerInferConsumedMessage<TContract, TName>,\n      rawMessage: ConsumeMessage,\n    ) => Future<Result<void, HandlerError>>,\n  ): Future<Result<void, TechnicalError>> {\n    const queueName = consumer.queue.name;\n\n    // Start consuming\n    return this.amqpClient\n      .consume(queueName, async (msg) => {\n        // Handle null messages (consumer cancellation)\n        if (msg === null) {\n          this.logger?.warn(\"Consumer cancelled by server\", {\n            consumerName: String(consumerName),\n            queueName,\n          });\n          return;\n        }\n\n        const startTime = Date.now();\n        const span = startConsumeSpan(this.telemetry, queueName, String(consumerName), {\n          \"messaging.rabbitmq.message.delivery_tag\": msg.fields.deliveryTag,\n        });\n\n        // Parse and validate message\n        await this.parseAndValidateMessage(msg, consumer, consumerName)\n          .flatMapOk((validatedMessage) =>\n            handler(validatedMessage, msg)\n              .flatMapOk(() => {\n                this.logger?.info(\"Message consumed successfully\", {\n                  consumerName: String(consumerName),\n                  queueName,\n                });\n                // Acknowledge message on success\n                this.amqpClient.ack(msg);\n\n                // Record telemetry success\n                const durationMs = Date.now() - startTime;\n                endSpanSuccess(span);\n                recordConsumeMetric(\n                  this.telemetry,\n                  queueName,\n                  String(consumerName),\n                  true,\n                  durationMs,\n                );\n\n                return Future.value(Result.Ok<void, HandlerError>(undefined));\n              })\n              .flatMapError((handlerError: HandlerError) => {\n                // Handler returned an error\n                this.logger?.error(\"Error processing message\", {\n                  consumerName: String(consumerName),\n                  queueName,\n                  errorType: handlerError.name,\n                  error: handlerError.message,\n                });\n\n                // Record telemetry failure\n                const durationMs = Date.now() - startTime;\n                endSpanError(span, handlerError);\n                recordConsumeMetric(\n                  this.telemetry,\n                  queueName,\n                  String(consumerName),\n                  false,\n                  durationMs,\n                );\n\n                // Handle the error using retry mechanism\n                return this.handleError(handlerError, msg, String(consumerName), consumer);\n              }),\n          )\n          .tapError(() => {\n            // Record telemetry failure for validation errors\n            // Note: The actual validation error is logged in parseAndValidateMessage,\n            // here we just record that validation failed for telemetry purposes\n            const durationMs = Date.now() - startTime;\n            endSpanError(span, new Error(\"Message validation failed\"));\n            recordConsumeMetric(this.telemetry, queueName, String(consumerName), false, durationMs);\n          })\n          .toPromise();\n      })\n      .tapOk((consumerTag) => {\n        // Store consumer tag for later cancellation\n        this.consumerTags.add(consumerTag);\n      })\n      .mapError(\n        (error) =>\n          new TechnicalError(`Failed to start consuming for \"${String(consumerName)}\"`, error),\n      )\n      .mapOk(() => undefined);\n  }\n\n  /**\n   * Handle error in message processing with retry logic.\n   *\n   * Flow depends on retry mode:\n   *\n   * **quorum-native mode:**\n   * 1. If NonRetryableError -> send directly to DLQ (no retry)\n   * 2. Otherwise -> nack with requeue=true (RabbitMQ handles delivery count)\n   *\n   * **ttl-backoff mode:**\n   * 1. If NonRetryableError -> send directly to DLQ (no retry)\n   * 2. If max retries exceeded -> send to DLQ\n   * 3. Otherwise -> publish to wait queue with TTL for retry\n   *\n   * **Legacy mode (no retry config):**\n   * 1. nack with requeue=true (immediate requeue)\n   */\n  private handleError(\n    error: Error,\n    msg: ConsumeMessage,\n    consumerName: string,\n    consumer: ConsumerDefinition,\n  ): Future<Result<void, TechnicalError>> {\n    // NonRetryableError -> send directly to DLQ without retrying\n    if (error instanceof NonRetryableError) {\n      this.logger?.error(\"Non-retryable error, sending to DLQ immediately\", {\n        consumerName,\n        errorType: error.name,\n        error: error.message,\n      });\n      this.sendToDLQ(msg, consumer);\n      return Future.value(Result.Ok(undefined));\n    }\n\n    // Get retry config from the queue definition in the contract\n    const config = this.getRetryConfigForConsumer(consumer);\n\n    // Quorum-native mode: let RabbitMQ handle retry via x-delivery-count\n    if (config.mode === \"quorum-native\") {\n      return this.handleErrorQuorumNative(error, msg, consumerName, consumer);\n    }\n\n    // TTL-backoff mode: use wait queue with exponential backoff\n    return this.handleErrorTtlBackoff(error, msg, consumerName, consumer, config);\n  }\n\n  /**\n   * Handle error using quorum queue's native delivery limit feature.\n   *\n   * Simply requeues the message with nack(requeue=true). RabbitMQ automatically:\n   * - Increments x-delivery-count header\n   * - Dead-letters the message when count exceeds x-delivery-limit\n   *\n   * This is simpler than TTL-based retry but provides immediate retries only.\n   */\n  private handleErrorQuorumNative(\n    error: Error,\n    msg: ConsumeMessage,\n    consumerName: string,\n    consumer: ConsumerDefinition,\n  ): Future<Result<void, TechnicalError>> {\n    const queue = consumer.queue;\n    const queueName = queue.name;\n    // x-delivery-count is incremented on each delivery attempt\n    // When x-delivery-count equals x-delivery-limit, message is dead-lettered on next attempt\n    const deliveryCount = (msg.properties.headers?.[\"x-delivery-count\"] as number) ?? 0;\n    // This function is only called for quorum-native mode, which requires quorum queues\n    const deliveryLimit = queue.type === \"quorum\" ? queue.deliveryLimit : undefined;\n\n    // After this requeue, RabbitMQ will increment deliveryCount\n    // Message is dead-lettered when deliveryCount reaches deliveryLimit\n    // So if deliveryCount == deliveryLimit - 1, the next failure will dead-letter the message\n    const attemptsBeforeDeadLetter =\n      deliveryLimit !== undefined ? Math.max(0, deliveryLimit - deliveryCount - 1) : \"unknown\";\n\n    // Log warning if this is the last attempt before dead-lettering\n    if (deliveryLimit !== undefined && deliveryCount >= deliveryLimit - 1) {\n      this.logger?.warn(\"Message at final delivery attempt (quorum-native mode)\", {\n        consumerName,\n        queueName,\n        deliveryCount,\n        deliveryLimit,\n        willDeadLetterOnNextFailure: deliveryCount === deliveryLimit - 1,\n        alreadyExceededLimit: deliveryCount >= deliveryLimit,\n        error: error.message,\n      });\n    } else {\n      this.logger?.warn(\"Retrying message (quorum-native mode)\", {\n        consumerName,\n        queueName,\n        deliveryCount,\n        deliveryLimit,\n        attemptsBeforeDeadLetter,\n        error: error.message,\n      });\n    }\n\n    // Requeue the message - RabbitMQ tracks delivery count and handles dead-lettering\n    this.amqpClient.nack(msg, false, true);\n    return Future.value(Result.Ok(undefined));\n  }\n\n  /**\n   * Handle error using TTL + wait queue pattern for exponential backoff.\n   */\n  private handleErrorTtlBackoff(\n    error: Error,\n    msg: ConsumeMessage,\n    consumerName: string,\n    consumer: ConsumerDefinition,\n    config: ResolvedTtlBackoffRetryOptions,\n  ): Future<Result<void, TechnicalError>> {\n    // Get retry count from headers\n    const retryCount = (msg.properties.headers?.[\"x-retry-count\"] as number) ?? 0;\n\n    // Max retries exceeded -> DLQ\n    if (retryCount >= config.maxRetries) {\n      this.logger?.error(\"Max retries exceeded, sending to DLQ\", {\n        consumerName,\n        retryCount,\n        maxRetries: config.maxRetries,\n        error: error.message,\n      });\n      this.sendToDLQ(msg, consumer);\n      return Future.value(Result.Ok(undefined));\n    }\n\n    // Retry with exponential backoff\n    const delayMs = this.calculateRetryDelay(retryCount, config);\n    this.logger?.warn(\"Retrying message (ttl-backoff mode)\", {\n      consumerName,\n      retryCount: retryCount + 1,\n      delayMs,\n      error: error.message,\n    });\n\n    return this.publishForRetry(msg, consumer, retryCount + 1, delayMs, error);\n  }\n\n  /**\n   * Calculate retry delay with exponential backoff and optional jitter.\n   */\n  private calculateRetryDelay(retryCount: number, config: ResolvedTtlBackoffRetryOptions): number {\n    const { initialDelayMs, maxDelayMs, backoffMultiplier, jitter } = config;\n\n    let delay = Math.min(initialDelayMs * Math.pow(backoffMultiplier, retryCount), maxDelayMs);\n\n    if (jitter) {\n      // Add jitter: random value between 50% and 100% of calculated delay\n      delay = delay * (0.5 + Math.random() * 0.5);\n    }\n\n    return Math.floor(delay);\n  }\n\n  /**\n   * Parse message content for republishing.\n   * Prevents double JSON serialization by converting Buffer to object when possible.\n   */\n  private parseMessageContentForRetry(msg: ConsumeMessage, queueName: string): Buffer | unknown {\n    let content: Buffer | unknown = msg.content;\n\n    // If message is not compressed (no contentEncoding), parse it to get the original object\n    if (!msg.properties.contentEncoding) {\n      try {\n        content = JSON.parse(msg.content.toString());\n      } catch (err) {\n        this.logger?.warn(\"Failed to parse message for retry, using original buffer\", {\n          queueName,\n          error: err,\n        });\n      }\n    }\n\n    return content;\n  }\n\n  /**\n   * Publish message to wait queue for retry after TTL expires.\n   *\n   * ┌─────────────────────────────────────────────────────────────────┐\n   * │ Retry Flow (Native RabbitMQ TTL + DLX Pattern)                   │\n   * ├─────────────────────────────────────────────────────────────────┤\n   * │                                                                   │\n   * │ 1. Handler throws any Error                                      │\n   * │    ↓                                                              │\n   * │ 2. Worker publishes to DLX with routing key: {queue}-wait        │\n   * │    ↓                                                              │\n   * │ 3. DLX routes to wait queue: {queue}-wait                        │\n   * │    (with expiration: calculated backoff delay)                   │\n   * │    ↓                                                              │\n   * │ 4. Message waits in queue until TTL expires                      │\n   * │    ↓                                                              │\n   * │ 5. Expired message dead-lettered to DLX                          │\n   * │    (with routing key: {queue})                                   │\n   * │    ↓                                                              │\n   * │ 6. DLX routes back to main queue → RETRY                         │\n   * │    ↓                                                              │\n   * │ 7. If retries exhausted: nack without requeue → DLQ              │\n   * │                                                                   │\n   * └─────────────────────────────────────────────────────────────────┘\n   */\n  private publishForRetry(\n    msg: ConsumeMessage,\n    consumer: ConsumerDefinition,\n    newRetryCount: number,\n    delayMs: number,\n    error: Error,\n  ): Future<Result<void, TechnicalError>> {\n    const queueName = consumer.queue.name;\n    const deadLetter = consumer.queue.deadLetter;\n\n    if (!deadLetter) {\n      this.logger?.warn(\n        \"Cannot retry: queue does not have DLX configured, falling back to nack with requeue\",\n        {\n          queueName,\n        },\n      );\n      this.amqpClient.nack(msg, false, true);\n      return Future.value(Result.Ok(undefined));\n    }\n\n    const dlxName = deadLetter.exchange.name;\n    const waitRoutingKey = `${queueName}-wait`;\n\n    // Acknowledge original message\n    this.amqpClient.ack(msg);\n\n    const content = this.parseMessageContentForRetry(msg, queueName);\n\n    // Publish to DLX with wait routing key\n    return this.amqpClient\n      .publish(dlxName, waitRoutingKey, content, {\n        ...msg.properties,\n        expiration: delayMs.toString(), // Per-message TTL\n        headers: {\n          ...msg.properties.headers,\n          \"x-retry-count\": newRetryCount,\n          \"x-last-error\": error.message,\n          \"x-first-failure-timestamp\":\n            msg.properties.headers?.[\"x-first-failure-timestamp\"] ?? Date.now(),\n        },\n      })\n      .mapOkToResult((published) => {\n        if (!published) {\n          this.logger?.error(\"Failed to publish message for retry (write buffer full)\", {\n            queueName,\n            waitRoutingKey,\n            retryCount: newRetryCount,\n          });\n          return Result.Error(\n            new TechnicalError(\"Failed to publish message for retry (write buffer full)\"),\n          );\n        }\n\n        this.logger?.info(\"Message published for retry\", {\n          queueName,\n          waitRoutingKey,\n          retryCount: newRetryCount,\n          delayMs,\n        });\n        return Result.Ok(undefined);\n      });\n  }\n\n  /**\n   * Send message to dead letter queue.\n   * Nacks the message without requeue, relying on DLX configuration.\n   */\n  private sendToDLQ(msg: ConsumeMessage, consumer: ConsumerDefinition): void {\n    const queueName = consumer.queue.name;\n    const hasDeadLetter = consumer.queue.deadLetter !== undefined;\n\n    if (!hasDeadLetter) {\n      this.logger?.warn(\"Queue does not have DLX configured - message will be lost on nack\", {\n        queueName,\n      });\n    }\n\n    this.logger?.info(\"Sending message to DLQ\", {\n      queueName,\n      deliveryTag: msg.fields.deliveryTag,\n    });\n\n    // Nack without requeue - relies on DLX configuration\n    this.amqpClient.nack(msg, false, false);\n  }\n}\n","import type { ContractDefinition, InferConsumerNames } from \"@amqp-contract/contract\";\nimport type {\n  WorkerInferConsumerHandler,\n  WorkerInferConsumerHandlerEntry,\n  WorkerInferConsumerHandlers,\n} from \"./types.js\";\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * Validate that a consumer exists in the contract\n */\nfunction validateConsumerExists<TContract extends ContractDefinition>(\n  contract: TContract,\n  consumerName: string,\n): void {\n  const consumers = contract.consumers;\n\n  if (!consumers || !(consumerName in consumers)) {\n    const availableConsumers = consumers ? Object.keys(consumers) : [];\n    const available = availableConsumers.length > 0 ? availableConsumers.join(\", \") : \"none\";\n    throw new Error(\n      `Consumer \"${consumerName}\" not found in contract. Available consumers: ${available}`,\n    );\n  }\n}\n\n/**\n * Validate that all handlers reference valid consumers\n */\nfunction validateHandlers<TContract extends ContractDefinition>(\n  contract: TContract,\n  handlers: Record<string, unknown>,\n): void {\n  const consumers = contract.consumers;\n  const availableConsumers = Object.keys(consumers ?? {});\n  const availableConsumerNames =\n    availableConsumers.length > 0 ? availableConsumers.join(\", \") : \"none\";\n\n  for (const handlerName of Object.keys(handlers)) {\n    if (!consumers || !(handlerName in consumers)) {\n      throw new Error(\n        `Consumer \"${handlerName}\" not found in contract. Available consumers: ${availableConsumerNames}`,\n      );\n    }\n  }\n}\n\n// =============================================================================\n// Handler Definitions\n// =============================================================================\n\n/**\n * Define a type-safe handler for a specific consumer in a contract.\n *\n * **Recommended:** This function creates handlers that return `Future<Result<void, HandlerError>>`,\n * providing explicit error handling and better control over retry behavior.\n *\n * Supports two patterns:\n * 1. Simple handler: just the function\n * 2. Handler with options: [handler, { prefetch: 10 }]\n *\n * @template TContract - The contract definition type\n * @template TName - The consumer name from the contract\n * @param contract - The contract definition containing the consumer\n * @param consumerName - The name of the consumer from the contract\n * @param handler - The handler function that returns `Future<Result<void, HandlerError>>`\n * @param options - Optional consumer options (prefetch)\n * @returns A type-safe handler that can be used with TypedAmqpWorker\n *\n * @example\n * ```typescript\n * import { defineHandler, RetryableError, NonRetryableError } from '@amqp-contract/worker';\n * import { Future, Result } from '@swan-io/boxed';\n * import { orderContract } from './contract';\n *\n * // Simple handler with explicit error handling using mapError\n * const processOrderHandler = defineHandler(\n *   orderContract,\n *   'processOrder',\n *   ({ payload }) =>\n *     Future.fromPromise(processPayment(payload))\n *       .mapOk(() => undefined)\n *       .mapError((error) => new RetryableError('Payment failed', error))\n * );\n *\n * // Handler with validation (non-retryable error)\n * const validateOrderHandler = defineHandler(\n *   orderContract,\n *   'validateOrder',\n *   ({ payload }) => {\n *     if (payload.amount < 1) {\n *       // Won't be retried - goes directly to DLQ\n *       return Future.value(Result.Error(new NonRetryableError('Invalid order amount')));\n *     }\n *     return Future.value(Result.Ok(undefined));\n *   }\n * );\n * ```\n */\nexport function defineHandler<\n  TContract extends ContractDefinition,\n  TName extends InferConsumerNames<TContract>,\n>(\n  contract: TContract,\n  consumerName: TName,\n  handler: WorkerInferConsumerHandler<TContract, TName>,\n): WorkerInferConsumerHandlerEntry<TContract, TName>;\nexport function defineHandler<\n  TContract extends ContractDefinition,\n  TName extends InferConsumerNames<TContract>,\n>(\n  contract: TContract,\n  consumerName: TName,\n  handler: WorkerInferConsumerHandler<TContract, TName>,\n  options: { prefetch?: number },\n): WorkerInferConsumerHandlerEntry<TContract, TName>;\nexport function defineHandler<\n  TContract extends ContractDefinition,\n  TName extends InferConsumerNames<TContract>,\n>(\n  contract: TContract,\n  consumerName: TName,\n  handler: WorkerInferConsumerHandler<TContract, TName>,\n  options?: { prefetch?: number },\n): WorkerInferConsumerHandlerEntry<TContract, TName> {\n  validateConsumerExists(contract, String(consumerName));\n\n  if (options) {\n    return [handler, options];\n  }\n  return handler;\n}\n\n/**\n * Define multiple type-safe handlers for consumers in a contract.\n *\n * **Recommended:** This function creates handlers that return `Future<Result<void, HandlerError>>`,\n * providing explicit error handling and better control over retry behavior.\n *\n * @template TContract - The contract definition type\n * @param contract - The contract definition containing the consumers\n * @param handlers - An object with handler functions for each consumer\n * @returns A type-safe handlers object that can be used with TypedAmqpWorker\n *\n * @example\n * ```typescript\n * import { defineHandlers, RetryableError } from '@amqp-contract/worker';\n * import { Future } from '@swan-io/boxed';\n * import { orderContract } from './contract';\n *\n * const handlers = defineHandlers(orderContract, {\n *   processOrder: ({ payload }) =>\n *     Future.fromPromise(processPayment(payload))\n *       .mapOk(() => undefined)\n *       .mapError((error) => new RetryableError('Payment failed', error)),\n *   notifyOrder: ({ payload }) =>\n *     Future.fromPromise(sendNotification(payload))\n *       .mapOk(() => undefined)\n *       .mapError((error) => new RetryableError('Notification failed', error)),\n * });\n * ```\n */\nexport function defineHandlers<TContract extends ContractDefinition>(\n  contract: TContract,\n  handlers: WorkerInferConsumerHandlers<TContract>,\n): WorkerInferConsumerHandlers<TContract> {\n  validateHandlers(contract, handlers as unknown as Record<string, unknown>);\n  return handlers;\n}\n"],"mappings":";;;;;;;;;;AAGA,IAAa,yBAAb,cAA4C,MAAM;CAChD,YACE,AAAgB,cAChB,AAAgB,QAChB;AACA,QAAM,2CAA2C,aAAa,GAAG;EAHjD;EACA;AAGhB,OAAK,OAAO;EAEZ,MAAM,mBAAmB;AAGzB,MAAI,OAAO,iBAAiB,sBAAsB,WAChD,kBAAiB,kBAAkB,MAAM,KAAK,YAAY;;;;;;;;;;AAYhE,IAAa,iBAAb,cAAoC,MAAM;CACxC,YACE,SACA,AAAyB,OACzB;AACA,QAAM,QAAQ;EAFW;AAGzB,OAAK,OAAO;EAEZ,MAAM,mBAAmB;AAGzB,MAAI,OAAO,iBAAiB,sBAAsB,WAChD,kBAAiB,kBAAkB,MAAM,KAAK,YAAY;;;;;;;;;;AAYhE,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YACE,SACA,AAAyB,OACzB;AACA,QAAM,QAAQ;EAFW;AAGzB,OAAK,OAAO;EAEZ,MAAM,mBAAmB;AAGzB,MAAI,OAAO,iBAAiB,sBAAsB,WAChD,kBAAiB,kBAAkB,MAAM,KAAK,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;AAsChE,SAAgB,iBAAiB,OAAyC;AACxE,QAAO,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;AAwB1B,SAAgB,oBAAoB,OAA4C;AAC9E,QAAO,iBAAiB;;;;;;;;;;;;;;;;;;;;AAqB1B,SAAgB,eAAe,OAAuC;AACpE,QAAO,iBAAiB,MAAM,IAAI,oBAAoB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;AA+B9D,SAAgB,UAAU,SAAiB,OAAiC;AAC1E,QAAO,IAAI,eAAe,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6B3C,SAAgB,aAAa,SAAiB,OAAoC;AAChF,QAAO,IAAI,kBAAkB,SAAS,MAAM;;;;;AC9M9C,MAAM,cAAc,UAAU,OAAO;AACrC,MAAM,eAAe,UAAU,QAAQ;;;;AAKvC,MAAM,sBAAsB,CAAC,QAAQ,UAAU;;;;AAU/C,SAAS,oBAAoB,UAAiD;AAC5E,QAAO,oBAAoB,SAAS,SAAS,aAAa,CAAsB;;;;;;;;;;;AAYlF,SAAgB,iBACd,QACA,iBACwC;AACxC,KAAI,CAAC,gBACH,QAAO,OAAO,MAAM,OAAO,GAAG,OAAO,CAAC;CAGxC,MAAM,qBAAqB,gBAAgB,aAAa;AAExD,KAAI,CAAC,oBAAoB,mBAAmB,CAC1C,QAAO,OAAO,MACZ,OAAO,MACL,IAAI,eACF,kCAAkC,gBAAgB,8BACpB,oBAAoB,KAAK,KAAK,CAAC,8CAE9D,CACF,CACF;AAGH,SAAQ,oBAAR;EACE,KAAK,OACH,QAAO,OAAO,YAAY,YAAY,OAAO,CAAC,CAAC,UAC5C,UAAU,IAAI,eAAe,6BAA6B,MAAM,CAClE;EACH,KAAK,UACH,QAAO,OAAO,YAAY,aAAa,OAAO,CAAC,CAAC,UAC7C,UAAU,IAAI,eAAe,gCAAgC,MAAM,CACrE;;;;;;;;;ACVP,SAAS,eAAe,OAAqD;AAC3E,QAAO,MAAM,QAAQ,MAAM,IAAI,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsGlD,IAAa,kBAAb,MAAa,gBAAsD;;;;CAIjE,AAAiB;CAMjB,AAAiB;CACjB,AAAiB,+BAA4B,IAAI,KAAK;CACtD,AAAiB;CAEjB,AAAQ,YACN,AAAiB,UACjB,AAAiB,YACjB,UACA,AAAiB,QACjB,WACA;EALiB;EACA;EAEA;AAGjB,OAAK,YAAY,aAAa;AAG9B,OAAK,iBAAiB,EAAE;AACxB,OAAK,kBAAkB,EAAE;EAGzB,MAAM,iBAAiB;AAEvB,OAAK,MAAM,gBAAgB,OAAO,KAAK,eAAe,EAAE;GACtD,MAAM,eAAe,eAAe;GACpC,MAAM,oBAAoB;AAE1B,OAAI,eAAe,aAAa,EAAE;IAEhC,MAAM,CAAC,SAAS,WAAW;AAC3B,SAAK,eAAe,qBAAqB;AAIzC,SAAK,gBAAgB,qBAAqB;SAG1C,MAAK,eAAe,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC/C,OAAO,OAA6C,EAClD,UACA,UACA,MACA,mBACA,QACA,aAC6F;EAC7F,MAAM,SAAS,IAAI,gBACjB,UACA,IAAI,WAAW,UAAU;GACvB;GACA;GACD,CAAC,EACF,UACA,QACA,UACD;AAID,SAAO,OACJ,wBAAwB,CACxB,gBAAgB,OAAO,YAAY,CAAC,CACpC,YAAY,OAAO;;;;;;;;;;;;;;;;;;CAmBxB,QAA8C;AAC5C,SAAO,OAAO,IACZ,MAAM,KAAK,KAAK,aAAa,CAAC,KAAK,gBACjC,KAAK,WAAW,OAAO,YAAY,CAAC,kBAAkB,UAAU;AAC9D,QAAK,QAAQ,KAAK,0CAA0C;IAAE;IAAa;IAAO,CAAC;AACnF,UAAO,OAAO,GAAG,OAAU;IAC3B,CACH,CACF,CACE,IAAI,OAAO,IAAI,CACf,YAAY;AAEX,QAAK,aAAa,OAAO;IACzB,CACD,gBAAgB,KAAK,WAAW,OAAO,CAAC,CACxC,YAAY,OAAU;;;;;;CAO3B,AAAQ,0BAA0B,UAAmD;AACnF,SAAO,SAAS,MAAM;;;;;;CAOxB,AAAQ,aAAmD;EACzD,MAAM,YAAY,KAAK,SAAS;EAChC,MAAM,gBAAgB,OAAO,KAAK,UAAU;EAG5C,MAAM,cAAc,cAAc,QAAQ,KAAK,SAAS;GACtD,MAAM,WAAW,KAAK,gBAAgB,OAAO;AAC7C,UAAO,WAAW,KAAK,IAAI,KAAK,SAAS,GAAG;KAC3C,EAAE;AAEL,MAAI,cAAc,EAChB,MAAK,WAAW,SAAS,OAAO,YAAqB;AACnD,SAAM,QAAQ,SAAS,YAAY;IACnC;AAGJ,SAAO,OAAO,IAAI,cAAc,KAAK,SAAS,KAAK,QAAQ,KAAK,CAAC,CAAC,CAC/D,IAAI,OAAO,IAAI,CACf,YAAY,OAAU;;CAG3B,AAAQ,yBAA+D;AACrE,SAAO,KAAK,WAAW,gBAAgB;;;;;;CAOzC,AAAQ,QACN,cACsC;EAEtC,MAAM,gBAAgB,KAAK,SAAS,UAAW;EAC/C,MAAM,WAAW,gBAAgB,cAAc;EAC/C,MAAM,UAAU,KAAK,eAAe;AAEpC,SAAO,KAAK,cACV,cACA,UACA,QACD;;;;;CAMH,AAAQ,eACN,QACA,MACA,SACA,KACyC;EACzC,MAAM,gBAAgB,OAAO,aAAa,SAAS,KAAK;EACxD,MAAM,oBACJ,yBAAyB,UAAU,gBAAgB,QAAQ,QAAQ,cAAc;AAEnF,SAAO,OAAO,YAAY,kBAAkB,CACzC,UAAU,UAAU,IAAI,eAAe,oBAAoB,QAAQ,SAAS,MAAM,CAAC,CACnF,eAAe,WAAW;AACzB,OAAI,OAAO,OACT,QAAO,OAAO,MACZ,IAAI,eACF,GAAG,QAAQ,MAAM,qBACjB,IAAI,uBAAuB,QAAQ,cAAc,OAAO,OAAO,CAChE,CACF;AAEH,UAAO,OAAO,GAAG,OAAO,MAAM;IAC9B,CACD,UAAU,UAAU;AACnB,QAAK,QAAQ,MAAM,GAAG,QAAQ,MAAM,qBAAqB;IACvD,cAAc,QAAQ;IACtB,WAAW,QAAQ;IACnB;IACD,CAAC;AACF,QAAK,WAAW,KAAK,KAAK,OAAO,MAAM;IACvC;;;;;;CAON,AAAQ,wBACN,KACA,UACA,cAC8E;EAC9E,MAAM,UAAU;GACd,cAAc,OAAO,aAAa;GAClC,WAAW,SAAS,MAAM;GAC3B;EAED,MAAM,gBAAgB,SAAiB,UAAoC;AACzE,QAAK,QAAQ,MAAM,SAAS;IAAE,GAAG;IAAS;IAAO,CAAC;AAClD,QAAK,WAAW,KAAK,KAAK,OAAO,MAAM;AACvC,UAAO,IAAI,eAAe,SAAS,MAAM;;EAI3C,MAAM,eAAe,iBAAiB,IAAI,SAAS,IAAI,WAAW,gBAAgB,CAC/E,UAAU,UAAU;AACnB,QAAK,QAAQ,MAAM,gCAAgC;IAAE,GAAG;IAAS;IAAO,CAAC;AACzE,QAAK,WAAW,KAAK,KAAK,OAAO,MAAM;IACvC,CACD,eAAe,WACd,OAAO,oBAAoB,KAAK,MAAM,OAAO,UAAU,CAAC,CAAY,CAAC,UAAU,UAC7E,aAAa,wBAAwB,MAAM,CAC5C,CACF,CACA,WAAW,WACV,KAAK,eACH,SAAS,QAAQ,SACjB,QACA;GAAE,GAAG;GAAS,OAAO;GAAW,EAChC,IACD,CACF;EAGH,MAAM,eAAe,SAAS,QAAQ,UAClC,KAAK,eACH,SAAS,QAAQ,SACjB,IAAI,WAAW,WAAW,EAAE,EAC5B;GAAE,GAAG;GAAS,OAAO;GAAW,EAChC,IACD,GACD,OAAO,MAAM,OAAO,GAA4B,OAAU,CAAC;AAE/D,SAAO,OAAO,YAAY;GAAE,SAAS;GAAc,SAAS;GAAc,CAAC,CAAC,IAC1E,OAAO,YACR;;;;;CAMH,AAAQ,cACN,cACA,UACA,SAIsC;EACtC,MAAM,YAAY,SAAS,MAAM;AAGjC,SAAO,KAAK,WACT,QAAQ,WAAW,OAAO,QAAQ;AAEjC,OAAI,QAAQ,MAAM;AAChB,SAAK,QAAQ,KAAK,gCAAgC;KAChD,cAAc,OAAO,aAAa;KAClC;KACD,CAAC;AACF;;GAGF,MAAM,YAAY,KAAK,KAAK;GAC5B,MAAM,OAAO,iBAAiB,KAAK,WAAW,WAAW,OAAO,aAAa,EAAE,EAC7E,2CAA2C,IAAI,OAAO,aACvD,CAAC;AAGF,SAAM,KAAK,wBAAwB,KAAK,UAAU,aAAa,CAC5D,WAAW,qBACV,QAAQ,kBAAkB,IAAI,CAC3B,gBAAgB;AACf,SAAK,QAAQ,KAAK,iCAAiC;KACjD,cAAc,OAAO,aAAa;KAClC;KACD,CAAC;AAEF,SAAK,WAAW,IAAI,IAAI;IAGxB,MAAM,aAAa,KAAK,KAAK,GAAG;AAChC,mBAAe,KAAK;AACpB,wBACE,KAAK,WACL,WACA,OAAO,aAAa,EACpB,MACA,WACD;AAED,WAAO,OAAO,MAAM,OAAO,GAAuB,OAAU,CAAC;KAC7D,CACD,cAAc,iBAA+B;AAE5C,SAAK,QAAQ,MAAM,4BAA4B;KAC7C,cAAc,OAAO,aAAa;KAClC;KACA,WAAW,aAAa;KACxB,OAAO,aAAa;KACrB,CAAC;IAGF,MAAM,aAAa,KAAK,KAAK,GAAG;AAChC,iBAAa,MAAM,aAAa;AAChC,wBACE,KAAK,WACL,WACA,OAAO,aAAa,EACpB,OACA,WACD;AAGD,WAAO,KAAK,YAAY,cAAc,KAAK,OAAO,aAAa,EAAE,SAAS;KAC1E,CACL,CACA,eAAe;IAId,MAAM,aAAa,KAAK,KAAK,GAAG;AAChC,iBAAa,sBAAM,IAAI,MAAM,4BAA4B,CAAC;AAC1D,wBAAoB,KAAK,WAAW,WAAW,OAAO,aAAa,EAAE,OAAO,WAAW;KACvF,CACD,WAAW;IACd,CACD,OAAO,gBAAgB;AAEtB,QAAK,aAAa,IAAI,YAAY;IAClC,CACD,UACE,UACC,IAAI,eAAe,kCAAkC,OAAO,aAAa,CAAC,IAAI,MAAM,CACvF,CACA,YAAY,OAAU;;;;;;;;;;;;;;;;;;;CAoB3B,AAAQ,YACN,OACA,KACA,cACA,UACsC;AAEtC,MAAI,iBAAiB,mBAAmB;AACtC,QAAK,QAAQ,MAAM,mDAAmD;IACpE;IACA,WAAW,MAAM;IACjB,OAAO,MAAM;IACd,CAAC;AACF,QAAK,UAAU,KAAK,SAAS;AAC7B,UAAO,OAAO,MAAM,OAAO,GAAG,OAAU,CAAC;;EAI3C,MAAM,SAAS,KAAK,0BAA0B,SAAS;AAGvD,MAAI,OAAO,SAAS,gBAClB,QAAO,KAAK,wBAAwB,OAAO,KAAK,cAAc,SAAS;AAIzE,SAAO,KAAK,sBAAsB,OAAO,KAAK,cAAc,UAAU,OAAO;;;;;;;;;;;CAY/E,AAAQ,wBACN,OACA,KACA,cACA,UACsC;EACtC,MAAM,QAAQ,SAAS;EACvB,MAAM,YAAY,MAAM;EAGxB,MAAM,gBAAiB,IAAI,WAAW,UAAU,uBAAkC;EAElF,MAAM,gBAAgB,MAAM,SAAS,WAAW,MAAM,gBAAgB;EAKtE,MAAM,2BACJ,kBAAkB,SAAY,KAAK,IAAI,GAAG,gBAAgB,gBAAgB,EAAE,GAAG;AAGjF,MAAI,kBAAkB,UAAa,iBAAiB,gBAAgB,EAClE,MAAK,QAAQ,KAAK,0DAA0D;GAC1E;GACA;GACA;GACA;GACA,6BAA6B,kBAAkB,gBAAgB;GAC/D,sBAAsB,iBAAiB;GACvC,OAAO,MAAM;GACd,CAAC;MAEF,MAAK,QAAQ,KAAK,yCAAyC;GACzD;GACA;GACA;GACA;GACA;GACA,OAAO,MAAM;GACd,CAAC;AAIJ,OAAK,WAAW,KAAK,KAAK,OAAO,KAAK;AACtC,SAAO,OAAO,MAAM,OAAO,GAAG,OAAU,CAAC;;;;;CAM3C,AAAQ,sBACN,OACA,KACA,cACA,UACA,QACsC;EAEtC,MAAM,aAAc,IAAI,WAAW,UAAU,oBAA+B;AAG5E,MAAI,cAAc,OAAO,YAAY;AACnC,QAAK,QAAQ,MAAM,wCAAwC;IACzD;IACA;IACA,YAAY,OAAO;IACnB,OAAO,MAAM;IACd,CAAC;AACF,QAAK,UAAU,KAAK,SAAS;AAC7B,UAAO,OAAO,MAAM,OAAO,GAAG,OAAU,CAAC;;EAI3C,MAAM,UAAU,KAAK,oBAAoB,YAAY,OAAO;AAC5D,OAAK,QAAQ,KAAK,uCAAuC;GACvD;GACA,YAAY,aAAa;GACzB;GACA,OAAO,MAAM;GACd,CAAC;AAEF,SAAO,KAAK,gBAAgB,KAAK,UAAU,aAAa,GAAG,SAAS,MAAM;;;;;CAM5E,AAAQ,oBAAoB,YAAoB,QAAgD;EAC9F,MAAM,EAAE,gBAAgB,YAAY,mBAAmB,WAAW;EAElE,IAAI,QAAQ,KAAK,IAAI,iBAAiB,KAAK,IAAI,mBAAmB,WAAW,EAAE,WAAW;AAE1F,MAAI,OAEF,SAAQ,SAAS,KAAM,KAAK,QAAQ,GAAG;AAGzC,SAAO,KAAK,MAAM,MAAM;;;;;;CAO1B,AAAQ,4BAA4B,KAAqB,WAAqC;EAC5F,IAAI,UAA4B,IAAI;AAGpC,MAAI,CAAC,IAAI,WAAW,gBAClB,KAAI;AACF,aAAU,KAAK,MAAM,IAAI,QAAQ,UAAU,CAAC;WACrC,KAAK;AACZ,QAAK,QAAQ,KAAK,4DAA4D;IAC5E;IACA,OAAO;IACR,CAAC;;AAIN,SAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BT,AAAQ,gBACN,KACA,UACA,eACA,SACA,OACsC;EACtC,MAAM,YAAY,SAAS,MAAM;EACjC,MAAM,aAAa,SAAS,MAAM;AAElC,MAAI,CAAC,YAAY;AACf,QAAK,QAAQ,KACX,uFACA,EACE,WACD,CACF;AACD,QAAK,WAAW,KAAK,KAAK,OAAO,KAAK;AACtC,UAAO,OAAO,MAAM,OAAO,GAAG,OAAU,CAAC;;EAG3C,MAAM,UAAU,WAAW,SAAS;EACpC,MAAM,iBAAiB,GAAG,UAAU;AAGpC,OAAK,WAAW,IAAI,IAAI;EAExB,MAAM,UAAU,KAAK,4BAA4B,KAAK,UAAU;AAGhE,SAAO,KAAK,WACT,QAAQ,SAAS,gBAAgB,SAAS;GACzC,GAAG,IAAI;GACP,YAAY,QAAQ,UAAU;GAC9B,SAAS;IACP,GAAG,IAAI,WAAW;IAClB,iBAAiB;IACjB,gBAAgB,MAAM;IACtB,6BACE,IAAI,WAAW,UAAU,gCAAgC,KAAK,KAAK;IACtE;GACF,CAAC,CACD,eAAe,cAAc;AAC5B,OAAI,CAAC,WAAW;AACd,SAAK,QAAQ,MAAM,2DAA2D;KAC5E;KACA;KACA,YAAY;KACb,CAAC;AACF,WAAO,OAAO,MACZ,IAAI,eAAe,0DAA0D,CAC9E;;AAGH,QAAK,QAAQ,KAAK,+BAA+B;IAC/C;IACA;IACA,YAAY;IACZ;IACD,CAAC;AACF,UAAO,OAAO,GAAG,OAAU;IAC3B;;;;;;CAON,AAAQ,UAAU,KAAqB,UAAoC;EACzE,MAAM,YAAY,SAAS,MAAM;AAGjC,MAAI,EAFkB,SAAS,MAAM,eAAe,QAGlD,MAAK,QAAQ,KAAK,qEAAqE,EACrF,WACD,CAAC;AAGJ,OAAK,QAAQ,KAAK,0BAA0B;GAC1C;GACA,aAAa,IAAI,OAAO;GACzB,CAAC;AAGF,OAAK,WAAW,KAAK,KAAK,OAAO,MAAM;;;;;;;;;AC9yB3C,SAAS,uBACP,UACA,cACM;CACN,MAAM,YAAY,SAAS;AAE3B,KAAI,CAAC,aAAa,EAAE,gBAAgB,YAAY;EAC9C,MAAM,qBAAqB,YAAY,OAAO,KAAK,UAAU,GAAG,EAAE;EAClE,MAAM,YAAY,mBAAmB,SAAS,IAAI,mBAAmB,KAAK,KAAK,GAAG;AAClF,QAAM,IAAI,MACR,aAAa,aAAa,gDAAgD,YAC3E;;;;;;AAOL,SAAS,iBACP,UACA,UACM;CACN,MAAM,YAAY,SAAS;CAC3B,MAAM,qBAAqB,OAAO,KAAK,aAAa,EAAE,CAAC;CACvD,MAAM,yBACJ,mBAAmB,SAAS,IAAI,mBAAmB,KAAK,KAAK,GAAG;AAElE,MAAK,MAAM,eAAe,OAAO,KAAK,SAAS,CAC7C,KAAI,CAAC,aAAa,EAAE,eAAe,WACjC,OAAM,IAAI,MACR,aAAa,YAAY,gDAAgD,yBAC1E;;AA0EP,SAAgB,cAId,UACA,cACA,SACA,SACmD;AACnD,wBAAuB,UAAU,OAAO,aAAa,CAAC;AAEtD,KAAI,QACF,QAAO,CAAC,SAAS,QAAQ;AAE3B,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCT,SAAgB,eACd,UACA,UACwC;AACxC,kBAAiB,UAAU,SAA+C;AAC1E,QAAO"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/decompression.ts","../src/worker.ts","../src/handlers.ts"],"sourcesContent":["export { MessageValidationError } from \"@amqp-contract/core\";\n\n/**\n * Retryable errors - transient failures that may succeed on retry\n * Examples: network timeouts, rate limiting, temporary service unavailability\n *\n * Use this error type when the operation might succeed if retried.\n * The worker will apply exponential backoff and retry the message.\n */\nexport class RetryableError extends Error {\n  constructor(\n    message: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"RetryableError\";\n    // Node.js specific stack trace capture\n    const ErrorConstructor = Error as unknown as {\n      captureStackTrace?: (target: object, constructor: Function) => void;\n    };\n    if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n      ErrorConstructor.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Non-retryable errors - permanent failures that should not be retried\n * Examples: invalid data, business rule violations, permanent external failures\n *\n * Use this error type when retrying would not help - the message will be\n * immediately sent to the dead letter queue (DLQ) if configured.\n */\nexport class NonRetryableError extends Error {\n  constructor(\n    message: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"NonRetryableError\";\n    // Node.js specific stack trace capture\n    const ErrorConstructor = Error as unknown as {\n      captureStackTrace?: (target: object, constructor: Function) => void;\n    };\n    if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n      ErrorConstructor.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Union type representing all handler errors.\n * Use this type when defining handlers that explicitly signal error outcomes.\n */\nexport type HandlerError = RetryableError | NonRetryableError;\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Type guard to check if an error is a RetryableError.\n *\n * Use this to check error types in catch blocks or error handlers.\n *\n * @param error - The error to check\n * @returns True if the error is a RetryableError\n *\n * @example\n * ```typescript\n * import { isRetryableError } from '@amqp-contract/worker';\n *\n * try {\n *   await processMessage();\n * } catch (error) {\n *   if (isRetryableError(error)) {\n *     console.log('Will retry:', error.message);\n *   } else {\n *     console.log('Permanent failure:', error);\n *   }\n * }\n * ```\n */\nexport function isRetryableError(error: unknown): error is RetryableError {\n  return error instanceof RetryableError;\n}\n\n/**\n * Type guard to check if an error is a NonRetryableError.\n *\n * Use this to check error types in catch blocks or error handlers.\n *\n * @param error - The error to check\n * @returns True if the error is a NonRetryableError\n *\n * @example\n * ```typescript\n * import { isNonRetryableError } from '@amqp-contract/worker';\n *\n * try {\n *   await processMessage();\n * } catch (error) {\n *   if (isNonRetryableError(error)) {\n *     console.log('Will not retry:', error.message);\n *   }\n * }\n * ```\n */\nexport function isNonRetryableError(error: unknown): error is NonRetryableError {\n  return error instanceof NonRetryableError;\n}\n\n/**\n * Type guard to check if an error is any HandlerError (RetryableError or NonRetryableError).\n *\n * @param error - The error to check\n * @returns True if the error is a HandlerError\n *\n * @example\n * ```typescript\n * import { isHandlerError } from '@amqp-contract/worker';\n *\n * function handleError(error: unknown) {\n *   if (isHandlerError(error)) {\n *     // error is RetryableError | NonRetryableError\n *     console.log('Handler error:', error.name, error.message);\n *   }\n * }\n * ```\n */\nexport function isHandlerError(error: unknown): error is HandlerError {\n  return isRetryableError(error) || isNonRetryableError(error);\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Create a RetryableError with less verbosity.\n *\n * This is a shorthand factory function for creating RetryableError instances.\n * Use it for cleaner error creation in handlers.\n *\n * @param message - Error message describing the failure\n * @param cause - Optional underlying error that caused this failure\n * @returns A new RetryableError instance\n *\n * @example\n * ```typescript\n * import { retryable } from '@amqp-contract/worker';\n * import { Future, Result } from '@swan-io/boxed';\n *\n * const handler = ({ payload }) =>\n *   Future.fromPromise(processPayment(payload))\n *     .mapOk(() => undefined)\n *     .mapError((e) => retryable('Payment service unavailable', e));\n *\n * // Equivalent to:\n * // .mapError((e) => new RetryableError('Payment service unavailable', e));\n * ```\n */\nexport function retryable(message: string, cause?: unknown): RetryableError {\n  return new RetryableError(message, cause);\n}\n\n/**\n * Create a NonRetryableError with less verbosity.\n *\n * This is a shorthand factory function for creating NonRetryableError instances.\n * Use it for cleaner error creation in handlers.\n *\n * @param message - Error message describing the failure\n * @param cause - Optional underlying error that caused this failure\n * @returns A new NonRetryableError instance\n *\n * @example\n * ```typescript\n * import { nonRetryable } from '@amqp-contract/worker';\n * import { Future, Result } from '@swan-io/boxed';\n *\n * const handler = ({ payload }) => {\n *   if (!isValidPayload(payload)) {\n *     return Future.value(Result.Error(nonRetryable('Invalid payload format')));\n *   }\n *   return Future.value(Result.Ok(undefined));\n * };\n *\n * // Equivalent to:\n * // return Future.value(Result.Error(new NonRetryableError('Invalid payload format')));\n * ```\n */\nexport function nonRetryable(message: string, cause?: unknown): NonRetryableError {\n  return new NonRetryableError(message, cause);\n}\n","import { Future, Result } from \"@swan-io/boxed\";\nimport { gunzip, inflate } from \"node:zlib\";\nimport { TechnicalError } from \"@amqp-contract/core\";\nimport { promisify } from \"node:util\";\n\nconst gunzipAsync = promisify(gunzip);\nconst inflateAsync = promisify(inflate);\n\n/**\n * Supported content encodings for message decompression.\n */\nconst SUPPORTED_ENCODINGS = [\"gzip\", \"deflate\"] as const;\n\n/**\n * Type for supported content encodings.\n */\ntype SupportedEncoding = (typeof SUPPORTED_ENCODINGS)[number];\n\n/**\n * Type guard to check if a string is a supported encoding.\n */\nfunction isSupportedEncoding(encoding: string): encoding is SupportedEncoding {\n  return SUPPORTED_ENCODINGS.includes(encoding.toLowerCase() as SupportedEncoding);\n}\n\n/**\n * Decompress a buffer based on the content-encoding header.\n *\n * @param buffer - The buffer to decompress\n * @param contentEncoding - The content-encoding header value (e.g., 'gzip', 'deflate')\n * @returns A Future with the decompressed buffer or a TechnicalError\n *\n * @internal\n */\nexport function decompressBuffer(\n  buffer: Buffer,\n  contentEncoding: string | undefined,\n): Future<Result<Buffer, TechnicalError>> {\n  if (!contentEncoding) {\n    return Future.value(Result.Ok(buffer));\n  }\n\n  const normalizedEncoding = contentEncoding.toLowerCase();\n\n  if (!isSupportedEncoding(normalizedEncoding)) {\n    return Future.value(\n      Result.Error(\n        new TechnicalError(\n          `Unsupported content-encoding: \"${contentEncoding}\". ` +\n            `Supported encodings are: ${SUPPORTED_ENCODINGS.join(\", \")}. ` +\n            `Please check your publisher configuration.`,\n        ),\n      ),\n    );\n  }\n\n  switch (normalizedEncoding) {\n    case \"gzip\":\n      return Future.fromPromise(gunzipAsync(buffer)).mapError(\n        (error) => new TechnicalError(\"Failed to decompress gzip\", error),\n      );\n    case \"deflate\":\n      return Future.fromPromise(inflateAsync(buffer)).mapError(\n        (error) => new TechnicalError(\"Failed to decompress deflate\", error),\n      );\n  }\n}\n","import {\n  AmqpClient,\n  type Logger,\n  TechnicalError,\n  type TelemetryProvider,\n  defaultTelemetryProvider,\n  endSpanError,\n  endSpanSuccess,\n  recordConsumeMetric,\n  startConsumeSpan,\n} from \"@amqp-contract/core\";\nimport type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\nimport type { Channel, ConsumeMessage } from \"amqplib\";\nimport {\n  type ConsumerDefinition,\n  type ContractDefinition,\n  type InferConsumerNames,\n  type ResolvedRetryOptions,\n  type ResolvedTtlBackoffRetryOptions,\n  extractConsumer,\n} from \"@amqp-contract/contract\";\nimport { Future, Result } from \"@swan-io/boxed\";\nimport { MessageValidationError, NonRetryableError } from \"./errors.js\";\nimport type {\n  WorkerInferConsumedMessage,\n  WorkerInferConsumerHandler,\n  WorkerInferConsumerHandlers,\n} from \"./types.js\";\nimport type { HandlerError } from \"./errors.js\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { decompressBuffer } from \"./decompression.js\";\n\n/**\n * Internal type for consumer options extracted from handler tuples.\n * Not exported - options are specified inline in the handler tuple types.\n *\n * Note: Retry configuration is now defined at the queue level in the contract,\n * not at the handler level. See `QueueDefinition.retry` for configuration options.\n */\ntype ConsumerOptions = {\n  /** Number of messages to prefetch */\n  prefetch?: number;\n};\n\n/**\n * Retry configuration from the contract with all values resolved.\n * This is a discriminated union on `mode` - TTL-backoff has the config fields,\n * quorum-native does not.\n */\ntype ResolvedRetryConfig = ResolvedRetryOptions;\n\n/**\n * Type guard to check if a handler entry is a tuple format [handler, options].\n */\nfunction isHandlerTuple(entry: unknown): entry is [unknown, ConsumerOptions] {\n  return Array.isArray(entry) && entry.length === 2;\n}\n\n/**\n * Options for creating a type-safe AMQP worker.\n *\n * @typeParam TContract - The contract definition type\n *\n * @example\n * ```typescript\n * const options: CreateWorkerOptions<typeof contract> = {\n *   contract: myContract,\n *   handlers: {\n *     // Simple handler\n *     processOrder: ({ payload }) => {\n *       console.log('Processing order:', payload.orderId);\n *       return Future.value(Result.Ok(undefined));\n *     },\n *     // Handler with prefetch configuration\n *     processPayment: [\n *       ({ payload }) => {\n *         console.log('Processing payment:', payload.paymentId);\n *         return Future.value(Result.Ok(undefined));\n *       },\n *       { prefetch: 10 }\n *     ]\n *   },\n *   urls: ['amqp://localhost'],\n *   connectionOptions: {\n *     heartbeatIntervalInSeconds: 30\n *   },\n *   logger: myLogger\n * };\n * ```\n *\n * Note: Retry configuration is defined at the queue level in the contract,\n * not at the handler level. See `QueueDefinition.retry` for configuration options.\n */\nexport type CreateWorkerOptions<TContract extends ContractDefinition> = {\n  /** The AMQP contract definition specifying consumers and their message schemas */\n  contract: TContract;\n  /**\n   * Handlers for each consumer defined in the contract.\n   * Handlers must return `Future<Result<void, HandlerError>>` for explicit error handling.\n   * Use defineHandler() to create handlers.\n   */\n  handlers: WorkerInferConsumerHandlers<TContract>;\n  /** AMQP broker URL(s). Multiple URLs provide failover support */\n  urls: ConnectionUrl[];\n  /** Optional connection configuration (heartbeat, reconnect settings, etc.) */\n  connectionOptions?: AmqpConnectionManagerOptions | undefined;\n  /** Optional logger for logging message consumption and errors */\n  logger?: Logger | undefined;\n  /**\n   * Optional telemetry provider for tracing and metrics.\n   * If not provided, uses the default provider which attempts to load OpenTelemetry.\n   * OpenTelemetry instrumentation is automatically enabled if @opentelemetry/api is installed.\n   */\n  telemetry?: TelemetryProvider | undefined;\n};\n\n/**\n * Type-safe AMQP worker for consuming messages from RabbitMQ.\n *\n * This class provides automatic message validation, connection management,\n * and error handling for consuming messages based on a contract definition.\n *\n * @typeParam TContract - The contract definition type\n *\n * @example\n * ```typescript\n * import { TypedAmqpWorker } from '@amqp-contract/worker';\n * import { defineQueue, defineMessage, defineContract, defineConsumer } from '@amqp-contract/contract';\n * import { z } from 'zod';\n *\n * const orderQueue = defineQueue('order-processing', { durable: true });\n * const orderMessage = defineMessage(z.object({\n *   orderId: z.string(),\n *   amount: z.number()\n * }));\n *\n * const contract = defineContract({\n *   consumers: {\n *     processOrder: defineConsumer(orderQueue, orderMessage)\n *   }\n * });\n *\n * const worker = await TypedAmqpWorker.create({\n *   contract,\n *   handlers: {\n *     processOrder: async (message) => {\n *       console.log('Processing order', message.orderId);\n *       // Process the order...\n *     }\n *   },\n *   urls: ['amqp://localhost']\n * }).resultToPromise();\n *\n * // Close when done\n * await worker.close().resultToPromise();\n * ```\n */\nexport class TypedAmqpWorker<TContract extends ContractDefinition> {\n  /**\n   * Internal handler storage - handlers returning `Future<Result>`.\n   */\n  private readonly actualHandlers: Partial<\n    Record<\n      InferConsumerNames<TContract>,\n      WorkerInferConsumerHandler<TContract, InferConsumerNames<TContract>>\n    >\n  >;\n  private readonly consumerOptions: Partial<Record<InferConsumerNames<TContract>, ConsumerOptions>>;\n  private readonly consumerTags: Set<string> = new Set();\n  private readonly telemetry: TelemetryProvider;\n\n  private constructor(\n    private readonly contract: TContract,\n    private readonly amqpClient: AmqpClient,\n    handlers: WorkerInferConsumerHandlers<TContract>,\n    private readonly logger?: Logger,\n    telemetry?: TelemetryProvider,\n  ) {\n    this.telemetry = telemetry ?? defaultTelemetryProvider;\n\n    // Extract handlers and options from the handlers object\n    this.actualHandlers = {};\n    this.consumerOptions = {};\n\n    // Cast handlers to a generic record for iteration\n    const handlersRecord = handlers as Record<string, unknown>;\n\n    for (const consumerName of Object.keys(handlersRecord)) {\n      const handlerEntry = handlersRecord[consumerName];\n      const typedConsumerName = consumerName as InferConsumerNames<TContract>;\n\n      if (isHandlerTuple(handlerEntry)) {\n        // Tuple format: [handler, options]\n        const [handler, options] = handlerEntry;\n        this.actualHandlers[typedConsumerName] = handler as WorkerInferConsumerHandler<\n          TContract,\n          InferConsumerNames<TContract>\n        >;\n        this.consumerOptions[typedConsumerName] = options;\n      } else {\n        // Direct function format\n        this.actualHandlers[typedConsumerName] = handlerEntry as WorkerInferConsumerHandler<\n          TContract,\n          InferConsumerNames<TContract>\n        >;\n      }\n    }\n  }\n\n  /**\n   * Create a type-safe AMQP worker from a contract.\n   *\n   * Connection management (including automatic reconnection) is handled internally\n   * by amqp-connection-manager via the {@link AmqpClient}. The worker will set up\n   * consumers for all contract-defined handlers asynchronously in the background\n   * once the underlying connection and channels are ready.\n   *\n   * Connections are automatically shared across clients and workers with the same\n   * URLs and connection options, following RabbitMQ best practices.\n   *\n   * @param options - Configuration options for the worker\n   * @returns A Future that resolves to a Result containing the worker or an error\n   *\n   * @example\n   * ```typescript\n   * const worker = await TypedAmqpWorker.create({\n   *   contract: myContract,\n   *   handlers: {\n   *     processOrder: async ({ payload }) => console.log('Order:', payload.orderId)\n   *   },\n   *   urls: ['amqp://localhost']\n   * }).resultToPromise();\n   * ```\n   */\n  static create<TContract extends ContractDefinition>({\n    contract,\n    handlers,\n    urls,\n    connectionOptions,\n    logger,\n    telemetry,\n  }: CreateWorkerOptions<TContract>): Future<Result<TypedAmqpWorker<TContract>, TechnicalError>> {\n    const worker = new TypedAmqpWorker(\n      contract,\n      new AmqpClient(contract, {\n        urls,\n        connectionOptions,\n      }),\n      handlers,\n      logger,\n      telemetry,\n    );\n\n    // Note: Wait queues are now created by the core package in setupAmqpTopology\n    // when the queue's retry mode is \"ttl-backoff\"\n    return worker\n      .waitForConnectionReady()\n      .flatMapOk(() => worker.consumeAll())\n      .mapOk(() => worker);\n  }\n\n  /**\n   * Close the AMQP channel and connection.\n   *\n   * This gracefully closes the connection to the AMQP broker,\n   * stopping all message consumption and cleaning up resources.\n   *\n   * @returns A Future that resolves to a Result indicating success or failure\n   *\n   * @example\n   * ```typescript\n   * const closeResult = await worker.close().resultToPromise();\n   * if (closeResult.isOk()) {\n   *   console.log('Worker closed successfully');\n   * }\n   * ```\n   */\n  close(): Future<Result<void, TechnicalError>> {\n    return Future.all(\n      Array.from(this.consumerTags).map((consumerTag) =>\n        this.amqpClient.cancel(consumerTag).mapErrorToResult((error) => {\n          this.logger?.warn(\"Failed to cancel consumer during close\", { consumerTag, error });\n          return Result.Ok(undefined);\n        }),\n      ),\n    )\n      .map(Result.all)\n      .tapOk(() => {\n        // Clear consumer tags after successful cancellation\n        this.consumerTags.clear();\n      })\n      .flatMapOk(() => this.amqpClient.close())\n      .mapOk(() => undefined);\n  }\n\n  /**\n   * Get the retry configuration for a consumer's queue.\n   * Defaults are applied in the contract's defineQueue, so we just return the config.\n   */\n  private getRetryConfigForConsumer(consumer: ConsumerDefinition): ResolvedRetryConfig {\n    return consumer.queue.retry;\n  }\n\n  /**\n   * Start consuming messages for all consumers.\n   * TypeScript guarantees consumers exist (handlers require matching consumers).\n   */\n  private consumeAll(): Future<Result<void, TechnicalError>> {\n    // Non-null assertion safe: TypeScript guarantees consumers exist (handlers require matching consumers)\n    const consumers = this.contract.consumers!;\n    const consumerNames = Object.keys(consumers) as InferConsumerNames<TContract>[];\n\n    // Calculate max prefetch (AMQP 0.9.1 prefetch is per-channel)\n    const maxPrefetch = consumerNames.reduce((max, name) => {\n      const prefetch = this.consumerOptions[name]?.prefetch;\n      return prefetch ? Math.max(max, prefetch) : max;\n    }, 0);\n\n    if (maxPrefetch > 0) {\n      this.amqpClient.addSetup(async (channel: Channel) => {\n        await channel.prefetch(maxPrefetch);\n      });\n    }\n\n    return Future.all(consumerNames.map((name) => this.consume(name)))\n      .map(Result.all)\n      .mapOk(() => undefined);\n  }\n\n  private waitForConnectionReady(): Future<Result<void, TechnicalError>> {\n    return this.amqpClient.waitForConnect();\n  }\n\n  /**\n   * Start consuming messages for a specific consumer.\n   * TypeScript guarantees consumer and handler exist for valid consumer names.\n   */\n  private consume<TName extends InferConsumerNames<TContract>>(\n    consumerName: TName,\n  ): Future<Result<void, TechnicalError>> {\n    // Non-null assertions safe: TypeScript guarantees these exist for valid TName\n    const consumerEntry = this.contract.consumers![consumerName as string]!;\n    const consumer = extractConsumer(consumerEntry);\n    // Non-null assertion safe: constructor validates handlers match consumer names\n    const handler = this.actualHandlers[consumerName]!;\n\n    return this.consumeSingle(\n      consumerName,\n      consumer,\n      handler as Parameters<typeof this.consumeSingle<TName>>[2],\n    );\n  }\n\n  /**\n   * Validate data against a Standard Schema and handle errors.\n   */\n  private validateSchema(\n    schema: StandardSchemaV1,\n    data: unknown,\n    context: { consumerName: string; queueName: string; field: string },\n    msg: ConsumeMessage,\n  ): Future<Result<unknown, TechnicalError>> {\n    const rawValidation = schema[\"~standard\"].validate(data);\n    const validationPromise =\n      rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);\n\n    return Future.fromPromise(validationPromise)\n      .mapError((error) => new TechnicalError(`Error validating ${context.field}`, error))\n      .mapOkToResult((result) => {\n        if (result.issues) {\n          return Result.Error(\n            new TechnicalError(\n              `${context.field} validation failed`,\n              new MessageValidationError(context.consumerName, result.issues),\n            ),\n          );\n        }\n        return Result.Ok(result.value);\n      })\n      .tapError((error) => {\n        this.logger?.error(`${context.field} validation failed`, {\n          consumerName: context.consumerName,\n          queueName: context.queueName,\n          error,\n        });\n        this.amqpClient.nack(msg, false, false);\n      });\n  }\n\n  /**\n   * Parse and validate a message from AMQP.\n   * @returns Ok with validated message (payload + headers), or Error (message already nacked)\n   */\n  private parseAndValidateMessage<TName extends InferConsumerNames<TContract>>(\n    msg: ConsumeMessage,\n    consumer: ConsumerDefinition,\n    consumerName: TName,\n  ): Future<Result<WorkerInferConsumedMessage<TContract, TName>, TechnicalError>> {\n    const context = {\n      consumerName: String(consumerName),\n      queueName: consumer.queue.name,\n    };\n\n    const nackAndError = (message: string, error?: unknown): TechnicalError => {\n      this.logger?.error(message, { ...context, error });\n      this.amqpClient.nack(msg, false, false);\n      return new TechnicalError(message, error);\n    };\n\n    // Decompress → Parse JSON → Validate payload\n    const parsePayload = decompressBuffer(msg.content, msg.properties.contentEncoding)\n      .tapError((error) => {\n        this.logger?.error(\"Failed to decompress message\", { ...context, error });\n        this.amqpClient.nack(msg, false, false);\n      })\n      .mapOkToResult((buffer) =>\n        Result.fromExecution(() => JSON.parse(buffer.toString()) as unknown).mapError((error) =>\n          nackAndError(\"Failed to parse JSON\", error),\n        ),\n      )\n      .flatMapOk((parsed) =>\n        this.validateSchema(\n          consumer.message.payload as StandardSchemaV1,\n          parsed,\n          { ...context, field: \"payload\" },\n          msg,\n        ),\n      );\n\n    // Validate headers (if schema defined)\n    const parseHeaders = consumer.message.headers\n      ? this.validateSchema(\n          consumer.message.headers as StandardSchemaV1,\n          msg.properties.headers ?? {},\n          { ...context, field: \"headers\" },\n          msg,\n        )\n      : Future.value(Result.Ok<unknown, TechnicalError>(undefined));\n\n    return Future.allFromDict({ payload: parsePayload, headers: parseHeaders }).map(\n      Result.allFromDict,\n    ) as Future<Result<WorkerInferConsumedMessage<TContract, TName>, TechnicalError>>;\n  }\n\n  /**\n   * Consume messages one at a time\n   */\n  private consumeSingle<TName extends InferConsumerNames<TContract>>(\n    consumerName: TName,\n    consumer: ConsumerDefinition,\n    handler: (\n      message: WorkerInferConsumedMessage<TContract, TName>,\n      rawMessage: ConsumeMessage,\n    ) => Future<Result<void, HandlerError>>,\n  ): Future<Result<void, TechnicalError>> {\n    const queueName = consumer.queue.name;\n\n    // Start consuming\n    return this.amqpClient\n      .consume(queueName, async (msg) => {\n        // Handle null messages (consumer cancellation)\n        if (msg === null) {\n          this.logger?.warn(\"Consumer cancelled by server\", {\n            consumerName: String(consumerName),\n            queueName,\n          });\n          return;\n        }\n\n        const startTime = Date.now();\n        const span = startConsumeSpan(this.telemetry, queueName, String(consumerName), {\n          \"messaging.rabbitmq.message.delivery_tag\": msg.fields.deliveryTag,\n        });\n\n        // Parse and validate message\n        await this.parseAndValidateMessage(msg, consumer, consumerName)\n          .flatMapOk((validatedMessage) =>\n            handler(validatedMessage, msg)\n              .flatMapOk(() => {\n                this.logger?.info(\"Message consumed successfully\", {\n                  consumerName: String(consumerName),\n                  queueName,\n                });\n                // Acknowledge message on success\n                this.amqpClient.ack(msg);\n\n                // Record telemetry success\n                const durationMs = Date.now() - startTime;\n                endSpanSuccess(span);\n                recordConsumeMetric(\n                  this.telemetry,\n                  queueName,\n                  String(consumerName),\n                  true,\n                  durationMs,\n                );\n\n                return Future.value(Result.Ok<void, HandlerError>(undefined));\n              })\n              .flatMapError((handlerError: HandlerError) => {\n                // Handler returned an error\n                this.logger?.error(\"Error processing message\", {\n                  consumerName: String(consumerName),\n                  queueName,\n                  errorType: handlerError.name,\n                  error: handlerError.message,\n                });\n\n                // Record telemetry failure\n                const durationMs = Date.now() - startTime;\n                endSpanError(span, handlerError);\n                recordConsumeMetric(\n                  this.telemetry,\n                  queueName,\n                  String(consumerName),\n                  false,\n                  durationMs,\n                );\n\n                // Handle the error using retry mechanism\n                return this.handleError(handlerError, msg, String(consumerName), consumer);\n              }),\n          )\n          .tapError(() => {\n            // Record telemetry failure for validation errors\n            // Note: The actual validation error is logged in parseAndValidateMessage,\n            // here we just record that validation failed for telemetry purposes\n            const durationMs = Date.now() - startTime;\n            endSpanError(span, new Error(\"Message validation failed\"));\n            recordConsumeMetric(this.telemetry, queueName, String(consumerName), false, durationMs);\n          })\n          .toPromise();\n      })\n      .tapOk((consumerTag) => {\n        // Store consumer tag for later cancellation\n        this.consumerTags.add(consumerTag);\n      })\n      .mapError(\n        (error) =>\n          new TechnicalError(`Failed to start consuming for \"${String(consumerName)}\"`, error),\n      )\n      .mapOk(() => undefined);\n  }\n\n  /**\n   * Handle error in message processing with retry logic.\n   *\n   * Flow depends on retry mode:\n   *\n   * **quorum-native mode:**\n   * 1. If NonRetryableError -> send directly to DLQ (no retry)\n   * 2. Otherwise -> nack with requeue=true (RabbitMQ handles delivery count)\n   *\n   * **ttl-backoff mode:**\n   * 1. If NonRetryableError -> send directly to DLQ (no retry)\n   * 2. If max retries exceeded -> send to DLQ\n   * 3. Otherwise -> publish to wait queue with TTL for retry\n   *\n   * **Legacy mode (no retry config):**\n   * 1. nack with requeue=true (immediate requeue)\n   */\n  private handleError(\n    error: Error,\n    msg: ConsumeMessage,\n    consumerName: string,\n    consumer: ConsumerDefinition,\n  ): Future<Result<void, TechnicalError>> {\n    // NonRetryableError -> send directly to DLQ without retrying\n    if (error instanceof NonRetryableError) {\n      this.logger?.error(\"Non-retryable error, sending to DLQ immediately\", {\n        consumerName,\n        errorType: error.name,\n        error: error.message,\n      });\n      this.sendToDLQ(msg, consumer);\n      return Future.value(Result.Ok(undefined));\n    }\n\n    // Get retry config from the queue definition in the contract\n    const config = this.getRetryConfigForConsumer(consumer);\n\n    // Quorum-native mode: let RabbitMQ handle retry via x-delivery-count\n    if (config.mode === \"quorum-native\") {\n      return this.handleErrorQuorumNative(error, msg, consumerName, consumer);\n    }\n\n    // TTL-backoff mode: use wait queue with exponential backoff\n    return this.handleErrorTtlBackoff(error, msg, consumerName, consumer, config);\n  }\n\n  /**\n   * Handle error using quorum queue's native delivery limit feature.\n   *\n   * Simply requeues the message with nack(requeue=true). RabbitMQ automatically:\n   * - Increments x-delivery-count header\n   * - Dead-letters the message when count exceeds x-delivery-limit\n   *\n   * This is simpler than TTL-based retry but provides immediate retries only.\n   */\n  private handleErrorQuorumNative(\n    error: Error,\n    msg: ConsumeMessage,\n    consumerName: string,\n    consumer: ConsumerDefinition,\n  ): Future<Result<void, TechnicalError>> {\n    const queue = consumer.queue;\n    const queueName = queue.name;\n    // x-delivery-count is incremented on each delivery attempt\n    // When x-delivery-count equals x-delivery-limit, message is dead-lettered on next attempt\n    const deliveryCount = (msg.properties.headers?.[\"x-delivery-count\"] as number) ?? 0;\n    // This function is only called for quorum-native mode, which requires quorum queues\n    const deliveryLimit = queue.type === \"quorum\" ? queue.deliveryLimit : undefined;\n\n    // After this requeue, RabbitMQ will increment deliveryCount\n    // Message is dead-lettered when deliveryCount reaches deliveryLimit\n    // So if deliveryCount == deliveryLimit - 1, the next failure will dead-letter the message\n    const attemptsBeforeDeadLetter =\n      deliveryLimit !== undefined ? Math.max(0, deliveryLimit - deliveryCount - 1) : \"unknown\";\n\n    // Log warning if this is the last attempt before dead-lettering\n    if (deliveryLimit !== undefined && deliveryCount >= deliveryLimit - 1) {\n      this.logger?.warn(\"Message at final delivery attempt (quorum-native mode)\", {\n        consumerName,\n        queueName,\n        deliveryCount,\n        deliveryLimit,\n        willDeadLetterOnNextFailure: deliveryCount === deliveryLimit - 1,\n        alreadyExceededLimit: deliveryCount >= deliveryLimit,\n        error: error.message,\n      });\n    } else {\n      this.logger?.warn(\"Retrying message (quorum-native mode)\", {\n        consumerName,\n        queueName,\n        deliveryCount,\n        deliveryLimit,\n        attemptsBeforeDeadLetter,\n        error: error.message,\n      });\n    }\n\n    // Requeue the message - RabbitMQ tracks delivery count and handles dead-lettering\n    this.amqpClient.nack(msg, false, true);\n    return Future.value(Result.Ok(undefined));\n  }\n\n  /**\n   * Handle error using TTL + wait queue pattern for exponential backoff.\n   */\n  private handleErrorTtlBackoff(\n    error: Error,\n    msg: ConsumeMessage,\n    consumerName: string,\n    consumer: ConsumerDefinition,\n    config: ResolvedTtlBackoffRetryOptions,\n  ): Future<Result<void, TechnicalError>> {\n    // Get retry count from headers\n    const retryCount = (msg.properties.headers?.[\"x-retry-count\"] as number) ?? 0;\n\n    // Max retries exceeded -> DLQ\n    if (retryCount >= config.maxRetries) {\n      this.logger?.error(\"Max retries exceeded, sending to DLQ\", {\n        consumerName,\n        retryCount,\n        maxRetries: config.maxRetries,\n        error: error.message,\n      });\n      this.sendToDLQ(msg, consumer);\n      return Future.value(Result.Ok(undefined));\n    }\n\n    // Retry with exponential backoff\n    const delayMs = this.calculateRetryDelay(retryCount, config);\n    this.logger?.warn(\"Retrying message (ttl-backoff mode)\", {\n      consumerName,\n      retryCount: retryCount + 1,\n      delayMs,\n      error: error.message,\n    });\n\n    return this.publishForRetry(msg, consumer, retryCount + 1, delayMs, error);\n  }\n\n  /**\n   * Calculate retry delay with exponential backoff and optional jitter.\n   */\n  private calculateRetryDelay(retryCount: number, config: ResolvedTtlBackoffRetryOptions): number {\n    const { initialDelayMs, maxDelayMs, backoffMultiplier, jitter } = config;\n\n    let delay = Math.min(initialDelayMs * Math.pow(backoffMultiplier, retryCount), maxDelayMs);\n\n    if (jitter) {\n      // Add jitter: random value between 50% and 100% of calculated delay\n      delay = delay * (0.5 + Math.random() * 0.5);\n    }\n\n    return Math.floor(delay);\n  }\n\n  /**\n   * Parse message content for republishing.\n   * Prevents double JSON serialization by converting Buffer to object when possible.\n   */\n  private parseMessageContentForRetry(msg: ConsumeMessage, queueName: string): Buffer | unknown {\n    let content: Buffer | unknown = msg.content;\n\n    // If message is not compressed (no contentEncoding), parse it to get the original object\n    if (!msg.properties.contentEncoding) {\n      try {\n        content = JSON.parse(msg.content.toString());\n      } catch (err) {\n        this.logger?.warn(\"Failed to parse message for retry, using original buffer\", {\n          queueName,\n          error: err,\n        });\n      }\n    }\n\n    return content;\n  }\n\n  /**\n   * Publish message to wait queue for retry after TTL expires.\n   *\n   * ┌─────────────────────────────────────────────────────────────────┐\n   * │ Retry Flow (Native RabbitMQ TTL + DLX Pattern)                   │\n   * ├─────────────────────────────────────────────────────────────────┤\n   * │                                                                   │\n   * │ 1. Handler throws any Error                                      │\n   * │    ↓                                                              │\n   * │ 2. Worker publishes to DLX with routing key: {queue}-wait        │\n   * │    ↓                                                              │\n   * │ 3. DLX routes to wait queue: {queue}-wait                        │\n   * │    (with expiration: calculated backoff delay)                   │\n   * │    ↓                                                              │\n   * │ 4. Message waits in queue until TTL expires                      │\n   * │    ↓                                                              │\n   * │ 5. Expired message dead-lettered to DLX                          │\n   * │    (with routing key: {queue})                                   │\n   * │    ↓                                                              │\n   * │ 6. DLX routes back to main queue → RETRY                         │\n   * │    ↓                                                              │\n   * │ 7. If retries exhausted: nack without requeue → DLQ              │\n   * │                                                                   │\n   * └─────────────────────────────────────────────────────────────────┘\n   */\n  private publishForRetry(\n    msg: ConsumeMessage,\n    consumer: ConsumerDefinition,\n    newRetryCount: number,\n    delayMs: number,\n    error: Error,\n  ): Future<Result<void, TechnicalError>> {\n    const queueName = consumer.queue.name;\n    const deadLetter = consumer.queue.deadLetter;\n\n    if (!deadLetter) {\n      this.logger?.warn(\n        \"Cannot retry: queue does not have DLX configured, falling back to nack with requeue\",\n        {\n          queueName,\n        },\n      );\n      this.amqpClient.nack(msg, false, true);\n      return Future.value(Result.Ok(undefined));\n    }\n\n    const dlxName = deadLetter.exchange.name;\n    const waitRoutingKey = `${queueName}-wait`;\n\n    // Acknowledge original message\n    this.amqpClient.ack(msg);\n\n    const content = this.parseMessageContentForRetry(msg, queueName);\n\n    // Publish to DLX with wait routing key\n    return this.amqpClient\n      .publish(dlxName, waitRoutingKey, content, {\n        ...msg.properties,\n        expiration: delayMs.toString(), // Per-message TTL\n        headers: {\n          ...msg.properties.headers,\n          \"x-retry-count\": newRetryCount,\n          \"x-last-error\": error.message,\n          \"x-first-failure-timestamp\":\n            msg.properties.headers?.[\"x-first-failure-timestamp\"] ?? Date.now(),\n        },\n      })\n      .mapOkToResult((published) => {\n        if (!published) {\n          this.logger?.error(\"Failed to publish message for retry (write buffer full)\", {\n            queueName,\n            waitRoutingKey,\n            retryCount: newRetryCount,\n          });\n          return Result.Error(\n            new TechnicalError(\"Failed to publish message for retry (write buffer full)\"),\n          );\n        }\n\n        this.logger?.info(\"Message published for retry\", {\n          queueName,\n          waitRoutingKey,\n          retryCount: newRetryCount,\n          delayMs,\n        });\n        return Result.Ok(undefined);\n      });\n  }\n\n  /**\n   * Send message to dead letter queue.\n   * Nacks the message without requeue, relying on DLX configuration.\n   */\n  private sendToDLQ(msg: ConsumeMessage, consumer: ConsumerDefinition): void {\n    const queueName = consumer.queue.name;\n    const hasDeadLetter = consumer.queue.deadLetter !== undefined;\n\n    if (!hasDeadLetter) {\n      this.logger?.warn(\"Queue does not have DLX configured - message will be lost on nack\", {\n        queueName,\n      });\n    }\n\n    this.logger?.info(\"Sending message to DLQ\", {\n      queueName,\n      deliveryTag: msg.fields.deliveryTag,\n    });\n\n    // Nack without requeue - relies on DLX configuration\n    this.amqpClient.nack(msg, false, false);\n  }\n}\n","import type { ContractDefinition, InferConsumerNames } from \"@amqp-contract/contract\";\nimport type {\n  WorkerInferConsumerHandler,\n  WorkerInferConsumerHandlerEntry,\n  WorkerInferConsumerHandlers,\n} from \"./types.js\";\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * Validate that a consumer exists in the contract\n */\nfunction validateConsumerExists<TContract extends ContractDefinition>(\n  contract: TContract,\n  consumerName: string,\n): void {\n  const consumers = contract.consumers;\n\n  if (!consumers || !(consumerName in consumers)) {\n    const availableConsumers = consumers ? Object.keys(consumers) : [];\n    const available = availableConsumers.length > 0 ? availableConsumers.join(\", \") : \"none\";\n    throw new Error(\n      `Consumer \"${consumerName}\" not found in contract. Available consumers: ${available}`,\n    );\n  }\n}\n\n/**\n * Validate that all handlers reference valid consumers\n */\nfunction validateHandlers<TContract extends ContractDefinition>(\n  contract: TContract,\n  handlers: object,\n): void {\n  const consumers = contract.consumers;\n  const availableConsumers = Object.keys(consumers ?? {});\n  const availableConsumerNames =\n    availableConsumers.length > 0 ? availableConsumers.join(\", \") : \"none\";\n\n  for (const handlerName of Object.keys(handlers)) {\n    if (!consumers || !(handlerName in consumers)) {\n      throw new Error(\n        `Consumer \"${handlerName}\" not found in contract. Available consumers: ${availableConsumerNames}`,\n      );\n    }\n  }\n}\n\n// =============================================================================\n// Handler Definitions\n// =============================================================================\n\n/**\n * Define a type-safe handler for a specific consumer in a contract.\n *\n * **Recommended:** This function creates handlers that return `Future<Result<void, HandlerError>>`,\n * providing explicit error handling and better control over retry behavior.\n *\n * Supports two patterns:\n * 1. Simple handler: just the function\n * 2. Handler with options: [handler, { prefetch: 10 }]\n *\n * @template TContract - The contract definition type\n * @template TName - The consumer name from the contract\n * @param contract - The contract definition containing the consumer\n * @param consumerName - The name of the consumer from the contract\n * @param handler - The handler function that returns `Future<Result<void, HandlerError>>`\n * @param options - Optional consumer options (prefetch)\n * @returns A type-safe handler that can be used with TypedAmqpWorker\n *\n * @example\n * ```typescript\n * import { defineHandler, RetryableError, NonRetryableError } from '@amqp-contract/worker';\n * import { Future, Result } from '@swan-io/boxed';\n * import { orderContract } from './contract';\n *\n * // Simple handler with explicit error handling using mapError\n * const processOrderHandler = defineHandler(\n *   orderContract,\n *   'processOrder',\n *   ({ payload }) =>\n *     Future.fromPromise(processPayment(payload))\n *       .mapOk(() => undefined)\n *       .mapError((error) => new RetryableError('Payment failed', error))\n * );\n *\n * // Handler with validation (non-retryable error)\n * const validateOrderHandler = defineHandler(\n *   orderContract,\n *   'validateOrder',\n *   ({ payload }) => {\n *     if (payload.amount < 1) {\n *       // Won't be retried - goes directly to DLQ\n *       return Future.value(Result.Error(new NonRetryableError('Invalid order amount')));\n *     }\n *     return Future.value(Result.Ok(undefined));\n *   }\n * );\n * ```\n */\nexport function defineHandler<\n  TContract extends ContractDefinition,\n  TName extends InferConsumerNames<TContract>,\n>(\n  contract: TContract,\n  consumerName: TName,\n  handler: WorkerInferConsumerHandler<TContract, TName>,\n): WorkerInferConsumerHandlerEntry<TContract, TName>;\nexport function defineHandler<\n  TContract extends ContractDefinition,\n  TName extends InferConsumerNames<TContract>,\n>(\n  contract: TContract,\n  consumerName: TName,\n  handler: WorkerInferConsumerHandler<TContract, TName>,\n  options: { prefetch?: number },\n): WorkerInferConsumerHandlerEntry<TContract, TName>;\nexport function defineHandler<\n  TContract extends ContractDefinition,\n  TName extends InferConsumerNames<TContract>,\n>(\n  contract: TContract,\n  consumerName: TName,\n  handler: WorkerInferConsumerHandler<TContract, TName>,\n  options?: { prefetch?: number },\n): WorkerInferConsumerHandlerEntry<TContract, TName> {\n  validateConsumerExists(contract, String(consumerName));\n\n  if (options) {\n    return [handler, options];\n  }\n  return handler;\n}\n\n/**\n * Define multiple type-safe handlers for consumers in a contract.\n *\n * **Recommended:** This function creates handlers that return `Future<Result<void, HandlerError>>`,\n * providing explicit error handling and better control over retry behavior.\n *\n * @template TContract - The contract definition type\n * @param contract - The contract definition containing the consumers\n * @param handlers - An object with handler functions for each consumer\n * @returns A type-safe handlers object that can be used with TypedAmqpWorker\n *\n * @example\n * ```typescript\n * import { defineHandlers, RetryableError } from '@amqp-contract/worker';\n * import { Future } from '@swan-io/boxed';\n * import { orderContract } from './contract';\n *\n * const handlers = defineHandlers(orderContract, {\n *   processOrder: ({ payload }) =>\n *     Future.fromPromise(processPayment(payload))\n *       .mapOk(() => undefined)\n *       .mapError((error) => new RetryableError('Payment failed', error)),\n *   notifyOrder: ({ payload }) =>\n *     Future.fromPromise(sendNotification(payload))\n *       .mapOk(() => undefined)\n *       .mapError((error) => new RetryableError('Notification failed', error)),\n * });\n * ```\n */\nexport function defineHandlers<TContract extends ContractDefinition>(\n  contract: TContract,\n  handlers: WorkerInferConsumerHandlers<TContract>,\n): WorkerInferConsumerHandlers<TContract> {\n  validateHandlers(contract, handlers);\n  return handlers;\n}\n"],"mappings":"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"}

package/docs/index.md

@@ -8,9 +8,20 @@
 
 ### MessageValidationError
 
-Defined in: [packages/worker/src/errors.ts:4](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L4)
+Defined in: packages/core/dist/index.d.mts:83
 
-Error thrown when message validation fails
+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).
+
+#### Param
+
+The name of the publisher or consumer that triggered the validation
+
+#### Param
+
+The validation issues from the Standard Schema validation
 
 #### Extends
 
@@ -21,16 +32,16 @@ Error thrown when message validation fails
 ##### Constructor
 
 ```ts
-new MessageValidationError(consumerName, issues): MessageValidationError;
+new MessageValidationError(source, issues): MessageValidationError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:5](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L5)
+Defined in: packages/core/dist/index.d.mts:86
 
 ###### Parameters
 
 | Parameter | Type |
 | ------ | ------ |
-| `consumerName` | `string` |
+| `source` | `string` |
 | `issues` | `unknown` |
 
 ###### Returns
@@ -48,12 +59,12 @@ Error.constructor
 | Property | Modifier | Type | Description | Inherited from | Defined in |
 | ------ | ------ | ------ | ------ | ------ | ------ |
 | <a id="cause"></a> `cause?` | `public` | `unknown` | - | `Error.cause` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es2022.error.d.ts:26 |
-| <a id="consumername"></a> `consumerName` | `readonly` | `string` | - | - | [packages/worker/src/errors.ts:6](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L6) |
-| <a id="issues"></a> `issues` | `readonly` | `unknown` | - | - | [packages/worker/src/errors.ts:7](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L7) |
+| <a id="issues"></a> `issues` | `readonly` | `unknown` | - | - | packages/core/dist/index.d.mts:85 |
 | <a id="message"></a> `message` | `public` | `string` | - | `Error.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
 | <a id="name"></a> `name` | `public` | `string` | - | `Error.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
+| <a id="source"></a> `source` | `readonly` | `string` | - | - | packages/core/dist/index.d.mts:84 |
 | <a id="stack"></a> `stack?` | `public` | `string` | - | `Error.stack` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1078 |
-| <a id="stacktracelimit"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:67 |
+| <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.2.3/node\_modules/@types/node/globals.d.ts:67 |
 
 #### Methods
 
@@ -63,7 +74,7 @@ Error.constructor
 static captureStackTrace(targetObject, constructorOpt?): void;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:51
+Defined in: node\_modules/.pnpm/@types+node@25.2.3/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
@@ -132,7 +143,7 @@ Error.captureStackTrace
 static prepareStackTrace(err, stackTraces): any;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:55
+Defined in: node\_modules/.pnpm/@types+node@25.2.3/node\_modules/@types/node/globals.d.ts:55
 
 ###### Parameters
 
@@ -159,7 +170,7 @@ Error.prepareStackTrace
 
 ### NonRetryableError
 
-Defined in: [packages/worker/src/errors.ts:52](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L52)
+Defined in: [packages/worker/src/errors.ts:34](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L34)
 
 Non-retryable errors - permanent failures that should not be retried
 Examples: invalid data, business rule violations, permanent external failures
@@ -179,7 +190,7 @@ immediately sent to the dead letter queue (DLQ) if configured.
 new NonRetryableError(message, cause?): NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:53](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L53)
+Defined in: [packages/worker/src/errors.ts:35](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L35)
 
 ###### Parameters
 
@@ -202,11 +213,11 @@ Error.constructor
 
 | Property | Modifier | Type | Description | Inherited from | Defined in |
 | ------ | ------ | ------ | ------ | ------ | ------ |
-| <a id="cause-1"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/worker/src/errors.ts:55](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L55) |
+| <a id="cause-1"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/worker/src/errors.ts:37](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L37) |
 | <a id="message-1"></a> `message` | `public` | `string` | - | `Error.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
 | <a id="name-1"></a> `name` | `public` | `string` | - | `Error.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
 | <a id="stack-1"></a> `stack?` | `public` | `string` | - | `Error.stack` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1078 |
-| <a id="stacktracelimit-1"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:67 |
+| <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.2.3/node\_modules/@types/node/globals.d.ts:67 |
 
 #### Methods
 
@@ -216,7 +227,7 @@ Error.constructor
 static captureStackTrace(targetObject, constructorOpt?): void;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:51
+Defined in: node\_modules/.pnpm/@types+node@25.2.3/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
@@ -285,7 +296,7 @@ Error.captureStackTrace
 static prepareStackTrace(err, stackTraces): any;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:55
+Defined in: node\_modules/.pnpm/@types+node@25.2.3/node\_modules/@types/node/globals.d.ts:55
 
 ###### Parameters
 
@@ -312,7 +323,7 @@ Error.prepareStackTrace
 
 ### RetryableError
 
-Defined in: [packages/worker/src/errors.ts:28](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L28)
+Defined in: [packages/worker/src/errors.ts:10](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L10)
 
 Retryable errors - transient failures that may succeed on retry
 Examples: network timeouts, rate limiting, temporary service unavailability
@@ -332,7 +343,7 @@ The worker will apply exponential backoff and retry the message.
 new RetryableError(message, cause?): RetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:29](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L29)
+Defined in: [packages/worker/src/errors.ts:11](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L11)
 
 ###### Parameters
 
@@ -355,11 +366,11 @@ Error.constructor
 
 | Property | Modifier | Type | Description | Inherited from | Defined in |
 | ------ | ------ | ------ | ------ | ------ | ------ |
-| <a id="cause-2"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/worker/src/errors.ts:31](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L31) |
+| <a id="cause-2"></a> `cause?` | `readonly` | `unknown` | - | `Error.cause` | [packages/worker/src/errors.ts:13](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L13) |
 | <a id="message-2"></a> `message` | `public` | `string` | - | `Error.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
 | <a id="name-2"></a> `name` | `public` | `string` | - | `Error.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
 | <a id="stack-2"></a> `stack?` | `public` | `string` | - | `Error.stack` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1078 |
-| <a id="stacktracelimit-2"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:67 |
+| <a id="stacktracelimit-2"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.2.3/node\_modules/@types/node/globals.d.ts:67 |
 
 #### Methods
 
@@ -369,7 +380,7 @@ Error.constructor
 static captureStackTrace(targetObject, constructorOpt?): void;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:51
+Defined in: node\_modules/.pnpm/@types+node@25.2.3/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
@@ -438,7 +449,7 @@ Error.captureStackTrace
 static prepareStackTrace(err, stackTraces): any;
 ```
 
-Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:55
+Defined in: node\_modules/.pnpm/@types+node@25.2.3/node\_modules/@types/node/globals.d.ts:55
 
 ###### Parameters
 
@@ -465,7 +476,7 @@ Error.prepareStackTrace
 
 ### TypedAmqpWorker
 
-Defined in: [packages/worker/src/worker.ts:158](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/worker.ts#L158)
+Defined in: [packages/worker/src/worker.ts:158](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/worker.ts#L158)
 
 Type-safe AMQP worker for consuming messages from RabbitMQ.
 
@@ -520,7 +531,7 @@ await worker.close().resultToPromise();
 close(): Future<Result<void, TechnicalError>>;
 ```
 
-Defined in: [packages/worker/src/worker.ts:278](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/worker.ts#L278)
+Defined in: [packages/worker/src/worker.ts:278](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/worker.ts#L278)
 
 Close the AMQP channel and connection.
 
@@ -548,7 +559,7 @@ if (closeResult.isOk()) {
 static create<TContract>(options): Future<Result<TypedAmqpWorker<TContract>, TechnicalError>>;
 ```
 
-Defined in: [packages/worker/src/worker.ts:235](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/worker.ts#L235)
+Defined in: [packages/worker/src/worker.ts:235](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/worker.ts#L235)
 
 Create a type-safe AMQP worker from a contract.
 
@@ -598,7 +609,7 @@ const worker = await TypedAmqpWorker.create({
 type CreateWorkerOptions<TContract> = object;
 ```
 
-Defined in: [packages/worker/src/worker.ts:94](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/worker.ts#L94)
+Defined in: [packages/worker/src/worker.ts:94](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/worker.ts#L94)
 
 Options for creating a type-safe AMQP worker.
 
@@ -643,12 +654,12 @@ not at the handler level. See `QueueDefinition.retry` for configuration options.
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.) | [packages/worker/src/worker.ts:106](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/worker.ts#L106) |
-| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [packages/worker/src/worker.ts:96](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/worker.ts#L96) |
-| <a id="handlers"></a> `handlers` | [`WorkerInferConsumerHandlers`](#workerinferconsumerhandlers)&lt;`TContract`&gt; | Handlers for each consumer defined in the contract. Handlers must return `Future<Result<void, HandlerError>>` for explicit error handling. Use defineHandler() to create handlers. | [packages/worker/src/worker.ts:102](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/worker.ts#L102) |
-| <a id="logger"></a> `logger?` | `Logger` | Optional logger for logging message consumption and errors | [packages/worker/src/worker.ts:108](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/worker.ts#L108) |
-| <a id="telemetry"></a> `telemetry?` | `TelemetryProvider` | Optional telemetry provider for tracing and metrics. If not provided, uses the default provider which attempts to load OpenTelemetry. OpenTelemetry instrumentation is automatically enabled if @opentelemetry/api is installed. | [packages/worker/src/worker.ts:114](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/worker.ts#L114) |
-| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [packages/worker/src/worker.ts:104](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/worker.ts#L104) |
+| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | Optional connection configuration (heartbeat, reconnect settings, etc.) | [packages/worker/src/worker.ts:106](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/worker.ts#L106) |
+| <a id="contract"></a> `contract` | `TContract` | The AMQP contract definition specifying consumers and their message schemas | [packages/worker/src/worker.ts:96](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/worker.ts#L96) |
+| <a id="handlers"></a> `handlers` | [`WorkerInferConsumerHandlers`](#workerinferconsumerhandlers)&lt;`TContract`&gt; | Handlers for each consumer defined in the contract. Handlers must return `Future<Result<void, HandlerError>>` for explicit error handling. Use defineHandler() to create handlers. | [packages/worker/src/worker.ts:102](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/worker.ts#L102) |
+| <a id="logger"></a> `logger?` | `Logger` | Optional logger for logging message consumption and errors | [packages/worker/src/worker.ts:108](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/worker.ts#L108) |
+| <a id="telemetry"></a> `telemetry?` | `TelemetryProvider` | Optional telemetry provider for tracing and metrics. If not provided, uses the default provider which attempts to load OpenTelemetry. OpenTelemetry instrumentation is automatically enabled if @opentelemetry/api is installed. | [packages/worker/src/worker.ts:114](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/worker.ts#L114) |
+| <a id="urls"></a> `urls` | `ConnectionUrl`[] | AMQP broker URL(s). Multiple URLs provide failover support | [packages/worker/src/worker.ts:104](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/worker.ts#L104) |
 
 ***
 
@@ -660,7 +671,7 @@ type HandlerError =
   | NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:73](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L73)
+Defined in: [packages/worker/src/errors.ts:55](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L55)
 
 Union type representing all handler errors.
 Use this type when defining handlers that explicitly signal error outcomes.
@@ -673,7 +684,7 @@ Use this type when defining handlers that explicitly signal error outcomes.
 type WorkerConsumedMessage<TPayload, THeaders> = object;
 ```
 
-Defined in: [packages/worker/src/types.ts:104](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L104)
+Defined in: [packages/worker/src/types.ts:104](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/types.ts#L104)
 
 A consumed message containing parsed payload and headers.
 
@@ -703,8 +714,8 @@ const handler = defineHandler(contract, 'processOrder', (message, rawMessage) =>
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="headers"></a> `headers` | `THeaders` *extends* `undefined` ? `undefined` : `THeaders` | The validated message headers (present only when headers schema is defined) | [packages/worker/src/types.ts:108](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L108) |
-| <a id="payload"></a> `payload` | `TPayload` | The validated message payload | [packages/worker/src/types.ts:106](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L106) |
+| <a id="headers"></a> `headers` | `THeaders` *extends* `undefined` ? `undefined` : `THeaders` | The validated message headers (present only when headers schema is defined) | [packages/worker/src/types.ts:108](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/types.ts#L108) |
+| <a id="payload"></a> `payload` | `TPayload` | The validated message payload | [packages/worker/src/types.ts:106](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/types.ts#L106) |
 
 ***
 
@@ -714,7 +725,7 @@ const handler = defineHandler(contract, 'processOrder', (message, rawMessage) =>
 type WorkerInferConsumedMessage<TContract, TName> = WorkerConsumedMessage<WorkerInferConsumerPayload<TContract, TName>, WorkerInferConsumerHeaders<TContract, TName>>;
 ```
 
-Defined in: [packages/worker/src/types.ts:115](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L115)
+Defined in: [packages/worker/src/types.ts:115](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/types.ts#L115)
 
 Infer the full consumed message type for a specific consumer.
 Includes both payload and headers (if defined).
@@ -734,7 +745,7 @@ Includes both payload and headers (if defined).
 type WorkerInferConsumerHandler<TContract, TName> = (message, rawMessage) => Future<Result<void, HandlerError>>;
 ```
 
-Defined in: [packages/worker/src/types.ts:154](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L154)
+Defined in: [packages/worker/src/types.ts:154](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/types.ts#L154)
 
 Consumer handler type for a specific consumer.
 Returns a `Future<Result<void, HandlerError>>` for explicit error handling.
@@ -787,7 +798,7 @@ type WorkerInferConsumerHandlerEntry<TContract, TName> =
 }];
 ```
 
-Defined in: [packages/worker/src/types.ts:172](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L172)
+Defined in: [packages/worker/src/types.ts:172](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/types.ts#L172)
 
 Handler entry for a consumer - either a function or a tuple of [handler, options].
 
@@ -813,7 +824,7 @@ not at the handler level. See `QueueDefinition.retry` for configuration options.
 type WorkerInferConsumerHandlers<TContract> = { [K in InferConsumerNames<TContract>]: WorkerInferConsumerHandlerEntry<TContract, K> };
 ```
 
-Defined in: [packages/worker/src/types.ts:193](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L193)
+Defined in: [packages/worker/src/types.ts:193](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/types.ts#L193)
 
 Consumer handlers for a contract.
 All handlers return `Future<Result<void, HandlerError>>` for explicit error control.
@@ -843,7 +854,7 @@ const handlers: WorkerInferConsumerHandlers<typeof contract> = {
 type WorkerInferConsumerHeaders<TContract, TName> = ConsumerInferHeadersInput<InferConsumer<TContract, TName>>;
 ```
 
-Defined in: [packages/worker/src/types.ts:79](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L79)
+Defined in: [packages/worker/src/types.ts:79](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/types.ts#L79)
 
 Infer the headers type for a specific consumer
 Returns undefined if no headers schema is defined
@@ -855,68 +866,6 @@ Returns undefined if no headers schema is defined
 | `TContract` *extends* `ContractDefinition` |
 | `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
 
-***
-
-### ~~WorkerInferSafeConsumerHandler~~
-
-```ts
-type WorkerInferSafeConsumerHandler<TContract, TName> = WorkerInferConsumerHandler<TContract, TName>;
-```
-
-Defined in: [packages/worker/src/types.ts:205](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L205)
-
-#### Type Parameters
-
-| Type Parameter |
-| ------ |
-| `TContract` *extends* `ContractDefinition` |
-| `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
-
-#### Deprecated
-
-Use `WorkerInferConsumerHandler` instead. Will be removed in next major version.
-
-***
-
-### ~~WorkerInferSafeConsumerHandlerEntry~~
-
-```ts
-type WorkerInferSafeConsumerHandlerEntry<TContract, TName> = WorkerInferConsumerHandlerEntry<TContract, TName>;
-```
-
-Defined in: [packages/worker/src/types.ts:213](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L213)
-
-#### Type Parameters
-
-| Type Parameter |
-| ------ |
-| `TContract` *extends* `ContractDefinition` |
-| `TName` *extends* `InferConsumerNames`&lt;`TContract`&gt; |
-
-#### Deprecated
-
-Use `WorkerInferConsumerHandlerEntry` instead. Will be removed in next major version.
-
-***
-
-### ~~WorkerInferSafeConsumerHandlers~~
-
-```ts
-type WorkerInferSafeConsumerHandlers<TContract> = WorkerInferConsumerHandlers<TContract>;
-```
-
-Defined in: [packages/worker/src/types.ts:221](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/types.ts#L221)
-
-#### Type Parameters
-
-| Type Parameter |
-| ------ |
-| `TContract` *extends* `ContractDefinition` |
-
-#### Deprecated
-
-Use `WorkerInferConsumerHandlers` instead. Will be removed in next major version.
-
 ## Functions
 
 ### defineHandler()
@@ -930,7 +879,7 @@ function defineHandler<TContract, TName>(
    handler): WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:103](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/handlers.ts#L103)
+Defined in: [packages/worker/src/handlers.ts:103](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/handlers.ts#L103)
 
 Define a type-safe handler for a specific consumer in a contract.
 
@@ -1003,7 +952,7 @@ function defineHandler<TContract, TName>(
    options): WorkerInferConsumerHandlerEntry<TContract, TName>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:111](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/handlers.ts#L111)
+Defined in: [packages/worker/src/handlers.ts:111](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/handlers.ts#L111)
 
 Define a type-safe handler for a specific consumer in a contract.
 
@@ -1076,7 +1025,7 @@ const validateOrderHandler = defineHandler(
 function defineHandlers<TContract>(contract, handlers): WorkerInferConsumerHandlers<TContract>;
 ```
 
-Defined in: [packages/worker/src/handlers.ts:166](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/handlers.ts#L166)
+Defined in: [packages/worker/src/handlers.ts:166](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/handlers.ts#L166)
 
 Define multiple type-safe handlers for consumers in a contract.
 
@@ -1129,7 +1078,7 @@ const handlers = defineHandlers(orderContract, {
 function isHandlerError(error): error is HandlerError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:149](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L149)
+Defined in: [packages/worker/src/errors.ts:131](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L131)
 
 Type guard to check if an error is any HandlerError (RetryableError or NonRetryableError).
 
@@ -1166,7 +1115,7 @@ function handleError(error: unknown) {
 function isNonRetryableError(error): error is NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:127](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L127)
+Defined in: [packages/worker/src/errors.ts:109](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L109)
 
 Type guard to check if an error is a NonRetryableError.
 
@@ -1206,7 +1155,7 @@ try {
 function isRetryableError(error): error is RetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:102](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L102)
+Defined in: [packages/worker/src/errors.ts:84](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L84)
 
 Type guard to check if an error is a RetryableError.
 
@@ -1248,7 +1197,7 @@ try {
 function nonRetryable(message, cause?): NonRetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:211](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L211)
+Defined in: [packages/worker/src/errors.ts:193](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L193)
 
 Create a NonRetryableError with less verbosity.
 
@@ -1293,7 +1242,7 @@ const handler = ({ payload }) => {
 function retryable(message, cause?): RetryableError;
 ```
 
-Defined in: [packages/worker/src/errors.ts:181](https://github.com/btravers/amqp-contract/blob/5f68ac0e7a01403c51ddebd327d65b70384c2e2f/packages/worker/src/errors.ts#L181)
+Defined in: [packages/worker/src/errors.ts:163](https://github.com/btravers/amqp-contract/blob/a5ff0e58db355e3410ea3b765884871c3b44c87d/packages/worker/src/errors.ts#L163)
 
 Create a RetryableError with less verbosity.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amqp-contract/worker",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Worker utilities for consuming messages using amqp-contract",
   "keywords": [
     "amqp",
@@ -52,22 +52,22 @@
   "dependencies": {
     "@standard-schema/spec": "1.1.0",
     "@swan-io/boxed": "3.2.1",
-    "@amqp-contract/contract": "0.17.0",
-    "@amqp-contract/core": "0.17.0"
+    "@amqp-contract/contract": "0.19.0",
+    "@amqp-contract/core": "0.19.0"
   },
   "devDependencies": {
     "@types/amqplib": "0.10.8",
-    "@types/node": "25.2.1",
+    "@types/node": "25.2.3",
     "@vitest/coverage-v8": "4.0.18",
     "amqp-connection-manager": "5.0.0",
     "amqplib": "0.10.9",
     "tsdown": "0.20.3",
     "typedoc": "0.28.16",
-    "typedoc-plugin-markdown": "4.9.0",
+    "typedoc-plugin-markdown": "4.10.0",
     "typescript": "5.9.3",
     "vitest": "4.0.18",
     "zod": "4.3.6",
-    "@amqp-contract/testing": "0.17.0",
+    "@amqp-contract/testing": "0.19.0",
     "@amqp-contract/tsconfig": "0.1.0",
     "@amqp-contract/typedoc": "0.1.0"
   },