@eggjs/cluster 3.0.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Alibaba Group Holding Limited and other contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,92 @@
+# egg-cluster
+
+[![NPM version][npm-image]][npm-url]
+[![CI](https://github.com/eggjs/egg-cluster/actions/workflows/nodejs.yml/badge.svg)](https://github.com/eggjs/egg-cluster/actions/workflows/nodejs.yml)
+[![Test coverage][codecov-image]][codecov-url]
+[![Known Vulnerabilities][snyk-image]][snyk-url]
+[![npm download][download-image]][download-url]
+[![Node.js Version](https://img.shields.io/node/v/@eggjs/cluster.svg?style=flat)](https://nodejs.org/en/download/)
+
+[npm-image]: https://img.shields.io/npm/v/@eggjs/cluster.svg?style=flat-square
+[npm-url]: https://npmjs.org/package/@eggjs/cluster
+[codecov-image]: https://codecov.io/github/eggjs/egg-cluster/coverage.svg?branch=master
+[codecov-url]: https://codecov.io/github/eggjs/egg-cluster?branch=master
+[snyk-image]: https://snyk.io/test/npm/@eggjs/cluster/badge.svg?style=flat-square
+[snyk-url]: https://snyk.io/test/npm/@eggjs/cluster
+[download-image]: https://img.shields.io/npm/dm/@eggjs/cluster.svg?style=flat-square
+[download-url]: https://npmjs.org/package/@eggjs/cluster
+
+Cluster Manager for EggJS
+
+## Install
+
+```bash
+npm i @eggjs/cluster
+```
+
+## Usage
+
+CommonJS
+
+```js
+const { startCluster } = require('@eggjs/cluster');
+
+startCluster({
+  baseDir: '/path/to/app',
+  framework: '/path/to/framework',
+});
+```
+
+You can specify a callback that will be invoked when application has started.
+However, master process will exit when catch an error.
+
+```js
+startCluster(options).then(() => {
+  console.log('started');
+});
+```
+
+ESM and TypeScript
+
+```ts
+import { startCluster } from '@eggjs/cluster';
+
+startCluster({
+  baseDir: '/path/to/app',
+  framework: '/path/to/framework',
+});
+```
+
+## Options
+
+| Param        | Type      | Description                              |
+| ------------ | --------- | ---------------------------------------- |
+| baseDir      | `String`  | directory of application                 |
+| framework    | `String`  | specify framework that can be absolute path or npm package |
+| plugins      | `Object`  | plugins for unittest                     |
+| workers      | `Number`  | numbers of app workers                   |
+| sticky       | `Boolean` | sticky mode server                       |
+| port         | `Number`  | port                                     |
+| debugPort    | `Number`  | the debug port only listen on http protocol |
+| https        | `Object`  | start a https server, note: `key` / `cert` / `ca` should be full path to file |
+| require      | `Array\|String` | will inject into worker/agent process |
+| pidFile      | `String`  | will save master pid to this file |
+| startMode    | `String`  | default is 'process', use 'worker_threads' to start the app & agent worker by worker_threads |
+| ports        | `Array`   | startup port of each app worker, such as: [7001, 7002, 7003], only effects when the startMode is 'worker_threads' |
+| env        | `String`   | custom env, default is process.env.EGG_SERVER_ENV |
+
+## Env
+
+`EGG_APP_CLOSE_TIMEOUT`: app worker boot timeout value
+
+`EGG_AGENT_CLOSE_TIMEOUT`: agent worker boot timeout value
+
+## License
+
+[MIT](LICENSE)
+
+## Contributors
+
+[![Contributors](https://contrib.rocks/image?repo=eggjs/egg-cluster)](https://github.com/eggjs/egg-cluster/graphs/contributors)
+
+Made with [contributors-img](https://contrib.rocks).

package/dist/commonjs/agent_worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commonjs/agent_worker.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_util_1 = require("node:util");
+const egg_logger_1 = require("egg-logger");
+const utils_1 = require("@eggjs/utils");
+const agent_js_1 = require("./utils/mode/impl/worker_threads/agent.js");
+const agent_js_2 = require("./utils/mode/impl/process/agent.js");
+const debug = (0, node_util_1.debuglog)('@eggjs/cluster/agent_worker');
+/**
+ * agent worker is child_process forked by master.
+ *
+ * agent worker only exit in two cases:
+ *  - receive signal SIGTERM, exit code 0 (exit gracefully)
+ *  - receive disconnect event, exit code 110 (maybe master exit in accident)
+ */
+async function main() {
+    // $ node agent_worker.js options
+    const options = JSON.parse(process.argv[2]);
+    if (options.require) {
+        // inject
+        options.require.forEach(mod => {
+            require(mod);
+        });
+    }
+    let AgentWorker;
+    if (options.startMode === 'worker_threads') {
+        AgentWorker = agent_js_1.AgentThreadWorker;
+    }
+    else {
+        AgentWorker = agent_js_2.AgentProcessWorker;
+    }
+    const consoleLogger = new egg_logger_1.EggConsoleLogger({ level: process.env.EGG_AGENT_WORKER_LOGGER_LEVEL });
+    const { Agent } = await (0, utils_1.importModule)(options.framework);
+    debug('new Agent with options %j', options);
+    let agent;
+    try {
+        agent = new Agent(options);
+    }
+    catch (err) {
+        consoleLogger.error(err);
+        throw err;
+    }
+    function startErrorHandler(err) {
+        consoleLogger.error(err);
+        consoleLogger.error('[agent_worker] start error, exiting with code:1');
+        AgentWorker.kill();
+    }
+    agent.ready((err) => {
+        // don't send started message to master when start error
+        if (err) {
+            return;
+        }
+        agent.removeListener('error', startErrorHandler);
+        AgentWorker.send({ action: 'agent-start', to: 'master' });
+    });
+    // exit if agent start error
+    agent.once('error', startErrorHandler);
+    AgentWorker.gracefulExit({
+        logger: consoleLogger,
+        label: 'agent_worker',
+        beforeExit: () => agent.close(),
+    });
+}
+main();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnRfd29ya2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2FnZW50X3dvcmtlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLHlDQUFxQztBQUNyQywyQ0FBK0Q7QUFDL0Qsd0NBQTRDO0FBRTVDLHdFQUE4RTtBQUM5RSxpRUFBd0U7QUFFeEUsTUFBTSxLQUFLLEdBQUcsSUFBQSxvQkFBUSxFQUFDLDZCQUE2QixDQUFDLENBQUM7QUFFdEQ7Ozs7OztHQU1HO0FBQ0gsS0FBSyxVQUFVLElBQUk7SUFDakIsaUNBQWlDO0lBQ2pDLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FJekMsQ0FBQztJQUNGLElBQUksT0FBTyxDQUFDLE9BQU8sRUFBRSxDQUFDO1FBQ3BCLFNBQVM7UUFDVCxPQUFPLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsRUFBRTtZQUM1QixPQUFPLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDZixDQUFDLENBQUMsQ0FBQztJQUNMLENBQUM7SUFFRCxJQUFJLFdBQW1DLENBQUM7SUFDeEMsSUFBSSxPQUFPLENBQUMsU0FBUyxLQUFLLGdCQUFnQixFQUFFLENBQUM7UUFDM0MsV0FBVyxHQUFHLDRCQUF3QixDQUFDO0lBQ3pDLENBQUM7U0FBTSxDQUFDO1FBQ04sV0FBVyxHQUFHLDZCQUF5QixDQUFDO0lBQzFDLENBQUM7SUFFRCxNQUFNLGFBQWEsR0FBRyxJQUFJLDZCQUFhLENBQUMsRUFBRSxLQUFLLEVBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQyw2QkFBNkIsRUFBRSxDQUFDLENBQUM7SUFDOUYsTUFBTSxFQUFFLEtBQUssRUFBRSxHQUFHLE1BQU0sSUFBQSxvQkFBWSxFQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsQ0FBQztJQUN4RCxLQUFLLENBQUMsMkJBQTJCLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDNUMsSUFBSSxLQUFVLENBQUM7SUFDZixJQUFJLENBQUM7UUFDSCxLQUFLLEdBQUcsSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDN0IsQ0FBQztJQUFDLE9BQU8sR0FBRyxFQUFFLENBQUM7UUFDYixhQUFhLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ3pCLE1BQU0sR0FBRyxDQUFDO0lBQ1osQ0FBQztJQUVELFNBQVMsaUJBQWlCLENBQUMsR0FBVTtRQUNuQyxhQUFhLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ3pCLGFBQWEsQ0FBQyxLQUFLLENBQUMsaURBQWlELENBQUMsQ0FBQztRQUN2RSxXQUFXLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDckIsQ0FBQztJQUVELEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQyxHQUFXLEVBQUUsRUFBRTtRQUMxQix3REFBd0Q7UUFDeEQsSUFBSSxHQUFHLEVBQUUsQ0FBQztZQUNSLE9BQU87UUFDVCxDQUFDO1FBRUQsS0FBSyxDQUFDLGNBQWMsQ0FBQyxPQUFPLEVBQUUsaUJBQWlCLENBQUMsQ0FBQztRQUNqRCxXQUFXLENBQUMsSUFBSSxDQUFDLEVBQUUsTUFBTSxFQUFFLGFBQWEsRUFBRSxFQUFFLEVBQUUsUUFBUSxFQUFFLENBQUMsQ0FBQztJQUM1RCxDQUFDLENBQUMsQ0FBQztJQUVILDRCQUE0QjtJQUM1QixLQUFLLENBQUMsSUFBSSxDQUFDLE9BQU8sRUFBRSxpQkFBaUIsQ0FBQyxDQUFDO0lBRXZDLFdBQVcsQ0FBQyxZQUFZLENBQUM7UUFDdkIsTUFBTSxFQUFFLGFBQWE7UUFDckIsS0FBSyxFQUFFLGNBQWM7UUFDckIsVUFBVSxFQUFFLEdBQUcsRUFBRSxDQUFDLEtBQUssQ0FBQyxLQUFLLEVBQUU7S0FDaEMsQ0FBQyxDQUFDO0FBQ0wsQ0FBQztBQUVELElBQUksRUFBRSxDQUFDIn0=

package/dist/commonjs/app_worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commonjs/app_worker.js

@@ -0,0 +1,151 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_http_1 = require("node:http");
+const node_https_1 = require("node:https");
+const node_util_1 = require("node:util");
+const egg_logger_1 = require("egg-logger");
+const utils_1 = require("@eggjs/utils");
+const app_js_1 = require("./utils/mode/impl/worker_threads/app.js");
+const app_js_2 = require("./utils/mode/impl/process/app.js");
+const debug = (0, node_util_1.debuglog)('@eggjs/cluster/app_worker');
+async function main() {
+    // $ node app_worker.js options-json-string
+    const options = JSON.parse(process.argv[2]);
+    if (options.require) {
+        // inject
+        for (const mod of options.require) {
+            await (0, utils_1.importModule)(mod);
+        }
+    }
+    let AppWorker;
+    if (options.startMode === 'worker_threads') {
+        AppWorker = app_js_1.AppThreadWorker;
+    }
+    else {
+        AppWorker = app_js_2.AppProcessWorker;
+    }
+    const consoleLogger = new egg_logger_1.EggConsoleLogger({
+        level: process.env.EGG_APP_WORKER_LOGGER_LEVEL,
+    });
+    const { Application } = await (0, utils_1.importModule)(options.framework);
+    debug('new Application with options %j', options);
+    let app;
+    try {
+        app = new Application(options);
+    }
+    catch (err) {
+        consoleLogger.error(err);
+        throw err;
+    }
+    app.ready(startServer);
+    function exitProcess() {
+        // Use SIGTERM kill process, ensure trigger the gracefulExit
+        AppWorker.kill();
+    }
+    // exit if worker start timeout
+    app.once('startTimeout', startTimeoutHandler);
+    function startTimeoutHandler() {
+        consoleLogger.error('[app_worker] start timeout, exiting with code:1');
+        exitProcess();
+    }
+    function startServer(err) {
+        if (err) {
+            consoleLogger.error(err);
+            consoleLogger.error('[app_worker] start error, exiting with code:1');
+            exitProcess();
+            return;
+        }
+        const clusterConfig = app.config.cluster ?? {};
+        const listenConfig = clusterConfig.listen ?? {};
+        const httpsOptions = {
+            ...clusterConfig.https,
+            ...options.https,
+        };
+        const port = options.port = options.port ?? listenConfig.port;
+        const debugPort = options.debugPort;
+        const protocol = (httpsOptions.key && httpsOptions.cert) ? 'https' : 'http';
+        AppWorker.send({
+            to: 'master',
+            action: 'realport',
+            data: {
+                port,
+                protocol,
+            },
+        });
+        app.removeListener('startTimeout', startTimeoutHandler);
+        let server;
+        let debugPortServer;
+        // https config
+        if (protocol === 'https') {
+            httpsOptions.key = node_fs_1.default.readFileSync(httpsOptions.key);
+            httpsOptions.cert = node_fs_1.default.readFileSync(httpsOptions.cert);
+            httpsOptions.ca = httpsOptions.ca && node_fs_1.default.readFileSync(httpsOptions.ca);
+            server = (0, node_https_1.createServer)(httpsOptions, app.callback());
+            if (debugPort) {
+                debugPortServer = (0, node_http_1.createServer)(app.callback());
+            }
+        }
+        else {
+            server = (0, node_http_1.createServer)(app.callback());
+            if (debugPort) {
+                debugPortServer = server;
+            }
+        }
+        server.once('error', (err) => {
+            consoleLogger.error('[app_worker] server got error: %s, code: %s', err.message, err.code);
+            exitProcess();
+        });
+        // emit `server` event in app
+        app.emit('server', server);
+        if (options.sticky && options.stickyWorkerPort) {
+            server.listen(options.stickyWorkerPort, '127.0.0.1');
+            // Listen to messages was sent from the master. Ignore everything else.
+            AppWorker.on('message', (message, connection) => {
+                if (message !== 'sticky-session:connection') {
+                    return;
+                }
+                // Emulate a connection event on the server by emitting the
+                // event with the connection the master sent us.
+                server.emit('connection', connection);
+                connection.resume();
+            });
+        }
+        else {
+            if (listenConfig.path) {
+                server.listen(listenConfig.path);
+            }
+            else {
+                if (typeof port !== 'number') {
+                    consoleLogger.error('[app_worker] port should be number, but got %s(%s)', port, typeof port);
+                    exitProcess();
+                    return;
+                }
+                const args = [port];
+                if (listenConfig.hostname)
+                    args.push(listenConfig.hostname);
+                debug('listen options %s', args);
+                server.listen(...args);
+            }
+            if (debugPortServer) {
+                debug('listen on debug port: %s', debugPort);
+                debugPortServer.listen(debugPort);
+            }
+        }
+        AppWorker.send({
+            to: 'master',
+            action: 'listening',
+            data: server.address() || { port },
+        });
+    }
+    AppWorker.gracefulExit({
+        logger: consoleLogger,
+        label: 'app_worker',
+        beforeExit: () => app.close(),
+    });
+}
+main();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwX3dvcmtlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9hcHBfd29ya2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBQUEsc0RBQXlCO0FBQ3pCLHlDQUEwRTtBQUMxRSwyQ0FBK0Q7QUFFL0QseUNBQXFDO0FBQ3JDLDJDQUErRDtBQUMvRCx3Q0FBNEM7QUFFNUMsb0VBQTBFO0FBQzFFLDZEQUFvRTtBQUVwRSxNQUFNLEtBQUssR0FBRyxJQUFBLG9CQUFRLEVBQUMsMkJBQTJCLENBQUMsQ0FBQztBQUVwRCxLQUFLLFVBQVUsSUFBSTtJQUNqQiwyQ0FBMkM7SUFDM0MsTUFBTSxPQUFPLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQVN6QyxDQUFDO0lBQ0YsSUFBSSxPQUFPLENBQUMsT0FBTyxFQUFFLENBQUM7UUFDcEIsU0FBUztRQUNULEtBQUssTUFBTSxHQUFHLElBQUksT0FBTyxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQ2xDLE1BQU0sSUFBQSxvQkFBWSxFQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQzFCLENBQUM7SUFDSCxDQUFDO0lBRUQsSUFBSSxTQUErQixDQUFDO0lBQ3BDLElBQUksT0FBTyxDQUFDLFNBQVMsS0FBSyxnQkFBZ0IsRUFBRSxDQUFDO1FBQzNDLFNBQVMsR0FBRyx3QkFBc0IsQ0FBQztJQUNyQyxDQUFDO1NBQU0sQ0FBQztRQUNOLFNBQVMsR0FBRyx5QkFBdUIsQ0FBQztJQUN0QyxDQUFDO0lBRUQsTUFBTSxhQUFhLEdBQUcsSUFBSSw2QkFBYSxDQUFDO1FBQ3RDLEtBQUssRUFBRSxPQUFPLENBQUMsR0FBRyxDQUFDLDJCQUEyQjtLQUMvQyxDQUFDLENBQUM7SUFDSCxNQUFNLEVBQUUsV0FBVyxFQUFFLEdBQUcsTUFBTSxJQUFBLG9CQUFZLEVBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzlELEtBQUssQ0FBQyxpQ0FBaUMs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

package/dist/commonjs/dirname.d.ts

@@ -0,0 +1 @@
+export declare function getSrcDirname(): string;

package/dist/commonjs/dirname.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSrcDirname = getSrcDirname;
+const node_url_1 = require("node:url");
+const node_path_1 = __importDefault(require("node:path"));
+function getSrcDirname() {
+    if (typeof __dirname !== 'undefined') {
+        return __dirname;
+    }
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    return node_path_1.default.dirname((0, node_url_1.fileURLToPath)('import_meta_url_placeholder_by_tshy_after'));
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGlybmFtZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kaXJuYW1lLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBR0Esc0NBT0M7QUFWRCx1Q0FBeUM7QUFDekMsMERBQTZCO0FBRTdCLFNBQWdCLGFBQWE7SUFDM0IsSUFBSSxPQUFPLFNBQVMsS0FBSyxXQUFXLEVBQUUsQ0FBQztRQUNyQyxPQUFPLFNBQVMsQ0FBQztJQUNuQixDQUFDO0lBQ0QsNkRBQTZEO0lBQzdELGFBQWE7SUFDYixPQUFPLG1CQUFJLENBQUMsT0FBTyxDQUFDLElBQUEsd0JBQWEsRUFBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUM7QUFDdEQsQ0FBQyJ9

package/dist/commonjs/error/ClusterAgentWorkerError.d.ts

@@ -0,0 +1,10 @@
+export declare class ClusterAgentWorkerError extends Error {
+    id: number;
+    /**
+     * pid in process mode
+     * tid in worker_threads mode
+     */
+    workerId: number;
+    status: string;
+    constructor(id: number, workerId: number, status: string, error: Error);
+}

package/dist/commonjs/error/ClusterAgentWorkerError.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClusterAgentWorkerError = void 0;
+class ClusterAgentWorkerError extends Error {
+    id;
+    /**
+     * pid in process mode
+     * tid in worker_threads mode
+     */
+    workerId;
+    status;
+    constructor(id, workerId, status, error) {
+        const message = `Got agent worker error: ${error.message}`;
+        super(message, { cause: error });
+        this.name = this.constructor.name;
+        this.id = id;
+        this.workerId = workerId;
+        this.status = status;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.ClusterAgentWorkerError = ClusterAgentWorkerError;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ2x1c3RlckFnZW50V29ya2VyRXJyb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZXJyb3IvQ2x1c3RlckFnZW50V29ya2VyRXJyb3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsTUFBYSx1QkFBd0IsU0FBUSxLQUFLO0lBQ2hELEVBQUUsQ0FBUztJQUNYOzs7T0FHRztJQUNILFFBQVEsQ0FBUztJQUNqQixNQUFNLENBQVM7SUFFZixZQUFZLEVBQVUsRUFBRSxRQUFnQixFQUFFLE1BQWMsRUFBRSxLQUFZO1FBQ3BFLE1BQU0sT0FBTyxHQUFHLDJCQUEyQixLQUFLLENBQUMsT0FBTyxFQUFFLENBQUM7UUFDM0QsS0FBSyxDQUFDLE9BQU8sRUFBRSxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO1FBQ2pDLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDLFdBQVcsQ0FBQyxJQUFJLENBQUM7UUFDbEMsSUFBSSxDQUFDLEVBQUUsR0FBRyxFQUFFLENBQUM7UUFDYixJQUFJLENBQUMsUUFBUSxHQUFHLFFBQVEsQ0FBQztRQUN6QixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztRQUNyQixLQUFLLENBQUMsaUJBQWlCLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUNsRCxDQUFDO0NBQ0Y7QUFsQkQsMERBa0JDIn0=

package/dist/commonjs/error/ClusterWorkerExceptionError.d.ts

@@ -0,0 +1,7 @@
+export declare class ClusterWorkerExceptionError extends Error {
+    count: {
+        agent: number;
+        worker: number;
+    };
+    constructor(agent: number, worker: number);
+}

package/dist/commonjs/error/ClusterWorkerExceptionError.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClusterWorkerExceptionError = void 0;
+class ClusterWorkerExceptionError extends Error {
+    count;
+    constructor(agent, worker) {
+        const message = `[master] ${agent} agent and ${worker} worker(s) alive, exit to avoid unknown state`;
+        super(message);
+        this.name = this.constructor.name;
+        this.count = {
+            agent,
+            worker,
+        };
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.ClusterWorkerExceptionError = ClusterWorkerExceptionError;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ2x1c3RlcldvcmtlckV4Y2VwdGlvbkVycm9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2Vycm9yL0NsdXN0ZXJXb3JrZXJFeGNlcHRpb25FcnJvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxNQUFhLDJCQUE0QixTQUFRLEtBQUs7SUFDcEQsS0FBSyxDQUdIO0lBRUYsWUFBWSxLQUFhLEVBQUUsTUFBYztRQUN2QyxNQUFNLE9BQU8sR0FBRyxZQUFZLEtBQUssY0FBYyxNQUFNLCtDQUErQyxDQUFDO1FBQ3JHLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUNmLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDLFdBQVcsQ0FBQyxJQUFJLENBQUM7UUFDbEMsSUFBSSxDQUFDLEtBQUssR0FBRztZQUNYLEtBQUs7WUFDTCxNQUFNO1NBQ1AsQ0FBQztRQUNGLEtBQUssQ0FBQyxpQkFBaUIsQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLFdBQVcsQ0FBQyxDQUFDO0lBQ2xELENBQUM7Q0FDRjtBQWhCRCxrRUFnQkMifQ==

package/dist/commonjs/error/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ClusterAgentWorkerError.js';
+export * from './ClusterWorkerExceptionError.js';

package/dist/commonjs/error/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ClusterAgentWorkerError.js"), exports);
+__exportStar(require("./ClusterWorkerExceptionError.js"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZXJyb3IvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLCtEQUE2QztBQUM3QyxtRUFBaUQifQ==

package/dist/commonjs/index.d.ts

@@ -0,0 +1,17 @@
+import { Master, MasterOptions } from './master.js';
+import { ClusterOptions, ClusterHTTPSSecureOptions, ClusterStartMode } from './utils/options.js';
+/**
+ * cluster start flow:
+ *
+ * [startCluster] -> master -> agent_worker -> new [Agent]       -> agentWorkerLoader
+ *                         `-> app_worker   -> new [Application] -> appWorkerLoader
+ *
+ */
+/**
+ * start egg app
+ * @function Egg#startCluster
+ * @param {Object} options {@link Master}
+ */
+export declare function startCluster(options: ClusterOptions): Promise<void>;
+export { Master, MasterOptions, ClusterOptions, ClusterHTTPSSecureOptions, ClusterStartMode, };
+export * from './error/index.js';

package/dist/commonjs/index.js

@@ -0,0 +1,37 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Master = void 0;
+exports.startCluster = startCluster;
+const master_js_1 = require("./master.js");
+Object.defineProperty(exports, "Master", { enumerable: true, get: function () { return master_js_1.Master; } });
+/**
+ * cluster start flow:
+ *
+ * [startCluster] -> master -> agent_worker -> new [Agent]       -> agentWorkerLoader
+ *                         `-> app_worker   -> new [Application] -> appWorkerLoader
+ *
+ */
+/**
+ * start egg app
+ * @function Egg#startCluster
+ * @param {Object} options {@link Master}
+ */
+async function startCluster(options) {
+    await new master_js_1.Master(options).ready();
+}
+__exportStar(require("./error/index.js"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFnQkEsb0NBRUM7QUFsQkQsMkNBQW9EO0FBcUJsRCx1RkFyQk8sa0JBQU0sT0FxQlA7QUFsQlI7Ozs7OztHQU1HO0FBRUg7Ozs7R0FJRztBQUNJLEtBQUssVUFBVSxZQUFZLENBQUMsT0FBdUI7SUFDeEQsTUFBTSxJQUFJLGtCQUFNLENBQUMsT0FBTyxDQUFDLENBQUMsS0FBSyxFQUFFLENBQUM7QUFDcEMsQ0FBQztBQU9ELG1EQUFpQyJ9

package/dist/commonjs/master.d.ts

@@ -0,0 +1,90 @@
+import { ReadyEventEmitter } from 'get-ready';
+import { EggConsoleLogger as ConsoleLogger } from 'egg-logger';
+import { ClusterOptions, ParsedClusterOptions } from './utils/options.js';
+import { WorkerManager } from './utils/worker_manager.js';
+import { Messenger } from './utils/messenger.js';
+import { AgentProcessUtils as ProcessAgentWorker } from './utils/mode/impl/process/agent.js';
+import { AppProcessUtils as ProcessAppWorker } from './utils/mode/impl/process/app.js';
+import { AgentThreadUtils as WorkerThreadsAgentWorker } from './utils/mode/impl/worker_threads/agent.js';
+import { AppThreadUtils as WorkerThreadsAppWorker } from './utils/mode/impl/worker_threads/app.js';
+export interface MasterOptions extends ParsedClusterOptions {
+    clusterPort?: number;
+    stickyWorkerPort?: number;
+}
+export declare class Master extends ReadyEventEmitter {
+    #private;
+    options: MasterOptions;
+    isStarted: boolean;
+    workerManager: WorkerManager;
+    messenger: Messenger;
+    isProduction: boolean;
+    agentWorkerIndex: number;
+    closed: boolean;
+    logger: ConsoleLogger;
+    agentWorker: ProcessAgentWorker | WorkerThreadsAgentWorker;
+    appWorker: ProcessAppWorker | WorkerThreadsAppWorker;
+    constructor(options?: ClusterOptions);
+    startByProcess(): void;
+    startByWorkerThreads(): void;
+    detectPorts(): Promise<void>;
+    log(msg: string, ...args: any[]): void;
+    startMasterSocketServer(cb: (err?: Error) => void): void;
+    stickyWorker(ip: string): import("./utils/mode/base/app.js").BaseAppWorker<import("worker_threads").Worker | import("cluster").Worker>;
+    forkAgentWorker(): void;
+    forkAppWorkers(): void;
+    /**
+     * close agent worker, App Worker will closed by cluster
+     *
+     * https://www.exratione.com/2013/05/die-child-process-die/
+     * make sure Agent Worker exit before master exit
+     *
+     * @param {number} timeout - kill agent timeout
+     * @return {Promise} -
+     */
+    killAgentWorker(timeout: number): Promise<void>;
+    killAppWorkers(timeout: number): Promise<void>;
+    /**
+     * Agent Worker exit handler
+     * Will exit during startup, and refork during running.
+     */
+    onAgentExit(data: {
+        /** exit code */
+        code: number;
+        /** received signal */
+        signal: string;
+    }): void;
+    onAgentStart(): void;
+    /**
+     * App Worker exit handler
+     */
+    onAppExit(data: {
+        workerId: number;
+        code: number;
+        signal: string;
+    }): void;
+    /**
+     * after app worker
+     */
+    onAppStart(data: {
+        workerId: number;
+        address: ListeningAddress;
+    }): void;
+    /**
+     * master exit handler
+     */
+    onExit(code: number): void;
+    onSignal(signal: string): void;
+    /**
+     * reload workers, for develop purpose
+     */
+    onReload(): void;
+    close(): Promise<void>;
+    _doClose(): Promise<void>;
+}
+interface ListeningAddress {
+    port: number;
+    protocol: string;
+    address?: string;
+    addressType?: number;
+}
+export {};