@zetra/citrineos-base 1.8.3-fork.1

package/dist/interfaces/messages/index.js

@@ -0,0 +1,53 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+export class RetryMessageError extends Error {
+    constructor(retryReason) {
+        super(retryReason);
+    }
+}
+export var MessageState;
+(function (MessageState) {
+    MessageState[MessageState["Request"] = 1] = "Request";
+    MessageState[MessageState["Response"] = 2] = "Response";
+    MessageState[MessageState["Unknown"] = 99] = "Unknown";
+})(MessageState || (MessageState = {}));
+export var MessageOrigin;
+(function (MessageOrigin) {
+    MessageOrigin["ChargingStationManagementSystem"] = "csms";
+    MessageOrigin["ChargingStation"] = "cs";
+})(MessageOrigin || (MessageOrigin = {}));
+export var EventGroup;
+(function (EventGroup) {
+    EventGroup["All"] = "all";
+    EventGroup["Router"] = "router";
+    EventGroup["Modules"] = "modules";
+    EventGroup["Certificates"] = "certificates";
+    EventGroup["Configuration"] = "configuration";
+    EventGroup["EVDriver"] = "evdriver";
+    EventGroup["Monitoring"] = "monitoring";
+    EventGroup["Reporting"] = "reporting";
+    EventGroup["SmartCharging"] = "smartcharging";
+    EventGroup["Tenant"] = "tenant";
+    EventGroup["Transactions"] = "transactions";
+    EventGroup["Cdrs"] = "cdrs";
+    EventGroup["ChargingProfiles"] = "chargingprofiles";
+    EventGroup["Commands"] = "commands";
+    EventGroup["Locations"] = "locations";
+    EventGroup["Sessions"] = "sessions";
+    EventGroup["Tariffs"] = "tariffs";
+    EventGroup["Tokens"] = "tokens";
+    EventGroup["Versions"] = "versions";
+    EventGroup["Credentials"] = "credentials";
+})(EventGroup || (EventGroup = {}));
+export const eventGroupFromString = (source) => {
+    const eventGroup = source;
+    if (!eventGroup) {
+        throw new Error(`Invalid event group source ${source}"`);
+    }
+    return eventGroup;
+};
+export { AbstractMessageHandler } from './AbstractMessageHandler.js';
+export { AbstractMessageSender } from './AbstractMessageSender.js';
+export { Message } from './Message.js';
+//# sourceMappingURL=index.js.map

package/dist/interfaces/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/messages/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,sCAAsC;AAItC,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,WAAmB;QAC7B,KAAK,CAAC,WAAW,CAAC,CAAC;IACrB,CAAC;CACF;AAED,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,qDAAW,CAAA;IACX,uDAAY,CAAA;IACZ,sDAAY,CAAA;AACd,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAED,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,yDAAwC,CAAA;IACxC,uCAAsB,CAAA;AACxB,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAED,MAAM,CAAN,IAAY,UAqBX;AArBD,WAAY,UAAU;IACpB,yBAAW,CAAA;IACX,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;IACnB,2CAA6B,CAAA;IAC7B,6CAA+B,CAAA;IAC/B,mCAAqB,CAAA;IACrB,uCAAyB,CAAA;IACzB,qCAAuB,CAAA;IACvB,6CAA+B,CAAA;IAC/B,+BAAiB,CAAA;IACjB,2CAA6B,CAAA;IAC7B,2BAAa,CAAA;IACb,mDAAqC,CAAA;IACrC,mCAAqB,CAAA;IACrB,qCAAuB,CAAA;IACvB,mCAAqB,CAAA;IACrB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,mCAAqB,CAAA;IACrB,yCAA2B,CAAA;AAC7B,CAAC,EArBW,UAAU,KAAV,UAAU,QAqBrB;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAc,EAAc,EAAE;IACjE,MAAM,UAAU,GAAe,MAAoB,CAAC;IACpD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,GAAG,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/interfaces/modules/AbstractModule.d.ts

@@ -0,0 +1,149 @@
+import 'reflect-metadata';
+import type { ILogObj } from 'tslog';
+import { Logger } from 'tslog';
+import type { SystemConfig } from '../../config/types.js';
+import type { OcppRequest, OcppResponse } from '../../index.js';
+import type { CallAction, OCPPVersionType } from '../../ocpp/rpc/message.js';
+import { OcppError } from '../../ocpp/rpc/message.js';
+import type { ICache } from '../cache/cache.js';
+import type { HandlerProperties, IMessage, IMessageConfirmation, IMessageHandler, IMessageSender } from '../messages/index.js';
+import { EventGroup, MessageOrigin } from '../messages/index.js';
+import type { IModule } from './index.js';
+import { OCPPValidator } from './OCPPValidator.js';
+export declare abstract class AbstractModule implements IModule {
+    static readonly CALLBACK_URL_CACHE_PREFIX: string;
+    protected _config: SystemConfig;
+    protected _ocppValidator: OCPPValidator;
+    protected readonly _cache: ICache;
+    protected readonly _handler: IMessageHandler;
+    protected readonly _sender: IMessageSender;
+    protected readonly _eventGroup: EventGroup;
+    protected readonly _logger: Logger<ILogObj>;
+    protected _requests: CallAction[];
+    protected _responses: CallAction[];
+    private startTime;
+    constructor(config: SystemConfig, cache: ICache, handler: IMessageHandler, sender: IMessageSender, eventGroup: EventGroup, logger?: Logger<ILogObj>, ocppValidator?: OCPPValidator);
+    /**
+     * Getters & Setters
+     */
+    get ocppValidator(): OCPPValidator;
+    get cache(): ICache;
+    get sender(): IMessageSender;
+    get handler(): IMessageHandler;
+    get config(): SystemConfig;
+    /**
+     * Sets the system configuration for the module.
+     *
+     * @param {SystemConfig} config - The new configuration to set.
+     */
+    set config(config: SystemConfig);
+    /**
+     * Methods
+     */
+    /**
+     * Handles a message with an OcppRequest or OcppResponse payload.
+     *
+     * @param {IMessage<OcppRequest | OcppResponse>} message - The message to handle.
+     * @param {HandlerProperties} props - Optional properties for the handler.
+     * @return {void} This function does not return anything.
+     */
+    handle(message: IMessage<OcppRequest | OcppResponse>, props?: HandlerProperties): Promise<void>;
+    /**
+     * Interface methods.
+     */
+    /**
+     * Unimplemented method to handle incoming {@link IMessage}.
+     *
+     * **Note**: This method is **programmatically** overridden by the {@link ModuleHandlers} annotation.
+     *
+     * @param message The {@link IMessage} to handle. Can contain either a {@link OcppRequest} or a {@link OcppResponse} as payload.
+     * @param props The {@link HandlerProperties} for this {@link IMessage} containing implementation specific metadata. Metadata is not used in the base implementation.
+     */
+    handleMessageApiCallback(message: IMessage<OcppResponse>): Promise<void>;
+    /**
+     * Calls shutdown on the handler and sender.
+     *
+     * Note: To be overwritten by subclass if other logic is necessary.
+     *
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Default implementation
+     */
+    /**
+     * Sends a call with the specified identifier, tenantId, protocol, action, payload, and origin.
+     *
+     * @param {string} stationId - The identifier of the station making the call.
+     * @param {number} tenantId - The identifier of the tenant.
+     * @param {string} protocol - The subprotocol of the Websocket, i.e. "ocpp1.6" or "ocpp2.0.1".
+     * @param {CallAction} action - The action to be performed.
+     * @param {OcppRequest} payload - The payload of the call.
+     * @param {string} [callbackUrl] - The callback URL for the call.
+     * @param {string} [correlationId] - The correlation ID of the call.
+     * @param {MessageOrigin} [origin] - The origin of the call.
+     * @return {Promise<IMessageConfirmation>} A promise that resolves to the message confirmation.
+     */
+    sendCall(stationId: string, tenantId: number, protocol: OCPPVersionType, action: CallAction, payload: OcppRequest, callbackUrl?: string, correlationId?: string, origin?: MessageOrigin): Promise<IMessageConfirmation>;
+    /**
+     * Sends the call result message and returns a Promise that resolves with the confirmation message.
+     *
+     * @param {string} correlationId - The correlation ID of the message.
+     * @param {string} stationId - The identifier of the station making the call.
+     * @param {number} tenantId - The identifier of the tenant.
+     * @param {string} protocol - The subprotocol of the Websocket, i.e. "ocpp1.6" or "ocpp2.0.1".
+     * @param {CallAction} action - The call action.
+     * @param {OcppResponse} payload - The payload of the call result message.
+     * @param {MessageOrigin} origin - (optional) The origin of the message.
+     * @return {Promise<IMessageConfirmation>} A Promise that resolves with the confirmation message.
+     */
+    sendCallResult(correlationId: string, stationId: string, tenantId: number, protocol: OCPPVersionType, action: CallAction, payload: OcppResponse, origin?: MessageOrigin): Promise<IMessageConfirmation>;
+    /**
+     * Sends the call result using the request message's fields.
+     * Payload will overwrite message.payload.
+     *
+     * @param {IMessage<OcppRequest>} message - The request message object.
+     * @param {OcppResponse} payload - The payload to send.
+     * @return {Promise<IMessageConfirmation>} A promise that resolves to the message confirmation.
+     */
+    sendCallResultWithMessage(message: IMessage<OcppRequest>, payload: OcppResponse): Promise<IMessageConfirmation>;
+    /**
+     * Sends the call error message and returns a Promise that resolves with the confirmation message.
+     *
+     * @param {string} correlationId - The correlation ID of the message.
+     * @param {string} stationId - The identifier of the station making the call.
+     * @param {number} tenantId - The identifier of the tenant.
+     * @param {string} protocol - The subprotocol of the Websocket, i.e. "ocpp1.6" or "ocpp2.0.1".
+     * @param {CallAction} action - The call action.
+     * @param {OcppError} payload - The payload of the call error message.
+     * @param {MessageOrigin} origin - (optional) The origin of the message.
+     * @return {Promise<IMessageConfirmation>} A Promise that resolves with the confirmation message.
+     */
+    sendCallError(correlationId: string, stationId: string, tenantId: number, protocol: OCPPVersionType, action: CallAction, payload: OcppError, origin?: MessageOrigin): Promise<IMessageConfirmation>;
+    /**
+     * Sends the call error using the request message's fields.
+     * Payload will overwrite message.payload.
+     *
+     * @param {IMessage<OcppRequest>} message - The request message object.
+     * @param {OcppResponse} payload - The payload to send.
+     * @return {Promise<IMessageConfirmation>} A promise that resolves to the message confirmation.
+     */
+    sendCallErrorWithMessage(message: IMessage<OcppRequest>, payload: OcppError): Promise<IMessageConfirmation>;
+    /**
+     * Initializes the logger for the class.
+     *
+     * @return {Logger<ILogObj>} The initialized logger.
+     */
+    protected _initLogger(baseLogger?: Logger<ILogObj>): Logger<ILogObj>;
+    /**
+     * Initializes the handler for handling requests and responses.
+     */
+    initHandlers(): Promise<void>;
+    /**
+     * Initializes the handler for handling requests and responses.
+     *
+     * @param {CallAction[]} requests - The array of call actions for requests.
+     * @param {CallAction[]} responses - The array of call actions for responses.
+     * @return {Promise<boolean>} Returns a promise that resolves to a boolean indicating if the initialization was successful.
+     */
+    private _initHandler;
+}

package/dist/interfaces/modules/AbstractModule.js

@@ -0,0 +1,350 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+import 'reflect-metadata';
+import { Logger } from 'tslog';
+import { v4 as uuidv4 } from 'uuid';
+import { ErrorCode, OcppError, OCPPVersion } from '../../ocpp/rpc/message.js';
+import { RequestBuilder } from '../../util/request.js';
+import { CacheNamespace, createIdentifier } from '../cache/types.js';
+import { EventGroup, MessageOrigin, MessageState } from '../messages/index.js';
+import { AS_HANDLER_METADATA } from './index.js';
+import { OCPPValidator } from './OCPPValidator.js';
+export class AbstractModule {
+    static CALLBACK_URL_CACHE_PREFIX = 'CALLBACK_URL_';
+    _config;
+    _ocppValidator;
+    _cache;
+    _handler;
+    _sender;
+    _eventGroup;
+    _logger;
+    _requests = [];
+    _responses = [];
+    startTime = Date.now();
+    constructor(config, cache, handler, sender, eventGroup, logger, ocppValidator) {
+        this._logger = this._initLogger(logger);
+        this._ocppValidator = ocppValidator || new OCPPValidator(logger);
+        this._logger.info('Initializing...');
+        this._config = config;
+        this._handler = handler;
+        this._sender = sender;
+        this._eventGroup = eventGroup;
+        this._cache = cache;
+        // Set module for proper message flow.
+        this.handler.module = this;
+    }
+    /**
+     * Getters & Setters
+     */
+    get ocppValidator() {
+        return this._ocppValidator;
+    }
+    get cache() {
+        return this._cache;
+    }
+    get sender() {
+        return this._sender;
+    }
+    get handler() {
+        return this._handler;
+    }
+    get config() {
+        return this._config;
+    }
+    /**
+     * Sets the system configuration for the module.
+     *
+     * @param {SystemConfig} config - The new configuration to set.
+     */
+    set config(config) {
+        this._config = config;
+        // Update all necessary settings for hot reload
+        this._logger.info(`Updating system configuration for ${this._eventGroup} module...`);
+        this._logger.settings.minLevel = this._config.logLevel;
+    }
+    /**
+     * Methods
+     */
+    /**
+     * Handles a message with an OcppRequest or OcppResponse payload.
+     *
+     * @param {IMessage<OcppRequest | OcppResponse>} message - The message to handle.
+     * @param {HandlerProperties} props - Optional properties for the handler.
+     * @return {void} This function does not return anything.
+     */
+    async handle(message, props) {
+        message.payload = this._ocppValidator.sanitizeOCPPPayload(message.payload);
+        switch (message.state) {
+            case MessageState.Request: {
+                const { isValid, errors } = this._ocppValidator.validateOCPPRequest(message.action, message.payload, message.protocol);
+                if (!isValid || errors) {
+                    throw new OcppError(message.context.correlationId, ErrorCode.FormatViolation, 'Invalid message format', {
+                        errors: errors,
+                    });
+                }
+                break;
+            }
+            case MessageState.Response: {
+                const { isValid, errors } = this._ocppValidator.validateOCPPResponse(message.action, message.payload, message.protocol);
+                if (!isValid || errors) {
+                    throw new OcppError(message.context.correlationId, ErrorCode.FormatViolation, 'Invalid message format', {
+                        errors: errors,
+                    });
+                }
+                await this.handleMessageApiCallback(message);
+                await this._cache.set(message.context.correlationId, JSON.stringify(message.payload), message.context.stationId, this._config.maxCachingSeconds);
+                break;
+            }
+            default:
+                this._logger.error('Unknown message state', message);
+                throw new Error('Unknown message state: ' + message.state);
+        }
+        try {
+            const handlerDefinition = Reflect.getMetadata(AS_HANDLER_METADATA, this.constructor)
+                .filter((h) => h.protocol === message.protocol && h.action === message.action)
+                .pop();
+            if (handlerDefinition) {
+                await handlerDefinition.method.call(this, message, props);
+            }
+            else {
+                throw new OcppError(message.context.correlationId, ErrorCode.NotSupported, 'No handler found for action: ' + message.action + ' at module ' + this._eventGroup);
+            }
+        }
+        catch (error) {
+            this._logger.error('Failed handling message: ', error, message);
+            if (message.state === MessageState.Request) {
+                // CallErrors are only emitted for Calls
+                this._logger.error('Sending CallError to ChargingStation...');
+                message.origin = MessageOrigin.ChargingStationManagementSystem;
+                if (error instanceof OcppError) {
+                    await this._sender.sendResponse(message, error);
+                }
+                else if (error instanceof Error) {
+                    await this._sender.sendResponse(message, new OcppError(message.context.correlationId, ErrorCode.InternalError, 'Failed handling message: ' + error.message));
+                }
+                else {
+                    this._logger.warn("Unknown error type, couldn't send CallError");
+                }
+            }
+        }
+    }
+    /**
+     * Interface methods.
+     */
+    /**
+     * Unimplemented method to handle incoming {@link IMessage}.
+     *
+     * **Note**: This method is **programmatically** overridden by the {@link ModuleHandlers} annotation.
+     *
+     * @param message The {@link IMessage} to handle. Can contain either a {@link OcppRequest} or a {@link OcppResponse} as payload.
+     * @param props The {@link HandlerProperties} for this {@link IMessage} containing implementation specific metadata. Metadata is not used in the base implementation.
+     */
+    async handleMessageApiCallback(message) {
+        const url = await this._cache.get(message.context.correlationId, AbstractModule.CALLBACK_URL_CACHE_PREFIX + message.context.stationId);
+        if (url) {
+            this._logger.debug(`Sending call result to callback URL: ${url} for correlationId: ${message.context.correlationId}`);
+            try {
+                await fetch(url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(message.payload),
+                });
+            }
+            catch (error) {
+                // TODO: Ideally the error log is also stored in the database in a failed invocations table to ensure these are visible outside of a log file.
+                this._logger.error('Failed sending call result: ', error);
+            }
+        }
+    }
+    /**
+     * Calls shutdown on the handler and sender.
+     *
+     * Note: To be overwritten by subclass if other logic is necessary.
+     *
+     */
+    async shutdown() {
+        await this._handler.shutdown();
+        await this._sender.shutdown();
+    }
+    /**
+     * Default implementation
+     */
+    /**
+     * Sends a call with the specified identifier, tenantId, protocol, action, payload, and origin.
+     *
+     * @param {string} stationId - The identifier of the station making the call.
+     * @param {number} tenantId - The identifier of the tenant.
+     * @param {string} protocol - The subprotocol of the Websocket, i.e. "ocpp1.6" or "ocpp2.0.1".
+     * @param {CallAction} action - The action to be performed.
+     * @param {OcppRequest} payload - The payload of the call.
+     * @param {string} [callbackUrl] - The callback URL for the call.
+     * @param {string} [correlationId] - The correlation ID of the call.
+     * @param {MessageOrigin} [origin] - The origin of the call.
+     * @return {Promise<IMessageConfirmation>} A promise that resolves to the message confirmation.
+     */
+    async sendCall(stationId, tenantId, protocol, action, payload, callbackUrl, correlationId, origin = MessageOrigin.ChargingStationManagementSystem) {
+        const identifier = createIdentifier(tenantId, stationId);
+        const _correlationId = correlationId === undefined ? uuidv4() : correlationId;
+        payload = this._ocppValidator.sanitizeOCPPPayload(payload);
+        const { isValid, errors } = this._ocppValidator.validateOCPPRequest(action, payload, protocol);
+        if (!isValid || errors) {
+            throw new OcppError(_correlationId, ErrorCode.FormatViolation, 'Invalid message format', {
+                errors: errors,
+            });
+        }
+        if (callbackUrl) {
+            // TODO: Handle callErrors, failure to send to charger, timeout from charger, with different responses to callback
+            this._logger.debug(`Setting callback URL: ${callbackUrl} for correlationId: ${_correlationId}`);
+            this._cache
+                .set(_correlationId, callbackUrl, AbstractModule.CALLBACK_URL_CACHE_PREFIX + stationId, this._config.maxCachingSeconds)
+                .then((value) => {
+                if (value) {
+                    this._logger.debug(`Successfully set cache for correlationId: ${_correlationId}`);
+                }
+                else {
+                    this._logger.warn(`Failed to set cache for correlationId: ${_correlationId}`);
+                }
+            })
+                .catch((error) => this._logger.error('Error setting cache: ', error));
+        }
+        // TODO: Future - Compound key with tenantId
+        return this._cache.get(identifier, CacheNamespace.Connections).then((connection) => {
+            if (connection) {
+                const websocketConnection = JSON.parse(connection);
+                if (websocketConnection.protocol !== protocol) {
+                    this._logger.error(`Failed sending call. Requested protocol: '${protocol}', connection protocol: '${websocketConnection.protocol}' for identifier: `, identifier);
+                    return Promise.resolve({
+                        success: false,
+                        payload: `Requested protocol: '${protocol}', connection protocol: '${websocketConnection.protocol}' for identifier: '${identifier}'`,
+                    });
+                }
+                return this._sender.sendRequest(RequestBuilder.buildCall(stationId, _correlationId, tenantId, action, payload, this._eventGroup, origin, protocol));
+            }
+            else {
+                this._logger.error('Failed sending call. No connection found for identifier: ', identifier);
+                return Promise.resolve({
+                    success: false,
+                    payload: 'No connection found for identifier: ' + identifier,
+                });
+            }
+        });
+    }
+    /**
+     * Sends the call result message and returns a Promise that resolves with the confirmation message.
+     *
+     * @param {string} correlationId - The correlation ID of the message.
+     * @param {string} stationId - The identifier of the station making the call.
+     * @param {number} tenantId - The identifier of the tenant.
+     * @param {string} protocol - The subprotocol of the Websocket, i.e. "ocpp1.6" or "ocpp2.0.1".
+     * @param {CallAction} action - The call action.
+     * @param {OcppResponse} payload - The payload of the call result message.
+     * @param {MessageOrigin} origin - (optional) The origin of the message.
+     * @return {Promise<IMessageConfirmation>} A Promise that resolves with the confirmation message.
+     */
+    sendCallResult(correlationId, stationId, tenantId, protocol, action, payload, origin = MessageOrigin.ChargingStationManagementSystem) {
+        payload = this._ocppValidator.sanitizeOCPPPayload(payload);
+        const { isValid, errors } = this._ocppValidator.validateOCPPResponse(action, payload, protocol);
+        if (!isValid || errors) {
+            throw new OcppError(correlationId, ErrorCode.FormatViolation, 'Invalid message format', {
+                errors: errors,
+            });
+        }
+        return this._sender.sendResponse(RequestBuilder.buildCallResult(stationId, correlationId, tenantId, action, payload, this._eventGroup, origin, protocol));
+    }
+    /**
+     * Sends the call result using the request message's fields.
+     * Payload will overwrite message.payload.
+     *
+     * @param {IMessage<OcppRequest>} message - The request message object.
+     * @param {OcppResponse} payload - The payload to send.
+     * @return {Promise<IMessageConfirmation>} A promise that resolves to the message confirmation.
+     */
+    sendCallResultWithMessage(message, payload) {
+        payload = this._ocppValidator.sanitizeOCPPPayload(payload);
+        const { isValid, errors } = this._ocppValidator.validateOCPPResponse(message.action, payload, message.protocol);
+        if (!isValid || errors) {
+            throw new OcppError(message.context.correlationId, ErrorCode.FormatViolation, 'Invalid message format', {
+                errors: errors,
+            });
+        }
+        message.origin = MessageOrigin.ChargingStationManagementSystem;
+        return this._sender.sendResponse(message, payload);
+    }
+    /**
+     * Sends the call error message and returns a Promise that resolves with the confirmation message.
+     *
+     * @param {string} correlationId - The correlation ID of the message.
+     * @param {string} stationId - The identifier of the station making the call.
+     * @param {number} tenantId - The identifier of the tenant.
+     * @param {string} protocol - The subprotocol of the Websocket, i.e. "ocpp1.6" or "ocpp2.0.1".
+     * @param {CallAction} action - The call action.
+     * @param {OcppError} payload - The payload of the call error message.
+     * @param {MessageOrigin} origin - (optional) The origin of the message.
+     * @return {Promise<IMessageConfirmation>} A Promise that resolves with the confirmation message.
+     */
+    sendCallError(correlationId, stationId, tenantId, protocol, action, payload, origin = MessageOrigin.ChargingStationManagementSystem) {
+        return this._sender.sendResponse(RequestBuilder.buildCallError(stationId, correlationId, tenantId, action, payload, this._eventGroup, origin, protocol));
+    }
+    /**
+     * Sends the call error using the request message's fields.
+     * Payload will overwrite message.payload.
+     *
+     * @param {IMessage<OcppRequest>} message - The request message object.
+     * @param {OcppResponse} payload - The payload to send.
+     * @return {Promise<IMessageConfirmation>} A promise that resolves to the message confirmation.
+     */
+    sendCallErrorWithMessage(message, payload) {
+        message.origin = MessageOrigin.ChargingStationManagementSystem;
+        return this._sender.sendResponse(message, payload);
+    }
+    /**
+     * Initializes the logger for the class.
+     *
+     * @return {Logger<ILogObj>} The initialized logger.
+     */
+    _initLogger(baseLogger) {
+        return baseLogger
+            ? baseLogger.getSubLogger({ name: this.constructor.name })
+            : new Logger({
+                name: this.constructor.name,
+                minLevel: this._config.logLevel,
+                hideLogPositionForProduction: this._config.env === 'production',
+            });
+    }
+    /**
+     * Initializes the handler for handling requests and responses.
+     */
+    async initHandlers() {
+        const result = await this._initHandler(this._requests, this._responses);
+        if (!result) {
+            throw new Error('Could not initialize module due to failure in handler initialization.');
+        }
+        this._logger.info(`Initialized in ${Date.now() - this.startTime}ms...`);
+    }
+    /**
+     * Initializes the handler for handling requests and responses.
+     *
+     * @param {CallAction[]} requests - The array of call actions for requests.
+     * @param {CallAction[]} responses - The array of call actions for responses.
+     * @return {Promise<boolean>} Returns a promise that resolves to a boolean indicating if the initialization was successful.
+     */
+    async _initHandler(requests, responses) {
+        this._handler.module = this;
+        await this.handler.initConnection();
+        let success = await this._handler.subscribe(this._eventGroup.toString() + '_requests', requests, {
+            origin: MessageOrigin.ChargingStation.toString(),
+            state: MessageState.Request.toString(),
+        });
+        success =
+            success &&
+                (await this._handler.subscribe(this._eventGroup.toString() + '_responses', responses, {
+                    origin: MessageOrigin.ChargingStation.toString(),
+                    state: MessageState.Response.toString(),
+                }));
+        return success;
+    }
+}
+//# sourceMappingURL=AbstractModule.js.map

package/dist/interfaces/modules/AbstractModule.js.map

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

package/dist/interfaces/modules/AsHandler.d.ts

@@ -0,0 +1,13 @@
+import type { CallAction } from '../../ocpp/rpc/message.js';
+import { OCPPVersion } from '../../ocpp/rpc/message.js';
+/**
+ * Decorators for module components.
+ */
+export declare const AS_HANDLER_METADATA = "AS_HANDLER_METADATA";
+/**
+ * Decorator function for OCPP modules to expose methods within module classes as handlers for given call action.
+ *
+ * @param {CallAction} action - the call action parameter
+ * @return {PropertyDescriptor} - the property descriptor
+ */
+export declare const AsHandler: (protocol: OCPPVersion, action: CallAction) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/interfaces/modules/AsHandler.js

@@ -0,0 +1,31 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+import { OCPPVersion } from '../../ocpp/rpc/message.js';
+/**
+ * Decorators for module components.
+ */
+export const AS_HANDLER_METADATA = 'AS_HANDLER_METADATA';
+/**
+ * Decorator function for OCPP modules to expose methods within module classes as handlers for given call action.
+ *
+ * @param {CallAction} action - the call action parameter
+ * @return {PropertyDescriptor} - the property descriptor
+ */
+export const AsHandler = function (protocol, action) {
+    return (target, propertyKey, descriptor) => {
+        if (!Reflect.hasMetadata(AS_HANDLER_METADATA, target.constructor)) {
+            Reflect.defineMetadata(AS_HANDLER_METADATA, [], target.constructor);
+        }
+        const handlers = Reflect.getMetadata(AS_HANDLER_METADATA, target.constructor);
+        handlers.push({
+            action: action,
+            protocol: protocol,
+            methodName: propertyKey,
+            method: descriptor.value,
+        });
+        Reflect.defineMetadata(AS_HANDLER_METADATA, handlers, target.constructor);
+        return descriptor;
+    };
+};
+//# sourceMappingURL=AsHandler.js.map

package/dist/interfaces/modules/AsHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsHandler.js","sourceRoot":"","sources":["../../../src/interfaces/modules/AsHandler.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,sCAAsC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD;;GAEG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,QAAqB,EAAE,MAAkB;IAC1E,OAAO,CAAC,MAAW,EAAE,WAAmB,EAAE,UAA8B,EAAsB,EAAE;QAC9F,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YAClE,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAClC,mBAAmB,EACnB,MAAM,CAAC,WAAW,CACU,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,WAAW;YACvB,MAAM,EAAE,UAAU,CAAC,KAAK;SACzB,CAAC,CAAC;QACH,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1E,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/interfaces/modules/CircuitBreaker.d.ts

@@ -0,0 +1,18 @@
+export type CircuitBreakerState = 'OPEN' | 'FAILING' | 'CLOSED';
+export interface CircuitBreakerOptions {
+    maxReconnectDelayMs?: number;
+    onStateChange?: (state: CircuitBreakerState, reason?: string) => void;
+}
+export declare class CircuitBreaker {
+    private _state;
+    private onStateChangeCbs;
+    private lastReason?;
+    constructor(options?: CircuitBreakerOptions);
+    get state(): CircuitBreakerState;
+    triggerFailure(reason?: string): void;
+    triggerSuccess(): void;
+    onStateChange(cb: (state: CircuitBreakerState, reason?: string) => void): void;
+    reset(): void;
+    close(reason?: string): void;
+    private emitStateChange;
+}