X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Futility-types.ts;h=a8da491e16fe62143d1d716672c4b4db44aa8e9f;hb=21f710aa73abbb5d90328cfb199adfc0f7a70406;hp=faeda0a5a4e4048ed9c16b5e48d8bdecd4b8c690;hpb=d715b7bc2973eed82edebb1f7d233d451ad3c97b;p=poolifier.git diff --git a/src/utility-types.ts b/src/utility-types.ts index faeda0a5..a8da491e 100644 --- a/src/utility-types.ts +++ b/src/utility-types.ts @@ -1,89 +1,93 @@ -import type { Worker as ClusterWorker } from 'node:cluster' -import type { MessagePort } from 'node:worker_threads' import type { EventLoopUtilization } from 'node:perf_hooks' import type { KillBehavior } from './worker/worker-options' import type { IWorker, Task } from './pools/worker' /** - * Make all properties in T non-readonly. + * Task error. * - * @typeParam T - Type in which properties will be non-readonly. + * @typeParam Data - Type of data sent to the worker triggering an error. This can only be structured-cloneable data. */ -export type Draft = { -readonly [P in keyof T]?: T[P] } +export interface TaskError { + /** + * Error message. + */ + readonly message: string + /** + * Data passed to the worker triggering the error. + */ + readonly data?: Data +} /** * Task performance. + * + * @internal */ export interface TaskPerformance { /** * Task performance timestamp. */ - timestamp: number + readonly timestamp: number /** * Task runtime. */ - runTime?: number - /** - * Task wait time. - */ - waitTime?: number + readonly runTime?: number /** * Task event loop utilization. */ - elu?: EventLoopUtilization + readonly elu?: EventLoopUtilization } /** * Performance statistics computation. + * + * @internal */ export interface WorkerStatistics { runTime: boolean - waitTime: boolean elu: boolean } /** * Message object that is passed between main worker and worker. * - * @typeParam Data - Type of data sent to the worker. This can only be serializable data. - * @typeParam MainWorker - Type of main worker. + * @typeParam Data - Type of data sent to the worker or execution response. This can only be structured-cloneable data. + * @typeParam ErrorData - Type of data sent to the worker triggering an error. This can only be structured-cloneable data. * @internal */ -export interface MessageValue< - Data = unknown, - MainWorker extends ClusterWorker | MessagePort = ClusterWorker | MessagePort -> extends Task { +export interface MessageValue + extends Task { /** * Kill code. */ - readonly kill?: KillBehavior | 1 + readonly kill?: KillBehavior | true /** * Task error. */ - readonly error?: string - /** - * Task data triggering task error. - */ - readonly errorData?: unknown + readonly taskError?: TaskError /** * Task performance. */ readonly taskPerformance?: TaskPerformance /** - * Reference to main worker. + * Whether the worker computes the given statistics or not. */ - readonly parent?: MainWorker + readonly statistics?: WorkerStatistics /** - * Whether to compute the given statistics or not. + * Whether the worker is ready or not. */ - readonly statistics?: WorkerStatistics + readonly ready?: boolean + /** + * Whether the worker starts or stops its aliveness check. + */ + readonly checkAlive?: boolean } /** * An object holding the execution response promise resolve/reject callbacks. * * @typeParam Worker - Type of worker. - * @typeParam Response - Type of execution response. This can only be serializable data. + * @typeParam Response - Type of execution response. This can only be structured-cloneable data. * @internal */ export interface PromiseResponseWrapper<