electron-infra-kit 0.0.2

package/dist/core/ipc/IpcRouter.mjs

@@ -0,0 +1,143 @@
+import {z}from'zod';import {MessageDispatcher}from'../../internal/utils/MessageDispatcher.mjs';import {IpcHandlerError}from'../../infrastructure/errors/index.mjs';import {RateLimiter}from'../../internal/utils/RateLimiter.mjs';import {PerformanceMonitor}from'../../infrastructure/debug/PerformanceMonitor.mjs';// Define the schema for IpcRequest
+// 定义 IpcRequest 的 Schema
+const IpcRequestSchema = z.object({
+    name: z.string({ message: 'Handler name is required' }),
+    payload: z.unknown().optional(),
+});
+class IpcRouter {
+    _api = {};
+    dispatcher;
+    rateLimiter;
+    constructor(options = {}) {
+        this.dispatcher = new MessageDispatcher('IpcRouter', options.logger);
+        this.rateLimiter = new RateLimiter({
+            logger: options.logger,
+            defaultLimit: options.defaultRateLimit,
+        });
+    }
+    /**
+     * Add a single IPC handler
+     * 添加单个IPC处理器
+     * @param handler - IPC handler instance (IPC处理器实例)
+     */
+    addHandler(handler) {
+        this.dispatcher.register(handler.name, handler.callback, handler.schema);
+    }
+    /**
+     * Add multiple IPC handlers
+     * 添加多个IPC处理器
+     * @param handlers - Array of IPC handler instances (IPC处理器实例数组)
+     */
+    addHandlers(handlers) {
+        handlers.forEach((handler) => this.addHandler(handler));
+    }
+    /**
+     * Set rate limit for a specific handler
+     * 为特定处理器设置限流
+     * @param handlerName - Handler name (处理器名称)
+     * @param config - Rate limit configuration (限流配置)
+     */
+    setRateLimit(handlerName, config) {
+        this.rateLimiter.setLimit(handlerName, config);
+    }
+    /**
+     * Remove IPC handler by name
+     * 移除指定名称的IPC处理器
+     * @param name - Handler name (处理器名称)
+     */
+    removeHandler(name) {
+        this.dispatcher.unregister(name);
+    }
+    /**
+     * Trigger callback of specified IPC handler
+     * 触发指定名称的IPC处理器回调
+     * @param data - Object containing handler name and data (包含处理器名称和数据的对象)
+     * @param senderId - Optional sender ID (e.g. window ID) for rate limiting (可选的发送者 ID，用于限流)
+     * @returns Return value of the callback function (回调函数的返回值)
+     */
+    handle(data, senderId) {
+        const perf = PerformanceMonitor.getInstance();
+        const measureId = `ipc-${String(data.name)}-${Date.now()}`;
+        const handleAsync = async () => {
+            try {
+                perf.startMeasure(measureId, 'IPC Call', { handler: String(data.name), senderId });
+                // 0. Rate Limiting Check
+                // 0. 限流检查
+                if (senderId !== undefined) {
+                    const rateLimitKey = `${senderId}:${String(data.name)}`;
+                    const allowed = this.rateLimiter.check(rateLimitKey, String(data.name));
+                    if (!allowed) {
+                        throw new IpcHandlerError(String(data.name), new Error(`Rate limit exceeded for handler "${String(data.name)}"`));
+                    }
+                }
+                // Runtime validation using Zod (Envelope validation)
+                // 使用 Zod 进行运行时校验 (信封校验)
+                const validationResult = IpcRequestSchema.safeParse(data);
+                if (!validationResult.success) {
+                    console.warn('[IpcRouter] Invalid IPC request data:', validationResult.error.format());
+                    throw new IpcHandlerError('validation', new Error(`Invalid IPC request: ${validationResult.error.message}`));
+                }
+                // Payload validation if schema exists
+                // 如果存在 Schema，则进行 Payload 校验
+                const schema = this.dispatcher.getMetadata(data.name);
+                if (schema) {
+                    const payloadResult = schema.safeParse(data.payload);
+                    if (!payloadResult.success) {
+                        console.warn(`[IpcRouter] Invalid payload for handler "${String(data.name)}":`, payloadResult.error.message);
+                        throw new IpcHandlerError(String(data.name), new Error(`Invalid payload: ${payloadResult.error.message}`));
+                    }
+                }
+                // 1. Dependency Injection (inject this._api)
+                // 1. 依赖注入 (注入 this._api)
+                const context = { ...this._api };
+                // 2. Dispatch
+                // 2. 分发
+                const result = await Promise.resolve(this.dispatcher.dispatch(data.name, context, data.payload));
+                perf.endMeasure(measureId, { status: 'success' });
+                return result;
+            }
+            catch (error) {
+                perf.endMeasure(measureId, {
+                    status: 'error',
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                // Error handling
+                // 错误处理
+                if (error instanceof IpcHandlerError) {
+                    throw error;
+                }
+                throw new IpcHandlerError(String(data.name), error);
+            }
+        };
+        return handleAsync();
+    }
+    /**
+     * Inject API (Dependencies)
+     * 注入 API (依赖)
+     * @param name - API Name (API 名称)
+     * @param api - API Instance (API 实例)
+     */
+    addApi(name, api) {
+        this._api[name] = api;
+    }
+    /**
+     * Inject multiple APIs (Batch)
+     * 批量注入 API
+     * @param apis - Object containing API instances (包含 API 实例的对象)
+     */
+    addApis(apis) {
+        Object.entries(apis).forEach(([name, api]) => {
+            this.addApi(name, api);
+        });
+    }
+    /**
+     * Dispose IpcRouter
+     * 释放 IpcRouter
+     */
+    dispose() {
+        this.rateLimiter.stopCleanup();
+        this.rateLimiter.clear();
+        this.dispatcher.clear();
+        this._api = {};
+    }
+}export{IpcRouter as default};//# sourceMappingURL=IpcRouter.mjs.map

package/dist/core/ipc/IpcRouter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IpcRouter.mjs","sources":["../../../src/core/ipc/IpcRouter.ts"],"sourcesContent":["import IpcHandler from './IpcHandler';\nimport { IpcRequest, IpcSchema, IpcDefinition } from './ipc-router.type';\nimport { z } from 'zod';\nimport { MessageDispatcher } from '@/internal/utils/MessageDispatcher';\nimport { ILogger } from '@/infrastructure/logger';\nimport { IpcHandlerError } from '@/infrastructure/errors';\nimport { RateLimiter, RateLimitConfig } from '@/internal/utils/RateLimiter';\nimport { PerformanceMonitor } from '@/infrastructure/debug';\n\n// Define the schema for IpcRequest\n// 定义 IpcRequest 的 Schema\nconst IpcRequestSchema = z.object({\n  name: z.string({ message: 'Handler name is required' }),\n  payload: z.unknown().optional(),\n});\n\nexport default class IpcRouter<\n  Api extends Record<string, any> = Record<string, any>,\n  Schema extends IpcSchema = Record<string, IpcDefinition>,\n> {\n  private _api: Api = {} as Api;\n  private dispatcher: MessageDispatcher<Api>;\n  private rateLimiter: RateLimiter;\n\n  constructor(options: { logger?: ILogger; defaultRateLimit?: RateLimitConfig } = {}) {\n    this.dispatcher = new MessageDispatcher('IpcRouter', options.logger);\n    this.rateLimiter = new RateLimiter({\n      logger: options.logger,\n      defaultLimit: options.defaultRateLimit,\n    });\n  }\n\n  /**\n   * Add a single IPC handler\n   * 添加单个IPC处理器\n   * @param handler - IPC handler instance (IPC处理器实例)\n   */\n  addHandler<K extends keyof Schema>(\n    handler: IpcHandler<Api, Schema[K]['payload'], Schema[K]['response']> & {\n      name: K;\n    }\n  ): void {\n    this.dispatcher.register(handler.name as string, handler.callback, handler.schema);\n  }\n\n  /**\n   * Add multiple IPC handlers\n   * 添加多个IPC处理器\n   * @param handlers - Array of IPC handler instances (IPC处理器实例数组)\n   */\n  addHandlers(handlers: (IpcHandler<Api, any, any> & { name: keyof Schema })[]): void {\n    handlers.forEach((handler) => this.addHandler(handler as any));\n  }\n\n  /**\n   * Set rate limit for a specific handler\n   * 为特定处理器设置限流\n   * @param handlerName - Handler name (处理器名称)\n   * @param config - Rate limit configuration (限流配置)\n   */\n  setRateLimit(handlerName: keyof Schema, config: RateLimitConfig): void {\n    this.rateLimiter.setLimit(handlerName as string, config);\n  }\n\n  /**\n   * Remove IPC handler by name\n   * 移除指定名称的IPC处理器\n   * @param name - Handler name (处理器名称)\n   */\n  removeHandler(name: string): void {\n    this.dispatcher.unregister(name);\n  }\n\n  /**\n   * Trigger callback of specified IPC handler\n   * 触发指定名称的IPC处理器回调\n   * @param data - Object containing handler name and data (包含处理器名称和数据的对象)\n   * @param senderId - Optional sender ID (e.g. window ID) for rate limiting (可选的发送者 ID，用于限流)\n   * @returns Return value of the callback function (回调函数的返回值)\n   */\n  handle<K extends keyof Schema>(\n    data: IpcRequest<Schema[K]['payload']> & { name: K },\n    senderId?: number | string\n  ): Promise<Schema[K]['response']> {\n    const perf = PerformanceMonitor.getInstance();\n    const measureId = `ipc-${String(data.name)}-${Date.now()}`;\n\n    const handleAsync = async (): Promise<Schema[K]['response']> => {\n      try {\n        perf.startMeasure(measureId, 'IPC Call', { handler: String(data.name), senderId });\n\n        // 0. Rate Limiting Check\n        // 0. 限流检查\n        if (senderId !== undefined) {\n          const rateLimitKey = `${senderId}:${String(data.name)}`;\n          const allowed = this.rateLimiter.check(rateLimitKey, String(data.name));\n          if (!allowed) {\n            throw new IpcHandlerError(\n              String(data.name),\n              new Error(`Rate limit exceeded for handler \"${String(data.name)}\"`)\n            );\n          }\n        }\n\n        // Runtime validation using Zod (Envelope validation)\n        // 使用 Zod 进行运行时校验 (信封校验)\n        const validationResult = IpcRequestSchema.safeParse(data);\n\n        if (!validationResult.success) {\n          console.warn('[IpcRouter] Invalid IPC request data:', validationResult.error.format());\n          throw new IpcHandlerError(\n            'validation',\n            new Error(`Invalid IPC request: ${validationResult.error.message}`)\n          );\n        }\n\n        // Payload validation if schema exists\n        // 如果存在 Schema，则进行 Payload 校验\n        const schema = this.dispatcher.getMetadata(data.name as string) as\n          | z.ZodType<any>\n          | undefined;\n        if (schema) {\n          const payloadResult = schema.safeParse(data.payload);\n          if (!payloadResult.success) {\n            console.warn(\n              `[IpcRouter] Invalid payload for handler \"${String(data.name)}\":`,\n              payloadResult.error.message\n            );\n            throw new IpcHandlerError(\n              String(data.name),\n              new Error(`Invalid payload: ${payloadResult.error.message}`)\n            );\n          }\n        }\n\n        // 1. Dependency Injection (inject this._api)\n        // 1. 依赖注入 (注入 this._api)\n        const context = { ...this._api };\n\n        // 2. Dispatch\n        // 2. 分发\n        const result = await Promise.resolve(\n          this.dispatcher.dispatch(data.name as string, context, data.payload)\n        );\n\n        perf.endMeasure(measureId, { status: 'success' });\n        return result as Schema[K]['response'];\n      } catch (error: any) {\n        perf.endMeasure(measureId, {\n          status: 'error',\n          error: error instanceof Error ? error.message : String(error),\n        });\n\n        // Error handling\n        // 错误处理\n        if (error instanceof IpcHandlerError) {\n          throw error;\n        }\n        throw new IpcHandlerError(String(data.name), error);\n      }\n    };\n\n    return handleAsync();\n  }\n\n  /**\n   * Inject API (Dependencies)\n   * 注入 API (依赖)\n   * @param name - API Name (API 名称)\n   * @param api - API Instance (API 实例)\n   */\n  addApi(name: keyof Api, api: any): void {\n    this._api[name] = api;\n  }\n\n  /**\n   * Inject multiple APIs (Batch)\n   * 批量注入 API\n   * @param apis - Object containing API instances (包含 API 实例的对象)\n   */\n  addApis(apis: Partial<Api>): void {\n    Object.entries(apis).forEach(([name, api]) => {\n      this.addApi(name as keyof Api, api);\n    });\n  }\n\n  /**\n   * Dispose IpcRouter\n   * 释放 IpcRouter\n   */\n  dispose(): void {\n    this.rateLimiter.stopCleanup();\n    this.rateLimiter.clear();\n    this.dispatcher.clear();\n    this._api = {} as Api;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/core/ipc/index.d.ts

@@ -0,0 +1,3 @@
+export { default as IpcRouter } from './IpcRouter';
+export { default as IpcHandler } from './IpcHandler';
+export * from './ipc-router.type';

package/dist/core/ipc/index.js

@@ -0,0 +1 @@
+'use strict';var IpcRouter=require('./IpcRouter.js'),IpcHandler=require('./IpcHandler.js');exports.IpcRouter=IpcRouter;exports.IpcHandler=IpcHandler;//# sourceMappingURL=index.js.map

package/dist/core/ipc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/core/ipc/index.mjs

@@ -0,0 +1 @@
+export{default as IpcRouter}from'./IpcRouter.mjs';export{default as IpcHandler}from'./IpcHandler.mjs';//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/core/ipc/ipc-router.type.d.ts

@@ -0,0 +1,73 @@
+/**
+ * IPC Request Interface
+ * IPC 请求接口
+ *
+ * @template T - Payload type (载荷类型)
+ */
+export interface IpcRequest<T = any> {
+    /**
+     * Handler name
+     * 处理器名称
+     */
+    name: string;
+    /**
+     * Request payload
+     * 请求载荷
+     */
+    payload?: T;
+}
+/**
+ * IPC Handler Callback Interface
+ * IPC 处理器回调接口
+ *
+ * @template Context - Context/API type (上下文/API 类型)
+ * @template T - Input data type (输入数据类型)
+ * @template R - Return value type (返回值类型)
+ */
+export interface IpcHandlerCallback<Context = Record<string, any>, T = any, R = any> {
+    /**
+     * Callback function
+     * 回调函数
+     * @param api - API object exposed to the handler (暴露给处理器的 API 对象)
+     * @param data - Input data (输入数据)
+     * @returns Result of the operation (操作结果)
+     */
+    (api: Context, data: T): R;
+}
+/**
+ * IPC Handler Data Interface
+ * IPC 处理器数据接口
+ *
+ * @template T - Data payload type (数据载荷类型)
+ */
+export interface IpcHandlerData<T = any> {
+    /**
+     * Handler name
+     * 处理器名称
+     */
+    name: string;
+    /**
+     * Data payload
+     * 数据载荷
+     */
+    data?: T;
+}
+/**
+ * IPC Definition Interface
+ * IPC 定义接口
+ *
+ * @template Payload - Request payload type (请求载荷类型)
+ * @template Response - Response data type (响应数据类型)
+ */
+export interface IpcDefinition<Payload = any, Response = any> {
+    payload: Payload;
+    response: Response;
+}
+/**
+ * IPC Schema Type
+ * IPC 架构类型
+ *
+ * Mapping of handler names to their definitions
+ * 处理器名称到定义的映射
+ */
+export type IpcSchema = Record<string, IpcDefinition>;

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

@@ -0,0 +1,65 @@
+import { ILogger } from '@/infrastructure/logger';
+import type { IPCEventHandler, IPCHandleHandler, IIpcTransport } from './ipc.type';
+/**
+ * @internal This class is an internal implementation detail.
+ * Please use `IpcRouter` for application-level IPC communication.
+ */
+export default class IpcTransport implements IIpcTransport {
+    private readonly channels;
+    private readonly handlers;
+    private logger;
+    constructor(logger?: ILogger);
+    /**
+     * Set custom logger
+     * 设置自定义日志实例
+     * @param logger - Logger instance
+     */
+    setLogger(logger: ILogger): void;
+    /**
+     * 注册监听事件 (ipcMain.on)
+     * @param channel - 事件名称
+     * @param cb - 回调函数
+     */
+    on(channel: string, cb?: IPCEventHandler): void;
+    /**
+     * 注册处理事件 (ipcMain.handle)
+     * 注意: 同一个 channel 只能注册一个 handler，重复注册会覆盖之前的 handler
+     * @param channel - 事件名称
+     * @param cb - 回调函数
+     */
+    handle(channel: string, cb?: IPCHandleHandler): void;
+    /**
+     * 移除指定频道的监听器
+     * @param channel - 频道名称
+     * @param cb - 可选，指定要移除的回调函数。如果不传，则移除该频道下所有由 IpcTransport 管理的监听器
+     */
+    removeListener(channel: string, cb?: IPCEventHandler): void;
+    /**
+     * 移除所有监听器
+     * @param channel - 可选，指定频道名称
+     */
+    removeAllListeners(channel?: string): void;
+    /**
+     * 移除处理器
+     * @param channel - 频道名称
+     */
+    removeHandler(channel: string): void;
+    /**
+     * 移除所有处理器
+     */
+    removeAllHandlers(): void;
+    /**
+     * 记录错误信息
+     * @param err - 错误信息
+     */
+    error(err: string): void;
+    /**
+     * 记录普通日志
+     * @param data - 日志信息
+     */
+    log(data: string): void;
+    private logEvent;
+    private logError;
+    private serializeError;
+    private safeStringify;
+}

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

@@ -0,0 +1,229 @@
+'use strict';var electron=require('electron'),ElectronLogger=require('../../../infrastructure/logger/ElectronLogger.js');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.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);
+        electron.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)) {
+            electron.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,
+                };
+            }
+        };
+        electron.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) {
+                electron.ipcMain.removeListener(channel, wrappedCb);
+                channelListeners.delete(cb);
+            }
+        }
+        else {
+            // 移除该频道下所有由本实例管理的监听器
+            for (const wrappedCb of channelListeners.values()) {
+                electron.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)) {
+            electron.ipcMain.removeHandler(channel);
+            this.handlers.delete(channel);
+        }
+    }
+    /**
+     * 移除所有处理器
+     */
+    removeAllHandlers() {
+        for (const channel of this.handlers) {
+            electron.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]';
+        }
+    }
+}module.exports=IpcTransport;//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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","ipcMain"],"mappings":"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"}