ee-core 4.1.5 → 5.0.0-beta.5

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

@@ -0,0 +1,524 @@
+/**
+ * @module types
+ * @description Framework core type definitions. Centralizes all public interface and configuration
+ * types for ee-core, referenced by framework modules and business code to ensure type safety
+ * and interface consistency.
+ *
+ * Includes:
+ * - ElectronEggOptions: framework startup parameters
+ * - Config series: runtime configuration (main service, Socket, HTTP, logging, exception, jobs, cross-process)
+ * - JobChildOptions: child process job parameters
+ * - FileLoaderOptions: file loader configuration
+ * - AppInfo: application metadata
+ * - MessageData: IPC message structure
+ * - TimingItem: performance timing entry
+ * - RegistryEntry: bundle mode registry entry
+ */
+import type { BrowserWindowConstructorOptions, OpenDevToolsOptions } from 'electron';
+/**
+ * ElectronEgg startup options
+ *
+ * Constructed by the boot module during framework initialization, containing basic information
+ * about the application runtime environment. These values, once determined, do not change
+ * throughout the application lifecycle.
+ */
+export interface ElectronEggOptions {
+    /** Runtime environment identifier, e.g. 'dev', 'prod', 'test' */
+    env: string;
+    /** Project root directory (where package.json is located) */
+    baseDir: string;
+    /** Electron main process source directory (e.g. electron/) */
+    electronDir: string;
+    /** Application name, taken from the name field in package.json */
+    appName: string;
+    /** User home directory (os.homedir()) */
+    userHome: string;
+    /** System-level application data directory (macOS: ~/Library/Application Support, Windows: %APPDATA%) */
+    appData: string;
+    /** Electron user data directory (appData/appName) */
+    appUserData: string;
+    /** Application version, taken from the version field in package.json */
+    appVersion: string;
+    /** Whether packaged as an installer (app.isPackaged) */
+    isPackaged: boolean;
+    /** Executable directory (after packaging: exe path; during development: node_modules/electron path) */
+    execDir: string;
+}
+/**
+ * Remote service configuration
+ *
+ * Used to configure remote debugging or remote control service addresses.
+ * When enabled, the main process can connect to the remote service via WebSocket.
+ */
+export interface RemoteConfig {
+    /** Whether to enable remote service */
+    enable: boolean;
+    /** Remote service address (e.g. ws://remote-host:port) */
+    url: string;
+}
+/**
+ * Main window service configuration
+ *
+ * Defines how the main window loads content (local file or remote URL) and loading behavior.
+ */
+export interface MainServerConfig {
+    /** Protocol type: 'file://' loads local file, 'http://'/'https://' loads remote page */
+    protocol: string;
+    /** Entry file path (HTML file path for file protocol, URL path for http protocol) */
+    indexPath: string;
+    /** Extra options passed to protocol.handle or loadURL */
+    options?: Record<string, unknown>;
+    /** Loading strategy: 'start' (load on startup) or 'ready' (load after app ready), default 'start' */
+    takeover?: string;
+    /** Preload page path. Displayed before the main page loads, used for splash screens */
+    loadingPage?: string;
+    /** IPC channel separator, default '/'. E.g. '/' in 'controller/user/info' */
+    channelSeparator?: string;
+}
+/**
+ * Socket.IO service configuration
+ *
+ * Defines WebSocket communication parameters between main process and renderer process.
+ * Implemented with socket.io, supporting both polling and WebSocket transports.
+ */
+export interface SocketServerConfig {
+    /** Whether to enable Socket service */
+    enable: boolean;
+    /** Socket service listening port */
+    port: number;
+    /** Socket.IO path (default /socket.io) */
+    path: string;
+    /** Connection timeout (ms), disconnect after timeout */
+    connectTimeout: number;
+    /** Heartbeat timeout (ms), disconnect if no pong received */
+    pingTimeout: number;
+    /** Heartbeat send interval (ms) */
+    pingInterval: number;
+    /** Maximum bytes per HTTP message body, prevents oversized messages causing memory issues */
+    maxHttpBufferSize: number;
+    /** Transport list, supports 'polling' (long polling) and 'websocket' */
+    transports: ('polling' | 'websocket')[];
+    /** CORS configuration, follows socket.io CORS rules */
+    cors: {
+        origin: boolean | string | RegExp | string[] | ((origin: string | undefined, callback: (err: Error | null, allow?: boolean) => void) => void);
+    };
+    /** Custom communication channel name, used to distinguish different socket communication groups */
+    channel: string;
+}
+/**
+ * HTTPS certificate configuration
+ *
+ * Provides SSL/TLS certificates for HTTP service, enabling HTTPS support.
+ */
+export interface HttpsConfig {
+    /** Whether to enable HTTPS */
+    enable: boolean;
+    /** SSL private key file path */
+    key: string;
+    /** SSL certificate file path */
+    cert: string;
+}
+/**
+ * HTTP service configuration
+ *
+ * Defines parameters for the built-in Koa HTTP service, providing RESTful API interfaces.
+ * Primarily used for renderer process to communicate with main process via HTTP.
+ */
+export interface HttpServerConfig {
+    /** Whether to enable HTTP service */
+    enable: boolean;
+    /** HTTPS certificate configuration */
+    https: HttpsConfig;
+    /** Protocol type: 'http' or 'https' */
+    protocol: string;
+    /** Listening host address, default '127.0.0.1' (local access only) */
+    host: string;
+    /** Listening port */
+    port: number;
+    /** CORS configuration */
+    cors: {
+        /** Allowed origins, e.g. '*' or specific domain */
+        origin: string;
+    };
+    /** Request body parsing configuration */
+    body: {
+        /** Whether to support multipart/form-data (file upload) */
+        multipart: boolean;
+        /** formidable file upload handling configuration */
+        formidable: {
+            /** Whether to keep original file extensions for uploaded files */
+            keepExtensions: boolean;
+        };
+    };
+    /** Request filter configuration, returns fixed data for matched URIs (used to block or intercept specific requests) */
+    filterRequest: {
+        /** List of URIs to filter */
+        uris: string[];
+        /** Data to return for filtered URIs */
+        returnData: string;
+    };
+    /** Koa middleware extension configuration */
+    koaConfig?: KoaConfig;
+}
+/**
+ * Koa middleware configuration
+ *
+ * Allows business code to insert custom logic into the Koa HTTP service middleware chain.
+ */
+export interface KoaConfig {
+    /** Pre-middleware list, executed before route handling (e.g. auth, logging) */
+    preMiddleware?: ((...args: unknown[]) => unknown)[];
+    /** Post-middleware list, executed after route handling (e.g. error wrapping, response formatting) */
+    postMiddleware?: ((...args: unknown[]) => unknown)[];
+    /** Custom error handler, replaces framework's default Koa error handling logic */
+    errorHandler?: ((err: Error) => void) | null;
+}
+/**
+ * Logger configuration
+ *
+ * Complete configuration for the Pino logging library. The framework has three built-in log instances:
+ * - appLogName: application log, records business output
+ * - coreLogName: core log, records framework internal operations
+ * - errorLogName: error log, only records error/fatal
+ */
+export interface LoggerConfig {
+    /** Log file storage directory, defaults to appUserData/logs if not set */
+    dir?: string;
+    /** Minimum log level, logs below this level will be ignored */
+    level: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal' | string;
+    /** Whether to enable pino-pretty output (recommended for development only) */
+    prettyPrint?: boolean;
+    /** Timestamp date format (e.g. 'yyyy-MM-dd hh:mm:ss') */
+    dateFormat?: string;
+    /** Application log filename (e.g. app.log) */
+    appLogName: string;
+    /** Core log filename (e.g. core.log) */
+    coreLogName: string;
+    /** Error log filename (e.g. error.log) */
+    errorLogName: string;
+    /** Log rotation period: 'daily' (every day) or 'hourly' (every hour) */
+    rotator: 'daily' | 'hourly' | string;
+    /** Field paths to redact (Pino redact feature, e.g. ['password', 'token']) */
+    redact?: string[];
+    /** Redaction replacement value, can be a fixed string or custom replacement function */
+    redactCensor?: string | ((value: unknown, path: string[]) => unknown);
+    /** Whether logs include timestamps, default true */
+    timestamp?: boolean;
+    /** IANA timezone for log timestamps (file JSON logs), default 'UTC'. Set e.g. 'Asia/Shanghai' to emit local time with offset */
+    timezone?: string;
+    /** Logger name, displayed in log entries */
+    name?: string;
+    /** Maximum size of a single log file, auto-rotates when exceeded (e.g. '10m' for 10MB) */
+    maxSize?: number | string;
+    /** Custom serializers for formatting specific value types (e.g. err, req, res) */
+    serializers?: Record<string, (value: unknown) => unknown>;
+    /** Custom log level mapping (e.g. { verbose: 30 }) */
+    customLevels?: Record<string, number>;
+    /** Object serialization depth limit, prevents circular references or oversized objects from causing performance issues */
+    depthLimit?: number;
+    /** Safe mode: when log write fails, no exception is thrown but silently handled */
+    safe?: boolean;
+    /** Whether to enable logging, false disables all log output */
+    enabled?: boolean;
+}
+/**
+ * Exception handling configuration
+ *
+ * Defines handling strategies when processes exit abnormally.
+ * Exit behavior: true means process exits, false means only log.
+ */
+export interface ExceptionConfig {
+    /** Whether main process exception exits the application. true: exit on main process crash, false: only log error */
+    mainExit: boolean;
+    /** Whether child process (Job) abnormal exit terminates the main process */
+    childExit: boolean;
+    /** Handling strategy for renderer process abnormal exit */
+    rendererExit: boolean;
+}
+/**
+ * Background job (Job) configuration
+ *
+ * Controls global behavior of child process jobs.
+ */
+export interface JobsConfig {
+    /** Whether to log child process communication messages. When true, all IPC messages are logged for debugging */
+    messageLog: boolean;
+}
+/**
+ * Cross-process target configuration
+ *
+ * Defines startup parameters and communication methods for an external process.
+ * Supports child process fork, Go/Python backend process startup, and other scenarios.
+ */
+export interface CrossTargetConfig {
+    /** Target process name identifier (e.g. 'go', 'python') */
+    name: string;
+    /** Whether to enable this cross-process target */
+    enable?: boolean;
+    /** Command line arguments passed to the child process */
+    args?: string[];
+    /** Startup command (e.g. 'go', 'python3'), empty means use script for direct fork */
+    cmd?: string;
+    /** Child process working directory, defaults to project root directory */
+    directory?: string;
+    /** Whether to automatically add .exe extension on Windows */
+    windowsExtname?: boolean;
+    /** Child process stdio configuration (same as child_process.fork stdio option) */
+    stdio?: ('pipe' | 'ignore' | 'inherit' | 'ipc')[];
+    /** Whether to exit the main application when the child process exits */
+    appExit?: boolean;
+    /** Child process listening port (Go/Python HTTP service port) */
+    port?: number;
+    /** Child process service URL (e.g. http://localhost:port) */
+    url?: string;
+}
+/**
+ * Cross-process configuration collection
+ *
+ * Key names are target process identifiers, values are startup parameters for each process.
+ * Supports configuring multiple external processes simultaneously (Go, Python, custom child processes, etc.).
+ */
+export interface CrossConfig {
+    /** Dynamic key names corresponding to each cross-process target configuration */
+    [key: string]: CrossTargetConfig;
+}
+/**
+ * Framework main configuration interface
+ *
+ * Integrates all sub-module configurations, serves as the type definition for the object
+ * exported by config.default.js. Loaded and merged by ConfigLoader at runtime, then
+ * provided to each module.
+ */
+export interface Config {
+    /** Dynamic properties, allows user-defined configuration items */
+    [key: string]: unknown;
+    /** DevTools configuration: true opens DevTools, false closes, or pass OpenDevToolsOptions for fine control */
+    openDevTools: boolean | OpenDevToolsOptions;
+    /** Single instance lock: true allows only one application instance, subsequent launches activate existing window */
+    singleLock: boolean;
+    /** BrowserWindow constructor options, passed directly to Electron BrowserWindow */
+    windowsOption: BrowserWindowConstructorOptions;
+    /** Logger configuration */
+    logger: LoggerConfig;
+    /** Socket.IO service configuration */
+    socketServer: SocketServerConfig;
+    /** HTTP service configuration */
+    httpServer: HttpServerConfig;
+    /** Remote service configuration */
+    remote: RemoteConfig;
+    /** Main window service configuration */
+    mainServer: MainServerConfig;
+    /** Exception handling configuration */
+    exception: ExceptionConfig;
+    /** Background jobs configuration */
+    jobs: JobsConfig;
+    /** Cross-process configuration */
+    cross: CrossConfig;
+}
+/**
+ * Child process job (Job) startup options
+ *
+ * Defines parameters for ChildJob / ChildPoolJob to create child processes.
+ */
+export interface JobChildOptions {
+    /** Job name identifier, used for logging and IPC routing */
+    name: string;
+    /** Child process entry script path (first argument of child_process.fork) */
+    script: string;
+    /** Command line arguments passed to the child process */
+    args?: string[];
+    /** Child process environment variables, merged with process.env */
+    env?: NodeJS.ProcessEnv;
+    /** Child process HTTP service port (e.g. Go/Python child process listening port) */
+    port?: number;
+}
+/**
+ * extend() merge options
+ *
+ * Controls whether deep merging is performed during object merging.
+ */
+export interface ExtendOptions {
+    /** Whether to deep merge. When true, nested objects are recursively merged; when false, shallow overwrite */
+    deep?: boolean;
+}
+/**
+ * Performance timing entry
+ *
+ * Records duration information for each stage in the framework startup process, used for performance analysis.
+ */
+export interface TimingItem {
+    /** Stage name (e.g. 'loadConfig', 'loadController') */
+    name: string;
+    /** Stage start time (ms timestamp) */
+    start: number;
+    /** Stage end time (ms timestamp), undefined when not finished */
+    end: number | undefined;
+    /** Stage duration (ms), undefined when not finished */
+    duration: number | undefined;
+    /** PID of the process executing this stage */
+    pid: number;
+    /** Entry sequence number, indicating the execution order of startup stages */
+    index: number;
+}
+/**
+ * Registry entry
+ *
+ * In bundle mode, the esbuild plugin pre-registers file information to a global variable.
+ * Each entry corresponds to a scanned module file.
+ */
+export interface RegistryEntry {
+    /** Full file path (e.g. 'controller/user.js') */
+    fullpath: string;
+    /** Property path array, converted from file path (e.g. ['user'] or ['admin', 'login']) */
+    properties: string[];
+    /** Lazily loaded module: requires only on access, avoiding initialization order issues */
+    module: unknown;
+}
+/**
+ * FileLoader loading options
+ *
+ * Controls how the file loader scans directories, converts property names, and processes exports.
+ */
+export interface FileLoaderOptions {
+    /**
+     * Property naming style, determines file path to property name conversion rules:
+     * - 'lower': first letter lowercase (used by controllers, e.g. UserController -> userController)
+     * - 'upper': first letter uppercase
+     * - 'camel': camelCase (default)
+     * - function: fully custom conversion logic
+     */
+    caseStyle?: 'lower' | 'upper' | 'camel' | ((filepath: string) => string[]);
+    /** Directory path(s) to scan, can be a single directory or an array of directories */
+    directory: string;
+    /**
+     * Custom initializer for additional processing of file exports.
+     * Accepts the export value and path info, returns the processed value.
+     */
+    initializer?: ((obj: unknown, options: {
+        pathName: string;
+        path: string;
+    }) => unknown) | null;
+    /** Whether to auto-call function-type exports. When true, plain function exports are executed and the return value is used as the final export */
+    call?: boolean;
+    /** Whether to override same-name properties. When true, later-loaded modules with the same name override earlier ones */
+    override?: boolean;
+    /** Injection parameters for auto-called functions */
+    inject?: unknown;
+    /** File match pattern (globby format), only loads matching files */
+    match?: string | string[] | ((name: string) => boolean);
+    /** File ignore pattern, matched files will be skipped */
+    ignore?: string | string[] | ((name: string) => boolean);
+    /**
+     * Pre-registry entry array. In bundle mode, provided by global variable __EE_CONTROLLER_REGISTRY__;
+     * when present, skips filesystem scanning and loads modules directly from the registry
+     */
+    registry?: RegistryEntry[];
+}
+/**
+ * Application metadata
+ *
+ * During configuration file loading, the framework passes this object as a parameter to the
+ * configuration function, allowing config files to dynamically return different configurations
+ * based on environment information.
+ *
+ * @example
+ * ```js
+ * // config.default.js
+ * module.exports = (appInfo) => {
+ *   const config = {};
+ *   config.logger.dir = path.join(appInfo.root, 'logs');
+ *   return config;
+ * };
+ * ```
+ */
+export interface AppInfo {
+    /** Application name */
+    name: string;
+    /** Project root directory */
+    baseDir: string;
+    /** Electron source directory */
+    electronDir: string;
+    /** Runtime environment ('dev' / 'prod' / 'test') */
+    env: string;
+    /** Log and runtime data root directory (usually appUserData) */
+    root: string;
+}
+/**
+ * IPC message data structure
+ *
+ * Standardized message format for communication between main process and renderer process.
+ * Transmitted via socket.io or Electron IPC.
+ */
+export interface MessageData {
+    /** Communication channel identifier (e.g. 'controller/user/info') */
+    channel: string;
+    /** Event name */
+    event: string;
+    /** Message payload data */
+    data: unknown;
+}
+/**
+ * Process exit event data
+ *
+ * Process identification information carried when a child process or renderer process exits abnormally.
+ */
+export interface ProcessExitEventData {
+    /** PID of the exited process, undefined if unavailable */
+    pid: number | undefined;
+}
+/**
+ * Dev frontend config — mirrors ee-bin's DevFrontendConfig
+ *
+ * Used by ee-core to type the dev.frontend section loaded from cmd/bin.js.
+ */
+export interface DevFrontendConfig {
+    /** Process working directory (relative to project root) */
+    directory: string;
+    /** Command to execute */
+    cmd: string;
+    /** Command argument array */
+    args: string[];
+    /** Frontend dev server protocol */
+    protocol: string;
+    /** Frontend dev server hostname */
+    hostname: string;
+    /** Frontend dev server port */
+    port: number;
+    /** Frontend index page filename */
+    indexPath: string;
+    /** Whether to force-refresh the page */
+    force: boolean;
+    /** Whether to execute synchronously */
+    sync: boolean;
+}
+/**
+ * Dev electron config — mirrors ee-bin's DevElectronConfig
+ *
+ * Used by ee-core to type the dev.electron section loaded from cmd/bin.js.
+ */
+export interface DevElectronConfig {
+    /** Process working directory (relative to project root) */
+    directory: string;
+    /** Command to execute */
+    cmd: string;
+    /** Command argument array */
+    args: string[];
+    /** Electron loading page path */
+    loadingPage: string;
+    /** Whether to watch for file changes and auto-restart */
+    watch: boolean;
+    /** Whether to execute synchronously */
+    sync: boolean;
+    /** Debounce delay in watch mode (milliseconds) */
+    delay: number;
+}
+/**
+ * Dev mode config — mirrors ee-bin's DevConfig
+ *
+ * Used by ee-core to type the dev section loaded from cmd/bin.js.
+ */
+export interface DevConfig {
+    frontend: DevFrontendConfig;
+    electron: DevElectronConfig;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cjs/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/cjs/utils/extend.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @module utils/extend
+ * @description Object deep merge utility. Provides extend() function supporting shallow merge
+ * and deep recursive merge, used for framework configuration layer merging
+ * (config.default -> config.local -> config.prod) and other object merging scenarios.
+ *
+ * Deep merge logic:
+ * - When deep=true and both target and source properties are plain objects, recursively merge instead of overwrite
+ * - Non-undefined source properties overwrite target properties (shallow merge or non-plain-object cases)
+ * - Automatically skips __proto__ property, preventing prototype chain pollution attacks
+ * - Automatically skips undefined values, will not set target properties to undefined
+ * - Detects self-references (target === val), preventing infinite recursion loops
+ */
+import type { ExtendOptions } from '../types/index.js';
+/**
+ * Merge object properties
+ *
+ * Merges properties from multiple source objects into the target object, supporting shallow and deep merge.
+ * This is the core implementation for framework configuration layer merging.
+ *
+ * Merge rules:
+ * - Shallow merge (deep=false): source properties directly overwrite target properties
+ * - Deep merge (deep=true): plain objects are recursively merged, non-plain-objects are directly overwritten
+ * - Skip __proto__ property, preventing prototype chain pollution
+ * - Skip undefined values, will not overwrite existing properties with undefined
+ * - Detect self-references (target === val), preventing infinite recursion
+ *
+ * @param deep - Whether to deep merge, can be a boolean or an object with a deep property
+ * @param target - Target object, merge result will be written to this object
+ * @param sources - One or more source objects, merged into target in order
+ * @returns Merged target object
+ *
+ * @example
+ * ```ts
+ * // Shallow merge
+ * extend(false, { a: 1 }, { a: 2, b: 3 }); // { a: 2, b: 3 }
+ *
+ * // Deep merge
+ * extend(true, { a: { x: 1 } }, { a: { y: 2 } }); // { a: { x: 1, y: 2 } }
+ *
+ * // Using options object
+ * extend({ deep: true }, { a: { x: 1 } }, { a: { y: 2 } }); // { a: { x: 1, y: 2 } }
+ * ```
+ */
+export declare function extend<T extends Record<string, unknown>>(deep: boolean | ExtendOptions, target: T, ...sources: Array<Partial<T> | Record<string, unknown> | undefined | null>): T;
+//# sourceMappingURL=extend.d.ts.map

package/dist/cjs/utils/extend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend.d.ts","sourceRoot":"","sources":["../../../src/utils/extend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA+CvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,IAAI,EAAE,OAAO,GAAG,aAAa,EAC7B,MAAM,EAAE,CAAC,EACT,GAAG,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,GACzE,CAAC,CA+BH"}