electron-infra-kit 0.0.2

package/dist/core/ipc/transport/index.mjs

@@ -0,0 +1,229 @@
+import {ipcMain}from'electron';import {ElectronLogger}from'../../../infrastructure/logger/ElectronLogger.mjs';const emptyFunc = () => { };
+/**
+ * @internal This class is an internal implementation detail.
+ * Please use `IpcRouter` for application-level IPC communication.
+ */
+class IpcTransport {
+    // 存储所有频道的回调函数 (用于清理)
+    // Map<channel, Map<originalCallback, wrappedCallback>>
+    channels = new Map();
+    handlers = new Set();
+    // 日志实例
+    logger;
+    constructor(logger) {
+        this.logger = logger || new ElectronLogger({ appName: 'IpcTransport' });
+    }
+    /**
+     * Set custom logger
+     * 设置自定义日志实例
+     * @param logger - Logger instance
+     */
+    setLogger(logger) {
+        this.logger = logger;
+    }
+    /**
+     * 注册监听事件 (ipcMain.on)
+     * @param channel - 事件名称
+     * @param cb - 回调函数
+     */
+    on(channel, cb = emptyFunc) {
+        // 包装回调函数以添加日志和错误处理
+        const wrappedCb = async (event, ...args) => {
+            try {
+                this.logEvent(channel, 'on', args);
+                await cb(event, ...args);
+            }
+            catch (error) {
+                this.logError(channel, 'on', error);
+                // 尝试回传错误给发送者
+                if (!event.sender.isDestroyed()) {
+                    event.sender.send(`${channel}:error`, this.serializeError(error));
+                }
+            }
+        };
+        // 存储回调引用
+        if (!this.channels.has(channel)) {
+            this.channels.set(channel, new Map());
+        }
+        this.channels.get(channel).set(cb, wrappedCb);
+        ipcMain.on(channel, wrappedCb);
+    }
+    /**
+     * 注册处理事件 (ipcMain.handle)
+     * 注意: 同一个 channel 只能注册一个 handler，重复注册会覆盖之前的 handler
+     * @param channel - 事件名称
+     * @param cb - 回调函数
+     */
+    handle(channel, cb = emptyFunc) {
+        // 确保先移除旧的 handler，防止 electron 抛出 "second handler" 错误
+        if (this.handlers.has(channel)) {
+            ipcMain.removeHandler(channel);
+        }
+        this.handlers.add(channel);
+        // 包装回调函数以添加日志和错误处理
+        const wrappedCb = async (event, ...args) => {
+            try {
+                this.logEvent(channel, 'handle', args);
+                const result = await cb(event, ...args);
+                // Wrap result in standard response
+                // 将结果包装在标准响应中
+                return {
+                    code: 0,
+                    message: 'success',
+                    data: result,
+                };
+            }
+            catch (error) {
+                this.logError(channel, 'handle', error);
+                // Enhanced error handling with StandardError support
+                // 增强的错误处理，支持 StandardError
+                const isDevelopment = process.env.NODE_ENV === 'development';
+                // Check if it's a StandardError
+                if (error && typeof error === 'object' && 'code' in error && 'category' in error) {
+                    return {
+                        code: error.code,
+                        message: error.message,
+                        data: null,
+                        category: error.category,
+                        details: error.details,
+                        stack: isDevelopment ? error.stack : undefined,
+                    };
+                }
+                // Return standard error response for regular errors
+                // 为常规错误返回标准错误响应
+                return {
+                    code: error.code || 500,
+                    message: error instanceof Error ? error.message : String(error),
+                    data: null,
+                    stack: isDevelopment && error instanceof Error ? error.stack : undefined,
+                };
+            }
+        };
+        ipcMain.handle(channel, wrappedCb);
+    }
+    /**
+     * 移除指定频道的监听器
+     * @param channel - 频道名称
+     * @param cb - 可选，指定要移除的回调函数。如果不传，则移除该频道下所有由 IpcTransport 管理的监听器
+     */
+    removeListener(channel, cb) {
+        const channelListeners = this.channels.get(channel);
+        if (!channelListeners)
+            return;
+        if (cb) {
+            // 移除特定回调
+            const wrappedCb = channelListeners.get(cb);
+            if (wrappedCb) {
+                ipcMain.removeListener(channel, wrappedCb);
+                channelListeners.delete(cb);
+            }
+        }
+        else {
+            // 移除该频道下所有由本实例管理的监听器
+            for (const wrappedCb of channelListeners.values()) {
+                ipcMain.removeListener(channel, wrappedCb);
+            }
+            channelListeners.clear();
+        }
+        if (channelListeners.size === 0) {
+            this.channels.delete(channel);
+        }
+    }
+    /**
+     * 移除所有监听器
+     * @param channel - 可选，指定频道名称
+     */
+    removeAllListeners(channel) {
+        if (channel) {
+            this.removeListener(channel);
+        }
+        else {
+            for (const ch of this.channels.keys()) {
+                this.removeListener(ch);
+            }
+            this.channels.clear();
+        }
+    }
+    /**
+     * 移除处理器
+     * @param channel - 频道名称
+     */
+    removeHandler(channel) {
+        if (this.handlers.has(channel)) {
+            ipcMain.removeHandler(channel);
+            this.handlers.delete(channel);
+        }
+    }
+    /**
+     * 移除所有处理器
+     */
+    removeAllHandlers() {
+        for (const channel of this.handlers) {
+            ipcMain.removeHandler(channel);
+        }
+        this.handlers.clear();
+    }
+    /**
+     * 记录错误信息
+     * @param err - 错误信息
+     */
+    error(err) {
+        this.logger.error(`[IPC System Error]: ${err}`);
+    }
+    /**
+     * 记录普通日志
+     * @param data - 日志信息
+     */
+    log(data) {
+        this.logger.info(`[IPC System Log]: ${data}`);
+    }
+    // 私有辅助方法：格式化日志
+    logEvent(channel, type, args) {
+        try {
+            // 尝试获取 data.name 作为操作名，这是我们约定的通信格式
+            const actionName = args[0]?.name;
+            const argStr = actionName ? `[Action: ${actionName}]` : `[Args: ${this.safeStringify(args)}]`;
+            this.logger.info(`[${type.toUpperCase()}] ${channel} ${argStr}`);
+        }
+        catch {
+            this.logger.info(`[${type.toUpperCase()}] ${channel} [Args parsing failed]`);
+        }
+    }
+    logError(channel, type, error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        const errorStack = error instanceof Error ? error.stack : '';
+        this.logger.error(`[${type.toUpperCase()} ERROR] ${channel}: ${errorMsg}`, errorStack);
+    }
+    serializeError(error) {
+        if (error instanceof Error) {
+            // 获取所有属性，包括不可枚举的
+            const serialized = {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            };
+            // 复制其他自定义属性 (如 code, issues 等)
+            for (const key of Object.getOwnPropertyNames(error)) {
+                if (!['name', 'message', 'stack'].includes(key)) {
+                    serialized[key] = error[key];
+                }
+            }
+            return serialized;
+        }
+        if (typeof error === 'object' && error !== null) {
+            return error;
+        }
+        return {
+            message: String(error),
+            name: 'UnknownError',
+        };
+    }
+    safeStringify(obj) {
+        try {
+            return JSON.stringify(obj);
+        }
+        catch {
+            return '[Circular or Non-serializable]';
+        }
+    }
+}export{IpcTransport as default};//# sourceMappingURL=index.mjs.map

package/dist/core/ipc/transport/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../../src/core/ipc/transport/index.ts"],"sourcesContent":["import { ipcMain, IpcMainEvent, IpcMainInvokeEvent } from 'electron';\nimport { Logger, ILogger } from '@/infrastructure/logger';\nimport type {\n  EmptyFunc,\n  IPCEventHandler,\n  IPCHandleHandler,\n  IpcResponse,\n  IIpcTransport,\n} from './ipc.type';\n\nconst emptyFunc: EmptyFunc = () => {};\n\n/**\n * @internal This class is an internal implementation detail.\n * Please use `IpcRouter` for application-level IPC communication.\n */\nexport default class IpcTransport implements IIpcTransport {\n  // 存储所有频道的回调函数 (用于清理)\n  // Map<channel, Map<originalCallback, wrappedCallback>>\n  private readonly channels: Map<\n    string,\n    Map<IPCEventHandler, (event: IpcMainEvent, ...args: unknown[]) => Promise<void>>\n  > = new Map();\n  private readonly handlers: Set<string> = new Set();\n\n  // 日志实例\n  private logger: ILogger;\n\n  constructor(logger?: ILogger) {\n    this.logger = logger || new Logger({ appName: 'IpcTransport' });\n  }\n\n  /**\n   * Set custom logger\n   * 设置自定义日志实例\n   * @param logger - Logger instance\n   */\n  public setLogger(logger: ILogger): void {\n    this.logger = logger;\n  }\n\n  /**\n   * 注册监听事件 (ipcMain.on)\n   * @param channel - 事件名称\n   * @param cb - 回调函数\n   */\n  public on(channel: string, cb: IPCEventHandler = emptyFunc): void {\n    // 包装回调函数以添加日志和错误处理\n    const wrappedCb = async (event: IpcMainEvent, ...args: unknown[]) => {\n      try {\n        this.logEvent(channel, 'on', args);\n        await cb(event, ...args);\n      } catch (error) {\n        this.logError(channel, 'on', error);\n        // 尝试回传错误给发送者\n        if (!event.sender.isDestroyed()) {\n          event.sender.send(`${channel}:error`, this.serializeError(error));\n        }\n      }\n    };\n\n    // 存储回调引用\n    if (!this.channels.has(channel)) {\n      this.channels.set(channel, new Map());\n    }\n    this.channels.get(channel)!.set(cb, wrappedCb);\n\n    ipcMain.on(channel, wrappedCb);\n  }\n\n  /**\n   * 注册处理事件 (ipcMain.handle)\n   * 注意: 同一个 channel 只能注册一个 handler，重复注册会覆盖之前的 handler\n   * @param channel - 事件名称\n   * @param cb - 回调函数\n   */\n  public handle(channel: string, cb: IPCHandleHandler = emptyFunc): void {\n    // 确保先移除旧的 handler，防止 electron 抛出 \"second handler\" 错误\n    if (this.handlers.has(channel)) {\n      ipcMain.removeHandler(channel);\n    }\n    this.handlers.add(channel);\n\n    // 包装回调函数以添加日志和错误处理\n    const wrappedCb = async (\n      event: IpcMainInvokeEvent,\n      ...args: unknown[]\n    ): Promise<IpcResponse> => {\n      try {\n        this.logEvent(channel, 'handle', args);\n        const result = await cb(event, ...args);\n\n        // Wrap result in standard response\n        // 将结果包装在标准响应中\n        return {\n          code: 0,\n          message: 'success',\n          data: result,\n        };\n      } catch (error) {\n        this.logError(channel, 'handle', error);\n\n        // Enhanced error handling with StandardError support\n        // 增强的错误处理，支持 StandardError\n        const isDevelopment = process.env.NODE_ENV === 'development';\n\n        // Check if it's a StandardError\n        if (error && typeof error === 'object' && 'code' in error && 'category' in error) {\n          return {\n            code: (error as any).code,\n            message: (error as any).message,\n            data: null,\n            category: (error as any).category,\n            details: (error as any).details,\n            stack: isDevelopment ? (error as any).stack : undefined,\n          };\n        }\n\n        // Return standard error response for regular errors\n        // 为常规错误返回标准错误响应\n        return {\n          code: (error as any).code || 500,\n          message: error instanceof Error ? error.message : String(error),\n          data: null,\n          stack: isDevelopment && error instanceof Error ? error.stack : undefined,\n        };\n      }\n    };\n\n    ipcMain.handle(channel, wrappedCb);\n  }\n\n  /**\n   * 移除指定频道的监听器\n   * @param channel - 频道名称\n   * @param cb - 可选，指定要移除的回调函数。如果不传，则移除该频道下所有由 IpcTransport 管理的监听器\n   */\n  public removeListener(channel: string, cb?: IPCEventHandler): void {\n    const channelListeners = this.channels.get(channel);\n    if (!channelListeners) return;\n\n    if (cb) {\n      // 移除特定回调\n      const wrappedCb = channelListeners.get(cb);\n      if (wrappedCb) {\n        ipcMain.removeListener(channel, wrappedCb);\n        channelListeners.delete(cb);\n      }\n    } else {\n      // 移除该频道下所有由本实例管理的监听器\n      for (const wrappedCb of channelListeners.values()) {\n        ipcMain.removeListener(channel, wrappedCb);\n      }\n      channelListeners.clear();\n    }\n\n    if (channelListeners.size === 0) {\n      this.channels.delete(channel);\n    }\n  }\n\n  /**\n   * 移除所有监听器\n   * @param channel - 可选，指定频道名称\n   */\n  public removeAllListeners(channel?: string): void {\n    if (channel) {\n      this.removeListener(channel);\n    } else {\n      for (const ch of this.channels.keys()) {\n        this.removeListener(ch);\n      }\n      this.channels.clear();\n    }\n  }\n\n  /**\n   * 移除处理器\n   * @param channel - 频道名称\n   */\n  public removeHandler(channel: string): void {\n    if (this.handlers.has(channel)) {\n      ipcMain.removeHandler(channel);\n      this.handlers.delete(channel);\n    }\n  }\n\n  /**\n   * 移除所有处理器\n   */\n  public removeAllHandlers(): void {\n    for (const channel of this.handlers) {\n      ipcMain.removeHandler(channel);\n    }\n    this.handlers.clear();\n  }\n\n  /**\n   * 记录错误信息\n   * @param err - 错误信息\n   */\n  public error(err: string): void {\n    this.logger.error(`[IPC System Error]: ${err}`);\n  }\n\n  /**\n   * 记录普通日志\n   * @param data - 日志信息\n   */\n  public log(data: string): void {\n    this.logger.info(`[IPC System Log]: ${data}`);\n  }\n\n  // 私有辅助方法：格式化日志\n  private logEvent(channel: string, type: 'on' | 'handle', args: unknown[]): void {\n    try {\n      // 尝试获取 data.name 作为操作名，这是我们约定的通信格式\n      const actionName = (args[0] as { name?: string })?.name;\n      const argStr = actionName ? `[Action: ${actionName}]` : `[Args: ${this.safeStringify(args)}]`;\n      this.logger.info(`[${type.toUpperCase()}] ${channel} ${argStr}`);\n    } catch {\n      this.logger.info(`[${type.toUpperCase()}] ${channel} [Args parsing failed]`);\n    }\n  }\n\n  private logError(channel: string, type: 'on' | 'handle', error: unknown): void {\n    const errorMsg = error instanceof Error ? error.message : String(error);\n    const errorStack = error instanceof Error ? error.stack : '';\n    this.logger.error(`[${type.toUpperCase()} ERROR] ${channel}: ${errorMsg}`, errorStack);\n  }\n\n  private serializeError(error: unknown): Record<string, unknown> {\n    if (error instanceof Error) {\n      // 获取所有属性，包括不可枚举的\n      const serialized: Record<string, unknown> = {\n        name: error.name,\n        message: error.message,\n        stack: error.stack,\n      };\n\n      // 复制其他自定义属性 (如 code, issues 等)\n      for (const key of Object.getOwnPropertyNames(error)) {\n        if (!['name', 'message', 'stack'].includes(key)) {\n          serialized[key] = (error as any)[key];\n        }\n      }\n      return serialized;\n    }\n\n    if (typeof error === 'object' && error !== null) {\n      return error as Record<string, unknown>;\n    }\n\n    return {\n      message: String(error),\n      name: 'UnknownError',\n    };\n  }\n\n  private safeStringify(obj: unknown): string {\n    try {\n      return JSON.stringify(obj);\n    } catch {\n      return '[Circular or Non-serializable]';\n    }\n  }\n}\n"],"names":["Logger"],"mappings":"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"}

package/dist/core/ipc/transport/ipc.type.d.ts

@@ -0,0 +1,36 @@
+import { IpcMainEvent, IpcMainInvokeEvent } from 'electron';
+import { ErrorCategory } from '@/infrastructure/errors';
+export type EmptyFunc = () => void;
+export type IPCEventHandler = (event: IpcMainEvent, ...args: unknown[]) => void | Promise<void>;
+export type IPCHandleHandler = (event: IpcMainInvokeEvent, ...args: unknown[]) => unknown | Promise<unknown>;
+/**
+ * Standard IPC Response
+ * 标准 IPC 响应
+ */
+export interface IpcResponse<T = unknown> {
+    /** Response code (0 = success, non-zero = error) */
+    code: number;
+    /** Response message */
+    message: string;
+    /** Response data */
+    data: T | null;
+    /** Error category (only present on error) */
+    category?: ErrorCategory;
+    /** Error details (only present on error) */
+    details?: unknown;
+    /** Error stack (only in development mode) */
+    stack?: string;
+}
+/**
+ * Public Interface for IpcTransport
+ * IpcTransport 的公共接口
+ */
+export interface IIpcTransport {
+    setLogger(logger: any): void;
+    on(channel: string, cb: IPCEventHandler): void;
+    handle(channel: string, cb: IPCHandleHandler): void;
+    removeHandler(channel: string): void;
+    removeListener(channel: string): void;
+    removeAllHandlers(): void;
+    removeAllListeners(): void;
+}

package/dist/core/lifecycle/LifecycleManager.d.ts

@@ -0,0 +1,66 @@
+import WindowManager from '@/core/window/WindowManager';
+import IpcRouter from '@/core/ipc/IpcRouter';
+import { MessageBus } from '@/core/message-bus/MessageBus';
+import { WindowManagerConfig } from '@/core/window/window-manager.type';
+/**
+ * Lifecycle Configuration
+ * 生命周期配置
+ */
+export interface LifecycleConfig extends WindowManagerConfig {
+    /**
+     * Whether to automatically start on instantiation (default: false)
+     * 是否在实例化时自动启动 (默认: false)
+     */
+    autoStart?: boolean;
+    /**
+     * Existing IpcRouter instance
+     * 现有的 IpcRouter 实例
+     */
+    ipcRouter?: IpcRouter;
+    /**
+     * Existing WindowManager instance
+     * 现有的 WindowManager 实例
+     */
+    windowManager?: WindowManager;
+    /**
+     * Existing MessageBus instance
+     * 现有的 MessageBus 实例
+     */
+    messageBus?: MessageBus;
+}
+/**
+ * Lifecycle Manager
+ * 生命周期管理器
+ *
+ * Orchestrates the startup and shutdown of the Electron Toolkit modules.
+ * 编排 Electron Toolkit 模块的启动和关闭。
+ */
+export declare class LifecycleManager {
+    windowManager?: WindowManager;
+    ipcRouter?: IpcRouter;
+    messageBus?: MessageBus;
+    private logger;
+    private isStarted;
+    private config;
+    /**
+     * Create LifecycleManager instance
+     * 创建 LifecycleManager 实例
+     * @param config - Configuration object
+     */
+    constructor(config?: LifecycleConfig);
+    /**
+     * Start up all services
+     * 启动所有服务
+     */
+    startup(): Promise<void>;
+    /**
+     * Shut down all services gracefully
+     * 优雅地关闭所有服务
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get initialization status
+     * 获取初始化状态
+     */
+    get started(): boolean;
+}

package/dist/core/lifecycle/LifecycleManager.js

@@ -0,0 +1,140 @@
+'use strict';var WindowManager=require('../window/WindowManager.js'),IpcRouter=require('../ipc/IpcRouter.js'),MessageBus=require('../message-bus/MessageBus.js'),index=require('../../infrastructure/debug/index.js'),ElectronLogger=require('../../infrastructure/logger/ElectronLogger.js');/**
+ * Lifecycle Manager
+ * 生命周期管理器
+ *
+ * Orchestrates the startup and shutdown of the Electron Toolkit modules.
+ * 编排 Electron Toolkit 模块的启动和关闭。
+ */
+class LifecycleManager {
+    windowManager;
+    ipcRouter;
+    messageBus;
+    logger;
+    isStarted = false;
+    config;
+    /**
+     * Create LifecycleManager instance
+     * 创建 LifecycleManager 实例
+     * @param config - Configuration object
+     */
+    constructor(config = {}) {
+        this.config = config;
+        this.logger = config.logger || new ElectronLogger.ElectronLogger({ appName: 'LifecycleManager' });
+        if (config.autoStart) {
+            this.startup().catch((err) => {
+                this.logger.error(`Auto-startup failed: ${err}`);
+            });
+        }
+    }
+    /**
+     * Start up all services
+     * 启动所有服务
+     */
+    async startup() {
+        if (this.isStarted) {
+            this.logger.warn('LifecycleManager already started');
+            return;
+        }
+        try {
+            this.logger.info('Starting up Electron Toolkit services...');
+            // 1. Initialize IpcRouter (Foundation for communication)
+            // 1. 初始化 IpcRouter (通信基础)
+            this.ipcRouter = this.config.ipcRouter || new IpcRouter({ logger: this.config.logger });
+            this.logger.info('IpcRouter initialized');
+            // 2. Initialize MessageBus (Cross-window communication)
+            // 2. 初始化 MessageBus (跨窗口通信)
+            this.messageBus = this.config.messageBus || new MessageBus.MessageBus({ logger: this.config.logger });
+            // 3. Initialize WindowManager (Core window management)
+            // 3. 初始化 WindowManager (核心窗口管理)
+            this.windowManager =
+                this.config.windowManager ||
+                    new WindowManager({
+                        ...this.config,
+                        ipcRouter: this.ipcRouter,
+                        messageBus: this.messageBus,
+                    });
+            // Wait for WindowManager initialization (plugins, etc.)
+            await this.windowManager.ready();
+            this.logger.info('WindowManager initialized');
+            // 4. Connect MessageBus to WindowManager
+            // 4. 连接 MessageBus 到 WindowManager
+            this.messageBus.autoRegisterWindows(this.windowManager);
+            this.logger.info('MessageBus initialized');
+            // 4. Setup Debug Mode if enabled
+            // 4. 如果启用，设置调试模式
+            if (this.config.isDevelopment || process.env.NODE_ENV === 'development') {
+                index.DebugHelper.enableDebugMode();
+                index.DebugHelper.register('windowManager', this.windowManager);
+                index.DebugHelper.register('ipcRouter', this.ipcRouter);
+                index.DebugHelper.register('messageBus', this.messageBus);
+                index.DebugHelper.register('lifecycleManager', this);
+                this.logger.info('Debug mode enabled');
+            }
+            this.isStarted = true;
+            this.logger.info('Startup completed successfully');
+        }
+        catch (error) {
+            this.logger.error(`Startup failed: ${error}`);
+            await this.shutdown(); // Cleanup partial initialization
+            throw error;
+        }
+    }
+    /**
+     * Shut down all services gracefully
+     * 优雅地关闭所有服务
+     */
+    async shutdown() {
+        this.logger.info('Shutting down Electron Toolkit services...');
+        // Shutdown in reverse order of initialization
+        // 按初始化的逆序关闭
+        // 1. Dispose MessageBus
+        if (this.messageBus) {
+            try {
+                this.messageBus.dispose();
+                this.logger.info('MessageBus disposed');
+            }
+            catch (e) {
+                this.logger.warn(`MessageBus dispose error: ${e}`);
+            }
+            this.messageBus = undefined;
+        }
+        // 2. Dispose WindowManager (closes all windows)
+        if (this.windowManager) {
+            try {
+                if (typeof this.windowManager.dispose === 'function') {
+                    await this.windowManager.dispose();
+                    this.logger.info('WindowManager disposed');
+                }
+                else {
+                    // Fallback if dispose is not implemented
+                    this.windowManager.stopCleanupProtection();
+                    // Ideally we should close all windows here, but we rely on WindowManager's dispose
+                }
+            }
+            catch (e) {
+                this.logger.warn(`WindowManager dispose error: ${e}`);
+            }
+            this.windowManager = undefined;
+        }
+        // 3. Dispose IpcRouter
+        if (this.ipcRouter) {
+            try {
+                this.ipcRouter.dispose();
+                this.logger.info('IpcRouter disposed');
+            }
+            catch (e) {
+                this.logger.warn(`IpcRouter dispose error: ${e}`);
+            }
+            this.ipcRouter = undefined;
+        }
+        this.isStarted = false;
+        this.logger.info('Shutdown completed');
+    }
+    /**
+     * Get initialization status
+     * 获取初始化状态
+     */
+    get started() {
+        return this.isStarted;
+    }
+}exports.LifecycleManager=LifecycleManager;//# sourceMappingURL=LifecycleManager.js.map

package/dist/core/lifecycle/LifecycleManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleManager.js","sources":["../../../src/core/lifecycle/LifecycleManager.ts"],"sourcesContent":["import { Logger, ILogger } from '@/infrastructure/logger';\nimport WindowManager from '@/core/window/WindowManager';\nimport IpcRouter from '@/core/ipc/IpcRouter';\nimport { MessageBus } from '@/core/message-bus/MessageBus';\nimport { WindowManagerConfig } from '@/core/window/window-manager.type';\nimport { DebugHelper } from '@/infrastructure/debug';\n\n/**\n * Lifecycle Configuration\n * 生命周期配置\n */\nexport interface LifecycleConfig extends WindowManagerConfig {\n  /**\n   * Whether to automatically start on instantiation (default: false)\n   * 是否在实例化时自动启动 (默认: false)\n   */\n  autoStart?: boolean;\n\n  /**\n   * Existing IpcRouter instance\n   * 现有的 IpcRouter 实例\n   */\n  ipcRouter?: IpcRouter;\n\n  /**\n   * Existing WindowManager instance\n   * 现有的 WindowManager 实例\n   */\n  windowManager?: WindowManager;\n\n  /**\n   * Existing MessageBus instance\n   * 现有的 MessageBus 实例\n   */\n  messageBus?: MessageBus;\n}\n\n/**\n * Lifecycle Manager\n * 生命周期管理器\n *\n * Orchestrates the startup and shutdown of the Electron Toolkit modules.\n * 编排 Electron Toolkit 模块的启动和关闭。\n */\nexport class LifecycleManager {\n  public windowManager?: WindowManager;\n  public ipcRouter?: IpcRouter;\n  public messageBus?: MessageBus;\n  private logger: ILogger;\n  private isStarted = false;\n  private config: LifecycleConfig;\n\n  /**\n   * Create LifecycleManager instance\n   * 创建 LifecycleManager 实例\n   * @param config - Configuration object\n   */\n  constructor(config: LifecycleConfig = {}) {\n    this.config = config;\n    this.logger = config.logger || new Logger({ appName: 'LifecycleManager' });\n\n    if (config.autoStart) {\n      this.startup().catch((err) => {\n        this.logger.error(`Auto-startup failed: ${err}`);\n      });\n    }\n  }\n\n  /**\n   * Start up all services\n   * 启动所有服务\n   */\n  async startup(): Promise<void> {\n    if (this.isStarted) {\n      this.logger.warn('LifecycleManager already started');\n      return;\n    }\n\n    try {\n      this.logger.info('Starting up Electron Toolkit services...');\n\n      // 1. Initialize IpcRouter (Foundation for communication)\n      // 1. 初始化 IpcRouter (通信基础)\n      this.ipcRouter = this.config.ipcRouter || new IpcRouter({ logger: this.config.logger });\n      this.logger.info('IpcRouter initialized');\n\n      // 2. Initialize MessageBus (Cross-window communication)\n      // 2. 初始化 MessageBus (跨窗口通信)\n      this.messageBus = this.config.messageBus || new MessageBus({ logger: this.config.logger });\n\n      // 3. Initialize WindowManager (Core window management)\n      // 3. 初始化 WindowManager (核心窗口管理)\n      this.windowManager =\n        this.config.windowManager ||\n        new WindowManager({\n          ...this.config,\n          ipcRouter: this.ipcRouter,\n          messageBus: this.messageBus,\n        });\n      // Wait for WindowManager initialization (plugins, etc.)\n      await this.windowManager.ready();\n      this.logger.info('WindowManager initialized');\n\n      // 4. Connect MessageBus to WindowManager\n      // 4. 连接 MessageBus 到 WindowManager\n      this.messageBus.autoRegisterWindows(this.windowManager);\n      this.logger.info('MessageBus initialized');\n\n      // 4. Setup Debug Mode if enabled\n      // 4. 如果启用，设置调试模式\n      if (this.config.isDevelopment || process.env.NODE_ENV === 'development') {\n        DebugHelper.enableDebugMode();\n        DebugHelper.register('windowManager', this.windowManager);\n        DebugHelper.register('ipcRouter', this.ipcRouter);\n        DebugHelper.register('messageBus', this.messageBus);\n        DebugHelper.register('lifecycleManager', this);\n        this.logger.info('Debug mode enabled');\n      }\n\n      this.isStarted = true;\n      this.logger.info('Startup completed successfully');\n    } catch (error) {\n      this.logger.error(`Startup failed: ${error}`);\n      await this.shutdown(); // Cleanup partial initialization\n      throw error;\n    }\n  }\n\n  /**\n   * Shut down all services gracefully\n   * 优雅地关闭所有服务\n   */\n  async shutdown(): Promise<void> {\n    this.logger.info('Shutting down Electron Toolkit services...');\n\n    // Shutdown in reverse order of initialization\n    // 按初始化的逆序关闭\n\n    // 1. Dispose MessageBus\n    if (this.messageBus) {\n      try {\n        this.messageBus.dispose();\n        this.logger.info('MessageBus disposed');\n      } catch (e) {\n        this.logger.warn(`MessageBus dispose error: ${e}`);\n      }\n      this.messageBus = undefined;\n    }\n\n    // 2. Dispose WindowManager (closes all windows)\n    if (this.windowManager) {\n      try {\n        if (typeof this.windowManager.dispose === 'function') {\n          await this.windowManager.dispose();\n          this.logger.info('WindowManager disposed');\n        } else {\n          // Fallback if dispose is not implemented\n          this.windowManager.stopCleanupProtection();\n          // Ideally we should close all windows here, but we rely on WindowManager's dispose\n        }\n      } catch (e) {\n        this.logger.warn(`WindowManager dispose error: ${e}`);\n      }\n      this.windowManager = undefined;\n    }\n\n    // 3. Dispose IpcRouter\n    if (this.ipcRouter) {\n      try {\n        this.ipcRouter.dispose();\n        this.logger.info('IpcRouter disposed');\n      } catch (e) {\n        this.logger.warn(`IpcRouter dispose error: ${e}`);\n      }\n      this.ipcRouter = undefined;\n    }\n\n    this.isStarted = false;\n    this.logger.info('Shutdown completed');\n  }\n\n  /**\n   * Get initialization status\n   * 获取初始化状态\n   */\n  public get started(): boolean {\n    return this.isStarted;\n  }\n}\n"],"names":["Logger","MessageBus","DebugHelper"],"mappings":"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"}

package/dist/core/lifecycle/LifecycleManager.mjs

@@ -0,0 +1,140 @@
+import WindowManager from'../window/WindowManager.mjs';import IpcRouter from'../ipc/IpcRouter.mjs';import {MessageBus}from'../message-bus/MessageBus.mjs';import {DebugHelper}from'../../infrastructure/debug/index.mjs';import {ElectronLogger}from'../../infrastructure/logger/ElectronLogger.mjs';/**
+ * Lifecycle Manager
+ * 生命周期管理器
+ *
+ * Orchestrates the startup and shutdown of the Electron Toolkit modules.
+ * 编排 Electron Toolkit 模块的启动和关闭。
+ */
+class LifecycleManager {
+    windowManager;
+    ipcRouter;
+    messageBus;
+    logger;
+    isStarted = false;
+    config;
+    /**
+     * Create LifecycleManager instance
+     * 创建 LifecycleManager 实例
+     * @param config - Configuration object
+     */
+    constructor(config = {}) {
+        this.config = config;
+        this.logger = config.logger || new ElectronLogger({ appName: 'LifecycleManager' });
+        if (config.autoStart) {
+            this.startup().catch((err) => {
+                this.logger.error(`Auto-startup failed: ${err}`);
+            });
+        }
+    }
+    /**
+     * Start up all services
+     * 启动所有服务
+     */
+    async startup() {
+        if (this.isStarted) {
+            this.logger.warn('LifecycleManager already started');
+            return;
+        }
+        try {
+            this.logger.info('Starting up Electron Toolkit services...');
+            // 1. Initialize IpcRouter (Foundation for communication)
+            // 1. 初始化 IpcRouter (通信基础)
+            this.ipcRouter = this.config.ipcRouter || new IpcRouter({ logger: this.config.logger });
+            this.logger.info('IpcRouter initialized');
+            // 2. Initialize MessageBus (Cross-window communication)
+            // 2. 初始化 MessageBus (跨窗口通信)
+            this.messageBus = this.config.messageBus || new MessageBus({ logger: this.config.logger });
+            // 3. Initialize WindowManager (Core window management)
+            // 3. 初始化 WindowManager (核心窗口管理)
+            this.windowManager =
+                this.config.windowManager ||
+                    new WindowManager({
+                        ...this.config,
+                        ipcRouter: this.ipcRouter,
+                        messageBus: this.messageBus,
+                    });
+            // Wait for WindowManager initialization (plugins, etc.)
+            await this.windowManager.ready();
+            this.logger.info('WindowManager initialized');
+            // 4. Connect MessageBus to WindowManager
+            // 4. 连接 MessageBus 到 WindowManager
+            this.messageBus.autoRegisterWindows(this.windowManager);
+            this.logger.info('MessageBus initialized');
+            // 4. Setup Debug Mode if enabled
+            // 4. 如果启用，设置调试模式
+            if (this.config.isDevelopment || process.env.NODE_ENV === 'development') {
+                DebugHelper.enableDebugMode();
+                DebugHelper.register('windowManager', this.windowManager);
+                DebugHelper.register('ipcRouter', this.ipcRouter);
+                DebugHelper.register('messageBus', this.messageBus);
+                DebugHelper.register('lifecycleManager', this);
+                this.logger.info('Debug mode enabled');
+            }
+            this.isStarted = true;
+            this.logger.info('Startup completed successfully');
+        }
+        catch (error) {
+            this.logger.error(`Startup failed: ${error}`);
+            await this.shutdown(); // Cleanup partial initialization
+            throw error;
+        }
+    }
+    /**
+     * Shut down all services gracefully
+     * 优雅地关闭所有服务
+     */
+    async shutdown() {
+        this.logger.info('Shutting down Electron Toolkit services...');
+        // Shutdown in reverse order of initialization
+        // 按初始化的逆序关闭
+        // 1. Dispose MessageBus
+        if (this.messageBus) {
+            try {
+                this.messageBus.dispose();
+                this.logger.info('MessageBus disposed');
+            }
+            catch (e) {
+                this.logger.warn(`MessageBus dispose error: ${e}`);
+            }
+            this.messageBus = undefined;
+        }
+        // 2. Dispose WindowManager (closes all windows)
+        if (this.windowManager) {
+            try {
+                if (typeof this.windowManager.dispose === 'function') {
+                    await this.windowManager.dispose();
+                    this.logger.info('WindowManager disposed');
+                }
+                else {
+                    // Fallback if dispose is not implemented
+                    this.windowManager.stopCleanupProtection();
+                    // Ideally we should close all windows here, but we rely on WindowManager's dispose
+                }
+            }
+            catch (e) {
+                this.logger.warn(`WindowManager dispose error: ${e}`);
+            }
+            this.windowManager = undefined;
+        }
+        // 3. Dispose IpcRouter
+        if (this.ipcRouter) {
+            try {
+                this.ipcRouter.dispose();
+                this.logger.info('IpcRouter disposed');
+            }
+            catch (e) {
+                this.logger.warn(`IpcRouter dispose error: ${e}`);
+            }
+            this.ipcRouter = undefined;
+        }
+        this.isStarted = false;
+        this.logger.info('Shutdown completed');
+    }
+    /**
+     * Get initialization status
+     * 获取初始化状态
+     */
+    get started() {
+        return this.isStarted;
+    }
+}export{LifecycleManager};//# sourceMappingURL=LifecycleManager.mjs.map