@linagora/rabbitmq-client 0.4.1 → 0.5.0

package/dist/testing/index.d.cts

@@ -1,5 +1,5 @@
 import { EventEmitter } from 'events';
-import { d as RabbitMQMessageProperties } from '../types-D29GyoZX.cjs';
+import { e as RabbitMQMessageProperties } from '../types-Cjg-65Ef.cjs';
 
 interface MockFn {
     (...args: unknown[]): unknown;
@@ -20,6 +20,7 @@ declare class MockRabbitMQChannel extends EventEmitter {
     private _consumeCallback;
     isClosed: boolean;
     readonly assertExchange: MockFn;
+    readonly checkExchange: MockFn;
     readonly assertQueue: MockFn;
     readonly bindQueue: MockFn;
     readonly ack: MockFn;
@@ -77,6 +78,8 @@ declare class MockRabbitMQConnection extends EventEmitter {
      * Creates a new channel (simulates a reconnection / new confirm-channel).
      */
     createConfirmChannel(): Promise<MockRabbitMQChannel>;
+    /** Creates an untracked plain channel, as used for passive exchange checks. */
+    createChannel(): Promise<MockRabbitMQChannel>;
     close(): Promise<void>;
     /** Emits a close event and marks the connection as disconnected. */
     simulateClose(): void;

package/dist/testing/index.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from 'events';
-import { d as RabbitMQMessageProperties } from '../types-D29GyoZX.js';
+import { e as RabbitMQMessageProperties } from '../types-Cjg-65Ef.js';
 
 interface MockFn {
     (...args: unknown[]): unknown;
@@ -20,6 +20,7 @@ declare class MockRabbitMQChannel extends EventEmitter {
     private _consumeCallback;
     isClosed: boolean;
     readonly assertExchange: MockFn;
+    readonly checkExchange: MockFn;
     readonly assertQueue: MockFn;
     readonly bindQueue: MockFn;
     readonly ack: MockFn;
@@ -77,6 +78,8 @@ declare class MockRabbitMQConnection extends EventEmitter {
      * Creates a new channel (simulates a reconnection / new confirm-channel).
      */
     createConfirmChannel(): Promise<MockRabbitMQChannel>;
+    /** Creates an untracked plain channel, as used for passive exchange checks. */
+    createChannel(): Promise<MockRabbitMQChannel>;
     close(): Promise<void>;
     /** Emits a close event and marks the connection as disconnected. */
     simulateClose(): void;

package/dist/testing/index.js

@@ -24,6 +24,7 @@ var MockRabbitMQChannel = class extends EventEmitter {
   isClosed = false;
   // Stubs
   assertExchange = mockFn().mockResolvedValue({});
+  checkExchange = mockFn().mockResolvedValue({});
   assertQueue = mockFn().mockResolvedValue({ queue: "" });
   bindQueue = mockFn().mockResolvedValue({});
   ack = mockFn();
@@ -74,10 +75,11 @@ var MockRabbitMQChannel = class extends EventEmitter {
   }
   _deliver(content, properties = {}) {
     if (!this._consumeCallback) return;
+    const { exchange = "", routingKey = "", ...amqpProperties } = properties;
     this._consumeCallback({
       content,
-      fields: { deliveryTag: 1, redelivered: false, exchange: "", routingKey: "", consumerTag: "mock-consumer" },
-      properties: { headers: {}, ...properties }
+      fields: { deliveryTag: 1, redelivered: false, exchange, routingKey, consumerTag: "mock-consumer" },
+      properties: { headers: {}, ...amqpProperties }
     });
   }
   /** Emits a close event and marks the channel as closed. */
@@ -137,6 +139,10 @@ var MockRabbitMQConnection = class extends EventEmitter {
     this._channels.push(ch);
     return Promise.resolve(ch);
   }
+  /** Creates an untracked plain channel, as used for passive exchange checks. */
+  createChannel() {
+    return Promise.resolve(new MockRabbitMQChannel());
+  }
   close() {
     this.isConnected = false;
     return Promise.resolve();

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["import { EventEmitter } from 'events'\nimport type { RabbitMQMessageProperties } from '../types.js'\n\n// ---------------------------------------------------------------------------\n// Framework-agnostic mock function factory\n// ---------------------------------------------------------------------------\n\ninterface MockFn {\n  (...args: unknown[]): unknown\n  mock: { calls: unknown[][] }\n  mockResolvedValue: (val: unknown) => MockFn\n  mockImplementation: (fn: (...args: unknown[]) => unknown) => MockFn\n}\n\nfunction mockFn(): MockFn {\n  let impl: ((...args: unknown[]) => unknown) | null = null\n  const calls: unknown[][] = []\n\n  const fn = ((...args: unknown[]) => {\n    calls.push(args)\n    return impl ? impl(...args) : undefined\n  }) as MockFn\n\n  fn.mock = { calls }\n\n  fn.mockResolvedValue = (val: unknown) => {\n    impl = () => Promise.resolve(val)\n    return fn\n  }\n\n  fn.mockImplementation = (newImpl: (...args: unknown[]) => unknown) => {\n    impl = newImpl\n    return fn\n  }\n\n  return fn\n}\n\n// ---------------------------------------------------------------------------\n// Published message record\n// ---------------------------------------------------------------------------\n\nexport interface PublishedMessage {\n  exchange: string\n  routingKey: string\n  message: unknown\n  options: unknown\n}\n\n// ---------------------------------------------------------------------------\n// MockRabbitMQChannel\n// ---------------------------------------------------------------------------\n\nexport class MockRabbitMQChannel extends EventEmitter {\n  private _publishedMessages: PublishedMessage[] = []\n  private _consumeCallback: ((msg: unknown) => void) | null = null\n\n  isClosed = false\n\n  // Stubs\n  readonly assertExchange = mockFn().mockResolvedValue({})\n  readonly assertQueue = mockFn().mockResolvedValue({ queue: '' })\n  readonly bindQueue = mockFn().mockResolvedValue({})\n  readonly ack = mockFn()\n  readonly nack = mockFn()\n  readonly close = mockFn().mockResolvedValue(undefined)\n  readonly waitForConfirms = mockFn().mockResolvedValue(undefined)\n  readonly prefetch = mockFn().mockResolvedValue(undefined)\n  readonly deleteQueue = mockFn().mockResolvedValue({})\n  readonly cancel = mockFn().mockResolvedValue(undefined)\n\n  /**\n   * Tracks all published messages and stores them for later inspection.\n   */\n  publish(exchange: string, routingKey: string, content: Buffer, options?: unknown): boolean {\n    let message: unknown\n    try {\n      message = JSON.parse(content.toString())\n    } catch {\n      message = content.toString()\n    }\n    this._publishedMessages.push({ exchange, routingKey, message, options })\n    return true\n  }\n\n  private _consumerCounter = 0\n\n  /**\n   * Stores the consumer callback for use with simulateMessage.\n   * Returns a unique consumer tag per call.\n   */\n  consume(_queue: string, callback: (msg: unknown) => void): Promise<{ consumerTag: string }> {\n    this._consumeCallback = callback\n    const consumerTag = `mock-consumer-${++this._consumerCounter}`\n    return Promise.resolve({ consumerTag })\n  }\n\n  // ---------------------------------------------------------------------------\n  // Simulation helpers\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Delivers a valid JSON message to the registered consume callback, with\n   * optional AMQP properties such as `headers` or `timestamp`.\n   */\n  simulateMessage(content: unknown, properties: Partial<RabbitMQMessageProperties> = {}): void {\n    this._deliver(Buffer.from(JSON.stringify(content)), properties)\n  }\n\n  /**\n   * Delivers a message with content that is not valid JSON.\n   */\n  simulateInvalidJsonMessage(): void {\n    this._deliver(Buffer.from('not valid json {'))\n  }\n\n  private _deliver(content: Buffer, properties: Partial<RabbitMQMessageProperties> = {}): void {\n    if (!this._consumeCallback) return\n    this._consumeCallback({\n      content,\n      fields: { deliveryTag: 1, redelivered: false, exchange: '', routingKey: '', consumerTag: 'mock-consumer' },\n      properties: { headers: {}, ...properties },\n    })\n  }\n\n  /** Emits a close event and marks the channel as closed. */\n  simulateClose(): void {\n    this.isClosed = true\n    this.emit('close')\n  }\n\n  /** Emits an error event. */\n  simulateError(error: Error): void {\n    this.emit('error', error)\n  }\n\n  // ---------------------------------------------------------------------------\n  // Inspection helpers\n  // ---------------------------------------------------------------------------\n\n  getPublishedMessages(): PublishedMessage[] {\n    return [...this._publishedMessages]\n  }\n\n  clearMessages(): void {\n    this._publishedMessages = []\n  }\n\n  /** Resets all state back to initial values. */\n  reset(): void {\n    this._publishedMessages = []\n    this._consumeCallback = null\n    this._consumerCounter = 0\n    this.isClosed = false\n    this.removeAllListeners()\n  }\n}\n\n// ---------------------------------------------------------------------------\n// MockRabbitMQConnection\n// ---------------------------------------------------------------------------\n\nexport class MockRabbitMQConnection extends EventEmitter {\n  private _channels: MockRabbitMQChannel[] = []\n\n  isConnected = true\n\n  constructor() {\n    super()\n    // Create the initial channel eagerly so `conn.channel` is defined\n    // before the first createConfirmChannel call.\n    this._channels.push(new MockRabbitMQChannel())\n  }\n\n  /**\n   * Returns the most recently created channel.\n   */\n  get channel(): MockRabbitMQChannel {\n    return this._channels[this._channels.length - 1]\n  }\n\n  /**\n   * Returns all channels created so far (including the initial one).\n   */\n  get channels(): MockRabbitMQChannel[] {\n    return [...this._channels]\n  }\n\n  get channelCount(): number {\n    return this._channels.length\n  }\n\n  /**\n   * Creates a new channel (simulates a reconnection / new confirm-channel).\n   */\n  createConfirmChannel(): Promise<MockRabbitMQChannel> {\n    const ch = new MockRabbitMQChannel()\n    this._channels.push(ch)\n    return Promise.resolve(ch)\n  }\n\n  close(): Promise<void> {\n    this.isConnected = false\n    return Promise.resolve()\n  }\n\n  /** Emits a close event and marks the connection as disconnected. */\n  simulateClose(): void {\n    this.isConnected = false\n    this.emit('close')\n  }\n\n  /** Emits an error event. */\n  simulateError(error: Error): void {\n    this.emit('error', error)\n  }\n\n  /** Resets to the initial connected state with a single fresh channel. */\n  reset(): void {\n    this._channels = [new MockRabbitMQChannel()]\n    this.isConnected = true\n    this.removeAllListeners()\n  }\n}\n\n// ---------------------------------------------------------------------------\n// createMockAmqplib\n// ---------------------------------------------------------------------------\n\nexport interface AmqpMock {\n  connect: MockFn\n}\n\nexport interface MockAmqplibResult {\n  mockConnection: MockRabbitMQConnection\n  amqpMock: AmqpMock\n}\n\n/**\n * Returns a pre-wired { mockConnection, amqpMock } pair that can be used as\n * a drop-in replacement for amqplib in tests (e.g. via vi.mock or jest.mock).\n */\nexport function createMockAmqplib(): MockAmqplibResult {\n  const mockConnection = new MockRabbitMQConnection()\n  const amqpMock: AmqpMock = {\n    connect: mockFn().mockResolvedValue(mockConnection),\n  }\n  return { mockConnection, amqpMock }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["import { EventEmitter } from 'events'\nimport type { RabbitMQMessageProperties } from '../types.js'\n\n// ---------------------------------------------------------------------------\n// Framework-agnostic mock function factory\n// ---------------------------------------------------------------------------\n\ninterface MockFn {\n  (...args: unknown[]): unknown\n  mock: { calls: unknown[][] }\n  mockResolvedValue: (val: unknown) => MockFn\n  mockImplementation: (fn: (...args: unknown[]) => unknown) => MockFn\n}\n\nfunction mockFn(): MockFn {\n  let impl: ((...args: unknown[]) => unknown) | null = null\n  const calls: unknown[][] = []\n\n  const fn = ((...args: unknown[]) => {\n    calls.push(args)\n    return impl ? impl(...args) : undefined\n  }) as MockFn\n\n  fn.mock = { calls }\n\n  fn.mockResolvedValue = (val: unknown) => {\n    impl = () => Promise.resolve(val)\n    return fn\n  }\n\n  fn.mockImplementation = (newImpl: (...args: unknown[]) => unknown) => {\n    impl = newImpl\n    return fn\n  }\n\n  return fn\n}\n\n// ---------------------------------------------------------------------------\n// Published message record\n// ---------------------------------------------------------------------------\n\nexport interface PublishedMessage {\n  exchange: string\n  routingKey: string\n  message: unknown\n  options: unknown\n}\n\n// ---------------------------------------------------------------------------\n// MockRabbitMQChannel\n// ---------------------------------------------------------------------------\n\nexport class MockRabbitMQChannel extends EventEmitter {\n  private _publishedMessages: PublishedMessage[] = []\n  private _consumeCallback: ((msg: unknown) => void) | null = null\n\n  isClosed = false\n\n  // Stubs\n  readonly assertExchange = mockFn().mockResolvedValue({})\n  readonly checkExchange = mockFn().mockResolvedValue({})\n  readonly assertQueue = mockFn().mockResolvedValue({ queue: '' })\n  readonly bindQueue = mockFn().mockResolvedValue({})\n  readonly ack = mockFn()\n  readonly nack = mockFn()\n  readonly close = mockFn().mockResolvedValue(undefined)\n  readonly waitForConfirms = mockFn().mockResolvedValue(undefined)\n  readonly prefetch = mockFn().mockResolvedValue(undefined)\n  readonly deleteQueue = mockFn().mockResolvedValue({})\n  readonly cancel = mockFn().mockResolvedValue(undefined)\n\n  /**\n   * Tracks all published messages and stores them for later inspection.\n   */\n  publish(exchange: string, routingKey: string, content: Buffer, options?: unknown): boolean {\n    let message: unknown\n    try {\n      message = JSON.parse(content.toString())\n    } catch {\n      message = content.toString()\n    }\n    this._publishedMessages.push({ exchange, routingKey, message, options })\n    return true\n  }\n\n  private _consumerCounter = 0\n\n  /**\n   * Stores the consumer callback for use with simulateMessage.\n   * Returns a unique consumer tag per call.\n   */\n  consume(_queue: string, callback: (msg: unknown) => void): Promise<{ consumerTag: string }> {\n    this._consumeCallback = callback\n    const consumerTag = `mock-consumer-${++this._consumerCounter}`\n    return Promise.resolve({ consumerTag })\n  }\n\n  // ---------------------------------------------------------------------------\n  // Simulation helpers\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Delivers a valid JSON message to the registered consume callback, with\n   * optional AMQP properties such as `headers` or `timestamp`.\n   */\n  simulateMessage(content: unknown, properties: Partial<RabbitMQMessageProperties> = {}): void {\n    this._deliver(Buffer.from(JSON.stringify(content)), properties)\n  }\n\n  /**\n   * Delivers a message with content that is not valid JSON.\n   */\n  simulateInvalidJsonMessage(): void {\n    this._deliver(Buffer.from('not valid json {'))\n  }\n\n  private _deliver(content: Buffer, properties: Partial<RabbitMQMessageProperties> = {}): void {\n    if (!this._consumeCallback) return\n    const { exchange = '', routingKey = '', ...amqpProperties } = properties\n    this._consumeCallback({\n      content,\n      fields: { deliveryTag: 1, redelivered: false, exchange, routingKey, consumerTag: 'mock-consumer' },\n      properties: { headers: {}, ...amqpProperties },\n    })\n  }\n\n  /** Emits a close event and marks the channel as closed. */\n  simulateClose(): void {\n    this.isClosed = true\n    this.emit('close')\n  }\n\n  /** Emits an error event. */\n  simulateError(error: Error): void {\n    this.emit('error', error)\n  }\n\n  // ---------------------------------------------------------------------------\n  // Inspection helpers\n  // ---------------------------------------------------------------------------\n\n  getPublishedMessages(): PublishedMessage[] {\n    return [...this._publishedMessages]\n  }\n\n  clearMessages(): void {\n    this._publishedMessages = []\n  }\n\n  /** Resets all state back to initial values. */\n  reset(): void {\n    this._publishedMessages = []\n    this._consumeCallback = null\n    this._consumerCounter = 0\n    this.isClosed = false\n    this.removeAllListeners()\n  }\n}\n\n// ---------------------------------------------------------------------------\n// MockRabbitMQConnection\n// ---------------------------------------------------------------------------\n\nexport class MockRabbitMQConnection extends EventEmitter {\n  private _channels: MockRabbitMQChannel[] = []\n\n  isConnected = true\n\n  constructor() {\n    super()\n    // Create the initial channel eagerly so `conn.channel` is defined\n    // before the first createConfirmChannel call.\n    this._channels.push(new MockRabbitMQChannel())\n  }\n\n  /**\n   * Returns the most recently created channel.\n   */\n  get channel(): MockRabbitMQChannel {\n    return this._channels[this._channels.length - 1]\n  }\n\n  /**\n   * Returns all channels created so far (including the initial one).\n   */\n  get channels(): MockRabbitMQChannel[] {\n    return [...this._channels]\n  }\n\n  get channelCount(): number {\n    return this._channels.length\n  }\n\n  /**\n   * Creates a new channel (simulates a reconnection / new confirm-channel).\n   */\n  createConfirmChannel(): Promise<MockRabbitMQChannel> {\n    const ch = new MockRabbitMQChannel()\n    this._channels.push(ch)\n    return Promise.resolve(ch)\n  }\n\n  /** Creates an untracked plain channel, as used for passive exchange checks. */\n  createChannel(): Promise<MockRabbitMQChannel> {\n    return Promise.resolve(new MockRabbitMQChannel())\n  }\n\n  close(): Promise<void> {\n    this.isConnected = false\n    return Promise.resolve()\n  }\n\n  /** Emits a close event and marks the connection as disconnected. */\n  simulateClose(): void {\n    this.isConnected = false\n    this.emit('close')\n  }\n\n  /** Emits an error event. */\n  simulateError(error: Error): void {\n    this.emit('error', error)\n  }\n\n  /** Resets to the initial connected state with a single fresh channel. */\n  reset(): void {\n    this._channels = [new MockRabbitMQChannel()]\n    this.isConnected = true\n    this.removeAllListeners()\n  }\n}\n\n// ---------------------------------------------------------------------------\n// createMockAmqplib\n// ---------------------------------------------------------------------------\n\nexport interface AmqpMock {\n  connect: MockFn\n}\n\nexport interface MockAmqplibResult {\n  mockConnection: MockRabbitMQConnection\n  amqpMock: AmqpMock\n}\n\n/**\n * Returns a pre-wired { mockConnection, amqpMock } pair that can be used as\n * a drop-in replacement for amqplib in tests (e.g. via vi.mock or jest.mock).\n */\nexport function createMockAmqplib(): MockAmqplibResult {\n  const mockConnection = new MockRabbitMQConnection()\n  const amqpMock: AmqpMock = {\n    connect: mockFn().mockResolvedValue(mockConnection),\n  }\n  return { mockConnection, amqpMock }\n}\n"],"mappings":"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","names":[]}

package/dist/{types-D29GyoZX.d.cts → types-Cjg-65Ef.d.cts}

@@ -39,7 +39,7 @@ interface RabbitMQHooks {
         exchange: string;
         routingKey: string;
         duration: number;
-        reason: 'invalid_json' | 'max_retries_exhausted';
+        reason: 'invalid_json' | 'max_retries_exhausted' | 'dead_letter_error';
     }) => void;
     /** Called after reconnection completes and subscriptions are re-established */
     onReconnect?: (info: {
@@ -60,6 +60,27 @@ interface SubscribeOptions {
      * at once, and only throttles when set below `prefetch`. `0` means no limit.
      */
     concurrency?: number;
+    /** More exchanges and routing keys to bind the same queue to, consumed by the same handler */
+    bindings?: RabbitMQBinding[];
+    /** Dead-letter exchange name (default: `<exchange>.dlx`) */
+    deadLetterExchange?: string;
+    /**
+     * Check that the source exchanges exist instead of declaring them, for
+     * exchanges another service owns. Subscribing fails when one is missing.
+     */
+    passiveExchanges?: boolean;
+    /** Max handler attempts before the DLQ for this queue (overrides the client default); `Infinity` retries until the handler succeeds */
+    maxRetries?: number;
+    /**
+     * Double the delay between handler attempts, from `retryDelay` up to this
+     * many ms. Without it the delay stays at `retryDelay`.
+     */
+    maxRetryDelay?: number;
+}
+/** An exchange and routing key a queue is bound to */
+interface RabbitMQBinding {
+    exchange: string;
+    routingKey: string;
 }
 /**
  * Configuration options for the RabbitMQ client.
@@ -119,6 +140,10 @@ interface PublishOptions {
 type RabbitMQMessage = Record<string, unknown>;
 /** What the publisher and the broker attached to a consumed message */
 interface RabbitMQMessageProperties {
+    /** Exchange the message was published to */
+    exchange: string;
+    /** Routing key the message was published with */
+    routingKey: string;
     /** AMQP headers, including broker-added ones such as `x-death` on a dead-lettered message */
     headers: Record<string, unknown>;
     /** AMQP timestamp in seconds, if the publisher set one */
@@ -139,4 +164,4 @@ interface RabbitMQSubscription {
     options?: SubscribeOptions;
 }
 
-export type { ILogger as I, PublishOptions as P, RabbitMQClientOptions as R, SubscribeOptions as S, RabbitMQMessage as a, RabbitMQMessageHandler as b, RabbitMQHooks as c, RabbitMQMessageProperties as d, RabbitMQSubscription as e };
+export type { ILogger as I, PublishOptions as P, RabbitMQClientOptions as R, SubscribeOptions as S, RabbitMQMessage as a, RabbitMQMessageHandler as b, RabbitMQBinding as c, RabbitMQHooks as d, RabbitMQMessageProperties as e, RabbitMQSubscription as f };

package/dist/{types-D29GyoZX.d.ts → types-Cjg-65Ef.d.ts}

@@ -39,7 +39,7 @@ interface RabbitMQHooks {
         exchange: string;
         routingKey: string;
         duration: number;
-        reason: 'invalid_json' | 'max_retries_exhausted';
+        reason: 'invalid_json' | 'max_retries_exhausted' | 'dead_letter_error';
     }) => void;
     /** Called after reconnection completes and subscriptions are re-established */
     onReconnect?: (info: {
@@ -60,6 +60,27 @@ interface SubscribeOptions {
      * at once, and only throttles when set below `prefetch`. `0` means no limit.
      */
     concurrency?: number;
+    /** More exchanges and routing keys to bind the same queue to, consumed by the same handler */
+    bindings?: RabbitMQBinding[];
+    /** Dead-letter exchange name (default: `<exchange>.dlx`) */
+    deadLetterExchange?: string;
+    /**
+     * Check that the source exchanges exist instead of declaring them, for
+     * exchanges another service owns. Subscribing fails when one is missing.
+     */
+    passiveExchanges?: boolean;
+    /** Max handler attempts before the DLQ for this queue (overrides the client default); `Infinity` retries until the handler succeeds */
+    maxRetries?: number;
+    /**
+     * Double the delay between handler attempts, from `retryDelay` up to this
+     * many ms. Without it the delay stays at `retryDelay`.
+     */
+    maxRetryDelay?: number;
+}
+/** An exchange and routing key a queue is bound to */
+interface RabbitMQBinding {
+    exchange: string;
+    routingKey: string;
 }
 /**
  * Configuration options for the RabbitMQ client.
@@ -119,6 +140,10 @@ interface PublishOptions {
 type RabbitMQMessage = Record<string, unknown>;
 /** What the publisher and the broker attached to a consumed message */
 interface RabbitMQMessageProperties {
+    /** Exchange the message was published to */
+    exchange: string;
+    /** Routing key the message was published with */
+    routingKey: string;
     /** AMQP headers, including broker-added ones such as `x-death` on a dead-lettered message */
     headers: Record<string, unknown>;
     /** AMQP timestamp in seconds, if the publisher set one */
@@ -139,4 +164,4 @@ interface RabbitMQSubscription {
     options?: SubscribeOptions;
 }
 
-export type { ILogger as I, PublishOptions as P, RabbitMQClientOptions as R, SubscribeOptions as S, RabbitMQMessage as a, RabbitMQMessageHandler as b, RabbitMQHooks as c, RabbitMQMessageProperties as d, RabbitMQSubscription as e };
+export type { ILogger as I, PublishOptions as P, RabbitMQClientOptions as R, SubscribeOptions as S, RabbitMQMessage as a, RabbitMQMessageHandler as b, RabbitMQBinding as c, RabbitMQHooks as d, RabbitMQMessageProperties as e, RabbitMQSubscription as f };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linagora/rabbitmq-client",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Production-grade RabbitMQ client with confirm channels, DLQ infrastructure, auto-reconnection, exponential backoff, graceful shutdown, and observability hooks",
   "type": "module",
   "exports": {