build: properly workaround Ajv TS type definitions bug
[e-mobility-charging-stations-simulator.git] / src / worker / WorkerAbstract.ts
index 0fccdb812d7ed4c2a40b28596a3cfc883ed606e3..e78216def1d2aff36ce53572b30044a109675c28 100644 (file)
@@ -1,13 +1,18 @@
-import fs from 'fs';
+import type { EventEmitterAsyncResource } from 'node:events';
+import { existsSync } from 'node:fs';
 
-import WorkerConstants from './WorkerConstants';
-import type { WorkerData, WorkerOptions } from '../types/Worker';
+import type { PoolInfo } from 'poolifier';
 
-export default abstract class WorkerAbstract<T extends WorkerData> {
+import type { SetInfo, WorkerData, WorkerOptions } from './WorkerTypes.js';
+import { defaultErrorHandler, defaultExitHandler } from './WorkerUtils.js';
+
+export abstract class WorkerAbstract<T extends WorkerData> {
   protected readonly workerScript: string;
   protected readonly workerOptions: WorkerOptions;
+  public abstract readonly info: PoolInfo | SetInfo;
   public abstract readonly size: number;
-  public abstract readonly maxElementsPerWorker: number | null;
+  public abstract readonly maxElementsPerWorker: number | undefined;
+  public abstract readonly emitter: EventEmitterAsyncResource | undefined;
 
   /**
    * `WorkerAbstract` constructor.
@@ -15,31 +20,39 @@ export default abstract class WorkerAbstract<T extends WorkerData> {
    * @param workerScript -
    * @param workerOptions -
    */
-  constructor(
-    workerScript: string,
-    workerOptions: WorkerOptions = {
-      workerStartDelay: WorkerConstants.DEFAULT_WORKER_START_DELAY,
-      elementStartDelay: WorkerConstants.DEFAULT_ELEMENT_START_DELAY,
-      poolMinSize: WorkerConstants.DEFAULT_POOL_MIN_SIZE,
-      poolMaxSize: WorkerConstants.DEFAULT_POOL_MAX_SIZE,
-      elementsPerWorker: WorkerConstants.DEFAULT_ELEMENTS_PER_WORKER,
-      poolOptions: {},
-      messageHandler: () => {
-        /* This is intentional */
-      },
+  constructor(workerScript: string, workerOptions: WorkerOptions) {
+    if (workerScript == null) {
+      throw new TypeError('Worker script is not defined');
+    }
+    if (typeof workerScript !== 'string') {
+      throw new TypeError('Worker script must be a string');
     }
-  ) {
-    if (!workerScript) {
-      throw new Error('Worker script is not defined');
+    if (workerScript.trim().length === 0) {
+      throw new Error('Worker script is an empty string');
     }
-    if (!fs.existsSync(workerScript)) {
+    if (!existsSync(workerScript)) {
       throw new Error('Worker script file does not exist');
     }
     this.workerScript = workerScript;
     this.workerOptions = workerOptions;
+    this.workerOptions.poolOptions!.errorHandler =
+      this.workerOptions.poolOptions?.errorHandler ?? defaultErrorHandler;
+    this.workerOptions.poolOptions!.exitHandler =
+      this.workerOptions.poolOptions?.exitHandler ?? defaultExitHandler;
   }
 
+  /**
+   * Starts the worker pool/set.
+   */
   public abstract start(): Promise<void>;
+  /**
+   * Stops the worker pool/set.
+   */
   public abstract stop(): Promise<void>;
+  /**
+   * Adds a task element to the worker pool/set.
+   *
+   * @param elementData -
+   */
   public abstract addElement(elementData: T): Promise<void>;
 }