@eggjs/cluster 4.0.0-beta.19 → 4.0.0-beta.21

package/dist/utils/mode/impl/worker_threads/app.js

@@ -1,128 +1,137 @@
-import { BaseAppUtils, BaseAppWorker } from "../../base/app.js";
-import { Worker, parentPort, threadId } from "node:worker_threads";
-import { setTimeout } from "node:timers/promises";
-
-//#region src/utils/mode/impl/worker_threads/app.ts
-var AppThreadWorker = class extends BaseAppWorker {
-	#state = "none";
-	#id;
-	constructor(instance, id) {
-		super(instance);
-		this.#id = id;
-	}
-	get id() {
-		return this.#id;
-	}
-	get workerId() {
-		return this.instance.threadId;
-	}
-	get state() {
-		return this.#state;
-	}
-	set state(val) {
-		this.#state = val;
-	}
-	get exitedAfterDisconnect() {
-		return true;
-	}
-	get exitCode() {
-		return 0;
-	}
-	send(message) {
-		this.instance.postMessage(message);
-	}
-	clean() {
-		this.instance.removeAllListeners();
-	}
-	static get workerId() {
-		return threadId;
-	}
-	static on(event, listener) {
-		parentPort.on(event, listener);
-	}
-	static send(message) {
-		message.senderWorkerId = String(threadId);
-		parentPort.postMessage(message);
-	}
-	static kill() {
-		process.exit(1);
-	}
-	static gracefulExit(options) {
-		process.on("exit", async (code) => {
-			if (typeof options.beforeExit === "function") await options.beforeExit();
-			process.exit(code);
-		});
-	}
-};
-var AppThreadUtils = class extends BaseAppUtils {
-	#workers = [];
-	#forkSingle(appPath, options, id) {
-		const worker = new Worker(appPath, options);
-		this.#workers.push(worker);
-		const appWorker = new AppThreadWorker(worker, id);
-		this.emit("worker_forked", appWorker);
-		appWorker.disableRefork = true;
-		worker.on("message", (msg) => {
-			if (typeof msg === "string") msg = {
-				action: msg,
-				data: msg
-			};
-			msg.from = "app";
-			this.messenger.send(msg);
-		});
-		this.log("[master] app_worker#%s (tid:%s) start", appWorker.id, appWorker.workerId);
-		let debugPort = process.debugPort;
-		if (this.options.isDebug) {
-			debugPort++;
-			this.messenger.send({
-				to: "parent",
-				from: "app",
-				action: "debug",
-				data: {
-					debugPort,
-					pid: appWorker.workerId,
-					workerId: appWorker.workerId
-				}
-			});
-		}
-		worker.on("exit", async (code) => {
-			appWorker.state = "dead";
-			this.messenger.send({
-				action: "app-exit",
-				data: {
-					workerId: appWorker.workerId,
-					code
-				},
-				to: "master",
-				from: "app"
-			});
-			await setTimeout(1e3);
-			this.#forkSingle(appPath, options, id);
-		});
-	}
-	fork() {
-		this.startTime = Date.now();
-		this.startSuccessCount = 0;
-		const ports = this.options.ports ?? [];
-		if (!ports.length) ports.push(this.options.port);
-		this.options.workers = ports.length;
-		let i = 0;
-		do {
-			const options = Object.assign({}, this.options, { port: ports[i] });
-			const argv = [JSON.stringify(options)];
-			this.#forkSingle(this.getAppWorkerFile(), { argv }, ++i);
-		} while (i < ports.length);
-		return this;
-	}
-	async kill() {
-		for (const worker of this.#workers) {
-			const id = Reflect.get(worker, "id");
-			this.log(`[master] kill app worker#${id} (worker_threads) by worker.terminate()`);
-			worker.removeAllListeners();
-			worker.terminate();
-		}
-	}
-};
-
-//#endregion
-export { AppThreadUtils, AppThreadWorker };
+import { setTimeout as sleep } from 'node:timers/promises';
+import { Worker as ThreadWorker, threadId, parentPort } from 'node:worker_threads';
+import { BaseAppWorker, BaseAppUtils } from "../../base/app.js";
+export class AppThreadWorker extends BaseAppWorker {
+    #state = 'none';
+    #id;
+    constructor(instance, id) {
+        super(instance);
+        this.#id = id;
+    }
+    get id() {
+        return this.#id;
+    }
+    get workerId() {
+        return this.instance.threadId;
+    }
+    get state() {
+        return this.#state;
+    }
+    set state(val) {
+        this.#state = val;
+    }
+    get exitedAfterDisconnect() {
+        return true;
+    }
+    get exitCode() {
+        return 0;
+        // return this.instance.exitCode;
+    }
+    send(message) {
+        this.instance.postMessage(message);
+    }
+    clean() {
+        this.instance.removeAllListeners();
+    }
+    // static methods use on src/app_worker.ts
+    static get workerId() {
+        return threadId;
+    }
+    static on(event, listener) {
+        parentPort.on(event, listener);
+    }
+    static send(message) {
+        message.senderWorkerId = String(threadId);
+        parentPort.postMessage(message);
+    }
+    static kill() {
+        process.exit(1);
+    }
+    static gracefulExit(options) {
+        process.on('exit', async (code) => {
+            if (typeof options.beforeExit === 'function') {
+                await options.beforeExit();
+            }
+            process.exit(code);
+        });
+    }
+}
+export class AppThreadUtils extends BaseAppUtils {
+    #workers = [];
+    #forkSingle(appPath, options, id) {
+        // start app worker
+        const worker = new ThreadWorker(appPath, options);
+        this.#workers.push(worker);
+        // wrap app worker
+        const appWorker = new AppThreadWorker(worker, id);
+        this.emit('worker_forked', appWorker);
+        appWorker.disableRefork = true;
+        worker.on('message', (msg) => {
+            if (typeof msg === 'string') {
+                msg = {
+                    action: msg,
+                    data: msg,
+                };
+            }
+            msg.from = 'app';
+            this.messenger.send(msg);
+        });
+        this.log('[master] app_worker#%s (tid:%s) start', appWorker.id, appWorker.workerId);
+        // send debug message, due to `brk` scene, send here instead of app_worker.js
+        let debugPort = process.debugPort;
+        if (this.options.isDebug) {
+            debugPort++;
+            this.messenger.send({
+                to: 'parent',
+                from: 'app',
+                action: 'debug',
+                data: {
+                    debugPort,
+                    pid: appWorker.workerId,
+                    workerId: appWorker.workerId,
+                },
+            });
+        }
+        // handle worker exit
+        worker.on('exit', async (code) => {
+            appWorker.state = 'dead';
+            this.messenger.send({
+                action: 'app-exit',
+                data: {
+                    workerId: appWorker.workerId,
+                    code,
+                },
+                to: 'master',
+                from: 'app',
+            });
+            // refork app worker
+            await sleep(1000);
+            this.#forkSingle(appPath, options, id);
+        });
+    }
+    fork() {
+        this.startTime = Date.now();
+        this.startSuccessCount = 0;
+        const ports = this.options.ports ?? [];
+        if (!ports.length) {
+            ports.push(this.options.port);
+        }
+        this.options.workers = ports.length;
+        let i = 0;
+        do {
+            const options = Object.assign({}, this.options, { port: ports[i] });
+            const argv = [JSON.stringify(options)];
+            this.#forkSingle(this.getAppWorkerFile(), { argv }, ++i);
+        } while (i < ports.length);
+        return this;
+    }
+    async kill() {
+        for (const worker of this.#workers) {
+            const id = Reflect.get(worker, 'id');
+            this.log(`[master] kill app worker#${id} (worker_threads) by worker.terminate()`);
+            worker.removeAllListeners();
+            worker.terminate();
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL3V0aWxzL21vZGUvaW1wbC93b3JrZXJfdGhyZWFkcy9hcHAudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsSUFBSSxLQUFLLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUMzRCxPQUFPLEVBQUUsTUFBTSxJQUFJLFlBQVksRUFBRSxRQUFRLEVBQUUsVUFBVSxFQUFzQixNQUFNLHFCQUFxQixDQUFDO0FBSXZHLE9BQU8sRUFBRSxhQUFhLEVBQUUsWUFBWSxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFHaEUsTUFBTSxPQUFPLGVBQWdCLFNBQVEsYUFBMkI7SUFDOUQsTUFBTSxHQUFHLE1BQU0sQ0FBQztJQUNoQixHQUFHLENBQVM7SUFFWixZQUFZLFFBQXNCLEVBQUUsRUFBVTtRQUM1QyxLQUFLLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDaEIsSUFBSSxDQUFDLEdBQUcsR0FBRyxFQUFFLENBQUM7SUFDaEIsQ0FBQztJQUVELElBQUksRUFBRTtRQUNKLE9BQU8sSUFBSSxDQUFDLEdBQUcsQ0FBQztJQUNsQixDQUFDO0lBRUQsSUFBSSxRQUFRO1FBQ1YsT0FBTyxJQUFJLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQztJQUNoQyxDQUFDO0lBRUQsSUFBSSxLQUFLO1FBQ1AsT0FBTyxJQUFJLENBQUMsTUFBTSxDQUFDO0lBQ3JCLENBQUM7SUFFRCxJQUFJLEtBQUssQ0FBQyxHQUFHO1FBQ1gsSUFBSSxDQUFDLE1BQU0sR0FBRyxHQUFHLENBQUM7SUFDcEIsQ0FBQztJQUVELElBQUkscUJBQXFCO1FBQ3ZCLE9BQU8sSUFBSSxDQUFDO0lBQ2QsQ0FBQztJQUVELElBQUksUUFBUTtRQUNWLE9BQU8sQ0FBQyxDQUFDO1FBQ1QsaUNBQWlDO0lBQ25DLENBQUM7SUFFRCxJQUFJLENBQUMsT0FBb0I7UUFDdkIsSUFBSSxDQUFDLFFBQVEsQ0FBQyxX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

package/dist/utils/options.d.ts

@@ -1,83 +1,80 @@
-import { SecureContextOptions } from "node:tls";
-
-//#region src/utils/options.d.ts
-interface ClusterHTTPSSecureOptions {
-  key: SecureContextOptions['key'];
-  cert: SecureContextOptions['cert'];
-  ca?: SecureContextOptions['ca'];
-  passphrase?: SecureContextOptions['passphrase'];
+import { type SecureContextOptions } from 'node:tls';
+export interface ClusterHTTPSSecureOptions {
+    key: SecureContextOptions['key'];
+    cert: SecureContextOptions['cert'];
+    ca?: SecureContextOptions['ca'];
+    passphrase?: SecureContextOptions['passphrase'];
 }
-type ClusterStartMode = 'process' | 'worker_threads';
+export type ClusterStartMode = 'process' | 'worker_threads';
 /** Cluster start options */
-interface ClusterOptions {
-  /**
-   * specify framework that can be absolute path or npm package
-   */
-  framework?: string;
-  /**
-   * @deprecated please use framework instead
-   */
-  customEgg?: string;
-  /** directory of application, default to `process.cwd()` */
-  baseDir?: string;
-  /**
-   * numbers of app workers, default to `os.cpus().length`
-   */
-  workers?: number | string;
-  /**
-   * listening port, default to `7001`(http) or `8443`(https)
-   */
-  port?: number | string | null;
-  /**
-   * listening a debug port on http protocol
-   */
-  debugPort?: number;
-  /**
-   * https options, { key, cert, ca }, full path
-   */
-  https?: ClusterHTTPSSecureOptions | boolean;
-  /**
-   * @deprecated please use `options.https.key` instead
-   */
-  key?: ClusterHTTPSSecureOptions['key'];
-  /**
-   * @deprecated please use `options.https.cert` instead
-   */
-  cert?: ClusterHTTPSSecureOptions['cert'];
-  /**
-   * will inject into worker/agent process
-   */
-  require?: string | string[];
-  /**
-   * will save master pid to this file
-   */
-  pidFile?: string;
-  /**
-   * custom env, default is `process.env.EGG_SERVER_ENV`
-   */
-  env?: string;
-  /**
-   * default is `'process'`, use `'worker_threads'` to start the app & agent worker by worker_threads
-   */
-  startMode?: ClusterStartMode;
-  /**
-   * startup port of each app worker, such as: `[7001, 7002, 7003]`, only effects when the startMode is `'worker_threads'`
-   */
-  ports?: number[];
-  /**
-   * sticky mode server
-   */
-  sticky?: boolean;
-  /** customized plugins, for unittest */
-  plugins?: object;
-  isDebug?: boolean;
+export interface ClusterOptions {
+    /**
+     * specify framework that can be absolute path or npm package
+     */
+    framework?: string;
+    /**
+     * @deprecated please use framework instead
+     */
+    customEgg?: string;
+    /** directory of application, default to `process.cwd()` */
+    baseDir?: string;
+    /**
+     * numbers of app workers, default to `os.cpus().length`
+     */
+    workers?: number | string;
+    /**
+     * listening port, default to `7001`(http) or `8443`(https)
+     */
+    port?: number | string | null;
+    /**
+     * listening a debug port on http protocol
+     */
+    debugPort?: number;
+    /**
+     * https options, { key, cert, ca }, full path
+     */
+    https?: ClusterHTTPSSecureOptions | boolean;
+    /**
+     * @deprecated please use `options.https.key` instead
+     */
+    key?: ClusterHTTPSSecureOptions['key'];
+    /**
+     * @deprecated please use `options.https.cert` instead
+     */
+    cert?: ClusterHTTPSSecureOptions['cert'];
+    /**
+     * will inject into worker/agent process
+     */
+    require?: string | string[];
+    /**
+     * will save master pid to this file
+     */
+    pidFile?: string;
+    /**
+     * custom env, default is `process.env.EGG_SERVER_ENV`
+     */
+    env?: string;
+    /**
+     * default is `'process'`, use `'worker_threads'` to start the app & agent worker by worker_threads
+     */
+    startMode?: ClusterStartMode;
+    /**
+     * startup port of each app worker, such as: `[7001, 7002, 7003]`, only effects when the startMode is `'worker_threads'`
+     */
+    ports?: number[];
+    /**
+     * sticky mode server
+     */
+    sticky?: boolean;
+    /** customized plugins, for unittest */
+    plugins?: object;
+    isDebug?: boolean;
 }
-interface ParsedClusterOptions extends ClusterOptions {
-  port?: number;
-  baseDir: string;
-  workers: number;
-  framework: string;
-  startMode: ClusterStartMode;
+export interface ParsedClusterOptions extends ClusterOptions {
+    port?: number;
+    baseDir: string;
+    workers: number;
+    framework: string;
+    startMode: ClusterStartMode;
 }
-//#endregion
-export { ClusterHTTPSSecureOptions, ClusterOptions, ClusterStartMode, ParsedClusterOptions };
+export declare function parseOptions(options?: ClusterOptions): Promise<ParsedClusterOptions>;

package/dist/utils/options.js

@@ -1,56 +1,81 @@
-import os from "node:os";
-import { debuglog } from "node:util";
-import path from "node:path";
-import fs from "node:fs";
-import assert from "node:assert";
-import { getFrameworkPath, importModule } from "@eggjs/utils";
-
-//#region src/utils/options.ts
-const debug = debuglog("egg/cluster/utils/options");
-async function parseOptions(options) {
-	options = {
-		baseDir: process.cwd(),
-		port: options?.https ? 8443 : void 0,
-		startMode: "process",
-		env: process.env.EGG_SERVER_ENV,
-		...options
-	};
-	const pkgPath = path.join(options.baseDir, "package.json");
-	assert(fs.existsSync(pkgPath), `${pkgPath} should exist`);
-	options.framework = getFrameworkPath({
-		baseDir: options.baseDir,
-		framework: options.framework ?? options.customEgg
-	});
-	debug("[parseOptions] %o", options);
-	const egg = await importModule(options.framework, { paths: [options.baseDir] });
-	assert(egg.Application, `should define Application in ${options.framework}`);
-	assert(egg.Agent, `should define Agent in ${options.framework}`);
-	if (options.https === true) {
-		console.warn("[@eggjs/cluster:deprecated] [master] Please use `https: { key, cert, ca }` instead of `https: true`");
-		options.https = {
-			key: options.key,
-			cert: options.cert
-		};
-	}
-	if (options.https) {
-		assert(options.https.key, "options.https.key should exists");
-		if (typeof options.https.key === "string") assert(fs.existsSync(options.https.key), "options.https.key file should exists");
-		assert(options.https.cert, "options.https.cert should exists");
-		if (typeof options.https.cert === "string") assert(fs.existsSync(options.https.cert), "options.https.cert file should exists");
-		if (typeof options.https.ca === "string") assert(fs.existsSync(options.https.ca), "options.https.ca file should exists");
-	}
-	if (options.port && typeof options.port === "string") options.port = parseInt(options.port);
-	if (options.port === null) options.port = void 0;
-	if (options.workers && typeof options.workers === "string") options.workers = parseInt(options.workers);
-	if (!options.workers) options.workers = os.cpus().length;
-	if (options.require) {
-		if (typeof options.require === "string") options.require = [options.require];
-	}
-	if (process.env.NODE_ENV === "production") process.env.NO_DEPRECATION = "*";
-	const isDebug = process.execArgv.some((argv) => argv.includes("--debug") || argv.includes("--inspect"));
-	if (isDebug) options.isDebug = isDebug;
-	return options;
+import os from 'node:os';
+import fs from 'node:fs';
+import path from 'node:path';
+import assert from 'node:assert';
+import { debuglog } from 'node:util';
+import {} from 'node:tls';
+import { getFrameworkPath, importModule } from '@eggjs/utils';
+const debug = debuglog('egg/cluster/utils/options');
+export async function parseOptions(options) {
+    options = {
+        baseDir: process.cwd(),
+        port: options?.https ? 8443 : undefined,
+        startMode: 'process',
+        // ports: [],
+        env: process.env.EGG_SERVER_ENV,
+        ...options,
+    };
+    const pkgPath = path.join(options.baseDir, 'package.json');
+    assert(fs.existsSync(pkgPath), `${pkgPath} should exist`);
+    options.framework = getFrameworkPath({
+        baseDir: options.baseDir,
+        // compatible customEgg only when call startCluster directly without framework
+        framework: options.framework ?? options.customEgg,
+    });
+    debug('[parseOptions] %o', options);
+    const egg = await importModule(options.framework, {
+        paths: [options.baseDir],
+    });
+    assert(egg.Application, `should define Application in ${options.framework}`);
+    assert(egg.Agent, `should define Agent in ${options.framework}`);
+    if (options.https === true) {
+        // Keep compatible options.key, options.cert
+        console.warn('[@eggjs/cluster:deprecated] [master] Please use `https: { key, cert, ca }` instead of `https: true`');
+        options.https = {
+            key: options.key,
+            cert: options.cert,
+        };
+    }
+    // https
+    if (options.https) {
+        assert(options.https.key, 'options.https.key should exists');
+        if (typeof options.https.key === 'string') {
+            assert(fs.existsSync(options.https.key), 'options.https.key file should exists');
+        }
+        assert(options.https.cert, 'options.https.cert should exists');
+        if (typeof options.https.cert === 'string') {
+            assert(fs.existsSync(options.https.cert), 'options.https.cert file should exists');
+        }
+        if (typeof options.https.ca === 'string') {
+            assert(fs.existsSync(options.https.ca), 'options.https.ca file should exists');
+        }
+    }
+    if (options.port && typeof options.port === 'string') {
+        options.port = parseInt(options.port);
+    }
+    if (options.port === null) {
+        options.port = undefined;
+    }
+    if (options.workers && typeof options.workers === 'string') {
+        options.workers = parseInt(options.workers);
+    }
+    if (!options.workers) {
+        options.workers = os.cpus().length;
+    }
+    if (options.require) {
+        if (typeof options.require === 'string') {
+            options.require = [options.require];
+        }
+    }
+    // don't print deprecated message in production env.
+    // it will print to stderr.
+    if (process.env.NODE_ENV === 'production') {
+        process.env.NO_DEPRECATION = '*';
+    }
+    const isDebug = process.execArgv.some(argv => argv.includes('--debug') || argv.includes('--inspect'));
+    if (isDebug) {
+        options.isDebug = isDebug;
+    }
+    return options;
 }
-
-//#endregion
-export { parseOptions };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3B0aW9ucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9vcHRpb25zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUN6QixPQUFPLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDekIsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFDO0FBQzdCLE9BQU8sTUFBTSxNQUFNLGFBQWEsQ0FBQztBQUNqQyxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBQ3JDLE9BQU8sRUFBNkIsTUFBTSxVQUFVLENBQUM7QUFFckQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLFlBQVksRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUU5RCxNQUFNLEtBQUssR0FBRyxRQUFRLENBQUMsMkJBQTJCLENBQUMsQ0FBQztBQW9GcEQsTUFBTSxDQUFDLEtBQUssVUFBVSxZQUFZLENBQUMsT0FBd0I7SUFDekQsT0FBTyxHQUFHO1FBQ1IsT0FBTyxFQUFFLE9BQU8sQ0FBQyxHQUFHLEVBQUU7UUFDdEIsSUFBSSxFQUFFLE9BQU8sRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsU0FBUztRQUN2QyxTQUFTLEVBQUUsU0FBUztRQUNwQixhQUFhO1FBQ2IsR0FBRyxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsY0FBYztRQUMvQixHQUFHLE9BQU87S0FDWCxDQUFDO0lBRUYsTUFBTSxPQUFPLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBUSxFQUFFLGNBQWMsQ0FBQyxDQUFDO0lBQzVELE1BQU0sQ0FBQyxFQUFFLENBQUMsVUFBVSxDQUFDLE9BQU8sQ0FBQyxFQUFFLEdBQUcsT0FBTyxlQUFlLENBQUMsQ0FBQztJQUUxRCxPQUFPLENBQUMsU0FBUyxHQUFHLGdCQUFnQixDQUFDO1FBQ25DLE9BQU8sRUFBRSxPQUFPLENBQUMsT0FBUTtRQUN6Qiw4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

package/dist/utils/terminate.d.ts

@@ -0,0 +1,6 @@
+import { ChildProcess } from 'node:child_process';
+interface SubProcess extends ChildProcess {
+    process?: ChildProcess;
+}
+export declare function terminate(subProcess: SubProcess, timeout: number): Promise<void>;
+export {};