X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fworker.ts;h=2da91457aed58994f01714a162adffba69ab61fe;hb=3d76750ac8dacd95003ca89cf9542c3b2a014b8c;hp=81b49d3bc4a0f02fb99f964b626fecae387c2d33;hpb=658b9aa08266ed9a8ae3c0fc947d237fa2674f09;p=poolifier.git diff --git a/src/pools/worker.ts b/src/pools/worker.ts index 81b49d3b..2da91457 100644 --- a/src/pools/worker.ts +++ b/src/pools/worker.ts @@ -1,4 +1,6 @@ +import type { MessageChannel } from 'node:worker_threads' import type { CircularArray } from '../circular-array' +import type { Task } from '../utility-types' /** * Callback invoked if the worker has received a message. @@ -29,31 +31,6 @@ export type ExitHandler = ( exitCode: number ) => void -/** - * Message object that is passed as a task between main worker and worker. - * - * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data. - * @internal - */ -export interface Task { - /** - * Task name. - */ - readonly name?: string - /** - * Task input data that will be passed to the worker. - */ - readonly data?: Data - /** - * Timestamp. - */ - readonly timestamp?: number - /** - * Message UUID. - */ - readonly id?: string -} - /** * Measurement statistics. * @@ -118,7 +95,7 @@ export interface TaskStatistics { /** * Maximum number of queued tasks. */ - readonly maxQueued: number + readonly maxQueued?: number /** * Number of failed tasks. */ @@ -129,8 +106,8 @@ export interface TaskStatistics { * Enumeration of worker types. */ export const WorkerTypes = Object.freeze({ - cluster: 'cluster', - thread: 'thread' + thread: 'thread', + cluster: 'cluster' } as const) /** @@ -157,9 +134,13 @@ export interface WorkerInfo { */ dynamic: boolean /** - * Started flag. + * Ready flag. + */ + ready: boolean + /** + * Message channel. */ - started: boolean + messageChannel?: MessageChannel } /** @@ -223,42 +204,50 @@ export interface IWorker { */ export interface IWorkerNode { /** - * Worker node worker. + * Worker. */ readonly worker: Worker /** - * Worker node worker info. + * Worker info. */ readonly info: WorkerInfo /** - * Worker node worker usage statistics. + * Worker usage statistics. */ usage: WorkerUsage /** - * Worker node tasks queue size. + * Tasks queue size. * * @returns The tasks queue size. */ readonly tasksQueueSize: () => number /** - * Worker node enqueue task. + * Enqueue task. * * @param task - The task to queue. * @returns The task queue size. */ readonly enqueueTask: (task: Task) => number /** - * Worker node dequeue task. + * Dequeue task. * * @returns The dequeued task. */ readonly dequeueTask: () => Task | undefined /** - * Worker node clear tasks queue. + * Clears tasks queue. */ readonly clearTasksQueue: () => void /** - * Worker node reset usage statistics . + * Resets usage statistics . */ readonly resetUsage: () => void + /** + * Close communication channel. + */ + readonly closeChannel: () => void + /** + * Gets task worker usage statistics. + */ + readonly getTaskWorkerUsage: (name: string) => WorkerUsage | undefined }