@amqp-contract/core 0.24.0 → 0.25.0

package/dist/index.cjs

@@ -375,6 +375,15 @@ var AmqpClient = class {
 	/** Resolved timeout in ms; `null` means "wait forever". */
 	connectTimeoutMs;
 	/**
+	* Per-consumer prefetch setup functions registered via `addSetup` so they
+	* can be removed in {@link cancel} once the consumer is gone — otherwise
+	* the channel wrapper would replay the cancelled consumer's QoS on every
+	* reconnect and silently apply it to subsequent consumers.
+	*
+	* @internal
+	*/
+	prefetchSetups = /* @__PURE__ */ new Map();
+	/**
 	* Create a new AMQP client instance.
 	*
 	* The client will automatically:
@@ -468,16 +477,55 @@ var AmqpClient = class {
 	/**
 	* Start consuming messages from a queue.
 	*
+	* If `options.prefetch` is set, a per-consumer prefetch count is applied via
+	* `channel.prefetch(count, false)` registered as a setup function on the
+	* channel wrapper *before* the underlying `consume` call. Registering it via
+	* `addSetup` ensures the prefetch is reapplied automatically on channel
+	* reconnect; using `global=false` scopes it to subsequent consumers on the
+	* channel (RabbitMQ semantics — opposite of intuition: `false` is per-
+	* consumer, `true` is channel-wide).
+	*
+	* `prefetch` is stripped from the options handed to `channelWrapper.consume`
+	* because it is not a valid `amqplib` `Options.Consume` field — leaving it
+	* in would just travel as a no-op key-value pair on the consume frame.
+	*
 	* @returns ResultAsync resolving to the consumer tag.
 	*/
 	consume(queue, callback, options) {
-		return neverthrow.ResultAsync.fromPromise(this.channelWrapper.consume(queue, callback, options), (error) => new TechnicalError("Failed to start consuming messages", error)).map((reply) => reply.consumerTag);
+		const { prefetch, ...consumeOptions } = options ?? {};
+		if (prefetch !== void 0) {
+			if (!Number.isInteger(prefetch) || prefetch < 0 || prefetch > 65535) return (0, neverthrow.errAsync)(new TechnicalError(`Invalid prefetch: expected a non-negative integer ≤ 65535, got ${String(prefetch)}`));
+		}
+		const prefetchSetup = typeof prefetch === "number" ? async (channel) => {
+			await channel.prefetch(prefetch, false);
+		} : void 0;
+		const consumePromise = (async () => {
+			if (prefetchSetup) await this.channelWrapper.addSetup(prefetchSetup);
+			let reply;
+			try {
+				reply = await this.channelWrapper.consume(queue, callback, consumeOptions);
+			} catch (error) {
+				if (prefetchSetup) await this.channelWrapper.removeSetup(prefetchSetup).catch(() => {});
+				throw error;
+			}
+			if (prefetchSetup) this.prefetchSetups.set(reply.consumerTag, prefetchSetup);
+			return reply;
+		})();
+		return neverthrow.ResultAsync.fromPromise(consumePromise, (error) => new TechnicalError("Failed to start consuming messages", error)).map((reply) => reply.consumerTag);
 	}
 	/**
 	* Cancel a consumer by its consumer tag.
 	*/
 	cancel(consumerTag) {
-		return neverthrow.ResultAsync.fromPromise(this.channelWrapper.cancel(consumerTag), (error) => new TechnicalError("Failed to cancel consumer", error)).map(() => void 0);
+		return neverthrow.ResultAsync.fromPromise((async () => {
+			const setup = this.prefetchSetups.get(consumerTag);
+			this.prefetchSetups.delete(consumerTag);
+			try {
+				await this.channelWrapper.cancel(consumerTag);
+			} finally {
+				if (setup !== void 0) await this.channelWrapper.removeSetup(setup).catch(() => {});
+			}
+		})(), (error) => new TechnicalError("Failed to cancel consumer", error)).map(() => void 0);
 	}
 	/**
 	* Acknowledge a message.
@@ -552,6 +600,32 @@ var AmqpClient = class {
 	}
 };
 //#endregion
+//#region src/parsing.ts
+/**
+* Parse a `Buffer` as JSON, mapping any `JSON.parse` exception to the
+* caller-supplied error type.
+*
+* Use this in consume / reply paths where a parse failure is a typed value,
+* not a thrown exception — the caller decides how to translate the raw error
+* into a domain-level error (e.g. {@link TechnicalError}).
+*
+* @typeParam E - The error type produced by `errorFn`.
+* @param buffer - The raw message body to parse.
+* @param errorFn - Callback invoked with the underlying `JSON.parse` error.
+* @returns A `Result` containing the parsed `unknown` value or the mapped error.
+*
+* @example
+* ```typescript
+* const parsed = safeJsonParse(
+*   msg.content,
+*   (error) => new TechnicalError("Failed to parse JSON", error),
+* );
+* ```
+*/
+function safeJsonParse(buffer, errorFn) {
+	return neverthrow.Result.fromThrowable(() => JSON.parse(buffer.toString()), errorFn)();
+}
+//#endregion
 //#region src/telemetry.ts
 /**
 * SpanKind values from OpenTelemetry.
@@ -830,6 +904,7 @@ exports.endSpanSuccess = endSpanSuccess;
 exports.recordConsumeMetric = recordConsumeMetric;
 exports.recordLateRpcReply = recordLateRpcReply;
 exports.recordPublishMetric = recordPublishMetric;
+exports.safeJsonParse = safeJsonParse;
 exports.setupAmqpTopology = setupAmqpTopology;
 exports.startConsumeSpan = startConsumeSpan;
 exports.startPublishSpan = startPublishSpan;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { ContractDefinition } from "@amqp-contract/contract";
 import { AmqpConnectionManager, AmqpConnectionManagerOptions, ConnectionUrl, CreateChannelOpts } from "amqp-connection-manager";
 import { Channel, ConsumeMessage, Options } from "amqplib";
-import { ResultAsync } from "neverthrow";
+import { Result, ResultAsync } from "neverthrow";
 import { Attributes, Counter, Histogram, Span, Tracer } from "@opentelemetry/api";
 
 //#region src/errors.d.ts
@@ -63,16 +63,29 @@ type AmqpClientOptions = {
  */
 type ConsumeCallback = (msg: ConsumeMessage | null) => void | Promise<void>;
 /**
- * Publish options that extend amqplib's Options.Publish with optional timeout support.
+ * Publish options for `AmqpClient.publish` / `AmqpClient.sendToQueue`.
+ *
+ * Currently a re-export of amqplib's `Options.Publish`. A previous version of
+ * this type also exposed a `timeout` field, but that field never had a
+ * meaningful AMQP-level effect in this codebase and has been removed to avoid
+ * suggesting behaviour we do not provide. (`amqp-connection-manager`'s own
+ * `publishTimeout` channel option is unrelated and is configured at channel
+ * creation, not per-publish.)
  */
-type PublishOptions = Options.Publish & {
-  /** Message will be rejected after timeout ms */timeout?: number;
-};
+type PublishOptions = Options.Publish;
 /**
- * Consume options that extend amqplib's Options.Consume with optional prefetch support.
+ * Consume options that extend amqplib's `Options.Consume` with an optional
+ * per-consumer prefetch count.
+ *
+ * `prefetch` is intercepted by {@link AmqpClient.consume}: it is stripped from
+ * the options handed to the underlying `channelWrapper.consume(...)` call
+ * (since amqplib's `Options.Consume` does not include it) and applied via
+ * `channel.prefetch(count, false)` registered through `addSetup` *before* the
+ * consume so the value is in effect when the consumer starts and is reapplied
+ * automatically on channel reconnect.
  */
 type ConsumerOptions = Options.Consume & {
-  /** Number of messages to prefetch */prefetch?: number;
+  /** Per-consumer prefetch count. Applied before `channel.consume(...)`. */prefetch?: number;
 };
 /**
  * AMQP client that manages connections and channels with automatic topology setup.
@@ -110,6 +123,15 @@ declare class AmqpClient {
   private readonly connectionOptions?;
   /** Resolved timeout in ms; `null` means "wait forever". */
   private readonly connectTimeoutMs;
+  /**
+   * Per-consumer prefetch setup functions registered via `addSetup` so they
+   * can be removed in {@link cancel} once the consumer is gone — otherwise
+   * the channel wrapper would replay the cancelled consumer's QoS on every
+   * reconnect and silently apply it to subsequent consumers.
+   *
+   * @internal
+   */
+  private readonly prefetchSetups;
   /**
    * Create a new AMQP client instance.
    *
@@ -162,6 +184,18 @@ declare class AmqpClient {
   /**
    * Start consuming messages from a queue.
    *
+   * If `options.prefetch` is set, a per-consumer prefetch count is applied via
+   * `channel.prefetch(count, false)` registered as a setup function on the
+   * channel wrapper *before* the underlying `consume` call. Registering it via
+   * `addSetup` ensures the prefetch is reapplied automatically on channel
+   * reconnect; using `global=false` scopes it to subsequent consumers on the
+   * channel (RabbitMQ semantics — opposite of intuition: `false` is per-
+   * consumer, `true` is channel-wide).
+   *
+   * `prefetch` is stripped from the options handed to `channelWrapper.consume`
+   * because it is not a valid `amqplib` `Options.Consume` field — leaving it
+   * in would just travel as a no-op key-value pair on the consume frame.
+   *
    * @returns ResultAsync resolving to the consumer tag.
    */
   consume(queue: string, callback: ConsumeCallback, options?: ConsumerOptions): ResultAsync<string, TechnicalError>;
@@ -296,6 +330,30 @@ type Logger = {
   error(message: string, context?: LoggerContext): void;
 };
 //#endregion
+//#region src/parsing.d.ts
+/**
+ * Parse a `Buffer` as JSON, mapping any `JSON.parse` exception to the
+ * caller-supplied error type.
+ *
+ * Use this in consume / reply paths where a parse failure is a typed value,
+ * not a thrown exception — the caller decides how to translate the raw error
+ * into a domain-level error (e.g. {@link TechnicalError}).
+ *
+ * @typeParam E - The error type produced by `errorFn`.
+ * @param buffer - The raw message body to parse.
+ * @param errorFn - Callback invoked with the underlying `JSON.parse` error.
+ * @returns A `Result` containing the parsed `unknown` value or the mapped error.
+ *
+ * @example
+ * ```typescript
+ * const parsed = safeJsonParse(
+ *   msg.content,
+ *   (error) => new TechnicalError("Failed to parse JSON", error),
+ * );
+ * ```
+ */
+declare function safeJsonParse<E>(buffer: Buffer, errorFn: (raw: unknown) => E): Result<unknown, E>;
+//#endregion
 //#region src/setup.d.ts
 /**
  * Setup AMQP topology (exchanges, queues, and bindings) from a contract definition.
@@ -423,5 +481,5 @@ declare function recordLateRpcReply(provider: TelemetryProvider, reason: "unknow
  */
 declare function _resetTelemetryCacheForTesting(): void;
 //#endregion
-export { AmqpClient, type AmqpClientOptions, type ConsumeCallback, type ConsumerOptions, DEFAULT_CONNECT_TIMEOUT_MS, type Logger, type LoggerContext, MessageValidationError, MessagingSemanticConventions, type PublishOptions, TechnicalError, type TelemetryProvider, _getConnectionCountForTesting, _resetConnectionsForTesting, _resetTelemetryCacheForTesting, defaultTelemetryProvider, endSpanError, endSpanSuccess, recordConsumeMetric, recordLateRpcReply, recordPublishMetric, setupAmqpTopology, startConsumeSpan, startPublishSpan };
+export { AmqpClient, type AmqpClientOptions, type ConsumeCallback, type ConsumerOptions, DEFAULT_CONNECT_TIMEOUT_MS, type Logger, type LoggerContext, MessageValidationError, MessagingSemanticConventions, type PublishOptions, TechnicalError, type TelemetryProvider, _getConnectionCountForTesting, _resetConnectionsForTesting, _resetTelemetryCacheForTesting, defaultTelemetryProvider, endSpanError, endSpanSuccess, recordConsumeMetric, recordLateRpcReply, recordPublishMetric, safeJsonParse, setupAmqpTopology, startConsumeSpan, startPublishSpan };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/amqp-client.ts","../src/connection-manager.ts","../src/logger.ts","../src/setup.ts","../src/telemetry.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/amqp-client.ts","../src/connection-manager.ts","../src/logger.ts","../src/parsing.ts","../src/setup.ts","../src/telemetry.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ResultAsync } from "neverthrow";
+import { Result, ResultAsync } from "neverthrow";
 import { AmqpConnectionManager, AmqpConnectionManagerOptions, ConnectionUrl, CreateChannelOpts } from "amqp-connection-manager";
 import { ContractDefinition } from "@amqp-contract/contract";
 import { Attributes, Counter, Histogram, Span, Tracer } from "@opentelemetry/api";
@@ -63,16 +63,29 @@ type AmqpClientOptions = {
  */
 type ConsumeCallback = (msg: ConsumeMessage | null) => void | Promise<void>;
 /**
- * Publish options that extend amqplib's Options.Publish with optional timeout support.
+ * Publish options for `AmqpClient.publish` / `AmqpClient.sendToQueue`.
+ *
+ * Currently a re-export of amqplib's `Options.Publish`. A previous version of
+ * this type also exposed a `timeout` field, but that field never had a
+ * meaningful AMQP-level effect in this codebase and has been removed to avoid
+ * suggesting behaviour we do not provide. (`amqp-connection-manager`'s own
+ * `publishTimeout` channel option is unrelated and is configured at channel
+ * creation, not per-publish.)
  */
-type PublishOptions = Options.Publish & {
-  /** Message will be rejected after timeout ms */timeout?: number;
-};
+type PublishOptions = Options.Publish;
 /**
- * Consume options that extend amqplib's Options.Consume with optional prefetch support.
+ * Consume options that extend amqplib's `Options.Consume` with an optional
+ * per-consumer prefetch count.
+ *
+ * `prefetch` is intercepted by {@link AmqpClient.consume}: it is stripped from
+ * the options handed to the underlying `channelWrapper.consume(...)` call
+ * (since amqplib's `Options.Consume` does not include it) and applied via
+ * `channel.prefetch(count, false)` registered through `addSetup` *before* the
+ * consume so the value is in effect when the consumer starts and is reapplied
+ * automatically on channel reconnect.
  */
 type ConsumerOptions = Options.Consume & {
-  /** Number of messages to prefetch */prefetch?: number;
+  /** Per-consumer prefetch count. Applied before `channel.consume(...)`. */prefetch?: number;
 };
 /**
  * AMQP client that manages connections and channels with automatic topology setup.
@@ -110,6 +123,15 @@ declare class AmqpClient {
   private readonly connectionOptions?;
   /** Resolved timeout in ms; `null` means "wait forever". */
   private readonly connectTimeoutMs;
+  /**
+   * Per-consumer prefetch setup functions registered via `addSetup` so they
+   * can be removed in {@link cancel} once the consumer is gone — otherwise
+   * the channel wrapper would replay the cancelled consumer's QoS on every
+   * reconnect and silently apply it to subsequent consumers.
+   *
+   * @internal
+   */
+  private readonly prefetchSetups;
   /**
    * Create a new AMQP client instance.
    *
@@ -162,6 +184,18 @@ declare class AmqpClient {
   /**
    * Start consuming messages from a queue.
    *
+   * If `options.prefetch` is set, a per-consumer prefetch count is applied via
+   * `channel.prefetch(count, false)` registered as a setup function on the
+   * channel wrapper *before* the underlying `consume` call. Registering it via
+   * `addSetup` ensures the prefetch is reapplied automatically on channel
+   * reconnect; using `global=false` scopes it to subsequent consumers on the
+   * channel (RabbitMQ semantics — opposite of intuition: `false` is per-
+   * consumer, `true` is channel-wide).
+   *
+   * `prefetch` is stripped from the options handed to `channelWrapper.consume`
+   * because it is not a valid `amqplib` `Options.Consume` field — leaving it
+   * in would just travel as a no-op key-value pair on the consume frame.
+   *
    * @returns ResultAsync resolving to the consumer tag.
    */
   consume(queue: string, callback: ConsumeCallback, options?: ConsumerOptions): ResultAsync<string, TechnicalError>;
@@ -296,6 +330,30 @@ type Logger = {
   error(message: string, context?: LoggerContext): void;
 };
 //#endregion
+//#region src/parsing.d.ts
+/**
+ * Parse a `Buffer` as JSON, mapping any `JSON.parse` exception to the
+ * caller-supplied error type.
+ *
+ * Use this in consume / reply paths where a parse failure is a typed value,
+ * not a thrown exception — the caller decides how to translate the raw error
+ * into a domain-level error (e.g. {@link TechnicalError}).
+ *
+ * @typeParam E - The error type produced by `errorFn`.
+ * @param buffer - The raw message body to parse.
+ * @param errorFn - Callback invoked with the underlying `JSON.parse` error.
+ * @returns A `Result` containing the parsed `unknown` value or the mapped error.
+ *
+ * @example
+ * ```typescript
+ * const parsed = safeJsonParse(
+ *   msg.content,
+ *   (error) => new TechnicalError("Failed to parse JSON", error),
+ * );
+ * ```
+ */
+declare function safeJsonParse<E>(buffer: Buffer, errorFn: (raw: unknown) => E): Result<unknown, E>;
+//#endregion
 //#region src/setup.d.ts
 /**
  * Setup AMQP topology (exchanges, queues, and bindings) from a contract definition.
@@ -423,5 +481,5 @@ declare function recordLateRpcReply(provider: TelemetryProvider, reason: "unknow
  */
 declare function _resetTelemetryCacheForTesting(): void;
 //#endregion
-export { AmqpClient, type AmqpClientOptions, type ConsumeCallback, type ConsumerOptions, DEFAULT_CONNECT_TIMEOUT_MS, type Logger, type LoggerContext, MessageValidationError, MessagingSemanticConventions, type PublishOptions, TechnicalError, type TelemetryProvider, _getConnectionCountForTesting, _resetConnectionsForTesting, _resetTelemetryCacheForTesting, defaultTelemetryProvider, endSpanError, endSpanSuccess, recordConsumeMetric, recordLateRpcReply, recordPublishMetric, setupAmqpTopology, startConsumeSpan, startPublishSpan };
+export { AmqpClient, type AmqpClientOptions, type ConsumeCallback, type ConsumerOptions, DEFAULT_CONNECT_TIMEOUT_MS, type Logger, type LoggerContext, MessageValidationError, MessagingSemanticConventions, type PublishOptions, TechnicalError, type TelemetryProvider, _getConnectionCountForTesting, _resetConnectionsForTesting, _resetTelemetryCacheForTesting, defaultTelemetryProvider, endSpanError, endSpanSuccess, recordConsumeMetric, recordLateRpcReply, recordPublishMetric, safeJsonParse, setupAmqpTopology, startConsumeSpan, startPublishSpan };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts","../src/amqp-client.ts","../src/connection-manager.ts","../src/logger.ts","../src/setup.ts","../src/telemetry.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts","../src/amqp-client.ts","../src/connection-manager.ts","../src/logger.ts","../src/parsing.ts","../src/setup.ts","../src/telemetry.ts"],"mappings":";;;;;;;;;;;;;cAMa,cAAA,SAAuB,KAAA;EAAA,SAGP,KAAA;cADzB,OAAA,UACyB,KAAA;AAAA;;;;;;;;;AAuB7B;cAAa,sBAAA,SAA+B,KAAA;EAAA,SAExB,MAAA;EAAA,SACA,MAAA;cADA,MAAA,UACA,MAAA;AAAA;;;;;AA7BpB;;;;;;;cCwCa,0BAAA;;;;ADdb;;;;;;;;KCwCY,iBAAA;EACV,IAAA,EAAM,aAAA;EACN,iBAAA,GAAoB,4BAAA;EACpB,cAAA,GAAiB,OAAA,CAAQ,iBAAA;EACzB,gBAAA;AAAA;;AA9BF;;KAoCY,eAAA,IAAmB,GAAA,EAAK,cAAA,mBAAiC,OAAA;;;AAVrE;;;;;;;;KAsBY,cAAA,GAAiB,OAAA,CAAQ,OAAA;;;;;;;;;;;AAZrC;KAyBY,eAAA,GAAkB,OAAA,CAAQ,OAAA;4EAEpC,QAAA;AAAA;;;;;AAfF;;;;;AAaA;;;;;;;;;AAiCA;;;;;;;;;;cAAa,UAAA;EAAA,iBA6BQ,QAAA;EAAA,iBA5BF,UAAA;EAAA,iBACA,cAAA;EAAA,iBACA,IAAA;EAAA,iBACA,iBAAA;EAkLL;EAAA,iBAhLK,gBAAA;EAkLM;;;;;;;;EAAA,iBAzKN,cAAA;EAkUR;;;;;;;;;;;cApTU,QAAA,EAAU,kBAAA,EAC3B,OAAA,EAAS,iBAAA;EADkB;;;;;;;;;EAsD7B,aAAA,CAAA,GAAiB,qBAAA;EAqDf;;;;;;;;;;;;;;EAnCF,cAAA,CAAA,GAAkB,WAAA,OAAkB,cAAA;EAuDZ;;;;;EArBxB,OAAA,CACE,QAAA,UACA,UAAA,UACA,OAAA,EAAS,MAAA,YACT,OAAA,GAAU,cAAA,GACT,WAAA,UAAqB,cAAA;EA2CtB;;;;;EA/BF,WAAA,CACE,KAAA,UACA,OAAA,EAAS,MAAA,YACT,OAAA,GAAU,cAAA,GACT,WAAA,UAAqB,cAAA;EAkGuB;;;;;;;;;;;;;;;;;EA1E/C,OAAA,CACE,KAAA,UACA,QAAA,EAAU,eAAA,EACV,OAAA,GAAU,eAAA,GACT,WAAA,SAAoB,cAAA;EA0IL;;;EApElB,MAAA,CAAO,WAAA,WAAsB,WAAA,OAAkB,cAAA;EAyHlC;;;;;;EA1Fb,GAAA,CAAI,GAAA,EAAK,cAAA,EAAgB,OAAA;ECjOX;;;;;AAShB;;EDmOE,IAAA,CAAK,GAAA,EAAK,cAAA,EAAgB,OAAA,YAAiB,OAAA;ECnOE;;;;;ACzM/C;;EFubE,QAAA,CAAS,KAAA,GAAQ,OAAA,EAAS,OAAA,YAAmB,OAAA;EEvbnB;;AAqB5B;;;;;;;;;EFibE,EAAA,CAAG,KAAA,UAAe,QAAA,MAAc,IAAA;EE3a1B;;;;;;;;;;;EF0bN,KAAA,CAAA,GAAS,WAAA,OAAkB,cAAA;EErarB;;;;EAAA,OF2cO,+BAAA,CAAA,GAAmC,OAAA;AAAA;;;;;;;;;;;iBC3TlC,6BAAA,CAAA;;;;;;iBASA,2BAAA,CAAA,GAA+B,OAAA;;;;;;;;;;AF3M/C;KGEY,aAAA,GAAgB,MAAA;EAC1B,KAAA;AAAA;;;;;;;;AHuBF;;;;;;;;;;KGHY,MAAA;EHMuB;;;;ACWnC;EEXE,KAAA,CAAM,OAAA,UAAiB,OAAA,GAAU,aAAA;;;;AFqCnC;;EE9BE,IAAA,CAAK,OAAA,UAAiB,OAAA,GAAU,aAAA;EF+B1B;;;;;EExBN,IAAA,CAAK,OAAA,UAAiB,OAAA,GAAU,aAAA;EFwBhC;;;;;EEjBA,KAAA,CAAM,OAAA,UAAiB,OAAA,GAAU,aAAA;AAAA;;;;;;;;;AHlDnC;;;;;;;;;;;AA0BA;;;;iBITgB,aAAA,GAAA,CAAiB,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,GAAA,cAAiB,CAAA,GAAI,MAAA,UAAgB,CAAA;;;;;;;;AJjBhG;;;;;;;;;;;AA0BA;;;;iBKPsB,iBAAA,CACpB,OAAA,EAAS,OAAA,EACT,QAAA,EAAU,kBAAA,GACT,OAAA;;;;;;;cCHU,4BAAA;EAAA;;;;;;;;;;;;;;;;;;;KA4BD,iBAAA;ENnBQ;;;;EMwBlB,SAAA,QAAiB,MAAA;;;ALZnB;;EKkBE,iBAAA,QAAyB,OAAA;ELlBY;;AA0BvC;;EKFE,iBAAA,QAAyB,OAAA;ELGnB;;;;EKGN,0BAAA,QAAkC,SAAA;ELDV;;;;EKOxB,0BAAA,QAAkC,SAAA;ELPlC;;;;;EKcA,sBAAA,QAA8B,OAAA;AAAA;;;;cA2InB,wBAAA,EAA0B,iBAAA;;;;;iBAavB,gBAAA,CACd,QAAA,EAAU,iBAAA,EACV,YAAA,UACA,UAAA,sBACA,UAAA,GAAa,UAAA,GACZ,IAAA;;;;;iBA8Ba,gBAAA,CACd,QAAA,EAAU,iBAAA,EACV,SAAA,UACA,YAAA,UACA,UAAA,GAAa,UAAA,GACZ,IAAA;;;;iBA2Ba,cAAA,CAAe,IAAA,EAAM,IAAA;;;;iBAerB,YAAA,CAAa,IAAA,EAAM,IAAA,cAAkB,KAAA,EAAO,KAAA;ALvL5D;;;AAAA,iBKwMgB,mBAAA,CACd,QAAA,EAAU,iBAAA,EACV,YAAA,UACA,UAAA,sBACA,OAAA,WACA,UAAA;;;;iBAsBc,mBAAA,CACd,QAAA,EAAU,iBAAA,EACV,SAAA,UACA,YAAA,UACA,OAAA,WACA,UAAA;;;;;;;;;iBAyBc,kBAAA,CACd,QAAA,EAAU,iBAAA,EACV,MAAA;;;;;;iBAkBc,8BAAA,CAAA"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { ResultAsync, err, ok } from "neverthrow";
+import { Result, ResultAsync, err, errAsync, ok } from "neverthrow";
 import amqp from "amqp-connection-manager";
 import { extractQueue } from "@amqp-contract/contract";
 //#region \0rolldown/runtime.js
@@ -354,6 +354,15 @@ var AmqpClient = class {
 	/** Resolved timeout in ms; `null` means "wait forever". */
 	connectTimeoutMs;
 	/**
+	* Per-consumer prefetch setup functions registered via `addSetup` so they
+	* can be removed in {@link cancel} once the consumer is gone — otherwise
+	* the channel wrapper would replay the cancelled consumer's QoS on every
+	* reconnect and silently apply it to subsequent consumers.
+	*
+	* @internal
+	*/
+	prefetchSetups = /* @__PURE__ */ new Map();
+	/**
 	* Create a new AMQP client instance.
 	*
 	* The client will automatically:
@@ -447,16 +456,55 @@ var AmqpClient = class {
 	/**
 	* Start consuming messages from a queue.
 	*
+	* If `options.prefetch` is set, a per-consumer prefetch count is applied via
+	* `channel.prefetch(count, false)` registered as a setup function on the
+	* channel wrapper *before* the underlying `consume` call. Registering it via
+	* `addSetup` ensures the prefetch is reapplied automatically on channel
+	* reconnect; using `global=false` scopes it to subsequent consumers on the
+	* channel (RabbitMQ semantics — opposite of intuition: `false` is per-
+	* consumer, `true` is channel-wide).
+	*
+	* `prefetch` is stripped from the options handed to `channelWrapper.consume`
+	* because it is not a valid `amqplib` `Options.Consume` field — leaving it
+	* in would just travel as a no-op key-value pair on the consume frame.
+	*
 	* @returns ResultAsync resolving to the consumer tag.
 	*/
 	consume(queue, callback, options) {
-		return ResultAsync.fromPromise(this.channelWrapper.consume(queue, callback, options), (error) => new TechnicalError("Failed to start consuming messages", error)).map((reply) => reply.consumerTag);
+		const { prefetch, ...consumeOptions } = options ?? {};
+		if (prefetch !== void 0) {
+			if (!Number.isInteger(prefetch) || prefetch < 0 || prefetch > 65535) return errAsync(new TechnicalError(`Invalid prefetch: expected a non-negative integer ≤ 65535, got ${String(prefetch)}`));
+		}
+		const prefetchSetup = typeof prefetch === "number" ? async (channel) => {
+			await channel.prefetch(prefetch, false);
+		} : void 0;
+		const consumePromise = (async () => {
+			if (prefetchSetup) await this.channelWrapper.addSetup(prefetchSetup);
+			let reply;
+			try {
+				reply = await this.channelWrapper.consume(queue, callback, consumeOptions);
+			} catch (error) {
+				if (prefetchSetup) await this.channelWrapper.removeSetup(prefetchSetup).catch(() => {});
+				throw error;
+			}
+			if (prefetchSetup) this.prefetchSetups.set(reply.consumerTag, prefetchSetup);
+			return reply;
+		})();
+		return ResultAsync.fromPromise(consumePromise, (error) => new TechnicalError("Failed to start consuming messages", error)).map((reply) => reply.consumerTag);
 	}
 	/**
 	* Cancel a consumer by its consumer tag.
 	*/
 	cancel(consumerTag) {
-		return ResultAsync.fromPromise(this.channelWrapper.cancel(consumerTag), (error) => new TechnicalError("Failed to cancel consumer", error)).map(() => void 0);
+		return ResultAsync.fromPromise((async () => {
+			const setup = this.prefetchSetups.get(consumerTag);
+			this.prefetchSetups.delete(consumerTag);
+			try {
+				await this.channelWrapper.cancel(consumerTag);
+			} finally {
+				if (setup !== void 0) await this.channelWrapper.removeSetup(setup).catch(() => {});
+			}
+		})(), (error) => new TechnicalError("Failed to cancel consumer", error)).map(() => void 0);
 	}
 	/**
 	* Acknowledge a message.
@@ -531,6 +579,32 @@ var AmqpClient = class {
 	}
 };
 //#endregion
+//#region src/parsing.ts
+/**
+* Parse a `Buffer` as JSON, mapping any `JSON.parse` exception to the
+* caller-supplied error type.
+*
+* Use this in consume / reply paths where a parse failure is a typed value,
+* not a thrown exception — the caller decides how to translate the raw error
+* into a domain-level error (e.g. {@link TechnicalError}).
+*
+* @typeParam E - The error type produced by `errorFn`.
+* @param buffer - The raw message body to parse.
+* @param errorFn - Callback invoked with the underlying `JSON.parse` error.
+* @returns A `Result` containing the parsed `unknown` value or the mapped error.
+*
+* @example
+* ```typescript
+* const parsed = safeJsonParse(
+*   msg.content,
+*   (error) => new TechnicalError("Failed to parse JSON", error),
+* );
+* ```
+*/
+function safeJsonParse(buffer, errorFn) {
+	return Result.fromThrowable(() => JSON.parse(buffer.toString()), errorFn)();
+}
+//#endregion
 //#region src/telemetry.ts
 /**
 * SpanKind values from OpenTelemetry.
@@ -795,6 +869,6 @@ function _resetTelemetryCacheForTesting() {
 	cachedLateRpcReplyCounter = void 0;
 }
 //#endregion
-export { AmqpClient, DEFAULT_CONNECT_TIMEOUT_MS, MessageValidationError, MessagingSemanticConventions, TechnicalError, _getConnectionCountForTesting, _resetConnectionsForTesting, _resetTelemetryCacheForTesting, defaultTelemetryProvider, endSpanError, endSpanSuccess, recordConsumeMetric, recordLateRpcReply, recordPublishMetric, setupAmqpTopology, startConsumeSpan, startPublishSpan };
+export { AmqpClient, DEFAULT_CONNECT_TIMEOUT_MS, MessageValidationError, MessagingSemanticConventions, TechnicalError, _getConnectionCountForTesting, _resetConnectionsForTesting, _resetTelemetryCacheForTesting, defaultTelemetryProvider, endSpanError, endSpanSuccess, recordConsumeMetric, recordLateRpcReply, recordPublishMetric, safeJsonParse, setupAmqpTopology, startConsumeSpan, startPublishSpan };
 
 //# sourceMappingURL=index.mjs.map