X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fpool-internal.ts;h=8912dd2c18f8a99a6791b006f672442e5be5ecdf;hb=f9f00b5f18805c14b1bac3b2e5d2e8b5abc6c66c;hp=470ccdd5938e04ac8585ddc1fb6afc906919d02e;hpb=b4904890be69e53510b67172dda7b6bbf50a635a;p=poolifier.git diff --git a/src/pools/pool-internal.ts b/src/pools/pool-internal.ts index 470ccdd5..8912dd2c 100644 --- a/src/pools/pool-internal.ts +++ b/src/pools/pool-internal.ts @@ -1,48 +1,32 @@ import type { IPool } from './pool' -import type { IPoolWorker } from './pool-worker' +import type { IWorker, WorkerNode } from './worker' /** * Internal pool types. + * + * @enum */ export enum PoolType { FIXED = 'fixed', DYNAMIC = 'dynamic' } -/** - * Internal tasks usage statistics. - */ -export interface TasksUsage { - run: number - running: number - runTime: number - avgRunTime: number -} - /** * Internal contract definition for a poolifier pool. * - * @template Worker Type of worker which manages this pool. - * @template Data Type of data sent to the worker. - * @template Response Type of response of execution. + * @typeParam Worker - Type of worker which manages this pool. + * @typeParam Data - Type of data sent to the worker. This can only be serializable data. + * @typeParam Response - Type of response of execution. This can only be serializable data. */ export interface IPoolInternal< - Worker extends IPoolWorker, + Worker extends IWorker, Data = unknown, Response = unknown > extends IPool { /** - * List of currently available workers. + * Pool worker nodes. */ - readonly workers: Worker[] - - /** - * The workers tasks usage map. - * - * `key`: The `Worker` - * `value`: Worker tasks usage statistics. - */ - readonly workersTasksUsage: Map + readonly workerNodes: Array> /** * Pool type. @@ -52,9 +36,11 @@ export interface IPoolInternal< readonly type: PoolType /** - * Maximum number of workers that can be created by this pool. + * Whether the pool is full or not. + * + * The pool filling boolean status. */ - readonly max?: number + readonly full: boolean /** * Whether the pool is busy or not. @@ -64,42 +50,13 @@ export interface IPoolInternal< readonly busy: boolean /** - * Number of tasks currently concurrently running. - */ - readonly numberOfRunningTasks: number - - /** - * Finds a free worker based on the number of tasks the worker has applied. + * Finds a free worker node key based on the number of tasks the worker has applied. * - * If a worker is found with `0` running tasks, it is detected as free and returned. + * If a worker is found with `0` running tasks, it is detected as free and its worker node key is returned. * - * If no free worker is found, `false` is returned. - * - * @returns A free worker if there is one, otherwise `false`. - */ - findFreeWorker(): Worker | false - - /** - * Gets worker index. - * - * @param worker The worker. - * @returns The worker index. - */ - getWorkerIndex(worker: Worker): number - - /** - * Gets worker running tasks. - * - * @param worker The worker. - * @returns The number of tasks currently running on the worker. - */ - getWorkerRunningTasks(worker: Worker): number | undefined - - /** - * Gets worker average tasks runtime. + * If no free worker is found, `-1` is returned. * - * @param worker The worker. - * @returns The average tasks runtime on the worker. + * @returns A worker node key if there is one, `-1` otherwise. */ - getWorkerAverageTasksRunTime(worker: Worker): number | undefined + findFreeWorkerNodeKey: () => number }