ee-core 4.1.5 → 5.0.0-beta.5

package/dist/cjs/utils/wrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.js","sourceRoot":"","sources":["../../../src/utils/wrap.ts"],"names":[],"mappings":";;AA2BA,sCAWC;AAeD,0CAgCC;AArFD;;;;;;;;;;;GAWG;AACH,mDAA6C;AAE7C;;;;;;;;;;;;GAYG;AACH,SAAgB,aAAa,CAAC,QAAgB,EAAE,EAAE,SAAS,EAA4D;IACrH,0FAA0F;IAC1F,IAAI,IAAA,0BAAU,EAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAI,SAA4C,CAAC,QAAQ,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,0CAA0C;IAC1C,OAAO,eAAe,CAAC,QAAQ,EAAE,SAAmB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,eAAe,CAAC,QAAgB,EAAE,SAAiB;IACjE,4CAA4C;IAC5C,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/E,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QACjC,uDAAuD;QACvD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,+BAA+B,QAAQ,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,uEAAuE;QACvE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACxF,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK;YAAE,OAAO,UAAU,CAAC;QAE9B,yCAAyC;QACzC,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,OAAO;gBACV,wEAAwE;gBACxE,SAAS,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;gBAChC,MAAM;YACR,KAAK,OAAO;gBACV,2CAA2C;gBAC3C,SAAS,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;gBAChC,MAAM;YACR,KAAK,OAAO,CAAC;YACb;gBACE,yBAAyB;gBACzB,MAAM;QACV,CAAC;QACD,OAAO,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/app/application.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Application class — Framework startup flow orchestrator
+ *
+ * Responsibilities:
+ * - register(): Register lifecycle event hooks
+ * - run(): Synchronous startup flow (CJS controller loading)
+ * - runAsync(): Asynchronous startup flow (ESM controller loading)
+ *
+ * Startup order:
+ * 1. Load Controllers — Register all business handler functions
+ * 2. Load Communication Services (Socket) — Start IPC/HTTP/SocketIO services
+ * 3. Emit Ready lifecycle event
+ * 4. Load Electron features — Create windows, register shortcuts, etc.
+ */
+export declare class Application {
+    /**
+     * Register a lifecycle event handler
+     * @param eventName - Event name (e.g. 'ready', 'before-close')
+     * @param handler - Event handler function
+     */
+    register(eventName: string, handler: (...args: unknown[]) => void): void;
+    /**
+     * Start the application synchronously
+     *
+     * Flow:
+     * 1. loadController() — Synchronously load controllers (using require())
+     * 2. loadSocket() — Start IPC/HTTP/SocketIO communication services
+     * 3. emitLifecycle(Ready) — Trigger ready lifecycle event
+     * 4. loadElectron() — Initialize Electron main process (create windows, etc.)
+     */
+    run(): Promise<void>;
+    /**
+     * Start the application asynchronously
+     *
+     * Same flow as run(), but controllers are loaded asynchronously using dynamic import(), supporting ESM modules.
+     */
+    runAsync(): Promise<void>;
+}
+/** Application singleton */
+export declare const app: Application;
+//# sourceMappingURL=application.d.ts.map

package/dist/esm/app/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../../src/app/application.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;IACtB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAIxE;;;;;;;;OAQG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAO1B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAMhC;AAED,4BAA4B;AAC5B,eAAO,MAAM,GAAG,aAAoB,CAAC"}

package/dist/esm/app/application.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.app = exports.Application = void 0;
+/**
+ * @module app/application
+ * @description Application core class that orchestrates the framework startup flow.
+ * Responsible for sequentially loading controllers, communication services,
+ * emitting lifecycle events, and finally loading Electron main process features.
+ * Held and invoked by the ElectronEgg class in boot.ts.
+ */
+const index_js_1 = require("../controller/index.js");
+const events_js_1 = require("./events.js");
+const index_js_2 = require("../socket/index.js");
+const index_js_3 = require("../electron/index.js");
+/**
+ * Application class — Framework startup flow orchestrator
+ *
+ * Responsibilities:
+ * - register(): Register lifecycle event hooks
+ * - run(): Synchronous startup flow (CJS controller loading)
+ * - runAsync(): Asynchronous startup flow (ESM controller loading)
+ *
+ * Startup order:
+ * 1. Load Controllers — Register all business handler functions
+ * 2. Load Communication Services (Socket) — Start IPC/HTTP/SocketIO services
+ * 3. Emit Ready lifecycle event
+ * 4. Load Electron features — Create windows, register shortcuts, etc.
+ */
+class Application {
+    /**
+     * Register a lifecycle event handler
+     * @param eventName - Event name (e.g. 'ready', 'before-close')
+     * @param handler - Event handler function
+     */
+    register(eventName, handler) {
+        events_js_1.eventBus.register(eventName, handler);
+    }
+    /**
+     * Start the application synchronously
+     *
+     * Flow:
+     * 1. loadController() — Synchronously load controllers (using require())
+     * 2. loadSocket() — Start IPC/HTTP/SocketIO communication services
+     * 3. emitLifecycle(Ready) — Trigger ready lifecycle event
+     * 4. loadElectron() — Initialize Electron main process (create windows, etc.)
+     */
+    async run() {
+        (0, index_js_1.loadController)();
+        await (0, index_js_2.loadSocket)();
+        events_js_1.eventBus.emitLifecycle(events_js_1.Ready);
+        (0, index_js_3.loadElectron)();
+    }
+    /**
+     * Start the application asynchronously
+     *
+     * Same flow as run(), but controllers are loaded asynchronously using dynamic import(), supporting ESM modules.
+     */
+    async runAsync() {
+        await (0, index_js_1.loadControllerAsync)();
+        await (0, index_js_2.loadSocket)();
+        events_js_1.eventBus.emitLifecycle(events_js_1.Ready);
+        (0, index_js_3.loadElectron)();
+    }
+}
+exports.Application = Application;
+/** Application singleton */
+exports.app = new Application();
+//# sourceMappingURL=application.js.map

package/dist/esm/app/application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../../../src/app/application.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,qDAA6E;AAC7E,2CAA8C;AAC9C,iDAAgD;AAChD,mDAAoD;AAEpD;;;;;;;;;;;;;GAaG;AACH,MAAa,WAAW;IACtB;;;;OAIG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAqC;QAC/D,oBAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG;QACP,IAAA,yBAAc,GAAE,CAAC;QACjB,MAAM,IAAA,qBAAU,GAAE,CAAC;QACnB,oBAAQ,CAAC,aAAa,CAAC,iBAAK,CAAC,CAAC;QAC9B,IAAA,uBAAY,GAAE,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAA,8BAAmB,GAAE,CAAC;QAC5B,MAAM,IAAA,qBAAU,GAAE,CAAC;QACnB,oBAAQ,CAAC,aAAa,CAAC,iBAAK,CAAC,CAAC;QAC9B,IAAA,uBAAY,GAAE,CAAC;IACjB,CAAC;CACF;AArCD,kCAqCC;AAED,4BAA4B;AACf,QAAA,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/esm/app/boot.d.ts

@@ -0,0 +1,64 @@
+import type { ElectronEggOptions } from '../types/index.js';
+/**
+ * ElectronEgg framework main class
+ *
+ * Responsibilities:
+ * 1. Collect Electron runtime environment info (app name, version, paths, etc.)
+ * 2. Set global environment variables (EE_ENV, EE_BASE_DIR, etc.)
+ * 3. Initialize framework foundational features (exception handling -> config -> directories -> logging)
+ * 4. Provide register() for lifecycle hooks, run()/runAsync() to start the application
+ *
+ * Usage:
+ * ```ts
+ * const electronEgg = new ElectronEgg();
+ * electronEgg.register('ready', () => { ... });
+ * await electronEgg.run();
+ * ```
+ */
+export declare class ElectronEgg {
+    options: ElectronEggOptions;
+    /**
+     * Constructor — Collects environment info and initializes the framework
+     *
+     * Execution flow:
+     * 1. Get Electron app path as baseDir
+     * 2. Parse command-line arguments: env (environment) and debugger (debug source flag)
+     * 3. Based on debugger flag, decide whether electronDir points to bundle output or source directory
+     * 4. Collect application info (name, version, paths, etc.) to build options
+     * 5. In production + packaged mode, execDir points to the executable's directory
+     * 6. Write key info to process.env for other modules to read
+     * 7. Call init() to load foundational features
+     */
+    constructor();
+    /**
+     * Initialize framework foundational features
+     *
+     * Loading order (must not be changed):
+     * 1. loadException — Register global exception handling to ensure subsequent exceptions are caught
+     * 2. loadConfig — Load configuration files; subsequent modules depend on configuration
+     * 3. loadDir — Create necessary directories for data/logs
+     * 4. loadLog — Initialize logging system; depends on configuration and directories
+     */
+    init(): void;
+    /**
+     * Register a lifecycle event handler
+     * @param eventName - Lifecycle event name (e.g. 'ready', 'electron-app-ready')
+     * @param handler - Event handler function
+     */
+    register(eventName: string, handler: (...args: unknown[]) => void): void;
+    /**
+     * Start the application synchronously
+     *
+     * Execution flow: loadController -> loadSocket -> emitLifecycle(ready) -> loadElectron
+     * Controllers are loaded using synchronous require(), suitable for CJS projects
+     */
+    run(): Promise<void>;
+    /**
+     * Start the application asynchronously
+     *
+     * Execution flow: loadControllerAsync -> loadSocket -> emitLifecycle(ready) -> loadElectron
+     * Controllers are loaded using dynamic import(), suitable for ESM projects
+     */
+    runAsync(): Promise<void>;
+}
+//# sourceMappingURL=boot.d.ts.map

package/dist/esm/app/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../../src/app/boot.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAI5D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAW;IACtB,OAAO,EAAE,kBAAkB,CAAC;IAE5B;;;;;;;;;;;OAWG;;IAiDH;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI;IAOZ;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAIxE;;;;;OAKG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/esm/app/boot.js

@@ -0,0 +1,138 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElectronEgg = void 0;
+/**
+ * @module app/boot
+ * @description ElectronEgg framework boot module. Responsible for initializing the runtime environment,
+ * collecting application configuration, setting global environment variables, and sequentially
+ * loading framework foundational features (exception handling, configuration, directories, logging).
+ * This is the entry class of the entire framework, instantiated and started via run() from electron/main.js.
+ */
+const debug_1 = __importDefault(require("debug"));
+const path_1 = __importDefault(require("path"));
+const index_js_1 = require("../exception/index.js");
+const index_js_2 = require("../electron/app/index.js");
+const index_js_3 = require("../ps/index.js");
+const index_js_4 = require("../config/index.js");
+const index_js_5 = require("../log/index.js");
+const application_js_1 = require("./application.js");
+const dir_js_1 = require("./dir.js");
+const debugLog = (0, debug_1.default)('ee-core:app:boot');
+/**
+ * ElectronEgg framework main class
+ *
+ * Responsibilities:
+ * 1. Collect Electron runtime environment info (app name, version, paths, etc.)
+ * 2. Set global environment variables (EE_ENV, EE_BASE_DIR, etc.)
+ * 3. Initialize framework foundational features (exception handling -> config -> directories -> logging)
+ * 4. Provide register() for lifecycle hooks, run()/runAsync() to start the application
+ *
+ * Usage:
+ * ```ts
+ * const electronEgg = new ElectronEgg();
+ * electronEgg.register('ready', () => { ... });
+ * await electronEgg.run();
+ * ```
+ */
+class ElectronEgg {
+    /**
+     * Constructor — Collects environment info and initializes the framework
+     *
+     * Execution flow:
+     * 1. Get Electron app path as baseDir
+     * 2. Parse command-line arguments: env (environment) and debugger (debug source flag)
+     * 3. Based on debugger flag, decide whether electronDir points to bundle output or source directory
+     * 4. Collect application info (name, version, paths, etc.) to build options
+     * 5. In production + packaged mode, execDir points to the executable's directory
+     * 6. Write key info to process.env for other modules to read
+     * 7. Call init() to load foundational features
+     */
+    constructor() {
+        const baseDir = index_js_2.electronApp.getAppPath();
+        const environment = (0, index_js_3.getArgumentByName)('env') || 'prod';
+        const debugging = (0, index_js_3.getArgumentByName)('debugger') === 'true';
+        // In debug mode, point to source directory; otherwise point to bundle output directory
+        let electronDir = (0, index_js_3.getBundleDir)(baseDir);
+        if (debugging) {
+            electronDir = (0, index_js_3.getElectronCodeDir)(baseDir);
+        }
+        const options = {
+            env: environment,
+            baseDir,
+            electronDir,
+            appName: index_js_2.electronApp.getName(),
+            userHome: index_js_2.electronApp.getPath('home'),
+            appData: index_js_2.electronApp.getPath('appData'),
+            appUserData: index_js_2.electronApp.getPath('userData'),
+            appVersion: index_js_2.electronApp.getVersion(),
+            isPackaged: index_js_2.electronApp.isPackaged,
+            execDir: baseDir,
+        };
+        // In production and packaged mode, execDir is the directory of the executable (same level as exe/dmg)
+        if (environment === 'prod' && options.isPackaged) {
+            options.execDir = path_1.default.dirname(index_js_2.electronApp.getPath('exe'));
+        }
+        // Write runtime environment info to global variables for use by config loading, logging, and other modules
+        process.env.EE_ENV = environment;
+        process.env.EE_APP_NAME = options.appName;
+        process.env.EE_APP_VERSION = options.appVersion;
+        process.env.EE_BASE_DIR = options.baseDir;
+        process.env.EE_ELECTRON_DIR = options.electronDir;
+        process.env.EE_USER_HOME = options.userHome;
+        process.env.EE_APP_DATA = options.appData;
+        process.env.EE_APP_USER_DATA = options.appUserData;
+        process.env.EE_EXEC_DIR = options.execDir;
+        process.env.EE_IS_PACKAGED = String(options.isPackaged);
+        process.env.EE_SOCKET_PORT = '';
+        process.env.EE_HTTP_PORT = '';
+        debugLog('[constructor] options:%j', options);
+        this.options = options;
+        this.init();
+    }
+    /**
+     * Initialize framework foundational features
+     *
+     * Loading order (must not be changed):
+     * 1. loadException — Register global exception handling to ensure subsequent exceptions are caught
+     * 2. loadConfig — Load configuration files; subsequent modules depend on configuration
+     * 3. loadDir — Create necessary directories for data/logs
+     * 4. loadLog — Initialize logging system; depends on configuration and directories
+     */
+    init() {
+        (0, index_js_1.loadException)();
+        (0, index_js_4.loadConfig)();
+        (0, dir_js_1.loadDir)();
+        (0, index_js_5.loadLog)();
+    }
+    /**
+     * Register a lifecycle event handler
+     * @param eventName - Lifecycle event name (e.g. 'ready', 'electron-app-ready')
+     * @param handler - Event handler function
+     */
+    register(eventName, handler) {
+        application_js_1.app.register(eventName, handler);
+    }
+    /**
+     * Start the application synchronously
+     *
+     * Execution flow: loadController -> loadSocket -> emitLifecycle(ready) -> loadElectron
+     * Controllers are loaded using synchronous require(), suitable for CJS projects
+     */
+    async run() {
+        await application_js_1.app.run();
+    }
+    /**
+     * Start the application asynchronously
+     *
+     * Execution flow: loadControllerAsync -> loadSocket -> emitLifecycle(ready) -> loadElectron
+     * Controllers are loaded using dynamic import(), suitable for ESM projects
+     */
+    async runAsync() {
+        await application_js_1.app.runAsync();
+    }
+}
+exports.ElectronEgg = ElectronEgg;
+//# sourceMappingURL=boot.js.map

package/dist/esm/app/boot.js.map

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

package/dist/esm/app/dir.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Load and initialize directories required for application runtime
+ *
+ * Creates the following directories (if they don't exist):
+ * - Hidden app directory under user home (~/.{appName}/) — Stores app-level configuration and cache
+ * - Data directory — Stores business data (e.g. SQLite database files)
+ * - Log directory — Stores runtime log files
+ *
+ * Directory permissions set to 0o755 (owner: read/write/execute; others: read/execute)
+ */
+export declare function loadDir(): void;
+//# sourceMappingURL=dir.d.ts.map

package/dist/esm/app/dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir.d.ts","sourceRoot":"","sources":["../../../src/app/dir.ts"],"names":[],"mappings":"AAWA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAE9B"}

package/dist/esm/app/dir.js

@@ -0,0 +1,88 @@
+"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.loadDir = loadDir;
+/**
+ * @module app/dir
+ * @description Application directory initialization module. Creates necessary runtime directories
+ * at framework startup, including the hidden app directory under the user's home directory
+ * (for storing configuration, etc.), data directory, and log directory.
+ */
+const fs_1 = __importDefault(require("fs"));
+const index_js_1 = require("../ps/index.js");
+const helper_js_1 = require("../utils/helper.js");
+const is = __importStar(require("../utils/is.js"));
+/**
+ * Load and initialize directories required for application runtime
+ *
+ * Creates the following directories (if they don't exist):
+ * - Hidden app directory under user home (~/.{appName}/) — Stores app-level configuration and cache
+ * - Data directory — Stores business data (e.g. SQLite database files)
+ * - Log directory — Stores runtime log files
+ *
+ * Directory permissions set to 0o755 (owner: read/write/execute; others: read/execute)
+ */
+function loadDir() {
+    initDir();
+}
+function initDir() {
+    // 在记录日志前，单独捕获异常
+    try {
+        // 初始化应用自定义数据目录
+        let customAppDir = (0, index_js_1.getUserHomeHiddenAppDir)();
+        // 权限问题，openharmony 环境下，自定义应用目录
+        if (is.openharmony()) {
+            customAppDir = (0, index_js_1.getAppCustomDataDir)();
+        }
+        if (!fs_1.default.existsSync(customAppDir)) {
+            (0, helper_js_1.mkdir)(customAppDir, { mode: 0o755 });
+        }
+        const dataDir = (0, index_js_1.getDataDir)();
+        if (!fs_1.default.existsSync(dataDir)) {
+            (0, helper_js_1.mkdir)(dataDir, { mode: 0o755 });
+        }
+        const logDir = (0, index_js_1.getLogDir)();
+        if (!fs_1.default.existsSync(logDir)) {
+            (0, helper_js_1.mkdir)(logDir, { mode: 0o755 });
+        }
+    }
+    catch (e) {
+        console.error('[dir] initDir error: %s', e instanceof Error ? e.message : String(e));
+    }
+}
+//# sourceMappingURL=dir.js.map

package/dist/esm/app/dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir.js","sourceRoot":"","sources":["../../../src/app/dir.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,0BAEC;AAvBD;;;;;GAKG;AACH,4CAAoB;AACpB,6CAAqG;AACrG,kDAA2C;AAC3C,mDAAqC;AAErC;;;;;;;;;GASG;AACH,SAAgB,OAAO;IACrB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,OAAO;IACd,gBAAgB;IAChB,IAAI,CAAC;QACH,eAAe;QACf,IAAI,YAAY,GAAG,IAAA,kCAAuB,GAAE,CAAC;QAC7C,+BAA+B;QAC/B,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACrB,YAAY,GAAG,IAAA,8BAAmB,GAAE,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,IAAA,iBAAK,EAAC,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,OAAO,GAAG,IAAA,qBAAU,GAAE,CAAC;QAC7B,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,IAAA,iBAAK,EAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,MAAM,GAAG,IAAA,oBAAS,GAAE,CAAC;QAC3B,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,IAAA,iBAAK,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC;AACH,CAAC"}

package/dist/esm/app/events.d.ts

@@ -0,0 +1,71 @@
+/** Lifecycle: Framework foundational features loaded (controllers, communication services ready) */
+export declare const Ready = "ready";
+/** Lifecycle: Electron app.whenReady() completed */
+export declare const ElectronAppReady = "electron-app-ready";
+/** Lifecycle: Main window created */
+export declare const WindowReady = "window-ready";
+/** Lifecycle: Before window closes, can be used for cleanup operations */
+export declare const BeforeClose = "before-close";
+/** Lifecycle: Preload script injection timing */
+export declare const Preload = "preload";
+type EventHandler = (...args: unknown[]) => unknown;
+/**
+ * EventBus — Event bus
+ *
+ * Design highlights:
+ * - Lifecycle events and custom events are stored separately to avoid naming conflicts
+ * - register() registers lifecycle events, on() registers custom events
+ * - Re-registering the same event name overwrites the previous handler and outputs a warning (rather than silently ignoring)
+ * - emit methods have built-in try/catch, ensuring a single handler exception does not affect other logic
+ * - Promises returned by async handlers have errors automatically caught
+ */
+export declare class EventBus {
+    /** Lifecycle event handler mapping */
+    private lifecycleEvents;
+    /** Custom event handler mapping */
+    private eventsMap;
+    /**
+     * Register a lifecycle event handler
+     *
+     * Lifecycle events are triggered internally by the framework; business code registers hooks via this method.
+     * If the event name is already registered, the old handler is overwritten and a warning is logged.
+     *
+     * @param eventName - Lifecycle event name (Ready / ElectronAppReady / WindowReady / BeforeClose / Preload)
+     * @param handler - Event handler function, supports sync or async
+     */
+    register(eventName: string, handler: EventHandler): void;
+    /**
+     * Emit a lifecycle event
+     *
+     * Invokes the corresponding event handler. Errors are NOT silently swallowed —
+     * sync errors propagate to the caller, async errors are re-thrown as unhandled rejections
+     * (caught by the global exception handler).
+     *
+     * @param eventName - Lifecycle event name
+     * @param args - Arguments passed to the handler
+     */
+    emitLifecycle(eventName: string, ...args: unknown[]): void;
+    /**
+     * Register a custom event handler
+     *
+     * Business code can register custom events via this method, triggered by business code itself.
+     * If the event name is already registered, the old handler is overwritten and a warning is logged.
+     *
+     * @param eventName - Custom event name
+     * @param handler - Event handler function, supports sync or async
+     */
+    on(eventName: string, handler: EventHandler): void;
+    /**
+     * Emit a custom event
+     *
+     * Invokes the corresponding event handler, automatically catching synchronous exceptions and async rejections.
+     *
+     * @param eventName - Custom event name
+     * @param args - Arguments passed to the handler
+     */
+    emit(eventName: string, ...args: unknown[]): void;
+}
+/** Event bus singleton, globally shared */
+export declare const eventBus: EventBus;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/esm/app/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/app/events.ts"],"names":[],"mappings":"AAaA,oGAAoG;AACpG,eAAO,MAAM,KAAK,UAAU,CAAC;AAC7B,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AACrD,qCAAqC;AACrC,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAC1C,0EAA0E;AAC1E,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAC1C,iDAAiD;AACjD,eAAO,MAAM,OAAO,YAAY,CAAC;AAEjC,KAAK,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAEpD;;;;;;;;;GASG;AACH,qBAAa,QAAQ;IACnB,sCAAsC;IACtC,OAAO,CAAC,eAAe,CAAoC;IAC3D,mCAAmC;IACnC,OAAO,CAAC,SAAS,CAAoC;IAErD;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAOxD;;;;;;;;;OASG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAc1D;;;;;;;;OAQG;IACH,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAOlD;;;;;;;OAOG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAelD;AAED,2CAA2C;AAC3C,eAAO,MAAM,QAAQ,UAAiB,CAAC"}

package/dist/esm/app/events.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventBus = exports.EventBus = exports.Preload = exports.BeforeClose = exports.WindowReady = exports.ElectronAppReady = exports.Ready = void 0;
+/**
+ * @module app/events
+ * @description Event bus module, providing lifecycle events and custom event mechanisms within the framework.
+ *
+ * Two event types:
+ * - Lifecycle events (lifecycleEvents): Triggered at framework core milestones, e.g. ready, electron-app-ready, window-ready
+ * - Custom events (eventsMap): Freely used by business code via on/emit
+ *
+ * Event handlers support both synchronous and asynchronous functions. Async errors are caught and logged
+ * without causing the process to crash.
+ */
+const index_js_1 = require("../log/index.js");
+/** Lifecycle: Framework foundational features loaded (controllers, communication services ready) */
+exports.Ready = 'ready';
+/** Lifecycle: Electron app.whenReady() completed */
+exports.ElectronAppReady = 'electron-app-ready';
+/** Lifecycle: Main window created */
+exports.WindowReady = 'window-ready';
+/** Lifecycle: Before window closes, can be used for cleanup operations */
+exports.BeforeClose = 'before-close';
+/** Lifecycle: Preload script injection timing */
+exports.Preload = 'preload';
+/**
+ * EventBus — Event bus
+ *
+ * Design highlights:
+ * - Lifecycle events and custom events are stored separately to avoid naming conflicts
+ * - register() registers lifecycle events, on() registers custom events
+ * - Re-registering the same event name overwrites the previous handler and outputs a warning (rather than silently ignoring)
+ * - emit methods have built-in try/catch, ensuring a single handler exception does not affect other logic
+ * - Promises returned by async handlers have errors automatically caught
+ */
+class EventBus {
+    constructor() {
+        /** Lifecycle event handler mapping */
+        this.lifecycleEvents = {};
+        /** Custom event handler mapping */
+        this.eventsMap = {};
+    }
+    /**
+     * Register a lifecycle event handler
+     *
+     * Lifecycle events are triggered internally by the framework; business code registers hooks via this method.
+     * If the event name is already registered, the old handler is overwritten and a warning is logged.
+     *
+     * @param eventName - Lifecycle event name (Ready / ElectronAppReady / WindowReady / BeforeClose / Preload)
+     * @param handler - Event handler function, supports sync or async
+     */
+    register(eventName, handler) {
+        if (this.lifecycleEvents[eventName]) {
+            index_js_1.coreLogger.warn(`[EventBus] Lifecycle event '${eventName}' already registered, overriding.`);
+        }
+        this.lifecycleEvents[eventName] = handler;
+    }
+    /**
+     * Emit a lifecycle event
+     *
+     * Invokes the corresponding event handler. Errors are NOT silently swallowed —
+     * sync errors propagate to the caller, async errors are re-thrown as unhandled rejections
+     * (caught by the global exception handler).
+     *
+     * @param eventName - Lifecycle event name
+     * @param args - Arguments passed to the handler
+     */
+    emitLifecycle(eventName, ...args) {
+        const eventFn = this.lifecycleEvents[eventName];
+        if (!eventFn)
+            return;
+        const result = eventFn(...args);
+        // Async handler: re-throw as unhandled rejection so the global handler catches it
+        if (result instanceof Promise) {
+            result.catch((err) => {
+                index_js_1.coreLogger.error(`[EventBus] Async lifecycle handler '${eventName}' error:`, err);
+                throw err;
+            });
+        }
+    }
+    /**
+     * Register a custom event handler
+     *
+     * Business code can register custom events via this method, triggered by business code itself.
+     * If the event name is already registered, the old handler is overwritten and a warning is logged.
+     *
+     * @param eventName - Custom event name
+     * @param handler - Event handler function, supports sync or async
+     */
+    on(eventName, handler) {
+        if (this.eventsMap[eventName]) {
+            index_js_1.coreLogger.warn(`[EventBus] Event '${eventName}' already registered, overriding.`);
+        }
+        this.eventsMap[eventName] = handler;
+    }
+    /**
+     * Emit a custom event
+     *
+     * Invokes the corresponding event handler, automatically catching synchronous exceptions and async rejections.
+     *
+     * @param eventName - Custom event name
+     * @param args - Arguments passed to the handler
+     */
+    emit(eventName, ...args) {
+        const eventFn = this.eventsMap[eventName];
+        if (eventFn) {
+            try {
+                const result = eventFn(...args);
+                if (result instanceof Promise) {
+                    result.catch((err) => {
+                        index_js_1.coreLogger.error(`[EventBus] Async event handler '${eventName}' error:`, err);
+                    });
+                }
+            }
+            catch (err) {
+                index_js_1.coreLogger.error(`[EventBus] Event handler '${eventName}' error:`, err);
+            }
+        }
+    }
+}
+exports.EventBus = EventBus;
+/** Event bus singleton, globally shared */
+exports.eventBus = new EventBus();
+//# sourceMappingURL=events.js.map

package/dist/esm/app/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/app/events.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,8CAA6C;AAE7C,oGAAoG;AACvF,QAAA,KAAK,GAAG,OAAO,CAAC;AAC7B,oDAAoD;AACvC,QAAA,gBAAgB,GAAG,oBAAoB,CAAC;AACrD,qCAAqC;AACxB,QAAA,WAAW,GAAG,cAAc,CAAC;AAC1C,0EAA0E;AAC7D,QAAA,WAAW,GAAG,cAAc,CAAC;AAC1C,iDAAiD;AACpC,QAAA,OAAO,GAAG,SAAS,CAAC;AAIjC;;;;;;;;;GASG;AACH,MAAa,QAAQ;IAArB;QACE,sCAAsC;QAC9B,oBAAe,GAAiC,EAAE,CAAC;QAC3D,mCAAmC;QAC3B,cAAS,GAAiC,EAAE,CAAC;IAiFvD,CAAC;IA/EC;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAqB;QAC/C,IAAI,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,qBAAU,CAAC,IAAI,CAAC,+BAA+B,SAAS,mCAAmC,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAC5C,CAAC;IAED;;;;;;;;;OASG;IACH,aAAa,CAAC,SAAiB,EAAE,GAAG,IAAe;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAChC,kFAAkF;QAClF,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBAC5B,qBAAU,CAAC,KAAK,CAAC,uCAAuC,SAAS,UAAU,EAAE,GAAG,CAAC,CAAC;gBAClF,MAAM,GAAG,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,EAAE,CAAC,SAAiB,EAAE,OAAqB;QACzC,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,qBAAU,CAAC,IAAI,CAAC,qBAAqB,SAAS,mCAAmC,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IACtC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,SAAiB,EAAE,GAAG,IAAe;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;gBAChC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;wBAC5B,qBAAU,CAAC,KAAK,CAAC,mCAAmC,SAAS,UAAU,EAAE,GAAG,CAAC,CAAC;oBAChF,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,qBAAU,CAAC,KAAK,CAAC,6BAA6B,SAAS,UAAU,EAAE,GAAG,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;CACF;AArFD,4BAqFC;AAED,2CAA2C;AAC9B,QAAA,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC"}