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

package/dist/cjs/config/default_config.js.map

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

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

@@ -1,4 +1,34 @@
-import type { Config } from '../types/index.js';
+import type { AppInfo, Config } from '../types/index.js';
+/**
+ * Load configuration
+ *
+ * Uses ConfigLoader to load and merge default configuration with business configuration.
+ * Called by init() in boot.ts during the framework startup flow.
+ */
 export declare function loadConfig(): void;
+/**
+ * Get runtime configuration
+ *
+ * If configuration has not been loaded yet, loading is automatically triggered.
+ * Typically used after framework startup to ensure configuration is ready.
+ *
+ * @returns Complete runtime configuration object
+ */
 export declare function getConfig(): Config;
+/**
+ * Set runtime configuration directly
+ *
+ * Used by child processes to receive config from the main process,
+ * avoiding filesystem loading which may fail in child processes
+ * (e.g. bundle output directory lacks config files).
+ *
+ * @param cfg - Configuration object to set
+ */
+export declare function setConfig(cfg: Config): void;
+/**
+ * Get application basic info
+ *
+ * @returns Object containing application name, directories, environment, and other info
+ */
+export declare function getAppInfo(): AppInfo;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAKlC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAKzD;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAQpC"}

package/dist/cjs/config/index.js

@@ -2,16 +2,68 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadConfig = loadConfig;
 exports.getConfig = getConfig;
+exports.setConfig = setConfig;
+exports.getAppInfo = getAppInfo;
+/**
+ * @module config
+ * @description Configuration module entry point. Provides configuration loading and retrieval functionality.
+ *
+ * Usage:
+ * - loadConfig(): Called once during framework startup to load and merge configuration
+ * - getConfig(): Retrieve the final merged runtime configuration
+ * - getAppInfo(): Retrieve application basic info (name, paths, environment, etc.)
+ */
 const config_loader_js_1 = require("./config_loader.js");
+/** Runtime configuration (assigned after startup) */
 let config = null;
+/**
+ * Load configuration
+ *
+ * Uses ConfigLoader to load and merge default configuration with business configuration.
+ * Called by init() in boot.ts during the framework startup flow.
+ */
 function loadConfig() {
     const loader = new config_loader_js_1.ConfigLoader();
     config = loader.load();
 }
+/**
+ * Get runtime configuration
+ *
+ * If configuration has not been loaded yet, loading is automatically triggered.
+ * Typically used after framework startup to ensure configuration is ready.
+ *
+ * @returns Complete runtime configuration object
+ */
 function getConfig() {
     if (!config) {
         loadConfig();
     }
     return config;
 }
+/**
+ * Set runtime configuration directly
+ *
+ * Used by child processes to receive config from the main process,
+ * avoiding filesystem loading which may fail in child processes
+ * (e.g. bundle output directory lacks config files).
+ *
+ * @param cfg - Configuration object to set
+ */
+function setConfig(cfg) {
+    config = cfg;
+}
+/**
+ * Get application basic info
+ *
+ * @returns Object containing application name, directories, environment, and other info
+ */
+function getAppInfo() {
+    return {
+        name: process.env.EE_APP_NAME || '',
+        baseDir: process.env.EE_BASE_DIR || '',
+        electronDir: process.env.EE_ELECTRON_DIR || '',
+        env: process.env.EE_ENV || 'prod',
+        root: process.env.EE_BASE_DIR || '',
+    };
+}
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;AAKA,gCAGC;AAED,8BAKC;AAfD,yDAAkD;AAGlD,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAG,IAAI,+BAAY,EAAE,CAAC;IAClC,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAgB,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;IACf,CAAC;IACD,OAAO,MAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;AAqBA,gCAGC;AAUD,8BAKC;AAWD,8BAEC;AAOD,gCAQC;AAnED;;;;;;;;GAQG;AACH,yDAAkD;AAGlD,qDAAqD;AACrD,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC;;;;;GAKG;AACH,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAG,IAAI,+BAAY,EAAE,CAAC;IAClC,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;IACf,CAAC;IACD,OAAO,MAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAC,GAAW;IACnC,MAAM,GAAG,GAAG,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU;IACxB,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;QACnC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;QACtC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE;QAC9C,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM;QACjC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/cjs/const/channel.d.ts

@@ -1,17 +1,34 @@
+/**
+ * @module const/channel
+ * @description IPC communication channel and event constant definitions.
+ * Centrally manages channel names and event names used internally by the framework, avoiding hardcoded strings.
+ */
+/** Inter-process communication channels */
 export declare const Processes: {
+    /** Exception display channel: renderer process displays an exception dialog upon receiving this channel message */
     readonly showException: "ee#showException";
+    /** Channel for child process to send messages to the main process */
     readonly sendToMain: "ee#sendToMain";
 };
+/** SocketIO communication channels */
 export declare const SocketIO: {
+    /** Third-party software communication channel (default SocketIO communication channel name) */
     readonly partySoftware: "socket-channel";
 };
+/** Process lifecycle events */
 export declare const Events: {
+    /** Child process exit event */
     readonly childProcessExit: "ee#childProcess#exit";
+    /** Child process error event */
     readonly childProcessError: "ee#childProcess#error";
 };
+/** Message receiver types */
 export declare const Receiver: {
+    /** ChildJob-type child process */
     readonly childJob: "job";
+    /** Fork process (generic task) */
     readonly forkProcess: "task";
+    /** All receivers */
     readonly all: "all";
 };
 //# sourceMappingURL=channel.d.ts.map

package/dist/cjs/const/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/const/channel.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;;;CAGZ,CAAC;AAEX,eAAO,MAAM,QAAQ;;CAEX,CAAC;AAEX,eAAO,MAAM,MAAM;;;CAGT,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;CAIX,CAAC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/const/channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,SAAS;IACpB,mHAAmH;;IAEnH,qEAAqE;;CAE7D,CAAC;AAEX,sCAAsC;AACtC,eAAO,MAAM,QAAQ;IACnB,+FAA+F;;CAEvF,CAAC;AAEX,+BAA+B;AAC/B,eAAO,MAAM,MAAM;IACjB,+BAA+B;;IAE/B,gCAAgC;;CAExB,CAAC;AAEX,6BAA6B;AAC7B,eAAO,MAAM,QAAQ;IACnB,kCAAkC;;IAElC,kCAAkC;;IAElC,oBAAoB;;CAEZ,CAAC"}

package/dist/cjs/const/channel.js

@@ -1,20 +1,37 @@
 "use strict";
+/**
+ * @module const/channel
+ * @description IPC communication channel and event constant definitions.
+ * Centrally manages channel names and event names used internally by the framework, avoiding hardcoded strings.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Receiver = exports.Events = exports.SocketIO = exports.Processes = void 0;
+/** Inter-process communication channels */
 exports.Processes = {
+    /** Exception display channel: renderer process displays an exception dialog upon receiving this channel message */
     showException: 'ee#showException',
+    /** Channel for child process to send messages to the main process */
     sendToMain: 'ee#sendToMain',
 };
+/** SocketIO communication channels */
 exports.SocketIO = {
+    /** Third-party software communication channel (default SocketIO communication channel name) */
     partySoftware: 'socket-channel',
 };
+/** Process lifecycle events */
 exports.Events = {
+    /** Child process exit event */
     childProcessExit: 'ee#childProcess#exit',
+    /** Child process error event */
     childProcessError: 'ee#childProcess#error',
 };
+/** Message receiver types */
 exports.Receiver = {
+    /** ChildJob-type child process */
     childJob: 'job',
+    /** Fork process (generic task) */
     forkProcess: 'task',
+    /** All receivers */
     all: 'all',
 };
 //# sourceMappingURL=channel.js.map

package/dist/cjs/const/channel.js.map

@@ -1 +1 @@
-{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../src/const/channel.ts"],"names":[],"mappings":";;;AAAa,QAAA,SAAS,GAAG;IACvB,aAAa,EAAE,kBAAkB;IACjC,UAAU,EAAE,eAAe;CACnB,CAAC;AAEE,QAAA,QAAQ,GAAG;IACtB,aAAa,EAAE,gBAAgB;CACvB,CAAC;AAEE,QAAA,MAAM,GAAG;IACpB,gBAAgB,EAAE,sBAAsB;IACxC,iBAAiB,EAAE,uBAAuB;CAClC,CAAC;AAEE,QAAA,QAAQ,GAAG;IACtB,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,MAAM;IACnB,GAAG,EAAE,KAAK;CACF,CAAC"}
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../src/const/channel.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAA2C;AAC9B,QAAA,SAAS,GAAG;IACvB,mHAAmH;IACnH,aAAa,EAAE,kBAAkB;IACjC,qEAAqE;IACrE,UAAU,EAAE,eAAe;CACnB,CAAC;AAEX,sCAAsC;AACzB,QAAA,QAAQ,GAAG;IACtB,+FAA+F;IAC/F,aAAa,EAAE,gBAAgB;CACvB,CAAC;AAEX,+BAA+B;AAClB,QAAA,MAAM,GAAG;IACpB,+BAA+B;IAC/B,gBAAgB,EAAE,sBAAsB;IACxC,gCAAgC;IAChC,iBAAiB,EAAE,uBAAuB;CAClC,CAAC;AAEX,6BAA6B;AAChB,QAAA,QAAQ,GAAG;IACtB,kCAAkC;IAClC,QAAQ,EAAE,KAAK;IACf,kCAAkC;IAClC,WAAW,EAAE,MAAM;IACnB,oBAAoB;IACpB,GAAG,EAAE,KAAK;CACF,CAAC"}

package/dist/cjs/controller/controller_loader.d.ts

@@ -1,10 +1,29 @@
 import { Timing } from '../core/utils/timing.js';
+/**
+ * ControllerLoader — Controller loader
+ *
+ * Responsible for loading all controller files under the electron/controller/ directory
+ * and wrapping class methods into callable middleware functions.
+ */
 export declare class ControllerLoader {
     timing: Timing;
     constructor();
     /**
-     * Load controller/xxx.js
+     * Load controllers synchronously
+     *
+     * Uses registry first (bundle mode), otherwise falls back to filesystem scanning (dev mode).
+     *
+     * @returns Controller method mapping object, structured as { controller: { module: { method: fn } } }
      */
     load(): Record<string, unknown>;
+    /**
+     * Load controllers asynchronously (ESM support)
+     *
+     * Uses dynamic import() instead of require(), supporting ESM format controller files.
+     * Same flow as load(), but file loading and parsing are asynchronous operations.
+     *
+     * @returns Controller method mapping object
+     */
+    loadAsync(): Promise<Record<string, unknown>>;
 }
 //# sourceMappingURL=controller_loader.d.ts.map

package/dist/cjs/controller/controller_loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller_loader.d.ts","sourceRoot":"","sources":["../../../src/controller/controller_loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAMjD,qBAAa,gBAAgB;IAC3B,MAAM,EAAE,MAAM,CAAC;;IAMf;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAoBhC"}
+{"version":3,"file":"controller_loader.d.ts","sourceRoot":"","sources":["../../../src/controller/controller_loader.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAOjD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,MAAM,EAAE,MAAM,CAAC;;IAMf;;;;;;OAMG;IACH,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAuB/B;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAsBpD"}

package/dist/cjs/controller/controller_loader.js

@@ -4,6 +4,28 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ControllerLoader = void 0;
+/**
+ * @module controller/controller_loader
+ * @description Controller loader. Scans all files under the electron/controller/ directory,
+ * converts exported classes to method mapping objects, and registers exported functions directly.
+ *
+ * Loading modes:
+ * - Bundle mode (registry): Reads pre-registered controller modules from globalThis.__EE_CONTROLLER_REGISTRY__
+ * - Dev mode (filesystem): Scans the filesystem recursively
+ *
+ * Class controller processing flow:
+ * 1. The class is wrapped by wrapClass(), which traverses all methods on the prototype chain
+ * 2. Each method is converted to a middleware function by methodToMiddleware()
+ * 3. Each middleware invocation creates a new controller instance, ensuring concurrency safety
+ * 4. Method properties have pathName and fullPath attached for IPC channel routing
+ *
+ * Export structure example:
+ * ```
+ * controller/
+ *   user.js          -> { controller: { user: { add: fn, delete: fn } } }
+ *   admin/login.js   -> { controller: { admin: { login: { auth: fn } } } }
+ * ```
+ */
 const debug_1 = __importDefault(require("debug"));
 const path_1 = __importDefault(require("path"));
 const type_check_js_1 = require("../utils/type_check.js");
@@ -12,18 +34,30 @@ const timing_js_1 = require("../core/utils/timing.js");
 const file_loader_js_1 = require("../core/loader/file_loader.js");
 const index_js_2 = require("../core/utils/index.js");
 const debugLog = (0, debug_1.default)('ee-core:controller:controller_loader');
+/**
+ * ControllerLoader — Controller loader
+ *
+ * Responsible for loading all controller files under the electron/controller/ directory
+ * and wrapping class methods into callable middleware functions.
+ */
 class ControllerLoader {
     constructor() {
         this.timing = new timing_js_1.Timing();
     }
     /**
-     * Load controller/xxx.js
+     * Load controllers synchronously
+     *
+     * Uses registry first (bundle mode), otherwise falls back to filesystem scanning (dev mode).
+     *
+     * @returns Controller method mapping object, structured as { controller: { module: { method: fn } } }
      */
     load() {
         this.timing.start('Load Controller');
+        const registry = globalThis.__EE_CONTROLLER_REGISTRY__;
         const opt = {
             caseStyle: 'lower',
             directory: path_1.default.join((0, index_js_1.getElectronDir)(), 'controller'),
+            ...(registry ? { registry } : {}),
             initializer: (obj, options) => {
                 if ((0, type_check_js_1.isClass)(obj) || (0, index_js_2.isBytecodeClass)(obj)) {
                     obj.prototype.pathName = options.pathName;
@@ -34,28 +68,63 @@ class ControllerLoader {
             },
         };
         const target = new file_loader_js_1.FileLoader(opt).load();
-        debugLog('[load] controllers: %o', target);
+        debugLog('[load] controllers (%s): %o', registry ? 'registry' : 'filesystem', target);
+        this.timing.end('Load Controller');
+        return target;
+    }
+    /**
+     * Load controllers asynchronously (ESM support)
+     *
+     * Uses dynamic import() instead of require(), supporting ESM format controller files.
+     * Same flow as load(), but file loading and parsing are asynchronous operations.
+     *
+     * @returns Controller method mapping object
+     */
+    async loadAsync() {
+        this.timing.start('Load Controller');
+        const registry = globalThis.__EE_CONTROLLER_REGISTRY__;
+        const opt = {
+            caseStyle: 'lower',
+            directory: path_1.default.join((0, index_js_1.getElectronDir)(), 'controller'),
+            ...(registry ? { registry } : {}),
+            initializer: (obj, options) => {
+                if ((0, type_check_js_1.isClass)(obj) || (0, index_js_2.isBytecodeClass)(obj)) {
+                    obj.prototype.pathName = options.pathName;
+                    obj.prototype.fullPath = options.path;
+                    return wrapClass(obj);
+                }
+                return obj;
+            },
+        };
+        const target = await new file_loader_js_1.FileLoader(opt).loadAsync();
+        debugLog('[loadAsync] controllers (%s): %o', registry ? 'registry' : 'filesystem', target);
         this.timing.end('Load Controller');
         return target;
     }
 }
 exports.ControllerLoader = ControllerLoader;
-// wrap the class, yield a object with middlewares
+/**
+ * Wrap a controller class, extracting all methods from the prototype chain
+ *
+ * Traverses the class prototype chain, mapping each method name to a middleware function.
+ * Subclass methods are not overridden by parent class methods of the same name (hasOwnProperty guard).
+ * Getters/setters and non-function properties are skipped.
+ *
+ * @param Controller - Controller class constructor
+ * @returns Mapping of method names to middleware functions
+ */
 function wrapClass(Controller) {
     let proto = Controller.prototype;
     const ret = {};
-    // tracing the prototype chain
+    // Trace the prototype chain, collecting methods from all levels
     while (proto !== Object.prototype) {
         const keys = Object.getOwnPropertyNames(proto);
-        // debugLog("[wrapClass] keys:", keys);
         for (const key of keys) {
-            // getOwnPropertyNames will return constructor
-            // that should be ignored
+            // Skip constructor
             if (key === 'constructor')
                 continue;
-            // skip getter, setter & non-function properties
             const d = Object.getOwnPropertyDescriptor(proto, key);
-            // prevent to override sub method
+            // Skip getter/setter and non-function properties; methods already defined in subclass are not overridden by parent
             if ((0, type_check_js_1.isFunction)(d?.value) && !Object.prototype.hasOwnProperty.call(ret, key)) {
                 ret[key] = methodToMiddleware(Controller, key);
                 ret[key][file_loader_js_1.FULLPATH] =
@@ -66,6 +135,17 @@ function wrapClass(Controller) {
     }
     return ret;
 }
+/**
+ * Convert a controller method to a middleware function
+ *
+ * Key design: a new controller instance is created on each invocation.
+ * This is done to ensure concurrency safety — when multiple requests arrive simultaneously,
+ * each request has its own controller instance, avoiding race conditions caused by shared state.
+ *
+ * @param Controller - Controller class constructor
+ * @param key - Method name
+ * @returns Middleware function that creates a new instance and executes the corresponding method on invocation
+ */
 function methodToMiddleware(Controller, key) {
     return function classControllerMiddleware(...args) {
         const controller = new Controller();

package/dist/cjs/controller/controller_loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"controller_loader.js","sourceRoot":"","sources":["../../../src/controller/controller_loader.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,gDAAwB;AACxB,0DAA6D;AAC7D,6CAAgD;AAChD,uDAAiD;AACjD,kEAAqE;AACrE,qDAAiE;AAEjE,MAAM,QAAQ,GAAG,IAAA,eAAK,EAAC,sCAAsC,CAAC,CAAC;AAE/D,MAAa,gBAAgB;IAG3B;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAM,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAErC,MAAM,GAAG,GAAG;YACV,SAAS,EAAE,OAAgB;YAC3B,SAAS,EAAE,cAAI,CAAC,IAAI,CAAC,IAAA,yBAAc,GAAE,EAAE,YAAY,CAAC;YACpD,WAAW,EAAE,CAAC,GAAY,EAAE,OAA2C,EAAE,EAAE;gBACzE,IAAI,IAAA,uBAAO,EAAC,GAAG,CAAC,IAAI,IAAA,0BAAe,EAAC,GAAG,CAAC,EAAE,CAAC;oBACxC,GAA8C,CAAC,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;oBACrF,GAA8C,CAAC,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;oBAClF,OAAO,SAAS,CAAC,GAA0C,CAAC,CAAC;gBAC/D,CAAC;gBACD,OAAO,GAAG,CAAC;YACb,CAAC;SACF,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,2BAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA9BD,4CA8BC;AAED,kDAAkD;AAClD,SAAS,SAAS,CAAC,UAA+C;IAChE,IAAI,KAAK,GAAI,UAAgE,CAAC,SAAS,CAAC;IACxF,MAAM,GAAG,GAA4B,EAAE,CAAC;IAExC,8BAA8B;IAC9B,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC/C,uCAAuC;QACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,8CAA8C;YAC9C,yBAAyB;YACzB,IAAI,GAAG,KAAK,aAAa;gBAAE,SAAS;YACpC,gDAAgD;YAChD,MAAM,CAAC,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACtD,iCAAiC;YACjC,IAAI,IAAA,0BAAU,EAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC5E,GAAG,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;gBAC9C,GAAG,CAAC,GAAG,CAA4B,CAAC,yBAAQ,CAAC;oBAC3C,KAAgC,CAAC,QAAQ,GAAG,GAAG,GAAI,UAA0C,CAAC,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;YAC3H,CAAC;QACH,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB,CAAC,UAA+C,EAAE,GAAW;IACtF,OAAO,SAAS,yBAAyB,CAAC,GAAG,IAAe;QAC1D,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,EAAE,GAAI,UAA8D,CAAC,GAAG,CAAC,CAAC;QAChF,IAAI,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAC1B,OAAO,IAAA,iBAAM,EAAC,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"controller_loader.js","sourceRoot":"","sources":["../../../src/controller/controller_loader.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,36 @@
+/**
+ * Load controllers synchronously
+ *
+ * Uses require() to load all controller files, suitable for CJS projects.
+ * If async loading is in progress, calling this method throws an error.
+ *
+ * @returns Controller method mapping object
+ * @throws Throws an error when async loading is in progress
+ */
 export declare function loadController(): Record<string, unknown>;
+/**
+ * Load controllers asynchronously
+ *
+ * Uses import() to asynchronously load all controller files, suitable for ESM projects.
+ * Sets the loading flag during loading to prevent synchronous loading operations.
+ *
+ * @returns Controller method mapping object
+ */
+export declare function loadControllerAsync(): Promise<Record<string, unknown>>;
+/**
+ * Get all loaded controllers
+ *
+ * If controllers have not been loaded yet, synchronous loading is automatically triggered.
+ * Calling during async loading throws an error.
+ *
+ * @returns Controller method mapping object
+ * @throws Throws an error when async loading is in progress
+ */
 export declare function getControllers(): Record<string, unknown>;
+/**
+ * Get controllers (alias for getControllers)
+ *
+ * @returns Controller method mapping object
+ */
 export declare function getController(): Record<string, unknown>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/controller/index.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIxD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKxD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/controller/index.ts"],"names":[],"mappings":"AAsBA;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOxD;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAS5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEvD"}

package/dist/cjs/controller/index.js

@@ -1,21 +1,87 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadController = loadController;
+exports.loadControllerAsync = loadControllerAsync;
 exports.getControllers = getControllers;
 exports.getController = getController;
+/**
+ * @module controller
+ * @description Controller module entry point. Provides controller loading and retrieval functionality.
+ *
+ * Controllers are the core of business logic; each frontend IPC request is ultimately routed to a corresponding controller method.
+ *
+ * Usage:
+ * - loadController(): Synchronous loading (CJS projects)
+ * - loadControllerAsync(): Asynchronous loading (ESM projects)
+ * - getController() / getControllers(): Retrieve loaded controller mapping
+ *
+ * Thread safety: The loading flag prevents concurrent synchronous and asynchronous loading;
+ * calling a synchronous method during async loading throws an error.
+ */
 const controller_loader_js_1 = require("./controller_loader.js");
+/** Loaded controller method mapping */
 let controllers = null;
+/** Flag indicating async loading is in progress, preventing sync/async load race conditions */
+let loading = false;
+/**
+ * Load controllers synchronously
+ *
+ * Uses require() to load all controller files, suitable for CJS projects.
+ * If async loading is in progress, calling this method throws an error.
+ *
+ * @returns Controller method mapping object
+ * @throws Throws an error when async loading is in progress
+ */
 function loadController() {
+    if (loading) {
+        throw new Error('[ee-core] Controllers are being loaded asynchronously. Use getControllers() after the async load completes.');
+    }
     const loader = new controller_loader_js_1.ControllerLoader();
     controllers = loader.load();
     return controllers;
 }
+/**
+ * Load controllers asynchronously
+ *
+ * Uses import() to asynchronously load all controller files, suitable for ESM projects.
+ * Sets the loading flag during loading to prevent synchronous loading operations.
+ *
+ * @returns Controller method mapping object
+ */
+async function loadControllerAsync() {
+    loading = true;
+    try {
+        const loader = new controller_loader_js_1.ControllerLoader();
+        controllers = await loader.loadAsync();
+        return controllers;
+    }
+    finally {
+        loading = false;
+    }
+}
+/**
+ * Get all loaded controllers
+ *
+ * If controllers have not been loaded yet, synchronous loading is automatically triggered.
+ * Calling during async loading throws an error.
+ *
+ * @returns Controller method mapping object
+ * @throws Throws an error when async loading is in progress
+ */
 function getControllers() {
+    if (loading) {
+        throw new Error('[ee-core] Controllers are being loaded asynchronously. Await the async load before accessing controllers.');
+    }
     if (!controllers) {
         loadController();
     }
     return controllers;
 }
+/**
+ * Get controllers (alias for getControllers)
+ *
+ * @returns Controller method mapping object
+ */
 function getController() {
     return getControllers();
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/controller/index.ts"],"names":[],"mappings":";;AAIA,wCAIC;AAED,wCAKC;AAED,sCAEC;AAnBD,iEAA0D;AAE1D,IAAI,WAAW,GAAmC,IAAI,CAAC;AAEvD,SAAgB,cAAc;IAC5B,MAAM,MAAM,GAAG,IAAI,uCAAgB,EAAE,CAAC;IACtC,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAgB,cAAc;IAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,cAAc,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,WAAY,CAAC;AACtB,CAAC;AAED,SAAgB,aAAa;IAC3B,OAAO,cAAc,EAAE,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/controller/index.ts"],"names":[],"mappings":";;AA+BA,wCAOC;AAUD,kDASC;AAWD,wCAQC;AAOD,sCAEC;AArFD;;;;;;;;;;;;;GAaG;AACH,iEAA0D;AAE1D,uCAAuC;AACvC,IAAI,WAAW,GAAmC,IAAI,CAAC;AAEvD,+FAA+F;AAC/F,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB;;;;;;;;GAQG;AACH,SAAgB,cAAc;IAC5B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,6GAA6G,CAAC,CAAC;IACjI,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,uCAAgB,EAAE,CAAC;IACtC,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,mBAAmB;IACvC,OAAO,GAAG,IAAI,CAAC;IACf,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,uCAAgB,EAAE,CAAC;QACtC,WAAW,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QACvC,OAAO,WAAW,CAAC;IACrB,CAAC;YAAS,CAAC;QACT,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,cAAc;IAC5B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2GAA2G,CAAC,CAAC;IAC/H,CAAC;IACD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,cAAc,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,WAAY,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa;IAC3B,OAAO,cAAc,EAAE,CAAC;AAC1B,CAAC"}