-// Partial Copyright Jerome Benoit. 2021-2023. All Rights Reserved.
-
-import { EventEmitter } from 'node:events';
-import { dirname, extname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { isMainThread } from 'node:worker_threads';
-
-import chalk from 'chalk';
-import { availableParallelism } from 'poolifier';
-
-import { waitChargingStationEvents } from './ChargingStationUtils';
-import type { AbstractUIServer } from './ui-server/AbstractUIServer';
-import { UIServerFactory } from './ui-server/UIServerFactory';
-import { version } from '../../package.json' assert { type: 'json' };
-import { BaseError } from '../exception';
-import { type Storage, StorageFactory } from '../performance';
+// Partial Copyright Jerome Benoit. 2021-2024. All Rights Reserved.
+
+import { EventEmitter } from 'node:events'
+import { dirname, extname, join } from 'node:path'
+import process, { exit } from 'node:process'
+import { fileURLToPath } from 'node:url'
+import { isMainThread } from 'node:worker_threads'
+
+import chalk from 'chalk'
+import { availableParallelism, type MessageHandler } from 'poolifier'
+import type { Worker } from 'worker_threads'
+
+import { version } from '../../package.json'
+import { BaseError } from '../exception/index.js'
+import { type Storage, StorageFactory } from '../performance/index.js'
import {
type ChargingStationData,
+ type ChargingStationInfo,
+ type ChargingStationOptions,
type ChargingStationWorkerData,
type ChargingStationWorkerMessage,
type ChargingStationWorkerMessageData,
ChargingStationWorkerMessageEvents,
ConfigurationSection,
ProcedureName,
- type StationTemplateUrl,
+ type SimulatorState,
type Statistics,
type StorageConfiguration,
+ type TemplateStatistics,
type UIServerConfiguration,
- type WorkerConfiguration,
-} from '../types';
+ type WorkerConfiguration
+} from '../types/index.js'
import {
Configuration,
Constants,
generateUUID,
handleUncaughtException,
handleUnhandledRejection,
+ isAsyncFunction,
isNotEmptyArray,
- isNullOrUndefined,
- logPrefix,
logger,
-} from '../utils';
-import { type WorkerAbstract, WorkerFactory } from '../worker';
+ logPrefix
+} from '../utils/index.js'
+import { DEFAULT_ELEMENTS_PER_WORKER, type WorkerAbstract, WorkerFactory } from '../worker/index.js'
+import { buildTemplateName, waitChargingStationEvents } from './Helpers.js'
+import type { AbstractUIServer } from './ui-server/AbstractUIServer.js'
+import { UIServerFactory } from './ui-server/UIServerFactory.js'
-const moduleName = 'Bootstrap';
+const moduleName = 'Bootstrap'
enum exitCodes {
+ succeeded = 0,
missingChargingStationsConfiguration = 1,
- noChargingStationTemplates = 2,
+ duplicateChargingStationTemplateUrls = 2,
+ noChargingStationTemplates = 3,
+ gracefulShutdownError = 4
}
export class Bootstrap extends EventEmitter {
- private static instance: Bootstrap | null = null;
- public numberOfChargingStations!: number;
- public numberOfChargingStationTemplates!: number;
- private workerImplementation: WorkerAbstract<ChargingStationWorkerData> | null;
- private readonly uiServer!: AbstractUIServer | null;
- private readonly storage!: Storage;
- private numberOfStartedChargingStations!: number;
- private readonly version: string = version;
- private initializedCounters: boolean;
- private started: boolean;
- private starting: boolean;
- private stopping: boolean;
- private readonly workerScript: string;
-
- private constructor() {
- super();
+ private static instance: Bootstrap | null = null
+ private workerImplementation?: WorkerAbstract<ChargingStationWorkerData, ChargingStationInfo>
+ private readonly uiServer: AbstractUIServer
+ private storage?: Storage
+ private readonly templateStatistics: Map<string, TemplateStatistics>
+ private readonly version: string = version
+ private started: boolean
+ private starting: boolean
+ private stopping: boolean
+ private uiServerStarted: boolean
+
+ private constructor () {
+ super()
for (const signal of ['SIGINT', 'SIGQUIT', 'SIGTERM']) {
- process.on(signal, this.gracefulShutdown);
+ process.on(signal, this.gracefulShutdown.bind(this))
}
// Enable unconditionally for now
- handleUnhandledRejection();
- handleUncaughtException();
- this.started = false;
- this.starting = false;
- this.stopping = false;
- this.initializedCounters = false;
- this.initializeCounters();
- this.workerImplementation = null;
- this.workerScript = join(
- dirname(fileURLToPath(import.meta.url)),
- `ChargingStationWorker${extname(fileURLToPath(import.meta.url))}`,
- );
- Configuration.getConfigurationSection<UIServerConfiguration>(ConfigurationSection.uiServer)
- .enabled === true &&
- (this.uiServer = UIServerFactory.getUIServerImplementation(
- Configuration.getConfigurationSection<UIServerConfiguration>(ConfigurationSection.uiServer),
- ));
- Configuration.getConfigurationSection<StorageConfiguration>(
- ConfigurationSection.performanceStorage,
- ).enabled === true &&
- (this.storage = StorageFactory.getStorage(
- Configuration.getConfigurationSection<StorageConfiguration>(
- ConfigurationSection.performanceStorage,
- ).type!,
- Configuration.getConfigurationSection<StorageConfiguration>(
- ConfigurationSection.performanceStorage,
- ).uri!,
- this.logPrefix(),
- ));
- Configuration.setConfigurationChangeCallback(async () => Bootstrap.getInstance().restart());
+ handleUnhandledRejection()
+ handleUncaughtException()
+ this.started = false
+ this.starting = false
+ this.stopping = false
+ this.uiServerStarted = false
+ this.templateStatistics = new Map<string, TemplateStatistics>()
+ this.uiServer = UIServerFactory.getUIServerImplementation(
+ Configuration.getConfigurationSection<UIServerConfiguration>(ConfigurationSection.uiServer)
+ )
+ this.initializeCounters()
+ this.initializeWorkerImplementation(
+ Configuration.getConfigurationSection<WorkerConfiguration>(ConfigurationSection.worker)
+ )
+ Configuration.configurationChangeCallback = async () => {
+ if (isMainThread) {
+ await Bootstrap.getInstance().restart()
+ }
+ }
}
- public static getInstance(): Bootstrap {
+ public static getInstance (): Bootstrap {
if (Bootstrap.instance === null) {
- Bootstrap.instance = new Bootstrap();
+ Bootstrap.instance = new Bootstrap()
}
- return Bootstrap.instance;
+ return Bootstrap.instance
}
- public async start(): Promise<void> {
- if (!isMainThread) {
- throw new Error('Cannot start charging stations simulator from worker thread');
+ public get numberOfChargingStationTemplates (): number {
+ return this.templateStatistics.size
+ }
+
+ public get numberOfConfiguredChargingStations (): number {
+ return [...this.templateStatistics.values()].reduce(
+ (accumulator, value) => accumulator + value.configured,
+ 0
+ )
+ }
+
+ public get numberOfProvisionedChargingStations (): number {
+ return [...this.templateStatistics.values()].reduce(
+ (accumulator, value) => accumulator + value.provisioned,
+ 0
+ )
+ }
+
+ public getState (): SimulatorState {
+ return {
+ version: this.version,
+ configuration: Configuration.getConfigurationData(),
+ started: this.started,
+ templateStatistics: this.templateStatistics
+ }
+ }
+
+ public getLastIndex (templateName: string): number {
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ const indexes = [...this.templateStatistics.get(templateName)!.indexes]
+ .concat(0)
+ .sort((a, b) => a - b)
+ for (let i = 0; i < indexes.length - 1; i++) {
+ if (indexes[i + 1] - indexes[i] !== 1) {
+ return indexes[i]
+ }
}
- if (this.started === false) {
- if (this.starting === false) {
- this.starting = true;
- this.initializeCounters();
- this.initializeWorkerImplementation();
- await this.workerImplementation?.start();
- await this.storage?.open();
- this.uiServer?.start();
+ return indexes[indexes.length - 1]
+ }
+
+ public getPerformanceStatistics (): IterableIterator<Statistics> | undefined {
+ return this.storage?.getPerformanceStatistics()
+ }
+
+ private get numberOfAddedChargingStations (): number {
+ return [...this.templateStatistics.values()].reduce(
+ (accumulator, value) => accumulator + value.added,
+ 0
+ )
+ }
+
+ private get numberOfStartedChargingStations (): number {
+ return [...this.templateStatistics.values()].reduce(
+ (accumulator, value) => accumulator + value.started,
+ 0
+ )
+ }
+
+ public async start (): Promise<void> {
+ if (!this.started) {
+ if (!this.starting) {
+ this.starting = true
+ this.on(ChargingStationWorkerMessageEvents.added, this.workerEventAdded)
+ this.on(ChargingStationWorkerMessageEvents.deleted, this.workerEventDeleted)
+ this.on(ChargingStationWorkerMessageEvents.started, this.workerEventStarted)
+ this.on(ChargingStationWorkerMessageEvents.stopped, this.workerEventStopped)
+ this.on(ChargingStationWorkerMessageEvents.updated, this.workerEventUpdated)
+ this.on(
+ ChargingStationWorkerMessageEvents.performanceStatistics,
+ this.workerEventPerformanceStatistics
+ )
+ // eslint-disable-next-line @typescript-eslint/unbound-method
+ if (isAsyncFunction(this.workerImplementation?.start)) {
+ await this.workerImplementation.start()
+ } else {
+ (this.workerImplementation?.start as () => void)()
+ }
+ const performanceStorageConfiguration =
+ Configuration.getConfigurationSection<StorageConfiguration>(
+ ConfigurationSection.performanceStorage
+ )
+ if (performanceStorageConfiguration.enabled === true) {
+ this.storage = StorageFactory.getStorage(
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ performanceStorageConfiguration.type!,
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ performanceStorageConfiguration.uri!,
+ this.logPrefix()
+ )
+ await this.storage?.open()
+ }
+ if (
+ !this.uiServerStarted &&
+ Configuration.getConfigurationSection<UIServerConfiguration>(
+ ConfigurationSection.uiServer
+ ).enabled === true
+ ) {
+ this.uiServer.start()
+ this.uiServerStarted = true
+ }
// Start ChargingStation object instance in worker thread
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
for (const stationTemplateUrl of Configuration.getStationTemplateUrls()!) {
try {
- const nbStations = stationTemplateUrl.numberOfStations ?? 0;
+ const nbStations = stationTemplateUrl.numberOfStations
for (let index = 1; index <= nbStations; index++) {
- await this.startChargingStation(index, stationTemplateUrl);
+ await this.addChargingStation(index, stationTemplateUrl.file)
}
} catch (error) {
console.error(
chalk.red(
- `Error at starting charging station with template file ${stationTemplateUrl.file}: `,
+ `Error at starting charging station with template file ${stationTemplateUrl.file}: `
),
- error,
- );
+ error
+ )
}
}
+ const workerConfiguration = Configuration.getConfigurationSection<WorkerConfiguration>(
+ ConfigurationSection.worker
+ )
console.info(
chalk.green(
- `Charging stations simulator ${
- this.version
- } started with ${this.numberOfChargingStations.toString()} charging station(s) from ${this.numberOfChargingStationTemplates.toString()} configured charging station template(s) and ${
- Configuration.workerDynamicPoolInUse()
- ? `${Configuration.getConfigurationSection<WorkerConfiguration>(
- ConfigurationSection.worker,
- ).poolMinSize?.toString()}/`
- : ''
+ `Charging stations simulator ${this.version} started with ${
+ this.numberOfConfiguredChargingStations
+ } configured and ${
+ this.numberOfProvisionedChargingStations
+ } provisioned charging station(s) from ${
+ this.numberOfChargingStationTemplates
+ } charging station template(s) and ${
+ Configuration.workerDynamicPoolInUse() ? `${workerConfiguration.poolMinSize}/` : ''
}${this.workerImplementation?.size}${
- Configuration.workerPoolInUse()
- ? `/${Configuration.getConfigurationSection<WorkerConfiguration>(
- ConfigurationSection.worker,
- ).poolMaxSize?.toString()}`
- : ''
- } worker(s) concurrently running in '${
- Configuration.getConfigurationSection<WorkerConfiguration>(
- ConfigurationSection.worker,
- ).processType
- }' mode${
- !isNullOrUndefined(this.workerImplementation?.maxElementsPerWorker)
- ? ` (${this.workerImplementation?.maxElementsPerWorker} charging station(s) per worker)`
+ Configuration.workerPoolInUse() ? `/${workerConfiguration.poolMaxSize}` : ''
+ } worker(s) concurrently running in '${workerConfiguration.processType}' mode${
+ this.workerImplementation?.maxElementsPerWorker != null
+ ? ` (${this.workerImplementation.maxElementsPerWorker} charging station(s) per worker)`
: ''
- }`,
- ),
- );
+ }`
+ )
+ )
Configuration.workerDynamicPoolInUse() &&
console.warn(
chalk.yellow(
- 'Charging stations simulator is using dynamic pool mode. This is an experimental feature with known issues.\nPlease consider using static pool or worker set mode instead',
- ),
- );
- console.info(chalk.green('Worker set/pool information:'), this.workerImplementation?.info);
- this.started = true;
- this.starting = false;
+ 'Charging stations simulator is using dynamic pool mode. This is an experimental feature with known issues.\nPlease consider using fixed pool or worker set mode instead'
+ )
+ )
+ console.info(chalk.green('Worker set/pool information:'), this.workerImplementation?.info)
+ this.started = true
+ this.starting = false
} else {
- console.error(chalk.red('Cannot start an already starting charging stations simulator'));
+ console.error(chalk.red('Cannot start an already starting charging stations simulator'))
}
} else {
- console.error(chalk.red('Cannot start an already started charging stations simulator'));
+ console.error(chalk.red('Cannot start an already started charging stations simulator'))
}
}
- public async stop(): Promise<void> {
- if (!isMainThread) {
- throw new Error('Cannot stop charging stations simulator from worker thread');
- }
- if (this.started === true) {
- if (this.stopping === false) {
- this.stopping = true;
- await this.uiServer?.sendInternalRequest(
+ public async stop (): Promise<void> {
+ if (this.started) {
+ if (!this.stopping) {
+ this.stopping = true
+ await this.uiServer.sendInternalRequest(
this.uiServer.buildProtocolRequest(
generateUUID(),
ProcedureName.STOP_CHARGING_STATION,
- Constants.EMPTY_FREEZED_OBJECT,
- ),
- );
- await Promise.race([
- waitChargingStationEvents(
- this,
- ChargingStationWorkerMessageEvents.stopped,
- this.numberOfChargingStations,
- ),
- new Promise<string>((resolve) => {
- setTimeout(() => {
- const message = `Timeout reached ${formatDurationMilliSeconds(
- Constants.STOP_SIMULATOR_TIMEOUT,
- )} at stopping charging stations simulator`;
- console.warn(chalk.yellow(message));
- resolve(message);
- }, Constants.STOP_SIMULATOR_TIMEOUT);
- }),
- ]);
- await this.workerImplementation?.stop();
- this.workerImplementation = null;
- this.uiServer?.stop();
- await this.storage?.close();
- this.resetCounters();
- this.initializedCounters = false;
- this.started = false;
- this.stopping = false;
+ Constants.EMPTY_FROZEN_OBJECT
+ )
+ )
+ try {
+ await this.waitChargingStationsStopped()
+ } catch (error) {
+ console.error(chalk.red('Error while waiting for charging stations to stop: '), error)
+ }
+ await this.workerImplementation?.stop()
+ this.removeAllListeners()
+ this.uiServer.clearCaches()
+ await this.storage?.close()
+ delete this.storage
+ this.started = false
+ this.stopping = false
} else {
- console.error(chalk.red('Cannot stop an already stopping charging stations simulator'));
+ console.error(chalk.red('Cannot stop an already stopping charging stations simulator'))
}
} else {
- console.error(chalk.red('Cannot stop an already stopped charging stations simulator'));
+ console.error(chalk.red('Cannot stop an already stopped charging stations simulator'))
}
}
- public async restart(): Promise<void> {
- await this.stop();
- await this.start();
- }
-
- private initializeWorkerImplementation(): void {
- let elementsPerWorker: number | undefined;
+ private async restart (): Promise<void> {
+ await this.stop()
if (
- Configuration.getConfigurationSection<WorkerConfiguration>(ConfigurationSection.worker)
- ?.elementsPerWorker === 'auto'
+ this.uiServerStarted &&
+ Configuration.getConfigurationSection<UIServerConfiguration>(ConfigurationSection.uiServer)
+ .enabled !== true
) {
- elementsPerWorker =
- this.numberOfChargingStations > availableParallelism()
- ? Math.round(this.numberOfChargingStations / availableParallelism())
- : 1;
+ this.uiServer.stop()
+ this.uiServerStarted = false
+ }
+ this.initializeCounters()
+ // FIXME: initialize worker implementation only if the worker section has changed
+ this.initializeWorkerImplementation(
+ Configuration.getConfigurationSection<WorkerConfiguration>(ConfigurationSection.worker)
+ )
+ await this.start()
+ }
+
+ private async waitChargingStationsStopped (): Promise<string> {
+ return await new Promise<string>((resolve, reject: (reason?: unknown) => void) => {
+ const waitTimeout = setTimeout(() => {
+ const timeoutMessage = `Timeout ${formatDurationMilliSeconds(
+ Constants.STOP_CHARGING_STATIONS_TIMEOUT
+ )} reached at stopping charging stations`
+ console.warn(chalk.yellow(timeoutMessage))
+ reject(new Error(timeoutMessage))
+ }, Constants.STOP_CHARGING_STATIONS_TIMEOUT)
+ waitChargingStationEvents(
+ this,
+ ChargingStationWorkerMessageEvents.stopped,
+ this.numberOfStartedChargingStations
+ )
+ .then(() => {
+ resolve('Charging stations stopped')
+ })
+ .catch(reject)
+ .finally(() => {
+ clearTimeout(waitTimeout)
+ })
+ })
+ }
+
+ private initializeWorkerImplementation (workerConfiguration: WorkerConfiguration): void {
+ if (!isMainThread) {
+ return
+ }
+ let elementsPerWorker: number
+ switch (workerConfiguration.elementsPerWorker) {
+ case 'all':
+ elementsPerWorker =
+ this.numberOfConfiguredChargingStations + this.numberOfProvisionedChargingStations
+ break
+ case 'auto':
+ elementsPerWorker =
+ this.numberOfConfiguredChargingStations + this.numberOfProvisionedChargingStations >
+ availableParallelism()
+ ? Math.round(
+ (this.numberOfConfiguredChargingStations +
+ this.numberOfProvisionedChargingStations) /
+ (availableParallelism() * 1.5)
+ )
+ : 1
+ break
+ default:
+ elementsPerWorker = workerConfiguration.elementsPerWorker ?? DEFAULT_ELEMENTS_PER_WORKER
}
- this.workerImplementation === null &&
- (this.workerImplementation = WorkerFactory.getWorkerImplementation<ChargingStationWorkerData>(
- this.workerScript,
- Configuration.getConfigurationSection<WorkerConfiguration>(ConfigurationSection.worker)
- .processType!,
- {
- workerStartDelay: Configuration.getConfigurationSection<WorkerConfiguration>(
- ConfigurationSection.worker,
- ).startDelay,
- elementStartDelay: Configuration.getConfigurationSection<WorkerConfiguration>(
- ConfigurationSection.worker,
- ).elementStartDelay,
- poolMaxSize: Configuration.getConfigurationSection<WorkerConfiguration>(
- ConfigurationSection.worker,
- ).poolMaxSize!,
- poolMinSize: Configuration.getConfigurationSection<WorkerConfiguration>(
- ConfigurationSection.worker,
- ).poolMinSize!,
- elementsPerWorker:
- elementsPerWorker ??
- (Configuration.getConfigurationSection<WorkerConfiguration>(ConfigurationSection.worker)
- .elementsPerWorker as number),
- poolOptions: {
- messageHandler: this.messageHandler.bind(this) as (message: unknown) => void,
- },
- },
- ));
+ this.workerImplementation = WorkerFactory.getWorkerImplementation<
+ ChargingStationWorkerData,
+ ChargingStationInfo
+ >(
+ join(
+ dirname(fileURLToPath(import.meta.url)),
+ `ChargingStationWorker${extname(fileURLToPath(import.meta.url))}`
+ ),
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ workerConfiguration.processType!,
+ {
+ workerStartDelay: workerConfiguration.startDelay,
+ elementAddDelay: workerConfiguration.elementAddDelay,
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ poolMaxSize: workerConfiguration.poolMaxSize!,
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ poolMinSize: workerConfiguration.poolMinSize!,
+ elementsPerWorker,
+ poolOptions: {
+ messageHandler: this.messageHandler.bind(this) as MessageHandler<Worker>,
+ ...(workerConfiguration.resourceLimits != null && {
+ workerOptions: {
+ resourceLimits: workerConfiguration.resourceLimits
+ }
+ })
+ }
+ }
+ )
}
- private messageHandler(
- msg: ChargingStationWorkerMessage<ChargingStationWorkerMessageData>,
+ private messageHandler (
+ msg: ChargingStationWorkerMessage<ChargingStationWorkerMessageData>
): void {
// logger.debug(
- // `${this.logPrefix()} ${moduleName}.messageHandler: Worker channel message received: ${JSON.stringify(
+ // `${this.logPrefix()} ${moduleName}.messageHandler: Charging station worker message received: ${JSON.stringify(
// msg,
- // null,
- // 2,
- // )}`,
- // );
+ // undefined,
+ // 2
+ // )}`
+ // )
+ // Skip worker message events processing
+ // eslint-disable-next-line @typescript-eslint/dot-notation
+ if (msg['uuid'] != null) {
+ return
+ }
+ const { event, data } = msg
try {
- switch (msg.id) {
+ switch (event) {
+ case ChargingStationWorkerMessageEvents.added:
+ this.emit(ChargingStationWorkerMessageEvents.added, data)
+ break
+ case ChargingStationWorkerMessageEvents.deleted:
+ this.emit(ChargingStationWorkerMessageEvents.deleted, data)
+ break
case ChargingStationWorkerMessageEvents.started:
- this.workerEventStarted(msg.data as ChargingStationData);
- this.emit(ChargingStationWorkerMessageEvents.started, msg.data as ChargingStationData);
- break;
+ this.emit(ChargingStationWorkerMessageEvents.started, data)
+ break
case ChargingStationWorkerMessageEvents.stopped:
- this.workerEventStopped(msg.data as ChargingStationData);
- this.emit(ChargingStationWorkerMessageEvents.stopped, msg.data as ChargingStationData);
- break;
+ this.emit(ChargingStationWorkerMessageEvents.stopped, data)
+ break
case ChargingStationWorkerMessageEvents.updated:
- this.workerEventUpdated(msg.data as ChargingStationData);
- this.emit(ChargingStationWorkerMessageEvents.updated, msg.data as ChargingStationData);
- break;
+ this.emit(ChargingStationWorkerMessageEvents.updated, data)
+ break
case ChargingStationWorkerMessageEvents.performanceStatistics:
- this.workerEventPerformanceStatistics(msg.data as Statistics);
- this.emit(
- ChargingStationWorkerMessageEvents.performanceStatistics,
- msg.data as Statistics,
- );
- break;
+ this.emit(ChargingStationWorkerMessageEvents.performanceStatistics, data)
+ break
default:
throw new BaseError(
- `Unknown event type: '${msg.id}' for data: ${JSON.stringify(msg.data, null, 2)}`,
- );
+ `Unknown charging station worker message event: '${event}' received with data: ${JSON.stringify(
+ data,
+ undefined,
+ 2
+ )}`
+ )
}
} catch (error) {
logger.error(
- `${this.logPrefix()} ${moduleName}.messageHandler: Error occurred while handling '${
- msg.id
- }' event:`,
- error,
- );
+ `${this.logPrefix()} ${moduleName}.messageHandler: Error occurred while handling charging station worker message event '${event}':`,
+ error
+ )
}
}
- private workerEventStarted = (data: ChargingStationData) => {
- this.uiServer?.chargingStations.set(data.stationInfo.hashId, data);
- ++this.numberOfStartedChargingStations;
+ private readonly workerEventAdded = (data: ChargingStationData): void => {
+ this.uiServer.chargingStations.set(data.stationInfo.hashId, data)
+ logger.info(
+ `${this.logPrefix()} ${moduleName}.workerEventAdded: Charging station ${
+ data.stationInfo.chargingStationId
+ } (hashId: ${data.stationInfo.hashId}) added (${
+ this.numberOfAddedChargingStations
+ } added from ${this.numberOfConfiguredChargingStations} configured and ${
+ this.numberOfProvisionedChargingStations
+ } provisioned charging station(s))`
+ )
+ }
+
+ private readonly workerEventDeleted = (data: ChargingStationData): void => {
+ this.uiServer.chargingStations.delete(data.stationInfo.hashId)
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ const templateStatistics = this.templateStatistics.get(data.stationInfo.templateName)!
+ --templateStatistics.added
+ templateStatistics.indexes.delete(data.stationInfo.templateIndex)
+ logger.info(
+ `${this.logPrefix()} ${moduleName}.workerEventDeleted: Charging station ${
+ data.stationInfo.chargingStationId
+ } (hashId: ${data.stationInfo.hashId}) deleted (${
+ this.numberOfAddedChargingStations
+ } added from ${this.numberOfConfiguredChargingStations} configured and ${
+ this.numberOfProvisionedChargingStations
+ } provisioned charging station(s))`
+ )
+ }
+
+ private readonly workerEventStarted = (data: ChargingStationData): void => {
+ this.uiServer.chargingStations.set(data.stationInfo.hashId, data)
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ ++this.templateStatistics.get(data.stationInfo.templateName)!.started
logger.info(
`${this.logPrefix()} ${moduleName}.workerEventStarted: Charging station ${
data.stationInfo.chargingStationId
} (hashId: ${data.stationInfo.hashId}) started (${
this.numberOfStartedChargingStations
- } started from ${this.numberOfChargingStations})`,
- );
- };
+ } started from ${this.numberOfAddedChargingStations} added charging station(s))`
+ )
+ }
- private workerEventStopped = (data: ChargingStationData) => {
- this.uiServer?.chargingStations.set(data.stationInfo.hashId, data);
- --this.numberOfStartedChargingStations;
+ private readonly workerEventStopped = (data: ChargingStationData): void => {
+ this.uiServer.chargingStations.set(data.stationInfo.hashId, data)
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ --this.templateStatistics.get(data.stationInfo.templateName)!.started
logger.info(
`${this.logPrefix()} ${moduleName}.workerEventStopped: Charging station ${
data.stationInfo.chargingStationId
} (hashId: ${data.stationInfo.hashId}) stopped (${
this.numberOfStartedChargingStations
- } started from ${this.numberOfChargingStations})`,
- );
- };
-
- private workerEventUpdated = (data: ChargingStationData) => {
- this.uiServer?.chargingStations.set(data.stationInfo.hashId, data);
- };
-
- private workerEventPerformanceStatistics = (data: Statistics) => {
- this.storage.storePerformanceStatistics(data) as void;
- };
-
- private initializeCounters() {
- if (this.initializedCounters === false) {
- this.resetCounters();
- const stationTemplateUrls = Configuration.getStationTemplateUrls()!;
- if (isNotEmptyArray(stationTemplateUrls)) {
- this.numberOfChargingStationTemplates = stationTemplateUrls.length;
- for (const stationTemplateUrl of stationTemplateUrls) {
- this.numberOfChargingStations += stationTemplateUrl.numberOfStations ?? 0;
- }
- } else {
- console.warn(
- chalk.yellow("'stationTemplateUrls' not defined or empty in configuration, exiting"),
- );
- process.exit(exitCodes.missingChargingStationsConfiguration);
- }
- if (this.numberOfChargingStations === 0) {
- console.warn(
- chalk.yellow('No charging station template enabled in configuration, exiting'),
- );
- process.exit(exitCodes.noChargingStationTemplates);
- }
- this.initializedCounters = true;
+ } started from ${this.numberOfAddedChargingStations} added charging station(s))`
+ )
+ }
+
+ private readonly workerEventUpdated = (data: ChargingStationData): void => {
+ this.uiServer.chargingStations.set(data.stationInfo.hashId, data)
+ }
+
+ private readonly workerEventPerformanceStatistics = (data: Statistics): void => {
+ // eslint-disable-next-line @typescript-eslint/unbound-method
+ if (isAsyncFunction(this.storage?.storePerformanceStatistics)) {
+ (
+ this.storage.storePerformanceStatistics as (
+ performanceStatistics: Statistics
+ ) => Promise<void>
+ )(data).catch(Constants.EMPTY_FUNCTION)
+ } else {
+ (this.storage?.storePerformanceStatistics as (performanceStatistics: Statistics) => void)(
+ data
+ )
}
}
- private resetCounters(): void {
- this.numberOfChargingStationTemplates = 0;
- this.numberOfChargingStations = 0;
- this.numberOfStartedChargingStations = 0;
+ private initializeCounters (): void {
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ const stationTemplateUrls = Configuration.getStationTemplateUrls()!
+ if (isNotEmptyArray(stationTemplateUrls)) {
+ for (const stationTemplateUrl of stationTemplateUrls) {
+ const templateName = buildTemplateName(stationTemplateUrl.file)
+ this.templateStatistics.set(templateName, {
+ configured: stationTemplateUrl.numberOfStations,
+ provisioned: stationTemplateUrl.provisionedNumberOfStations ?? 0,
+ added: 0,
+ started: 0,
+ indexes: new Set<number>()
+ })
+ this.uiServer.chargingStationTemplates.add(templateName)
+ }
+ if (this.templateStatistics.size !== stationTemplateUrls.length) {
+ console.error(
+ chalk.red(
+ "'stationTemplateUrls' contains duplicate entries, please check your configuration"
+ )
+ )
+ exit(exitCodes.duplicateChargingStationTemplateUrls)
+ }
+ } else {
+ console.error(
+ chalk.red("'stationTemplateUrls' not defined or empty, please check your configuration")
+ )
+ exit(exitCodes.missingChargingStationsConfiguration)
+ }
+ if (
+ this.numberOfConfiguredChargingStations === 0 &&
+ Configuration.getConfigurationSection<UIServerConfiguration>(ConfigurationSection.uiServer)
+ .enabled !== true
+ ) {
+ console.error(
+ chalk.red(
+ "'stationTemplateUrls' has no charging station enabled and UI server is disabled, please check your configuration"
+ )
+ )
+ exit(exitCodes.noChargingStationTemplates)
+ }
}
- private async startChargingStation(
+ public async addChargingStation (
index: number,
- stationTemplateUrl: StationTemplateUrl,
- ): Promise<void> {
- await this.workerImplementation?.addElement({
+ templateFile: string,
+ options?: ChargingStationOptions
+ ): Promise<ChargingStationInfo | undefined> {
+ if (!this.started && !this.starting) {
+ throw new BaseError(
+ 'Cannot add charging station while the charging stations simulator is not started'
+ )
+ }
+ const stationInfo = await this.workerImplementation?.addElement({
index,
templateFile: join(
dirname(fileURLToPath(import.meta.url)),
'assets',
'station-templates',
- stationTemplateUrl.file,
+ templateFile
),
- });
+ options
+ })
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ const templateStatistics = this.templateStatistics.get(buildTemplateName(templateFile))!
+ ++templateStatistics.added
+ templateStatistics.indexes.add(index)
+ return stationInfo
}
- private gracefulShutdown = (): void => {
- console.info(`${chalk.green('Graceful shutdown')}`);
+ private gracefulShutdown (): void {
this.stop()
.then(() => {
- process.exit(0);
+ console.info(chalk.green('Graceful shutdown'))
+ this.uiServer.stop()
+ this.uiServerStarted = false
+ this.waitChargingStationsStopped()
+ .then(() => {
+ exit(exitCodes.succeeded)
+ })
+ .catch(() => {
+ exit(exitCodes.gracefulShutdownError)
+ })
+ })
+ .catch((error: unknown) => {
+ console.error(chalk.red('Error while shutdowning charging stations simulator: '), error)
+ exit(exitCodes.gracefulShutdownError)
})
- .catch((error) => {
- console.error(chalk.red('Error while shutdowning charging stations simulator: '), error);
- process.exit(1);
- });
- };
-
- private logPrefix = (): string => {
- return logPrefix(' Bootstrap |');
- };
+ }
+
+ private readonly logPrefix = (): string => {
+ return logPrefix(' Bootstrap |')
+ }
}