@eggjs/cluster 3.0.0-beta.0

package/dist/commonjs/utils/messenger.js

@@ -0,0 +1,183 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Messenger = void 0;
+const node_util_1 = require("node:util");
+const node_worker_threads_1 = __importDefault(require("node:worker_threads"));
+const debug = (0, node_util_1.debuglog)('@eggjs/cluster/messenger');
+/**
+ * master messenger, provide communication between parent, master, agent and app.
+ *
+ *             ┌────────┐
+ *             │ parent │
+ *            /└────────┘\
+ *           /     |      \
+ *          /  ┌────────┐  \
+ *         /   │ master │   \
+ *        /    └────────┘    \
+ *       /     /         \    \
+ *     ┌───────┐         ┌───────┐
+ *     │ agent │ ------- │  app  │
+ *     └───────┘         └───────┘
+ *
+ *
+ * in app worker
+ *
+ * ```js
+ * process.send({
+ *   action: 'xxx',
+ *   data: '',
+ *   to: 'agent/master/parent', // default to agent
+ * });
+ * ```
+ *
+ * in agent worker
+ *
+ * ```js
+ * process.send({
+ *   action: 'xxx',
+ *   data: '',
+ *   to: 'app/master/parent', // default to app
+ * });
+ * ```
+ *
+ * in parent
+ *
+ * ```js
+ * process.send({
+ *   action: 'xxx',
+ *   data: '',
+ *   to: 'app/agent/master', // default to master
+ * });
+ * ```
+ */
+class Messenger {
+    #master;
+    #workerManager;
+    #hasParent;
+    constructor(master, workerManager) {
+        this.#master = master;
+        this.#workerManager = workerManager;
+        this.#hasParent = !!node_worker_threads_1.default.parentPort || !!process.send;
+        process.on('message', (msg) => {
+            msg.from = 'parent';
+            this.send(msg);
+        });
+        process.once('disconnect', () => {
+            this.#hasParent = false;
+        });
+    }
+    /**
+     * send message
+     * @param {Object} data message body
+     *  - {String} from from who
+     *  - {String} to to who
+     */
+    send(data) {
+        if (!data.from) {
+            data.from = 'master';
+        }
+        // https://github.com/eggjs/egg/blob/b6861f1c7548f05a281386050dfeaeb30f236558/lib/core/messenger/ipc.js#L56
+        // recognize receiverPid is to who
+        if (data.receiverPid) {
+            if (data.receiverPid === String(process.pid)) {
+                data.to = 'master';
+            }
+            else if (data.receiverPid === String(this.#workerManager.getAgent().workerId)) {
+                data.to = 'agent';
+            }
+            else {
+                data.to = 'app';
+            }
+        }
+        // default from -> to rules
+        if (!data.to) {
+            if (data.from === 'agent') {
+                data.to = 'app';
+            }
+            if (data.from === 'app') {
+                data.to = 'agent';
+            }
+            if (data.from === 'parent') {
+                data.to = 'master';
+            }
+        }
+        // app -> master
+        // agent -> master
+        if (data.to === 'master') {
+            debug('%s -> master, data: %j', data.from, data);
+            // app/agent to master
+            this.sendToMaster(data);
+            return;
+        }
+        // master -> parent
+        // app -> parent
+        // agent -> parent
+        if (data.to === 'parent') {
+            debug('%s -> parent, data: %j', data.from, data);
+            this.sendToParent(data);
+            return;
+        }
+        // parent -> master -> app
+        // agent -> master -> app
+        if (data.to === 'app') {
+            debug('%s -> %s, data: %j', data.from, data.to, data);
+            this.sendToAppWorker(data);
+            return;
+        }
+        // parent -> master -> agent
+        // app -> master -> agent，可能不指定 to
+        if (data.to === 'agent') {
+            debug('%s -> %s, data: %j', data.from, data.to, data);
+            this.sendToAgentWorker(data);
+            return;
+        }
+    }
+    /**
+     * send message to master self
+     * @param {Object} data message body
+     */
+    sendToMaster(data) {
+        this.#master.emit(data.action, data.data);
+    }
+    /**
+     * send message to parent process
+     * @param {Object} data message body
+     */
+    sendToParent(data) {
+        if (!this.#hasParent) {
+            return;
+        }
+        process.send(data);
+    }
+    /**
+     * send message to app worker
+     * @param {Object} data message body
+     */
+    sendToAppWorker(data) {
+        for (const worker of this.#workerManager.listWorkers()) {
+            if (worker.state === 'disconnected') {
+                continue;
+            }
+            // check receiverPid
+            if (data.receiverPid && data.receiverPid !== String(worker.workerId)) {
+                continue;
+            }
+            worker.send(data);
+        }
+    }
+    /**
+     * send message to agent worker
+     * @param {Object} data message body
+     */
+    sendToAgentWorker(data) {
+        const agent = this.#workerManager.getAgent();
+        if (agent) {
+            agent.send(data);
+        }
+    }
+}
+exports.Messenger = Messenger;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVzc2VuZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3V0aWxzL21lc3Nlbmdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSx5Q0FBcUM7QUFDckMsOEVBQWdEO0FBSWhELE1BQU0sS0FBSyxHQUFHLElBQUEsb0JBQVEsRUFBQywwQkFBMEIsQ0FBQyxDQUFDO0FBWW5EOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0E2Q0c7QUFDSCxNQUFhLFNBQVM7SUFDcEIsT0FBTyxDQUFTO0lBQ2hCLGNBQWMsQ0FBZ0I7SUFDOUIsVUFBVSxDQUFVO0lBRXBCLFlBQVksTUFBYyxFQUFFLGFBQTRCO1FBQ3RELElBQUksQ0FBQyxPQUFPLEdBQUcsTUFBTSxDQUFDO1FBQ3RCLElBQUksQ0FBQyxjQUFjLEdBQUcsYUFBYSxDQUFDO1FBQ3BDLElBQUksQ0FBQyxVQUFVLEdBQUcsQ0FBQyxDQUFDLDZCQUFhLENBQUMsVUFBVSxJQUFJLENBQUMsQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDO1FBQy9ELE9BQU8sQ0FBQyxFQUFFLENBQUMsU0FBUyxFQUFFLENBQUMsR0FBZ0IsRUFBRSxFQUFFO1lBQ3pDLEdBQUcsQ0FBQyxJQUFJLEdBQUcsUUFBUSxDQUFDO1lBQ3BCLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDakIsQ0FBQyxDQUFDLENBQUM7UUFDSCxPQUFPLENBQUMsSUFBSSxDQUFDLFlBQVksRUFBRSxHQUFHLEVBQUU7WUFDOUIsSUFBSSxDQUFDLFVBQVUsR0FBRyxLQUFLLENBQUM7UUFDMUIsQ0FBQyxDQUFDLENBQUM7SUFDTCxDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxJQUFJLENBQUMsSUFBaUI7UUFDcEIsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztZQUNmLElBQUksQ0FBQyxJQUFJLEdBQUcsUUFBUSxDQUFDO1FBQ3ZCLENBQUM7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

package/dist/commonjs/utils/mode/base/agent.d.ts

@@ -0,0 +1,38 @@
+import { EventEmitter } from 'node:events';
+import type { ChildProcess } from 'node:child_process';
+import type { Worker } from 'node:worker_threads';
+import type { Logger } from 'egg-logger';
+import type { MasterOptions } from '../../../master.js';
+import type { MessageBody, Messenger } from '../../messenger.js';
+export declare abstract class BaseAgentWorker<T = ChildProcess | Worker> {
+    #private;
+    instance: T;
+    constructor(instance: T);
+    abstract get workerId(): number;
+    get id(): number;
+    set id(id: number);
+    get status(): string;
+    set status(status: string);
+    abstract send(message: MessageBody): void;
+    static send(_message: MessageBody): void;
+    static kill(): void;
+    static gracefulExit(_options: any): void;
+}
+type LogFun = (msg: any, ...args: any[]) => void;
+export declare abstract class BaseAgentUtils extends EventEmitter {
+    protected options: MasterOptions;
+    protected messenger: Messenger;
+    protected log: LogFun;
+    protected logger: Logger;
+    startTime: number;
+    constructor(options: MasterOptions, { log, logger, messenger }: {
+        log: LogFun;
+        logger: Logger;
+        messenger: Messenger;
+    });
+    getAgentWorkerFile(): string;
+    fork(): void;
+    clean(): void;
+    abstract kill(timeout: number): Promise<void>;
+}
+export {};

package/dist/commonjs/utils/mode/base/agent.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAgentUtils = exports.BaseAgentWorker = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const node_events_1 = require("node:events");
+const dirname_js_1 = require("../../../dirname.js");
+class BaseAgentWorker {
+    instance;
+    #instanceId;
+    #instanceStatus;
+    constructor(instance) {
+        this.instance = instance;
+    }
+    get id() {
+        return this.#instanceId;
+    }
+    set id(id) {
+        this.#instanceId = id;
+    }
+    get status() {
+        return this.#instanceStatus;
+    }
+    set status(status) {
+        this.#instanceStatus = status;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static send(_message) {
+        throw new Error('BaseAgentWorker should implement send.');
+    }
+    static kill() {
+        throw new Error('BaseAgentWorker should implement kill.');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static gracefulExit(_options) {
+        throw new Error('BaseAgentWorker should implement gracefulExit.');
+    }
+}
+exports.BaseAgentWorker = BaseAgentWorker;
+class BaseAgentUtils extends node_events_1.EventEmitter {
+    options;
+    messenger;
+    log;
+    logger;
+    // public attrs
+    startTime = 0;
+    constructor(options, { log, logger, messenger }) {
+        super();
+        this.options = options;
+        this.log = log;
+        this.logger = logger;
+        this.messenger = messenger;
+        // this.instance = null;
+    }
+    getAgentWorkerFile() {
+        return node_path_1.default.join((0, dirname_js_1.getSrcDirname)(), 'agent_worker.js');
+    }
+    fork() {
+        throw new Error('BaseAgent should implement fork.');
+    }
+    clean() {
+        throw new Error('BaseAgent should implement clean.');
+    }
+}
+exports.BaseAgentUtils = BaseAgentUtils;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvdXRpbHMvbW9kZS9iYXNlL2FnZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLDBEQUE2QjtBQUM3Qiw2Q0FBMkM7QUFNM0Msb0RBQW9EO0FBRXBELE1BQXNCLGVBQWU7SUFDbkMsUUFBUSxDQUFJO0lBQ1osV0FBVyxDQUFTO0lBQ3BCLGVBQWUsQ0FBUztJQUV4QixZQUFZLFFBQVc7UUFDckIsSUFBSSxDQUFDLFFBQVEsR0FBRyxRQUFRLENBQUM7SUFDM0IsQ0FBQztJQUlELElBQUksRUFBRTtRQUNKLE9BQU8sSUFBSSxDQUFDLFdBQVcsQ0FBQztJQUMxQixDQUFDO0lBRUQsSUFBSSxFQUFFLENBQUMsRUFBRTtRQUNQLElBQUksQ0FBQyxXQUFXLEdBQUcsRUFBRSxDQUFDO0lBQ3hCLENBQUM7SUFFRCxJQUFJLE1BQU07UUFDUixPQUFPLElBQUksQ0FBQyxlQUFlLENBQUM7SUFDOUIsQ0FBQztJQUVELElBQUksTUFBTSxDQUFDLE1BQU07UUFDZixJQUFJLENBQUMsZUFBZSxHQUFHLE1BQU0sQ0FBQztJQUNoQyxDQUFDO0lBSUQsNkRBQTZEO0lBQzdELE1BQU0sQ0FBQyxJQUFJLENBQUMsUUFBcUI7UUFDL0IsTUFBTSxJQUFJLEtBQUssQ0FBQyx3Q0FBd0MsQ0FBQyxDQUFDO0lBQzVELENBQUM7SUFFRCxNQUFNLENBQUMsSUFBSTtRQUNULE1BQU0sSUFBSSxLQUFLLENBQUMsd0NBQXdDLENBQUMsQ0FBQztJQUM1RCxDQUFDO0lBRUQsNkRBQTZEO0lBQzdELE1BQU0sQ0FBQyxZQUFZLENBQUMsUUFBYTtRQUMvQixNQUFNLElBQUksS0FBSyxDQUFDLGdEQUFnRCxDQUFDLENBQUM7SUFDcEUsQ0FBQztDQUNGO0FBMUNELDBDQTBDQztBQUlELE1BQXNCLGNBQWUsU0FBUSwwQkFBWTtJQUM3QyxPQUFPLENBQWdCO0lBQ3ZCLFNBQVMsQ0FBWTtJQUNyQixHQUFHLENBQVM7SUFDWixNQUFNLENBQVM7SUFDekIsZUFBZTtJQUNmLFNBQVMsR0FBRyxDQUFDLENBQUM7SUFFZCxZQUFZLE9BQXNCLEVBQUUsRUFBRSxHQUFHLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFJM0Q7UUFDQyxLQUFLLEVBQUUsQ0FBQztRQUNSLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDO1FBQ3ZCLElBQUksQ0FBQyxHQUFHLEdBQUcsR0FBRyxDQUFDO1FBQ2YsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUM7UUFDckIsSUFBSSxDQUFDLFNBQVMsR0FBRyxTQUFTLENBQUM7UUFDM0Isd0JBQXdCO0lBQzFCLENBQUM7SUFFRCxrQkFBa0I7UUFDaEIsT0FBTyxtQkFBSSxDQUFDLElBQUksQ0FBQyxJQUFBLDBCQUFhLEdBQUUsRUFBRSxpQkFBaUIsQ0FBQyxDQUFDO0lBQ3ZELENBQUM7SUFFRCxJQUFJO1FBQ0YsTUFBTSxJQUFJLEtBQUssQ0FBQyxrQ0FBa0MsQ0FBQyxDQUFDO0lBQ3RELENBQUM7SUFFRCxLQUFLO1FBQ0gsTUFBTSxJQUFJLEtBQUssQ0FBQyxtQ0FBbUMsQ0FBQyxDQUFDO0lBQ3ZELENBQUM7Q0FHRjtBQWxDRCx3Q0FrQ0MifQ==

package/dist/commonjs/utils/mode/base/app.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter } from 'node:events';
+import type { Worker as ClusterProcessWorker } from 'node:cluster';
+import type { Worker as ThreadWorker } from 'node:worker_threads';
+import type { Logger } from 'egg-logger';
+import type { MessageBody, Messenger } from '../../messenger.js';
+import type { MasterOptions } from '../../../master.js';
+export declare abstract class BaseAppWorker<T = ThreadWorker | ClusterProcessWorker> {
+    #private;
+    instance: T;
+    constructor(instance: T);
+    abstract get workerId(): number;
+    abstract get id(): number;
+    get state(): string;
+    set state(state: string);
+    abstract get exitedAfterDisconnect(): boolean;
+    abstract get exitCode(): number;
+    get disableRefork(): boolean;
+    set disableRefork(disableRefork: boolean);
+    get isDevReload(): boolean;
+    set isDevReload(status: boolean);
+    abstract send(data: MessageBody): void;
+    clean(): void;
+    static on(..._args: any[]): void;
+    static send(_message: MessageBody): void;
+    static kill(): void;
+    static gracefulExit(_options: any): void;
+}
+type LogFun = (msg: any, ...args: any[]) => void;
+export declare abstract class BaseAppUtils extends EventEmitter {
+    options: MasterOptions;
+    protected messenger: Messenger;
+    protected log: LogFun;
+    protected logger: Logger;
+    protected isProduction: boolean;
+    startTime: number;
+    startSuccessCount: number;
+    isAllWorkerStarted: boolean;
+    constructor(options: MasterOptions, { log, logger, messenger, isProduction, }: {
+        log: LogFun;
+        logger: Logger;
+        messenger: Messenger;
+        isProduction: boolean;
+    });
+    getAppWorkerFile(): string;
+    fork(): void;
+    abstract kill(timeout: number): Promise<void>;
+}
+export {};

package/dist/commonjs/utils/mode/base/app.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAppUtils = exports.BaseAppWorker = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const node_events_1 = require("node:events");
+const dirname_js_1 = require("../../../dirname.js");
+class BaseAppWorker {
+    instance;
+    #isDevReload;
+    #state;
+    constructor(instance) {
+        this.instance = instance;
+    }
+    get state() {
+        return this.#state;
+    }
+    set state(state) {
+        this.#state = state;
+    }
+    get disableRefork() {
+        return Reflect.get(this.instance, 'disableRefork');
+    }
+    set disableRefork(disableRefork) {
+        Reflect.set(this.instance, 'disableRefork', disableRefork);
+    }
+    get isDevReload() {
+        return this.#isDevReload;
+    }
+    set isDevReload(status) {
+        this.#isDevReload = status;
+    }
+    clean() {
+        throw new Error('BaseAppWorker should implement clean.');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static on(..._args) {
+        throw new Error('BaseAppWorker should implement on.');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static send(_message) {
+        throw new Error('BaseAgentWorker should implement send.');
+    }
+    static kill() {
+        throw new Error('BaseAppWorker should implement kill.');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static gracefulExit(_options) {
+        throw new Error('BaseAgentWorker should implement gracefulExit.');
+    }
+}
+exports.BaseAppWorker = BaseAppWorker;
+class BaseAppUtils extends node_events_1.EventEmitter {
+    options;
+    messenger;
+    log;
+    logger;
+    isProduction;
+    // public attrs
+    startTime = 0;
+    startSuccessCount = 0;
+    isAllWorkerStarted = false;
+    constructor(options, { log, logger, messenger, isProduction, }) {
+        super();
+        this.options = options;
+        this.log = log;
+        this.logger = logger;
+        this.messenger = messenger;
+        this.isProduction = isProduction;
+    }
+    getAppWorkerFile() {
+        return node_path_1.default.join((0, dirname_js_1.getSrcDirname)(), 'app_worker.js');
+    }
+    fork() {
+        throw new Error('BaseApp should implement fork.');
+    }
+}
+exports.BaseAppUtils = BaseAppUtils;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL3V0aWxzL21vZGUvYmFzZS9hcHAudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBQUEsMERBQTZCO0FBQzdCLDZDQUEyQztBQU0zQyxvREFBb0Q7QUFFcEQsTUFBc0IsYUFBYTtJQUNqQyxRQUFRLENBQUk7SUFDWixZQUFZLENBQVU7SUFDdEIsTUFBTSxDQUFTO0lBRWYsWUFBWSxRQUFXO1FBQ3JCLElBQUksQ0FBQyxRQUFRLEdBQUcsUUFBUSxDQUFDO0lBQzNCLENBQUM7SUFNRCxJQUFJLEtBQUs7UUFDUCxPQUFPLElBQUksQ0FBQyxNQUFNLENBQUM7SUFDckIsQ0FBQztJQUVELElBQUksS0FBSyxDQUFDLEtBQUs7UUFDYixJQUFJLENBQUMsTUFBTSxHQUFHLEtBQUssQ0FBQztJQUN0QixDQUFDO0lBTUQsSUFBSSxhQUFhO1FBQ2YsT0FBTyxPQUFPLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxRQUFTLEVBQUUsZUFBZSxDQUFZLENBQUM7SUFDakUsQ0FBQztJQUVELElBQUksYUFBYSxDQUFDLGFBQXNCO1FBQ3RDLE9BQU8sQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLFFBQVMsRUFBRSxlQUFlLEVBQUUsYUFBYSxDQUFDLENBQUM7SUFDOUQsQ0FBQztJQUVELElBQUksV0FBVztRQUNiLE9BQU8sSUFBSSxDQUFDLFlBQVksQ0FBQztJQUMzQixDQUFDO0lBRUQsSUFBSSxXQUFXLENBQUMsTUFBTTtRQUNwQixJQUFJLENBQUMsWUFBWSxHQUFHLE1BQU0sQ0FBQztJQUM3QixDQUFDO0lBSUQsS0FBSztRQUNILE1BQU0sSUFBSSxLQUFLLENBQUMsdUNBQXVDLENBQUMsQ0FBQztJQUMzRCxDQUFDO0lBRUQsNkRBQTZEO0lBQzdELE1BQU0sQ0FBQyxFQUFFLENBQUMsR0FBRyxLQUFZO1FBQ3ZCLE1BQU0sSUFBSSxLQUFLLENBQUMsb0NBQW9DLENBQUMsQ0FBQztJQUN4RCxDQUFDO0lBRUQsNkRBQTZEO0lBQzdELE1BQU0sQ0FBQyxJQUFJLENBQUMsUUFBcUI7UUFDL0IsTUFBTSxJQUFJLEtBQUssQ0FBQyx3Q0FBd0MsQ0FBQyxDQUFDO0lBQzVELENBQUM7SUFFRCxNQUFNLENBQUMsSUFBSTtRQUNULE1BQU0sSUFBSSxLQUFLLENBQUMsc0NBQXNDLENBQUMsQ0FBQztJQUMxRCxDQUFDO0lBRUQsNkRBQTZEO0lBQzdELE1BQU0sQ0FBQyxZQUFZLENBQUMsUUFBYTtRQUMvQixNQUFNLElBQUksS0FBSyxDQUFDLGdEQUFnRCxDQUFDLENBQUM7SUFDcEUsQ0FBQztDQUNGO0FBakVELHNDQWlFQztBQUlELE1BQXNCLFlBQWEsU0FBUSwwQkFBWTtJQUNyRCxPQUFPLENBQWdCO0lBQ2IsU0FBUyxDQUFZO0lBQ3JCLEdBQUcsQ0FBUztJQUNaLE1BQU0sQ0FBUztJQUNmLFlBQVksQ0FBVTtJQUNoQyxlQUFlO0lBQ2YsU0FBUyxHQUFHLENBQUMsQ0FBQztJQUNkLGlCQUFpQixHQUFHLENBQUMsQ0FBQztJQUN0QixrQkFBa0IsR0FBRyxLQUFLLENBQUM7SUFFM0IsWUFBWSxPQUFzQixFQUFFLEVBQ2xDLEdBQUcsRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLFlBQVksR0FNckM7UUFDQyxLQUFLLEVBQUUsQ0FBQztRQUNSLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDO1FBQ3ZCLElBQUksQ0FBQyxHQUFHLEdBQUcsR0FBRyxDQUFDO1FBQ2YsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUM7UUFDckIsSUFBSSxDQUFDLFNBQVMsR0FBRyxTQUFTLENBQUM7UUFDM0IsSUFBSSxDQUFDLFlBQVksR0FBRyxZQUFZLENBQUM7SUFDbkMsQ0FBQztJQUVELGdCQUFnQjtRQUNkLE9BQU8sbUJBQUksQ0FBQyxJQUFJLENBQUMsSUFBQSwwQkFBYSxHQUFFLEVBQUUsZUFBZSxDQUFDLENBQUM7SUFDckQsQ0FBQztJQUVELElBQUk7UUFDRixNQUFNLElBQUksS0FBSyxDQUFDLGdDQUFnQyxDQUFDLENBQUM7SUFDcEQsQ0FBQztDQUdGO0FBcENELG9DQW9DQyJ9

package/dist/commonjs/utils/mode/impl/process/agent.d.ts

@@ -0,0 +1,18 @@
+import { type ChildProcess } from 'node:child_process';
+import { type Options as gracefulExitOptions } from 'graceful-process';
+import { BaseAgentWorker, BaseAgentUtils } from '../../base/agent.js';
+import type { MessageBody } from '../../../messenger.js';
+export declare class AgentProcessWorker extends BaseAgentWorker<ChildProcess> {
+    get workerId(): number;
+    send(message: MessageBody): void;
+    static send(message: MessageBody): void;
+    static kill(): void;
+    static gracefulExit(options: gracefulExitOptions): void;
+}
+export declare class AgentProcessUtils extends BaseAgentUtils {
+    #private;
+    instance: AgentProcessWorker;
+    fork(): this;
+    clean(): void;
+    kill(timeout: number): Promise<void>;
+}

package/dist/commonjs/utils/mode/impl/process/agent.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentProcessUtils = exports.AgentProcessWorker = void 0;
+const node_child_process_1 = require("node:child_process");
+const sendmessage_1 = require("sendmessage");
+const graceful_process_1 = require("graceful-process");
+const agent_js_1 = require("../../base/agent.js");
+const terminate_js_1 = require("../../../terminate.js");
+const ClusterAgentWorkerError_js_1 = require("../../../../error/ClusterAgentWorkerError.js");
+class AgentProcessWorker extends agent_js_1.BaseAgentWorker {
+    get workerId() {
+        return this.instance.pid;
+    }
+    send(message) {
+        (0, sendmessage_1.sendmessage)(this.instance, message);
+    }
+    static send(message) {
+        process.send(message);
+    }
+    static kill() {
+        process.exitCode = 1;
+        process.kill(process.pid);
+    }
+    static gracefulExit(options) {
+        (0, graceful_process_1.graceful)(options);
+    }
+}
+exports.AgentProcessWorker = AgentProcessWorker;
+class AgentProcessUtils extends agent_js_1.BaseAgentUtils {
+    #agentProcess;
+    #id = 0;
+    instance;
+    fork() {
+        this.startTime = Date.now();
+        const args = [JSON.stringify(this.options)];
+        const forkOptions = {};
+        if (process.platform === 'win32') {
+            forkOptions.windowsHide = true;
+        }
+        // add debug execArgv
+        const debugPort = process.env.EGG_AGENT_DEBUG_PORT ?? 5800;
+        if (this.options.isDebug) {
+            forkOptions.execArgv = process.execArgv.concat([`--inspect-port=${debugPort}`]);
+        }
+        const agentProcess = this.#agentProcess = (0, node_child_process_1.fork)(this.getAgentWorkerFile(), args, forkOptions);
+        const agentWorker = this.instance = new AgentProcessWorker(agentProcess);
+        agentWorker.status = 'starting';
+        agentWorker.id = ++this.#id;
+        this.emit('agent_forked', agentWorker);
+        this.log('[master] agent_worker#%s:%s start with clusterPort:%s', agentWorker.id, agentWorker.workerId, this.options.clusterPort);
+        // send debug message
+        if (this.options.isDebug) {
+            this.messenger.send({
+                to: 'parent',
+                from: 'agent',
+                action: 'debug',
+                data: {
+                    debugPort,
+                    // keep compatibility, should use workerId instead
+                    pid: agentWorker.workerId,
+                    workerId: agentWorker.workerId,
+                },
+            });
+        }
+        // forwarding agent' message to messenger
+        agentProcess.on('message', (msg) => {
+            if (typeof msg === 'string') {
+                msg = {
+                    action: msg,
+                    data: msg,
+                };
+            }
+            msg.from = 'agent';
+            this.messenger.send(msg);
+        });
+        // logger error event
+        agentProcess.on('error', err => {
+            err.name = 'AgentWorkerError';
+            this.logger.error(new ClusterAgentWorkerError_js_1.ClusterAgentWorkerError(agentWorker.id, agentWorker.workerId, agentWorker.status, err));
+        });
+        // agent exit message
+        agentProcess.once('exit', (code, signal) => {
+            this.messenger.send({
+                action: 'agent-exit',
+                data: {
+                    code,
+                    signal,
+                },
+                to: 'master',
+                from: 'agent',
+            });
+        });
+        return this;
+    }
+    clean() {
+        this.#agentProcess.removeAllListeners();
+    }
+    async kill(timeout) {
+        if (this.#agentProcess) {
+            this.log('[master] kill agent worker with signal SIGTERM');
+            this.clean();
+            await (0, terminate_js_1.terminate)(this.#agentProcess, timeout);
+        }
+    }
+}
+exports.AgentProcessUtils = AgentProcessUtils;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9zcmMvdXRpbHMvbW9kZS9pbXBsL3Byb2Nlc3MvYWdlbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsMkRBQStFO0FBQy9FLDZDQUEwQztBQUMxQyx1REFBaUc7QUFDakcsa0RBQXNFO0FBQ3RFLHdEQUFrRDtBQUVsRCw2RkFBdUY7QUFFdkYsTUFBYSxrQkFBbUIsU0FBUSwwQkFBNkI7SUFDbkUsSUFBSSxRQUFRO1FBQ1YsT0FBTyxJQUFJLENBQUMsUUFBUSxDQUFDLEdBQUksQ0FBQztJQUM1QixDQUFDO0lBRUQsSUFBSSxDQUFDLE9BQW9CO1FBQ3ZCLElBQUEseUJBQVcsRUFBQyxJQUFJLENBQUMsUUFBUSxFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ3RDLENBQUM7SUFFRCxNQUFNLENBQUMsSUFBSSxDQUFDLE9BQW9CO1FBQzlCLE9BQU8sQ0FBQyxJQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDekIsQ0FBQztJQUVELE1BQU0sQ0FBQyxJQUFJO1FBQ1QsT0FBTyxDQUFDLFFBQVEsR0FBRyxDQUFDLENBQUM7UUFDckIsT0FBTyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDNUIsQ0FBQztJQUVELE1BQU0sQ0FBQyxZQUFZLENBQUMsT0FBNEI7UUFDOUMsSUFBQSwyQkFBWSxFQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQ3hCLENBQUM7Q0FDRjtBQXJCRCxnREFxQkM7QUFFRCxNQUFhLGlCQUFrQixTQUFRLHlCQUFjO0lBQ25ELGFBQWEsQ0FBZTtJQUM1QixHQUFHLEdBQUcsQ0FBQyxDQUFDO0lBQ1IsUUFBUSxDQUFxQjtJQUU3QixJQUFJO1FBQ0YsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7UUFFNUIsTUFBTSxJQUFJLEdBQUcsQ0FBRSxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUks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

package/dist/commonjs/utils/mode/impl/process/app.d.ts

@@ -0,0 +1,20 @@
+import { type Worker as ClusterProcessWorker } from 'node:cluster';
+import { type Options as gracefulExitOptions } from 'graceful-process';
+import { BaseAppWorker, BaseAppUtils } from '../../base/app.js';
+import type { MessageBody } from '../../../messenger.js';
+export declare class AppProcessWorker extends BaseAppWorker<ClusterProcessWorker> {
+    get id(): number;
+    get workerId(): number;
+    get exitedAfterDisconnect(): boolean;
+    get exitCode(): number;
+    send(message: MessageBody): void;
+    clean(): void;
+    static on(event: string, listener: (...args: any[]) => void): void;
+    static send(message: MessageBody): void;
+    static kill(): void;
+    static gracefulExit(options: gracefulExitOptions): void;
+}
+export declare class AppProcessUtils extends BaseAppUtils {
+    fork(): this;
+    kill(timeout: number): Promise<void>;
+}