@linagora/rabbitmq-client 0.2.1 → 0.3.0

package/README.md

@@ -103,6 +103,15 @@ After unsubscribing, the queue will not be re-subscribed on reconnection.
 
 Incoming messages are JSON-parsed first. If that fails, the message goes straight to the DLQ (no point retrying garbage). Otherwise, your handler runs up to `maxRetries` times. Success means ack, final failure means nack to the DLQ.
 
+The handler also receives what the publisher and the broker attached to the delivery: `headers`, `timestamp`, `messageId` and `correlationId`. A handler that only needs the body can ignore it.
+
+```typescript
+await client.subscribe('events', 'order.placed', 'order-queue', async (message, { headers }) => {
+  // `x-death` is set by the broker on a message that went through a DLQ
+  const replayed = headers['x-death'] !== undefined
+})
+```
+
 ### Reconnection
 
 If the connection or channel drops, the client reconnects and re-subscribes to everything automatically. Multiple reconnection triggers (e.g. connection close + channel close firing at the same time) are collapsed into a single attempt.

package/dist/index.cjs

@@ -247,6 +247,7 @@ var RabbitMQClient = class {
     const maxAttempts = options?.maxAttempts ?? this.options.publishMaxAttempts;
     const baseDelay = this.options.connectionRetryDelay;
     const content = Buffer.from(JSON.stringify(message));
+    const timestamp = Math.floor(Date.now() / 1e3);
     while (attempts < maxAttempts) {
       try {
         if (!this.connected) {
@@ -261,6 +262,7 @@ var RabbitMQClient = class {
         }
         this.channel.publish(exchange, routingKey, content, {
           persistent: true,
+          timestamp,
           headers: options?.headers,
           correlationId: options?.correlationId,
           messageId: options?.messageId,
@@ -494,19 +496,21 @@ var RabbitMQClient = class {
         routingKey,
         rawContentPreview: rawPreview + (rawContent.length > 100 ? "..." : "")
       });
-      channel.nack(message, false, false);
-      this.callHook(this.hooks.onMessageDlq, { exchange, routingKey, duration: 0, reason: "invalid_json" });
+      if (this.settle(channel, message, "nack")) {
+        this.callHook(this.hooks.onMessageDlq, { exchange, routingKey, duration: 0, reason: "invalid_json" });
+      }
       return;
     }
     this.logger.debug("Message received, processing", { exchange, routingKey, payload: content });
+    const properties = {
+      headers: message.properties.headers ?? {},
+      timestamp: message.properties.timestamp,
+      messageId: message.properties.messageId,
+      correlationId: message.properties.correlationId
+    };
     while (attempts < this.options.maxRetries) {
       try {
-        await handler(content);
-        const duration2 = Date.now() - startTime;
-        this.logger.info("Message processed successfully", { exchange, routingKey, duration: duration2, attempts: attempts + 1 });
-        channel.ack(message);
-        this.callHook(this.hooks.onMessageProcessed, { exchange, routingKey, duration: duration2, attempts: attempts + 1 });
-        return;
+        await handler(content, properties);
       } catch (error) {
         attempts++;
         this.logger.error("Handler failed", {
@@ -520,12 +524,50 @@ var RabbitMQClient = class {
         if (attempts < this.options.maxRetries) {
           await this.sleep(this.options.retryDelay);
         }
+        continue;
+      }
+      const duration2 = Date.now() - startTime;
+      this.logger.info("Message processed successfully", { exchange, routingKey, duration: duration2, attempts: attempts + 1 });
+      if (this.settle(channel, message, "ack")) {
+        this.callHook(this.hooks.onMessageProcessed, { exchange, routingKey, duration: duration2, attempts: attempts + 1 });
       }
+      return;
     }
     const duration = Date.now() - startTime;
     this.logger.error("Message failed after max retries, sending to DLQ", { exchange, routingKey, maxRetries: this.options.maxRetries, duration });
-    channel.nack(message, false, false);
-    this.callHook(this.hooks.onMessageDlq, { exchange, routingKey, duration, reason: "max_retries_exhausted" });
+    if (this.settle(channel, message, "nack")) {
+      this.callHook(this.hooks.onMessageDlq, { exchange, routingKey, duration, reason: "max_retries_exhausted" });
+    }
+  }
+  /**
+   * Acks or nacks a delivery, reporting whether the broker accepted it.
+   *
+   * A settle failure is a transport error, never a handler failure: by this
+   * point the handler has already run, so it must not be retried just because
+   * the channel went away. The delivery stays unacked and the broker redelivers
+   * it once the channel closes.
+   */
+  settle(channel, message, action) {
+    if (channel !== this.channel) {
+      this.logger.warn("Skipping message from a superseded channel; it will be redelivered");
+      return false;
+    }
+    try {
+      if (action === "ack") {
+        channel.ack(message);
+      } else {
+        channel.nack(message, false, false);
+      }
+      return true;
+    } catch (error) {
+      this.logger.error("Failed to settle message; leaving it unacked for redelivery", {
+        error,
+        action,
+        exchange: message.fields.exchange,
+        routingKey: message.fields.routingKey
+      });
+      return false;
+    }
   }
   /**
    * Lightweight liveness probe: creates and immediately deletes a temporary

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/logger.ts","../src/semaphore.ts"],"sourcesContent":["export { RabbitMQClient } from './client.js'\nexport { defaultLogger, silentLogger } from './logger.js'\nexport type {\n  ILogger,\n  PublishOptions,\n  RabbitMQClientOptions,\n  RabbitMQHooks,\n  RabbitMQMessage,\n  RabbitMQMessageHandler,\n  RabbitMQSubscription,\n  SubscribeOptions,\n} from './types.js'\n","import amqp from 'amqplib'\nimport type {\n  ILogger,\n  PublishOptions,\n  RabbitMQClientOptions,\n  RabbitMQHooks,\n  RabbitMQMessage,\n  RabbitMQMessageHandler,\n  RabbitMQSubscription,\n  SubscribeOptions,\n} from './types.js'\nimport { defaultLogger } from './logger.js'\nimport { Semaphore } from './semaphore.js'\n\nconst DEFAULT_PREFETCH = 10\nconst MAX_PUBLISH_RETRY_DELAY_MS = 60_000\n\nconst DEFAULTS = {\n  maxRetries: 3,\n  retryDelay: 1000,\n  connectionRetryDelay: 5000,\n  initMaxAttempts: 5,\n  publishMaxAttempts: 5,\n  prefetch: DEFAULT_PREFETCH,\n  closeTimeout: 5000,\n} as const\n\n/**\n * Production-grade RabbitMQ client with confirm channels, automatic DLQ\n * infrastructure, reconnection with subscription restoration, and\n * exponential-backoff publishing.\n *\n * @example\n * ```ts\n * const client = new RabbitMQClient({ url: 'amqp://localhost' })\n * await client.init()\n * await client.publish('events', 'user.created', { userId: '123' })\n * await client.subscribe('events', 'user.created', 'user-service', handler)\n * ```\n */\nexport class RabbitMQClient {\n  private connection: amqp.ChannelModel | null = null\n  private channel: amqp.ConfirmChannel | null = null\n  private connected = false\n  private subscriptions: RabbitMQSubscription[] = []\n  private readonly options: Required<Omit<RabbitMQClientOptions, 'logger' | 'hooks'>>\n  private readonly logger: ILogger\n  private readonly hooks: RabbitMQHooks\n  private initializationPromise: Promise<void> | null = null\n  private reconnectionPromise: Promise<void> | null = null\n  private assertedExchanges = new Set<string>()\n  private consumerTags = new Map<string, string>()\n  // Per-queue concurrency limiter, keyed by queue name. Persisted across\n  // reconnects (unlike consumerTags) so handlers still running when a\n  // connection drops keep holding their permits, and the new consumer cannot\n  // exceed the ceiling while the old pipeline drains. `null` = no limit.\n  private subscriptionSemaphores = new Map<string, Semaphore | null>()\n  private inflightCount = 0\n  private drainResolve: (() => void) | null = null\n\n  constructor(options: RabbitMQClientOptions) {\n    this.options = {\n      url: options.url,\n      maxRetries: options.maxRetries ?? DEFAULTS.maxRetries,\n      retryDelay: options.retryDelay ?? DEFAULTS.retryDelay,\n      connectionRetryDelay: options.connectionRetryDelay ?? DEFAULTS.connectionRetryDelay,\n      initMaxAttempts: options.initMaxAttempts ?? DEFAULTS.initMaxAttempts,\n      publishMaxAttempts: options.publishMaxAttempts ?? DEFAULTS.publishMaxAttempts,\n      prefetch: options.prefetch ?? DEFAULTS.prefetch,\n      // Default concurrency tracks prefetch, preserving the previous behaviour\n      // (handlers ran fire-and-forget, so up to `prefetch` ran at once) while\n      // making the ceiling explicit and independently tunable. A value <= 0\n      // (including an unlimited `prefetch: 0`) means \"no concurrency limit\".\n      concurrency: options.concurrency ?? options.prefetch ?? DEFAULTS.prefetch,\n      closeTimeout: options.closeTimeout ?? DEFAULTS.closeTimeout,\n    }\n    this.logger = options.logger ?? defaultLogger\n    this.hooks = options.hooks ?? {}\n  }\n\n  /**\n   * Opens a connection and creates a confirm channel. Retries up to\n   * `initMaxAttempts` times, then throws. Idempotent and safe to call\n   * concurrently — duplicate calls share the same in-flight promise.\n   */\n  async init(): Promise<void> {\n    if (this.connection && this.connected) {\n      return\n    }\n    if (this.initializationPromise) {\n      return this.initializationPromise\n    }\n    // Attach a no-op catch to prevent Node from briefly treating this as an\n    // unhandled rejection before the await below registers its own handler.\n    this.initializationPromise = this.doConnect(this.options.initMaxAttempts)\n    this.initializationPromise.catch(() => undefined)\n    try {\n      await this.initializationPromise\n    } finally {\n      this.initializationPromise = null\n    }\n  }\n\n  private async doConnect(maxAttempts?: number): Promise<void> {\n    this.assertedExchanges.clear()\n    this.consumerTags.clear()\n    let attempts = 0\n    while (!this.connected) {\n      try {\n        this.connection = await amqp.connect(this.options.url)\n        this.logger.info('Connected to server')\n        this.channel = await this.connection.createConfirmChannel()\n        this.logger.info('Confirm channel created')\n        await this.channel.prefetch(this.options.prefetch)\n        this.logger.info('Channel prefetch set', { prefetch: this.options.prefetch })\n\n        this.connection.on('error', (error: Error) => {\n          this.connected = false\n          this.logger.error('Connection error', { error })\n        })\n        this.connection.on('close', () => {\n          this.connected = false\n          this.logger.warn('Connection closed')\n          this.reconnectWithRetry()\n        })\n        this.channel.on('error', (error: Error) => {\n          this.logger.error('Channel error', { error })\n          this.handleChannelFailure()\n        })\n        this.channel.on('close', () => {\n          this.logger.warn('Channel closed')\n          this.handleChannelFailure()\n        })\n\n        this.connected = true\n        this.logger.info('Client initialized successfully')\n      } catch (error) {\n        attempts++\n        this.connected = false\n        if (maxAttempts !== undefined && attempts >= maxAttempts) {\n          this.logger.error('Connection failed after maximum attempts', { error, attempts, maxAttempts })\n          throw new Error(\n            `Failed to connect to RabbitMQ after ${attempts} attempts. ` +\n              'Check RABBITMQ_URL configuration and RabbitMQ server availability.',\n          )\n        }\n        this.logger.warn('Connection attempt failed, retrying...', {\n          error,\n          attempt: attempts,\n          maxAttempts: maxAttempts ?? 'unlimited',\n          retryDelayMs: this.options.connectionRetryDelay,\n        })\n        await this.sleep(this.options.connectionRetryDelay)\n      }\n    }\n  }\n\n  private handleChannelFailure(): void {\n    if (this.connected) {\n      this.connected = false\n      this.reconnectWithRetry()\n    }\n  }\n\n  /**\n   * Returns whether the client currently has an active connection and channel.\n   */\n  isConnected(): boolean {\n    return this.connected\n  }\n\n  /**\n   * Publishes a JSON message to a topic exchange with publisher confirms.\n   * Retries with exponential backoff (capped at 60 s), forcing a reconnect\n   * on each failure. Throws after `publishMaxAttempts` exhausted.\n   */\n  async publish(\n    exchange: string,\n    routingKey: string,\n    message: RabbitMQMessage,\n    options?: PublishOptions,\n  ): Promise<void> {\n    let attempts = 0\n    const maxAttempts = options?.maxAttempts ?? this.options.publishMaxAttempts\n    const baseDelay = this.options.connectionRetryDelay\n    const content = Buffer.from(JSON.stringify(message))\n\n    while (attempts < maxAttempts) {\n      try {\n        if (!this.connected) {\n          await this.reconnectWithRetry()\n        }\n\n        if (!this.channel) {\n          throw new Error('Channel not available')\n        }\n\n        if (!this.assertedExchanges.has(exchange)) {\n          await this.channel.assertExchange(exchange, 'topic', { durable: true })\n          this.assertedExchanges.add(exchange)\n        }\n\n        this.channel.publish(exchange, routingKey, content, {\n          persistent: true,\n          headers: options?.headers,\n          correlationId: options?.correlationId,\n          messageId: options?.messageId,\n          expiration: options?.expiration,\n        })\n\n        await this.channel.waitForConfirms()\n\n        if (attempts > 0) {\n          this.logger.info('Published message after retries', { exchange, routingKey, messageSize: content.length, attempts })\n        } else {\n          this.logger.info('Published message', { exchange, routingKey, messageSize: content.length })\n        }\n        this.logger.debug('Published message payload', { exchange, routingKey, payload: message })\n\n        this.callHook(this.hooks.onPublish, { exchange, routingKey, attempts: attempts + 1 })\n\n        return\n      } catch (error) {\n        attempts++\n        this.connected = false\n\n        if (attempts >= maxAttempts) {\n          this.logger.error('Publish failed after max attempts', { error, exchange, routingKey, attempts, maxAttempts })\n          throw new Error(\n            `Failed to publish to ${exchange}/${routingKey} after ${attempts} attempts: ${error instanceof Error ? error.message : String(error)}`,\n          )\n        }\n\n        const retryDelay = Math.min(\n          baseDelay * Math.pow(2, attempts - 1),\n          MAX_PUBLISH_RETRY_DELAY_MS,\n        )\n\n        this.logger.warn('Publish attempt failed, retrying', { error, exchange, routingKey, attempt: attempts, maxAttempts, retryDelayMs: retryDelay })\n\n        await this.sleep(retryDelay)\n      }\n    }\n  }\n\n  /**\n   * Gracefully shuts down the client. Waits up to `closeTimeout` ms for\n   * in-flight message handlers to finish before closing the channel and\n   * connection. Pass `false` to preserve subscriptions for a later\n   * `init()` / reconnect cycle.\n   */\n  async close(clearSubscriptions = true): Promise<void> {\n    try {\n      if (this.inflightCount > 0) {\n        this.logger.info('Waiting for in-flight messages to drain', { inflightCount: this.inflightCount })\n        await this.waitForDrain(this.options.closeTimeout)\n      }\n      await this.channel?.close()\n      await this.connection?.close()\n      this.connection = null\n      this.channel = null\n      this.connected = false\n      this.initializationPromise = null\n      this.reconnectionPromise = null\n      this.assertedExchanges.clear()\n      this.consumerTags.clear()\n      if (clearSubscriptions) {\n        this.subscriptions = []\n        this.subscriptionSemaphores.clear()\n      }\n      this.logger.info('Connection closed')\n    } catch (error) {\n      this.logger.error('Error closing connection', { error })\n      throw error\n    }\n  }\n\n  private async reconnectWithRetry(): Promise<void> {\n    if (this.reconnectionPromise) {\n      return this.reconnectionPromise\n    }\n    this.connected = false\n    this.logger.info('Starting reconnection...')\n    this.reconnectionPromise = this.doReconnect()\n    this.reconnectionPromise.catch(() => undefined)\n    try {\n      await this.reconnectionPromise\n    } finally {\n      this.reconnectionPromise = null\n    }\n  }\n\n  private async doReconnect(): Promise<void> {\n    await this.doConnect()\n    await this.resubscribeAll()\n  }\n\n  private async resubscribeAll(): Promise<void> {\n    if (this.subscriptions.length === 0) {\n      return\n    }\n    this.logger.info('Re-establishing subscriptions', { count: this.subscriptions.length })\n    const subs = [...this.subscriptions]\n    const results = await Promise.allSettled(\n      subs.map(async (sub) => {\n        await this.setupSubscription(sub)\n        return sub.queue\n      }),\n    )\n    const succeeded: string[] = []\n    const failed: string[] = []\n    results.forEach((result, index) => {\n      if (result.status === 'fulfilled') {\n        succeeded.push(result.value)\n      } else {\n        const queue = subs[index].queue\n        failed.push(queue)\n        this.logger.error('Failed to re-subscribe to queue', { error: result.reason, queue })\n      }\n    })\n    if (succeeded.length > 0) {\n      this.logger.info('Successfully re-subscribed to queues', { count: succeeded.length, queues: succeeded })\n    }\n    if (failed.length > 0) {\n      this.logger.warn('Some subscriptions failed to restore', { count: failed.length, queues: failed })\n    }\n    this.callHook(this.hooks.onReconnect, { subscriptionsRestored: succeeded.length, subscriptionsFailed: failed.length })\n  }\n\n  /**\n   * Subscribes to a queue with automatic DLQ infrastructure setup.\n   *\n   * Pass `options.queueArguments` to override the default quorum-queue\n   * arguments (merged with the DLQ wiring defaults).\n   */\n  async subscribe(\n    exchange: string,\n    routingKey: string,\n    queue: string,\n    handler: RabbitMQMessageHandler,\n    options?: SubscribeOptions,\n  ): Promise<void> {\n    if (!this.connected || !this.channel) {\n      throw new Error('RabbitMQ client not connected. Call init() first.')\n    }\n    const sub: RabbitMQSubscription = { exchange, routingKey, queue, handler, options }\n    const existingIndex = this.subscriptions.findIndex((s) => s.queue === queue)\n    if (existingIndex === -1) {\n      this.subscriptions.push(sub)\n    } else {\n      this.subscriptions[existingIndex] = sub\n      // Re-subscribing may change concurrency; drop the old limiter so\n      // setupSubscription rebuilds it from the new options. (A reconnect goes\n      // through setupSubscription directly and keeps the existing limiter.)\n      this.subscriptionSemaphores.delete(queue)\n    }\n    await this.setupSubscription(sub)\n  }\n\n  /**\n   * Cancels a queue subscription and removes it from the restoration list.\n   */\n  async unsubscribe(queue: string): Promise<void> {\n    const tag = this.consumerTags.get(queue)\n    if (tag && this.channel) {\n      await this.channel.cancel(tag)\n    }\n    this.consumerTags.delete(queue)\n    this.subscriptionSemaphores.delete(queue)\n    this.subscriptions = this.subscriptions.filter((s) => s.queue !== queue)\n    this.logger.info('Unsubscribed from queue', { queue })\n  }\n\n  private async setupSubscription(sub: RabbitMQSubscription): Promise<void> {\n    if (!this.channel) {\n      throw new Error('Channel not available')\n    }\n    // Bind this consumer to the exact channel that will deliver its messages,\n    // so ack/nack always target that channel even after a reconnect swaps\n    // `this.channel`.\n    const channel = this.channel\n    const { exchange, routingKey, queue, handler, options } = sub\n    const dlxExchange = `${exchange}.dlx`\n    const dlqQueue = `${queue}.dlq`\n    const dlqRoutingKey = `${routingKey}.dead`\n\n    await channel.assertExchange(dlxExchange, 'topic', { durable: true })\n    await channel.assertQueue(dlqQueue, { durable: true })\n    await channel.bindQueue(dlqQueue, dlxExchange, dlqRoutingKey)\n\n    if (!this.assertedExchanges.has(exchange)) {\n      await channel.assertExchange(exchange, 'topic', { durable: true })\n      this.assertedExchanges.add(exchange)\n    }\n\n    const queueType = options?.queueArguments?.['x-queue-type'] ?? 'quorum'\n    const queueArgs: Record<string, unknown> = {\n      'x-queue-type': queueType,\n      'x-overflow': 'reject-publish',\n    }\n    // at-least-once DLQ strategy is only supported by quorum queues\n    if (queueType === 'quorum') {\n      queueArgs['x-dead-letter-strategy'] = 'at-least-once'\n    }\n\n    await channel.assertQueue(queue, {\n      durable: true,\n      deadLetterExchange: dlxExchange,\n      deadLetterRoutingKey: dlqRoutingKey,\n      arguments: { ...queueArgs, ...options?.queueArguments },\n    })\n\n    await channel.bindQueue(queue, exchange, routingKey)\n    // Reuse the queue's existing limiter across reconnects; only build a new\n    // one the first time (or after subscribe()/unsubscribe() cleared it).\n    // A concurrency <= 0 means \"no limit\" (null), matching an unlimited prefetch.\n    if (!this.subscriptionSemaphores.has(queue)) {\n      const concurrency = options?.concurrency ?? this.options.concurrency\n      this.subscriptionSemaphores.set(queue, concurrency > 0 ? new Semaphore(concurrency) : null)\n    }\n    const semaphore = this.subscriptionSemaphores.get(queue) ?? null\n    const { consumerTag } = await channel.consume(\n      queue,\n      (message) => {\n        if (message) {\n          this.dispatch(message, handler, semaphore, channel)\n        }\n      },\n      { noAck: false },\n    )\n    this.consumerTags.set(queue, consumerTag)\n    this.logger.info('Subscribed to queue', { exchange, routingKey, queue })\n  }\n\n  /**\n   * Gates a delivered message on the subscription's concurrency semaphore, then\n   * processes it. A message counts as in-flight from delivery until its handler\n   * settles (including time spent waiting for a permit), so graceful `close()`\n   * drains queued messages as well as actively-processing ones.\n   */\n  private dispatch(\n    message: amqp.ConsumeMessage,\n    handler: RabbitMQMessageHandler,\n    semaphore: Semaphore | null,\n    channel: amqp.ConfirmChannel,\n  ): void {\n    this.inflightCount++\n    const acquire = semaphore ? semaphore.acquire() : Promise.resolve()\n    acquire\n      .then(() => this.handleWithRetry(message, handler, channel))\n      .catch((error) => {\n        this.logger.error('Unhandled error in message handler', { error })\n      })\n      .finally(() => {\n        semaphore?.release()\n        this.inflightCount--\n        if (this.inflightCount === 0 && this.drainResolve) {\n          this.drainResolve()\n        }\n      })\n  }\n\n  private async handleWithRetry(\n    message: amqp.ConsumeMessage,\n    handler: RabbitMQMessageHandler,\n    channel: amqp.ConfirmChannel,\n  ): Promise<void> {\n    // `channel` is the one that delivered this message. If a reconnect has\n    // since replaced it, this message was never acked and the broker will\n    // redeliver it on the new channel, so drop this stale attempt rather than\n    // run the handler again or ack a tag the new channel does not know.\n    if (channel !== this.channel) {\n      this.logger.warn('Skipping message from a superseded channel; it will be redelivered')\n      return\n    }\n    const startTime = Date.now()\n    let attempts = 0\n    const routingKey = message.fields.routingKey\n    const exchange = message.fields.exchange\n\n    let content: RabbitMQMessage\n    try {\n      content = JSON.parse(message.content.toString())\n    } catch (parseError) {\n      const rawContent = message.content.toString()\n      const rawPreview = rawContent.substring(0, 100)\n      this.logger.error('Failed to parse message JSON, sending to DLQ', {\n        error: parseError,\n        exchange,\n        routingKey,\n        rawContentPreview: rawPreview + (rawContent.length > 100 ? '...' : ''),\n      })\n      channel.nack(message, false, false)\n      this.callHook(this.hooks.onMessageDlq, { exchange, routingKey, duration: 0, reason: 'invalid_json' })\n      return\n    }\n\n    this.logger.debug('Message received, processing', { exchange, routingKey, payload: content })\n\n    while (attempts < this.options.maxRetries) {\n      try {\n        await handler(content)\n        const duration = Date.now() - startTime\n        this.logger.info('Message processed successfully', { exchange, routingKey, duration, attempts: attempts + 1 })\n        channel.ack(message)\n        this.callHook(this.hooks.onMessageProcessed, { exchange, routingKey, duration, attempts: attempts + 1 })\n        return\n      } catch (error) {\n        attempts++\n        this.logger.error('Handler failed', {\n          error: error instanceof Error ? error.message : error,\n          stack: error instanceof Error ? error.stack : undefined,\n          exchange,\n          routingKey,\n          attempt: attempts,\n          maxRetries: this.options.maxRetries,\n        })\n        if (attempts < this.options.maxRetries) {\n          await this.sleep(this.options.retryDelay)\n        }\n      }\n    }\n\n    const duration = Date.now() - startTime\n    this.logger.error('Message failed after max retries, sending to DLQ', { exchange, routingKey, maxRetries: this.options.maxRetries, duration })\n    channel.nack(message, false, false)\n    this.callHook(this.hooks.onMessageDlq, { exchange, routingKey, duration, reason: 'max_retries_exhausted' })\n  }\n\n  /**\n   * Lightweight liveness probe: creates and immediately deletes a temporary\n   * exclusive queue. Returns `false` when disconnected or on broker error.\n   */\n  async checkHealth(): Promise<boolean> {\n    if (!this.connected || !this.channel) {\n      return false\n    }\n    try {\n      const { queue } = await this.channel.assertQueue('', {\n        exclusive: true,\n        autoDelete: true,\n      })\n      await this.channel.deleteQueue(queue)\n      return true\n    } catch (error) {\n      this.logger.warn('Health check failed', { error })\n      return false\n    }\n  }\n\n  private waitForDrain(timeout: number): Promise<void> {\n    if (this.inflightCount === 0) return Promise.resolve()\n    return new Promise<void>((resolve) => {\n      const timer = setTimeout(() => {\n        this.logger.warn('Close timeout reached with messages still in flight', { inflightCount: this.inflightCount })\n        this.drainResolve = null\n        resolve()\n      }, timeout)\n      this.drainResolve = () => {\n        clearTimeout(timer)\n        this.drainResolve = null\n        resolve()\n      }\n    })\n  }\n\n  /** Invokes a hook callback, swallowing errors so hooks never break message flow. */\n  private callHook<T>(hook: ((info: T) => void) | undefined, info: T): void {\n    try { hook?.(info) } catch (error) { this.logger.debug('Observability hook error', { error }) }\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms))\n  }\n}\n","import type { ILogger } from './types.js'\n\n/**\n * Default logger used when the consumer does not inject one.\n *\n * Forwards `warn` and `error` to the console so connection drops, channel\n * errors, and failed handlers stay visible out of the box, while staying\n * silent for `info`/`debug` so routine operation never pollutes the\n * consumer's output. Pass `silentLogger` for zero output, or any `ILogger`\n * (console, Winston, pino, Bunyan) to take full control.\n */\nexport const defaultLogger: ILogger = {\n  debug: () => {},\n  info: () => {},\n  warn: (message, ...args) => console.warn('[rabbitmq-client]', message, ...args),\n  error: (message, ...args) => console.error('[rabbitmq-client]', message, ...args),\n}\n\n/**\n * No-op logger that discards every message. Use this to silence the client\n * entirely, including the `warn`/`error` output the default logger emits.\n */\nexport const silentLogger: ILogger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n}\n","/**\n * Minimal FIFO counting semaphore used to cap how many message handlers run\n * concurrently, independently of channel prefetch.\n *\n * Prefetch bounds how many messages the broker delivers into consumer memory;\n * the semaphore bounds how many of those are actively being processed at once.\n * Keeping the two separate lets a consumer buffer a large prefetch window while\n * still protecting a slow downstream (a database, an HTTP API) from a burst.\n */\nexport class Semaphore {\n  private permits: number\n  private readonly waiters: Array<() => void> = []\n\n  constructor(permits: number) {\n    if (!Number.isInteger(permits) || permits < 1) {\n      throw new Error(`Semaphore requires a positive integer of permits, got ${permits}`)\n    }\n    this.permits = permits\n  }\n\n  /**\n   * Acquires a permit, resolving immediately when one is free or queueing\n   * (FIFO) until another holder releases. Always pair with `release()` in a\n   * `finally` so a throwing handler never leaks a permit.\n   */\n  acquire(): Promise<void> {\n    if (this.permits > 0) {\n      this.permits--\n      return Promise.resolve()\n    }\n    return new Promise<void>((resolve) => {\n      this.waiters.push(resolve)\n    })\n  }\n\n  /**\n   * Releases a permit. Hands it directly to the next waiter if any are queued,\n   * otherwise returns it to the pool.\n   */\n  release(): void {\n    const next = this.waiters.shift()\n    if (next) {\n      next()\n    } else {\n      this.permits++\n    }\n  }\n\n  /** Permits currently available. Exposed for tests and introspection. */\n  get available(): number {\n    return this.permits\n  }\n\n  /** Number of callers currently queued waiting for a permit. */\n  get waiting(): number {\n    return this.waiters.length\n  }\n}\n"],"mappings":"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","names":["amqp","duration"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/logger.ts","../src/semaphore.ts"],"sourcesContent":["export { RabbitMQClient } from './client.js'\nexport { defaultLogger, silentLogger } from './logger.js'\nexport type {\n  ILogger,\n  PublishOptions,\n  RabbitMQClientOptions,\n  RabbitMQHooks,\n  RabbitMQMessage,\n  RabbitMQMessageHandler,\n  RabbitMQMessageProperties,\n  RabbitMQSubscription,\n  SubscribeOptions,\n} from './types.js'\n","import amqp from 'amqplib'\nimport type {\n  ILogger,\n  PublishOptions,\n  RabbitMQClientOptions,\n  RabbitMQHooks,\n  RabbitMQMessage,\n  RabbitMQMessageHandler,\n  RabbitMQMessageProperties,\n  RabbitMQSubscription,\n  SubscribeOptions,\n} from './types.js'\nimport { defaultLogger } from './logger.js'\nimport { Semaphore } from './semaphore.js'\n\nconst DEFAULT_PREFETCH = 10\nconst MAX_PUBLISH_RETRY_DELAY_MS = 60_000\n\nconst DEFAULTS = {\n  maxRetries: 3,\n  retryDelay: 1000,\n  connectionRetryDelay: 5000,\n  initMaxAttempts: 5,\n  publishMaxAttempts: 5,\n  prefetch: DEFAULT_PREFETCH,\n  closeTimeout: 5000,\n} as const\n\n/**\n * Production-grade RabbitMQ client with confirm channels, automatic DLQ\n * infrastructure, reconnection with subscription restoration, and\n * exponential-backoff publishing.\n *\n * @example\n * ```ts\n * const client = new RabbitMQClient({ url: 'amqp://localhost' })\n * await client.init()\n * await client.publish('events', 'user.created', { userId: '123' })\n * await client.subscribe('events', 'user.created', 'user-service', handler)\n * ```\n */\nexport class RabbitMQClient {\n  private connection: amqp.ChannelModel | null = null\n  private channel: amqp.ConfirmChannel | null = null\n  private connected = false\n  private subscriptions: RabbitMQSubscription[] = []\n  private readonly options: Required<Omit<RabbitMQClientOptions, 'logger' | 'hooks'>>\n  private readonly logger: ILogger\n  private readonly hooks: RabbitMQHooks\n  private initializationPromise: Promise<void> | null = null\n  private reconnectionPromise: Promise<void> | null = null\n  private assertedExchanges = new Set<string>()\n  private consumerTags = new Map<string, string>()\n  // Per-queue concurrency limiter, keyed by queue name. Persisted across\n  // reconnects (unlike consumerTags) so handlers still running when a\n  // connection drops keep holding their permits, and the new consumer cannot\n  // exceed the ceiling while the old pipeline drains. `null` = no limit.\n  private subscriptionSemaphores = new Map<string, Semaphore | null>()\n  private inflightCount = 0\n  private drainResolve: (() => void) | null = null\n\n  constructor(options: RabbitMQClientOptions) {\n    this.options = {\n      url: options.url,\n      maxRetries: options.maxRetries ?? DEFAULTS.maxRetries,\n      retryDelay: options.retryDelay ?? DEFAULTS.retryDelay,\n      connectionRetryDelay: options.connectionRetryDelay ?? DEFAULTS.connectionRetryDelay,\n      initMaxAttempts: options.initMaxAttempts ?? DEFAULTS.initMaxAttempts,\n      publishMaxAttempts: options.publishMaxAttempts ?? DEFAULTS.publishMaxAttempts,\n      prefetch: options.prefetch ?? DEFAULTS.prefetch,\n      // Default concurrency tracks prefetch, preserving the previous behaviour\n      // (handlers ran fire-and-forget, so up to `prefetch` ran at once) while\n      // making the ceiling explicit and independently tunable. A value <= 0\n      // (including an unlimited `prefetch: 0`) means \"no concurrency limit\".\n      concurrency: options.concurrency ?? options.prefetch ?? DEFAULTS.prefetch,\n      closeTimeout: options.closeTimeout ?? DEFAULTS.closeTimeout,\n    }\n    this.logger = options.logger ?? defaultLogger\n    this.hooks = options.hooks ?? {}\n  }\n\n  /**\n   * Opens a connection and creates a confirm channel. Retries up to\n   * `initMaxAttempts` times, then throws. Idempotent and safe to call\n   * concurrently — duplicate calls share the same in-flight promise.\n   */\n  async init(): Promise<void> {\n    if (this.connection && this.connected) {\n      return\n    }\n    if (this.initializationPromise) {\n      return this.initializationPromise\n    }\n    // Attach a no-op catch to prevent Node from briefly treating this as an\n    // unhandled rejection before the await below registers its own handler.\n    this.initializationPromise = this.doConnect(this.options.initMaxAttempts)\n    this.initializationPromise.catch(() => undefined)\n    try {\n      await this.initializationPromise\n    } finally {\n      this.initializationPromise = null\n    }\n  }\n\n  private async doConnect(maxAttempts?: number): Promise<void> {\n    this.assertedExchanges.clear()\n    this.consumerTags.clear()\n    let attempts = 0\n    while (!this.connected) {\n      try {\n        this.connection = await amqp.connect(this.options.url)\n        this.logger.info('Connected to server')\n        this.channel = await this.connection.createConfirmChannel()\n        this.logger.info('Confirm channel created')\n        await this.channel.prefetch(this.options.prefetch)\n        this.logger.info('Channel prefetch set', { prefetch: this.options.prefetch })\n\n        this.connection.on('error', (error: Error) => {\n          this.connected = false\n          this.logger.error('Connection error', { error })\n        })\n        this.connection.on('close', () => {\n          this.connected = false\n          this.logger.warn('Connection closed')\n          this.reconnectWithRetry()\n        })\n        this.channel.on('error', (error: Error) => {\n          this.logger.error('Channel error', { error })\n          this.handleChannelFailure()\n        })\n        this.channel.on('close', () => {\n          this.logger.warn('Channel closed')\n          this.handleChannelFailure()\n        })\n\n        this.connected = true\n        this.logger.info('Client initialized successfully')\n      } catch (error) {\n        attempts++\n        this.connected = false\n        if (maxAttempts !== undefined && attempts >= maxAttempts) {\n          this.logger.error('Connection failed after maximum attempts', { error, attempts, maxAttempts })\n          throw new Error(\n            `Failed to connect to RabbitMQ after ${attempts} attempts. ` +\n              'Check RABBITMQ_URL configuration and RabbitMQ server availability.',\n          )\n        }\n        this.logger.warn('Connection attempt failed, retrying...', {\n          error,\n          attempt: attempts,\n          maxAttempts: maxAttempts ?? 'unlimited',\n          retryDelayMs: this.options.connectionRetryDelay,\n        })\n        await this.sleep(this.options.connectionRetryDelay)\n      }\n    }\n  }\n\n  private handleChannelFailure(): void {\n    if (this.connected) {\n      this.connected = false\n      this.reconnectWithRetry()\n    }\n  }\n\n  /**\n   * Returns whether the client currently has an active connection and channel.\n   */\n  isConnected(): boolean {\n    return this.connected\n  }\n\n  /**\n   * Publishes a JSON message to a topic exchange with publisher confirms.\n   * Retries with exponential backoff (capped at 60 s), forcing a reconnect\n   * on each failure. Throws after `publishMaxAttempts` exhausted.\n   */\n  async publish(\n    exchange: string,\n    routingKey: string,\n    message: RabbitMQMessage,\n    options?: PublishOptions,\n  ): Promise<void> {\n    let attempts = 0\n    const maxAttempts = options?.maxAttempts ?? this.options.publishMaxAttempts\n    const baseDelay = this.options.connectionRetryDelay\n    const content = Buffer.from(JSON.stringify(message))\n    // Taken once, not per attempt: a retried publish must not look newer than\n    // a message published after it succeeded.\n    const timestamp = Math.floor(Date.now() / 1000)\n\n    while (attempts < maxAttempts) {\n      try {\n        if (!this.connected) {\n          await this.reconnectWithRetry()\n        }\n\n        if (!this.channel) {\n          throw new Error('Channel not available')\n        }\n\n        if (!this.assertedExchanges.has(exchange)) {\n          await this.channel.assertExchange(exchange, 'topic', { durable: true })\n          this.assertedExchanges.add(exchange)\n        }\n\n        this.channel.publish(exchange, routingKey, content, {\n          persistent: true,\n          timestamp,\n          headers: options?.headers,\n          correlationId: options?.correlationId,\n          messageId: options?.messageId,\n          expiration: options?.expiration,\n        })\n\n        await this.channel.waitForConfirms()\n\n        if (attempts > 0) {\n          this.logger.info('Published message after retries', { exchange, routingKey, messageSize: content.length, attempts })\n        } else {\n          this.logger.info('Published message', { exchange, routingKey, messageSize: content.length })\n        }\n        this.logger.debug('Published message payload', { exchange, routingKey, payload: message })\n\n        this.callHook(this.hooks.onPublish, { exchange, routingKey, attempts: attempts + 1 })\n\n        return\n      } catch (error) {\n        attempts++\n        this.connected = false\n\n        if (attempts >= maxAttempts) {\n          this.logger.error('Publish failed after max attempts', { error, exchange, routingKey, attempts, maxAttempts })\n          throw new Error(\n            `Failed to publish to ${exchange}/${routingKey} after ${attempts} attempts: ${error instanceof Error ? error.message : String(error)}`,\n          )\n        }\n\n        const retryDelay = Math.min(\n          baseDelay * Math.pow(2, attempts - 1),\n          MAX_PUBLISH_RETRY_DELAY_MS,\n        )\n\n        this.logger.warn('Publish attempt failed, retrying', { error, exchange, routingKey, attempt: attempts, maxAttempts, retryDelayMs: retryDelay })\n\n        await this.sleep(retryDelay)\n      }\n    }\n  }\n\n  /**\n   * Gracefully shuts down the client. Waits up to `closeTimeout` ms for\n   * in-flight message handlers to finish before closing the channel and\n   * connection. Pass `false` to preserve subscriptions for a later\n   * `init()` / reconnect cycle.\n   */\n  async close(clearSubscriptions = true): Promise<void> {\n    try {\n      if (this.inflightCount > 0) {\n        this.logger.info('Waiting for in-flight messages to drain', { inflightCount: this.inflightCount })\n        await this.waitForDrain(this.options.closeTimeout)\n      }\n      await this.channel?.close()\n      await this.connection?.close()\n      this.connection = null\n      this.channel = null\n      this.connected = false\n      this.initializationPromise = null\n      this.reconnectionPromise = null\n      this.assertedExchanges.clear()\n      this.consumerTags.clear()\n      if (clearSubscriptions) {\n        this.subscriptions = []\n        this.subscriptionSemaphores.clear()\n      }\n      this.logger.info('Connection closed')\n    } catch (error) {\n      this.logger.error('Error closing connection', { error })\n      throw error\n    }\n  }\n\n  private async reconnectWithRetry(): Promise<void> {\n    if (this.reconnectionPromise) {\n      return this.reconnectionPromise\n    }\n    this.connected = false\n    this.logger.info('Starting reconnection...')\n    this.reconnectionPromise = this.doReconnect()\n    this.reconnectionPromise.catch(() => undefined)\n    try {\n      await this.reconnectionPromise\n    } finally {\n      this.reconnectionPromise = null\n    }\n  }\n\n  private async doReconnect(): Promise<void> {\n    await this.doConnect()\n    await this.resubscribeAll()\n  }\n\n  private async resubscribeAll(): Promise<void> {\n    if (this.subscriptions.length === 0) {\n      return\n    }\n    this.logger.info('Re-establishing subscriptions', { count: this.subscriptions.length })\n    const subs = [...this.subscriptions]\n    const results = await Promise.allSettled(\n      subs.map(async (sub) => {\n        await this.setupSubscription(sub)\n        return sub.queue\n      }),\n    )\n    const succeeded: string[] = []\n    const failed: string[] = []\n    results.forEach((result, index) => {\n      if (result.status === 'fulfilled') {\n        succeeded.push(result.value)\n      } else {\n        const queue = subs[index].queue\n        failed.push(queue)\n        this.logger.error('Failed to re-subscribe to queue', { error: result.reason, queue })\n      }\n    })\n    if (succeeded.length > 0) {\n      this.logger.info('Successfully re-subscribed to queues', { count: succeeded.length, queues: succeeded })\n    }\n    if (failed.length > 0) {\n      this.logger.warn('Some subscriptions failed to restore', { count: failed.length, queues: failed })\n    }\n    this.callHook(this.hooks.onReconnect, { subscriptionsRestored: succeeded.length, subscriptionsFailed: failed.length })\n  }\n\n  /**\n   * Subscribes to a queue with automatic DLQ infrastructure setup.\n   *\n   * Pass `options.queueArguments` to override the default quorum-queue\n   * arguments (merged with the DLQ wiring defaults).\n   */\n  async subscribe(\n    exchange: string,\n    routingKey: string,\n    queue: string,\n    handler: RabbitMQMessageHandler,\n    options?: SubscribeOptions,\n  ): Promise<void> {\n    if (!this.connected || !this.channel) {\n      throw new Error('RabbitMQ client not connected. Call init() first.')\n    }\n    const sub: RabbitMQSubscription = { exchange, routingKey, queue, handler, options }\n    const existingIndex = this.subscriptions.findIndex((s) => s.queue === queue)\n    if (existingIndex === -1) {\n      this.subscriptions.push(sub)\n    } else {\n      this.subscriptions[existingIndex] = sub\n      // Re-subscribing may change concurrency; drop the old limiter so\n      // setupSubscription rebuilds it from the new options. (A reconnect goes\n      // through setupSubscription directly and keeps the existing limiter.)\n      this.subscriptionSemaphores.delete(queue)\n    }\n    await this.setupSubscription(sub)\n  }\n\n  /**\n   * Cancels a queue subscription and removes it from the restoration list.\n   */\n  async unsubscribe(queue: string): Promise<void> {\n    const tag = this.consumerTags.get(queue)\n    if (tag && this.channel) {\n      await this.channel.cancel(tag)\n    }\n    this.consumerTags.delete(queue)\n    this.subscriptionSemaphores.delete(queue)\n    this.subscriptions = this.subscriptions.filter((s) => s.queue !== queue)\n    this.logger.info('Unsubscribed from queue', { queue })\n  }\n\n  private async setupSubscription(sub: RabbitMQSubscription): Promise<void> {\n    if (!this.channel) {\n      throw new Error('Channel not available')\n    }\n    // Bind this consumer to the exact channel that will deliver its messages,\n    // so ack/nack always target that channel even after a reconnect swaps\n    // `this.channel`.\n    const channel = this.channel\n    const { exchange, routingKey, queue, handler, options } = sub\n    const dlxExchange = `${exchange}.dlx`\n    const dlqQueue = `${queue}.dlq`\n    const dlqRoutingKey = `${routingKey}.dead`\n\n    await channel.assertExchange(dlxExchange, 'topic', { durable: true })\n    await channel.assertQueue(dlqQueue, { durable: true })\n    await channel.bindQueue(dlqQueue, dlxExchange, dlqRoutingKey)\n\n    if (!this.assertedExchanges.has(exchange)) {\n      await channel.assertExchange(exchange, 'topic', { durable: true })\n      this.assertedExchanges.add(exchange)\n    }\n\n    const queueType = options?.queueArguments?.['x-queue-type'] ?? 'quorum'\n    const queueArgs: Record<string, unknown> = {\n      'x-queue-type': queueType,\n      'x-overflow': 'reject-publish',\n    }\n    // at-least-once DLQ strategy is only supported by quorum queues\n    if (queueType === 'quorum') {\n      queueArgs['x-dead-letter-strategy'] = 'at-least-once'\n    }\n\n    await channel.assertQueue(queue, {\n      durable: true,\n      deadLetterExchange: dlxExchange,\n      deadLetterRoutingKey: dlqRoutingKey,\n      arguments: { ...queueArgs, ...options?.queueArguments },\n    })\n\n    await channel.bindQueue(queue, exchange, routingKey)\n    // Reuse the queue's existing limiter across reconnects; only build a new\n    // one the first time (or after subscribe()/unsubscribe() cleared it).\n    // A concurrency <= 0 means \"no limit\" (null), matching an unlimited prefetch.\n    if (!this.subscriptionSemaphores.has(queue)) {\n      const concurrency = options?.concurrency ?? this.options.concurrency\n      this.subscriptionSemaphores.set(queue, concurrency > 0 ? new Semaphore(concurrency) : null)\n    }\n    const semaphore = this.subscriptionSemaphores.get(queue) ?? null\n    const { consumerTag } = await channel.consume(\n      queue,\n      (message) => {\n        if (message) {\n          this.dispatch(message, handler, semaphore, channel)\n        }\n      },\n      { noAck: false },\n    )\n    this.consumerTags.set(queue, consumerTag)\n    this.logger.info('Subscribed to queue', { exchange, routingKey, queue })\n  }\n\n  /**\n   * Gates a delivered message on the subscription's concurrency semaphore, then\n   * processes it. A message counts as in-flight from delivery until its handler\n   * settles (including time spent waiting for a permit), so graceful `close()`\n   * drains queued messages as well as actively-processing ones.\n   */\n  private dispatch(\n    message: amqp.ConsumeMessage,\n    handler: RabbitMQMessageHandler,\n    semaphore: Semaphore | null,\n    channel: amqp.ConfirmChannel,\n  ): void {\n    this.inflightCount++\n    const acquire = semaphore ? semaphore.acquire() : Promise.resolve()\n    acquire\n      .then(() => this.handleWithRetry(message, handler, channel))\n      .catch((error) => {\n        this.logger.error('Unhandled error in message handler', { error })\n      })\n      .finally(() => {\n        semaphore?.release()\n        this.inflightCount--\n        if (this.inflightCount === 0 && this.drainResolve) {\n          this.drainResolve()\n        }\n      })\n  }\n\n  private async handleWithRetry(\n    message: amqp.ConsumeMessage,\n    handler: RabbitMQMessageHandler,\n    channel: amqp.ConfirmChannel,\n  ): Promise<void> {\n    // `channel` is the one that delivered this message. If a reconnect has\n    // since replaced it, this message was never acked and the broker will\n    // redeliver it on the new channel, so drop this stale attempt rather than\n    // run the handler again or ack a tag the new channel does not know.\n    if (channel !== this.channel) {\n      this.logger.warn('Skipping message from a superseded channel; it will be redelivered')\n      return\n    }\n    const startTime = Date.now()\n    let attempts = 0\n    const routingKey = message.fields.routingKey\n    const exchange = message.fields.exchange\n\n    let content: RabbitMQMessage\n    try {\n      content = JSON.parse(message.content.toString())\n    } catch (parseError) {\n      const rawContent = message.content.toString()\n      const rawPreview = rawContent.substring(0, 100)\n      this.logger.error('Failed to parse message JSON, sending to DLQ', {\n        error: parseError,\n        exchange,\n        routingKey,\n        rawContentPreview: rawPreview + (rawContent.length > 100 ? '...' : ''),\n      })\n      if (this.settle(channel, message, 'nack')) {\n        this.callHook(this.hooks.onMessageDlq, { exchange, routingKey, duration: 0, reason: 'invalid_json' })\n      }\n      return\n    }\n\n    this.logger.debug('Message received, processing', { exchange, routingKey, payload: content })\n\n    const properties: RabbitMQMessageProperties = {\n      headers: message.properties.headers ?? {},\n      timestamp: message.properties.timestamp,\n      messageId: message.properties.messageId,\n      correlationId: message.properties.correlationId,\n    }\n\n    while (attempts < this.options.maxRetries) {\n      // Only the handler call belongs in this try. Acking inside it would make\n      // a dead channel look like a failed handler and re-run its side effects.\n      try {\n        await handler(content, properties)\n      } catch (error) {\n        attempts++\n        this.logger.error('Handler failed', {\n          error: error instanceof Error ? error.message : error,\n          stack: error instanceof Error ? error.stack : undefined,\n          exchange,\n          routingKey,\n          attempt: attempts,\n          maxRetries: this.options.maxRetries,\n        })\n        if (attempts < this.options.maxRetries) {\n          await this.sleep(this.options.retryDelay)\n        }\n        continue\n      }\n      const duration = Date.now() - startTime\n      this.logger.info('Message processed successfully', { exchange, routingKey, duration, attempts: attempts + 1 })\n      if (this.settle(channel, message, 'ack')) {\n        this.callHook(this.hooks.onMessageProcessed, { exchange, routingKey, duration, attempts: attempts + 1 })\n      }\n      return\n    }\n\n    const duration = Date.now() - startTime\n    this.logger.error('Message failed after max retries, sending to DLQ', { exchange, routingKey, maxRetries: this.options.maxRetries, duration })\n    if (this.settle(channel, message, 'nack')) {\n      this.callHook(this.hooks.onMessageDlq, { exchange, routingKey, duration, reason: 'max_retries_exhausted' })\n    }\n  }\n\n  /**\n   * Acks or nacks a delivery, reporting whether the broker accepted it.\n   *\n   * A settle failure is a transport error, never a handler failure: by this\n   * point the handler has already run, so it must not be retried just because\n   * the channel went away. The delivery stays unacked and the broker redelivers\n   * it once the channel closes.\n   */\n  private settle(\n    channel: amqp.ConfirmChannel,\n    message: amqp.ConsumeMessage,\n    action: 'ack' | 'nack',\n  ): boolean {\n    // A handler can run for minutes, so the channel that delivered this\n    // message may have been replaced by a reconnect since the entry check.\n    // Settling on it would throw, and replaying the delivery tag on the\n    // current channel would settle an unrelated message, since tags are scoped\n    // to the channel that issued them. The broker requeues a closed channel's\n    // unacked deliveries, so let it be redelivered instead.\n    if (channel !== this.channel) {\n      this.logger.warn('Skipping message from a superseded channel; it will be redelivered')\n      return false\n    }\n    try {\n      if (action === 'ack') {\n        channel.ack(message)\n      } else {\n        channel.nack(message, false, false)\n      }\n      return true\n    } catch (error) {\n      this.logger.error('Failed to settle message; leaving it unacked for redelivery', {\n        error,\n        action,\n        exchange: message.fields.exchange,\n        routingKey: message.fields.routingKey,\n      })\n      return false\n    }\n  }\n\n  /**\n   * Lightweight liveness probe: creates and immediately deletes a temporary\n   * exclusive queue. Returns `false` when disconnected or on broker error.\n   */\n  async checkHealth(): Promise<boolean> {\n    if (!this.connected || !this.channel) {\n      return false\n    }\n    try {\n      const { queue } = await this.channel.assertQueue('', {\n        exclusive: true,\n        autoDelete: true,\n      })\n      await this.channel.deleteQueue(queue)\n      return true\n    } catch (error) {\n      this.logger.warn('Health check failed', { error })\n      return false\n    }\n  }\n\n  private waitForDrain(timeout: number): Promise<void> {\n    if (this.inflightCount === 0) return Promise.resolve()\n    return new Promise<void>((resolve) => {\n      const timer = setTimeout(() => {\n        this.logger.warn('Close timeout reached with messages still in flight', { inflightCount: this.inflightCount })\n        this.drainResolve = null\n        resolve()\n      }, timeout)\n      this.drainResolve = () => {\n        clearTimeout(timer)\n        this.drainResolve = null\n        resolve()\n      }\n    })\n  }\n\n  /** Invokes a hook callback, swallowing errors so hooks never break message flow. */\n  private callHook<T>(hook: ((info: T) => void) | undefined, info: T): void {\n    try { hook?.(info) } catch (error) { this.logger.debug('Observability hook error', { error }) }\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms))\n  }\n}\n","import type { ILogger } from './types.js'\n\n/**\n * Default logger used when the consumer does not inject one.\n *\n * Forwards `warn` and `error` to the console so connection drops, channel\n * errors, and failed handlers stay visible out of the box, while staying\n * silent for `info`/`debug` so routine operation never pollutes the\n * consumer's output. Pass `silentLogger` for zero output, or any `ILogger`\n * (console, Winston, pino, Bunyan) to take full control.\n */\nexport const defaultLogger: ILogger = {\n  debug: () => {},\n  info: () => {},\n  warn: (message, ...args) => console.warn('[rabbitmq-client]', message, ...args),\n  error: (message, ...args) => console.error('[rabbitmq-client]', message, ...args),\n}\n\n/**\n * No-op logger that discards every message. Use this to silence the client\n * entirely, including the `warn`/`error` output the default logger emits.\n */\nexport const silentLogger: ILogger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n}\n","/**\n * Minimal FIFO counting semaphore used to cap how many message handlers run\n * concurrently, independently of channel prefetch.\n *\n * Prefetch bounds how many messages the broker delivers into consumer memory;\n * the semaphore bounds how many of those are actively being processed at once.\n * Keeping the two separate lets a consumer buffer a large prefetch window while\n * still protecting a slow downstream (a database, an HTTP API) from a burst.\n */\nexport class Semaphore {\n  private permits: number\n  private readonly waiters: Array<() => void> = []\n\n  constructor(permits: number) {\n    if (!Number.isInteger(permits) || permits < 1) {\n      throw new Error(`Semaphore requires a positive integer of permits, got ${permits}`)\n    }\n    this.permits = permits\n  }\n\n  /**\n   * Acquires a permit, resolving immediately when one is free or queueing\n   * (FIFO) until another holder releases. Always pair with `release()` in a\n   * `finally` so a throwing handler never leaks a permit.\n   */\n  acquire(): Promise<void> {\n    if (this.permits > 0) {\n      this.permits--\n      return Promise.resolve()\n    }\n    return new Promise<void>((resolve) => {\n      this.waiters.push(resolve)\n    })\n  }\n\n  /**\n   * Releases a permit. Hands it directly to the next waiter if any are queued,\n   * otherwise returns it to the pool.\n   */\n  release(): void {\n    const next = this.waiters.shift()\n    if (next) {\n      next()\n    } else {\n      this.permits++\n    }\n  }\n\n  /** Permits currently available. Exposed for tests and introspection. */\n  get available(): number {\n    return this.permits\n  }\n\n  /** Number of callers currently queued waiting for a permit. */\n  get waiting(): number {\n    return this.waiters.length\n  }\n}\n"],"mappings":"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","names":["amqp","duration"]}

package/dist/index.d.cts

@@ -1,126 +1,5 @@
-/**
- * Minimal logging contract required by this library.
- *
- * Calls are message-first (`logger.error('message', { context })`), matching
- * `console`, Winston, and Bunyan, so you can pass any of them (or pino)
- * directly without writing a wrapper. Only these four levels are used.
- */
-interface ILogger {
-    /** Detailed diagnostic information for developers. */
-    debug(message: string, ...args: unknown[]): void;
-    /** Routine informational messages about library operations. */
-    info(message: string, ...args: unknown[]): void;
-    /** Warnings about non-fatal issues. */
-    warn(message: string, ...args: unknown[]): void;
-    /** Errors indicating an operation failed. */
-    error(message: string, ...args: unknown[]): void;
-}
-/**
- * Hooks for observability — optional callbacks invoked on key client events.
- * Use these to wire metrics, tracing, or custom logging.
- */
-interface RabbitMQHooks {
-    /** Called after the broker confirms a published message */
-    onPublish?: (info: {
-        exchange: string;
-        routingKey: string;
-        attempts: number;
-    }) => void;
-    /** Called after a message handler returns successfully (duration includes retries) */
-    onMessageProcessed?: (info: {
-        exchange: string;
-        routingKey: string;
-        duration: number;
-        attempts: number;
-    }) => void;
-    /** Called when a message is nacked to the dead-letter queue */
-    onMessageDlq?: (info: {
-        exchange: string;
-        routingKey: string;
-        duration: number;
-        reason: 'invalid_json' | 'max_retries_exhausted';
-    }) => void;
-    /** Called after reconnection completes and subscriptions are re-established */
-    onReconnect?: (info: {
-        subscriptionsRestored: number;
-        subscriptionsFailed: number;
-    }) => void;
-}
-/**
- * Options for queue subscription.
- */
-interface SubscribeOptions {
-    /** Override default AMQP queue arguments (merged with DLQ wiring defaults) */
-    queueArguments?: Record<string, unknown>;
-    /**
-     * Max message handlers to run concurrently for this subscription.
-     * Overrides the client-level `concurrency` for this queue only. Prefetch
-     * bounds messages held in memory; concurrency bounds how many are processed
-     * at once, and only throttles when set below `prefetch`. `0` means no limit.
-     */
-    concurrency?: number;
-}
-/**
- * Configuration options for the RabbitMQ client.
- */
-interface RabbitMQClientOptions {
-    /** AMQP connection URL (e.g., 'amqp://user:pass@host:5672') */
-    url: string;
-    /** Max handler retries before sending to DLQ (default: 3) */
-    maxRetries?: number;
-    /** Delay in ms between handler retries (default: 1000) */
-    retryDelay?: number;
-    /** Delay in ms between reconnection attempts (default: 5000) */
-    connectionRetryDelay?: number;
-    /** Max connection attempts during init; undefined = unlimited (default: 5) */
-    initMaxAttempts?: number;
-    /** Max publish attempts with exponential backoff (default: 5) */
-    publishMaxAttempts?: number;
-    /** Channel prefetch count (default: 10) */
-    prefetch?: number;
-    /**
-     * Max message handlers to run concurrently per subscription (default: equal
-     * to `prefetch`). Bounds how many `handler` callbacks execute at once, on top
-     * of how many messages prefetch keeps buffered in memory. Only throttles when
-     * set below `prefetch`, since the broker never delivers more than `prefetch`
-     * unacked messages at a time; `0` (or a negative value) means no limit.
-     * Override per queue via `SubscribeOptions.concurrency`.
-     */
-    concurrency?: number;
-    /** Logger satisfying the ILogger contract; defaults to console warn/error only if omitted */
-    logger?: ILogger;
-    /** Timeout in ms to wait for in-flight messages during close (default: 5000) */
-    closeTimeout?: number;
-    /** Observability hooks for metrics and monitoring */
-    hooks?: RabbitMQHooks;
-}
-/**
- * Options for the `publish()` method.
- */
-interface PublishOptions {
-    /** Max publish attempts with backoff (overrides client default) */
-    maxAttempts?: number;
-    /** Custom message headers for tracing and metadata */
-    headers?: Record<string, unknown>;
-    /** Correlation ID for request-reply patterns */
-    correlationId?: string;
-    /** Unique message identifier */
-    messageId?: string;
-    /** Per-message TTL in milliseconds (as string per AMQP spec) */
-    expiration?: string;
-}
-/** JSON-serializable message payload */
-type RabbitMQMessage = Record<string, unknown>;
-/** Async handler function for consumed messages */
-type RabbitMQMessageHandler = (message: RabbitMQMessage) => Promise<void>;
-/** Stored subscription metadata for restoration after reconnection */
-interface RabbitMQSubscription {
-    exchange: string;
-    routingKey: string;
-    queue: string;
-    handler: RabbitMQMessageHandler;
-    options?: SubscribeOptions;
-}
+import { R as RabbitMQClientOptions, a as RabbitMQMessage, P as PublishOptions, b as RabbitMQMessageHandler, S as SubscribeOptions, I as ILogger } from './types-DixDwMJh.cjs';
+export { c as RabbitMQHooks, d as RabbitMQMessageProperties, e as RabbitMQSubscription } from './types-DixDwMJh.cjs';
 
 /**
  * Production-grade RabbitMQ client with confirm channels, automatic DLQ
@@ -199,6 +78,15 @@ declare class RabbitMQClient {
      */
     private dispatch;
     private handleWithRetry;
+    /**
+     * Acks or nacks a delivery, reporting whether the broker accepted it.
+     *
+     * A settle failure is a transport error, never a handler failure: by this
+     * point the handler has already run, so it must not be retried just because
+     * the channel went away. The delivery stays unacked and the broker redelivers
+     * it once the channel closes.
+     */
+    private settle;
     /**
      * Lightweight liveness probe: creates and immediately deletes a temporary
      * exclusive queue. Returns `false` when disconnected or on broker error.
@@ -226,4 +114,4 @@ declare const defaultLogger: ILogger;
  */
 declare const silentLogger: ILogger;
 
-export { type ILogger, type PublishOptions, RabbitMQClient, type RabbitMQClientOptions, type RabbitMQHooks, type RabbitMQMessage, type RabbitMQMessageHandler, type RabbitMQSubscription, type SubscribeOptions, defaultLogger, silentLogger };
+export { ILogger, PublishOptions, RabbitMQClient, RabbitMQClientOptions, RabbitMQMessage, RabbitMQMessageHandler, SubscribeOptions, defaultLogger, silentLogger };

package/dist/index.d.ts

@@ -1,126 +1,5 @@
-/**
- * Minimal logging contract required by this library.
- *
- * Calls are message-first (`logger.error('message', { context })`), matching
- * `console`, Winston, and Bunyan, so you can pass any of them (or pino)
- * directly without writing a wrapper. Only these four levels are used.
- */
-interface ILogger {
-    /** Detailed diagnostic information for developers. */
-    debug(message: string, ...args: unknown[]): void;
-    /** Routine informational messages about library operations. */
-    info(message: string, ...args: unknown[]): void;
-    /** Warnings about non-fatal issues. */
-    warn(message: string, ...args: unknown[]): void;
-    /** Errors indicating an operation failed. */
-    error(message: string, ...args: unknown[]): void;
-}
-/**
- * Hooks for observability — optional callbacks invoked on key client events.
- * Use these to wire metrics, tracing, or custom logging.
- */
-interface RabbitMQHooks {
-    /** Called after the broker confirms a published message */
-    onPublish?: (info: {
-        exchange: string;
-        routingKey: string;
-        attempts: number;
-    }) => void;
-    /** Called after a message handler returns successfully (duration includes retries) */
-    onMessageProcessed?: (info: {
-        exchange: string;
-        routingKey: string;
-        duration: number;
-        attempts: number;
-    }) => void;
-    /** Called when a message is nacked to the dead-letter queue */
-    onMessageDlq?: (info: {
-        exchange: string;
-        routingKey: string;
-        duration: number;
-        reason: 'invalid_json' | 'max_retries_exhausted';
-    }) => void;
-    /** Called after reconnection completes and subscriptions are re-established */
-    onReconnect?: (info: {
-        subscriptionsRestored: number;
-        subscriptionsFailed: number;
-    }) => void;
-}
-/**
- * Options for queue subscription.
- */
-interface SubscribeOptions {
-    /** Override default AMQP queue arguments (merged with DLQ wiring defaults) */
-    queueArguments?: Record<string, unknown>;
-    /**
-     * Max message handlers to run concurrently for this subscription.
-     * Overrides the client-level `concurrency` for this queue only. Prefetch
-     * bounds messages held in memory; concurrency bounds how many are processed
-     * at once, and only throttles when set below `prefetch`. `0` means no limit.
-     */
-    concurrency?: number;
-}
-/**
- * Configuration options for the RabbitMQ client.
- */
-interface RabbitMQClientOptions {
-    /** AMQP connection URL (e.g., 'amqp://user:pass@host:5672') */
-    url: string;
-    /** Max handler retries before sending to DLQ (default: 3) */
-    maxRetries?: number;
-    /** Delay in ms between handler retries (default: 1000) */
-    retryDelay?: number;
-    /** Delay in ms between reconnection attempts (default: 5000) */
-    connectionRetryDelay?: number;
-    /** Max connection attempts during init; undefined = unlimited (default: 5) */
-    initMaxAttempts?: number;
-    /** Max publish attempts with exponential backoff (default: 5) */
-    publishMaxAttempts?: number;
-    /** Channel prefetch count (default: 10) */
-    prefetch?: number;
-    /**
-     * Max message handlers to run concurrently per subscription (default: equal
-     * to `prefetch`). Bounds how many `handler` callbacks execute at once, on top
-     * of how many messages prefetch keeps buffered in memory. Only throttles when
-     * set below `prefetch`, since the broker never delivers more than `prefetch`
-     * unacked messages at a time; `0` (or a negative value) means no limit.
-     * Override per queue via `SubscribeOptions.concurrency`.
-     */
-    concurrency?: number;
-    /** Logger satisfying the ILogger contract; defaults to console warn/error only if omitted */
-    logger?: ILogger;
-    /** Timeout in ms to wait for in-flight messages during close (default: 5000) */
-    closeTimeout?: number;
-    /** Observability hooks for metrics and monitoring */
-    hooks?: RabbitMQHooks;
-}
-/**
- * Options for the `publish()` method.
- */
-interface PublishOptions {
-    /** Max publish attempts with backoff (overrides client default) */
-    maxAttempts?: number;
-    /** Custom message headers for tracing and metadata */
-    headers?: Record<string, unknown>;
-    /** Correlation ID for request-reply patterns */
-    correlationId?: string;
-    /** Unique message identifier */
-    messageId?: string;
-    /** Per-message TTL in milliseconds (as string per AMQP spec) */
-    expiration?: string;
-}
-/** JSON-serializable message payload */
-type RabbitMQMessage = Record<string, unknown>;
-/** Async handler function for consumed messages */
-type RabbitMQMessageHandler = (message: RabbitMQMessage) => Promise<void>;
-/** Stored subscription metadata for restoration after reconnection */
-interface RabbitMQSubscription {
-    exchange: string;
-    routingKey: string;
-    queue: string;
-    handler: RabbitMQMessageHandler;
-    options?: SubscribeOptions;
-}
+import { R as RabbitMQClientOptions, a as RabbitMQMessage, P as PublishOptions, b as RabbitMQMessageHandler, S as SubscribeOptions, I as ILogger } from './types-DixDwMJh.js';
+export { c as RabbitMQHooks, d as RabbitMQMessageProperties, e as RabbitMQSubscription } from './types-DixDwMJh.js';
 
 /**
  * Production-grade RabbitMQ client with confirm channels, automatic DLQ
@@ -199,6 +78,15 @@ declare class RabbitMQClient {
      */
     private dispatch;
     private handleWithRetry;
+    /**
+     * Acks or nacks a delivery, reporting whether the broker accepted it.
+     *
+     * A settle failure is a transport error, never a handler failure: by this
+     * point the handler has already run, so it must not be retried just because
+     * the channel went away. The delivery stays unacked and the broker redelivers
+     * it once the channel closes.
+     */
+    private settle;
     /**
      * Lightweight liveness probe: creates and immediately deletes a temporary
      * exclusive queue. Returns `false` when disconnected or on broker error.
@@ -226,4 +114,4 @@ declare const defaultLogger: ILogger;
  */
 declare const silentLogger: ILogger;
 
-export { type ILogger, type PublishOptions, RabbitMQClient, type RabbitMQClientOptions, type RabbitMQHooks, type RabbitMQMessage, type RabbitMQMessageHandler, type RabbitMQSubscription, type SubscribeOptions, defaultLogger, silentLogger };
+export { ILogger, PublishOptions, RabbitMQClient, RabbitMQClientOptions, RabbitMQMessage, RabbitMQMessageHandler, SubscribeOptions, defaultLogger, silentLogger };