poolifier 2.6.36 → 2.6.38

package/lib/deque.d.ts

@@ -1,80 +0,0 @@
-/**
- * @internal
- */
-export declare class Node<T> {
-    value: T;
-    next?: Node<T>;
-    prev?: Node<T>;
-    constructor(value: T);
-}
-/**
- * Deque.
- * Implemented with a doubly linked list.
- *
- * @typeParam T - Type of deque values.
- * @internal
- */
-export declare class Deque<T> {
-    private head?;
-    private tail?;
-    /** The size of the deque. */
-    size: number;
-    /** The maximum size of the deque. */
-    maxSize: number;
-    constructor();
-    /**
-     * Appends a value to the deque.
-     *
-     * @param value - Value to append.
-     * @returns The new size of the queue.
-     */
-    push(value: T): number;
-    /**
-     * Prepends a value to the deque.
-     *
-     * @param value - Value to prepend.
-     * @returns The new size of the queue.
-     */
-    unshift(value: T): number;
-    /**
-     * Pops a value from the deque.
-     *
-     * @returns The popped value or `undefined` if the deque is empty.
-     */
-    pop(): T | undefined;
-    /**
-     * Shifts a value from the deque.
-     *
-     * @returns The shifted value or `undefined` if the deque is empty.
-     */
-    shift(): T | undefined;
-    /**
-     * Peeks at the first value.
-     * @returns The first value or `undefined` if the deque is empty.
-     */
-    peekFirst(): T | undefined;
-    /**
-     * Peeks at the last value.
-     * @returns The last value or `undefined` if the deque is empty.
-     */
-    peekLast(): T | undefined;
-    /**
-     * Clears the deque.
-     */
-    clear(): void;
-    /**
-     * Returns an iterator for the deque.
-     *
-     * @returns An iterator for the deque.
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols
-     */
-    [Symbol.iterator](): Iterator<T>;
-    /**
-     * Returns an backward iterator for the deque.
-     *
-     * @returns An backward iterator for the deque.
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols
-     */
-    backward(): Iterable<T>;
-    private incrementSize;
-}

package/lib/pools/abstract-pool.d.ts

@@ -1,314 +0,0 @@
-/// <reference types="node" />
-import { type TransferListItem } from 'node:worker_threads';
-import type { MessageValue, PromiseResponseWrapper, Task } from '../utility-types';
-import { type IPool, PoolEmitter, type PoolInfo, type PoolOptions, type PoolType, type TasksQueueOptions } from './pool';
-import type { IWorker, IWorkerNode, WorkerInfo, WorkerType } from './worker';
-import { type WorkerChoiceStrategy, type WorkerChoiceStrategyOptions } from './selection-strategies/selection-strategies-types';
-import { WorkerChoiceStrategyContext } from './selection-strategies/worker-choice-strategy-context';
-/**
- * Base class that implements some shared logic for all poolifier pools.
- *
- * @typeParam Worker - Type of worker which manages this pool.
- * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
- * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
- */
-export declare abstract class AbstractPool<Worker extends IWorker, Data = unknown, Response = unknown> implements IPool<Worker, Data, Response> {
-    protected readonly numberOfWorkers: number;
-    protected readonly filePath: string;
-    protected readonly opts: PoolOptions<Worker>;
-    /** @inheritDoc */
-    readonly workerNodes: Array<IWorkerNode<Worker, Data>>;
-    /** @inheritDoc */
-    readonly emitter?: PoolEmitter;
-    /**
-     * The task execution response promise map.
-     *
-     * - `key`: The message id of each submitted task.
-     * - `value`: An object that contains the worker, the execution response promise resolve and reject callbacks.
-     *
-     * When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.
-     */
-    protected promiseResponseMap: Map<string, PromiseResponseWrapper<Response>>;
-    /**
-     * Worker choice strategy context referencing a worker choice algorithm implementation.
-     */
-    protected workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>;
-    /**
-     * Dynamic pool maximum size property placeholder.
-     */
-    protected readonly max?: number;
-    /**
-     * Whether the pool is starting or not.
-     */
-    private readonly starting;
-    /**
-     * Whether the pool is started or not.
-     */
-    private started;
-    /**
-     * The start timestamp of the pool.
-     */
-    private readonly startTimestamp;
-    /**
-     * Constructs a new poolifier pool.
-     *
-     * @param numberOfWorkers - Number of workers that this pool should manage.
-     * @param filePath - Path to the worker file.
-     * @param opts - Options for the pool.
-     */
-    constructor(numberOfWorkers: number, filePath: string, opts: PoolOptions<Worker>);
-    private checkFilePath;
-    private checkNumberOfWorkers;
-    protected checkDynamicPoolSize(min: number, max: number): void;
-    private checkPoolOptions;
-    private checkValidWorkerChoiceStrategy;
-    private checkValidWorkerChoiceStrategyOptions;
-    private checkValidTasksQueueOptions;
-    private startPool;
-    /** @inheritDoc */
-    get info(): PoolInfo;
-    /**
-     * The pool readiness boolean status.
-     */
-    private get ready();
-    /**
-     * The approximate pool utilization.
-     *
-     * @returns The pool utilization.
-     */
-    private get utilization();
-    /**
-     * The pool type.
-     *
-     * If it is `'dynamic'`, it provides the `max` property.
-     */
-    protected abstract get type(): PoolType;
-    /**
-     * The worker type.
-     */
-    protected abstract get worker(): WorkerType;
-    /**
-     * The pool minimum size.
-     */
-    protected get minSize(): number;
-    /**
-     * The pool maximum size.
-     */
-    protected get maxSize(): number;
-    /**
-     * Checks if the worker id sent in the received message from a worker is valid.
-     *
-     * @param message - The received message.
-     * @throws {@link https://nodejs.org/api/errors.html#class-error} If the worker id is invalid.
-     */
-    private checkMessageWorkerId;
-    /**
-     * Gets the given worker its worker node key.
-     *
-     * @param worker - The worker.
-     * @returns The worker node key if found in the pool worker nodes, `-1` otherwise.
-     */
-    private getWorkerNodeKeyByWorker;
-    /**
-     * Gets the worker node key given its worker id.
-     *
-     * @param workerId - The worker id.
-     * @returns The worker node key if the worker id is found in the pool worker nodes, `-1` otherwise.
-     */
-    private getWorkerNodeKeyByWorkerId;
-    /** @inheritDoc */
-    setWorkerChoiceStrategy(workerChoiceStrategy: WorkerChoiceStrategy, workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions): void;
-    /** @inheritDoc */
-    setWorkerChoiceStrategyOptions(workerChoiceStrategyOptions: WorkerChoiceStrategyOptions): void;
-    /** @inheritDoc */
-    enableTasksQueue(enable: boolean, tasksQueueOptions?: TasksQueueOptions): void;
-    /** @inheritDoc */
-    setTasksQueueOptions(tasksQueueOptions: TasksQueueOptions): void;
-    private setTasksQueueMaxSize;
-    private buildTasksQueueOptions;
-    /**
-     * Whether the pool is full or not.
-     *
-     * The pool filling boolean status.
-     */
-    protected get full(): boolean;
-    /**
-     * Whether the pool is busy or not.
-     *
-     * The pool busyness boolean status.
-     */
-    protected abstract get busy(): boolean;
-    /**
-     * Whether worker nodes are executing concurrently their tasks quota or not.
-     *
-     * @returns Worker nodes busyness boolean status.
-     */
-    protected internalBusy(): boolean;
-    /** @inheritDoc */
-    listTaskFunctions(): string[];
-    /** @inheritDoc */
-    execute(data?: Data, name?: string, transferList?: TransferListItem[]): Promise<Response>;
-    /** @inheritDoc */
-    destroy(): Promise<void>;
-    protected sendKillMessageToWorker(workerNodeKey: number, workerId: number): Promise<void>;
-    /**
-     * Terminates the worker node given its worker node key.
-     *
-     * @param workerNodeKey - The worker node key.
-     */
-    protected abstract destroyWorkerNode(workerNodeKey: number): Promise<void>;
-    /**
-     * Setup hook to execute code before worker nodes are created in the abstract constructor.
-     * Can be overridden.
-     *
-     * @virtual
-     */
-    protected setupHook(): void;
-    /**
-     * Should return whether the worker is the main worker or not.
-     */
-    protected abstract isMain(): boolean;
-    /**
-     * Hook executed before the worker task execution.
-     * Can be overridden.
-     *
-     * @param workerNodeKey - The worker node key.
-     * @param task - The task to execute.
-     */
-    protected beforeTaskExecutionHook(workerNodeKey: number, task: Task<Data>): void;
-    /**
-     * Hook executed after the worker task execution.
-     * Can be overridden.
-     *
-     * @param workerNodeKey - The worker node key.
-     * @param message - The received message.
-     */
-    protected afterTaskExecutionHook(workerNodeKey: number, message: MessageValue<Response>): void;
-    /**
-     * Whether the worker node shall update its task function worker usage or not.
-     *
-     * @param workerNodeKey - The worker node key.
-     * @returns `true` if the worker node shall update its task function worker usage, `false` otherwise.
-     */
-    private shallUpdateTaskFunctionWorkerUsage;
-    private updateTaskStatisticsWorkerUsage;
-    private updateRunTimeWorkerUsage;
-    private updateWaitTimeWorkerUsage;
-    private updateEluWorkerUsage;
-    /**
-     * Chooses a worker node for the next task.
-     *
-     * The default worker choice strategy uses a round robin algorithm to distribute the tasks.
-     *
-     * @returns The chosen worker node key
-     */
-    private chooseWorkerNode;
-    /**
-     * Conditions for dynamic worker creation.
-     *
-     * @returns Whether to create a dynamic worker or not.
-     */
-    private shallCreateDynamicWorker;
-    /**
-     * Sends a message to worker given its worker node key.
-     *
-     * @param workerNodeKey - The worker node key.
-     * @param message - The message.
-     * @param transferList - The optional array of transferable objects.
-     */
-    protected abstract sendToWorker(workerNodeKey: number, message: MessageValue<Data>, transferList?: TransferListItem[]): void;
-    /**
-     * Creates a new worker.
-     *
-     * @returns Newly created worker.
-     */
-    protected abstract createWorker(): Worker;
-    /**
-     * Creates a new, completely set up worker node.
-     *
-     * @returns New, completely set up worker node key.
-     */
-    protected createAndSetupWorkerNode(): number;
-    /**
-     * Creates a new, completely set up dynamic worker node.
-     *
-     * @returns New, completely set up dynamic worker node key.
-     */
-    protected createAndSetupDynamicWorkerNode(): number;
-    /**
-     * Registers a listener callback on the worker given its worker node key.
-     *
-     * @param workerNodeKey - The worker node key.
-     * @param listener - The message listener callback.
-     */
-    protected abstract registerWorkerMessageListener<Message extends Data | Response>(workerNodeKey: number, listener: (message: MessageValue<Message>) => void): void;
-    /**
-     * Method hooked up after a worker node has been newly created.
-     * Can be overridden.
-     *
-     * @param workerNodeKey - The newly created worker node key.
-     */
-    protected afterWorkerNodeSetup(workerNodeKey: number): void;
-    /**
-     * Sends the startup message to worker given its worker node key.
-     *
-     * @param workerNodeKey - The worker node key.
-     */
-    protected abstract sendStartupMessageToWorker(workerNodeKey: number): void;
-    /**
-     * Sends the statistics message to worker given its worker node key.
-     *
-     * @param workerNodeKey - The worker node key.
-     */
-    private sendStatisticsMessageToWorker;
-    private redistributeQueuedTasks;
-    private taskStealingOnEmptyQueue;
-    private tasksStealingOnBackPressure;
-    /**
-     * This method is the listener registered for each worker message.
-     *
-     * @returns The listener function to execute when a message is received from a worker.
-     */
-    protected workerListener(): (message: MessageValue<Response>) => void;
-    private handleWorkerReadyResponse;
-    private handleTaskExecutionResponse;
-    private checkAndEmitTaskExecutionEvents;
-    private checkAndEmitTaskQueuingEvents;
-    private checkAndEmitDynamicWorkerCreationEvents;
-    /**
-     * Gets the worker information given its worker node key.
-     *
-     * @param workerNodeKey - The worker node key.
-     * @returns The worker information.
-     */
-    protected getWorkerInfo(workerNodeKey: number): WorkerInfo | undefined;
-    /**
-     * Adds the given worker in the pool worker nodes.
-     *
-     * @param worker - The worker.
-     * @returns The added worker node key.
-     * @throws {@link https://nodejs.org/api/errors.html#class-error} If the added worker node is not found.
-     */
-    private addWorkerNode;
-    /**
-     * Removes the given worker from the pool worker nodes.
-     *
-     * @param worker - The worker.
-     */
-    private removeWorkerNode;
-    /** @inheritDoc */
-    hasWorkerNodeBackPressure(workerNodeKey: number): boolean;
-    private hasBackPressure;
-    /**
-     * Executes the given task on the worker given its worker node key.
-     *
-     * @param workerNodeKey - The worker node key.
-     * @param task - The task to execute.
-     */
-    private executeTask;
-    private enqueueTask;
-    private dequeueTask;
-    private tasksQueueSize;
-    protected flushTasksQueue(workerNodeKey: number): void;
-    private flushTasksQueues;
-}

package/lib/pools/cluster/dynamic.d.ts

@@ -1,29 +0,0 @@
-import { type PoolType } from '../pool';
-import { type ClusterPoolOptions, FixedClusterPool } from './fixed';
-/**
- * A cluster pool with a dynamic number of workers, but a guaranteed minimum number of workers.
- *
- * This cluster pool creates new workers when the others are busy, up to the maximum number of workers.
- * When the maximum number of workers is reached and workers are busy, an event is emitted. If you want to listen to this event, use the pool's `emitter`.
- *
- * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
- * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
- * @author [Christopher Quadflieg](https://github.com/Shinigami92)
- * @since 2.0.0
- */
-export declare class DynamicClusterPool<Data = unknown, Response = unknown> extends FixedClusterPool<Data, Response> {
-    protected readonly max: number;
-    /**
-     * Constructs a new poolifier dynamic cluster pool.
-     *
-     * @param min - Minimum number of workers which are always active.
-     * @param max - Maximum number of workers that can be created by this pool.
-     * @param filePath - Path to an implementation of a `ClusterWorker` file, which can be relative or absolute.
-     * @param opts - Options for this dynamic cluster pool.
-     */
-    constructor(min: number, max: number, filePath: string, opts?: ClusterPoolOptions);
-    /** @inheritDoc */
-    protected get type(): PoolType;
-    /** @inheritDoc */
-    protected get busy(): boolean;
-}

package/lib/pools/cluster/fixed.d.ts

@@ -1,62 +0,0 @@
-/// <reference types="node" />
-import { type ClusterSettings, type Worker } from 'node:cluster';
-import type { MessageValue } from '../../utility-types';
-import { AbstractPool } from '../abstract-pool';
-import { type PoolOptions, type PoolType } from '../pool';
-import { type WorkerType } from '../worker';
-/**
- * Options for a poolifier cluster pool.
- */
-export interface ClusterPoolOptions extends PoolOptions<Worker> {
-    /**
-     * Key/value pairs to add to worker process environment.
-     *
-     * @see https://nodejs.org/api/cluster.html#cluster_cluster_fork_env
-     */
-    env?: Record<string, unknown>;
-    /**
-     * Cluster settings.
-     *
-     * @see https://nodejs.org/api/cluster.html#cluster_cluster_settings
-     */
-    settings?: ClusterSettings;
-}
-/**
- * A cluster pool with a fixed number of workers.
- *
- * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
- * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
- * @author [Christopher Quadflieg](https://github.com/Shinigami92)
- * @since 2.0.0
- */
-export declare class FixedClusterPool<Data = unknown, Response = unknown> extends AbstractPool<Worker, Data, Response> {
-    protected readonly opts: ClusterPoolOptions;
-    /**
-     * Constructs a new poolifier fixed cluster pool.
-     *
-     * @param numberOfWorkers - Number of workers for this pool.
-     * @param filePath - Path to an implementation of a `ClusterWorker` file, which can be relative or absolute.
-     * @param opts - Options for this fixed cluster pool.
-     */
-    constructor(numberOfWorkers: number, filePath: string, opts?: ClusterPoolOptions);
-    /** @inheritDoc */
-    protected setupHook(): void;
-    /** @inheritDoc */
-    protected isMain(): boolean;
-    /** @inheritDoc */
-    protected destroyWorkerNode(workerNodeKey: number): Promise<void>;
-    /** @inheritDoc */
-    protected sendToWorker(workerNodeKey: number, message: MessageValue<Data>): void;
-    /** @inheritDoc */
-    protected sendStartupMessageToWorker(workerNodeKey: number): void;
-    /** @inheritDoc */
-    protected registerWorkerMessageListener<Message extends Data | Response>(workerNodeKey: number, listener: (message: MessageValue<Message>) => void): void;
-    /** @inheritDoc */
-    protected createWorker(): Worker;
-    /** @inheritDoc */
-    protected get type(): PoolType;
-    /** @inheritDoc */
-    protected get worker(): WorkerType;
-    /** @inheritDoc */
-    protected get busy(): boolean;
-}