ee-core 4.1.5 → 5.0.0-beta.5

package/dist/cjs/message/childMessage.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.childMessage = exports.ChildMessage = void 0;
+/**
+ * @module message/childMessage
+ * @description Child process message communication module. Provides the ability for child processes
+ * (created via child_process.fork) to send messages to the main process, serving as the core
+ * implementation of the framework's IPC communication mechanism on the child process side.
+ *
+ * Child processes cannot directly access Electron's ipcRenderer/ipcMain,
+ * so they communicate with the main process via Node.js built-in process.send() method.
+ * The main process receives and dispatches these messages by listening to the child process's message event.
+ *
+ * Message format follows the framework's unified IPC protocol:
+ * ```
+ * {
+ *   channel: string,      // Communication channel, e.g. 'ee#sendToMain'
+ *   eventReceiver: string, // Receiver type, e.g. 'job' / 'task'
+ *   event: string,        // Event name
+ *   data: object          // Event data
+ * }
+ * ```
+ *
+ * Usage examples:
+ * ```ts
+ * // Send a message to the ChildJob instance in the main process from a child process
+ * childMessage.sendToMain('taskComplete', { result: 42 });
+ *
+ * // Send a message to the Fork process instance in the main process from a child process
+ * childMessage.send('dataReady', { items: [...] });
+ *
+ * // Send error information to the terminal
+ * childMessage.sendErrorToTerminal(new Error('Something went wrong'));
+ * ```
+ */
+const channel_js_1 = require("../const/channel.js");
+/**
+ * ChildMessage - Child process message communication class
+ *
+ * Encapsulates methods for child processes to send messages to the main process,
+ * distinguishing different receiver types (ChildJob / ForkProcess),
+ * and provides error information forwarding capability.
+ *
+ * This class runs in the child process environment, relies on process.send() for communication,
+ * and returns false if the current process does not support process.send (non-forked process).
+ */
+class ChildMessage {
+    /**
+     * Send a message to the ChildJob instance in the main process
+     *
+     * Uses Receiver.childJob as the receiver type. After the main process receives the message,
+     * it routes the event to the corresponding ChildJob handler.
+     *
+     * @param eventName - Event name, the main process dispatches to the corresponding handler based on this
+     * @param params - Event parameters, defaults to an empty object
+     * @returns Returns true if sent successfully, false if the current process does not support process.send
+     */
+    sendToMain(eventName, params = {}) {
+        const receiver = channel_js_1.Receiver.childJob;
+        return this.send(eventName, params, receiver);
+    }
+    /**
+     * Send a message to the main process (generic method)
+     *
+     * Constructs a message object conforming to the framework's IPC protocol and sends it to the main process via process.send().
+     * If no receiver is specified, defaults to Receiver.forkProcess (generic task process).
+     *
+     * @param eventName - Event name
+     * @param params - Event parameters, defaults to an empty object
+     * @param receiver - Receiver type, defaults to Receiver.forkProcess
+     *   - 'job': ChildJob-type child process
+     *   - 'task': Fork process (generic task)
+     * @returns Returns true if sent successfully, false if the current process does not support process.send
+     */
+    send(eventName, params = {}, receiver) {
+        const eventReceiver = receiver || channel_js_1.Receiver.forkProcess;
+        const message = {
+            channel: channel_js_1.Processes.sendToMain,
+            eventReceiver,
+            event: eventName,
+            data: params,
+        };
+        return process.send ? process.send(message) : false;
+    }
+    /**
+     * Exit the current child process
+     *
+     * @param code - Exit code, defaults to 0 (normal exit)
+     * @throws Never returns (process.exit terminates the process)
+     */
+    exit(code = 0) {
+        return process.exit(code);
+    }
+    /**
+     * Send error information to the main process and display an exception dialog in the renderer process
+     *
+     * Sends via the Processes.showException channel. After the main process receives it,
+     * it forwards it to the renderer process via IPC, which displays a dialog with the error information.
+     * The error message includes a tip guiding the user to check the log file for details.
+     *
+     * @param err - Error object
+     * @returns Returns true if sent successfully, false if the current process does not support process.send
+     */
+    sendErrorToTerminal(err) {
+        let errTips = err && typeof err === 'object' ? err.toString() : '';
+        // Append a tip guiding the user to check the log file for the full error stack
+        errTips += ' Error !!! Please See file ee-core.log or ee-error-xxx.log for details !';
+        const message = {
+            channel: channel_js_1.Processes.showException,
+            data: errTips,
+        };
+        return process.send ? process.send(message) : false;
+    }
+}
+exports.ChildMessage = ChildMessage;
+/** Child process message communication singleton, for direct use by child process code */
+exports.childMessage = new ChildMessage();
+//# sourceMappingURL=childMessage.js.map

package/dist/cjs/message/childMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"childMessage.js","sourceRoot":"","sources":["../../../src/message/childMessage.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,oDAA0D;AAE1D;;;;;;;;;GASG;AACH,MAAa,YAAY;IACvB;;;;;;;;;OASG;IACH,UAAU,CAAC,SAAiB,EAAE,SAAkC,EAAE;QAChE,MAAM,QAAQ,GAAG,qBAAQ,CAAC,QAAQ,CAAC;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,SAAiB,EAAE,SAAkC,EAAE,EAAE,QAAiB;QAC7E,MAAM,aAAa,GAAG,QAAQ,IAAI,qBAAQ,CAAC,WAAW,CAAC;QACvD,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,sBAAS,CAAC,UAAU;YAC7B,aAAa;YACb,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,MAAM;SACb,CAAC;QAEF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAI,GAAG,CAAC;QACX,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;;;OASG;IACH,mBAAmB,CAAC,GAAU;QAC5B,IAAI,OAAO,GAAG,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,+EAA+E;QAC/E,OAAO,IAAI,0EAA0E,CAAC;QACtF,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,sBAAS,CAAC,aAAa;YAChC,IAAI,EAAE,OAAO;SACd,CAAC;QACF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,CAAC;CACF;AAvED,oCAuEC;AAED,0FAA0F;AAC7E,QAAA,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/cjs/message/index.d.ts

@@ -0,0 +1,2 @@
+export { ChildMessage, childMessage } from './childMessage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/message/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/message/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cjs/message/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.childMessage = exports.ChildMessage = void 0;
+var childMessage_js_1 = require("./childMessage.js");
+Object.defineProperty(exports, "ChildMessage", { enumerable: true, get: function () { return childMessage_js_1.ChildMessage; } });
+Object.defineProperty(exports, "childMessage", { enumerable: true, get: function () { return childMessage_js_1.childMessage; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/message/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/message/index.ts"],"names":[],"mappings":";;;AAAA,qDAA+D;AAAtD,+GAAA,YAAY,OAAA;AAAE,+GAAA,YAAY,OAAA"}

package/dist/cjs/ps/index.d.ts

@@ -0,0 +1,155 @@
+/** Get all environment variables of the current process */
+export declare function allEnv(): NodeJS.ProcessEnv;
+/** Get the current environment name (dev / local / prod) */
+export declare function env(): string;
+/** Whether this is a production environment */
+export declare function isProd(): boolean;
+/** Whether this is a development environment (dev or local) */
+export declare function isDev(): boolean;
+/** Whether this is a renderer process */
+export declare function isRenderer(): boolean;
+/** Whether this is the main process (browser) */
+export declare function isMain(): boolean;
+/** Whether this is a Node child process (created via child_process.fork, ELECTRON_RUN_AS_NODE=1) */
+export declare function isForkedChild(): boolean;
+/** Get the current process type (browser / renderer / child) */
+export declare function processType(): string;
+/** Get the application name */
+export declare function appName(): string;
+/** Get the application version */
+export declare function appVersion(): string;
+/**
+ * Get the data storage path
+ *
+ * Development: {baseDir}/data
+ * Production: {userHome}/.{appName}/data
+ */
+export declare function getDataDir(): string;
+/**
+ * Get the log storage path
+ *
+ * Development: {baseDir}/logs
+ * Production: {userHome}/.{appName}/logs
+ */
+export declare function getLogDir(): string;
+/**
+ * Get the build output directory
+ *
+ * @param basePath - Base path, defaults to cwd
+ * @returns {basePath}/public/electron
+ */
+export declare function getBundleDir(basePath?: string): string;
+/**
+ * Get the electron source directory
+ *
+ * @param basePath - Base path, defaults to cwd
+ * @returns {basePath}/electron
+ */
+export declare function getElectronCodeDir(basePath?: string): string;
+/**
+ * Get the frontend source directory
+ *
+ * @param basePath - Base path, defaults to cwd
+ * @returns {basePath}/frontend
+ */
+export declare function getFrontendCodeDir(basePath?: string): string;
+/** Get the project root directory (baseDir) */
+export declare function getBaseDir(): string;
+/** Get the electron directory (where business code resides) */
+export declare function getElectronDir(): string;
+/** Get the public static assets directory */
+export declare function getPublicDir(): string;
+/**
+ * Get the extra resources directory
+ *
+ * Path differs by platform after packaging:
+ * - Windows/Linux: {execDir}/resources/extraResources
+ * - macOS: {execDir}/../Resources/extraResources
+ *
+ * Before packaging: {execDir}/build/extraResources
+ */
+export declare function getExtraResourcesDir(): string;
+/**
+ * Get the root directory
+ *
+ * Development: Project root directory (baseDir)
+ * Production: App user data directory
+ */
+export declare function getRootDir(): string;
+/** Get the Electron appUserData directory */
+export declare function getAppUserDataDir(): string;
+/** Get the executable directory (execDir) */
+export declare function getExecDir(): string;
+/**
+ * Get the OS user home directory
+ * 权限原因：openharmony 下返回 appUserData 目录
+*/
+export declare function getUserHomeDir(): string;
+/**
+ * Get the hidden app directory under the user home directory
+ * Permission issue, custom data directory for application in OpenHarmony environment
+ *
+ * Path format: {userHome}/.{appName}/
+ * Used for storing data, logs, and other persistent files in production.
+ */
+export declare function getUserHomeHiddenAppDir(): string;
+/** Get the app directory under the user home directory (not hidden): {userHome}/{appName}/ */
+export declare function getUserHomeAppDir(): string;
+/** Get the built-in Socket server port number */
+export declare function getSocketPort(): number;
+/** Get the built-in HTTP server port number */
+export declare function getHttpPort(): number;
+/** Whether the app is packaged (production environment) */
+export declare function isPackaged(): boolean;
+/** Exit the current process */
+export declare function exit(code?: number): never;
+/**
+ * Format an IPC message
+ *
+ * @param msg - Partial message fields
+ * @returns Complete message object, with missing fields filled using default values
+ */
+export declare function makeMessage(msg?: Partial<{
+    channel: string;
+    event: string;
+    data: unknown;
+}>): {
+    channel: string;
+    event: string;
+    data: unknown;
+};
+/**
+ * Exit a ChildJob-type child process
+ *
+ * Checks the type field in argv[2] to determine if this is a ChildJob process.
+ * Only ChildJob processes will exit; other types of child processes are not affected.
+ */
+export declare function exitChildJob(code?: number): void;
+/**
+ * Determine whether the current process is of ChildJob type
+ *
+ * Checks the type field in the process startup arguments.
+ */
+export declare function isChildJob(): boolean;
+/**
+ * Determine whether the current process is of ChildPoolJob type
+ */
+export declare function isChildPoolJob(): boolean;
+/**
+ * Get the value of a named argument from command line arguments
+ *
+ * Search format: --name=value
+ *
+ * @param name - Argument name (without the -- prefix)
+ * @param args - Arguments array, defaults to process.argv
+ * @returns Argument value, or undefined if not found
+ */
+export declare function getArgumentByName(name: string, args?: string[]): string | undefined;
+/**
+ * Get the application custom data directory
+ *
+ * Used on OpenHarmony where the user home directory is not writable.
+ * Path format: {appUserData}/{appName}/
+ */
+export declare function getAppCustomDataDir(): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/ps/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ps/index.ts"],"names":[],"mappings":"AAUA,2DAA2D;AAC3D,wBAAgB,MAAM,IAAI,MAAM,CAAC,UAAU,CAE1C;AAED,4DAA4D;AAC5D,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,+CAA+C;AAC/C,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED,+DAA+D;AAC/D,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,yCAAyC;AACzC,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,iDAAiD;AACjD,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED,oGAAoG;AACpG,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,gEAAgE;AAChE,wBAAgB,WAAW,IAAI,MAAM,CAUpC;AAED,+BAA+B;AAC/B,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,kCAAkC;AAClC,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAOnC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAOlC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAkB7C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,6CAA6C;AAC7C,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;EAGE;AACF,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,iDAAiD;AACjD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,+BAA+B;AAC/B,wBAAgB,IAAI,CAAC,IAAI,SAAI,GAAG,KAAK,CAEpC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAM,GAAG;IACjG,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf,CAEA;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAI,GAAG,IAAI,CAS3C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAOpC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAOxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CASnF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/cjs/ps/index.js

@@ -0,0 +1,369 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allEnv = allEnv;
+exports.env = env;
+exports.isProd = isProd;
+exports.isDev = isDev;
+exports.isRenderer = isRenderer;
+exports.isMain = isMain;
+exports.isForkedChild = isForkedChild;
+exports.processType = processType;
+exports.appName = appName;
+exports.appVersion = appVersion;
+exports.getDataDir = getDataDir;
+exports.getLogDir = getLogDir;
+exports.getBundleDir = getBundleDir;
+exports.getElectronCodeDir = getElectronCodeDir;
+exports.getFrontendCodeDir = getFrontendCodeDir;
+exports.getBaseDir = getBaseDir;
+exports.getElectronDir = getElectronDir;
+exports.getPublicDir = getPublicDir;
+exports.getExtraResourcesDir = getExtraResourcesDir;
+exports.getRootDir = getRootDir;
+exports.getAppUserDataDir = getAppUserDataDir;
+exports.getExecDir = getExecDir;
+exports.getUserHomeDir = getUserHomeDir;
+exports.getUserHomeHiddenAppDir = getUserHomeHiddenAppDir;
+exports.getUserHomeAppDir = getUserHomeAppDir;
+exports.getSocketPort = getSocketPort;
+exports.getHttpPort = getHttpPort;
+exports.isPackaged = isPackaged;
+exports.exit = exit;
+exports.makeMessage = makeMessage;
+exports.exitChildJob = exitChildJob;
+exports.isChildJob = isChildJob;
+exports.isChildPoolJob = isChildPoolJob;
+exports.getArgumentByName = getArgumentByName;
+exports.getAppCustomDataDir = getAppCustomDataDir;
+/**
+ * @module ps
+ * @description Process state and path utility module. Provides environment detection, process type checking,
+ * and path retrieval functions, serving as the foundational dependency for other modules to obtain runtime environment information.
+ *
+ * All path information comes from process.env environment variables set in boot.ts.
+ */
+const path_1 = __importDefault(require("path"));
+const is = __importStar(require("../utils/is.js"));
+/** Get all environment variables of the current process */
+function allEnv() {
+    return process.env;
+}
+/** Get the current environment name (dev / local / prod) */
+function env() {
+    return process.env.EE_ENV || '';
+}
+/** Whether this is a production environment */
+function isProd() {
+    return process.env.EE_ENV === 'prod';
+}
+/** Whether this is a development environment (dev or local) */
+function isDev() {
+    return process.env.EE_ENV === 'dev' || process.env.EE_ENV === 'local';
+}
+/** Whether this is a renderer process */
+function isRenderer() {
+    return typeof process === 'undefined' || !process || process.type === 'renderer';
+}
+/** Whether this is the main process (browser) */
+function isMain() {
+    return typeof process !== 'undefined' && process.type === 'browser';
+}
+/** Whether this is a Node child process (created via child_process.fork, ELECTRON_RUN_AS_NODE=1) */
+function isForkedChild() {
+    return Number(process.env.ELECTRON_RUN_AS_NODE) === 1;
+}
+/** Get the current process type (browser / renderer / child) */
+function processType() {
+    let type = '';
+    if (isMain()) {
+        type = 'browser';
+    }
+    else if (isRenderer()) {
+        type = 'renderer';
+    }
+    else if (isForkedChild()) {
+        type = 'child';
+    }
+    return type;
+}
+/** Get the application name */
+function appName() {
+    return process.env.EE_APP_NAME || '';
+}
+/** Get the application version */
+function appVersion() {
+    return process.env.EE_APP_VERSION || '';
+}
+/**
+ * Get the data storage path
+ *
+ * Development: {baseDir}/data
+ * Production: {userHome}/.{appName}/data
+ */
+function getDataDir() {
+    let base = isDev() ? getBaseDir() : getUserHomeHiddenAppDir();
+    // 权限问题，openharmony 环境下，自定义应用目录
+    if (isProd() && is.openharmony()) {
+        base = getAppCustomDataDir();
+    }
+    return path_1.default.join(base, 'data');
+}
+/**
+ * Get the log storage path
+ *
+ * Development: {baseDir}/logs
+ * Production: {userHome}/.{appName}/logs
+ */
+function getLogDir() {
+    let base = isDev() ? getBaseDir() : getUserHomeHiddenAppDir();
+    // 权限问题，openharmony 环境下，自定义应用目录
+    if (isProd() && is.openharmony()) {
+        base = getAppCustomDataDir();
+    }
+    return path_1.default.join(base, 'logs');
+}
+/**
+ * Get the build output directory
+ *
+ * @param basePath - Base path, defaults to cwd
+ * @returns {basePath}/public/electron
+ */
+function getBundleDir(basePath) {
+    const base = basePath || process.cwd();
+    return path_1.default.join(base, 'public', 'electron');
+}
+/**
+ * Get the electron source directory
+ *
+ * @param basePath - Base path, defaults to cwd
+ * @returns {basePath}/electron
+ */
+function getElectronCodeDir(basePath) {
+    const base = basePath || process.cwd();
+    return path_1.default.join(base, 'electron');
+}
+/**
+ * Get the frontend source directory
+ *
+ * @param basePath - Base path, defaults to cwd
+ * @returns {basePath}/frontend
+ */
+function getFrontendCodeDir(basePath) {
+    const base = basePath || process.cwd();
+    return path_1.default.join(base, 'frontend');
+}
+/** Get the project root directory (baseDir) */
+function getBaseDir() {
+    return process.env.EE_BASE_DIR || '';
+}
+/** Get the electron directory (where business code resides) */
+function getElectronDir() {
+    return process.env.EE_ELECTRON_DIR || '';
+}
+/** Get the public static assets directory */
+function getPublicDir() {
+    return path_1.default.join(getBaseDir(), 'public');
+}
+/**
+ * Get the extra resources directory
+ *
+ * Path differs by platform after packaging:
+ * - Windows/Linux: {execDir}/resources/extraResources
+ * - macOS: {execDir}/../Resources/extraResources
+ *
+ * Before packaging: {execDir}/build/extraResources
+ */
+function getExtraResourcesDir() {
+    const execDir = getExecDir();
+    const packaged = isPackaged();
+    let dir = '';
+    if (packaged) {
+        dir = path_1.default.join(execDir, 'resources', 'extraResources');
+        // macOS app bundle structure: exe is in Contents/MacOS/, resources are in Contents/Resources/
+        if (is.macOS()) {
+            dir = path_1.default.join(execDir, '..', 'Resources', 'extraResources');
+        }
+        else if (is.openharmony()) {
+            // todo: 处理 openharmony 下的资源目录
+            dir = path_1.default.join(execDir, "..", "Resources", "extraResources");
+        }
+    }
+    else {
+        dir = path_1.default.join(execDir, 'build', 'extraResources');
+    }
+    return dir;
+}
+/**
+ * Get the root directory
+ *
+ * Development: Project root directory (baseDir)
+ * Production: App user data directory
+ */
+function getRootDir() {
+    return isDev() ? getBaseDir() : getAppUserDataDir();
+}
+/** Get the Electron appUserData directory */
+function getAppUserDataDir() {
+    return process.env.EE_APP_USER_DATA || '';
+}
+/** Get the executable directory (execDir) */
+function getExecDir() {
+    return process.env.EE_EXEC_DIR || '';
+}
+/**
+ * Get the OS user home directory
+ * 权限原因：openharmony 下返回 appUserData 目录
+*/
+function getUserHomeDir() {
+    if (is.openharmony()) {
+        return getAppUserDataDir();
+    }
+    return process.env.EE_USER_HOME || '';
+}
+/**
+ * Get the hidden app directory under the user home directory
+ * Permission issue, custom data directory for application in OpenHarmony environment
+ *
+ * Path format: {userHome}/.{appName}/
+ * Used for storing data, logs, and other persistent files in production.
+ */
+function getUserHomeHiddenAppDir() {
+    return path_1.default.join(getUserHomeDir(), '.' + appName());
+}
+/** Get the app directory under the user home directory (not hidden): {userHome}/{appName}/ */
+function getUserHomeAppDir() {
+    return path_1.default.join(getUserHomeDir(), appName());
+}
+/** Get the built-in Socket server port number */
+function getSocketPort() {
+    return parseInt(process.env.EE_SOCKET_PORT || '0') || 0;
+}
+/** Get the built-in HTTP server port number */
+function getHttpPort() {
+    return parseInt(process.env.EE_HTTP_PORT || '0') || 0;
+}
+/** Whether the app is packaged (production environment) */
+function isPackaged() {
+    return process.env.EE_IS_PACKAGED === 'true';
+}
+/** Exit the current process */
+function exit(code = 0) {
+    return process.exit(code);
+}
+/**
+ * Format an IPC message
+ *
+ * @param msg - Partial message fields
+ * @returns Complete message object, with missing fields filled using default values
+ */
+function makeMessage(msg = {}) {
+    return Object.assign({ channel: '', event: '', data: {} }, msg);
+}
+/**
+ * Exit a ChildJob-type child process
+ *
+ * Checks the type field in argv[2] to determine if this is a ChildJob process.
+ * Only ChildJob processes will exit; other types of child processes are not affected.
+ */
+function exitChildJob(code = 0) {
+    try {
+        const args = JSON.parse(process.argv[2] || '{}');
+        if (args.type === 'childJob') {
+            process.exit(code);
+        }
+    }
+    catch {
+        process.exit(code);
+    }
+}
+/**
+ * Determine whether the current process is of ChildJob type
+ *
+ * Checks the type field in the process startup arguments.
+ */
+function isChildJob() {
+    try {
+        const args = JSON.parse(process.argv[2] || '{}');
+        return args.type === 'childJob';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Determine whether the current process is of ChildPoolJob type
+ */
+function isChildPoolJob() {
+    try {
+        const args = JSON.parse(process.argv[2] || '{}');
+        return args.type === 'childPoolJob';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the value of a named argument from command line arguments
+ *
+ * Search format: --name=value
+ *
+ * @param name - Argument name (without the -- prefix)
+ * @param args - Arguments array, defaults to process.argv
+ * @returns Argument value, or undefined if not found
+ */
+function getArgumentByName(name, args) {
+    const searchArgs = args || process.argv;
+    for (const item of searchArgs) {
+        const prefixKey = `--${name}=`;
+        if (item.indexOf(prefixKey) !== -1) {
+            return item.substring(prefixKey.length);
+        }
+    }
+    return undefined;
+}
+/**
+ * Get the application custom data directory
+ *
+ * Used on OpenHarmony where the user home directory is not writable.
+ * Path format: {appUserData}/{appName}/
+ */
+function getAppCustomDataDir() {
+    return path_1.default.join(getAppUserDataDir(), appName());
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/ps/index.js.map

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