npm - @amqp-contract/worker - Versions diffs - 0.24.0 → 0.25.0 - Mend

@amqp-contract/worker 0.24.0 → 0.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.mjs","names":[],"sources":["../src/decompression.ts","../src/errors.ts","../src/retry.ts","../src/worker.ts","../src/handlers.ts"],"sourcesContent":["import { TechnicalError } from \"@amqp-contract/core\";\nimport { errAsync, okAsync, ResultAsync } from \"neverthrow\";\nimport { gunzip, inflate } from \"node:zlib\";\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 ResultAsync resolving to the decompressed buffer or a TechnicalError\n \n @internal\n /\nexport function decompressBuffer(\n buffer: Buffer,\n contentEncoding: string \| undefined,\n): ResultAsync<Buffer, TechnicalError> {\n if (!contentEncoding) {\n return okAsync(buffer);\n }\n\n const normalizedEncoding = contentEncoding.toLowerCase();\n\n if (!isSupportedEncoding(normalizedEncoding)) {\n return errAsync(\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 switch (normalizedEncoding) {\n case \"gzip\":\n return ResultAsync.fromPromise(\n gunzipAsync(buffer),\n (error) => new TechnicalError(\"Failed to decompress gzip\", error),\n );\n case \"deflate\":\n return ResultAsync.fromPromise(\n inflateAsync(buffer),\n (error) => new TechnicalError(\"Failed to decompress deflate\", error),\n );\n }\n}\n","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 { ResultAsync } from 'neverthrow';\n \n const handler = ({ payload }) =>\n * ResultAsync.fromPromise(\n * processPayment(payload),\n * (e) => retryable('Payment service unavailable', e),\n * ).map(() => undefined);\n \n // Equivalent to:\n * // ResultAsync.fromPromise(processPayment(payload), (e) => new RetryableError('...', 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 { errAsync, okAsync } from 'neverthrow';\n \n const handler = ({ payload }) => {\n * if (!isValidPayload(payload)) {\n * return errAsync(nonRetryable('Invalid payload format'));\n * }\n * return okAsync(undefined);\n * };\n \n // Equivalent to:\n * // return errAsync(new NonRetryableError('Invalid payload format'));\n * ```\n /\nexport function nonRetryable(message: string, cause?: unknown): NonRetryableError {\n return new NonRetryableError(message, cause);\n}\n","import {\n type ConsumerDefinition,\n type ResolvedImmediateRequeueRetryOptions,\n type ResolvedTtlBackoffRetryOptions,\n extractQueue,\n isQueueWithTtlBackoffInfrastructure,\n} from \"@amqp-contract/contract\";\nimport { type AmqpClient, type Logger, TechnicalError } from \"@amqp-contract/core\";\nimport type { ConsumeMessage } from \"amqplib\";\nimport { err, errAsync, ok, okAsync, ResultAsync } from \"neverthrow\";\nimport { NonRetryableError } from \"./errors.js\";\n\ntype RetryContext = {\n amqpClient: AmqpClient;\n logger?: Logger \| undefined;\n};\n\n/\n Handle error in message processing with retry logic.\n \n Flow depends on retry mode:\n \n immediate-requeue mode:\n * 1. If NonRetryableError -> send directly to DLQ (no retry)\n * 2. If max retries exceeded -> send to DLQ\n * 3. Otherwise -> requeue immediately for retry\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 none mode (no retry config):\n * 1. send directly to DLQ (no retry)\n /\nexport function handleError(\n ctx: RetryContext,\n error: Error,\n msg: ConsumeMessage,\n consumerName: string,\n consumer: ConsumerDefinition,\n): ResultAsync<void, TechnicalError> {\n // NonRetryableError -> send directly to DLQ without retrying\n if (error instanceof NonRetryableError) {\n ctx.logger?.error(\"Non-retryable error, sending to DLQ immediately\", {\n consumerName,\n errorType: error.name,\n error: error.message,\n });\n sendToDLQ(ctx, msg, consumer);\n return okAsync(undefined);\n }\n\n // Get retry config from the queue definition in the contract\n const config = extractQueue(consumer.queue).retry;\n\n // Immediate-requeue mode: requeue the message immediately\n if (config.mode === \"immediate-requeue\") {\n return handleErrorImmediateRequeue(ctx, error, msg, consumerName, consumer, config);\n }\n\n // TTL-backoff mode: use wait queue with exponential backoff\n if (config.mode === \"ttl-backoff\") {\n return handleErrorTtlBackoff(ctx, error, msg, consumerName, consumer, config);\n }\n\n // None mode: no retry, send directly to DLQ or reject\n ctx.logger?.warn(\"Retry disabled (none mode), sending to DLQ\", {\n consumerName,\n error: error.message,\n });\n sendToDLQ(ctx, msg, consumer);\n return okAsync(undefined);\n}\n\n/\n Handle error by requeuing immediately.\n \n For quorum queues, messages are requeued with `nack(requeue=true)`, and the worker tracks delivery count via the native RabbitMQ `x-delivery-count` header.\n * For classic queues, messages are re-published on the same queue, and the worker tracks delivery count via a custom `x-retry-count` header.\n * When the count exceeds `maxRetries`, the message is automatically dead-lettered (if DLX is configured) or dropped.\n \n This is simpler than TTL-based retry but provides immediate retries only.\n /\nfunction handleErrorImmediateRequeue(\n ctx: RetryContext,\n error: Error,\n msg: ConsumeMessage,\n consumerName: string,\n consumer: ConsumerDefinition,\n config: ResolvedImmediateRequeueRetryOptions,\n): ResultAsync<void, TechnicalError> {\n const queue = extractQueue(consumer.queue);\n const queueName = queue.name;\n\n // Get retry count from headers\n // For quorum queues, the header x-delivery-count is automatically incremented on each delivery attempt\n // For classic queues, the header x-retry-count is manually incremented by the worker when re-publishing messages\n const retryCount =\n queue.type === \"quorum\"\n ? ((msg.properties.headers?.[\"x-delivery-count\"] as number) ?? 0)\n : ((msg.properties.headers?.[\"x-retry-count\"] as number) ?? 0);\n\n // Max retries exceeded -> DLQ\n if (retryCount >= config.maxRetries) {\n ctx.logger?.error(\"Max retries exceeded, sending to DLQ (immediate-requeue mode)\", {\n consumerName,\n queueName,\n retryCount,\n maxRetries: config.maxRetries,\n error: error.message,\n });\n sendToDLQ(ctx, msg, consumer);\n return okAsync(undefined);\n }\n\n ctx.logger?.warn(\"Retrying message (immediate-requeue mode)\", {\n consumerName,\n queueName,\n retryCount,\n maxRetries: config.maxRetries,\n error: error.message,\n });\n\n if (queue.type === \"quorum\") {\n // For quorum queues, nack with requeue=true to trigger native retry mechanism\n ctx.amqpClient.nack(msg, false, true);\n return okAsync(undefined);\n } else {\n // For classic queues, re-publish the message to the same exchange / routing key immediately with an incremented x-retry-count header\n return publishForRetry(ctx, {\n msg,\n exchange: msg.fields.exchange,\n routingKey: msg.fields.routingKey,\n queueName,\n error,\n });\n }\n}\n\n/\n Handle error using TTL + wait queue pattern for exponential backoff.\n \n ┌─────────────────────────────────────────────────────────────────┐\n * │ Retry Flow (Native RabbitMQ TTL + Wait queue pattern) │\n * ├─────────────────────────────────────────────────────────────────┤\n * │ │\n * │ 1. Handler throws any Error │\n * │ ↓ │\n * │ 2. Worker publishes to wait exchange \|\n * \| (with header `x-wait-queue` set to the wait queue name) │\n * │ ↓ │\n * │ 3. Wait exchange routes to wait queue │\n * │ (with expiration: calculated backoff delay) │\n * │ ↓ │\n * │ 4. Message waits in queue until TTL expires │\n * │ ↓ │\n * │ 5. Expired message dead-lettered to retry exchange \|\n * \| (with header `x-retry-queue` set to the main queue name) │\n * │ ↓ │\n * │ 6. Retry exchange routes back to main queue → RETRY │\n * │ ↓ │\n * │ 7. If retries exhausted: nack without requeue → DLQ │\n * │ │\n * └─────────────────────────────────────────────────────────────────┘\n /\nfunction handleErrorTtlBackoff(\n ctx: RetryContext,\n error: Error,\n msg: ConsumeMessage,\n consumerName: string,\n consumer: ConsumerDefinition,\n config: ResolvedTtlBackoffRetryOptions,\n): ResultAsync<void, TechnicalError> {\n if (!isQueueWithTtlBackoffInfrastructure(consumer.queue)) {\n ctx.logger?.error(\"Queue does not have TTL-backoff infrastructure\", {\n consumerName,\n queueName: consumer.queue.name,\n });\n return errAsync(new TechnicalError(\"Queue does not have TTL-backoff infrastructure\"));\n }\n\n const queueEntry = consumer.queue;\n const queue = extractQueue(queueEntry);\n const queueName = queue.name;\n\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 ctx.logger?.error(\"Max retries exceeded, sending to DLQ (ttl-backoff mode)\", {\n consumerName,\n queueName,\n retryCount,\n maxRetries: config.maxRetries,\n error: error.message,\n });\n sendToDLQ(ctx, msg, consumer);\n return okAsync(undefined);\n }\n\n // Retry with exponential backoff\n const delayMs = calculateRetryDelay(retryCount, config);\n ctx.logger?.warn(\"Retrying message (ttl-backoff mode)\", {\n consumerName,\n queueName,\n retryCount: retryCount + 1,\n maxRetries: config.maxRetries,\n delayMs,\n error: error.message,\n });\n\n // Re-publish the message to the wait exchange with TTL and incremented x-retry-count header\n return publishForRetry(ctx, {\n msg,\n exchange: queueEntry.waitExchange.name,\n routingKey: msg.fields.routingKey, // Preserve original routing key\n waitQueueName: queueEntry.waitQueue.name,\n queueName,\n delayMs,\n error,\n });\n}\n\n/\n Calculate retry delay with exponential backoff and optional jitter.\n /\nfunction 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 \n The channel is configured with `json: true`, so values published as plain\n * objects are encoded once at publish time. Re-publishing the raw `Buffer`\n * would then trigger a second JSON.stringify (turning the bytes into a\n * stringified base64 blob), so for JSON payloads we must round-trip back to\n * the parsed value. For any other content type — or when the message is\n * compressed — we pass the bytes through untouched, since re-parsing would\n * either fail or silently corrupt binary data.\n /\nfunction parseMessageContentForRetry(\n ctx: RetryContext,\n msg: ConsumeMessage,\n queueName: string,\n): Buffer \| unknown {\n if (msg.properties.contentEncoding) {\n // Compressed (gzip, brotli, …) — opaque to us; keep the buffer as-is so\n // the consumer's decompressor sees the same bytes the producer sent.\n return msg.content;\n }\n\n const contentType = msg.properties.contentType;\n const isJson =\n contentType === undefined \|\|\n contentType === \"application/json\" \|\|\n contentType.startsWith(\"application/json;\") \|\|\n contentType.endsWith(\"+json\");\n\n if (!isJson) {\n // Binary or other text payload — preserve bytes exactly.\n return msg.content;\n }\n\n try {\n return JSON.parse(msg.content.toString());\n } catch (parseErr) {\n ctx.logger?.warn(\"Failed to parse JSON message for retry, using original buffer\", {\n queueName,\n error: parseErr,\n });\n return msg.content;\n }\n}\n\n/\n Publish message with an incremented x-retry-count header and optional TTL.\n /\nfunction publishForRetry(\n ctx: RetryContext,\n {\n msg,\n exchange,\n routingKey,\n queueName,\n waitQueueName,\n delayMs,\n error,\n }: {\n msg: ConsumeMessage;\n exchange: string;\n routingKey: string;\n queueName: string;\n waitQueueName?: string;\n delayMs?: number;\n error: Error;\n },\n): ResultAsync<void, TechnicalError> {\n // Get retry count from headers\n const retryCount = (msg.properties.headers?.[\"x-retry-count\"] as number) ?? 0;\n const newRetryCount = retryCount + 1;\n\n // Acknowledge original message\n ctx.amqpClient.ack(msg);\n\n const content = parseMessageContentForRetry(ctx, msg, queueName);\n\n // Publish message with incremented x-retry-count header and original error info\n return ctx.amqpClient\n .publish(exchange, routingKey, content, {\n ...msg.properties,\n ...(delayMs !== undefined ? { 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 ...(waitQueueName !== undefined\n ? {\n \"x-wait-queue\": waitQueueName, // For wait exchange routing\n \"x-retry-queue\": queueName, // For retry exchange routing\n }\n : {}),\n },\n })\n .andThen((published) => {\n if (!published) {\n ctx.logger?.error(\"Failed to publish message for retry (write buffer full)\", {\n queueName,\n retryCount: newRetryCount,\n ...(delayMs !== undefined ? { delayMs } : {}),\n });\n return err(new TechnicalError(\"Failed to publish message for retry (write buffer full)\"));\n }\n\n ctx.logger?.info(\"Message published for retry\", {\n queueName,\n retryCount: newRetryCount,\n ...(delayMs !== undefined ? { delayMs } : {}),\n });\n return ok<void, TechnicalError>(undefined);\n });\n}\n\n/\n Send message to dead letter queue.\n * Nacks the message without requeue, relying on DLX configuration.\n /\nfunction sendToDLQ(ctx: RetryContext, msg: ConsumeMessage, consumer: ConsumerDefinition): void {\n const queue = extractQueue(consumer.queue);\n const queueName = queue.name;\n const hasDeadLetter = queue.deadLetter !== undefined;\n\n if (!hasDeadLetter) {\n ctx.logger?.warn(\"Queue does not have DLX configured - message will be lost on nack\", {\n queueName,\n });\n }\n\n ctx.logger?.info(\"Sending message to DLQ\", {\n queueName,\n deliveryTag: msg.fields.deliveryTag,\n });\n\n // Nack without requeue - relies on DLX configuration\n ctx.amqpClient.nack(msg, false, false);\n}\n","import {\n type ConsumerDefinition,\n type ContractDefinition,\n type InferConsumerNames,\n type InferRpcNames,\n extractConsumer,\n extractQueue,\n} from \"@amqp-contract/contract\";\nimport {\n AmqpClient,\n ConsumerOptions as AmqpClientConsumerOptions,\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 { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\nimport type { ConsumeMessage } from \"amqplib\";\nimport { err, errAsync, ok, okAsync, Result, ResultAsync } from \"neverthrow\";\nimport { decompressBuffer } from \"./decompression.js\";\nimport type { HandlerError } from \"./errors.js\";\nimport { MessageValidationError, NonRetryableError } from \"./errors.js\";\nimport { handleError } from \"./retry.js\";\nimport type { WorkerInferHandlers } from \"./types.js\";\n\n/\n Either a regular consumer name or an RPC name from the contract.\n /\ntype HandlerName<TContract extends ContractDefinition> =\n \| InferConsumerNames<TContract>\n \| InferRpcNames<TContract>;\n\n/\n Resolved handler entry stored on the worker, regardless of whether the\n * source is a `consumers` or `rpcs` slot. The handler signature is widened\n * here because both kinds share the same dispatch loop; specific call sites\n * cast back to the correct typed handler.\n /\ntype StoredHandler = (\n message: { payload: unknown; headers: unknown },\n rawMessage: ConsumeMessage,\n) => ResultAsync<unknown, HandlerError>;\n\nexport type ConsumerOptions = AmqpClientConsumerOptions;\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 okAsync(undefined);\n * },\n * // Handler with prefetch configuration\n * processPayment: [\n * ({ payload }) => {\n * console.log('Processing payment:', payload.paymentId);\n * return okAsync(undefined);\n * },\n * { prefetch: 10 }\n * ]\n * },\n * urls: ['amqp://localhost'],\n * defaultConsumerOptions: {\n * prefetch: 5,\n * },\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 `consumers` and `rpcs` entry in the contract.\n \n - Regular consumers return `ResultAsync<void, HandlerError>`.\n * - RPC handlers return `ResultAsync<TResponse, HandlerError>` where\n * `TResponse` is inferred from the RPC's response message schema.\n \n Use `defineHandler` / `defineHandlers` to create handlers with full type\n * inference.\n /\n handlers: WorkerInferHandlers<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 Optional default consumer options applied to all consumer handlers.\n * Handler-specific options provided in tuple form override these defaults.\n /\n defaultConsumerOptions?: ConsumerOptions \| undefined;\n /\n Maximum time in ms to wait for the AMQP connection to become ready before\n * `create()` resolves to an `err(TechnicalError)`. Defaults to 30s\n * (the {@link AmqpClient}'s `DEFAULT_CONNECT_TIMEOUT_MS`). Pass `null` to\n * disable the timeout and let amqp-connection-manager retry indefinitely.\n /\n connectTimeoutMs?: number \| null \| 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 { okAsync } from 'neverthrow';\n * import { z } from 'zod';\n \n const orderQueue = defineQueue('order-processing');\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 result = await TypedAmqpWorker.create({\n * contract,\n * handlers: {\n * processOrder: ({ payload }) => {\n * console.log('Processing order', payload.orderId);\n * return okAsync(undefined);\n * },\n * },\n * urls: ['amqp://localhost'],\n * });\n \n if (result.isErr()) throw result.error;\n * const worker = result.value;\n \n // Close when done\n * await worker.close();\n * ```\n /\nexport class TypedAmqpWorker<TContract extends ContractDefinition> {\n /\n Internal handler storage. Keyed by handler name (consumer or RPC); the\n * stored function signature is widened so the dispatch loop can call it\n * uniformly. The actual handler is type-checked at the worker's public API\n * boundary via `WorkerInferHandlers<TContract>`.\n /\n private readonly actualHandlers: Partial<Record<HandlerName<TContract>, StoredHandler>>;\n private readonly consumerOptions: Partial<Record<HandlerName<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: WorkerInferHandlers<TContract>,\n private readonly defaultConsumerOptions: ConsumerOptions,\n private readonly logger?: Logger,\n telemetry?: TelemetryProvider,\n ) {\n this.telemetry = telemetry ?? defaultTelemetryProvider;\n\n this.actualHandlers = {};\n this.consumerOptions = {};\n\n const handlersRecord = handlers as Record<string, unknown>;\n\n for (const handlerName of Object.keys(handlersRecord)) {\n const handlerEntry = handlersRecord[handlerName];\n const typedName = handlerName as HandlerName<TContract>;\n\n if (isHandlerTuple(handlerEntry)) {\n const [handler, options] = handlerEntry;\n this.actualHandlers[typedName] = handler as StoredHandler;\n this.consumerOptions[typedName] = {\n ...this.defaultConsumerOptions,\n ...options,\n };\n } else {\n this.actualHandlers[typedName] = handlerEntry as StoredHandler;\n this.consumerOptions[typedName] = this.defaultConsumerOptions;\n }\n }\n }\n\n /\n Build a `ConsumerDefinition`-shaped view for a handler name, regardless\n * of whether it came from `contract.consumers` or `contract.rpcs`. The\n * dispatch path treats both uniformly; the returned `isRpc` flag (and the\n * accompanying `responseSchema`) tells `processMessage` whether to validate\n * the handler return value and publish a reply.\n /\n private resolveConsumerView(name: HandlerName<TContract>): {\n consumer: ConsumerDefinition;\n isRpc: boolean;\n responseSchema?: StandardSchemaV1;\n } {\n // Use `Object.hasOwn` rather than `key in rpcs` so prototype properties\n // (e.g. \"toString\") on a plain object are not misclassified as RPC names.\n const rpcs = this.contract.rpcs;\n if (rpcs && Object.hasOwn(rpcs, name as string)) {\n const rpc = rpcs[name as string]!;\n return {\n consumer: { queue: rpc.queue, message: rpc.request },\n isRpc: true,\n responseSchema: rpc.response.payload,\n };\n }\n const consumerEntry = this.contract.consumers![name as string]!;\n return {\n consumer: extractConsumer(consumerEntry),\n isRpc: false,\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 @returns A ResultAsync that resolves to the worker or a TechnicalError.\n \n @example\n * ```typescript\n * const result = await TypedAmqpWorker.create({\n * contract: myContract,\n * handlers: {\n * processOrder: ({ payload }) => okAsync(undefined),\n * },\n * urls: ['amqp://localhost'],\n * });\n * ```\n /\n static create<TContract extends ContractDefinition>({\n contract,\n handlers,\n urls,\n connectionOptions,\n defaultConsumerOptions,\n logger,\n telemetry,\n connectTimeoutMs,\n }: CreateWorkerOptions<TContract>): ResultAsync<TypedAmqpWorker<TContract>, TechnicalError> {\n const worker = new TypedAmqpWorker(\n contract,\n new AmqpClient(contract, {\n urls,\n connectionOptions,\n connectTimeoutMs,\n }),\n handlers,\n defaultConsumerOptions ?? {},\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 const setup = worker.waitForConnectionReady().andThen(() => worker.consumeAll());\n\n // If setup fails, release the AmqpClient's connection ref-count and cancel\n // any consumers that registered before the failure, so a failed create()\n // does not leak.\n return new ResultAsync<TypedAmqpWorker<TContract>, TechnicalError>(\n (async () => {\n const setupResult = await setup;\n if (setupResult.isOk()) {\n return ok(worker);\n }\n const closeResult = await worker.close();\n if (closeResult.isErr()) {\n logger?.warn(\"Failed to close worker after setup failure\", {\n error: closeResult.error,\n });\n }\n return err(setupResult.error);\n })(),\n );\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 @example\n * ```typescript\n * const closeResult = await worker.close();\n * if (closeResult.isOk()) {\n * console.log('Worker closed successfully');\n * }\n * ```\n /\n close(): ResultAsync<void, TechnicalError> {\n const cancellations = Array.from(this.consumerTags).map((consumerTag) =>\n // Swallow per-consumer cancel errors during close — they are best-effort\n // cleanup and we still want to release the underlying connection.\n this.amqpClient.cancel(consumerTag).orElse((error) => {\n this.logger?.warn(\"Failed to cancel consumer during close\", { consumerTag, error });\n return ok<void, TechnicalError>(undefined);\n }),\n );\n\n return ResultAsync.combine(cancellations)\n .andTee(() => {\n this.consumerTags.clear();\n })\n .andThen(() => this.amqpClient.close())\n .map(() => undefined);\n }\n\n /\n Start consuming for every entry in `contract.consumers` and `contract.rpcs`.\n /\n private consumeAll(): ResultAsync<void, TechnicalError> {\n const consumerNames = Object.keys(\n this.contract.consumers ?? {},\n ) as InferConsumerNames<TContract>[];\n const rpcNames = Object.keys(this.contract.rpcs ?? {}) as InferRpcNames<TContract>[];\n const allNames = [...consumerNames, ...rpcNames] as HandlerName<TContract>[];\n\n return ResultAsync.combine(allNames.map((name) => this.consume(name))).map(() => undefined);\n }\n\n private waitForConnectionReady(): ResultAsync<void, TechnicalError> {\n return this.amqpClient.waitForConnect();\n }\n\n /\n Start consuming messages for a specific handler — either a `consumers`\n * entry (regular event/command consumer) or an `rpcs` entry (RPC server).\n /\n private consume(name: HandlerName<TContract>): ResultAsync<void, TechnicalError> {\n const view = this.resolveConsumerView(name);\n // Non-null assertion safe: `WorkerInferHandlers<TContract>` requires every\n // consumers / rpcs key to have a handler, so by the time we reach this\n // dispatch path the entry exists in `actualHandlers`. Enforced by the type\n // system at the public API boundary, not by a runtime check.\n const handler = this.actualHandlers[name]!;\n\n return this.consumeSingle(name, view, handler);\n }\n\n /\n Validate data against a Standard Schema. No side effects; the caller is\n * responsible for ack/nack based on the Result.\n /\n private validateSchema(\n schema: StandardSchemaV1,\n data: unknown,\n context: { consumerName: string; field: string },\n ): ResultAsync<unknown, TechnicalError> {\n const rawValidation = schema[\"~standard\"].validate(data);\n const validationPromise =\n rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);\n\n return ResultAsync.fromPromise(\n validationPromise,\n (error) => new TechnicalError(`Error validating ${context.field}`, error),\n ).andThen((result) => {\n if (result.issues) {\n return err(\n new TechnicalError(\n `${context.field} validation failed`,\n new MessageValidationError(context.consumerName, result.issues),\n ),\n );\n }\n return ok<unknown, TechnicalError>(result.value);\n });\n }\n\n /\n Parse and validate a message from AMQP. Pure: returns the validated payload\n * and headers, or an error. The dispatch path in {@link processMessage} routes\n * validation/parse errors directly to the DLQ (single nack) — they never enter\n * the retry pipeline because retrying an unparseable or schema-violating\n * payload cannot succeed.\n /\n private parseAndValidateMessage(\n msg: ConsumeMessage,\n consumer: ConsumerDefinition,\n consumerName: HandlerName<TContract>,\n ): ResultAsync<{ payload: unknown; headers: unknown }, TechnicalError> {\n const context = { consumerName: String(consumerName) };\n\n const parsePayload = decompressBuffer(msg.content, msg.properties.contentEncoding)\n .andThen((buffer) =>\n Result.fromThrowable(\n () => JSON.parse(buffer.toString()) as unknown,\n (error) => new TechnicalError(\"Failed to parse JSON\", error),\n )(),\n )\n .andThen((parsed) =>\n this.validateSchema(consumer.message.payload as StandardSchemaV1, parsed, {\n ...context,\n field: \"payload\",\n }),\n );\n\n const parseHeaders: ResultAsync<unknown, TechnicalError> = consumer.message.headers\n ? this.validateSchema(\n consumer.message.headers as StandardSchemaV1,\n msg.properties.headers ?? {},\n {\n ...context,\n field: \"headers\",\n },\n )\n : okAsync(undefined);\n\n return ResultAsync.combine([parsePayload, parseHeaders]).map(([payload, headers]) => ({\n payload,\n headers,\n }));\n }\n\n /\n Validate an RPC handler's response and publish it back to the caller's reply\n * queue with the same `correlationId`. Published via the AMQP default exchange\n * with `routingKey = msg.properties.replyTo`, which works for both\n * `amq.rabbitmq.reply-to` and any anonymous queue declared by the caller.\n \n Failure semantics:\n * - Missing replyTo / correlationId: NonRetryableError. The caller is\n * already lost; retrying the original message cannot recover the reply\n * path. The poison message lands in DLQ for inspection rather than being\n * silently ack'd (which would mask a contract violation).\n * - Schema validation failure: NonRetryableError — the handler returned\n * the wrong shape; retrying the same input will not fix it.\n * - Publish failure: NonRetryableError. The caller has already timed out\n * (or will shortly), so retrying the message wastes the queue's retry\n * budget on a reply that no one is waiting for. The message is logged and\n * DLQ'd; the original work is treated as completed for the purpose of the\n * inbox.\n /\n private publishRpcResponse(\n msg: ConsumeMessage,\n queueName: string,\n rpcName: HandlerName<TContract>,\n responseSchema: StandardSchemaV1,\n response: unknown,\n ): ResultAsync<void, HandlerError> {\n const replyTo = msg.properties.replyTo;\n const correlationId = msg.properties.correlationId;\n if (typeof replyTo !== \"string\" \|\| replyTo.length === 0) {\n this.logger?.error(\n \"RPC handler returned a response but the incoming message has no replyTo\",\n { rpcName: String(rpcName), queueName },\n );\n return errAsync(\n new NonRetryableError(\n `RPC \"${String(rpcName)}\" received a message without replyTo; cannot deliver response`,\n ),\n );\n }\n if (typeof correlationId !== \"string\" \|\| correlationId.length === 0) {\n // Without a correlationId the client cannot match the reply to its\n // pending call — publishing anyway would guarantee a client-side timeout.\n this.logger?.error(\n \"RPC handler returned a response but the incoming message has no correlationId\",\n { rpcName: String(rpcName), queueName, replyTo },\n );\n return errAsync(\n new NonRetryableError(\n `RPC \"${String(rpcName)}\" received a message without correlationId; cannot deliver response`,\n ),\n );\n }\n\n // Wrap the call to `validate` itself in try/catch — a Standard Schema\n // implementation may throw synchronously (not via a rejected Promise), and\n // we don't want that to crash the consume callback.\n let rawValidation: ReturnType<StandardSchemaV1[\"~standard\"][\"validate\"]>;\n try {\n rawValidation = responseSchema[\"~standard\"].validate(response);\n } catch (error: unknown) {\n return errAsync(new NonRetryableError(\"RPC response schema validation threw\", error));\n }\n const validationPromise =\n rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);\n\n return ResultAsync.fromPromise(\n validationPromise,\n (error: unknown) =>\n new NonRetryableError(\"RPC response schema validation threw\", error) as HandlerError,\n )\n .andThen((validation) => {\n if (validation.issues) {\n return err<unknown, HandlerError>(\n new NonRetryableError(\n `RPC response for \"${String(rpcName)}\" failed schema validation`,\n new MessageValidationError(String(rpcName), validation.issues),\n ),\n );\n }\n return ok<unknown, HandlerError>(validation.value);\n })\n .andThen((validatedResponse) =>\n this.amqpClient\n .publish(\"\", replyTo, validatedResponse, {\n correlationId,\n contentType: \"application/json\",\n })\n // Reply-side failures are not retryable from the inbox: by the time\n // the broker can't deliver the reply, the caller's RPC future has\n // already (or will soon) time out. Retrying the original message\n // re-runs the handler against a stale caller. Send to DLQ instead so\n // the failure is visible without churning the queue.\n .mapErr(\n (error: TechnicalError): HandlerError =>\n new NonRetryableError(\"Failed to publish RPC response\", error),\n )\n .andThen((published) =>\n published\n ? ok<void, HandlerError>(undefined)\n : err<void, HandlerError>(\n new NonRetryableError(\"Failed to publish RPC response: channel buffer full\"),\n ),\n ),\n );\n }\n\n /\n Process a single consumed message: validate, invoke handler, optionally\n * publish the RPC response, record telemetry, and handle errors.\n /\n private processMessage(\n msg: ConsumeMessage,\n view: { consumer: ConsumerDefinition; isRpc: boolean; responseSchema?: StandardSchemaV1 },\n name: HandlerName<TContract>,\n handler: StoredHandler,\n ): ResultAsync<void, TechnicalError> {\n const { consumer, isRpc, responseSchema } = view;\n const queueName = extractQueue(consumer.queue).name;\n const startTime = Date.now();\n const span = startConsumeSpan(this.telemetry, queueName, String(name), {\n \"messaging.rabbitmq.message.delivery_tag\": msg.fields.deliveryTag,\n });\n\n let messageHandled = false;\n let firstError: Error \| undefined;\n\n // Parse / validation failure path: nack once with requeue=false so the\n // queue's DLX (if configured) receives the poison message. We bypass\n // handleError() because a malformed payload is deterministic — retrying\n // it would burn the queue's retry budget on a guaranteed failure.\n const parsedOrNack = this.parseAndValidateMessage(msg, consumer, name).orElse((parseError) => {\n firstError = parseError;\n this.logger?.error(\"Failed to parse/validate message; sending to DLQ\", {\n consumerName: String(name),\n queueName,\n error: parseError,\n });\n this.amqpClient.nack(msg, false, false);\n return errAsync(parseError);\n });\n\n const inner: ResultAsync<void, TechnicalError> = parsedOrNack.andThen((validatedMessage) =>\n handler(validatedMessage, msg)\n .andThen<void, HandlerError>((handlerResponse) => {\n if (isRpc && responseSchema) {\n return this.publishRpcResponse(\n msg,\n queueName,\n name,\n responseSchema,\n handlerResponse,\n ).map(() => {\n this.logger?.info(\"Message consumed successfully\", {\n consumerName: String(name),\n queueName,\n });\n this.amqpClient.ack(msg);\n messageHandled = true;\n });\n }\n\n this.logger?.info(\"Message consumed successfully\", {\n consumerName: String(name),\n queueName,\n });\n this.amqpClient.ack(msg);\n messageHandled = true;\n return okAsync<void, HandlerError>(undefined);\n })\n .orElse((handlerError: HandlerError) => {\n this.logger?.error(\"Error processing message\", {\n consumerName: String(name),\n queueName,\n errorType: handlerError.name,\n error: handlerError.message,\n });\n firstError = handlerError;\n\n return handleError(\n { amqpClient: this.amqpClient, logger: this.logger },\n handlerError,\n msg,\n String(name),\n consumer,\n );\n }),\n );\n\n return new ResultAsync<void, TechnicalError>(\n (async () => {\n const result = await inner;\n const durationMs = Date.now() - startTime;\n if (messageHandled) {\n endSpanSuccess(span);\n recordConsumeMetric(this.telemetry, queueName, String(name), true, durationMs);\n } else {\n const error = result.isErr() ? result.error : (firstError ?? new Error(\"Unknown error\"));\n endSpanError(span, error);\n recordConsumeMetric(this.telemetry, queueName, String(name), false, durationMs);\n }\n return result;\n })(),\n );\n }\n\n /\n Consume messages one at a time.\n /\n private consumeSingle(\n name: HandlerName<TContract>,\n view: { consumer: ConsumerDefinition; isRpc: boolean; responseSchema?: StandardSchemaV1 },\n handler: StoredHandler,\n ): ResultAsync<void, TechnicalError> {\n const queueName = extractQueue(view.consumer.queue).name;\n\n return this.amqpClient\n .consume(\n queueName,\n async (msg) => {\n if (msg === null) {\n this.logger?.warn(\"Consumer cancelled by server\", {\n consumerName: String(name),\n queueName,\n });\n return;\n }\n // The dispatch path is built on `ResultAsync` so handler failures\n // are values, not exceptions. Defensively guard the boundary anyway:\n // a handler that violates the contract by throwing synchronously (or\n // any unexpected fault inside processMessage) would otherwise leave\n // the message neither acked nor nacked, and amqp-connection-manager\n // would not redeliver it until the channel closes. nack(requeue=false)\n // routes it via DLX if configured.\n try {\n await this.processMessage(msg, view, name, handler);\n } catch (error: unknown) {\n this.logger?.error(\"Uncaught error in consume callback; nacking message\", {\n consumerName: String(name),\n queueName,\n error,\n });\n this.amqpClient.nack(msg, false, false);\n }\n },\n this.consumerOptions[name],\n )\n .andTee((consumerTag) => {\n this.consumerTags.add(consumerTag);\n })\n .map(() => undefined)\n .mapErr(\n (error) => new TechnicalError(`Failed to start consuming for \"${String(name)}\"`, error),\n );\n }\n}\n","import type { ContractDefinition, InferConsumerNames } from \"@amqp-contract/contract\";\nimport type {\n WorkerInferConsumerHandler,\n WorkerInferConsumerHandlerEntry,\n WorkerInferConsumerHandlers,\n} from \"./types.js\";\nimport { ConsumerOptions } from \"./worker.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 `ResultAsync<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 `ResultAsync<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 { errAsync, okAsync, ResultAsync } from 'neverthrow';\n * import { orderContract } from './contract';\n \n // Simple handler with explicit error handling\n * const processOrderHandler = defineHandler(\n * orderContract,\n * 'processOrder',\n * ({ payload }) =>\n * ResultAsync.fromPromise(\n * processPayment(payload),\n * (error) => new RetryableError('Payment failed', error),\n * ).map(() => undefined),\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 errAsync(new NonRetryableError('Invalid order amount'));\n * }\n * return okAsync(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: ConsumerOptions,\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?: ConsumerOptions,\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 `ResultAsync<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 { ResultAsync } from 'neverthrow';\n * import { orderContract } from './contract';\n \n const handlers = defineHandlers(orderContract, {\n * processOrder: ({ payload }) =>\n * ResultAsync.fromPromise(\n * processPayment(payload),\n * (error) => new RetryableError('Payment failed', error),\n * ).map(() => undefined),\n * notifyOrder: ({ payload }) =>\n * ResultAsync.fromPromise(\n * sendNotification(payload),\n * (error) => new RetryableError('Notification failed', error),\n * ).map(() => undefined),\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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"}
1	+ {"version":3,"file":"index.mjs","names":[],"sources":["../src/decompression.ts","../src/errors.ts","../src/retry.ts","../src/worker.ts","../src/handlers.ts"],"sourcesContent":["import { TechnicalError } from \"@amqp-contract/core\";\nimport { errAsync, okAsync, ResultAsync } from \"neverthrow\";\nimport { gunzip, inflate } from \"node:zlib\";\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 ResultAsync resolving to the decompressed buffer or a TechnicalError\n \n @internal\n /\nexport function decompressBuffer(\n buffer: Buffer,\n contentEncoding: string \| undefined,\n): ResultAsync<Buffer, TechnicalError> {\n if (!contentEncoding) {\n return okAsync(buffer);\n }\n\n const normalizedEncoding = contentEncoding.toLowerCase();\n\n if (!isSupportedEncoding(normalizedEncoding)) {\n return errAsync(\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 switch (normalizedEncoding) {\n case \"gzip\":\n return ResultAsync.fromPromise(\n gunzipAsync(buffer),\n (error) => new TechnicalError(\"Failed to decompress gzip\", error),\n );\n case \"deflate\":\n return ResultAsync.fromPromise(\n inflateAsync(buffer),\n (error) => new TechnicalError(\"Failed to decompress deflate\", error),\n );\n }\n}\n","export { MessageValidationError } from \"@amqp-contract/core\";\n\n/\n Abstract base class for all handler-signalled errors.\n \n Concrete subclasses (`RetryableError`, `NonRetryableError`) discriminate on\n * the `name` property so exhaustive narrowing in user code keeps working.\n * `error instanceof HandlerError` is true for any handler error.\n /\nexport abstract class HandlerError extends Error {\n abstract override readonly name: \"RetryableError\" \| \"NonRetryableError\";\n\n constructor(\n message: string,\n public override readonly cause?: unknown,\n ) {\n super(message);\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 HandlerError {\n override readonly name = \"RetryableError\" as const;\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 HandlerError {\n override readonly name = \"NonRetryableError\" as const;\n}\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 error instanceof HandlerError;\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 { ResultAsync } from 'neverthrow';\n \n const handler = ({ payload }) =>\n * ResultAsync.fromPromise(\n * processPayment(payload),\n * (e) => retryable('Payment service unavailable', e),\n * ).map(() => undefined);\n \n // Equivalent to:\n * // ResultAsync.fromPromise(processPayment(payload), (e) => new RetryableError('...', 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 { errAsync, okAsync } from 'neverthrow';\n \n const handler = ({ payload }) => {\n * if (!isValidPayload(payload)) {\n * return errAsync(nonRetryable('Invalid payload format'));\n * }\n * return okAsync(undefined);\n * };\n \n // Equivalent to:\n * // return errAsync(new NonRetryableError('Invalid payload format'));\n * ```\n /\nexport function nonRetryable(message: string, cause?: unknown): NonRetryableError {\n return new NonRetryableError(message, cause);\n}\n","import {\n type ConsumerDefinition,\n type ResolvedImmediateRequeueRetryOptions,\n type ResolvedTtlBackoffRetryOptions,\n extractQueue,\n isQueueWithTtlBackoffInfrastructure,\n} from \"@amqp-contract/contract\";\nimport { type AmqpClient, type Logger, TechnicalError } from \"@amqp-contract/core\";\nimport type { ConsumeMessage } from \"amqplib\";\nimport { err, errAsync, ok, okAsync, ResultAsync } from \"neverthrow\";\nimport { NonRetryableError } from \"./errors.js\";\n\ntype RetryContext = {\n amqpClient: AmqpClient;\n logger?: Logger \| undefined;\n};\n\n/\n Handle error in message processing with retry logic.\n \n Flow depends on retry mode:\n \n immediate-requeue mode:\n * 1. If NonRetryableError -> send directly to DLQ (no retry)\n * 2. If max retries exceeded -> send to DLQ\n * 3. Otherwise -> requeue immediately for retry\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 none mode (no retry config):\n * 1. send directly to DLQ (no retry)\n /\nexport function handleError(\n ctx: RetryContext,\n error: Error,\n msg: ConsumeMessage,\n consumerName: string,\n consumer: ConsumerDefinition,\n): ResultAsync<void, TechnicalError> {\n // NonRetryableError -> send directly to DLQ without retrying.\n // The caller already logged the original error; we only emit a routing\n // decision log inside `sendToDLQ`.\n if (error instanceof NonRetryableError) {\n sendToDLQ(ctx, msg, consumer);\n return okAsync(undefined);\n }\n\n // Get retry config from the queue definition in the contract\n const config = extractQueue(consumer.queue).retry;\n\n // Immediate-requeue mode: requeue the message immediately\n if (config.mode === \"immediate-requeue\") {\n return handleErrorImmediateRequeue(ctx, error, msg, consumerName, consumer, config);\n }\n\n // TTL-backoff mode: use wait queue with exponential backoff\n if (config.mode === \"ttl-backoff\") {\n return handleErrorTtlBackoff(ctx, error, msg, consumerName, consumer, config);\n }\n\n // None mode: no retry, send directly to DLQ or reject. The caller already\n // logged the original error; emit an info-level routing-decision log so\n // operators can distinguish this DLQ path from `NonRetryableError` and\n // max-retries exhaustion paths in retry.ts.\n ctx.logger?.info(\"Retry disabled (none mode), sending to DLQ\", {\n consumerName,\n queueName: extractQueue(consumer.queue).name,\n });\n sendToDLQ(ctx, msg, consumer);\n return okAsync(undefined);\n}\n\n/\n Handle error by requeuing immediately.\n \n For quorum queues, messages are requeued with `nack(requeue=true)`, and the worker tracks delivery count via the native RabbitMQ `x-delivery-count` header.\n * For classic queues, messages are re-published on the same queue, and the worker tracks delivery count via a custom `x-retry-count` header.\n * When the count exceeds `maxRetries`, the message is automatically dead-lettered (if DLX is configured) or dropped.\n \n This is simpler than TTL-based retry but provides immediate retries only.\n /\nfunction handleErrorImmediateRequeue(\n ctx: RetryContext,\n error: Error,\n msg: ConsumeMessage,\n consumerName: string,\n consumer: ConsumerDefinition,\n config: ResolvedImmediateRequeueRetryOptions,\n): ResultAsync<void, TechnicalError> {\n const queue = extractQueue(consumer.queue);\n const queueName = queue.name;\n\n // Get retry count from headers\n // For quorum queues, the header x-delivery-count is automatically incremented on each delivery attempt\n // For classic queues, the header x-retry-count is manually incremented by the worker when re-publishing messages\n const retryCount =\n queue.type === \"quorum\"\n ? ((msg.properties.headers?.[\"x-delivery-count\"] as number) ?? 0)\n : ((msg.properties.headers?.[\"x-retry-count\"] as number) ?? 0);\n\n // Max retries exceeded -> DLQ. The caller already logged the original error;\n // emit only the routing decision here.\n if (retryCount >= config.maxRetries) {\n ctx.logger?.info(\"Max retries exceeded, sending to DLQ (immediate-requeue mode)\", {\n consumerName,\n queueName,\n retryCount,\n maxRetries: config.maxRetries,\n });\n sendToDLQ(ctx, msg, consumer);\n return okAsync(undefined);\n }\n\n ctx.logger?.info(\"Retrying message (immediate-requeue mode)\", {\n consumerName,\n queueName,\n retryCount,\n maxRetries: config.maxRetries,\n });\n\n if (queue.type === \"quorum\") {\n // For quorum queues, nack with requeue=true to trigger native retry mechanism\n ctx.amqpClient.nack(msg, false, true);\n return okAsync(undefined);\n } else {\n // For classic queues, re-publish the message to the same exchange / routing key immediately with an incremented x-retry-count header\n return publishForRetry(ctx, {\n msg,\n exchange: msg.fields.exchange,\n routingKey: msg.fields.routingKey,\n queueName,\n error,\n });\n }\n}\n\n/\n Handle error using TTL + wait queue pattern for exponential backoff.\n \n ┌─────────────────────────────────────────────────────────────────┐\n * │ Retry Flow (Native RabbitMQ TTL + Wait queue pattern) │\n * ├─────────────────────────────────────────────────────────────────┤\n * │ │\n * │ 1. Handler throws any Error │\n * │ ↓ │\n * │ 2. Worker publishes to wait exchange \|\n * \| (with header `x-wait-queue` set to the wait queue name) │\n * │ ↓ │\n * │ 3. Wait exchange routes to wait queue │\n * │ (with expiration: calculated backoff delay) │\n * │ ↓ │\n * │ 4. Message waits in queue until TTL expires │\n * │ ↓ │\n * │ 5. Expired message dead-lettered to retry exchange \|\n * \| (with header `x-retry-queue` set to the main queue name) │\n * │ ↓ │\n * │ 6. Retry exchange routes back to main queue → RETRY │\n * │ ↓ │\n * │ 7. If retries exhausted: nack without requeue → DLQ │\n * │ │\n * └─────────────────────────────────────────────────────────────────┘\n /\nfunction handleErrorTtlBackoff(\n ctx: RetryContext,\n error: Error,\n msg: ConsumeMessage,\n consumerName: string,\n consumer: ConsumerDefinition,\n config: ResolvedTtlBackoffRetryOptions,\n): ResultAsync<void, TechnicalError> {\n if (!isQueueWithTtlBackoffInfrastructure(consumer.queue)) {\n ctx.logger?.error(\"Queue does not have TTL-backoff infrastructure\", {\n consumerName,\n queueName: consumer.queue.name,\n });\n return errAsync(new TechnicalError(\"Queue does not have TTL-backoff infrastructure\"));\n }\n\n const queueEntry = consumer.queue;\n const queue = extractQueue(queueEntry);\n const queueName = queue.name;\n\n // Get retry count from headers\n const retryCount = (msg.properties.headers?.[\"x-retry-count\"] as number) ?? 0;\n\n // Max retries exceeded -> DLQ. The caller already logged the original error;\n // emit only the routing decision here.\n if (retryCount >= config.maxRetries) {\n ctx.logger?.info(\"Max retries exceeded, sending to DLQ (ttl-backoff mode)\", {\n consumerName,\n queueName,\n retryCount,\n maxRetries: config.maxRetries,\n });\n sendToDLQ(ctx, msg, consumer);\n return okAsync(undefined);\n }\n\n // Retry with exponential backoff\n const delayMs = calculateRetryDelay(retryCount, config);\n ctx.logger?.info(\"Retrying message (ttl-backoff mode)\", {\n consumerName,\n queueName,\n retryCount: retryCount + 1,\n maxRetries: config.maxRetries,\n delayMs,\n });\n\n // Re-publish the message to the wait exchange with TTL and incremented x-retry-count header\n return publishForRetry(ctx, {\n msg,\n exchange: queueEntry.waitExchange.name,\n routingKey: msg.fields.routingKey, // Preserve original routing key\n waitQueueName: queueEntry.waitQueue.name,\n queueName,\n delayMs,\n error,\n });\n}\n\n/\n Calculate retry delay with exponential backoff and optional jitter.\n /\nfunction calculateRetryDelay(retryCount: number, config: ResolvedTtlBackoffRetryOptions): number {\n const { initialDelayMs, maxDelayMs, backoffMultiplier, jitter } = config;\n\n let delay = initialDelayMs Math.pow(backoffMultiplier, retryCount);\n\n if (jitter) {\n // ± 50% jitter, centred on the calculated delay (range: [0.5x, 1.5x],\n // mean 1.0x). The previous formula `0.5 + Math.random() * 0.5` produced\n // [0.5x, 1.0x] (mean 0.75x) and never overshot — that's a one-sided bias,\n // not real jitter.\n delay = delay * (0.5 + Math.random());\n }\n\n // Clamp AFTER jitter so the upper jitter bound cannot push the delay past\n // `maxDelayMs`.\n return Math.floor(Math.min(delay, maxDelayMs));\n}\n\n/*\n Parse message content for republishing.\n \n The channel is configured with `json: true`, so values published as plain\n * objects are encoded once at publish time. Re-publishing the raw `Buffer`\n * would then trigger a second JSON.stringify (turning the bytes into a\n * stringified base64 blob), so for JSON payloads we must round-trip back to\n * the parsed value. For any other content type — or when the message is\n * compressed — we pass the bytes through untouched, since re-parsing would\n * either fail or silently corrupt binary data.\n /\nfunction parseMessageContentForRetry(\n ctx: RetryContext,\n msg: ConsumeMessage,\n queueName: string,\n): Buffer \| unknown {\n if (msg.properties.contentEncoding) {\n // Compressed (gzip, brotli, …) — opaque to us; keep the buffer as-is so\n // the consumer's decompressor sees the same bytes the producer sent.\n return msg.content;\n }\n\n const contentType = msg.properties.contentType;\n const isJson =\n contentType === undefined \|\|\n contentType === \"application/json\" \|\|\n contentType.startsWith(\"application/json;\") \|\|\n contentType.endsWith(\"+json\");\n\n if (!isJson) {\n // Binary or other text payload — preserve bytes exactly.\n return msg.content;\n }\n\n try {\n return JSON.parse(msg.content.toString());\n } catch (parseErr) {\n ctx.logger?.warn(\"Failed to parse JSON message for retry, using original buffer\", {\n queueName,\n error: parseErr,\n });\n return msg.content;\n }\n}\n\n/\n Publish message with an incremented x-retry-count header and optional TTL.\n /\nfunction publishForRetry(\n ctx: RetryContext,\n {\n msg,\n exchange,\n routingKey,\n queueName,\n waitQueueName,\n delayMs,\n error,\n }: {\n msg: ConsumeMessage;\n exchange: string;\n routingKey: string;\n queueName: string;\n waitQueueName?: string;\n delayMs?: number;\n error: Error;\n },\n): ResultAsync<void, TechnicalError> {\n // Get retry count from headers\n const retryCount = (msg.properties.headers?.[\"x-retry-count\"] as number) ?? 0;\n const newRetryCount = retryCount + 1;\n\n const content = parseMessageContentForRetry(ctx, msg, queueName);\n\n // Publish FIRST, then ack the original only if the publish succeeded.\n //\n // Acking before publishing would lose the message if the publish then fails:\n // the broker has already discarded the original delivery and the retry copy\n // never made it out. By publishing first and acking on success, we ensure the\n // message is not lost on a publish failure — leaving the original un-ack'd\n // makes amqp-connection-manager redeliver it (or, on channel close, the\n // broker re-enqueues), so we either get the retry through or get another\n // chance at the original.\n return ctx.amqpClient\n .publish(exchange, routingKey, content, {\n ...msg.properties,\n ...(delayMs !== undefined ? { 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 ...(waitQueueName !== undefined\n ? {\n \"x-wait-queue\": waitQueueName, // For wait exchange routing\n \"x-retry-queue\": queueName, // For retry exchange routing\n }\n : {}),\n },\n })\n .andThen((published) => {\n if (!published) {\n // Publish was rejected (channel buffer full / channel error). Do NOT\n // ack the original — leave it un-ack'd so the broker / channel manager\n // can redeliver it once the channel recovers.\n ctx.logger?.error(\"Failed to publish message for retry (write buffer full)\", {\n queueName,\n retryCount: newRetryCount,\n ...(delayMs !== undefined ? { delayMs } : {}),\n });\n return err(new TechnicalError(\"Failed to publish message for retry (write buffer full)\"));\n }\n\n // Publish confirmed by the broker — safe to ack the original now.\n ctx.amqpClient.ack(msg);\n\n ctx.logger?.info(\"Message published for retry\", {\n queueName,\n retryCount: newRetryCount,\n ...(delayMs !== undefined ? { delayMs } : {}),\n });\n return ok<void, TechnicalError>(undefined);\n })\n .orElse((publishError) => {\n // Publish threw (network error, channel close, etc.). Same policy: do\n // not ack the original; the redelivery path is the recovery mechanism.\n ctx.logger?.error(\"Publish for retry failed; leaving original un-ack'd for redelivery\", {\n queueName,\n retryCount: newRetryCount,\n ...(delayMs !== undefined ? { delayMs } : {}),\n error: publishError,\n });\n return err(publishError);\n });\n}\n\n/\n Send message to dead letter queue.\n * Nacks the message without requeue, relying on DLX configuration.\n /\nfunction sendToDLQ(ctx: RetryContext, msg: ConsumeMessage, consumer: ConsumerDefinition): void {\n const queue = extractQueue(consumer.queue);\n const queueName = queue.name;\n const hasDeadLetter = queue.deadLetter !== undefined;\n\n if (!hasDeadLetter) {\n ctx.logger?.warn(\"Queue does not have DLX configured - message will be lost on nack\", {\n queueName,\n });\n }\n\n ctx.logger?.info(\"Sending message to DLQ\", {\n queueName,\n deliveryTag: msg.fields.deliveryTag,\n });\n\n // Nack without requeue - relies on DLX configuration\n ctx.amqpClient.nack(msg, false, false);\n}\n\n/\n Internal helpers exposed for unit testing only. Not part of the public API.\n \n @internal\n /\nexport const _internalForTesting = {\n calculateRetryDelay,\n publishForRetry,\n};\n","import {\n type ConsumerDefinition,\n type ContractDefinition,\n type InferConsumerNames,\n type InferRpcNames,\n extractConsumer,\n extractQueue,\n} from \"@amqp-contract/contract\";\nimport {\n AmqpClient,\n ConsumerOptions as AmqpClientConsumerOptions,\n type Logger,\n TechnicalError,\n type TelemetryProvider,\n defaultTelemetryProvider,\n endSpanError,\n endSpanSuccess,\n recordConsumeMetric,\n safeJsonParse,\n startConsumeSpan,\n} from \"@amqp-contract/core\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\nimport type { ConsumeMessage } from \"amqplib\";\nimport { err, errAsync, ok, okAsync, ResultAsync } from \"neverthrow\";\nimport { decompressBuffer } from \"./decompression.js\";\nimport type { HandlerError } from \"./errors.js\";\nimport { MessageValidationError, NonRetryableError } from \"./errors.js\";\nimport { handleError } from \"./retry.js\";\nimport type { WorkerInferHandlers } from \"./types.js\";\n\n/\n Either a regular consumer name or an RPC name from the contract.\n /\ntype HandlerName<TContract extends ContractDefinition> =\n \| InferConsumerNames<TContract>\n \| InferRpcNames<TContract>;\n\n/\n Resolved handler entry stored on the worker, regardless of whether the\n * source is a `consumers` or `rpcs` slot. The handler signature is widened\n * here because both kinds share the same dispatch loop; specific call sites\n * cast back to the correct typed handler.\n /\ntype StoredHandler = (\n message: { payload: unknown; headers: unknown },\n rawMessage: ConsumeMessage,\n) => ResultAsync<unknown, HandlerError>;\n\nexport type ConsumerOptions = AmqpClientConsumerOptions;\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 okAsync(undefined);\n * },\n * // Handler with prefetch configuration\n * processPayment: [\n * ({ payload }) => {\n * console.log('Processing payment:', payload.paymentId);\n * return okAsync(undefined);\n * },\n * { prefetch: 10 }\n * ]\n * },\n * urls: ['amqp://localhost'],\n * defaultConsumerOptions: {\n * prefetch: 5,\n * },\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 `consumers` and `rpcs` entry in the contract.\n \n - Regular consumers return `ResultAsync<void, HandlerError>`.\n * - RPC handlers return `ResultAsync<TResponse, HandlerError>` where\n * `TResponse` is inferred from the RPC's response message schema.\n \n Use `defineHandler` / `defineHandlers` to create handlers with full type\n * inference.\n /\n handlers: WorkerInferHandlers<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 Optional default consumer options applied to all consumer handlers.\n * Handler-specific options provided in tuple form override these defaults.\n /\n defaultConsumerOptions?: ConsumerOptions \| undefined;\n /\n Maximum time in ms to wait for the AMQP connection to become ready before\n * `create()` resolves to an `err(TechnicalError)`. Defaults to 30s\n * (the {@link AmqpClient}'s `DEFAULT_CONNECT_TIMEOUT_MS`). Pass `null` to\n * disable the timeout and let amqp-connection-manager retry indefinitely.\n /\n connectTimeoutMs?: number \| null \| 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 { okAsync } from 'neverthrow';\n * import { z } from 'zod';\n \n const orderQueue = defineQueue('order-processing');\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 result = await TypedAmqpWorker.create({\n * contract,\n * handlers: {\n * processOrder: ({ payload }) => {\n * console.log('Processing order', payload.orderId);\n * return okAsync(undefined);\n * },\n * },\n * urls: ['amqp://localhost'],\n * });\n \n if (result.isErr()) throw result.error;\n * const worker = result.value;\n \n // Close when done\n * await worker.close();\n * ```\n /\nexport class TypedAmqpWorker<TContract extends ContractDefinition> {\n /\n Internal handler storage. Keyed by handler name (consumer or RPC); the\n * stored function signature is widened so the dispatch loop can call it\n * uniformly. The actual handler is type-checked at the worker's public API\n * boundary via `WorkerInferHandlers<TContract>`.\n /\n private readonly actualHandlers: Partial<Record<HandlerName<TContract>, StoredHandler>>;\n private readonly consumerOptions: Partial<Record<HandlerName<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: WorkerInferHandlers<TContract>,\n private readonly defaultConsumerOptions: ConsumerOptions,\n private readonly logger?: Logger,\n telemetry?: TelemetryProvider,\n ) {\n this.telemetry = telemetry ?? defaultTelemetryProvider;\n\n this.actualHandlers = {};\n this.consumerOptions = {};\n\n const handlersRecord = handlers as Record<string, unknown>;\n\n for (const handlerName of Object.keys(handlersRecord)) {\n const handlerEntry = handlersRecord[handlerName];\n const typedName = handlerName as HandlerName<TContract>;\n\n if (isHandlerTuple(handlerEntry)) {\n const [handler, options] = handlerEntry;\n this.actualHandlers[typedName] = handler as StoredHandler;\n this.consumerOptions[typedName] = {\n ...this.defaultConsumerOptions,\n ...options,\n };\n } else {\n this.actualHandlers[typedName] = handlerEntry as StoredHandler;\n this.consumerOptions[typedName] = this.defaultConsumerOptions;\n }\n }\n }\n\n /\n Build a `ConsumerDefinition`-shaped view for a handler name, regardless\n * of whether it came from `contract.consumers` or `contract.rpcs`. The\n * dispatch path treats both uniformly; the returned `isRpc` flag (and the\n * accompanying `responseSchema`) tells `processMessage` whether to validate\n * the handler return value and publish a reply.\n /\n private resolveConsumerView(name: HandlerName<TContract>): {\n consumer: ConsumerDefinition;\n isRpc: boolean;\n responseSchema?: StandardSchemaV1;\n } {\n // Use `Object.hasOwn` rather than `key in rpcs` so prototype properties\n // (e.g. \"toString\") on a plain object are not misclassified as RPC names.\n const rpcs = this.contract.rpcs;\n if (rpcs && Object.hasOwn(rpcs, name as string)) {\n const rpc = rpcs[name as string]!;\n return {\n consumer: { queue: rpc.queue, message: rpc.request },\n isRpc: true,\n responseSchema: rpc.response.payload,\n };\n }\n const consumerEntry = this.contract.consumers![name as string]!;\n return {\n consumer: extractConsumer(consumerEntry),\n isRpc: false,\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 @returns A ResultAsync that resolves to the worker or a TechnicalError.\n \n @example\n * ```typescript\n * const result = await TypedAmqpWorker.create({\n * contract: myContract,\n * handlers: {\n * processOrder: ({ payload }) => okAsync(undefined),\n * },\n * urls: ['amqp://localhost'],\n * });\n * ```\n /\n static create<TContract extends ContractDefinition>({\n contract,\n handlers,\n urls,\n connectionOptions,\n defaultConsumerOptions,\n logger,\n telemetry,\n connectTimeoutMs,\n }: CreateWorkerOptions<TContract>): ResultAsync<TypedAmqpWorker<TContract>, TechnicalError> {\n const worker = new TypedAmqpWorker(\n contract,\n new AmqpClient(contract, {\n urls,\n connectionOptions,\n connectTimeoutMs,\n }),\n handlers,\n defaultConsumerOptions ?? {},\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 const setup = worker.waitForConnectionReady().andThen(() => worker.consumeAll());\n\n // If setup fails, release the AmqpClient's connection ref-count and cancel\n // any consumers that registered before the failure, so a failed create()\n // does not leak.\n return new ResultAsync<TypedAmqpWorker<TContract>, TechnicalError>(\n (async () => {\n const setupResult = await setup;\n if (setupResult.isOk()) {\n return ok(worker);\n }\n const closeResult = await worker.close();\n if (closeResult.isErr()) {\n logger?.warn(\"Failed to close worker after setup failure\", {\n error: closeResult.error,\n });\n }\n return err(setupResult.error);\n })(),\n );\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 @example\n * ```typescript\n * const closeResult = await worker.close();\n * if (closeResult.isOk()) {\n * console.log('Worker closed successfully');\n * }\n * ```\n /\n close(): ResultAsync<void, TechnicalError> {\n const cancellations = Array.from(this.consumerTags).map((consumerTag) =>\n // Swallow per-consumer cancel errors during close — they are best-effort\n // cleanup and we still want to release the underlying connection.\n this.amqpClient.cancel(consumerTag).orElse((error) => {\n this.logger?.warn(\"Failed to cancel consumer during close\", { consumerTag, error });\n return ok<void, TechnicalError>(undefined);\n }),\n );\n\n return ResultAsync.combine(cancellations)\n .andTee(() => {\n this.consumerTags.clear();\n })\n .andThen(() => this.amqpClient.close())\n .map(() => undefined);\n }\n\n /\n Start consuming for every entry in `contract.consumers` and `contract.rpcs`.\n /\n private consumeAll(): ResultAsync<void, TechnicalError> {\n const consumerNames = Object.keys(\n this.contract.consumers ?? {},\n ) as InferConsumerNames<TContract>[];\n const rpcNames = Object.keys(this.contract.rpcs ?? {}) as InferRpcNames<TContract>[];\n const allNames = [...consumerNames, ...rpcNames] as HandlerName<TContract>[];\n\n return ResultAsync.combine(allNames.map((name) => this.consume(name))).map(() => undefined);\n }\n\n private waitForConnectionReady(): ResultAsync<void, TechnicalError> {\n return this.amqpClient.waitForConnect();\n }\n\n /\n Start consuming messages for a specific handler — either a `consumers`\n * entry (regular event/command consumer) or an `rpcs` entry (RPC server).\n /\n private consume(name: HandlerName<TContract>): ResultAsync<void, TechnicalError> {\n const view = this.resolveConsumerView(name);\n // Non-null assertion safe: `WorkerInferHandlers<TContract>` requires every\n // consumers / rpcs key to have a handler, so by the time we reach this\n // dispatch path the entry exists in `actualHandlers`. Enforced by the type\n // system at the public API boundary, not by a runtime check.\n const handler = this.actualHandlers[name]!;\n\n return this.consumeSingle(name, view, handler);\n }\n\n /\n Validate data against a Standard Schema. No side effects; the caller is\n * responsible for ack/nack based on the Result.\n /\n private validateSchema(\n schema: StandardSchemaV1,\n data: unknown,\n context: { consumerName: string; field: string },\n ): ResultAsync<unknown, TechnicalError> {\n const rawValidation = schema[\"~standard\"].validate(data);\n const validationPromise =\n rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);\n\n return ResultAsync.fromPromise(\n validationPromise,\n (error) => new TechnicalError(`Error validating ${context.field}`, error),\n ).andThen((result) => {\n if (result.issues) {\n return err(\n new TechnicalError(\n `${context.field} validation failed`,\n new MessageValidationError(context.consumerName, result.issues),\n ),\n );\n }\n return ok<unknown, TechnicalError>(result.value);\n });\n }\n\n /\n Parse and validate a message from AMQP. Pure: returns the validated payload\n * and headers, or an error. The dispatch path in {@link processMessage} routes\n * validation/parse errors directly to the DLQ (single nack) — they never enter\n * the retry pipeline because retrying an unparseable or schema-violating\n * payload cannot succeed.\n /\n private parseAndValidateMessage(\n msg: ConsumeMessage,\n consumer: ConsumerDefinition,\n consumerName: HandlerName<TContract>,\n ): ResultAsync<{ payload: unknown; headers: unknown }, TechnicalError> {\n const context = { consumerName: String(consumerName) };\n\n const parsePayload = decompressBuffer(msg.content, msg.properties.contentEncoding)\n .andThen((buffer) =>\n safeJsonParse(buffer, (error) => new TechnicalError(\"Failed to parse JSON\", error)),\n )\n .andThen((parsed) =>\n this.validateSchema(consumer.message.payload as StandardSchemaV1, parsed, {\n ...context,\n field: \"payload\",\n }),\n );\n\n const parseHeaders: ResultAsync<unknown, TechnicalError> = consumer.message.headers\n ? this.validateSchema(\n consumer.message.headers as StandardSchemaV1,\n msg.properties.headers ?? {},\n {\n ...context,\n field: \"headers\",\n },\n )\n : okAsync(undefined);\n\n return ResultAsync.combine([parsePayload, parseHeaders]).map(([payload, headers]) => ({\n payload,\n headers,\n }));\n }\n\n /\n Validate an RPC handler's response and publish it back to the caller's reply\n * queue with the same `correlationId`. Published via the AMQP default exchange\n * with `routingKey = msg.properties.replyTo`, which works for both\n * `amq.rabbitmq.reply-to` and any anonymous queue declared by the caller.\n \n Failure semantics:\n * - Missing replyTo / correlationId: NonRetryableError. The caller is\n * already lost; retrying the original message cannot recover the reply\n * path. The poison message lands in DLQ for inspection rather than being\n * silently ack'd (which would mask a contract violation).\n * - Schema validation failure: NonRetryableError — the handler returned\n * the wrong shape; retrying the same input will not fix it.\n * - Publish failure: NonRetryableError. The caller has already timed out\n * (or will shortly), so retrying the message wastes the queue's retry\n * budget on a reply that no one is waiting for. The message is logged and\n * DLQ'd; the original work is treated as completed for the purpose of the\n * inbox.\n /\n private publishRpcResponse(\n msg: ConsumeMessage,\n queueName: string,\n rpcName: HandlerName<TContract>,\n responseSchema: StandardSchemaV1,\n response: unknown,\n ): ResultAsync<void, HandlerError> {\n const replyTo = msg.properties.replyTo;\n const correlationId = msg.properties.correlationId;\n if (typeof replyTo !== \"string\" \|\| replyTo.length === 0) {\n this.logger?.error(\n \"RPC handler returned a response but the incoming message has no replyTo\",\n { rpcName: String(rpcName), queueName },\n );\n return errAsync(\n new NonRetryableError(\n `RPC \"${String(rpcName)}\" received a message without replyTo; cannot deliver response`,\n ),\n );\n }\n if (typeof correlationId !== \"string\" \|\| correlationId.length === 0) {\n // Without a correlationId the client cannot match the reply to its\n // pending call — publishing anyway would guarantee a client-side timeout.\n this.logger?.error(\n \"RPC handler returned a response but the incoming message has no correlationId\",\n { rpcName: String(rpcName), queueName, replyTo },\n );\n return errAsync(\n new NonRetryableError(\n `RPC \"${String(rpcName)}\" received a message without correlationId; cannot deliver response`,\n ),\n );\n }\n\n // Wrap the call to `validate` itself in try/catch — a Standard Schema\n // implementation may throw synchronously (not via a rejected Promise), and\n // we don't want that to crash the consume callback.\n let rawValidation: ReturnType<StandardSchemaV1[\"~standard\"][\"validate\"]>;\n try {\n rawValidation = responseSchema[\"~standard\"].validate(response);\n } catch (error: unknown) {\n return errAsync(new NonRetryableError(\"RPC response schema validation threw\", error));\n }\n const validationPromise =\n rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);\n\n return ResultAsync.fromPromise(\n validationPromise,\n (error: unknown) =>\n new NonRetryableError(\"RPC response schema validation threw\", error) as HandlerError,\n )\n .andThen((validation) => {\n if (validation.issues) {\n return err<unknown, HandlerError>(\n new NonRetryableError(\n `RPC response for \"${String(rpcName)}\" failed schema validation`,\n new MessageValidationError(String(rpcName), validation.issues),\n ),\n );\n }\n return ok<unknown, HandlerError>(validation.value);\n })\n .andThen((validatedResponse) =>\n this.amqpClient\n .publish(\"\", replyTo, validatedResponse, {\n correlationId,\n contentType: \"application/json\",\n })\n // Reply-side failures are not retryable from the inbox: by the time\n // the broker can't deliver the reply, the caller's RPC future has\n // already (or will soon) time out. Retrying the original message\n // re-runs the handler against a stale caller. Send to DLQ instead so\n // the failure is visible without churning the queue.\n .mapErr(\n (error: TechnicalError): HandlerError =>\n new NonRetryableError(\"Failed to publish RPC response\", error),\n )\n .andThen((published) =>\n published\n ? ok<void, HandlerError>(undefined)\n : err<void, HandlerError>(\n new NonRetryableError(\"Failed to publish RPC response: channel buffer full\"),\n ),\n ),\n );\n }\n\n /\n Parse and validate the message; on failure, nack(requeue=false) so the\n * queue's DLX (if configured) receives the poison message and bypass the\n * retry pipeline — a malformed payload is deterministic and retrying it\n * would burn the queue's retry budget on a guaranteed failure.\n /\n private parseAndValidateOrNack(\n msg: ConsumeMessage,\n consumer: ConsumerDefinition,\n name: HandlerName<TContract>,\n ): ResultAsync<{ payload: unknown; headers: unknown }, TechnicalError> {\n return this.parseAndValidateMessage(msg, consumer, name).orElse((parseError) => {\n this.amqpClient.nack(msg, false, false);\n return errAsync(parseError);\n });\n }\n\n /\n Invoke the handler and ack the message on success. Returns the handler's\n * response (RPC) or `undefined` (regular consumer). Errors propagate as\n * `HandlerError` for downstream RPC reply publishing or routing via\n * {@link handleError}.\n /\n private runHandler(\n handler: StoredHandler,\n validatedMessage: { payload: unknown; headers: unknown },\n msg: ConsumeMessage,\n ): ResultAsync<unknown, HandlerError> {\n return handler(validatedMessage, msg);\n }\n\n /\n For RPC handlers, validate and publish the reply on the caller's\n * `replyTo` / `correlationId`. For non-RPC consumers, this is a no-op that\n * resolves to `okAsync(undefined)`.\n /\n private publishReplyIfRpc(\n msg: ConsumeMessage,\n view: { consumer: ConsumerDefinition; isRpc: boolean; responseSchema?: StandardSchemaV1 },\n name: HandlerName<TContract>,\n handlerResponse: unknown,\n ): ResultAsync<void, HandlerError> {\n if (!view.isRpc \|\| !view.responseSchema) {\n return okAsync<void, HandlerError>(undefined);\n }\n const queueName = extractQueue(view.consumer.queue).name;\n return this.publishRpcResponse(msg, queueName, name, view.responseSchema, handlerResponse);\n }\n\n /\n Process a single consumed message: validate, invoke handler, optionally\n * publish the RPC response, record telemetry, and route errors.\n \n The caller-supplied `state` is mutated as the message is ack'd/nack'd so\n * the consume callback's catch-all guard can tell whether a defensive nack\n * is still needed (see {@link consumeSingle}).\n \n Success-vs-failure telemetry is data-driven: the chain resolves to\n * `ok(undefined)` only on handler success (and reply-publish success for\n * RPC). Handler failures — even when {@link handleError} routes them\n * successfully to retry/DLQ — are classified as failures for metrics by\n * re-failing the chain with a `TechnicalError` whose `cause` is the\n * original `HandlerError`. The terminal `orTee` unwraps the cause before\n * recording the span exception so traces keep the original\n * `RetryableError` / `NonRetryableError` class as the exception type.\n /\n private processMessage(\n msg: ConsumeMessage,\n view: { consumer: ConsumerDefinition; isRpc: boolean; responseSchema?: StandardSchemaV1 },\n name: HandlerName<TContract>,\n handler: StoredHandler,\n state: { messageHandled: boolean },\n ): ResultAsync<void, TechnicalError> {\n const { consumer } = view;\n const queueName = extractQueue(consumer.queue).name;\n const startTime = Date.now();\n const span = startConsumeSpan(this.telemetry, queueName, String(name), {\n \"messaging.rabbitmq.message.delivery_tag\": msg.fields.deliveryTag,\n });\n\n return this.parseAndValidateOrNack(msg, consumer, name)\n .orTee((parseError) => {\n this.logger?.error(\"Failed to parse/validate message; sending to DLQ\", {\n consumerName: String(name),\n queueName,\n error: parseError,\n });\n // parseAndValidateOrNack already nacked; mark handled so the\n // catch-all in consumeSingle does not double-act.\n state.messageHandled = true;\n })\n .andThen<void, TechnicalError>((validatedMessage) =>\n this.runHandler(handler, validatedMessage, msg)\n .andThen((handlerResponse) =>\n this.publishReplyIfRpc(msg, view, name, handlerResponse).andTee(() => {\n this.logger?.info(\"Message consumed successfully\", {\n consumerName: String(name),\n queueName,\n });\n this.amqpClient.ack(msg);\n state.messageHandled = true;\n }),\n )\n .orElse((handlerError: HandlerError) => {\n this.logger?.error(\"Error processing message\", {\n consumerName: String(name),\n queueName,\n errorType: handlerError.name,\n retryCount:\n (msg.properties.headers?.[\"x-delivery-count\"] as number \| undefined) ??\n (msg.properties.headers?.[\"x-retry-count\"] as number \| undefined) ??\n 0,\n error: handlerError.message,\n });\n\n // Route the failure to retry / DLQ via handleError. On its\n // success paths (retry republish, immediate-requeue nack, DLQ\n // nack) the message has been ack'd or nack'd, so mark it\n // handled. On its failure paths (e.g. TTL-backoff misconfig)\n // no ack/nack happens and the message will be redelivered —\n // leave messageHandled false so the consume catch-all can\n // defensive-nack if needed.\n //\n // Either way, re-fail the chain with the original handlerError\n // as `cause` so the failure-telemetry path fires; routing-\n // internal errors (TechnicalError) take precedence and surface\n // as the chain's error directly.\n return handleError(\n { amqpClient: this.amqpClient, logger: this.logger },\n handlerError,\n msg,\n String(name),\n consumer,\n )\n .andTee(() => {\n state.messageHandled = true;\n })\n .andThen(() =>\n errAsync<void, TechnicalError>(\n new TechnicalError(\n `Handler \"${String(name)}\" failed: ${handlerError.message}`,\n handlerError,\n ),\n ),\n );\n }),\n )\n .andTee(() => {\n // Telemetry must never throw out of the consume loop — wrap each\n // call so an instrumentation bug cannot poison the dispatch path\n // (which would land us in the catch-all in consumeSingle, racing\n // with the ack we already issued above).\n try {\n endSpanSuccess(span);\n recordConsumeMetric(\n this.telemetry,\n queueName,\n String(name),\n true,\n Date.now() - startTime,\n );\n } catch (telemetryError: unknown) {\n this.logger?.warn(\"Telemetry recording threw; ignoring\", {\n consumerName: String(name),\n queueName,\n error: telemetryError,\n });\n }\n })\n .orTee((error) => {\n // Routed handler failures arrive here wrapped in a `TechnicalError`\n // with the original `HandlerError` carried via `cause`. Surface the\n // original to the span so the recorded `exception.type` is the\n // discriminating subclass (`RetryableError` / `NonRetryableError`)\n // rather than the wrapper.\n const reportedError = error.cause instanceof Error ? error.cause : error;\n try {\n endSpanError(span, reportedError);\n recordConsumeMetric(\n this.telemetry,\n queueName,\n String(name),\n false,\n Date.now() - startTime,\n );\n } catch (telemetryError: unknown) {\n this.logger?.warn(\"Telemetry recording threw; ignoring\", {\n consumerName: String(name),\n queueName,\n error: telemetryError,\n });\n }\n });\n }\n\n /\n Consume messages one at a time.\n /\n private consumeSingle(\n name: HandlerName<TContract>,\n view: { consumer: ConsumerDefinition; isRpc: boolean; responseSchema?: StandardSchemaV1 },\n handler: StoredHandler,\n ): ResultAsync<void, TechnicalError> {\n const queueName = extractQueue(view.consumer.queue).name;\n\n return this.amqpClient\n .consume(\n queueName,\n async (msg) => {\n if (msg === null) {\n this.logger?.warn(\"Consumer cancelled by server\", {\n consumerName: String(name),\n queueName,\n });\n return;\n }\n // The dispatch path is built on `ResultAsync` so handler failures\n // are values, not exceptions. Defensively guard the boundary anyway:\n // a handler that violates the contract by throwing synchronously (or\n // any unexpected fault inside processMessage) would otherwise leave\n // the message neither acked nor nacked, and amqp-connection-manager\n // would not redeliver it until the channel closes. nack(requeue=false)\n // routes it via DLX if configured.\n //\n // The `state.messageHandled` flag guards the catch-block nack: if\n // an exception is thrown after* the message was already ack'd or\n // nack'd (e.g. from the telemetry chain in processMessage's tail),\n // a second nack would target the same delivery tag and close the\n // channel with 406 PRECONDITION_FAILED.\n const state = { messageHandled: false };\n try {\n await this.processMessage(msg, view, name, handler, state);\n } catch (error: unknown) {\n if (state.messageHandled) {\n this.logger?.error(\n \"Uncaught error in consume callback after message was already handled; not nacking\",\n {\n consumerName: String(name),\n queueName,\n error,\n },\n );\n return;\n }\n this.logger?.error(\"Uncaught error in consume callback; nacking message\", {\n consumerName: String(name),\n queueName,\n error,\n });\n this.amqpClient.nack(msg, false, false);\n }\n },\n this.consumerOptions[name],\n )\n .andTee((consumerTag) => {\n this.consumerTags.add(consumerTag);\n })\n .map(() => undefined)\n .mapErr(\n (error) => new TechnicalError(`Failed to start consuming for \"${String(name)}\"`, error),\n );\n }\n}\n","import type {\n ContractDefinition,\n InferConsumerNames,\n InferRpcNames,\n} from \"@amqp-contract/contract\";\nimport type {\n WorkerInferConsumerHandler,\n WorkerInferConsumerHandlerEntry,\n WorkerInferHandlers,\n WorkerInferRpcHandler,\n WorkerInferRpcHandlerEntry,\n} from \"./types.js\";\nimport { ConsumerOptions } from \"./worker.js\";\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/*\n Build the list of available handler-target names — every key under\n * `contract.consumers` plus every key under `contract.rpcs`.\n /\nfunction availableHandlerNames<TContract extends ContractDefinition>(\n contract: TContract,\n): readonly string[] {\n const consumers = contract.consumers ? Object.keys(contract.consumers) : [];\n const rpcs = contract.rpcs ? Object.keys(contract.rpcs) : [];\n return [...consumers, ...rpcs];\n}\n\nfunction formatAvailable(names: readonly string[]): string {\n return names.length > 0 ? names.join(\", \") : \"none\";\n}\n\n/\n Validate that a name maps to a contract entry — either a `consumers` key\n * or an `rpcs` key. The two name spaces are disjoint by contract definition.\n /\nfunction validateHandlerTargetExists<TContract extends ContractDefinition>(\n contract: TContract,\n name: string,\n): void {\n const consumers = contract.consumers;\n const rpcs = contract.rpcs;\n\n const isConsumer = !!consumers && Object.hasOwn(consumers, name);\n const isRpc = !!rpcs && Object.hasOwn(rpcs, name);\n\n if (!isConsumer && !isRpc) {\n const available = formatAvailable(availableHandlerNames(contract));\n throw new Error(\n `Handler target \"${name}\" not found in contract. Available consumers and RPCs: ${available}`,\n );\n }\n}\n\n/\n Validate that every key in `handlers` maps to a contract entry —\n * either a `consumers` key or an `rpcs` key.\n /\nfunction validateHandlers<TContract extends ContractDefinition>(\n contract: TContract,\n handlers: object,\n): void {\n for (const handlerName of Object.keys(handlers)) {\n validateHandlerTargetExists(contract, handlerName);\n }\n}\n\n// =============================================================================\n// Handler Definitions\n// =============================================================================\n\n/\n Define a type-safe handler for a specific consumer or RPC in a contract.\n \n Recommended: This function creates handlers that return\n * `ResultAsync<void, HandlerError>` (consumers) or\n * `ResultAsync<TResponse, HandlerError>` (RPCs), providing explicit error\n * 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 or RPC name from the contract\n * @param contract - The contract definition containing the consumer or RPC\n * @param name - The name of the consumer or RPC from the contract\n * @param handler - The handler function — for consumers, returns\n * `ResultAsync<void, HandlerError>`; for RPCs, returns\n * `ResultAsync<TResponse, HandlerError>`.\n * @param options - Optional consumer options (prefetch)\n * @returns A type-safe handler that can be used with TypedAmqpWorker\n \n @example Consumer handler\n * ```typescript\n * import { defineHandler, RetryableError, NonRetryableError } from '@amqp-contract/worker';\n * import { errAsync, okAsync, ResultAsync } from 'neverthrow';\n \n const processOrderHandler = defineHandler(\n * orderContract,\n * 'processOrder',\n * ({ payload }) =>\n * ResultAsync.fromPromise(\n * processPayment(payload),\n * (error) => new RetryableError('Payment failed', error),\n * ).map(() => undefined),\n * );\n * ```\n \n @example RPC handler\n * ```typescript\n * const calculateHandler = defineHandler(\n * rpcContract,\n * 'calculate',\n * ({ payload }) => okAsync({ sum: payload.a + payload.b }),\n * );\n * ```\n /\nexport function defineHandler<\n TContract extends ContractDefinition,\n TName extends InferConsumerNames<TContract>,\n>(\n contract: TContract,\n name: 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 name: TName,\n handler: WorkerInferConsumerHandler<TContract, TName>,\n options: ConsumerOptions,\n): WorkerInferConsumerHandlerEntry<TContract, TName>;\nexport function defineHandler<\n TContract extends ContractDefinition,\n TName extends InferRpcNames<TContract>,\n>(\n contract: TContract,\n name: TName,\n handler: WorkerInferRpcHandler<TContract, TName>,\n): WorkerInferRpcHandlerEntry<TContract, TName>;\nexport function defineHandler<\n TContract extends ContractDefinition,\n TName extends InferRpcNames<TContract>,\n>(\n contract: TContract,\n name: TName,\n handler: WorkerInferRpcHandler<TContract, TName>,\n options: ConsumerOptions,\n): WorkerInferRpcHandlerEntry<TContract, TName>;\nexport function defineHandler<\n TContract extends ContractDefinition,\n TName extends InferConsumerNames<TContract> \| InferRpcNames<TContract>,\n>(contract: TContract, name: TName, handler: unknown, options?: ConsumerOptions): unknown {\n validateHandlerTargetExists(contract, String(name));\n\n if (options) {\n return [handler, options];\n }\n return handler;\n}\n\n/\n Define multiple type-safe handlers for consumers and RPCs in a contract.\n \n Recommended: This function creates handlers that return\n * `ResultAsync<void, HandlerError>` (consumers) or\n * `ResultAsync<TResponse, HandlerError>` (RPCs), providing explicit error\n * handling and better control over retry behavior.\n \n The handlers object must contain exactly one entry per `consumers` and\n * `rpcs` key in the contract — see {@link WorkerInferHandlers}.\n \n @template TContract - The contract definition type\n * @param contract - The contract definition containing the consumers and RPCs\n * @param handlers - An object with handler functions for each consumer and RPC\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 { okAsync, ResultAsync } from 'neverthrow';\n \n const handlers = defineHandlers(orderContract, {\n * processOrder: ({ payload }) =>\n * ResultAsync.fromPromise(\n * processPayment(payload),\n * (error) => new RetryableError('Payment failed', error),\n * ).map(() => undefined),\n * calculate: ({ payload }) => okAsync({ sum: payload.a + payload.b }),\n * });\n * ```\n */\nexport function defineHandlers<TContract extends ContractDefinition>(\n contract: TContract,\n handlers: WorkerInferHandlers<TContract>,\n): WorkerInferHandlers<TContract> {\n validateHandlers(contract, handlers);\n return handlers;\n}\n"],"mappings":";;;;;;AAKA,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,iBACqC;AACrC,KAAI,CAAC,gBACH,QAAO,QAAQ,OAAO;CAGxB,MAAM,qBAAqB,gBAAgB,aAAa;AAExD,KAAI,CAAC,oBAAoB,mBAAmB,CAC1C,QAAO,SACL,IAAI,eACF,kCAAkC,gBAAgB,8BACpB,oBAAoB,KAAK,KAAK,CAAC,8CAE9D,CACF;AAGH,SAAQ,oBAAR;EACE,KAAK,OACH,QAAO,YAAY,YACjB,YAAY,OAAO,GAClB,UAAU,IAAI,eAAe,6BAA6B,MAAM,CAClE;EACH,KAAK,UACH,QAAO,YAAY,YACjB,aAAa,OAAO,GACnB,UAAU,IAAI,eAAe,gCAAgC,MAAM,CACrE;;;;;;;;;;;;ACvDP,IAAsB,eAAtB,cAA2C,MAAM;CAG/C,YACE,SACA,OACA;AACA,QAAM,QAAQ;AAFW,OAAA,QAAA;EAIzB,MAAM,mBAAmB;AAGzB,MAAI,OAAO,iBAAiB,sBAAsB,WAChD,kBAAiB,kBAAkB,MAAM,KAAK,YAAY;;;;;;;;;;AAYhE,IAAa,iBAAb,cAAoC,aAAa;CAC/C,OAAyB;;;;;;;;;AAU3B,IAAa,oBAAb,cAAuC,aAAa;CAClD,OAAyB;;;;;;;;;;;;;;;;;;;;;;;;;AA8B3B,SAAgB,iBAAiB,OAAyC;AACxE,QAAO,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;AAwB1B,SAAgB,oBAAoB,OAA4C;AAC9E,QAAO,iBAAiB;;;;;;;;;;;;;;;;;;;;AAqB1B,SAAgB,eAAe,OAAuC;AACpE,QAAO,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgC1B,SAAgB,UAAU,SAAiB,OAAiC;AAC1E,QAAO,IAAI,eAAe,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6B3C,SAAgB,aAAa,SAAiB,OAAoC;AAChF,QAAO,IAAI,kBAAkB,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;ACxJ9C,SAAgB,YACd,KACA,OACA,KACA,cACA,UACmC;AAInC,KAAI,iBAAiB,mBAAmB;AACtC,YAAU,KAAK,KAAK,SAAS;AAC7B,SAAO,QAAQ,KAAA,EAAU;;CAI3B,MAAM,SAAS,aAAa,SAAS,MAAM,CAAC;AAG5C,KAAI,OAAO,SAAS,oBAClB,QAAO,4BAA4B,KAAK,OAAO,KAAK,cAAc,UAAU,OAAO;AAIrF,KAAI,OAAO,SAAS,cAClB,QAAO,sBAAsB,KAAK,OAAO,KAAK,cAAc,UAAU,OAAO;AAO/E,KAAI,QAAQ,KAAK,8CAA8C;EAC7D;EACA,WAAW,aAAa,SAAS,MAAM,CAAC;EACzC,CAAC;AACF,WAAU,KAAK,KAAK,SAAS;AAC7B,QAAO,QAAQ,KAAA,EAAU;;;;;;;;;;;AAY3B,SAAS,4BACP,KACA,OACA,KACA,cACA,UACA,QACmC;CACnC,MAAM,QAAQ,aAAa,SAAS,MAAM;CAC1C,MAAM,YAAY,MAAM;CAKxB,MAAM,aACJ,MAAM,SAAS,WACT,IAAI,WAAW,UAAU,uBAAkC,IAC3D,IAAI,WAAW,UAAU,oBAA+B;AAIhE,KAAI,cAAc,OAAO,YAAY;AACnC,MAAI,QAAQ,KAAK,iEAAiE;GAChF;GACA;GACA;GACA,YAAY,OAAO;GACpB,CAAC;AACF,YAAU,KAAK,KAAK,SAAS;AAC7B,SAAO,QAAQ,KAAA,EAAU;;AAG3B,KAAI,QAAQ,KAAK,6CAA6C;EAC5D;EACA;EACA;EACA,YAAY,OAAO;EACpB,CAAC;AAEF,KAAI,MAAM,SAAS,UAAU;AAE3B,MAAI,WAAW,KAAK,KAAK,OAAO,KAAK;AACrC,SAAO,QAAQ,KAAA,EAAU;OAGzB,QAAO,gBAAgB,KAAK;EAC1B;EACA,UAAU,IAAI,OAAO;EACrB,YAAY,IAAI,OAAO;EACvB;EACA;EACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BN,SAAS,sBACP,KACA,OACA,KACA,cACA,UACA,QACmC;AACnC,KAAI,CAAC,oCAAoC,SAAS,MAAM,EAAE;AACxD,MAAI,QAAQ,MAAM,kDAAkD;GAClE;GACA,WAAW,SAAS,MAAM;GAC3B,CAAC;AACF,SAAO,SAAS,IAAI,eAAe,iDAAiD,CAAC;;CAGvF,MAAM,aAAa,SAAS;CAE5B,MAAM,YADQ,aAAa,WACJ,CAAC;CAGxB,MAAM,aAAc,IAAI,WAAW,UAAU,oBAA+B;AAI5E,KAAI,cAAc,OAAO,YAAY;AACnC,MAAI,QAAQ,KAAK,2DAA2D;GAC1E;GACA;GACA;GACA,YAAY,OAAO;GACpB,CAAC;AACF,YAAU,KAAK,KAAK,SAAS;AAC7B,SAAO,QAAQ,KAAA,EAAU;;CAI3B,MAAM,UAAU,oBAAoB,YAAY,OAAO;AACvD,KAAI,QAAQ,KAAK,uCAAuC;EACtD;EACA;EACA,YAAY,aAAa;EACzB,YAAY,OAAO;EACnB;EACD,CAAC;AAGF,QAAO,gBAAgB,KAAK;EAC1B;EACA,UAAU,WAAW,aAAa;EAClC,YAAY,IAAI,OAAO;EACvB,eAAe,WAAW,UAAU;EACpC;EACA;EACA;EACD,CAAC;;;;;AAMJ,SAAS,oBAAoB,YAAoB,QAAgD;CAC/F,MAAM,EAAE,gBAAgB,YAAY,mBAAmB,WAAW;CAElE,IAAI,QAAQ,iBAAiB,KAAK,IAAI,mBAAmB,WAAW;AAEpE,KAAI,OAKF,SAAQ,SAAS,KAAM,KAAK,QAAQ;AAKtC,QAAO,KAAK,MAAM,KAAK,IAAI,OAAO,WAAW,CAAC;;;;;;;;;;;;;AAchD,SAAS,4BACP,KACA,KACA,WACkB;AAClB,KAAI,IAAI,WAAW,gBAGjB,QAAO,IAAI;CAGb,MAAM,cAAc,IAAI,WAAW;AAOnC,KAAI,EALF,gBAAgB,KAAA,KAChB,gBAAgB,sBAChB,YAAY,WAAW,oBAAoB,IAC3C,YAAY,SAAS,QAAQ,EAI7B,QAAO,IAAI;AAGb,KAAI;AACF,SAAO,KAAK,MAAM,IAAI,QAAQ,UAAU,CAAC;UAClC,UAAU;AACjB,MAAI,QAAQ,KAAK,iEAAiE;GAChF;GACA,OAAO;GACR,CAAC;AACF,SAAO,IAAI;;;;;;AAOf,SAAS,gBACP,KACA,EACE,KACA,UACA,YACA,WACA,eACA,SACA,SAUiC;CAGnC,MAAM,iBADc,IAAI,WAAW,UAAU,oBAA+B,KACzC;CAEnC,MAAM,UAAU,4BAA4B,KAAK,KAAK,UAAU;AAWhE,QAAO,IAAI,WACR,QAAQ,UAAU,YAAY,SAAS;EACtC,GAAG,IAAI;EACP,GAAI,YAAY,KAAA,IAAY,EAAE,YAAY,QAAQ,UAAU,EAAE,GAAG,EAAE;EACnE,SAAS;GACP,GAAG,IAAI,WAAW;GAClB,iBAAiB;GACjB,gBAAgB,MAAM;GACtB,6BACE,IAAI,WAAW,UAAU,gCAAgC,KAAK,KAAK;GACrE,GAAI,kBAAkB,KAAA,IAClB;IACE,gBAAgB;IAChB,iBAAiB;IAClB,GACD,EAAE;GACP;EACF,CAAC,CACD,SAAS,cAAc;AACtB,MAAI,CAAC,WAAW;AAId,OAAI,QAAQ,MAAM,2DAA2D;IAC3E;IACA,YAAY;IACZ,GAAI,YAAY,KAAA,IAAY,EAAE,SAAS,GAAG,EAAE;IAC7C,CAAC;AACF,UAAO,IAAI,IAAI,eAAe,0DAA0D,CAAC;;AAI3F,MAAI,WAAW,IAAI,IAAI;AAEvB,MAAI,QAAQ,KAAK,+BAA+B;GAC9C;GACA,YAAY;GACZ,GAAI,YAAY,KAAA,IAAY,EAAE,SAAS,GAAG,EAAE;GAC7C,CAAC;AACF,SAAO,GAAyB,KAAA,EAAU;GAC1C,CACD,QAAQ,iBAAiB;AAGxB,MAAI,QAAQ,MAAM,sEAAsE;GACtF;GACA,YAAY;GACZ,GAAI,YAAY,KAAA,IAAY,EAAE,SAAS,GAAG,EAAE;GAC5C,OAAO;GACR,CAAC;AACF,SAAO,IAAI,aAAa;GACxB;;;;;;AAON,SAAS,UAAU,KAAmB,KAAqB,UAAoC;CAC7F,MAAM,QAAQ,aAAa,SAAS,MAAM;CAC1C,MAAM,YAAY,MAAM;AAGxB,KAAI,EAFkB,MAAM,eAAe,KAAA,GAGzC,KAAI,QAAQ,KAAK,qEAAqE,EACpF,WACD,CAAC;AAGJ,KAAI,QAAQ,KAAK,0BAA0B;EACzC;EACA,aAAa,IAAI,OAAO;EACzB,CAAC;AAGF,KAAI,WAAW,KAAK,KAAK,OAAO,MAAM;;;;;;;AC5VxC,SAAS,eAAe,OAAqD;AAC3E,QAAO,MAAM,QAAQ,MAAM,IAAI,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8HlD,IAAa,kBAAb,MAAa,gBAAsD;;;;;;;CAOjE;CACA;CACA,+BAA6C,IAAI,KAAK;CACtD;CAEA,YACE,UACA,YACA,UACA,wBACA,QACA,WACA;AANiB,OAAA,WAAA;AACA,OAAA,aAAA;AAEA,OAAA,yBAAA;AACA,OAAA,SAAA;AAGjB,OAAK,YAAY,aAAa;AAE9B,OAAK,iBAAiB,EAAE;AACxB,OAAK,kBAAkB,EAAE;EAEzB,MAAM,iBAAiB;AAEvB,OAAK,MAAM,eAAe,OAAO,KAAK,eAAe,EAAE;GACrD,MAAM,eAAe,eAAe;GACpC,MAAM,YAAY;AAElB,OAAI,eAAe,aAAa,EAAE;IAChC,MAAM,CAAC,SAAS,WAAW;AAC3B,SAAK,eAAe,aAAa;AACjC,SAAK,gBAAgB,aAAa;KAChC,GAAG,KAAK;KACR,GAAG;KACJ;UACI;AACL,SAAK,eAAe,aAAa;AACjC,SAAK,gBAAgB,aAAa,KAAK;;;;;;;;;;;CAY7C,oBAA4B,MAI1B;EAGA,MAAM,OAAO,KAAK,SAAS;AAC3B,MAAI,QAAQ,OAAO,OAAO,MAAM,KAAe,EAAE;GAC/C,MAAM,MAAM,KAAK;AACjB,UAAO;IACL,UAAU;KAAE,OAAO,IAAI;KAAO,SAAS,IAAI;KAAS;IACpD,OAAO;IACP,gBAAgB,IAAI,SAAS;IAC9B;;EAEH,MAAM,gBAAgB,KAAK,SAAS,UAAW;AAC/C,SAAO;GACL,UAAU,gBAAgB,cAAc;GACxC,OAAO;GACR;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BH,OAAO,OAA6C,EAClD,UACA,UACA,MACA,mBACA,wBACA,QACA,WACA,oBAC0F;EAC1F,MAAM,SAAS,IAAI,gBACjB,UACA,IAAI,WAAW,UAAU;GACvB;GACA;GACA;GACD,CAAC,EACF,UACA,0BAA0B,EAAE,EAC5B,QACA,UACD;EAID,MAAM,QAAQ,OAAO,wBAAwB,CAAC,cAAc,OAAO,YAAY,CAAC;AAKhF,SAAO,IAAI,aACR,YAAY;GACX,MAAM,cAAc,MAAM;AAC1B,OAAI,YAAY,MAAM,CACpB,QAAO,GAAG,OAAO;GAEnB,MAAM,cAAc,MAAM,OAAO,OAAO;AACxC,OAAI,YAAY,OAAO,CACrB,SAAQ,KAAK,8CAA8C,EACzD,OAAO,YAAY,OACpB,CAAC;AAEJ,UAAO,IAAI,YAAY,MAAM;MAC3B,CACL;;;;;;;;;;;;;;;;CAiBH,QAA2C;EACzC,MAAM,gBAAgB,MAAM,KAAK,KAAK,aAAa,CAAC,KAAK,gBAGvD,KAAK,WAAW,OAAO,YAAY,CAAC,QAAQ,UAAU;AACpD,QAAK,QAAQ,KAAK,0CAA0C;IAAE;IAAa;IAAO,CAAC;AACnF,UAAO,GAAyB,KAAA,EAAU;IAC1C,CACH;AAED,SAAO,YAAY,QAAQ,cAAc,CACtC,aAAa;AACZ,QAAK,aAAa,OAAO;IACzB,CACD,cAAc,KAAK,WAAW,OAAO,CAAC,CACtC,UAAU,KAAA,EAAU;;;;;CAMzB,aAAwD;EACtD,MAAM,gBAAgB,OAAO,KAC3B,KAAK,SAAS,aAAa,EAAE,CAC9B;EACD,MAAM,WAAW,OAAO,KAAK,KAAK,SAAS,QAAQ,EAAE,CAAC;EACtD,MAAM,WAAW,CAAC,GAAG,eAAe,GAAG,SAAS;AAEhD,SAAO,YAAY,QAAQ,SAAS,KAAK,SAAS,KAAK,QAAQ,KAAK,CAAC,CAAC,CAAC,UAAU,KAAA,EAAU;;CAG7F,yBAAoE;AAClE,SAAO,KAAK,WAAW,gBAAgB;;;;;;CAOzC,QAAgB,MAAiE;EAC/E,MAAM,OAAO,KAAK,oBAAoB,KAAK;EAK3C,MAAM,UAAU,KAAK,eAAe;AAEpC,SAAO,KAAK,cAAc,MAAM,MAAM,QAAQ;;;;;;CAOhD,eACE,QACA,MACA,SACsC;EACtC,MAAM,gBAAgB,OAAO,aAAa,SAAS,KAAK;EACxD,MAAM,oBACJ,yBAAyB,UAAU,gBAAgB,QAAQ,QAAQ,cAAc;AAEnF,SAAO,YAAY,YACjB,oBACC,UAAU,IAAI,eAAe,oBAAoB,QAAQ,SAAS,MAAM,CAC1E,CAAC,SAAS,WAAW;AACpB,OAAI,OAAO,OACT,QAAO,IACL,IAAI,eACF,GAAG,QAAQ,MAAM,qBACjB,IAAI,uBAAuB,QAAQ,cAAc,OAAO,OAAO,CAChE,CACF;AAEH,UAAO,GAA4B,OAAO,MAAM;IAChD;;;;;;;;;CAUJ,wBACE,KACA,UACA,cACqE;EACrE,MAAM,UAAU,EAAE,cAAc,OAAO,aAAa,EAAE;EAEtD,MAAM,eAAe,iBAAiB,IAAI,SAAS,IAAI,WAAW,gBAAgB,CAC/E,SAAS,WACR,cAAc,SAAS,UAAU,IAAI,eAAe,wBAAwB,MAAM,CAAC,CACpF,CACA,SAAS,WACR,KAAK,eAAe,SAAS,QAAQ,SAA6B,QAAQ;GACxE,GAAG;GACH,OAAO;GACR,CAAC,CACH;EAEH,MAAM,eAAqD,SAAS,QAAQ,UACxE,KAAK,eACH,SAAS,QAAQ,SACjB,IAAI,WAAW,WAAW,EAAE,EAC5B;GACE,GAAG;GACH,OAAO;GACR,CACF,GACD,QAAQ,KAAA,EAAU;AAEtB,SAAO,YAAY,QAAQ,CAAC,cAAc,aAAa,CAAC,CAAC,KAAK,CAAC,SAAS,cAAc;GACpF;GACA;GACD,EAAE;;;;;;;;;;;;;;;;;;;;;CAsBL,mBACE,KACA,WACA,SACA,gBACA,UACiC;EACjC,MAAM,UAAU,IAAI,WAAW;EAC/B,MAAM,gBAAgB,IAAI,WAAW;AACrC,MAAI,OAAO,YAAY,YAAY,QAAQ,WAAW,GAAG;AACvD,QAAK,QAAQ,MACX,2EACA;IAAE,SAAS,OAAO,QAAQ;IAAE;IAAW,CACxC;AACD,UAAO,SACL,IAAI,kBACF,QAAQ,OAAO,QAAQ,CAAC,+DACzB,CACF;;AAEH,MAAI,OAAO,kBAAkB,YAAY,cAAc,WAAW,GAAG;AAGnE,QAAK,QAAQ,MACX,iFACA;IAAE,SAAS,OAAO,QAAQ;IAAE;IAAW;IAAS,CACjD;AACD,UAAO,SACL,IAAI,kBACF,QAAQ,OAAO,QAAQ,CAAC,qEACzB,CACF;;EAMH,IAAI;AACJ,MAAI;AACF,mBAAgB,eAAe,aAAa,SAAS,SAAS;WACvD,OAAgB;AACvB,UAAO,SAAS,IAAI,kBAAkB,wCAAwC,MAAM,CAAC;;EAEvF,MAAM,oBACJ,yBAAyB,UAAU,gBAAgB,QAAQ,QAAQ,cAAc;AAEnF,SAAO,YAAY,YACjB,oBACC,UACC,IAAI,kBAAkB,wCAAwC,MAAM,CACvE,CACE,SAAS,eAAe;AACvB,OAAI,WAAW,OACb,QAAO,IACL,IAAI,kBACF,qBAAqB,OAAO,QAAQ,CAAC,6BACrC,IAAI,uBAAuB,OAAO,QAAQ,EAAE,WAAW,OAAO,CAC/D,CACF;AAEH,UAAO,GAA0B,WAAW,MAAM;IAClD,CACD,SAAS,sBACR,KAAK,WACF,QAAQ,IAAI,SAAS,mBAAmB;GACvC;GACA,aAAa;GACd,CAAC,CAMD,QACE,UACC,IAAI,kBAAkB,kCAAkC,MAAM,CACjE,CACA,SAAS,cACR,YACI,GAAuB,KAAA,EAAU,GACjC,IACE,IAAI,kBAAkB,sDAAsD,CAC7E,CACN,CACJ;;;;;;;;CASL,uBACE,KACA,UACA,MACqE;AACrE,SAAO,KAAK,wBAAwB,KAAK,UAAU,KAAK,CAAC,QAAQ,eAAe;AAC9E,QAAK,WAAW,KAAK,KAAK,OAAO,MAAM;AACvC,UAAO,SAAS,WAAW;IAC3B;;;;;;;;CASJ,WACE,SACA,kBACA,KACoC;AACpC,SAAO,QAAQ,kBAAkB,IAAI;;;;;;;CAQvC,kBACE,KACA,MACA,MACA,iBACiC;AACjC,MAAI,CAAC,KAAK,SAAS,CAAC,KAAK,eACvB,QAAO,QAA4B,KAAA,EAAU;EAE/C,MAAM,YAAY,aAAa,KAAK,SAAS,MAAM,CAAC;AACpD,SAAO,KAAK,mBAAmB,KAAK,WAAW,MAAM,KAAK,gBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;CAoB5F,eACE,KACA,MACA,MACA,SACA,OACmC;EACnC,MAAM,EAAE,aAAa;EACrB,MAAM,YAAY,aAAa,SAAS,MAAM,CAAC;EAC/C,MAAM,YAAY,KAAK,KAAK;EAC5B,MAAM,OAAO,iBAAiB,KAAK,WAAW,WAAW,OAAO,KAAK,EAAE,EACrE,2CAA2C,IAAI,OAAO,aACvD,CAAC;AAEF,SAAO,KAAK,uBAAuB,KAAK,UAAU,KAAK,CACpD,OAAO,eAAe;AACrB,QAAK,QAAQ,MAAM,oDAAoD;IACrE,cAAc,OAAO,KAAK;IAC1B;IACA,OAAO;IACR,CAAC;AAGF,SAAM,iBAAiB;IACvB,CACD,SAA+B,qBAC9B,KAAK,WAAW,SAAS,kBAAkB,IAAI,CAC5C,SAAS,oBACR,KAAK,kBAAkB,KAAK,MAAM,MAAM,gBAAgB,CAAC,aAAa;AACpE,QAAK,QAAQ,KAAK,iCAAiC;IACjD,cAAc,OAAO,KAAK;IAC1B;IACD,CAAC;AACF,QAAK,WAAW,IAAI,IAAI;AACxB,SAAM,iBAAiB;IACvB,CACH,CACA,QAAQ,iBAA+B;AACtC,QAAK,QAAQ,MAAM,4BAA4B;IAC7C,cAAc,OAAO,KAAK;IAC1B;IACA,WAAW,aAAa;IACxB,YACG,IAAI,WAAW,UAAU,uBACzB,IAAI,WAAW,UAAU,oBAC1B;IACF,OAAO,aAAa;IACrB,CAAC;AAcF,UAAO,YACL;IAAE,YAAY,KAAK;IAAY,QAAQ,KAAK;IAAQ,EACpD,cACA,KACA,OAAO,KAAK,EACZ,SACD,CACE,aAAa;AACZ,UAAM,iBAAiB;KACvB,CACD,cACC,SACE,IAAI,eACF,YAAY,OAAO,KAAK,CAAC,YAAY,aAAa,WAClD,aACD,CACF,CACF;IACH,CACL,CACA,aAAa;AAKZ,OAAI;AACF,mBAAe,KAAK;AACpB,wBACE,KAAK,WACL,WACA,OAAO,KAAK,EACZ,MACA,KAAK,KAAK,GAAG,UACd;YACM,gBAAyB;AAChC,SAAK,QAAQ,KAAK,uCAAuC;KACvD,cAAc,OAAO,KAAK;KAC1B;KACA,OAAO;KACR,CAAC;;IAEJ,CACD,OAAO,UAAU;GAMhB,MAAM,gBAAgB,MAAM,iBAAiB,QAAQ,MAAM,QAAQ;AACnE,OAAI;AACF,iBAAa,MAAM,cAAc;AACjC,wBACE,KAAK,WACL,WACA,OAAO,KAAK,EACZ,OACA,KAAK,KAAK,GAAG,UACd;YACM,gBAAyB;AAChC,SAAK,QAAQ,KAAK,uCAAuC;KACvD,cAAc,OAAO,KAAK;KAC1B;KACA,OAAO;KACR,CAAC;;IAEJ;;;;;CAMN,cACE,MACA,MACA,SACmC;EACnC,MAAM,YAAY,aAAa,KAAK,SAAS,MAAM,CAAC;AAEpD,SAAO,KAAK,WACT,QACC,WACA,OAAO,QAAQ;AACb,OAAI,QAAQ,MAAM;AAChB,SAAK,QAAQ,KAAK,gCAAgC;KAChD,cAAc,OAAO,KAAK;KAC1B;KACD,CAAC;AACF;;GAeF,MAAM,QAAQ,EAAE,gBAAgB,OAAO;AACvC,OAAI;AACF,UAAM,KAAK,eAAe,KAAK,MAAM,MAAM,SAAS,MAAM;YACnD,OAAgB;AACvB,QAAI,MAAM,gBAAgB;AACxB,UAAK,QAAQ,MACX,qFACA;MACE,cAAc,OAAO,KAAK;MAC1B;MACA;MACD,CACF;AACD;;AAEF,SAAK,QAAQ,MAAM,uDAAuD;KACxE,cAAc,OAAO,KAAK;KAC1B;KACA;KACD,CAAC;AACF,SAAK,WAAW,KAAK,KAAK,OAAO,MAAM;;KAG3C,KAAK,gBAAgB,MACtB,CACA,QAAQ,gBAAgB;AACvB,QAAK,aAAa,IAAI,YAAY;IAClC,CACD,UAAU,KAAA,EAAU,CACpB,QACE,UAAU,IAAI,eAAe,kCAAkC,OAAO,KAAK,CAAC,IAAI,MAAM,CACxF;;;;;;;;;ACtyBP,SAAS,sBACP,UACmB;CACnB,MAAM,YAAY,SAAS,YAAY,OAAO,KAAK,SAAS,UAAU,GAAG,EAAE;CAC3E,MAAM,OAAO,SAAS,OAAO,OAAO,KAAK,SAAS,KAAK,GAAG,EAAE;AAC5D,QAAO,CAAC,GAAG,WAAW,GAAG,KAAK;;AAGhC,SAAS,gBAAgB,OAAkC;AACzD,QAAO,MAAM,SAAS,IAAI,MAAM,KAAK,KAAK,GAAG;;;;;;AAO/C,SAAS,4BACP,UACA,MACM;CACN,MAAM,YAAY,SAAS;CAC3B,MAAM,OAAO,SAAS;AAKtB,KAAI,EAHe,CAAC,CAAC,aAAa,OAAO,OAAO,WAAW,KAAK,KAG7C,EAFL,CAAC,CAAC,QAAQ,OAAO,OAAO,MAAM,KAAK,GAEtB;EACzB,MAAM,YAAY,gBAAgB,sBAAsB,SAAS,CAAC;AAClE,QAAM,IAAI,MACR,mBAAmB,KAAK,yDAAyD,YAClF;;;;;;;AAQL,SAAS,iBACP,UACA,UACM;AACN,MAAK,MAAM,eAAe,OAAO,KAAK,SAAS,CAC7C,6BAA4B,UAAU,YAAY;;AAyFtD,SAAgB,cAGd,UAAqB,MAAa,SAAkB,SAAoC;AACxF,6BAA4B,UAAU,OAAO,KAAK,CAAC;AAEnD,KAAI,QACF,QAAO,CAAC,SAAS,QAAQ;AAE3B,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCT,SAAgB,eACd,UACA,UACgC;AAChC,kBAAiB,UAAU,SAAS;AACpC,QAAO"}