X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Futility-types.ts;h=05af4e3d396b7c89d22ba0c895ceb6c4649e5f42;hb=3fafb1b2f068533b39818d66b5b0b9972f76f577;hp=e177adaeb7ccaf8022c338013284201e23ed1ed7;hpb=d3c8a1a8022726094160d1413f1f289c5d84d715;p=poolifier.git diff --git a/src/utility-types.ts b/src/utility-types.ts index e177adae..05af4e3d 100644 --- a/src/utility-types.ts +++ b/src/utility-types.ts @@ -1,15 +1,68 @@ -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 { IPoolWorker } from './pools/pool-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 { +/** + * Message object that is passed between worker and main worker. + */ +export interface MessageValue< + Data = unknown, + MainWorker extends ClusterWorker | MessagePort | unknown = unknown +> { + /** + * Input data that will be passed to the worker. + */ readonly data?: Data - readonly id?: number - readonly kill?: number + /** + * Id of the message. + */ + readonly id?: string + /** + * 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. + */ + 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. + */ +export interface PromiseResponseWrapper< + Worker extends IPoolWorker, + 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 promise. + */ + readonly worker: Worker }