X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Futility-types.ts;h=e48ded5373695b4f778d43da19f00c2cf5b0ee3f;hb=95311547b3ec8a54b9e4303bdd3c2c32c9c1e893;hp=e177adaeb7ccaf8022c338013284201e23ed1ed7;hpb=d3c8a1a8022726094160d1413f1f289c5d84d715;p=poolifier.git diff --git a/src/utility-types.ts b/src/utility-types.ts index e177adae..e48ded53 100644 --- a/src/utility-types.ts +++ b/src/utility-types.ts @@ -1,15 +1,66 @@ -export type Draft = { -readonly [P in keyof T]?: T[P] } +import type { Worker as ClusterWorker } from 'node:cluster' +import type { MessagePort } from 'node:worker_threads' +import type { KillBehavior } from './worker/worker-options' +import type { IWorker, Task } from './pools/worker' -export type JSONPrimitive = number | boolean | string | null -// eslint-disable-next-line no-use-before-define -export type JSONValue = JSONPrimitive | JSONArray | JSONObject -export type JSONObject = { [k: string]: JSONValue } -export type JSONArray = Array +/** + * Make all properties in T non-readonly. + */ +export type Draft = { -readonly [P in keyof T]?: T[P] } -export interface MessageValue { - readonly data?: Data - readonly id?: number - readonly kill?: number +/** + * 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. + * @internal + */ +export interface MessageValue< + Data = unknown, + MainWorker extends ClusterWorker | MessagePort | unknown = unknown +> extends Task { + /** + * Kill code. + */ + readonly kill?: KillBehavior | 1 + /** + * Error. + */ readonly error?: string - readonly parent?: MessagePort + /** + * Runtime. + */ + readonly runTime?: number + /** + * Reference to main worker. + * + * Only for internal use. + * @internal + */ + readonly parent?: MainWorker +} + +/** + * 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. + * @internal + */ +export interface PromiseResponseWrapper< + Worker extends IWorker, + Response = unknown +> { + /** + * Resolve callback to fulfill the promise. + */ + readonly resolve: (value: Response) => void + /** + * Reject callback to reject the promise. + */ + readonly reject: (reason?: string) => void + /** + * The worker handling the execution. + */ + readonly worker: Worker }