@amqp-contract/client 0.24.0 → 1.0.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.
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../src/compression.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { CompressionAlgorithm } from \"@amqp-contract/contract\";\nimport { TechnicalError } from \"@amqp-contract/core\";\nimport { ResultAsync } from \"neverthrow\";\nimport { deflate, gzip } from \"node:zlib\";\nimport { promisify } from \"node:util\";\nimport { match } from \"ts-pattern\";\n\nconst gzipAsync = promisify(gzip);\nconst deflateAsync = promisify(deflate);\n\n/**\n * Compress a buffer using the specified compression algorithm.\n *\n * @param buffer - The buffer to compress\n * @param algorithm - The compression algorithm to use\n * @returns A ResultAsync resolving to the compressed buffer or a TechnicalError\n *\n * @internal\n */\nexport function compressBuffer(\n buffer: Buffer,\n algorithm: CompressionAlgorithm,\n): ResultAsync<Buffer, TechnicalError> {\n return match(algorithm)\n .with(\"gzip\", () =>\n ResultAsync.fromPromise(\n gzipAsync(buffer),\n (error) => new TechnicalError(\"Failed to compress with gzip\", error),\n ),\n )\n .with(\"deflate\", () =>\n ResultAsync.fromPromise(\n deflateAsync(buffer),\n (error) => new TechnicalError(\"Failed to compress with deflate\", error),\n ),\n )\n .exhaustive();\n}\n","export { MessageValidationError } from \"@amqp-contract/core\";\n\n/**\n * Captured `Error.captureStackTrace` shim — only present on Node.js.\n */\nfunction captureStack(target: object, ctor: Function): void {\n const ErrorConstructor = Error as unknown as {\n captureStackTrace?: (target: object, constructor: Function) => void;\n };\n if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n ErrorConstructor.captureStackTrace(target, ctor);\n }\n}\n\n/**\n * Returned from `TypedAmqpClient.call()` when the configured `timeoutMs` elapses\n * before the RPC server publishes a reply with the matching `correlationId`.\n *\n * The pending call is removed from the in-memory correlation map; if a reply\n * arrives after the timeout it is dropped (and a debug log is emitted by the\n * client if a logger is configured).\n */\nexport class RpcTimeoutError extends Error {\n constructor(\n public readonly rpcName: string,\n public readonly timeoutMs: number,\n ) {\n super(`RPC call to \"${rpcName}\" timed out after ${timeoutMs}ms with no reply received`);\n this.name = \"RpcTimeoutError\";\n captureStack(this, this.constructor);\n }\n}\n\n/**\n * Returned from any in-flight RPC call when the client is closed before the\n * reply is received. The correlation map is cleared on close and every pending\n * caller's promise resolves with `err(RpcCancelledError)`.\n */\nexport class RpcCancelledError extends Error {\n constructor(public readonly rpcName: string) {\n super(`RPC call to \"${rpcName}\" was cancelled because the client was closed`);\n this.name = \"RpcCancelledError\";\n captureStack(this, this.constructor);\n }\n}\n","import {\n extractQueue,\n type CompressionAlgorithm,\n type ContractDefinition,\n type InferPublisherNames,\n type InferRpcNames,\n} from \"@amqp-contract/contract\";\nimport {\n AmqpClient,\n PublishOptions as AmqpClientPublishOptions,\n type Logger,\n MessagingSemanticConventions,\n TechnicalError,\n type TelemetryProvider,\n defaultTelemetryProvider,\n endSpanError,\n endSpanSuccess,\n recordLateRpcReply,\n recordPublishMetric,\n startPublishSpan,\n} from \"@amqp-contract/core\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\nimport { err, errAsync, ok, okAsync, Result, ResultAsync } from \"neverthrow\";\nimport { randomUUID } from \"node:crypto\";\nimport { compressBuffer } from \"./compression.js\";\nimport { MessageValidationError, RpcCancelledError, RpcTimeoutError } from \"./errors.js\";\nimport type {\n ClientInferPublisherInput,\n ClientInferRpcRequestInput,\n ClientInferRpcResponseOutput,\n} from \"./types.js\";\n\n/**\n * The RabbitMQ direct-reply-to pseudo-queue. Publishing with `replyTo` set to\n * this value tells the server to deliver the response back to the consumer\n * subscribed on this queue on the same channel — no real queue is created and\n * no setup is required beyond consuming from it once with `noAck: true`.\n *\n * @see https://www.rabbitmq.com/docs/direct-reply-to\n */\nconst DIRECT_REPLY_TO = \"amq.rabbitmq.reply-to\";\n\n/**\n * In-flight RPC call tracked by `TypedAmqpClient`. The reply consumer\n * looks up entries by `correlationId` when responses arrive.\n */\ntype PendingCall = {\n rpcName: string;\n responseSchema: StandardSchemaV1;\n resolve: (\n result: Result<\n unknown,\n TechnicalError | MessageValidationError | RpcTimeoutError | RpcCancelledError\n >,\n ) => void;\n timer: ReturnType<typeof setTimeout>;\n};\n\n/**\n * Publish options that extend amqp-client's PublishOptions with optional compression support.\n */\nexport type PublishOptions = AmqpClientPublishOptions & {\n /**\n * Optional compression algorithm to use for the message payload.\n * When specified, the message will be compressed using the chosen algorithm\n * and the contentEncoding header will be set automatically.\n */\n compression?: CompressionAlgorithm | undefined;\n};\n\n/**\n * Options for creating a client\n */\nexport type CreateClientOptions<TContract extends ContractDefinition> = {\n contract: TContract;\n urls: ConnectionUrl[];\n connectionOptions?: AmqpConnectionManagerOptions | undefined;\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 * Default publish options that will be applied to all publish operations.\n * These can be overridden by options passed to the publish method.\n * By default, persistent is set to true for message durability.\n */\n defaultPublishOptions?: PublishOptions | 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 * Per-call options for `client.call()`.\n */\nexport type CallOptions = {\n /**\n * Maximum time in ms to wait for an RPC reply. If exceeded, the call resolves\n * to `err(RpcTimeoutError)` and the in-memory correlation entry is cleared.\n * A late reply arriving after the timeout is silently dropped.\n *\n * Required: RPC without a timeout is a footgun.\n */\n timeoutMs: number;\n\n /**\n * Optional AMQP message properties to merge into the request. `replyTo` and\n * `correlationId` are managed by the client and cannot be overridden.\n */\n publishOptions?: Omit<AmqpClientPublishOptions, \"replyTo\" | \"correlationId\">;\n};\n\n/**\n * Type-safe AMQP client for publishing messages\n */\nexport class TypedAmqpClient<TContract extends ContractDefinition> {\n /**\n * In-flight RPC calls keyed by `correlationId`. Cleared when a reply is\n * received, when the call times out, or when the client is closed.\n */\n private readonly pendingCalls = new Map<string, PendingCall>();\n\n /**\n * Consumer tag of the reply consumer subscribed on `amq.rabbitmq.reply-to`.\n * Set when the contract has at least one entry in `rpcs`; undefined otherwise.\n */\n private replyConsumerTag?: string;\n\n private constructor(\n private readonly contract: TContract,\n private readonly amqpClient: AmqpClient,\n private readonly defaultPublishOptions: PublishOptions,\n private readonly logger?: Logger,\n private readonly telemetry: TelemetryProvider = defaultTelemetryProvider,\n ) {}\n\n /**\n * Create a type-safe AMQP client from a contract.\n *\n * Connection management (including automatic reconnection) is handled internally\n * by amqp-connection-manager via the {@link AmqpClient}. The client establishes\n * infrastructure asynchronously in the background once the connection is ready.\n *\n * Connections are automatically shared across clients with the same URLs and\n * connection options, following RabbitMQ best practices.\n */\n static create<TContract extends ContractDefinition>({\n contract,\n urls,\n connectionOptions,\n defaultPublishOptions,\n logger,\n telemetry,\n connectTimeoutMs,\n }: CreateClientOptions<TContract>): ResultAsync<TypedAmqpClient<TContract>, TechnicalError> {\n const client = new TypedAmqpClient(\n contract,\n new AmqpClient(contract, { urls, connectionOptions, connectTimeoutMs }),\n { persistent: true, ...defaultPublishOptions },\n logger,\n telemetry ?? defaultTelemetryProvider,\n );\n\n const setup = client\n .waitForConnectionReady()\n .andThen(() => client.setupReplyConsumerIfNeeded());\n\n return new ResultAsync<TypedAmqpClient<TContract>, TechnicalError>(\n (async () => {\n const setupResult = await setup;\n if (setupResult.isOk()) {\n return ok(client);\n }\n const closeResult = await client.close();\n if (closeResult.isErr()) {\n logger?.warn(\"Failed to close client after connection failure\", {\n error: closeResult.error,\n });\n }\n return err(setupResult.error);\n })(),\n );\n }\n\n /**\n * If the contract has any RPC entry, subscribe to `amq.rabbitmq.reply-to`\n * once. Replies for every in-flight call arrive on this single consumer and\n * are demultiplexed by `correlationId`.\n */\n private setupReplyConsumerIfNeeded(): ResultAsync<void, TechnicalError> {\n const rpcs = this.contract.rpcs ?? {};\n if (Object.keys(rpcs).length === 0) {\n return okAsync(undefined);\n }\n\n return this.amqpClient\n .consume(DIRECT_REPLY_TO, (msg) => this.handleRpcReply(msg), { noAck: true })\n .andTee((tag) => {\n this.replyConsumerTag = tag;\n })\n .map(() => undefined);\n }\n\n /**\n * Demultiplex an RPC reply by `correlationId`, validate the body against the\n * call's response schema, and resolve the awaiting caller. Replies with no\n * matching pending call (the call already timed out, was cancelled, or the\n * correlationId is unknown) are logged at warn — a non-zero rate of these\n * usually indicates a tuning problem (handler latency exceeds caller\n * timeout). The `messaging.rpc.late_reply` counter lets dashboards alert on\n * sustained drift without parsing logs.\n */\n private handleRpcReply(msg: Parameters<Parameters<AmqpClient[\"consume\"]>[1]>[0]): void {\n if (!msg) return;\n const correlationId = msg.properties.correlationId;\n if (typeof correlationId !== \"string\") {\n this.logger?.warn(\"Received RPC reply without correlationId; dropping\", {\n deliveryTag: msg.fields.deliveryTag,\n });\n recordLateRpcReply(this.telemetry, \"missing-correlation-id\");\n return;\n }\n const pending = this.pendingCalls.get(correlationId);\n if (!pending) {\n this.logger?.warn(\n \"Received RPC reply for unknown correlationId (caller already timed out or cancelled)\",\n { correlationId },\n );\n recordLateRpcReply(this.telemetry, \"unknown-correlation-id\");\n return;\n }\n this.pendingCalls.delete(correlationId);\n clearTimeout(pending.timer);\n\n let parsed: unknown;\n try {\n parsed = JSON.parse(msg.content.toString());\n } catch (error: unknown) {\n pending.resolve(\n err(new TechnicalError(`Failed to parse RPC reply JSON for \"${pending.rpcName}\"`, error)),\n );\n return;\n }\n\n // Wrap the validate call itself — a Standard Schema implementation may\n // throw synchronously, and the throw would otherwise escape the consume\n // callback and could crash the reply consumer.\n let rawValidation: ReturnType<StandardSchemaV1[\"~standard\"][\"validate\"]>;\n try {\n rawValidation = pending.responseSchema[\"~standard\"].validate(parsed);\n } catch (error: unknown) {\n pending.resolve(\n err(new TechnicalError(`RPC reply validation threw for \"${pending.rpcName}\"`, error)),\n );\n return;\n }\n const validationPromise =\n rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);\n\n validationPromise.then(\n (validation) => {\n if (validation.issues) {\n pending.resolve(err(new MessageValidationError(pending.rpcName, validation.issues)));\n return;\n }\n pending.resolve(ok(validation.value));\n },\n (error: unknown) => {\n pending.resolve(\n err(new TechnicalError(`RPC reply validation threw for \"${pending.rpcName}\"`, error)),\n );\n },\n );\n }\n\n /**\n * Publish a message using a defined publisher.\n *\n * @param publisherName - The name of the publisher to use\n * @param message - The message to publish\n * @param options - Optional publish options including compression, headers, priority, etc.\n *\n * @remarks\n * If `options.compression` is specified, the message will be compressed before publishing\n * and the `contentEncoding` property will be set automatically. Any `contentEncoding`\n * value already in options will be overwritten by the compression algorithm.\n */\n publish<TName extends InferPublisherNames<TContract>>(\n publisherName: TName,\n message: ClientInferPublisherInput<TContract, TName>,\n options?: PublishOptions,\n ): ResultAsync<void, TechnicalError | MessageValidationError> {\n const startTime = Date.now();\n // Non-null assertions safe: TypeScript guarantees these exist for valid TName\n const publisher = this.contract.publishers![publisherName as string]!;\n const { exchange, routingKey } = publisher;\n\n // Start telemetry span\n const span = startPublishSpan(this.telemetry, exchange.name, routingKey, {\n [MessagingSemanticConventions.AMQP_PUBLISHER_NAME]: String(publisherName),\n });\n\n const validateMessage = (): ResultAsync<unknown, TechnicalError | MessageValidationError> => {\n const validationResult = publisher.message.payload[\"~standard\"].validate(message);\n const promise =\n validationResult instanceof Promise ? validationResult : Promise.resolve(validationResult);\n return ResultAsync.fromPromise(\n promise,\n (error): TechnicalError | MessageValidationError =>\n new TechnicalError(\"Validation failed\", error),\n ).andThen((validation) => {\n if (validation.issues) {\n return err<unknown, TechnicalError | MessageValidationError>(\n new MessageValidationError(String(publisherName), validation.issues),\n );\n }\n return ok<unknown, TechnicalError | MessageValidationError>(validation.value);\n });\n };\n\n const publishMessage = (validatedMessage: unknown): ResultAsync<void, TechnicalError> => {\n // Merge default options with provided options\n const mergedOptions = { ...this.defaultPublishOptions, ...options };\n\n // Extract compression from merged options and create publish options without it\n const { compression, ...restOptions } = mergedOptions;\n const publishOptions: AmqpClientPublishOptions = { ...restOptions };\n\n // Prepare payload and options based on compression configuration\n const preparePayload = (): ResultAsync<Buffer | unknown, TechnicalError> => {\n if (compression) {\n // Compress the message payload\n const messageBuffer = Buffer.from(JSON.stringify(validatedMessage));\n publishOptions.contentEncoding = compression;\n return compressBuffer(messageBuffer, compression);\n }\n\n // No compression: use the channel's built-in JSON serialization\n return okAsync(validatedMessage);\n };\n\n return preparePayload().andThen((payload) =>\n this.amqpClient\n .publish(publisher.exchange.name, publisher.routingKey ?? \"\", payload, publishOptions)\n .andThen((published) => {\n if (!published) {\n return err<void, TechnicalError>(\n new TechnicalError(\n `Failed to publish message for publisher \"${String(publisherName)}\": Channel rejected the message (buffer full or other channel issue)`,\n ),\n );\n }\n\n this.logger?.info(\"Message published successfully\", {\n publisherName: String(publisherName),\n exchange: publisher.exchange.name,\n routingKey: publisher.routingKey,\n compressed: !!compression,\n });\n\n return ok<void, TechnicalError>(undefined);\n }),\n );\n };\n\n return validateMessage()\n .andThen((validatedMessage) => publishMessage(validatedMessage))\n .andTee(() => {\n const durationMs = Date.now() - startTime;\n endSpanSuccess(span);\n recordPublishMetric(this.telemetry, exchange.name, routingKey, true, durationMs);\n })\n .orTee((error) => {\n const durationMs = Date.now() - startTime;\n endSpanError(span, error);\n recordPublishMetric(this.telemetry, exchange.name, routingKey, false, durationMs);\n });\n }\n\n /**\n * Invoke an RPC defined via `defineRpc` and await the typed response.\n *\n * The request payload is validated against the RPC's request schema, then\n * published to the AMQP default exchange with the server's queue name as\n * routing key, `replyTo` set to `amq.rabbitmq.reply-to`, and a fresh UUID\n * `correlationId`. The returned ResultAsync resolves once a matching reply\n * arrives and validates against the response schema, or once `timeoutMs`\n * elapses (whichever comes first).\n *\n * @example\n * ```typescript\n * const result = await client.call('calculate', { a: 1, b: 2 }, { timeoutMs: 5_000 });\n * if (result.isOk()) console.log(result.value.sum); // 3\n * ```\n */\n call<TName extends InferRpcNames<TContract>>(\n rpcName: TName,\n request: ClientInferRpcRequestInput<TContract, TName>,\n options: CallOptions,\n ): ResultAsync<\n ClientInferRpcResponseOutput<TContract, TName>,\n TechnicalError | MessageValidationError | RpcTimeoutError | RpcCancelledError\n > {\n type ResponseType = ClientInferRpcResponseOutput<TContract, TName>;\n type CallError = TechnicalError | MessageValidationError | RpcTimeoutError | RpcCancelledError;\n type CallResult = Result<ResponseType, CallError>;\n\n // setTimeout truncates fractional ms and clamps anything outside the\n // 32-bit signed integer range (~24.8 days) to 1ms, so reject those up\n // front as user errors rather than producing surprising behavior.\n const TIMEOUT_MAX_MS = 2_147_483_647;\n if (\n typeof options.timeoutMs !== \"number\" ||\n !Number.isFinite(options.timeoutMs) ||\n options.timeoutMs <= 0 ||\n options.timeoutMs > TIMEOUT_MAX_MS\n ) {\n return errAsync<ResponseType, CallError>(\n new TechnicalError(\n `Invalid timeoutMs for RPC call to \"${String(rpcName)}\": expected a finite positive number ≤ ${TIMEOUT_MAX_MS}, got ${String(options.timeoutMs)}`,\n ),\n );\n }\n\n const startTime = Date.now();\n // Non-null assertion safe: TName is constrained to RPC names in the contract.\n const rpc = this.contract.rpcs![rpcName as string]!;\n const requestSchema = rpc.request.payload;\n const responseSchema = rpc.response.payload;\n const queueName = extractQueue(rpc.queue).name;\n\n // RPC publishes to the default exchange with the queue name as routing key.\n const span = startPublishSpan(this.telemetry, \"\", queueName, {\n [MessagingSemanticConventions.AMQP_PUBLISHER_NAME]: String(rpcName),\n });\n\n const correlationId = randomUUID();\n\n // Set up the reply future + pending entry up front so a reply that arrives\n // racing the publish round-trip can find a slot. Cleanup on preflight\n // failure happens in the `.orElse` below.\n let resolveCall!: (result: CallResult) => void;\n const callPromise = new Promise<CallResult>((res) => {\n resolveCall = res;\n });\n const callResultAsync = new ResultAsync<ResponseType, CallError>(callPromise);\n\n const timer = setTimeout(() => {\n if (!this.pendingCalls.has(correlationId)) return;\n this.pendingCalls.delete(correlationId);\n resolveCall(err(new RpcTimeoutError(String(rpcName), options.timeoutMs)));\n }, options.timeoutMs);\n\n this.pendingCalls.set(correlationId, {\n rpcName: String(rpcName),\n responseSchema,\n resolve: resolveCall as PendingCall[\"resolve\"],\n timer,\n });\n\n const validateRequest = (): ResultAsync<unknown, TechnicalError | MessageValidationError> => {\n // Wrap the validate call — a Standard Schema implementation may throw\n // synchronously, and that throw would otherwise escape the chain and\n // leave the pending-call entry/timer dangling until timeout.\n let rawValidation: ReturnType<StandardSchemaV1[\"~standard\"][\"validate\"]>;\n try {\n rawValidation = requestSchema[\"~standard\"].validate(request);\n } catch (error: unknown) {\n return errAsync<unknown, TechnicalError | MessageValidationError>(\n new TechnicalError(\"RPC request validation threw\", error),\n );\n }\n const validationPromise =\n rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);\n return ResultAsync.fromPromise(\n validationPromise,\n (error): TechnicalError | MessageValidationError =>\n new TechnicalError(\"RPC request validation threw\", error),\n ).andThen((validation) =>\n validation.issues\n ? err<unknown, TechnicalError | MessageValidationError>(\n new MessageValidationError(String(rpcName), validation.issues),\n )\n : ok<unknown, TechnicalError | MessageValidationError>(validation.value),\n );\n };\n\n const publishRequest = (validatedRequest: unknown): ResultAsync<void, TechnicalError> => {\n // Merge `defaultPublishOptions` (persistent, priority, headers, …) with\n // the per-call options, then layer the RPC-managed fields on top so they\n // cannot be overridden. `compression` is intentionally dropped: RPC v1\n // does not implement reply-side decompression, so request-side\n // compression would break the round-trip.\n const { compression: _ignoredCompression, ...defaultsWithoutCompression } =\n this.defaultPublishOptions;\n const publishOptions: AmqpClientPublishOptions = {\n ...defaultsWithoutCompression,\n ...options.publishOptions,\n replyTo: DIRECT_REPLY_TO,\n correlationId,\n contentType: \"application/json\",\n };\n return this.amqpClient\n .publish(\"\", queueName, validatedRequest, publishOptions)\n .andThen((published) =>\n published\n ? ok<void, TechnicalError>(undefined)\n : err<void, TechnicalError>(\n new TechnicalError(\n `Failed to publish RPC request for \"${String(rpcName)}\": channel buffer full`,\n ),\n ),\n );\n };\n\n return validateRequest()\n .andThen((validated) => publishRequest(validated))\n .andThen(() => callResultAsync)\n .orElse((error: CallError) => {\n // If preflight failed (validate or publish), the pending entry still\n // exists and the timer is alive. Clean both up so the call doesn't\n // leak. Timer-fired errors and reply-resolved errors have already\n // cleaned the entry, so the .has() check guards against double cleanup.\n if (this.pendingCalls.has(correlationId)) {\n clearTimeout(timer);\n this.pendingCalls.delete(correlationId);\n }\n return errAsync<ResponseType, CallError>(error);\n })\n .andTee(() => {\n const durationMs = Date.now() - startTime;\n endSpanSuccess(span);\n recordPublishMetric(this.telemetry, \"\", queueName, true, durationMs);\n })\n .orTee((error) => {\n const durationMs = Date.now() - startTime;\n endSpanError(span, error);\n recordPublishMetric(this.telemetry, \"\", queueName, false, durationMs);\n });\n }\n\n /**\n * Close the channel and connection. Cancels the reply consumer (if any) and\n * rejects every in-flight RPC call with `RpcCancelledError`.\n */\n close(): ResultAsync<void, TechnicalError> {\n // Reject pending calls first — once close() runs, no reply will arrive.\n for (const [, pending] of this.pendingCalls) {\n clearTimeout(pending.timer);\n pending.resolve(err(new RpcCancelledError(pending.rpcName)));\n }\n this.pendingCalls.clear();\n\n const cancelReply: ResultAsync<void, TechnicalError> = this.replyConsumerTag\n ? this.amqpClient.cancel(this.replyConsumerTag).orElse((error) => {\n this.logger?.warn(\"Failed to cancel RPC reply consumer during close\", { error });\n return ok<void, TechnicalError>(undefined);\n })\n : okAsync<void, TechnicalError>(undefined);\n\n return cancelReply.andThen(() => this.amqpClient.close());\n }\n\n private waitForConnectionReady(): ResultAsync<void, TechnicalError> {\n return this.amqpClient.waitForConnect();\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../src/compression.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { CompressionAlgorithm } from \"@amqp-contract/contract\";\nimport { TechnicalError } from \"@amqp-contract/core\";\nimport { fromPromise, type AsyncResult } from \"unthrown\";\nimport { deflate, gzip } from \"node:zlib\";\nimport { promisify } from \"node:util\";\nimport { match } from \"ts-pattern\";\n\nconst gzipAsync = promisify(gzip);\nconst deflateAsync = promisify(deflate);\n\n/**\n * Compress a buffer using the specified compression algorithm.\n *\n * @param buffer - The buffer to compress\n * @param algorithm - The compression algorithm to use\n * @returns An AsyncResult resolving to the compressed buffer or a TechnicalError\n *\n * @internal\n */\nexport function compressBuffer(\n buffer: Buffer,\n algorithm: CompressionAlgorithm,\n): AsyncResult<Buffer, TechnicalError> {\n return match(algorithm)\n .with(\"gzip\", () =>\n fromPromise(\n gzipAsync(buffer),\n (error) => new TechnicalError(\"Failed to compress with gzip\", error),\n ),\n )\n .with(\"deflate\", () =>\n fromPromise(\n deflateAsync(buffer),\n (error) => new TechnicalError(\"Failed to compress with deflate\", error),\n ),\n )\n .exhaustive();\n}\n","import { TaggedError } from \"unthrown\";\n\nexport { MessageValidationError } from \"@amqp-contract/core\";\n\n/**\n * Returned from `TypedAmqpClient.call()` when the configured `timeoutMs` elapses\n * before the RPC server publishes a reply with the matching `correlationId`.\n *\n * The pending call is removed from the in-memory correlation map; if a reply\n * arrives after the timeout it is dropped (and a debug log is emitted by the\n * client if a logger is configured). Carries a namespaced `_tag` of\n * `\"@amqp-contract/RpcTimeoutError\"`; the `Error.name` is kept bare\n * (`\"RpcTimeoutError\"`).\n */\nexport class RpcTimeoutError extends TaggedError(\"@amqp-contract/RpcTimeoutError\", {\n name: \"RpcTimeoutError\",\n})<{\n message: string;\n rpcName: string;\n timeoutMs: number;\n}> {\n constructor(rpcName: string, timeoutMs: number) {\n super({\n message: `RPC call to \"${rpcName}\" timed out after ${timeoutMs}ms with no reply received`,\n rpcName,\n timeoutMs,\n });\n }\n}\n\n/**\n * Returned from any in-flight RPC call when the client is closed before the\n * reply is received. The correlation map is cleared on close and every pending\n * caller's promise resolves with `err(RpcCancelledError)`. Carries a namespaced\n * `_tag` of `\"@amqp-contract/RpcCancelledError\"`; the `Error.name` is kept bare\n * (`\"RpcCancelledError\"`).\n */\nexport class RpcCancelledError extends TaggedError(\"@amqp-contract/RpcCancelledError\", {\n name: \"RpcCancelledError\",\n})<{\n message: string;\n rpcName: string;\n}> {\n constructor(rpcName: string) {\n super({\n message: `RPC call to \"${rpcName}\" was cancelled because the client was closed`,\n rpcName,\n });\n }\n}\n","import {\n extractQueue,\n type CompressionAlgorithm,\n type ContractDefinition,\n type InferPublisherNames,\n type InferRpcNames,\n} from \"@amqp-contract/contract\";\nimport {\n AmqpClient,\n PublishOptions as AmqpClientPublishOptions,\n type Logger,\n MessagingSemanticConventions,\n TechnicalError,\n type TelemetryProvider,\n defaultTelemetryProvider,\n endSpanError,\n endSpanSuccess,\n recordLateRpcReply,\n recordPublishMetric,\n safeJsonParse,\n startPublishSpan,\n} from \"@amqp-contract/core\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\nimport { err, fromPromise, fromSafePromise, ok, type AsyncResult, type Result } from \"unthrown\";\nimport { randomUUID } from \"node:crypto\";\nimport { compressBuffer } from \"./compression.js\";\nimport { MessageValidationError, RpcCancelledError, RpcTimeoutError } from \"./errors.js\";\nimport type {\n ClientInferPublisherInput,\n ClientInferRpcRequestInput,\n ClientInferRpcResponseOutput,\n} from \"./types.js\";\n\n/**\n * The RabbitMQ direct-reply-to pseudo-queue. Publishing with `replyTo` set to\n * this value tells the server to deliver the response back to the consumer\n * subscribed on this queue on the same channel — no real queue is created and\n * no setup is required beyond consuming from it once with `noAck: true`.\n *\n * @see https://www.rabbitmq.com/docs/direct-reply-to\n */\nconst DIRECT_REPLY_TO = \"amq.rabbitmq.reply-to\";\n\n/**\n * In-flight RPC call tracked by `TypedAmqpClient`. The reply consumer\n * looks up entries by `correlationId` when responses arrive.\n */\ntype PendingCall = {\n rpcName: string;\n responseSchema: StandardSchemaV1;\n resolve: (\n result: Result<\n unknown,\n TechnicalError | MessageValidationError | RpcTimeoutError | RpcCancelledError\n >,\n ) => void;\n timer: ReturnType<typeof setTimeout>;\n};\n\n/**\n * Publish options that extend amqp-client's PublishOptions with optional compression support.\n */\nexport type PublishOptions = AmqpClientPublishOptions & {\n /**\n * Optional compression algorithm to use for the message payload.\n * When specified, the message will be compressed using the chosen algorithm\n * and the contentEncoding header will be set automatically.\n */\n compression?: CompressionAlgorithm | undefined;\n};\n\n/**\n * Options for creating a client\n */\nexport type CreateClientOptions<TContract extends ContractDefinition> = {\n contract: TContract;\n urls: ConnectionUrl[];\n connectionOptions?: AmqpConnectionManagerOptions | undefined;\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 * Default publish options that will be applied to all publish operations.\n * These can be overridden by options passed to the publish method.\n * By default, persistent is set to true for message durability.\n */\n defaultPublishOptions?: PublishOptions | 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 * Per-call options for `client.call()`.\n */\nexport type CallOptions = {\n /**\n * Maximum time in ms to wait for an RPC reply. If exceeded, the call resolves\n * to `err(RpcTimeoutError)` and the in-memory correlation entry is cleared.\n * A late reply arriving after the timeout is silently dropped.\n *\n * Required: RPC without a timeout is a footgun.\n */\n timeoutMs: number;\n\n /**\n * Optional AMQP message properties to merge into the request. `replyTo` and\n * `correlationId` are managed by the client and cannot be overridden.\n */\n publishOptions?: Omit<AmqpClientPublishOptions, \"replyTo\" | \"correlationId\">;\n};\n\n/**\n * Type-safe AMQP client for publishing messages\n */\nexport class TypedAmqpClient<TContract extends ContractDefinition> {\n /**\n * In-flight RPC calls keyed by `correlationId`. Cleared when a reply is\n * received, when the call times out, or when the client is closed.\n */\n private readonly pendingCalls = new Map<string, PendingCall>();\n\n /**\n * Consumer tag of the reply consumer subscribed on `amq.rabbitmq.reply-to`.\n * Set when the contract has at least one entry in `rpcs`; undefined otherwise.\n */\n private replyConsumerTag?: string;\n\n private constructor(\n private readonly contract: TContract,\n private readonly amqpClient: AmqpClient,\n private readonly defaultPublishOptions: PublishOptions,\n private readonly logger?: Logger,\n private readonly telemetry: TelemetryProvider = defaultTelemetryProvider,\n ) {}\n\n /**\n * Create a type-safe AMQP client from a contract.\n *\n * Connection management (including automatic reconnection) is handled internally\n * by amqp-connection-manager via the {@link AmqpClient}. The client establishes\n * infrastructure asynchronously in the background once the connection is ready.\n *\n * Connections are automatically shared across clients with the same URLs and\n * connection options, following RabbitMQ best practices.\n */\n static create<TContract extends ContractDefinition>({\n contract,\n urls,\n connectionOptions,\n defaultPublishOptions,\n logger,\n telemetry,\n connectTimeoutMs,\n }: CreateClientOptions<TContract>): AsyncResult<TypedAmqpClient<TContract>, TechnicalError> {\n const client = new TypedAmqpClient(\n contract,\n new AmqpClient(contract, { urls, connectionOptions, connectTimeoutMs }),\n { persistent: true, ...defaultPublishOptions },\n logger,\n telemetry ?? defaultTelemetryProvider,\n );\n\n const setup = client\n .waitForConnectionReady()\n .flatMap(() => client.setupReplyConsumerIfNeeded());\n\n const inner = (async (): Promise<Result<TypedAmqpClient<TContract>, TechnicalError>> => {\n const setupResult = await setup;\n if (!setupResult.isOk()) {\n const closeResult = await client.close();\n if (closeResult.isErr()) {\n logger?.warn(\"Failed to close client after connection failure\", {\n error: closeResult.error,\n });\n }\n }\n // `map` runs only on Ok; an Err/Defect passes through with its value type\n // re-shaped to the client, so the failure surfaces unchanged.\n return setupResult.map(() => client);\n })();\n\n return fromSafePromise(inner).flatMap((result) => result);\n }\n\n /**\n * If the contract has any RPC entry, subscribe to `amq.rabbitmq.reply-to`\n * once. Replies for every in-flight call arrive on this single consumer and\n * are demultiplexed by `correlationId`.\n */\n private setupReplyConsumerIfNeeded(): AsyncResult<void, TechnicalError> {\n const rpcs = this.contract.rpcs ?? {};\n if (Object.keys(rpcs).length === 0) {\n return ok(undefined).toAsync();\n }\n\n return this.amqpClient\n .consume(DIRECT_REPLY_TO, (msg) => this.handleRpcReply(msg), { noAck: true })\n .tap((tag) => {\n this.replyConsumerTag = tag;\n })\n .map(() => undefined);\n }\n\n /**\n * Demultiplex an RPC reply by `correlationId`, validate the body against the\n * call's response schema, and resolve the awaiting caller. Replies with no\n * matching pending call (the call already timed out, was cancelled, or the\n * correlationId is unknown) are logged at warn — a non-zero rate of these\n * usually indicates a tuning problem (handler latency exceeds caller\n * timeout). The `messaging.rpc.late_reply` counter lets dashboards alert on\n * sustained drift without parsing logs.\n */\n private handleRpcReply(msg: Parameters<Parameters<AmqpClient[\"consume\"]>[1]>[0]): void {\n if (!msg) return;\n const correlationId = msg.properties.correlationId;\n if (typeof correlationId !== \"string\") {\n this.logger?.warn(\"Received RPC reply without correlationId; dropping\", {\n deliveryTag: msg.fields.deliveryTag,\n });\n recordLateRpcReply(this.telemetry, \"missing-correlation-id\");\n return;\n }\n const pending = this.pendingCalls.get(correlationId);\n if (!pending) {\n this.logger?.warn(\n \"Received RPC reply for unknown correlationId (caller already timed out or cancelled)\",\n { correlationId },\n );\n recordLateRpcReply(this.telemetry, \"unknown-correlation-id\");\n return;\n }\n this.pendingCalls.delete(correlationId);\n clearTimeout(pending.timer);\n\n const parseResult = safeJsonParse(\n msg.content,\n (error) =>\n new TechnicalError(`Failed to parse RPC reply JSON for \"${pending.rpcName}\"`, error),\n );\n if (!parseResult.isOk()) {\n pending.resolve(\n err(\n parseResult.isErr()\n ? parseResult.error\n : new TechnicalError(\n `Failed to parse RPC reply JSON for \"${pending.rpcName}\"`,\n parseResult.cause,\n ),\n ),\n );\n return;\n }\n const parsed = parseResult.value;\n\n // Wrap the validate call itself — a Standard Schema implementation may\n // throw synchronously, and the throw would otherwise escape the consume\n // callback and could crash the reply consumer.\n let rawValidation: ReturnType<StandardSchemaV1[\"~standard\"][\"validate\"]>;\n try {\n rawValidation = pending.responseSchema[\"~standard\"].validate(parsed);\n } catch (error: unknown) {\n pending.resolve(\n err(new TechnicalError(`RPC reply validation threw for \"${pending.rpcName}\"`, error)),\n );\n return;\n }\n const validationPromise =\n rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);\n\n validationPromise.then(\n (validation) => {\n if (validation.issues) {\n pending.resolve(err(new MessageValidationError(pending.rpcName, validation.issues)));\n return;\n }\n pending.resolve(ok(validation.value));\n },\n (error: unknown) => {\n pending.resolve(\n err(new TechnicalError(`RPC reply validation threw for \"${pending.rpcName}\"`, error)),\n );\n },\n );\n }\n\n /**\n * Publish a message using a defined publisher.\n *\n * @param publisherName - The name of the publisher to use\n * @param message - The message to publish\n * @param options - Optional publish options including compression, headers, priority, etc.\n *\n * @remarks\n * If `options.compression` is specified, the message will be compressed before publishing\n * and the `contentEncoding` property will be set automatically. Any `contentEncoding`\n * value already in options will be overwritten by the compression algorithm.\n */\n publish<TName extends InferPublisherNames<TContract>>(\n publisherName: TName,\n message: ClientInferPublisherInput<TContract, TName>,\n options?: PublishOptions,\n ): AsyncResult<void, TechnicalError | MessageValidationError> {\n const startTime = Date.now();\n // Non-null assertions safe: TypeScript guarantees these exist for valid TName\n const publisher = this.contract.publishers![publisherName as string]!;\n const { exchange, routingKey } = publisher;\n\n // Start telemetry span\n const span = startPublishSpan(this.telemetry, exchange.name, routingKey, {\n [MessagingSemanticConventions.AMQP_PUBLISHER_NAME]: String(publisherName),\n });\n\n const validateMessage = (): AsyncResult<unknown, TechnicalError | MessageValidationError> => {\n const validationResult = publisher.message.payload[\"~standard\"].validate(message);\n const promise =\n validationResult instanceof Promise ? validationResult : Promise.resolve(validationResult);\n return fromPromise(\n promise,\n (error): TechnicalError | MessageValidationError =>\n new TechnicalError(\"Validation failed\", error),\n ).flatMap((validation) => {\n if (validation.issues) {\n return err<TechnicalError | MessageValidationError>(\n new MessageValidationError(String(publisherName), validation.issues),\n );\n }\n return ok(validation.value);\n });\n };\n\n const publishMessage = (validatedMessage: unknown): AsyncResult<void, TechnicalError> => {\n // Merge default options with provided options\n const mergedOptions = { ...this.defaultPublishOptions, ...options };\n\n // Extract compression from merged options and create publish options without it\n const { compression, ...restOptions } = mergedOptions;\n const publishOptions: AmqpClientPublishOptions = { ...restOptions };\n\n // Prepare payload and options based on compression configuration\n const preparePayload = (): AsyncResult<Buffer | unknown, TechnicalError> => {\n if (compression) {\n // Compress the message payload\n const messageBuffer = Buffer.from(JSON.stringify(validatedMessage));\n publishOptions.contentEncoding = compression;\n return compressBuffer(messageBuffer, compression);\n }\n\n // No compression: use the channel's built-in JSON serialization\n return ok(validatedMessage).toAsync();\n };\n\n return preparePayload().flatMap((payload) =>\n this.amqpClient\n .publish(publisher.exchange.name, publisher.routingKey ?? \"\", payload, publishOptions)\n .flatMap((published) => {\n if (!published) {\n return err<TechnicalError>(\n new TechnicalError(\n `Failed to publish message for publisher \"${String(publisherName)}\": Channel rejected the message (buffer full or other channel issue)`,\n ),\n );\n }\n\n this.logger?.info(\"Message published successfully\", {\n publisherName: String(publisherName),\n exchange: publisher.exchange.name,\n routingKey: publisher.routingKey,\n compressed: !!compression,\n });\n\n return ok(undefined);\n }),\n );\n };\n\n return validateMessage()\n .flatMap((validatedMessage) => publishMessage(validatedMessage))\n .tap(() => {\n const durationMs = Date.now() - startTime;\n endSpanSuccess(span);\n recordPublishMetric(this.telemetry, exchange.name, routingKey, true, durationMs);\n })\n .tapErr((error) => {\n const durationMs = Date.now() - startTime;\n endSpanError(span, error);\n recordPublishMetric(this.telemetry, exchange.name, routingKey, false, durationMs);\n });\n }\n\n /**\n * Invoke an RPC defined via `defineRpc` and await the typed response.\n *\n * The request payload is validated against the RPC's request schema, then\n * published to the AMQP default exchange with the server's queue name as\n * routing key, `replyTo` set to `amq.rabbitmq.reply-to`, and a fresh UUID\n * `correlationId`. The returned AsyncResult resolves once a matching reply\n * arrives and validates against the response schema, or once `timeoutMs`\n * elapses (whichever comes first).\n *\n * @example\n * ```typescript\n * const result = await client.call('calculate', { a: 1, b: 2 }, { timeoutMs: 5_000 });\n * result.match({\n * ok: (value) => console.log(value.sum), // 3\n * err: (error) => console.error(error),\n * defect: (cause) => console.error(cause),\n * });\n * ```\n */\n call<TName extends InferRpcNames<TContract>>(\n rpcName: TName,\n request: ClientInferRpcRequestInput<TContract, TName>,\n options: CallOptions,\n ): AsyncResult<\n ClientInferRpcResponseOutput<TContract, TName>,\n TechnicalError | MessageValidationError | RpcTimeoutError | RpcCancelledError\n > {\n type ResponseType = ClientInferRpcResponseOutput<TContract, TName>;\n type CallError = TechnicalError | MessageValidationError | RpcTimeoutError | RpcCancelledError;\n type CallResult = Result<ResponseType, CallError>;\n\n // setTimeout truncates fractional ms and clamps anything outside the\n // 32-bit signed integer range (~24.8 days) to 1ms, so reject those up\n // front as user errors rather than producing surprising behavior.\n const TIMEOUT_MAX_MS = 2_147_483_647;\n if (\n typeof options.timeoutMs !== \"number\" ||\n !Number.isFinite(options.timeoutMs) ||\n options.timeoutMs <= 0 ||\n options.timeoutMs > TIMEOUT_MAX_MS\n ) {\n return err<CallError>(\n new TechnicalError(\n `Invalid timeoutMs for RPC call to \"${String(rpcName)}\": expected a finite positive number ≤ ${TIMEOUT_MAX_MS}, got ${String(options.timeoutMs)}`,\n ),\n ).toAsync();\n }\n\n const startTime = Date.now();\n // Non-null assertion safe: TName is constrained to RPC names in the contract.\n const rpc = this.contract.rpcs![rpcName as string]!;\n const requestSchema = rpc.request.payload;\n const responseSchema = rpc.response.payload;\n const queueName = extractQueue(rpc.queue).name;\n\n // RPC publishes to the default exchange with the queue name as routing key.\n const span = startPublishSpan(this.telemetry, \"\", queueName, {\n [MessagingSemanticConventions.AMQP_PUBLISHER_NAME]: String(rpcName),\n });\n\n const correlationId = randomUUID();\n\n // Set up the reply future + pending entry up front so a reply that arrives\n // racing the publish round-trip can find a slot. Cleanup on preflight\n // failure happens in the `.orElse` below.\n let resolveCall!: (result: CallResult) => void;\n const callPromise = new Promise<CallResult>((res) => {\n resolveCall = res;\n });\n // `callPromise` resolves to a `Result` (never rejects), so lift it with\n // `fromSafePromise` and collapse the nested `Result` back into the channel.\n const callResultAsync: AsyncResult<ResponseType, CallError> = fromSafePromise(\n callPromise,\n ).flatMap((result) => result);\n\n const timer = setTimeout(() => {\n if (!this.pendingCalls.has(correlationId)) return;\n this.pendingCalls.delete(correlationId);\n resolveCall(err(new RpcTimeoutError(String(rpcName), options.timeoutMs)));\n }, options.timeoutMs);\n\n this.pendingCalls.set(correlationId, {\n rpcName: String(rpcName),\n responseSchema,\n resolve: resolveCall as PendingCall[\"resolve\"],\n timer,\n });\n\n const validateRequest = (): AsyncResult<unknown, TechnicalError | MessageValidationError> => {\n // Wrap the validate call — a Standard Schema implementation may throw\n // synchronously, and that throw would otherwise escape the chain and\n // leave the pending-call entry/timer dangling until timeout.\n let rawValidation: ReturnType<StandardSchemaV1[\"~standard\"][\"validate\"]>;\n try {\n rawValidation = requestSchema[\"~standard\"].validate(request);\n } catch (error: unknown) {\n return err<TechnicalError | MessageValidationError>(\n new TechnicalError(\"RPC request validation threw\", error),\n ).toAsync();\n }\n const validationPromise =\n rawValidation instanceof Promise ? rawValidation : Promise.resolve(rawValidation);\n return fromPromise(\n validationPromise,\n (error): TechnicalError | MessageValidationError =>\n new TechnicalError(\"RPC request validation threw\", error),\n ).flatMap((validation) =>\n validation.issues\n ? err<TechnicalError | MessageValidationError>(\n new MessageValidationError(String(rpcName), validation.issues),\n )\n : ok(validation.value),\n );\n };\n\n const publishRequest = (validatedRequest: unknown): AsyncResult<void, TechnicalError> => {\n // Merge `defaultPublishOptions` (persistent, priority, headers, …) with\n // the per-call options, then layer the RPC-managed fields on top so they\n // cannot be overridden. `compression` is intentionally dropped: RPC v1\n // does not implement reply-side decompression, so request-side\n // compression would break the round-trip.\n const { compression: _ignoredCompression, ...defaultsWithoutCompression } =\n this.defaultPublishOptions;\n const publishOptions: AmqpClientPublishOptions = {\n ...defaultsWithoutCompression,\n ...options.publishOptions,\n replyTo: DIRECT_REPLY_TO,\n correlationId,\n contentType: \"application/json\",\n };\n return this.amqpClient\n .publish(\"\", queueName, validatedRequest, publishOptions)\n .flatMap((published) =>\n published\n ? ok(undefined)\n : err<TechnicalError>(\n new TechnicalError(\n `Failed to publish RPC request for \"${String(rpcName)}\": channel buffer full`,\n ),\n ),\n );\n };\n\n return validateRequest()\n .flatMap((validated) => publishRequest(validated))\n .flatMap(() => callResultAsync)\n .orElse((error: CallError) => {\n // If preflight failed (validate or publish), the pending entry still\n // exists and the timer is alive. Clean both up so the call doesn't\n // leak. Timer-fired errors and reply-resolved errors have already\n // cleaned the entry, so the .has() check guards against double cleanup.\n if (this.pendingCalls.has(correlationId)) {\n clearTimeout(timer);\n this.pendingCalls.delete(correlationId);\n }\n return err(error).toAsync();\n })\n .tap(() => {\n const durationMs = Date.now() - startTime;\n endSpanSuccess(span);\n recordPublishMetric(this.telemetry, \"\", queueName, true, durationMs);\n })\n .tapErr((error) => {\n const durationMs = Date.now() - startTime;\n endSpanError(span, error);\n recordPublishMetric(this.telemetry, \"\", queueName, false, durationMs);\n });\n }\n\n /**\n * Close the channel and connection. Cancels the reply consumer (if any) and\n * rejects every in-flight RPC call with `RpcCancelledError`.\n */\n close(): AsyncResult<void, TechnicalError> {\n // Reject pending calls first — once close() runs, no reply will arrive.\n for (const [, pending] of this.pendingCalls) {\n clearTimeout(pending.timer);\n pending.resolve(err(new RpcCancelledError(pending.rpcName)));\n }\n this.pendingCalls.clear();\n\n const cancelReply: AsyncResult<void, TechnicalError> = this.replyConsumerTag\n ? this.amqpClient.cancel(this.replyConsumerTag).orElse((error) => {\n this.logger?.warn(\"Failed to cancel RPC reply consumer during close\", { error });\n return ok(undefined);\n })\n : ok(undefined).toAsync();\n\n return cancelReply.flatMap(() => this.amqpClient.close());\n }\n\n private waitForConnectionReady(): AsyncResult<void, TechnicalError> {\n return this.amqpClient.waitForConnect();\n }\n}\n"],"mappings":"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"}