X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fpool-internal.ts;h=0c2454f83f9dbebbc48358ad3ab2e7c8c81fb77d;hb=4ac4f9763953bff98fa66c950a8c01284ffd5332;hp=6152e3a421a60bf65d64804e491c35a663c7d1c1;hpb=4a6952ffec2bc4dba2d73bd747c003d0fe59fe7c;p=poolifier.git diff --git a/src/pools/pool-internal.ts b/src/pools/pool-internal.ts index 6152e3a4..0c2454f8 100644 --- a/src/pools/pool-internal.ts +++ b/src/pools/pool-internal.ts @@ -1,11 +1,23 @@ -import EventEmitter from 'events' -import type { IWorker } from './abstract-pool' import type { IPool } from './pool' +import type { IPoolWorker } from './pool-worker' /** - * Internal poolifier pool emitter. + * Internal pool types. */ -export class PoolEmitter extends EventEmitter {} +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. @@ -15,7 +27,7 @@ export class PoolEmitter extends EventEmitter {} * @template Response Type of response of execution. */ export interface IPoolInternal< - Worker extends IWorker, + Worker extends IPoolWorker, Data = unknown, Response = unknown > extends IPool { @@ -25,31 +37,64 @@ export interface IPoolInternal< readonly workers: Worker[] /** - * The tasks map. + * The workers tasks usage map. + * + * `key`: The `Worker` + * `value`: Worker tasks usage statistics. + */ + readonly workersTasksUsage: Map + + /** + * Pool type. + * + * If it is `'dynamic'`, it provides the `max` property. + */ + readonly type: PoolType + + /** + * Whether the pool is busy or not. * - * - `key`: The `Worker` - * - `value`: Number of tasks currently in progress on the worker. + * The pool busyness boolean status. + */ + readonly busy: boolean + + /** + * Number of tasks currently concurrently running. */ - readonly tasks: Map + readonly numberOfRunningTasks: number /** - * Emitter on which events can be listened to. + * Finds a free worker 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. * - * Events that can currently be listened to: + * If no free worker is found, `false` is returned. * - * - `'FullPool'` + * @returns A free worker if there is one, otherwise `false`. */ - readonly emitter: PoolEmitter + findFreeWorker: () => Worker | false /** - * Whether the pool is dynamic or not. + * Gets worker index. * - * If it is dynamic, it provides the `max` property. + * @param worker The worker. + * @returns The worker index. */ - readonly dynamic: boolean + getWorkerIndex: (worker: Worker) => number /** - * Maximum number of workers that can be created by this pool. + * 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. + * + * @param worker The worker. + * @returns The average tasks runtime on the worker. */ - readonly max?: number + getWorkerAverageTasksRunTime: (worker: Worker) => number | undefined }