ee-core 5.0.0-beta.2 → 5.0.0-beta.6

package/dist/cjs/cross/cross.js

@@ -4,6 +4,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cross = exports.Cross = void 0;
+/**
+ * @module cross/cross
+ * @description Cross-process communication manager. Responsible for creating, managing, and terminating
+ * external child processes (e.g., Go/Python backends), and dynamically allocating ports for them.
+ *
+ * Core concepts:
+ * - children: Process mapping keyed by pid, storing CrossProcess instances
+ * - childrenMap: Mapping keyed by name, for quick process lookup by name
+ * - Event listening: Automatically cleans up from mappings when child processes exit/error
+ *
+ * Usage:
+ * ```ts
+ * const proc = await cross.run('goServer');
+ * const url = cross.getUrl('goServer');
+ * cross.killByName('goServer');
+ * ```
+ */
 const events_1 = __importDefault(require("events"));
 const index_js_1 = require("../config/index.js");
 const helper_js_1 = require("../utils/helper.js");
@@ -11,6 +28,12 @@ const crossProcess_js_1 = require("./crossProcess.js");
 const channel_js_1 = require("../const/channel.js");
 const extend_js_1 = require("../utils/extend.js");
 const index_js_2 = require("../utils/port/index.js");
+/**
+ * Cross - cross-process communication manager
+ *
+ * Implements the CrossHost interface, providing event notification capability for child processes.
+ * Manages processes via children and childrenMap dual indexes, supporting operations by pid or name.
+ */
 class Cross {
     constructor() {
         this.emitter = undefined;
@@ -18,18 +41,34 @@ class Cross {
         this.childrenMap = {};
         this._initEventEmitter();
     }
+    /**
+     * Create and start all cross-process services with enable=true in config
+     *
+     * Iterates over config.cross configuration, calling run() for each service with enable=true.
+     */
     async create() {
-        // boot services
         const crossCfg = (0, index_js_1.getConfig)().cross;
-        //await sleep(5 * 1000);
         for (const key of Object.keys(crossCfg)) {
             const val = crossCfg[key];
             if (val && val.enable === true) {
-                this.run(key);
+                await this.run(key);
             }
         }
     }
-    // run
+    /**
+     * Run the specified cross-process service
+     *
+     * Flow:
+     * 1. Get service configuration from config, merge with runtime options
+     * 2. Parse port parameter, dynamically acquire available port if specified
+     * 3. Create CrossProcess child process
+     * 4. Register in children and childrenMap indexes
+     *
+     * @param service - Service name (corresponding to key name in config.cross)
+     * @param opt - Runtime options, can override configuration parameters
+     * @returns CrossProcess instance
+     * @throws Throws error when service configuration does not exist
+     */
     async run(service, opt = {}) {
         const crossConf = (0, index_js_1.getConfig)().cross;
         const defaultOpt = crossConf[service] || {};
@@ -37,22 +76,23 @@ class Cross {
         if (Object.keys(targetConf).length === 0) {
             throw new Error(`[ee-core] [cross] The service [${service}] config does not exit`);
         }
-        // format params
+        // Parse and allocate port
         const tmpArgs = targetConf.args || [];
         let confPort = parseInt(String((0, helper_js_1.getValueFromArgv)(tmpArgs, 'port') || '0'), 10);
-        // 某些程序给它传入不存在的参数时会报错
+        // Some programs error when passed non-existent arguments, in which case use the port field from config
         if (isNaN(confPort) && (targetConf.port || 0) > 0) {
             confPort = targetConf.port || 0;
         }
         if (confPort > 0) {
-            // 动态生成port，传入的端口必须为int
+            // Dynamically acquire available port
             confPort = await (0, index_js_2.getPort)({ port: confPort });
-            // 替换port
+            // Replace port number in arguments
             targetConf.args = (0, helper_js_1.replaceArgsValue)(tmpArgs, 'port', String(confPort));
         }
-        // 创建进程
+        // Create child process
         const subProcess = new crossProcess_js_1.CrossProcess(this, { targetConf, port: confPort });
         let uniqueName = targetConf.name;
+        // Append pid suffix for duplicate service names to avoid conflicts
         if (Object.prototype.hasOwnProperty.call(this.childrenMap, uniqueName)) {
             uniqueName = uniqueName + '-' + String(subProcess.pid);
         }
@@ -64,31 +104,49 @@ class Cross {
         };
         return subProcess;
     }
+    /** Terminate all child processes */
     killAll() {
         Object.keys(this.children).forEach((pid) => {
             this.kill(pid);
         });
     }
+    /** Terminate child process by pid */
     kill(pid) {
         const entity = this.getProc(pid);
         if (entity) {
             entity.kill();
         }
     }
+    /** Terminate child process by name */
     killByName(name) {
         const entity = this.getProcByName(name);
         if (entity) {
             entity.kill();
         }
     }
+    /**
+     * Get the URL of the specified service
+     *
+     * @param name - Service name
+     * @returns Service URL, or undefined if process does not exist
+     */
     getUrl(name) {
-        const entity = this.getProcByName(name);
-        const url = entity.getUrl();
-        return url;
+        const pid = this.childrenMap[name];
+        if (!pid)
+            return undefined;
+        const child = this.children[String(pid)];
+        if (!child)
+            return undefined;
+        return child.entity.getUrl();
     }
-    // 获取 proc
+    /**
+     * Get process instance by name
+     *
+     * @param name - Service name
+     * @returns CrossProcess instance
+     * @throws Throws error when process does not exist
+     */
     getProcByName(name) {
-        // [todo] 如果有名字一样的服务，需要加 pid
         const pid = this.childrenMap[name];
         if (!pid) {
             throw new Error(`[ee-core] [cross] The process named [${name}] does not exit`);
@@ -96,7 +154,13 @@ class Cross {
         const entity = this.getProc(pid);
         return entity;
     }
-    // 获取 proc
+    /**
+     * Get process instance by pid
+     *
+     * @param pid - Process ID
+     * @returns CrossProcess instance
+     * @throws Throws error when process does not exist
+     */
     getProc(pid) {
         const child = this.children[String(pid)];
         if (!child) {
@@ -104,11 +168,16 @@ class Cross {
         }
         return child.entity;
     }
-    // 获取pids
+    /** Get list of all child process pids */
     getPids() {
         const pids = Object.keys(this.children);
         return pids;
     }
+    /**
+     * Initialize event listeners
+     *
+     * Listens for child process exit and error events, automatically cleaning up terminated processes from indexes.
+     */
     _initEventEmitter() {
         this.emitter = new events_1.default();
         this.emitter.on(channel_js_1.Events.childProcessExit, (data) => {
@@ -128,5 +197,6 @@ class Cross {
     }
 }
 exports.Cross = Cross;
+/** Cross manager singleton */
 exports.cross = new Cross();
 //# sourceMappingURL=cross.js.map

package/dist/cjs/cross/cross.js.map

@@ -1 +1 @@
-{"version":3,"file":"cross.js","sourceRoot":"","sources":["../../../src/cross/cross.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cross.js","sourceRoot":"","sources":["../../../src/cross/cross.ts"],"names":[],"mappings":"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"}

package/dist/cjs/cross/crossProcess.d.ts

@@ -1,46 +1,117 @@
+/**
+ * @module cross/crossProcess
+ * @description Cross-process child process management. Encapsulates the logic of using cross-spawn
+ * to create external processes, handling process path resolution, platform differences,
+ * lifecycle monitoring, and graceful exit.
+ *
+ * Supported external program types:
+ * - Go compiled binaries
+ * - Python scripts
+ * - Other executable programs
+ *
+ * Process path resolution rules:
+ * - Config has cmd → use cmd as executable file path
+ * - Config has no cmd → use extraResourcesDir/{name} as path
+ * - Windows platform automatically adds .exe extension
+ * - Dev environment relative to project root, production relative to extraResources directory
+ */
 import EventEmitter from 'events';
 import crossSpawn from 'cross-spawn';
-export interface CrossTargetConfig {
-    name: string;
-    args?: string[];
-    cmd?: string;
-    directory?: string;
-    windowsExtname?: boolean;
-    stdio?: ('pipe' | 'ignore' | 'inherit' | 'ipc')[];
-    appExit?: boolean;
-    port?: number;
-    enable?: boolean;
-}
+import type { CrossTargetConfig } from '../types/index.js';
+export type { CrossTargetConfig };
+/** Options when creating a CrossProcess */
 export interface CrossProcessOptions {
+    /** Target service configuration */
     targetConf: CrossTargetConfig;
+    /** Allocated port number */
     port: number;
 }
+/**
+ * CrossProcess - child process instance
+ *
+ * Encapsulates the complete lifecycle of an external process:
+ * Create → Run → Listen for events → Terminate
+ *
+ * Notifies the Cross manager of child process events (exit/error) via the host's emitter.
+ */
 export declare class CrossProcess {
+    /** Event emitter */
     emitter: EventEmitter;
+    /** Host (Cross manager), used to notify process events */
     host: CrossHost;
+    /** Child process object returned by cross-spawn */
     child: ReturnType<typeof crossSpawn> | undefined;
+    /** Child process PID */
     pid: number;
+    /** Allocated port number */
     port: number;
+    /** Unique service name (may be rewritten by Cross manager to avoid conflicts) */
     name: string;
+    /** Service configuration */
     config: CrossTargetConfig;
     constructor(host: CrossHost, opt?: CrossProcessOptions);
     /**
-     * 初始化子进程
+     * Initialize child process
+     *
+     * Execution flow:
+     * 1. Save configuration and port
+     * 2. Resolve executable file path (handle cmd/directory configuration and platform differences)
+     * 3. Set standard output mode (inherit in dev environment, ignore in production)
+     * 4. Start child process using cross-spawn
+     * 5. Listen for exit and error events
      */
     _init(options?: CrossProcessOptions): void;
     /**
-     * kill
+     * Terminate child process
+     *
+     * First sends SIGINT signal for graceful exit, then sends SIGKILL for forced termination if it fails.
+     * If the process still hasn't exited after timeout, triggers _exitElectron as a safety net.
+     *
+     * @param timeout - Timeout for waiting exit (milliseconds)
      */
     kill(timeout?: number): void;
+    /**
+     * Get the service URL of the child process
+     *
+     * Parses hostname and ssl flag from startup arguments, constructs HTTP/HTTPS URL.
+     * Outputs warning when port is 0 (service may not have bound port correctly).
+     *
+     * @returns Service URL, e.g., http://127.0.0.1:7070
+     */
     getUrl(): string;
+    /**
+     * Get key-value object of startup arguments
+     *
+     * @returns Parsed arguments object
+     */
     getArgsObj(): Record<string, unknown>;
+    /**
+     * Set port number
+     *
+     * @param port - Port number (strings will be converted to numbers)
+     */
     setPort(port: string | number): void;
+    /**
+     * Generate unique ID
+     *
+     * @returns Unique identifier in the format 'node:{pid}:{randomString}'
+     */
     _generateId(): string;
     /**
-     * exit electron
+     * Trigger Electron main process exit when child process exits
+     *
+     * Only effective when appExit=true is configured, ensuring the main process also exits when the child process crashes.
+     *
+     * @param timeout - Delayed exit time (milliseconds), waiting for resource release
      */
     _exitElectron(timeout?: number): void;
 }
+/**
+ * CrossHost interface
+ *
+ * CrossProcess communicates with the host (Cross manager) through this interface,
+ * sending child process exit and error events.
+ */
 export interface CrossHost {
     emitter: EventEmitter | undefined;
 }

package/dist/cjs/cross/crossProcess.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crossProcess.d.ts","sourceRoot":"","sources":["../../../src/cross/crossProcess.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAElC,OAAO,UAAU,MAAM,aAAa,CAAC;AAUrC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,YAAY;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,SAAS,CAAC;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;gBAEd,IAAI,EAAE,SAAS,EAAE,GAAG,GAAE,mBAA2D;IAW7F;;OAEG;IACH,KAAK,CAAC,OAAO,GAAE,mBAA2D,GAAG,IAAI;IAqFjF;;OAEG;IACH,IAAI,CAAC,OAAO,SAAO,GAAG,IAAI;IAc1B,MAAM,IAAI,MAAM;IAahB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIpC,WAAW,IAAI,MAAM;IAKrB;;OAEG;IACH,aAAa,CAAC,OAAO,SAAO,GAAG,IAAI;CAQpC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC"}
+{"version":3,"file":"crossProcess.d.ts","sourceRoot":"","sources":["../../../src/cross/crossProcess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,YAAY,MAAM,QAAQ,CAAC;AAElC,OAAO,UAAU,MAAM,aAAa,CAAC;AASrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,oBAAoB;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,0DAA0D;IAC1D,IAAI,EAAE,SAAS,CAAC;IAChB,mDAAmD;IACnD,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,SAAS,CAAC;IACjD,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,iBAAiB,CAAC;gBAEd,IAAI,EAAE,SAAS,EAAE,GAAG,GAAE,mBAA2D;IAW7F;;;;;;;;;OASG;IACH,KAAK,CAAC,OAAO,GAAE,mBAA2D,GAAG,IAAI;IAuFjF;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,SAAO,GAAG,IAAI;IAkB1B;;;;;;;OAOG;IACH,MAAM,IAAI,MAAM;IAgBhB;;;;OAIG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKrC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIpC;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAKrB;;;;;;OAMG;IACH,aAAa,CAAC,OAAO,SAAO,GAAG,IAAI;CAOpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC"}

package/dist/cjs/cross/crossProcess.js

@@ -37,6 +37,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CrossProcess = void 0;
+/**
+ * @module cross/crossProcess
+ * @description Cross-process child process management. Encapsulates the logic of using cross-spawn
+ * to create external processes, handling process path resolution, platform differences,
+ * lifecycle monitoring, and graceful exit.
+ *
+ * Supported external program types:
+ * - Go compiled binaries
+ * - Python scripts
+ * - Other executable programs
+ *
+ * Process path resolution rules:
+ * - Config has cmd → use cmd as executable file path
+ * - Config has no cmd → use extraResourcesDir/{name} as path
+ * - Windows platform automatically adds .exe extension
+ * - Dev environment relative to project root, production relative to extraResources directory
+ */
 const events_1 = __importDefault(require("events"));
 const path_1 = __importDefault(require("path"));
 const cross_spawn_1 = __importDefault(require("cross-spawn"));
@@ -48,6 +65,14 @@ const helper_js_1 = require("../utils/helper.js");
 const pargv_js_1 = require("../utils/pargv.js");
 const is = __importStar(require("../utils/is.js"));
 const index_js_3 = require("../electron/app/index.js");
+/**
+ * CrossProcess - child process instance
+ *
+ * Encapsulates the complete lifecycle of an external process:
+ * Create → Run → Listen for events → Terminate
+ *
+ * Notifies the Cross manager of child process events (exit/error) via the host's emitter.
+ */
 class CrossProcess {
     constructor(host, opt = { targetConf: { name: '' }, port: 0 }) {
         this.emitter = new events_1.default();
@@ -60,18 +85,26 @@ class CrossProcess {
         this._init(opt);
     }
     /**
-     * 初始化子进程
+     * Initialize child process
+     *
+     * Execution flow:
+     * 1. Save configuration and port
+     * 2. Resolve executable file path (handle cmd/directory configuration and platform differences)
+     * 3. Set standard output mode (inherit in dev environment, ignore in production)
+     * 4. Start child process using cross-spawn
+     * 5. Listen for exit and error events
      */
     _init(options = { targetConf: { name: '' }, port: 0 }) {
         const { targetConf, port } = options;
         this.config = targetConf;
         this.port = port;
-        // 该名称如果在childrenMap重复，会被重写
+        // This name may be rewritten by the Cross manager if duplicated in childrenMap
         this.name = targetConf.name;
-        // Launch executable program
+        // Resolve executable file path
         let cmdPath = '';
         const cmdArgs = targetConf.args || [];
         let execDir = (0, index_js_2.getExtraResourcesDir)();
+        // Standard output configuration: inherit terminal output in dev, ignore in production
         let standardOutput = ['inherit', 'inherit', 'inherit', 'ipc'];
         if ((0, index_js_2.isPackaged)()) {
             standardOutput = ['ignore', 'ignore', 'ignore', 'ipc'];
@@ -80,28 +113,28 @@ class CrossProcess {
             standardOutput = targetConf.stdio;
         }
         const { cmd, directory } = targetConf;
-        // use cmd first
+        // Prefer cmd configuration
         if (cmd) {
             if (!directory) {
                 throw new Error(`[ee-core] [cross] The config [directory] attribute does not exist`);
             }
             cmdPath = cmd;
+            // In non-dev environments, relative paths are resolved based on extraResources
             if (!path_1.default.isAbsolute(cmd) && !(0, index_js_2.isDev)()) {
                 cmdPath = path_1.default.join((0, index_js_2.getExtraResourcesDir)(), cmd);
             }
         }
         else {
+            // Without cmd, use extraResourcesDir/{name} as the executable file path
             cmdPath = path_1.default.join((0, index_js_2.getExtraResourcesDir)(), targetConf.name);
         }
-        // windows
+        // Windows platform automatically adds .exe extension
         if (is.windows() && path_1.default.extname(cmdPath) !== '.exe') {
-            // Complete the executable program extension
-            // notice: python.exe may bring up the App Store
             if (targetConf.windowsExtname === true || !(0, index_js_2.isDev)()) {
                 cmdPath += '.exe';
             }
         }
-        // executable program directory
+        // Resolve working directory
         if (directory && path_1.default.isAbsolute(directory)) {
             execDir = directory;
         }
@@ -124,13 +157,14 @@ class CrossProcess {
         });
         this.child = coreProcess;
         this.pid = coreProcess.pid || 0;
+        // Listen for child process exit: caused by external termination or internal error
         coreProcess.on('exit', (code, signal) => {
             const data = { pid: this.pid };
             this.host.emitter?.emit(channel_js_1.Events.childProcessExit, data);
-            // Child process closed: The child process was killed externally or an internal error caused the application to stop, resulting in the application exiting
             index_js_1.coreLogger.info(`[cross/process] received a exit from child-process, code:${code}, signal:${signal}, pid:${this.pid}, cmd:${cmdPath}, args: ${cmdArgs}`);
             this._exitElectron();
         });
+        // Listen for child process errors
         coreProcess.on('error', (err) => {
             const data = { pid: this.pid };
             this.host.emitter?.emit(channel_js_1.Events.childProcessError, data);
@@ -139,20 +173,40 @@ class CrossProcess {
         });
     }
     /**
-     * kill
+     * Terminate child process
+     *
+     * First sends SIGINT signal for graceful exit, then sends SIGKILL for forced termination if it fails.
+     * If the process still hasn't exited after timeout, triggers _exitElectron as a safety net.
+     *
+     * @param timeout - Timeout for waiting exit (milliseconds)
      */
     kill(timeout = 1000) {
         (0, tree_kill_1.default)(this.pid, 'SIGINT', (err) => {
             if (err) {
                 index_js_1.coreLogger.error(`[cross/process] kill cross-process, error: ${err}, pid:${this.pid}`);
+                // SIGINT failed, use SIGKILL for forced termination
                 (0, tree_kill_1.default)(this.pid, 'SIGKILL');
             }
+            // Timeout safety net: if exit event is not triggered within timeout, manually call _exitElectron
             setTimeout(() => {
-                this._exitElectron();
+                if (this.child && !this.child.killed) {
+                    this._exitElectron();
+                }
             }, timeout);
         });
     }
+    /**
+     * Get the service URL of the child process
+     *
+     * Parses hostname and ssl flag from startup arguments, constructs HTTP/HTTPS URL.
+     * Outputs warning when port is 0 (service may not have bound port correctly).
+     *
+     * @returns Service URL, e.g., http://127.0.0.1:7070
+     */
     getUrl() {
+        if (!this.port) {
+            index_js_1.coreLogger.warn(`[cross/process] getUrl called with port 0, pid:${this.pid}`);
+        }
         const ssl = (0, helper_js_1.getValueFromArgv)(this.config.args || [], 'ssl');
         let hostname = (0, helper_js_1.getValueFromArgv)(this.config.args || [], 'hostname');
         let protocol = 'http://';
@@ -163,24 +217,42 @@ class CrossProcess {
         const url = protocol + hostname + ':' + this.port;
         return url;
     }
+    /**
+     * Get key-value object of startup arguments
+     *
+     * @returns Parsed arguments object
+     */
     getArgsObj() {
         const obj = (0, pargv_js_1.parseArgv)(this.config.args || []);
         return obj;
     }
+    /**
+     * Set port number
+     *
+     * @param port - Port number (strings will be converted to numbers)
+     */
     setPort(port) {
         this.port = typeof port === 'string' ? parseInt(port, 10) : port;
     }
+    /**
+     * Generate unique ID
+     *
+     * @returns Unique identifier in the format 'node:{pid}:{randomString}'
+     */
     _generateId() {
         const rid = (0, helper_js_1.getRandomString)();
         return `node:${this.pid}:${rid}`;
     }
     /**
-     * exit electron
+     * Trigger Electron main process exit when child process exits
+     *
+     * Only effective when appExit=true is configured, ensuring the main process also exits when the child process crashes.
+     *
+     * @param timeout - Delayed exit time (milliseconds), waiting for resource release
      */
     _exitElectron(timeout = 1000) {
         if (this.config.appExit) {
             setTimeout(() => {
-                // 主进程退出
                 index_js_3.electronApp.quit();
             }, timeout);
         }

package/dist/cjs/cross/crossProcess.js.map

@@ -1 +1 @@
-{"version":3,"file":"crossProcess.js","sourceRoot":"","sources":["../../../src/cross/crossProcess.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"crossProcess.js","sourceRoot":"","sources":["../../../src/cross/crossProcess.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,oDAAkC;AAClC,gDAAwB;AACxB,8DAAqC;AACrC,0DAA8B;AAC9B,8CAA6C;AAC7C,6CAAqF;AACrF,oDAA6C;AAC7C,kDAAuE;AACvE,gDAA8C;AAC9C,mDAAqC;AACrC,uDAAuD;AAavD;;;;;;;GAOG;AACH,MAAa,YAAY;IAgBvB,YAAY,IAAe,EAAE,MAA2B,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;QAC3F,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAY,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,UAA+B,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;QACxE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,+EAA+E;QAC/E,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAE5B,+BAA+B;QAC/B,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;QACtC,IAAI,OAAO,GAAG,IAAA,+BAAoB,GAAE,CAAC;QACrC,sFAAsF;QACtF,IAAI,cAAc,GAA8C,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACzG,IAAI,IAAA,qBAAU,GAAE,EAAE,CAAC;YACjB,cAAc,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QACpC,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;QACtC,2BAA2B;QAC3B,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;YACvF,CAAC;YACD,OAAO,GAAG,GAAG,CAAC;YACd,+EAA+E;YAC/E,IAAI,CAAC,cAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAA,gBAAK,GAAE,EAAE,CAAC;gBACtC,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,IAAA,+BAAoB,GAAE,EAAE,GAAG,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,wEAAwE;YACxE,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,IAAA,+BAAoB,GAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC;QAED,qDAAqD;QACrD,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;YACrD,IAAI,UAAU,CAAC,cAAc,KAAK,IAAI,IAAI,CAAC,IAAA,gBAAK,GAAE,EAAE,CAAC;gBACnD,OAAO,IAAI,MAAM,CAAC;YACpB,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,IAAI,SAAS,IAAI,cAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5C,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;aAAM,IAAI,SAAS,IAAI,CAAC,cAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACpD,IAAI,IAAA,gBAAK,GAAE,EAAE,CAAC;gBACZ,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,IAAA,qBAAU,GAAE,EAAE,SAAS,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,IAAA,+BAAoB,GAAE,EAAE,SAAS,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,IAAA,+BAAoB,GAAE,CAAC;QACnC,CAAC;QAED,qBAAU,CAAC,IAAI,CAAC,oBAAoB,OAAO,WAAW,OAAO,EAAE,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,IAAA,qBAAU,EAAC,OAAO,EAAE,OAAO,EAAE;YAC/C,KAAK,EAAE,cAAc;YACrB,QAAQ,EAAE,KAAK;YACf,GAAG,EAAE,OAAO;SACb,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;QAEhC,kFAAkF;QAClF,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAmB,EAAE,MAA6B,EAAE,EAAE;YAC5E,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAM,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;YACvD,qBAAU,CAAC,IAAI,CACb,4DAA4D,IAAI,YAAY,MAAM,SAAS,IAAI,CAAC,GAAG,SAAS,OAAO,WAAW,OAAO,EAAE,CACxI,CAAC;YACF,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,kCAAkC;QAClC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAM,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;YACxD,qBAAU,CAAC,KAAK,CACd,+DAA+D,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,CACtF,CAAC;YACF,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,GAAG,IAAI;QACjB,IAAA,mBAAK,EAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,GAAsB,EAAE,EAAE;YACnD,IAAI,GAAG,EAAE,CAAC;gBACR,qBAAU,CAAC,KAAK,CACd,8CAA8C,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,CACrE,CAAC;gBACF,oDAAoD;gBACpD,IAAA,mBAAK,EAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC7B,CAAC;YACD,iGAAiG;YACjG,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBACrC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,CAAC;YACH,CAAC,EAAE,OAAO,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,qBAAU,CAAC,IAAI,CAAC,kDAAkD,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,GAAG,GAAG,IAAA,4BAAgB,EAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QAC5D,IAAI,QAAQ,GAAG,IAAA,4BAAgB,EAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,UAAU,CAAuB,CAAC;QAC1F,IAAI,QAAQ,GAAG,SAAS,CAAC;QACzB,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;YAC3C,QAAQ,GAAG,UAAU,CAAC;QACxB,CAAC;QACD,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC;QAC7C,MAAM,GAAG,GAAG,QAAQ,GAAG,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;QAElD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,MAAM,GAAG,GAAG,IAAA,oBAAS,EAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAqB;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,MAAM,GAAG,GAAG,IAAA,2BAAe,GAAE,CAAC;QAC9B,OAAO,QAAQ,IAAI,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,OAAO,GAAG,IAAI;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,UAAU,CAAC,GAAG,EAAE;gBACd,sBAAW,CAAC,IAAI,EAAE,CAAC;YACrB,CAAC,EAAE,OAAO,CAAC,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAzND,oCAyNC"}

package/dist/cjs/electron/app/index.d.ts

@@ -1,7 +1,23 @@
+/**
+ * @module electron/app
+ * @description Electron application lifecycle management. Responsible for creating application instances,
+ * registering system events, managing single instance locks, and handling cleanup on window close and app exit.
+ *
+ * Lifecycle:
+ * 1. createElectron() — Check single instance lock → app.whenReady() → Create main window → Load page
+ * 2. window-all-closed — Quit app on non-macOS platforms
+ * 3. before-quit — Clean up cross-process services and child tasks
+ */
 import { app as electronApp } from 'electron';
 export { electronApp };
 /**
- * 创建electron应用
+ * Create and start Electron application
+ *
+ * Execution flow:
+ * 1. Check single instance lock (when singleLock=true is configured, prevents running multiple instances simultaneously)
+ * 2. Wait for app.whenReady() to complete
+ * 3. Create main window, emit Preload event, load service page, emit ElectronAppReady event
+ * 4. Register system event listeners: window-all-closed, before-quit
  */
 export declare function createElectron(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/electron/app/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/electron/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,UAAU,CAAC;AAQ9C,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CA6BrC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/electron/app/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,UAAU,CAAC;AAS9C,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAmCrC"}