ee-core 4.1.5 → 5.0.0-beta.5

package/dist/cjs/controller/controller_loader.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": 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 (globby): Scans the filesystem, using globby to match files
+ *
+ * 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");
+const index_js_1 = require("../ps/index.js");
+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 controllers synchronously
+     *
+     * Uses registry first (bundle mode), otherwise falls back to globby file 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;
+                    obj.prototype.fullPath = options.path;
+                    return wrapClass(obj);
+                }
+                return obj;
+            },
+        };
+        const target = new file_loader_js_1.FileLoader(opt).load();
+        debugLog('[load] controllers (%s): %o', registry ? 'registry' : 'globby', 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' : 'globby', target);
+        this.timing.end('Load Controller');
+        return target;
+    }
+}
+exports.ControllerLoader = ControllerLoader;
+/**
+ * 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 = {};
+    // Trace the prototype chain, collecting methods from all levels
+    while (proto !== Object.prototype) {
+        const keys = Object.getOwnPropertyNames(proto);
+        for (const key of keys) {
+            // Skip constructor
+            if (key === 'constructor')
+                continue;
+            const d = Object.getOwnPropertyDescriptor(proto, key);
+            // 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] =
+                    proto.fullPath + '#' + Controller.name + '.' + key + '()';
+            }
+        }
+        proto = Object.getPrototypeOf(proto);
+    }
+    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();
+        const fn = controller[key];
+        if (!fn)
+            return undefined;
+        return (0, index_js_2.callFn)(fn, args, controller);
+    };
+}
+//# sourceMappingURL=controller_loader.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,88 @@
+"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();
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"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"}

package/dist/cjs/core/loader/file_loader.d.ts

@@ -0,0 +1,112 @@
+import type { FileLoaderOptions } from '../../types/index.js';
+/** Symbol marker: records the full path of a file */
+export declare const FULLPATH: unique symbol;
+/** Symbol marker: indicates the export has been processed by the loader */
+export declare const EXPORTS: unique symbol;
+/** Load item: file path, property path, exported content */
+interface LoaderItem {
+    fullpath: string;
+    properties: string[];
+    exports: unknown;
+}
+/** Default configuration */
+declare const defaults: {
+    /** Property naming style */
+    caseStyle: "camel";
+    /** Custom initializer: performs additional processing on exported content */
+    initializer: ((obj: unknown, options: {
+        pathName: string;
+        path: string;
+    }) => unknown) | null;
+    /** Whether to automatically invoke function-type exports */
+    call: boolean;
+    /** Injection arguments for function calls */
+    inject: undefined;
+    /** Target object (deprecated; now created internally by load()) */
+    target: Record<string, unknown> | null;
+    /** File match patterns (overrides default filePatterns) */
+    match: string[] | undefined;
+};
+/**
+ * FileLoader — File loader
+ *
+ * Organizes exported content from files in a directory into nested property objects
+ * based on directory structure. Supports synchronous/asynchronous loading and registry mode.
+ */
+export declare class FileLoader {
+    options: FileLoaderOptions & typeof defaults;
+    constructor(options: FileLoaderOptions);
+    /**
+     * Process a single export
+     *
+     * Execution flow:
+     * 1. Run initializer (if present) for custom processing of the export
+     * 2. Set pathName and fullPath properties on classes
+     * 3. Class/generator function/async function/bytecode class -> return directly
+     * 4. Plain function -> auto-invoke based on the call option
+     *
+     * @param exports - File exported content
+     * @param fullpath - File full path
+     * @param properties - Property path (array converted from directory + filename)
+     * @param dirName - Directory name (used as property path prefix)
+     * @returns LoaderItem or null (skipped when export is null/undefined)
+     */
+    private _processExport;
+    /**
+     * Assign load items to target object
+     *
+     * Creates nested objects level by level along the property path, ultimately mounting
+     * the exported content at the leaf node. Also marks non-primitive exports with
+     * FULLPATH and EXPORTS symbols.
+     *
+     * @param items - Load item list
+     * @returns Nested property object
+     */
+    private _assignToTarget;
+    /**
+     * Load files and build target object
+     *
+     * Loads from registry when available (bundle mode), otherwise scans filesystem (dev mode).
+     *
+     * @returns Nested property object organized by directory structure
+     */
+    load(): Record<string, unknown>;
+    /**
+     * Parse files synchronously from filesystem
+     *
+     * Uses globby to scan directories and require() to load files.
+     * Suitable for CJS dev mode.
+     *
+     * @returns Load item list
+     */
+    parse(): LoaderItem[];
+    /**
+     * Parse modules from pre-registered registry
+     *
+     * In bundle mode, the esbuild plugin pre-registers controller/configuration info
+     * into global variables. This method reads the registry directly without filesystem scanning.
+     *
+     * @returns Load item list
+     */
+    parseFromRegistry(): LoaderItem[];
+    /**
+     * Load files asynchronously and build target object
+     *
+     * Uses globby async scanning and import() dynamic loading.
+     * Suitable for ESM dev mode.
+     *
+     * @returns Nested property object organized by directory structure
+     */
+    loadAsync(): Promise<Record<string, unknown>>;
+    /**
+     * Parse files asynchronously from filesystem
+     *
+     * Uses globby async scanning and fs.promises.stat for async file checking.
+     * Suitable for ESM dev mode.
+     *
+     * @returns Load item list
+     */
+    parseAsync(): Promise<LoaderItem[]>;
+}
+export {};
+//# sourceMappingURL=file_loader.d.ts.map

package/dist/cjs/core/loader/file_loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_loader.d.ts","sourceRoot":"","sources":["../../../../src/core/loader/file_loader.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI9D,qDAAqD;AACrD,eAAO,MAAM,QAAQ,eAAiC,CAAC;AACvD,2EAA2E;AAC3E,eAAO,MAAM,OAAO,eAAgC,CAAC;AAErD,4DAA4D;AAC5D,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,4BAA4B;AAC5B,QAAA,MAAM,QAAQ;IACZ,4BAA4B;;IAE5B,6EAA6E;iBACxD,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,IAAI;IACpG,4DAA4D;;IAE5D,6CAA6C;;IAE7C,mEAAmE;YACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAC9C,2DAA2D;WACvC,MAAM,EAAE,GAAG,SAAS;CACzC,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,EAAE,iBAAiB,GAAG,OAAO,QAAQ,CAAC;gBAEjC,OAAO,EAAE,iBAAiB;IAQtC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,cAAc;IAqCtB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAyBvB;;;;;;OAMG;IACH,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK/B;;;;;;;OAOG;IACH,KAAK,IAAI,UAAU,EAAE;IAoCrB;;;;;;;OAOG;IACH,iBAAiB,IAAI,UAAU,EAAE;IA4BjC;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKnD;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;CAmC1C"}