rabbitmq-sdk 0.0.1-security → 1.2.0

package/dist/components/MessagePublisher.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagePublisher = void 0;
+const IErrors_1 = require("../interfaces/IErrors");
+const Logger_1 = require("./Logger");
+/**
+ * MessagePublisher handles message publishing to RabbitMQ exchanges
+ * Implements parameter validation, JSON serialization, and automatic exchange creation
+ */
+class MessagePublisher {
+    constructor(connectionManager, resourceCreator, config) {
+        this.connectionManager = connectionManager;
+        this.resourceCreator = resourceCreator;
+        this.logger = Logger_1.Logger.createComponentLogger('MessagePublisher', config);
+    }
+    /**
+     * Publish a message to an exchange
+     * @param exchange Exchange name (required)
+     * @param routingKey Routing key for message routing (required)
+     * @param payload Message payload to be JSON serialized (required)
+     * @returns Promise<boolean> - true for success, false for failure
+     */
+    async publish(exchange, routingKey, payload) {
+        // Parameter validation - all parameters are required
+        this.validatePublishParameters(exchange, routingKey, payload);
+        try {
+            // JSON serialization for all payloads
+            const serializedPayload = this.serializePayload(payload);
+            // Automatic exchange creation before publishing
+            await this.ensureExchangeExists(exchange);
+            return await this.connectionManager.executeOperation(async () => {
+                const connection = this.connectionManager.getConnection();
+                if (!connection) {
+                    throw new IErrors_1.PublishError('No active connection to RabbitMQ', {
+                        exchange,
+                        routingKey,
+                        payload: typeof payload
+                    });
+                }
+                const channel = await connection.createChannel();
+                try {
+                    // Publish message with JSON content type
+                    const published = channel.publish(exchange, routingKey, Buffer.from(serializedPayload), {
+                        contentType: 'application/json',
+                        timestamp: Date.now(),
+                        persistent: true // Make messages persistent by default
+                    });
+                    await channel.close();
+                    // Log successful publish
+                    this.logger.logOperation('publish', `Message published successfully`, {
+                        exchange,
+                        routingKey,
+                        payloadType: typeof payload,
+                        payloadSize: serializedPayload.length
+                    });
+                    return published;
+                }
+                catch (error) {
+                    await channel.close();
+                    throw error;
+                }
+            });
+        }
+        catch (error) {
+            // Detailed error logging with context
+            this.logPublishError(error, exchange, routingKey, payload);
+            // Return false for failure as per requirements
+            return false;
+        }
+    }
+    /**
+     * Validate publish method parameters
+     * @param exchange Exchange name
+     * @param routingKey Routing key
+     * @param payload Message payload
+     */
+    validatePublishParameters(exchange, routingKey, payload) {
+        if (!exchange || typeof exchange !== 'string') {
+            throw new IErrors_1.PublishError('Exchange parameter is required and must be a non-empty string', {
+                exchange,
+                routingKey,
+                payload: typeof payload
+            });
+        }
+        if (!routingKey || typeof routingKey !== 'string') {
+            throw new IErrors_1.PublishError('RoutingKey parameter is required and must be a non-empty string', {
+                exchange,
+                routingKey,
+                payload: typeof payload
+            });
+        }
+        if (payload === undefined || payload === null) {
+            throw new IErrors_1.PublishError('Payload parameter is required and cannot be null or undefined', {
+                exchange,
+                routingKey,
+                payload
+            });
+        }
+    }
+    /**
+     * Serialize payload to JSON string
+     * @param payload Payload to serialize
+     * @returns JSON string representation
+     */
+    serializePayload(payload) {
+        try {
+            return JSON.stringify(payload);
+        }
+        catch (error) {
+            throw new IErrors_1.PublishError('Failed to serialize payload to JSON', {
+                payload: typeof payload,
+                error: error instanceof Error ? error.message : 'Unknown serialization error'
+            });
+        }
+    }
+    /**
+     * Ensure exchange exists before publishing
+     * @param exchange Exchange name
+     */
+    async ensureExchangeExists(exchange) {
+        try {
+            // Use ResourceCreator to automatically create exchange if it doesn't exist
+            // Always use topic type by default
+            await this.resourceCreator.ensureExchange(exchange, 'topic');
+        }
+        catch (error) {
+            throw new IErrors_1.PublishError(`Failed to ensure exchange '${exchange}' exists`, {
+                exchange,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+    /**
+     * Log publish errors with detailed context
+     * @param error The error that occurred
+     * @param exchange Exchange name
+     * @param routingKey Routing key
+     * @param payload Original payload
+     */
+    logPublishError(error, exchange, routingKey, payload) {
+        let payloadSize = 0;
+        try {
+            payloadSize = JSON.stringify(payload).length;
+        }
+        catch {
+            payloadSize = -1; // Indicate serialization failed
+        }
+        this.logger.logError('Message publish failed', error, {
+            exchange,
+            routingKey,
+            payloadType: typeof payload,
+            payloadSize,
+            operation: 'publish'
+        });
+    }
+}
+exports.MessagePublisher = MessagePublisher;
+//# sourceMappingURL=MessagePublisher.js.map

package/dist/components/MessagePublisher.js.map

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

package/dist/components/MessageSubscriber.d.ts

@@ -0,0 +1,108 @@
+import { IMessageSubscriber, MessageCallback } from '../interfaces/IMessage';
+import { ConnectionManager } from './ConnectionManager';
+import { ResourceCreator } from './ResourceCreator';
+import { DLQHandler } from './DLQHandler';
+import { IConfiguration } from '../interfaces/IConfiguration';
+/**
+ * MessageSubscriber handles message consumption from RabbitMQ queues
+ * Implements parameter validation, JSON deserialization, automatic resource creation, and DLQ handling
+ */
+export declare class MessageSubscriber implements IMessageSubscriber {
+    private connectionManager;
+    private resourceCreator;
+    private dlqHandler;
+    private activeConsumers;
+    private logger;
+    constructor(connectionManager: ConnectionManager, resourceCreator: ResourceCreator, dlqHandler: DLQHandler, config?: IConfiguration['logging']);
+    /**
+     * Subscribe to messages from a queue
+     * @param exchange Exchange name (required)
+     * @param queue Queue name (required)
+     * @param routingKey Routing key for binding (required)
+     * @param callback Message callback function (required)
+     */
+    subscribe(exchange: string, queue: string, routingKey: string, callback: MessageCallback): Promise<void>;
+    /**
+     * Unsubscribe from a queue
+     * @param queue Queue name to unsubscribe from
+     */
+    unsubscribe(queue: string): Promise<void>;
+    /**
+     * Handle incoming message
+     * @param message RabbitMQ message
+     * @param callback User callback function
+     * @param channel Channel for acknowledgment
+     */
+    private handleMessage;
+    /**
+     * Validate subscribe method parameters
+     * @param exchange Exchange name
+     * @param queue Queue name
+     * @param routingKey Routing key
+     * @param callback Message callback function
+     */
+    private validateSubscribeParameters;
+    /**
+     * Deserialize message content from JSON
+     * @param message RabbitMQ message
+     * @returns Deserialized payload
+     */
+    private deserializeMessage;
+    /**
+     * Ensure exchange, queue, and binding exist before subscribing
+     * @param exchange Exchange name
+     * @param queue Queue name
+     * @param routingKey Routing key for binding
+     */
+    private ensureResourcesExist;
+    /**
+     * Log subscription errors with detailed context
+     * @param error The error that occurred
+     * @param exchange Exchange name
+     * @param queue Queue name
+     * @param routingKey Routing key
+     */
+    private logSubscriptionError;
+    /**
+     * Get active consumer information for monitoring
+     */
+    getActiveConsumers(): string[];
+    /**
+     * Handle failed message by routing to DLQ or acknowledging based on configuration
+     * @param message Failed RabbitMQ message
+     * @param queueName Original queue name
+     * @param channel Channel for acknowledgment
+     */
+    private handleFailedMessage;
+    /**
+     * Get retry count from message headers
+     * @param message RabbitMQ message
+     * @returns Current retry count
+     */
+    private getRetryCount;
+    /**
+     * Requeue message with incremented retry count
+     * @param message Original message
+     * @param channel Channel for operations
+     * @param retryCount New retry count
+     */
+    private requeueWithRetryCount;
+    /**
+     * Republish message with updated retry count
+     * @param message Original message
+     * @param channel Channel for operations
+     * @param retryCount New retry count
+     */
+    private republishWithRetryCount;
+    /**
+     * Extract queue name from message (fallback to routing key if not available)
+     * @param message RabbitMQ message
+     * @returns Queue name
+     */
+    private getQueueNameFromMessage;
+    /**
+     * Cleanup all active consumers (useful for shutdown)
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=MessageSubscriber.d.ts.map

package/dist/components/MessageSubscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageSubscriber.d.ts","sourceRoot":"","sources":["../../src/components/MessageSubscriber.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAqE;IAC5F,OAAO,CAAC,MAAM,CAAS;gBAEX,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC;IAO9I;;;;;;OAMG;IACU,SAAS,CACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC;IAoGhB;;;OAGG;IACU,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCtD;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IA2FrB;;;;;;OAMG;IACH,OAAO,CAAC,2BAA2B;IAwCnC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;;OAKG;YACW,oBAAoB;IA0BlC;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACI,kBAAkB,IAAI,MAAM,EAAE;IAIrC;;;;;OAKG;YACW,mBAAmB;IAoDjC;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAQrB;;;;;OAKG;YACW,qBAAqB;IA4CnC;;;;;OAKG;YACW,uBAAuB;IAmCrC;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAatC"}