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

package/dist/cjs/ps/index.js

@@ -1,4 +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 __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 };
 };
@@ -37,36 +70,45 @@ 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"));
-// 当前进程的所有env
+const is = __importStar(require("../utils/is.js"));
+/** Get all environment variables of the current process */
 function allEnv() {
     return process.env;
 }
-// 当前环境 - local | prod
+/** 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';
 }
-// 是否为node子进程
+/** 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()) {
@@ -80,116 +122,185 @@ function processType() {
     }
     return type;
 }
-// app name
+/** Get the application name */
 function appName() {
     return process.env.EE_APP_NAME || '';
 }
-// app version
+/** 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() {
-    const base = isDev() ? getBaseDir() : getUserHomeHiddenAppDir();
+    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() {
-    const base = isDev() ? getBaseDir() : getUserHomeHiddenAppDir();
+    let base = isDev() ? getBaseDir() : getUserHomeHiddenAppDir();
+    // 权限问题，openharmony 环境下，自定义应用目录
+    if (isProd() && is.openharmony()) {
+        base = getAppCustomDataDir();
+    }
     return path_1.default.join(base, 'logs');
 }
-// 获取bundle文件路径
+/**
+ * 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');
 }
-// 获取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');
 }
-// 获取frontend 源码文件路径
+/**
+ * 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');
 }
-// 获取base目录
+/** Get the project root directory (baseDir) */
 function getBaseDir() {
     return process.env.EE_BASE_DIR || '';
 }
-// 获取electron目录
+/** Get the electron directory (where business code resides) */
 function getElectronDir() {
     return process.env.EE_ELECTRON_DIR || '';
 }
-// 获取public目录
+/** 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) {
-        // 打包后  execDir为 应用程序 exe\dmg\dep软件所在目录；打包前该值是项目根目录
-        // windows和MacOs不一样
         dir = path_1.default.join(execDir, 'resources', 'extraResources');
-        if (process.platform === 'darwin') {
+        // 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;
 }
-// 获取root目录  (dev-项目根目录，pro-app user data目录)
+/**
+ * Get the root directory
+ *
+ * Development: Project root directory (baseDir)
+ * Production: App user data directory
+ */
 function getRootDir() {
     return isDev() ? getBaseDir() : getAppUserDataDir();
 }
-// 获取 appUserData目录
+/** Get the Electron appUserData directory */
 function getAppUserDataDir() {
     return process.env.EE_APP_USER_DATA || '';
 }
-// 获取 exec目录
+/** 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 || '';
 }
-// 获取用户家目录中的隐藏的app目录
+/**
+ * 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());
 }
-// 获取用户家目录中的app目录
+/** Get the app directory under the user home directory (not hidden): {userHome}/{appName}/ */
 function getUserHomeAppDir() {
     return path_1.default.join(getUserHomeDir(), appName());
 }
-// 获取内置socket端口
+/** Get the built-in Socket server port number */
 function getSocketPort() {
     return parseInt(process.env.EE_SOCKET_PORT || '0') || 0;
 }
-// 获取内置http端口
+/** 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);
 }
-// 格式化message
+/**
+ * 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);
 }
-// 退出ChildJob进程
+/**
+ * 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] || '{}');
@@ -201,7 +312,11 @@ function exitChildJob(code = 0) {
         process.exit(code);
     }
 }
-// 任务类型 ChildJob
+/**
+ * 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] || '{}');
@@ -211,7 +326,9 @@ function isChildJob() {
         return false;
     }
 }
-// 任务类型 ChildPoolJob
+/**
+ * Determine whether the current process is of ChildPoolJob type
+ */
 function isChildPoolJob() {
     try {
         const args = JSON.parse(process.argv[2] || '{}');
@@ -221,7 +338,15 @@ function isChildPoolJob() {
         return false;
     }
 }
-// Get cmd parameter by name
+/**
+ * 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) {
@@ -232,4 +357,13 @@ function getArgumentByName(name, args) {
     }
     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

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

package/dist/cjs/socket/httpServer.d.ts

@@ -1,20 +1,73 @@
 import Koa from 'koa';
 import type { HttpServerConfig } from '../types/index.js';
+/**
+ * HttpServer - HTTP server
+ *
+ * Created using factory pattern (static create()), because initialization requires async port acquisition.
+ * When enable=false in config, the service will not start after creation.
+ */
 export declare class HttpServer {
+    /** HTTP server configuration */
     config: HttpServerConfig;
+    /** Koa application instance */
     httpApp: Koa | undefined;
+    /** Channel separator */
     channelSeparator: string;
-    constructor();
+    private constructor();
+    /**
+     * Factory method: create and initialize HttpServer
+     *
+     * @returns Fully initialized HttpServer instance
+     */
+    static create(): Promise<HttpServer>;
+    /**
+     * Initialize HTTP server
+     *
+     * Acquires an available port then creates a Koa application and starts listening.
+     * The port number is written to process.env.EE_HTTP_PORT for other modules to access.
+     */
     init(): Promise<void>;
+    /**
+     * Create Koa application and start HTTP/HTTPS service
+     *
+     * Loads middleware in order, handles HTTPS configuration, and starts listening.
+     */
     _create(): Promise<void>;
+    /**
+     * Core routing dispatch middleware
+     *
+     * Maps HTTP request paths to controller methods:
+     * 1. Remove leading '/' from path
+     * 2. Check if path is in filter list (e.g., favicon.ico)
+     * 3. Ensure path starts with 'controller'
+     * 4. Find and call controller method via resolveControllerFn
+     * 5. GET requests pass query params, POST requests pass body params
+     *
+     * Error handling: When controller method throws an exception, returns 500 + { error: 'Internal Server Error' }
+     */
     _dispatch(ctx: Koa.Context, next: Koa.Next): Promise<void>;
+    /**
+     * Get Koa application instance
+     *
+     * @returns Koa instance, or undefined if HTTP service is not enabled
+     */
     getHttpApp(): Koa | undefined;
+    /**
+     * Set up Koa error handler
+     *
+     * @param app - Koa application instance
+     * @param errorHandler - Error handler function that receives an Error parameter
+     */
     _setupErrorHandler(app: Koa, errorHandler: ((err: Error) => void) | null): void;
     /**
-     * 加载前置、后置中间件
-     * @param {*} app koaApp示例
-     * @param {*} middlewares 中间件数组
-     * @param {*} type 类型，pre/post
+     * Load pre/post middleware
+     *
+     * Middleware can be factory functions (called to return Koa middleware) or direct middleware functions.
+     * Invalid middleware will be skipped with a warning.
+     *
+     * @param app - Koa application instance
+     * @param middlewares - Middleware array
+     * @param type - Type identifier (pre/post), used for warning messages
      */
     _loadMiddlewares(app: Koa, middlewares?: unknown[], type?: string): void;
 }

package/dist/cjs/socket/httpServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"httpServer.d.ts","sourceRoot":"","sources":["../../../src/socket/httpServer.ts"],"names":[],"mappings":"AAGA,OAAO,GAAG,MAAM,KAAK,CAAC;AAWtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,qBAAa,UAAU;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,GAAG,GAAG,SAAS,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;;IAUnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4DxB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDhE,UAAU,IAAI,GAAG,GAAG,SAAS;IAK7B,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAM/E;;;;;OAKG;IACH,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,GAAE,OAAO,EAAO,EAAE,IAAI,SAAQ,GAAG,IAAI;CAc5E"}
+{"version":3,"file":"httpServer.d.ts","sourceRoot":"","sources":["../../../src/socket/httpServer.ts"],"names":[],"mappings":"AAsBA,OAAO,GAAG,MAAM,KAAK,CAAC;AAWtB,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,mBAAmB,CAAC;AAKrE;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,gCAAgC;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,+BAA+B;IAC/B,OAAO,EAAE,GAAG,GAAG,SAAS,CAAC;IACzB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,OAAO;IAOP;;;;OAIG;WACU,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;IAM1C;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4D9B;;;;;;;;;;;OAWG;IACG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA+ChE;;;;OAIG;IACH,UAAU,IAAI,GAAG,GAAG,SAAS;IAI7B;;;;;OAKG;IACH,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAM/E;;;;;;;;;OASG;IACH,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,GAAE,OAAO,EAAO,EAAE,IAAI,SAAQ,GAAG,IAAI;CAY5E"}