X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Futility-types.ts;h=ea90afd688d8622ee2128366c2b3e20d5302977a;hb=09564a833b20cff37a199cabe15ee5470b63e071;hp=685e5c4c606755bf801dd6c13d582d3657f8fe8e;hpb=aec509b85e7d73e9883c8885e27fc4e34fdaef1e;p=poolifier.git diff --git a/src/utility-types.ts b/src/utility-types.ts index 685e5c4c..ea90afd6 100644 --- a/src/utility-types.ts +++ b/src/utility-types.ts @@ -1,31 +1,26 @@ 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 } from './pools/worker' +import type { IWorker, Task } from './pools/worker' /** * Make all properties in T non-readonly. + * + * @typeParam T - Type in which properties will be non-readonly. */ export type Draft = { -readonly [P in keyof T]?: T[P] } /** - * Message object that is passed between worker and main worker. + * 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 -> { - /** - * Input data that will be passed to the worker. - */ - readonly data?: Data - /** - * Id of the message. - */ - readonly id?: string +> extends Task { /** * Kill code. */ @@ -40,13 +35,40 @@ export interface MessageValue< readonly runTime?: number /** * Reference to main worker. - * - * Only for internal use. - * @internal */ readonly parent?: MainWorker } +/** + * Worker synchronous function that can be executed. + * + * @typeParam Data - Type of data sent to the worker. This can only be serializable data. + * @typeParam Response - Type of execution response. This can only be serializable data. + */ +export type WorkerSyncFunction = ( + data?: Data +) => Response +/** + * Worker asynchronous function that can be executed. + * This function must return a promise. + * + * @typeParam Data - Type of data sent to the worker. This can only be serializable data. + * @typeParam Response - Type of execution response. This can only be serializable data. + */ +export type WorkerAsyncFunction = ( + data?: Data +) => Promise +/** + * Worker function that can be executed. + * This function can be synchronous or asynchronous. + * + * @typeParam Data - Type of data sent to the worker. This can only be serializable data. + * @typeParam Response - Type of execution response. This can only be serializable data. + */ +export type WorkerFunction = + | WorkerSyncFunction + | WorkerAsyncFunction + /** * An object holding the execution response promise resolve/reject callbacks. *