@zetra/citrineos-util 1.8.3-fork.1

package/dist/files/s3Storage.js

@@ -0,0 +1,118 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+import { CreateBucketCommand, GetObjectCommand, PutObjectCommand, S3Client, } from '@aws-sdk/client-s3';
+import { Readable } from 'stream';
+import { Logger } from 'tslog';
+export class S3Storage {
+    _logger;
+    s3Client;
+    defaultBucketName;
+    configFileName;
+    configBucketName;
+    constructor(config, configFileName, configDir, logger) {
+        this.s3Client = new S3Client({
+            // Endpoint required for Minio
+            ...(config.endpoint ? { endpoint: config.endpoint } : {}),
+            // Region required for AWS S3
+            ...(config.region ? { region: config.region } : {}),
+            // Only set forcePathStyle to true for Minio, use default (false) for AWS S3
+            forcePathStyle: !!config?.s3ForcePathStyle,
+            // Add credentials if explicitly provided
+            ...(config.accessKeyId && config.secretAccessKey
+                ? {
+                    credentials: {
+                        accessKeyId: config.accessKeyId,
+                        secretAccessKey: config.secretAccessKey,
+                    },
+                }
+                : {}),
+        });
+        this.defaultBucketName = config.defaultBucketName;
+        this.configFileName = configFileName;
+        this.configBucketName = configDir;
+        this._logger = logger
+            ? logger.getSubLogger({ name: this.constructor.name })
+            : new Logger({ name: this.constructor.name });
+    }
+    async saveFile(fileName, content, filePath) {
+        const bucketName = filePath ? filePath : this.defaultBucketName;
+        const command = new PutObjectCommand({
+            Bucket: bucketName,
+            Key: fileName,
+            Body: content,
+            ContentType: 'application/octet-stream',
+        });
+        try {
+            const result = await this.s3Client.send(command);
+            if (result.$metadata.httpStatusCode !== 200) {
+                throw new Error(`Failed to upload file ${fileName}: ${result.$metadata.httpStatusCode}`);
+            }
+            else {
+                return fileName;
+            }
+        }
+        catch (error) {
+            if (error.name === 'NoSuchBucket' || error.$metadata?.httpStatusCode === 404) {
+                this._logger.warn(`Bucket "${bucketName}" not found. Creating it...`);
+                await this.createBucket(bucketName);
+                this._logger.info(`Bucket "${bucketName}" created. Retrying config save...`);
+                return await this.saveFile(fileName, content, filePath);
+            }
+            else {
+                this._logger.error('Error saving config to S3:', error);
+                throw error;
+            }
+        }
+    }
+    async getFile(id, filePath) {
+        const command = new GetObjectCommand({
+            Bucket: filePath ? filePath : this.defaultBucketName,
+            Key: id,
+        });
+        const { Body } = await this.s3Client.send(command);
+        if (!Body)
+            return;
+        return await S3Storage.streamToString(Body);
+    }
+    async fetchConfig() {
+        try {
+            const configString = await this.getFile(this.configFileName, this.configBucketName);
+            if (!configString)
+                return null;
+            return JSON.parse(configString);
+        }
+        catch (error) {
+            if (error.name === 'NoSuchKey' || error.$metadata?.httpStatusCode === 404) {
+                this._logger.warn('Config not found in S3.');
+                return null;
+            }
+            this._logger.error('Error fetching config from S3:', error);
+            throw error;
+        }
+    }
+    async saveConfig(config) {
+        await this.saveFile(this.configFileName, Buffer.from(JSON.stringify(config, null, 2)), this.configBucketName);
+        this._logger.info('Config saved to S3.');
+    }
+    async createBucket(bucket) {
+        try {
+            const command = new CreateBucketCommand({ Bucket: bucket });
+            await this.s3Client.send(command);
+            this._logger.info(`Bucket "${bucket}" created successfully.`);
+        }
+        catch (error) {
+            this._logger.error(`Failed to create bucket "${bucket}":`, error);
+            throw error;
+        }
+    }
+    static async streamToString(stream) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            stream.on('data', (chunk) => chunks.push(chunk));
+            stream.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+            stream.on('error', reject);
+        });
+    }
+}
+//# sourceMappingURL=s3Storage.js.map

package/dist/files/s3Storage.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { UnknownStationFilter } from './networkconnection/authenticator/UnknownStationFilter.js';
+export { ConnectedStationFilter } from './networkconnection/authenticator/ConnectedStationFilter.js';
+export { NetworkProfileFilter } from './networkconnection/authenticator/NetworkProfileFilter.js';
+export { BasicAuthenticationFilter } from './networkconnection/authenticator/BasicAuthenticationFilter.js';
+export * from './authorization/index.js';
+export * from './authorizer/index.js';
+export { MemoryCache } from './cache/memory.js';
+export { RedisCache } from './cache/redis.js';
+export { S3Storage } from './files/s3Storage.js';
+export { GcpCloudStorage } from './files/gcpCloudStorage.js';
+export { FtpServer } from './files/ftpServer.js';
+export { LocalStorage } from './files/localStorage.js';
+export * from './queue/index.js';
+export * from './networkconnection/index.js';
+export * from './certificate/index.js';
+export { initSwagger } from './util/swagger.js';
+export { getSizeOfRequest, getBatches, stringToSet } from './util/parser.js';
+export { validateLanguageTag, validateChargingProfileType, validateIdToken, validateISO15693IdToken, validateISO14443IdToken, validateIdentifierStringIdToken, validateNoAuthorizationIdToken, type ValidationResult, validateASCIIContent, validateHTMLContent, validateURIContent, validateUTF8Content, validateMessageContent, validateMessageContentType, validatePEMEncodedCSR, } from './util/validator.js';
+export { IdGenerator } from './util/idGenerator.js';
+export { isValidPassword, generatePassword } from './security/authentication.js';
+export { SignedMeterValuesUtil } from './security/SignedMeterValuesUtil.js';

package/dist/index.js

@@ -0,0 +1,25 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+export { UnknownStationFilter } from './networkconnection/authenticator/UnknownStationFilter.js';
+export { ConnectedStationFilter } from './networkconnection/authenticator/ConnectedStationFilter.js';
+export { NetworkProfileFilter } from './networkconnection/authenticator/NetworkProfileFilter.js';
+export { BasicAuthenticationFilter } from './networkconnection/authenticator/BasicAuthenticationFilter.js';
+export * from './authorization/index.js';
+export * from './authorizer/index.js';
+export { MemoryCache } from './cache/memory.js';
+export { RedisCache } from './cache/redis.js';
+export { S3Storage } from './files/s3Storage.js';
+export { GcpCloudStorage } from './files/gcpCloudStorage.js';
+export { FtpServer } from './files/ftpServer.js';
+export { LocalStorage } from './files/localStorage.js';
+export * from './queue/index.js';
+export * from './networkconnection/index.js';
+export * from './certificate/index.js';
+export { initSwagger } from './util/swagger.js';
+export { getSizeOfRequest, getBatches, stringToSet } from './util/parser.js';
+export { validateLanguageTag, validateChargingProfileType, validateIdToken, validateISO15693IdToken, validateISO14443IdToken, validateIdentifierStringIdToken, validateNoAuthorizationIdToken, validateASCIIContent, validateHTMLContent, validateURIContent, validateUTF8Content, validateMessageContent, validateMessageContentType, validatePEMEncodedCSR, } from './util/validator.js';
+export { IdGenerator } from './util/idGenerator.js';
+export { isValidPassword, generatePassword } from './security/authentication.js';
+export { SignedMeterValuesUtil } from './security/SignedMeterValuesUtil.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,sCAAsC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,6DAA6D,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AACjG,OAAO,EAAE,yBAAyB,EAAE,MAAM,gEAAgE,CAAC;AAE3G,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,+BAA+B,EAC/B,8BAA8B,EAE9B,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/networkconnection/WebsocketNetworkConnection.d.ts

@@ -0,0 +1,135 @@
+import type { IAuthenticator, ICache, IMessageRouter, INetworkConnection, SystemConfig, WebsocketServerConfig } from '@citrineos/base';
+import type { ILogObj } from 'tslog';
+import { Logger } from 'tslog';
+export declare class WebsocketNetworkConnection implements INetworkConnection {
+    protected _cache: ICache;
+    protected _config: SystemConfig;
+    protected _logger: Logger<ILogObj>;
+    private _identifierConnections;
+    private _httpServersMap;
+    private _authenticator;
+    private _router;
+    private _doesChargingStationExistByStationId?;
+    constructor(config: SystemConfig, cache: ICache, authenticator: IAuthenticator, router: IMessageRouter, logger?: Logger<ILogObj>, doesChargingStationExistByStationId?: (tenantId: number, stationId: string) => Promise<boolean>);
+    /**
+     * Send a message to the charging station specified by the identifier.
+     *
+     * @param {string} identifier - The identifier of the client.
+     * @param {string} message - The message to send.
+     * @return {void} rejects the promise if message fails to send, otherwise returns void.
+     */
+    sendMessage(identifier: string, message: string): Promise<void>;
+    bindNetworkHook(): (identifier: string, message: string) => Promise<void>;
+    disconnect(tenantId: number, stationId: string): Promise<boolean>;
+    shutdown(): Promise<void>;
+    /**
+     * Updates certificates for a specific server with the provided TLS key, certificate chain, and optional
+     * root CA.
+     *
+     * @param {string} serverId - The ID of the server to update.
+     * @param {string} tlsKey - The TLS key to set.
+     * @param {string} tlsCertificateChain - The TLS certificate chain to set.
+     * @param {string} [rootCA] - The root CA to set (optional).
+     * @return {void} void
+     */
+    updateTlsCertificates(serverId: string, tlsKey: string, tlsCertificateChain: string, rootCA?: string): void;
+    /**
+     * Dynamically adds a new websocket server at runtime and starts it.
+     *
+     * @param {WebsocketServerConfig} websocketServerConfig
+     * @returns {Promise<void>}
+     */
+    addWebsocketServer(websocketServerConfig: WebsocketServerConfig): Promise<void>;
+    private _onHttpRequest;
+    /**
+     * Method to validate websocket upgrade requests and pass them to the socket server.
+     *
+     * @param {IncomingMessage} req - The request object.
+     * @param {Duplex} socket - Websocket duplex stream.
+     * @param {Buffer} head - Websocket buffer.
+     * @param {WebSocketServer} wss - Websocket server.
+     * @param {WebsocketServerConfig} websocketServerConfig - websocket server config.
+     */
+    private _upgradeRequest;
+    /**
+     * Utility function to reject websocket upgrade requests with 500 status code.
+     * @param socket - Websocket duplex stream.
+     */
+    private _terminateConnectionInternalError;
+    /**
+     * Internal method to handle new client connection and ensures supported protocols are used.
+     *
+     * @param {Set<string>} protocols - The set of protocols to handle.
+     * @param {IncomingMessage} _req - The request object.
+     * @param {string} wsServerProtocol - The websocket server protocol.
+     * @return {boolean|string} - Returns the protocol version if successful, otherwise false.
+     */
+    private _handleProtocols;
+    /**
+     * Internal method to handle the connection event when a WebSocket connection is established.
+     * This happens after successful protocol exchange with client.
+     *
+     * @param {WebSocket} ws - The WebSocket object representing the connection.
+     * @param {WebsocketServerConfig} websocketServerConfig - The websocket server configuration.
+     * @param {number} pingInterval - The ping interval in seconds.
+     * @param {IncomingMessage} req - The request object associated with the connection.
+     * @return {void}
+     */
+    private _onConnection;
+    /**
+     * Internal method to register event listeners for the WebSocket connection.
+     *
+     * @param {string} identifier - The unique identifier of the connection, i.e. the combination of tenantId and stationId.
+     * @param {WebSocket} ws - The WebSocket object representing the connection.
+     * @param {number} pingInterval - The ping interval in seconds.
+     * @return {void} This function does not return anything.
+     */
+    private _registerWebsocketEvents;
+    /**
+     * Internal method to handle the incoming message from the websocket client.
+     *
+     * @param {string} identifier - The client identifier.
+     * @param {string} message - The incoming message from the client.
+     * @param {OCPPVersionType} protocol - The OCPP protocol version of the client, 'ocpp1.6' or 'ocpp2.0.1'.
+     * @return {void} This function does not return anything.
+     */
+    private _onMessage;
+    /**
+     * Internal method to handle the error event for the WebSocket server.
+     *
+     * @param {WebSocketServer} wss - The WebSocket server instance.
+     * @param {Error} error - The error object.
+     * @return {void} This function does not return anything.
+     */
+    private _onError;
+    /**
+     * Internal method to handle the event when the WebSocketServer is closed.
+     *
+     * @param {WebSocketServer} wss - The WebSocketServer instance.
+     * @return {void} This function does not return anything.
+     */
+    private _onClose;
+    /**
+     * Internal method to execute a ping operation on a WebSocket connection after a delay of 60 seconds.
+     *
+     * @param {string} identifier - The identifier of the client connection.
+     * @param {WebSocket} ws - The WebSocket connection to ping.
+     * @param {number} pingInterval - The ping interval in milliseconds.
+     * @return {void} This function does not return anything.
+     */
+    private _ping;
+    /**
+     *
+     * @param url Http upgrade request url used by charger
+     * @returns Charger identifier
+     */
+    private _getClientIdFromUrl;
+    /**
+     * Extract tenant id from the incoming upgrade request.
+     * Supported sources (in order): query `tenant`/`tenantId`, header `x-tenant-id`,
+     * path segment (second-last segment if URL is `/tenant/station`).
+     */
+    private _extractTenantIdFromRequest;
+    private _generateServerOptions;
+    private _createAndStartWebsocketServer;
+}