1 |
|
2 |
|
3 |
|
4 |
|
5 |
|
6 |
|
7 |
|
8 | import type { ForkOptions } from 'child_process';
|
9 | import type { EventEmitter } from 'events';
|
10 | export interface ResourceLimits {
|
11 | maxYoungGenerationSizeMb?: number;
|
12 | maxOldGenerationSizeMb?: number;
|
13 | codeRangeSizeMb?: number;
|
14 | stackSizeMb?: number;
|
15 | }
|
16 | export declare const CHILD_MESSAGE_INITIALIZE: 0;
|
17 | export declare const CHILD_MESSAGE_CALL: 1;
|
18 | export declare const CHILD_MESSAGE_END: 2;
|
19 | export declare const PARENT_MESSAGE_OK: 0;
|
20 | export declare const PARENT_MESSAGE_CLIENT_ERROR: 1;
|
21 | export declare const PARENT_MESSAGE_SETUP_ERROR: 2;
|
22 | export declare const PARENT_MESSAGE_CUSTOM: 3;
|
23 | export declare type PARENT_MESSAGE_ERROR = typeof PARENT_MESSAGE_CLIENT_ERROR | typeof PARENT_MESSAGE_SETUP_ERROR;
|
24 | export interface WorkerPoolInterface {
|
25 | getStderr(): NodeJS.ReadableStream;
|
26 | getStdout(): NodeJS.ReadableStream;
|
27 | getWorkers(): Array<WorkerInterface>;
|
28 | createWorker(options: WorkerOptions): WorkerInterface;
|
29 | send(workerId: number, request: ChildMessage, onStart: OnStart, onEnd: OnEnd, onCustomMessage: OnCustomMessage): void;
|
30 | end(): Promise<PoolExitResult>;
|
31 | }
|
32 | export interface WorkerInterface {
|
33 | send(request: ChildMessage, onProcessStart: OnStart, onProcessEnd: OnEnd, onCustomMessage: OnCustomMessage): void;
|
34 | waitForExit(): Promise<void>;
|
35 | forceExit(): void;
|
36 | getWorkerId(): number;
|
37 | getStderr(): NodeJS.ReadableStream | null;
|
38 | getStdout(): NodeJS.ReadableStream | null;
|
39 | }
|
40 | export declare type PoolExitResult = {
|
41 | forceExited: boolean;
|
42 | };
|
43 | export interface PromiseWithCustomMessage<T> extends Promise<T> {
|
44 | UNSTABLE_onCustomMessage?: (listener: OnCustomMessage) => () => void;
|
45 | }
|
46 | export type { ForkOptions };
|
47 | export interface TaskQueue {
|
48 | |
49 |
|
50 |
|
51 |
|
52 |
|
53 |
|
54 |
|
55 | enqueue(task: QueueChildMessage, workerId?: number): void;
|
56 | |
57 |
|
58 |
|
59 |
|
60 | dequeue(workerId: number): QueueChildMessage | null;
|
61 | }
|
62 | export declare type FarmOptions = {
|
63 | computeWorkerKey?: (method: string, ...args: Array<unknown>) => string | null;
|
64 | exposedMethods?: ReadonlyArray<string>;
|
65 | forkOptions?: ForkOptions;
|
66 | workerSchedulingPolicy?: 'round-robin' | 'in-order';
|
67 | resourceLimits?: ResourceLimits;
|
68 | setupArgs?: Array<unknown>;
|
69 | maxRetries?: number;
|
70 | numWorkers?: number;
|
71 | taskQueue?: TaskQueue;
|
72 | WorkerPool?: (workerPath: string, options?: WorkerPoolOptions) => WorkerPoolInterface;
|
73 | enableWorkerThreads?: boolean;
|
74 | };
|
75 | export declare type WorkerPoolOptions = {
|
76 | setupArgs: Array<unknown>;
|
77 | forkOptions: ForkOptions;
|
78 | resourceLimits: ResourceLimits;
|
79 | maxRetries: number;
|
80 | numWorkers: number;
|
81 | enableWorkerThreads: boolean;
|
82 | };
|
83 | export declare type WorkerOptions = {
|
84 | forkOptions: ForkOptions;
|
85 | resourceLimits: ResourceLimits;
|
86 | setupArgs: Array<unknown>;
|
87 | maxRetries: number;
|
88 | workerId: number;
|
89 | workerPath: string;
|
90 | };
|
91 | export declare type MessagePort = typeof EventEmitter & {
|
92 | postMessage(message: unknown): void;
|
93 | };
|
94 | export declare type MessageChannel = {
|
95 | port1: MessagePort;
|
96 | port2: MessagePort;
|
97 | };
|
98 | export declare type ChildMessageInitialize = [
|
99 | typeof CHILD_MESSAGE_INITIALIZE,
|
100 | boolean,
|
101 | string,
|
102 |
|
103 | Array<unknown> | undefined,
|
104 |
|
105 | MessagePort | undefined
|
106 | ];
|
107 | export declare type ChildMessageCall = [
|
108 | typeof CHILD_MESSAGE_CALL,
|
109 | boolean,
|
110 | string,
|
111 | Array<unknown>
|
112 | ];
|
113 | export declare type ChildMessageEnd = [
|
114 | typeof CHILD_MESSAGE_END,
|
115 | boolean
|
116 | ];
|
117 | export declare type ChildMessage = ChildMessageInitialize | ChildMessageCall | ChildMessageEnd;
|
118 | export declare type ParentMessageCustom = [
|
119 | typeof PARENT_MESSAGE_CUSTOM,
|
120 | unknown
|
121 | ];
|
122 | export declare type ParentMessageOk = [
|
123 | typeof PARENT_MESSAGE_OK,
|
124 | unknown
|
125 | ];
|
126 | export declare type ParentMessageError = [
|
127 | PARENT_MESSAGE_ERROR,
|
128 | string,
|
129 | string,
|
130 | string,
|
131 | unknown
|
132 | ];
|
133 | export declare type ParentMessage = ParentMessageOk | ParentMessageError | ParentMessageCustom;
|
134 | export declare type OnStart = (worker: WorkerInterface) => void;
|
135 | export declare type OnEnd = (err: Error | null, result: unknown) => void;
|
136 | export declare type OnCustomMessage = (message: Array<unknown> | unknown) => void;
|
137 | export declare type QueueChildMessage = {
|
138 | request: ChildMessageCall;
|
139 | onStart: OnStart;
|
140 | onEnd: OnEnd;
|
141 | onCustomMessage: OnCustomMessage;
|
142 | };
|