rabbitmq-with-retry-and-dlq 1.0.23 → 1.0.25

package/dist/consumerMq.d.ts

@@ -76,8 +76,11 @@ declare class RabbitMQConsumer extends EventEmitter {
      * await consumer.assertQueues(['orders-worker', 'payments-worker']);
      *
      * @example
-     * // Assert queue with DLQ setup
+     * // Assert queue with exchange binding and retry config
      * await consumer.assertQueues('orders-worker', {
+     *   exchangeName: 'orders',
+     *   exchangeType: 'direct',
+     *   routingKey: 'order.created',
      *   retryConfig: { maxRetries: 3, retryDelayMs: 5000 }
      * });
      */
@@ -85,12 +88,44 @@ declare class RabbitMQConsumer extends EventEmitter {
         durable?: boolean;
         exclusive?: boolean;
         autoDelete?: boolean;
+        exchangeName?: string;
+        exchangeType?: 'direct' | 'topic' | 'fanout' | 'headers';
+        routingKey?: string;
         retryConfig?: RetryConfig;
     }): Promise<void>;
     /**
-     * Setup retry queue and DLQ for a main queue
+     * Delete queues (Best Practice for cleanup/testing)
+     * Can be called with a single queue name or multiple queue names
+     * Also deletes associated retry and DLQ queues if they exist
+     *
+     * @param queueNames - Single queue name (string) or array of queue names
+     * @param options - Delete options (includeRetry, includeDLQ)
+     *
+     * @example
+     * // Delete a single queue
+     * await consumer.deleteQueues('orders');
+     *
+     * @example
+     * // Delete multiple queues
+     * await consumer.deleteQueues(['orders', 'payments', 'notifications']);
+     *
+     * @example
+     * // Delete queue without retry/DLQ queues
+     * await consumer.deleteQueues('orders', {
+     *   includeRetry: false,
+     *   includeDLQ: false
+     * });
      */
-    private setupRetryAndDLQQueues;
+    deleteQueues(queueNames: string | string[], options?: {
+        /** Whether to delete associated retry queue (default: true) */
+        includeRetry?: boolean;
+        /** Whether to delete associated DLQ (default: true) */
+        includeDLQ?: boolean;
+    }): Promise<void>;
+    /**
+     * Setup Dead Letter Queue (DLQ) infrastructure for a queue with retry mechanism
+     */
+    private setupDLQInfrastructure;
     /**
      * Bind a queue to an exchange with a routing key (Best Practice for Consumers)
      * Consumers decide which exchanges/routing keys they want to subscribe to
@@ -118,6 +153,43 @@ declare class RabbitMQConsumer extends EventEmitter {
         exchangeType?: 'direct' | 'topic' | 'fanout' | 'headers';
         durable?: boolean;
     }): Promise<void>;
+    /**
+     * Setup a complete queue with exchange and bindings in ONE atomic operation
+     * This is the RECOMMENDED method to prevent race conditions
+     *
+     * All operations (exchange, queue, bindings) happen in a single setup callback,
+     * guaranteeing correct order of execution.
+     *
+     * @param config - Queue setup configuration
+     *
+     * @example
+     * await consumer.setupQueue({
+     *   queueName: 'orders-processor',
+     *   exchangeName: 'orders',
+     *   exchangeType: 'topic',
+     *   routingKeys: ['order.created', 'order.updated'],
+     *   retryConfig: { maxRetries: 3, retryDelayMs: 5000 }
+     * });
+     *
+     * @example
+     * // Setup multiple queues
+     * await consumer.setupQueue({
+     *   queueName: 'fiat.account.create',
+     *   exchangeName: 'user-accounts',
+     *   exchangeType: 'topic',
+     *   routingKeys: ['account.fiat.create', 'account.create']
+     * });
+     */
+    setupQueue(config: {
+        queueName: string;
+        exchangeName: string;
+        exchangeType: 'direct' | 'topic' | 'fanout' | 'headers';
+        routingKeys: string | string[];
+        durable?: boolean;
+        exclusive?: boolean;
+        autoDelete?: boolean;
+        retryConfig?: RetryConfig;
+    }): Promise<void>;
     /**
      * List of error codes that are considered retryable (transient errors)
      * These errors indicate temporary failures that may succeed on retry
@@ -139,10 +211,61 @@ declare class RabbitMQConsumer extends EventEmitter {
     private calculateRetryDelay;
     /**
      * Consume messages from a queue with automatic retry and DLQ handling
+     *
+     * Note: Queue should be set up separately before consuming:
+     * - Use assertQueues() to create queue with exchange binding
+     * - Use setupQueue() for complete setup with multiple routing keys
+     * - Use bindQueue() to add additional routing key bindings
+     *
+     * @example
+     * // Step 1: Setup queue with exchange and routing keys
+     * await consumer.setupQueue({
+     *   queueName: 'orders',
+     *   exchangeName: 'orders',
+     *   exchangeType: 'topic',
+     *   routingKeys: ['order.created', 'order.updated'],
+     *   retryConfig: { maxRetries: 5 }
+     * });
+     *
+     * // Step 2: Consume (queue already set up)
+     * await consumer.consumeQueue({
+     *   queueName: 'orders',
+     *   onMessage: async (message) => {
+     *     await processOrder(message);
+     *   }
+     * });
+     *
+     * @example
+     * // Direct queue consumption (no exchange)
+     * await consumer.assertQueues('simple-queue');
+     * await consumer.consumeQueue({
+     *   queueName: 'simple-queue',
+     *   onMessage: async (message) => { ... }
+     * });
      */
     consumeQueue<T = any>(config: ConsumeConfig<T>): Promise<void>;
     /**
      * Consume from multiple queues with the same connection
+     * Note: Queues should be set up separately before consuming
+     *
+     * @example
+     * // Setup queues first
+     * await consumer.setupQueue({ queueName: 'orders', ... });
+     * await consumer.setupQueue({ queueName: 'payments', ... });
+     *
+     * // Then consume from all
+     * await consumer.consumeMultipleQueues({
+     *   queues: [
+     *     {
+     *       queueName: 'orders',
+     *       onMessage: async (msg) => { ... }
+     *     },
+     *     {
+     *       queueName: 'payments',
+     *       onMessage: async (msg) => { ... }
+     *     }
+     *   ]
+     * });
      */
     consumeMultipleQueues<T = any>(config: MultiQueueConsumeConfig<T>): Promise<void>;
     /**

package/dist/consumerMq.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consumerMq.d.ts","sourceRoot":"","sources":["../consumerMq.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"consumerMq.d.ts","sourceRoot":"","sources":["../consumerMq.ts"],"names":[],"mappings":"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"}