X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Futility-types.ts;h=f330d192296dcc62a5b86a4209126d21798acff6;hb=25f5b5de1c522d29f7a16597245a2f7c9434b124;hp=9cdf6b0a7e82f9d1e3da5fb434537ca8e2d943f9;hpb=b6b3245344bd453ea91fa3d74acd5145f70d84fd;p=poolifier.git diff --git a/src/utility-types.ts b/src/utility-types.ts index 9cdf6b0a..f330d192 100644 --- a/src/utility-types.ts +++ b/src/utility-types.ts @@ -1,36 +1,58 @@ -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. + */ + message: string + /** + * Data passed to the worker triggering the error. + */ + data?: Data +} + +/** + * Task performance. + */ +export interface TaskPerformance { + /** + * Task performance timestamp. + */ + timestamp: number + /** + * Task runtime. + */ + runTime?: number + /** + * Task event loop utilization. + */ + elu?: EventLoopUtilization +} /** * Performance statistics computation. */ 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. */ @@ -38,27 +60,11 @@ export interface MessageValue< /** * Task error. */ - readonly error?: string - /** - * Task data triggering task error. - */ - readonly errorData?: unknown - /** - * Runtime. - */ - readonly runTime?: number - /** - * Wait time. - */ - readonly waitTime?: number - /** - * Event loop utilization. - */ - readonly elu?: EventLoopUtilization + readonly taskError?: TaskError /** - * Reference to main worker. + * Task performance. */ - readonly parent?: MainWorker + readonly taskPerformance?: TaskPerformance /** * Whether to compute the given statistics or not. */ @@ -69,7 +75,7 @@ export interface MessageValue< * 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<