@zetra/citrineos-util 1.8.3-fork.1

package/dist/queue/rabbit-mq/receiver.js

@@ -0,0 +1,472 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+import { AbstractMessageHandler, CacheNamespace, CircuitBreaker, Message, RetryMessageError, } from '@citrineos/base';
+import * as amqplib from 'amqplib';
+import { Logger } from 'tslog';
+import { MemoryCache } from '../../index.js';
+/**
+ * Implementation of a {@link IMessageHandler} using RabbitMQ as the underlying transport.
+ */
+export class RabbitMqReceiver extends AbstractMessageHandler {
+    /**
+     * Constants
+     */
+    static QUEUE_PREFIX = 'rabbit_queue_';
+    static CACHE_PREFIX = 'rabbit_subscription_';
+    static METADATA_PREFIX = 'rabbit_subscription_metadata_';
+    static REGISTRY_KEY = 'rabbit_subscription_registry';
+    static RECONNECT_DELAY = 5000;
+    /**
+     * Fields
+     */
+    _cache;
+    _connection;
+    _channel;
+    _abortReconnectController;
+    _circuitBreaker;
+    _reconnectInterval;
+    constructor(config, logger, module, cache, circuitBreaker) {
+        super(config, logger, module);
+        this._cache = cache || new MemoryCache();
+        this._circuitBreaker = circuitBreaker ?? new CircuitBreaker();
+        this._circuitBreaker.onStateChange(this._onCircuitBreakerStateChange.bind(this));
+    }
+    async initConnection() {
+        if (this._circuitBreaker.state === 'CLOSED') {
+            throw new Error('Circuit breaker is CLOSED. Cannot initialize RabbitMQ connection.');
+        }
+        this._abortReconnectController = new AbortController();
+        this._channel = await this._connectWithRetry(this._abortReconnectController.signal);
+    }
+    /**
+     * Methods
+     */
+    /**
+     * Binds queue to an exchange given identifier and optional actions and filter.
+     * Note: Due to the nature of AMQP 0-9-1 model, if you need to filter for the identifier, you **MUST** provide it in the filter object.
+     *
+     * @param {string} identifier - The identifier of the channel to subscribe to.
+     * @param {CallAction[]} actions - Optional. An array of actions to filter the messages.
+     * @param {{ [k: string]: string; }} filter - Optional. An object representing the filter to apply on the messages.
+     * @return {Promise<boolean>} A promise that resolves to true if the subscription is successful, false otherwise.
+     */
+    async subscribe(identifier, actions, filter) {
+        // If actions are a defined but empty list, it is likely a module
+        // with no available actions and should not have a queue.
+        //
+        // If actions are undefined, it is likely a charger,
+        // which is "allowed" not to have actions.
+        if (actions && actions.length === 0) {
+            this._logger.debug(`Skipping queue binding for module ${identifier} as there are no available actions.`);
+            return true;
+        }
+        const exchange = this._config.util.messageBroker.amqp?.exchange;
+        const queueName = `${RabbitMqReceiver.QUEUE_PREFIX}${identifier}`;
+        // Ensure that filter includes the x-match header set to all
+        filter = filter
+            ? {
+                'x-match': 'all',
+                ...filter,
+            }
+            : { 'x-match': 'all' };
+        if (!this._channel) {
+            throw new Error('RabbitMQ is down: cannot subscribe.');
+        }
+        const channel = this._channel;
+        // Assert exchange and queue
+        await channel.assertExchange(exchange, 'headers', { durable: false });
+        await channel.assertQueue(queueName, {
+            durable: false,
+            autoDelete: true,
+            exclusive: false,
+        });
+        // Bind queue based on provided actions and filters
+        if (actions && actions.length > 0) {
+            for (const action of actions) {
+                this._logger.debug(`Bind ${queueName} on ${exchange} for ${action} with filter ${JSON.stringify(filter)}.`);
+                await channel.bindQueue(queueName, exchange, '', { action, ...filter });
+                this._logger.info(`Queue ${queueName} bound to exchange ${exchange} for action ${action} with filter ${JSON.stringify(filter)}.`);
+            }
+        }
+        else {
+            this._logger.debug(`Bind ${queueName} on ${exchange} with filter ${JSON.stringify(filter)}.`);
+            await channel.bindQueue(queueName, exchange, '', filter);
+            this._logger.info(`Queue ${queueName} bound to exchange ${exchange} with filter ${JSON.stringify(filter)}.`);
+        }
+        // Start consuming messages
+        await channel.consume(queueName, (msg) => this._onMessage(msg, channel));
+        // Define cache keys
+        const cacheKey = `${RabbitMqReceiver.CACHE_PREFIX}${identifier}`;
+        const metadataKey = `${RabbitMqReceiver.METADATA_PREFIX}${identifier}`;
+        // Retrieve cached queue names
+        const cachedQueues = await this._cache
+            .get(cacheKey, CacheNamespace.Other, () => Array)
+            .then((value) => {
+            if (value) {
+                value.push(queueName);
+                return value;
+            }
+            return new Array(queueName);
+        });
+        // Add queue name to cache
+        await this._cache.set(cacheKey, JSON.stringify(cachedQueues), CacheNamespace.Other);
+        // Store subscription metadata for re-subscription after reconnect
+        const subscriptionMetadata = {
+            identifier,
+            actions,
+            filter,
+        };
+        await this._cache.set(metadataKey, JSON.stringify(subscriptionMetadata), CacheNamespace.Other);
+        // Add identifier to registry (list of all active subscriptions)
+        const registry = await this._cache
+            .get(RabbitMqReceiver.REGISTRY_KEY, CacheNamespace.Other, () => Array)
+            .then((value) => {
+            if (value && !value.includes(identifier)) {
+                value.push(identifier);
+                return value;
+            }
+            else if (!value) {
+                return new Array(identifier);
+            }
+            return value; // Already in registry
+        });
+        await this._cache.set(RabbitMqReceiver.REGISTRY_KEY, JSON.stringify(registry), CacheNamespace.Other);
+        return true;
+    }
+    unsubscribe(identifier) {
+        const cacheKey = `${RabbitMqReceiver.CACHE_PREFIX}${identifier}`;
+        const metadataKey = `${RabbitMqReceiver.METADATA_PREFIX}${identifier}`;
+        return this._cache
+            .get(cacheKey, CacheNamespace.Other, () => Array)
+            .then(async (queues) => {
+            if (queues) {
+                if (!this._channel) {
+                    throw new Error('RabbitMQ is down: cannot unsubscribe.');
+                }
+                const channel = this._channel;
+                this._channel = channel;
+                for (const queue of queues) {
+                    await channel.unbindQueue(queue, this._config.util.messageBroker.amqp?.exchange || '', '');
+                    const messageCount = await this._channel?.deleteQueue(queue);
+                    this._logger.info(`Queue ${identifier} deleted with ${messageCount?.messageCount} messages remaining.`);
+                }
+                // Remove the cache entries after successfully deleting all queues
+                await this._cache.remove(cacheKey, CacheNamespace.Other);
+                await this._cache.remove(metadataKey, CacheNamespace.Other);
+                // Remove identifier from registry
+                const registry = await this._cache.get(RabbitMqReceiver.REGISTRY_KEY, CacheNamespace.Other, () => Array);
+                if (registry) {
+                    const updatedRegistry = registry.filter((id) => id !== identifier);
+                    if (updatedRegistry.length === 0) {
+                        await this._cache.remove(RabbitMqReceiver.REGISTRY_KEY, CacheNamespace.Other);
+                    }
+                    else {
+                        await this._cache.set(RabbitMqReceiver.REGISTRY_KEY, JSON.stringify(updatedRegistry), CacheNamespace.Other);
+                    }
+                }
+                return true;
+            }
+            else {
+                this._logger.warn(`Failed to delete queue for ${identifier}, queue name not found in cache.`);
+                return false;
+            }
+        });
+    }
+    shutdown() {
+        this._abortReconnectController?.abort();
+        return Promise.resolve();
+    }
+    /**
+     * Protected Methods
+     */
+    /**
+     * Connect to RabbitMQ with retry logic.
+     * This method will keep trying to connect until successful, unless aborted.
+     *
+     * @param {AbortSignal} [abortSignal] - Optional abort signal to stop retrying.
+     * @return {Promise<amqplib.Channel>} A promise that resolves to the AMQP channel.
+     */
+    async _connectWithRetry(abortSignal) {
+        const url = this._config.util.messageBroker.amqp?.url;
+        if (!url) {
+            throw new Error('RabbitMQ URL is not configured');
+        }
+        while (true) {
+            if (abortSignal?.aborted) {
+                this._logger.warn('RabbitMQ reconnect aborted by signal.');
+                throw new Error('RabbitMQ reconnect aborted');
+            }
+            if (this._circuitBreaker.state === 'CLOSED') {
+                throw new Error('Circuit breaker is CLOSED. Cannot connect to RabbitMQ.');
+            }
+            try {
+                const connection = await amqplib.connect(url, { heartbeat: 10 });
+                this._connection = connection;
+                const channel = await connection.createChannel();
+                const exchange = this._config.util.messageBroker.amqp?.exchange;
+                if (exchange) {
+                    await channel.assertExchange(exchange, 'headers', { durable: false });
+                }
+                channel.on('error', (err) => {
+                    this._logger.error('AMQP channel error', err);
+                });
+                this._setupConnectionListeners();
+                this._circuitBreaker.triggerSuccess();
+                // Re-subscribe to all cached subscriptions after successful reconnection
+                await this._resubscribeAll();
+                return channel;
+            }
+            catch (err) {
+                this._logger.error('RabbitMQ connect failed, triggering circuit breaker failure', err);
+                this._circuitBreaker.triggerFailure(err?.message);
+                // Wait for circuit breaker to allow retry (exponential backoff handled by circuit breaker)
+                await new Promise((res) => setTimeout(res, 1000));
+            }
+        }
+    }
+    _startReconnectInterval() {
+        if (this._reconnectInterval) {
+            clearInterval(this._reconnectInterval);
+        }
+        const delay = (this._config.maxReconnectDelay || 30) * 1000;
+        this._logger.warn(`Starting continuous reconnect attempts every ${delay / 1000} seconds while circuit breaker is CLOSED.`);
+        this._reconnectInterval = setInterval(() => {
+            this._logger.info('Attempting RabbitMQ reconnect due to circuit breaker CLOSED...');
+            this._connectWithRetry()
+                .then((channel) => {
+                this._logger.info('RabbitMQ reconnect attempt succeeded.');
+                this._channel = channel;
+                this._circuitBreaker.triggerSuccess();
+            })
+                .catch((err) => {
+                this._logger.error('RabbitMQ reconnect attempt failed.', err);
+            });
+        }, delay);
+    }
+    _onCircuitBreakerStateChange(state, reason) {
+        this._logger.info(`[CircuitBreaker] State changed to ${state}${reason ? `: ${reason}` : ''}`);
+        switch (state) {
+            case 'CLOSED': {
+                this._logger.error('Circuit breaker CLOSED: shutting down RabbitMQ receiver. Reason:', reason);
+                void this.shutdown();
+                if (this._reconnectInterval) {
+                    this._logger.info('Clearing reconnect interval as circuit breaker is now CLOSED.');
+                    clearInterval(this._reconnectInterval);
+                    this._reconnectInterval = undefined;
+                }
+                break;
+            }
+            case 'OPEN': {
+                this._logger.info('Circuit breaker is OPEN. Will attempt to (re)initialize RabbitMQ connection.');
+                if (this._reconnectInterval) {
+                    this._logger.info('Clearing reconnect interval as circuit breaker is now OPEN.');
+                    clearInterval(this._reconnectInterval);
+                    this._reconnectInterval = undefined;
+                }
+                this._connectWithRetry()
+                    .then((channel) => {
+                    this._logger.info('RabbitMQ connection (re)initialized.');
+                    this._channel = channel;
+                    this._circuitBreaker.triggerSuccess();
+                })
+                    .catch((err) => {
+                    this._logger.error('RabbitMQ (re)init failed.', err);
+                });
+                break;
+            }
+            case 'FAILING': {
+                this._logger.warn('Circuit breaker is FAILING. RabbitMQ receiver will not receive messages until recovery. Reason:', reason);
+                this._logger.info('Attempting to start reconnect interval after circuit breaker FAILING.');
+                this._startReconnectInterval();
+                break;
+            }
+            default:
+                this._logger.warn('Unknown circuit breaker state:', state);
+                break;
+        }
+    }
+    /**
+     * Setup listeners for connection and channel events.
+     * This will handle disconnections and errors.
+     * Ensures listeners are not attached multiple times to the same connection.
+     */
+    _setupConnectionListeners() {
+        if (this._connection) {
+            // Only attach listeners if not already attached to this connection
+            if (this._connection._listenersAttached)
+                return;
+            this._connection.removeAllListeners('close');
+            this._connection.removeAllListeners('error');
+            this._connection.on('close', () => this._handleDisconnect());
+            this._connection.on('error', () => this._handleDisconnect());
+            this._connection._listenersAttached = true;
+        }
+    }
+    /**
+     * Handle RabbitMQ disconnection.
+     * This method will attempt to reconnect to RabbitMQ when the connection is lost.
+     * Debounces concurrent reconnects.
+     */
+    async _handleDisconnect() {
+        this._logger.warn('RabbitMQ connection lost. Triggering circuit breaker failure.');
+        this._connection = undefined;
+        this._channel = undefined;
+        this._circuitBreaker.triggerFailure('RabbitMQ connection lost');
+        if (this._circuitBreaker.state === 'CLOSED') {
+            this._startReconnectInterval();
+        }
+        if (this._circuitBreaker.state === 'FAILING') {
+            this._logger.warn('Circuit breaker is FAILING. RabbitMQ receiver will not receive messages until recovery.');
+            this._startReconnectInterval();
+        }
+    }
+    /**
+     * Re-subscribe to all cached subscriptions after reconnection.
+     * This ensures queues are recreated with the same bindings.
+     * Uses cache to retrieve subscription metadata.
+     */
+    async _resubscribeAll() {
+        if (!this._channel) {
+            this._logger.warn('Cannot re-subscribe: channel not available.');
+            return;
+        }
+        try {
+            // Get registry of all active subscription identifiers
+            const registry = await this._cache.get(RabbitMqReceiver.REGISTRY_KEY, CacheNamespace.Other, () => Array);
+            if (!registry || registry.length === 0) {
+                this._logger.debug('No active subscriptions found in cache to re-subscribe.');
+                return;
+            }
+            this._logger.info(`Re-subscribing ${registry.length} active subscription(s) after RabbitMQ reconnection.`);
+            // Re-subscribe to all subscriptions in registry
+            const resubscribePromises = [];
+            for (const identifier of registry) {
+                // Get subscription metadata from cache
+                const metadataKey = `${RabbitMqReceiver.METADATA_PREFIX}${identifier}`;
+                const metadataJson = await this._cache.get(metadataKey, CacheNamespace.Other);
+                if (!metadataJson) {
+                    this._logger.warn(`Subscription metadata not found for ${identifier}, skipping re-subscription.`);
+                    continue;
+                }
+                try {
+                    // Parse the JSON metadata to ensure proper deserialization
+                    const metadata = JSON.parse(metadataJson);
+                    // Validate metadata structure
+                    if (!metadata.identifier || metadata.identifier !== identifier) {
+                        this._logger.warn(`Subscription metadata identifier mismatch for ${identifier}, skipping re-subscription.`);
+                        continue;
+                    }
+                    this._logger.debug(`Re-subscribing identifier: ${identifier} with actions: ${JSON.stringify(metadata.actions)} and filter: ${JSON.stringify(metadata.filter)}`);
+                    resubscribePromises.push(this._resubscribe(identifier, metadata.actions, metadata.filter).catch((error) => {
+                        this._logger.error(`Failed to re-subscribe ${identifier}:`, error);
+                        return false;
+                    }));
+                }
+                catch (parseError) {
+                    this._logger.error(`Failed to parse subscription metadata for ${identifier}:`, parseError, metadataJson);
+                }
+            }
+            const results = await Promise.all(resubscribePromises);
+            const successCount = results.filter((r) => r === true).length;
+            this._logger.info(`Re-subscription complete: ${successCount}/${registry.length} subscriptions recreated successfully.`);
+        }
+        catch (error) {
+            this._logger.error('Error during re-subscription:', error);
+        }
+    }
+    /**
+     * Internal method to re-subscribe without the channel check.
+     * Used during reconnection to recreate queues.
+     */
+    async _resubscribe(identifier, actions, filter) {
+        // If actions are a defined but empty list, skip (modules with no actions shouldn't have queues)
+        if (actions && actions.length === 0) {
+            this._logger.debug(`Skipping re-subscription for ${identifier}: actions array is empty.`);
+            return true;
+        }
+        // Log warning if actions is undefined for module subscriptions (should have actions)
+        // Router subscriptions (like "1_cp001") can have undefined actions, but module subscriptions should have them
+        if ((!actions && identifier.includes('_requests')) || identifier.includes('_responses')) {
+            this._logger.warn(`Re-subscribing module subscription ${identifier} without actions filter - this may cause messages to be routed incorrectly!`);
+        }
+        const exchange = this._config.util.messageBroker.amqp?.exchange;
+        const queueName = `${RabbitMqReceiver.QUEUE_PREFIX}${identifier}_${Date.now()}`;
+        // Ensure that filter includes the x-match header set to all
+        filter = filter
+            ? {
+                'x-match': 'all',
+                ...filter,
+            }
+            : { 'x-match': 'all' };
+        if (!this._channel) {
+            throw new Error('RabbitMQ is down: cannot re-subscribe.');
+        }
+        const channel = this._channel;
+        // Assert exchange and queue
+        await channel.assertExchange(exchange, 'headers', { durable: false });
+        await channel.assertQueue(queueName, {
+            durable: false,
+            autoDelete: true,
+            exclusive: false,
+        });
+        // Bind queue based on provided actions and filters
+        if (actions && actions.length > 0) {
+            for (const action of actions) {
+                this._logger.debug(`Re-bind ${queueName} on ${exchange} for ${action} with filter ${JSON.stringify(filter)}.`);
+                await channel.bindQueue(queueName, exchange, '', { action, ...filter });
+            }
+        }
+        else {
+            this._logger.debug(`Re-bind ${queueName} on ${exchange} with filter ${JSON.stringify(filter)}.`);
+            await channel.bindQueue(queueName, exchange, '', filter);
+        }
+        // Start consuming messages
+        await channel.consume(queueName, (msg) => this._onMessage(msg, channel));
+        // Update cache with new queue name
+        const cacheKey = `${RabbitMqReceiver.CACHE_PREFIX}${identifier}`;
+        const cachedQueues = await this._cache
+            .get(cacheKey, CacheNamespace.Other, () => Array)
+            .then((value) => {
+            if (value) {
+                value.push(queueName);
+                return value;
+            }
+            return new Array(queueName);
+        });
+        await this._cache.set(cacheKey, JSON.stringify(cachedQueues), CacheNamespace.Other);
+        this._logger.debug(`Successfully re-subscribed ${identifier} with queue ${queueName}`);
+        return true;
+    }
+    /**
+     * Underlying RabbitMQ message handler.
+     *
+     * @param message The AMQPMessage to process
+     * @param channel
+     */
+    async _onMessage(message, channel) {
+        if (message) {
+            try {
+                this._logger.debug('_onMessage:Received message:', message.properties, message.content.toString());
+                const messageData = JSON.parse(message.content.toString());
+                // Create Message instance with generic payload (no type transformation needed)
+                const parsed = new Message(messageData.origin || messageData._origin, messageData.eventGroup || messageData._eventGroup, messageData.action || messageData._action, messageData.state || messageData._state, messageData.context || messageData._context, messageData.payload || messageData._payload, // Keep payload as generic object
+                messageData.protocol || messageData._protocol);
+                await this.handle(parsed, message.properties);
+            }
+            catch (error) {
+                if (error instanceof RetryMessageError) {
+                    this._logger.warn('Retrying message: ', error.message);
+                    // Retryable error, usually ongoing call with station when trying to send new call
+                    channel.nack(message);
+                    return;
+                }
+                else {
+                    this._logger.error('Error while processing message:', error, message);
+                }
+            }
+            channel.ack(message);
+        }
+    }
+}
+//# sourceMappingURL=receiver.js.map

package/dist/queue/rabbit-mq/receiver.js.map

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

package/dist/queue/rabbit-mq/sender.d.ts

@@ -0,0 +1,90 @@
+import type { IMessage, IMessageConfirmation, IMessageSender, OcppRequest, OcppResponse, SystemConfig } from '@citrineos/base';
+import { AbstractMessageSender, CircuitBreaker, MessageState, OcppError } from '@citrineos/base';
+import * as amqplib from 'amqplib';
+import type { ILogObj } from 'tslog';
+import { Logger } from 'tslog';
+/**
+ * Implementation of a {@link IMessageSender} using RabbitMQ as the underlying transport.
+ */
+export declare class RabbitMqSender extends AbstractMessageSender implements IMessageSender {
+    /**
+     * Constants
+     */
+    private static readonly QUEUE_PREFIX;
+    private static readonly RECONNECT_DELAY;
+    /**
+     * Fields
+     */
+    protected _connection?: amqplib.Connection;
+    protected _channel?: amqplib.Channel;
+    private _reconnecting;
+    private _abortReconnectController?;
+    private _circuitBreaker;
+    private _reconnectInterval?;
+    /**
+     * Constructor for the class.
+     *
+     * @param {SystemConfig} config - The system configuration.
+     * @param {Logger<ILogObj>} [logger] - The logger object.
+     */
+    constructor(config: SystemConfig, logger?: Logger<ILogObj>, circuitBreaker?: CircuitBreaker);
+    /**
+     * Methods
+     */
+    /**
+     * Sends a request message with an optional payload and returns a promise that resolves to the confirmation message.
+     *
+     * @param {IMessage<OcppRequest>} message - The message to be sent.
+     * @param {OcppRequest | undefined} payload - The optional payload to be sent with the message.
+     * @return {Promise<IMessageConfirmation>} A promise that resolves to the confirmation message.
+     */
+    sendRequest(message: IMessage<OcppRequest>, payload?: OcppRequest | undefined): Promise<IMessageConfirmation>;
+    /**
+     * Sends a response message and returns a promise of the message confirmation.
+     *
+     * @param {IMessage<OcppResponse | OcppError>} message - The message to send.
+     * @param {OcppResponse | OcppError} payload - The payload to include in the response.
+     * @return {Promise<IMessageConfirmation>} - A promise that resolves to the message confirmation.
+     */
+    sendResponse(message: IMessage<OcppResponse | OcppError>, payload?: OcppResponse | OcppError): Promise<IMessageConfirmation>;
+    /**
+     * Sends a message and returns a promise that resolves to a message confirmation.
+     *
+     * @param {IMessage<OcppRequest | OcppResponse | OcppError>} message - The message to be sent.
+     * @param {OcppRequest | OcppResponse | OcppError} [payload] - The payload to be included in the message.
+     * @param {MessageState} [state] - The state of the message.
+     * @return {Promise<IMessageConfirmation>} - A promise that resolves to a message confirmation.
+     */
+    send(message: IMessage<OcppRequest | OcppResponse | OcppError>, payload?: OcppRequest | OcppResponse | OcppError, state?: MessageState): Promise<IMessageConfirmation>;
+    /**
+     * Shuts down the sender by closing the client.
+     *
+     * @return {Promise<void>} A promise that resolves when the client is closed.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Protected Methods
+     */
+    /**
+     * Connect to RabbitMQ with retry logic.
+     * This method will keep trying to connect until successful, unless aborted.
+     *
+     * @param {AbortSignal} [abortSignal] - Optional abort signal to stop retrying.
+     * @return {Promise<amqplib.Channel>} A promise that resolves to the AMQP channel.
+     */
+    protected _connectWithRetry(abortSignal?: AbortSignal): Promise<amqplib.Channel>;
+    private _startReconnectInterval;
+    private _onCircuitBreakerStateChange;
+    /**
+     * Setup listeners for connection and channel events.
+     * This will handle disconnections and errors.
+     * Ensures listeners are not attached multiple times to the same connection.
+     */
+    private _setupConnectionListeners;
+    /**
+     * Handle RabbitMQ disconnection.
+     * This method will attempt to reconnect to RabbitMQ when the connection is lost.
+     * Debounces concurrent reconnects.
+     */
+    private _handleDisconnect;
+}