electron-infra-kit 0.0.2

package/dist/infrastructure/logger/ElectronLogger.mjs

@@ -0,0 +1,65 @@
+import LoggerService from'electron-log';/**
+ * Default logger implementation using electron-log
+ * 使用 electron-log 的默认日志实现
+ */
+class ElectronLogger {
+    logger;
+    isDev;
+    /**
+     * Constructor for Logger
+     * 日志记录器构造函数
+     * @param options - Logger configuration options
+     */
+    constructor(options = {}) {
+        this.isDev = process.env.NODE_ENV !== 'production';
+        const { appName = 'main', maxSize = 10 * 1024 * 1024, // Default 10MB
+        fileName, fileLevel, consoleLevel, } = options;
+        // Create a logger instance for either 'main' or 'renderer'
+        this.logger = LoggerService.create({ logId: appName });
+        this.logger.scope(appName);
+        // Set log levels with smart defaults based on environment
+        // 根据环境设置日志级别，使用智能默认值
+        const defaultFileLevel = this.isDev ? 'debug' : 'info';
+        const defaultConsoleLevel = this.isDev ? 'debug' : false;
+        this.logger.transports.file.level = fileLevel ?? defaultFileLevel;
+        this.logger.transports.console.level = consoleLevel ?? defaultConsoleLevel;
+        // Optimize log format with date and log level
+        // 优化日志格式，增加日期和日志级别
+        this.logger.transports.file.format = '[{y}-{m}-{d} {h}:{i}:{s}.{ms}] [{level}] {text}';
+        // Set maximum file size (configurable)
+        // 设置最大文件大小（可配置）
+        this.logger.transports.file.maxSize = maxSize;
+        // Set log file name (configurable or default based on environment)
+        // 设置日志文件名（可配置或根据环境使用默认值）
+        this.logger.transports.file.fileName =
+            fileName ?? (this.isDev ? `${appName}_dev.log` : `${appName}.log`);
+    }
+    // Info log
+    info(message, ...args) {
+        this.logger.info(message, ...args);
+    }
+    // Debug log
+    debug(message, ...args) {
+        this.logger.debug(message, ...args);
+    }
+    // Error log
+    error(message, ...args) {
+        this.logger.error(message, ...args);
+    }
+    // Warn log
+    warn(message, ...args) {
+        this.logger.warn(message, ...args);
+    }
+    // Verbose log
+    verbose(message, ...args) {
+        this.logger.verbose(message, ...args);
+    }
+    // Silly log
+    silly(message, ...args) {
+        this.logger.silly(message, ...args);
+    }
+    // Get the logger instance (useful if you need more custom configurations)
+    getLogger() {
+        return this.logger;
+    }
+}export{ElectronLogger};//# sourceMappingURL=ElectronLogger.mjs.map

package/dist/infrastructure/logger/ElectronLogger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronLogger.mjs","sources":["../../../src/infrastructure/logger/ElectronLogger.ts"],"sourcesContent":["import LoggerService from 'electron-log';\nimport { ILogger } from './logger.type';\n\n/**\n * Logger Configuration Options\n * 日志配置选项\n */\nexport interface LoggerOptions {\n  /** Application name for log identification / 应用名称用于日志标识 */\n  appName?: string;\n  /** Maximum log file size in bytes / 最大日志文件大小(字节) */\n  maxSize?: number;\n  /** Custom log file name / 自定义日志文件名 */\n  fileName?: string;\n  /** File log level / 文件日志级别 */\n  fileLevel?: 'debug' | 'info' | 'warn' | 'error' | 'verbose' | 'silly' | false;\n  /** Console log level / 控制台日志级别 */\n  consoleLevel?: 'debug' | 'info' | 'warn' | 'error' | 'verbose' | 'silly' | false;\n}\n\n/**\n * Default logger implementation using electron-log\n * 使用 electron-log 的默认日志实现\n */\nexport class ElectronLogger implements ILogger {\n  private logger: typeof LoggerService;\n  private isDev: boolean;\n\n  /**\n   * Constructor for Logger\n   * 日志记录器构造函数\n   * @param options - Logger configuration options\n   */\n  constructor(options: LoggerOptions = {}) {\n    this.isDev = process.env.NODE_ENV !== 'production';\n\n    const {\n      appName = 'main',\n      maxSize = 10 * 1024 * 1024, // Default 10MB\n      fileName,\n      fileLevel,\n      consoleLevel,\n    } = options;\n\n    // Create a logger instance for either 'main' or 'renderer'\n    this.logger = LoggerService.create({ logId: appName });\n    this.logger.scope(appName);\n\n    // Set log levels with smart defaults based on environment\n    // 根据环境设置日志级别，使用智能默认值\n    const defaultFileLevel = this.isDev ? 'debug' : 'info';\n    const defaultConsoleLevel = this.isDev ? 'debug' : false;\n\n    this.logger.transports.file.level = fileLevel ?? defaultFileLevel;\n    this.logger.transports.console.level = consoleLevel ?? defaultConsoleLevel;\n\n    // Optimize log format with date and log level\n    // 优化日志格式，增加日期和日志级别\n    this.logger.transports.file.format = '[{y}-{m}-{d} {h}:{i}:{s}.{ms}] [{level}] {text}';\n\n    // Set maximum file size (configurable)\n    // 设置最大文件大小（可配置）\n    this.logger.transports.file.maxSize = maxSize;\n\n    // Set log file name (configurable or default based on environment)\n    // 设置日志文件名（可配置或根据环境使用默认值）\n    this.logger.transports.file.fileName =\n      fileName ?? (this.isDev ? `${appName}_dev.log` : `${appName}.log`);\n  }\n\n  // Info log\n  info(message: string, ...args: any[]): void {\n    this.logger.info(message, ...args);\n  }\n\n  // Debug log\n  debug(message: string, ...args: any[]): void {\n    this.logger.debug(message, ...args);\n  }\n\n  // Error log\n  error(message: string, ...args: any[]): void {\n    this.logger.error(message, ...args);\n  }\n\n  // Warn log\n  warn(message: string, ...args: any[]): void {\n    this.logger.warn(message, ...args);\n  }\n\n  // Verbose log\n  verbose(message: string, ...args: any[]): void {\n    this.logger.verbose(message, ...args);\n  }\n\n  // Silly log\n  silly(message: string, ...args: any[]): void {\n    this.logger.silly(message, ...args);\n  }\n\n  // Get the logger instance (useful if you need more custom configurations)\n  getLogger(): typeof LoggerService {\n    return this.logger;\n  }\n}\n"],"names":[],"mappings":"wCAoBA;;;AAGG;MACU,cAAc,CAAA;AACjB,IAAA,MAAM;AACN,IAAA,KAAK;AAEb;;;;AAIG;AACH,IAAA,WAAA,CAAY,UAAyB,EAAE,EAAA;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;AAElD,QAAA,MAAM,EACJ,OAAO,GAAG,MAAM,EAChB,OAAO,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;AAC1B,QAAA,QAAQ,EACR,SAAS,EACT,YAAY,GACb,GAAG,OAAO;;AAGX,QAAA,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACtD,QAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;;;AAI1B,QAAA,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,GAAG,OAAO,GAAG,MAAM;AACtD,QAAA,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAK,GAAG,OAAO,GAAG,KAAK;AAExD,QAAA,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,IAAI,gBAAgB;AACjE,QAAA,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,GAAG,YAAY,IAAI,mBAAmB;;;QAI1E,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,iDAAiD;;;QAItF,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO;;;AAI7C,QAAA,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ;AAClC,YAAA,QAAQ,KAAK,IAAI,CAAC,KAAK,GAAG,CAAA,EAAG,OAAO,CAAA,QAAA,CAAU,GAAG,GAAG,OAAO,CAAA,IAAA,CAAM,CAAC;IACtE;;AAGA,IAAA,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW,EAAA;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IACpC;;AAGA,IAAA,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW,EAAA;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IACrC;;AAGA,IAAA,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW,EAAA;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IACrC;;AAGA,IAAA,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW,EAAA;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IACpC;;AAGA,IAAA,OAAO,CAAC,OAAe,EAAE,GAAG,IAAW,EAAA;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IACvC;;AAGA,IAAA,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW,EAAA;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IACrC;;IAGA,SAAS,GAAA;QACP,OAAO,IAAI,CAAC,MAAM;IACpB;AACD"}

package/dist/infrastructure/logger/index.d.ts

@@ -0,0 +1,2 @@
+export { ElectronLogger as Logger, type LoggerOptions } from './ElectronLogger';
+export type { ILogger } from './logger.type';

package/dist/infrastructure/logger/logger.type.d.ts

@@ -0,0 +1,8 @@
+export interface ILogger {
+    info(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    verbose?(message: string, ...args: any[]): void;
+    silly?(message: string, ...args: any[]): void;
+}

package/dist/internal/types/BrandedTypes.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Brand Types for Type Safety
+ * 品牌类型用于增强类型安全
+ */
+/**
+ * Window ID - Branded string type
+ * 窗口 ID - 品牌字符串类型
+ */
+export type WindowId = string & {
+    readonly __brand: 'WindowId';
+};
+/**
+ * Event Name - Branded string type
+ * 事件名称 - 品牌字符串类型
+ */
+export type EventName = string & {
+    readonly __brand: 'EventName';
+};
+/**
+ * Channel Name - Branded string type
+ * 频道名称 - 品牌字符串类型
+ */
+export type ChannelName = string & {
+    readonly __brand: 'ChannelName';
+};
+/**
+ * Handler Name - Branded string type
+ * 处理器名称 - 品牌字符串类型
+ */
+export type HandlerName = string & {
+    readonly __brand: 'HandlerName';
+};
+/**
+ * Field Key - Branded string type for MessageBus fields
+ * 字段键 - MessageBus 字段的品牌字符串类型
+ */
+export type FieldKey = string & {
+    readonly __brand: 'FieldKey';
+};
+/**
+ * Create a WindowId from a string with validation
+ * 从字符串创建 WindowId (带验证)
+ */
+export declare function createWindowId(id: string): WindowId;
+/**
+ * Create an EventName from a string with validation
+ * 从字符串创建 EventName (带验证)
+ */
+export declare function createEventName(name: string): EventName;
+/**
+ * Create a ChannelName from a string with validation
+ * 从字符串创建 ChannelName (带验证)
+ */
+export declare function createChannelName(name: string): ChannelName;
+/**
+ * Create a HandlerName from a string with validation
+ * 从字符串创建 HandlerName (带验证)
+ */
+export declare function createHandlerName(name: string): HandlerName;
+/**
+ * Create a FieldKey from a string with validation
+ * 从字符串创建 FieldKey (带验证)
+ */
+export declare function createFieldKey(key: string): FieldKey;

package/dist/internal/types/BrandedTypes.js

@@ -0,0 +1,54 @@
+'use strict';/**
+ * Brand Types for Type Safety
+ * 品牌类型用于增强类型安全
+ */
+/**
+ * Create a WindowId from a string with validation
+ * 从字符串创建 WindowId (带验证)
+ */
+function createWindowId(id) {
+    if (!id || typeof id !== 'string') {
+        throw new Error('Invalid window ID: must be a non-empty string');
+    }
+    return id;
+}
+/**
+ * Create an EventName from a string with validation
+ * 从字符串创建 EventName (带验证)
+ */
+function createEventName(name) {
+    if (!name || typeof name !== 'string') {
+        throw new Error('Invalid event name: must be a non-empty string');
+    }
+    return name;
+}
+/**
+ * Create a ChannelName from a string with validation
+ * 从字符串创建 ChannelName (带验证)
+ */
+function createChannelName(name) {
+    if (!name || typeof name !== 'string') {
+        throw new Error('Invalid channel name: must be a non-empty string');
+    }
+    return name;
+}
+/**
+ * Create a HandlerName from a string with validation
+ * 从字符串创建 HandlerName (带验证)
+ */
+function createHandlerName(name) {
+    if (!name || typeof name !== 'string') {
+        throw new Error('Invalid handler name: must be a non-empty string');
+    }
+    return name;
+}
+/**
+ * Create a FieldKey from a string with validation
+ * 从字符串创建 FieldKey (带验证)
+ */
+function createFieldKey(key) {
+    if (!key || typeof key !== 'string') {
+        throw new Error('Invalid field key: must be a non-empty string');
+    }
+    return key;
+}exports.createChannelName=createChannelName;exports.createEventName=createEventName;exports.createFieldKey=createFieldKey;exports.createHandlerName=createHandlerName;exports.createWindowId=createWindowId;//# sourceMappingURL=BrandedTypes.js.map

package/dist/internal/types/BrandedTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandedTypes.js","sources":["../../../src/internal/types/BrandedTypes.ts"],"sourcesContent":["/**\n * Brand Types for Type Safety\n * 品牌类型用于增强类型安全\n */\n\n/**\n * Window ID - Branded string type\n * 窗口 ID - 品牌字符串类型\n */\nexport type WindowId = string & { readonly __brand: 'WindowId' };\n\n/**\n * Event Name - Branded string type\n * 事件名称 - 品牌字符串类型\n */\nexport type EventName = string & { readonly __brand: 'EventName' };\n\n/**\n * Channel Name - Branded string type\n * 频道名称 - 品牌字符串类型\n */\nexport type ChannelName = string & { readonly __brand: 'ChannelName' };\n\n/**\n * Handler Name - Branded string type\n * 处理器名称 - 品牌字符串类型\n */\nexport type HandlerName = string & { readonly __brand: 'HandlerName' };\n\n/**\n * Field Key - Branded string type for MessageBus fields\n * 字段键 - MessageBus 字段的品牌字符串类型\n */\nexport type FieldKey = string & { readonly __brand: 'FieldKey' };\n\n/**\n * Create a WindowId from a string with validation\n * 从字符串创建 WindowId (带验证)\n */\nexport function createWindowId(id: string): WindowId {\n  if (!id || typeof id !== 'string') {\n    throw new Error('Invalid window ID: must be a non-empty string');\n  }\n  return id as WindowId;\n}\n\n/**\n * Create an EventName from a string with validation\n * 从字符串创建 EventName (带验证)\n */\nexport function createEventName(name: string): EventName {\n  if (!name || typeof name !== 'string') {\n    throw new Error('Invalid event name: must be a non-empty string');\n  }\n  return name as EventName;\n}\n\n/**\n * Create a ChannelName from a string with validation\n * 从字符串创建 ChannelName (带验证)\n */\nexport function createChannelName(name: string): ChannelName {\n  if (!name || typeof name !== 'string') {\n    throw new Error('Invalid channel name: must be a non-empty string');\n  }\n  return name as ChannelName;\n}\n\n/**\n * Create a HandlerName from a string with validation\n * 从字符串创建 HandlerName (带验证)\n */\nexport function createHandlerName(name: string): HandlerName {\n  if (!name || typeof name !== 'string') {\n    throw new Error('Invalid handler name: must be a non-empty string');\n  }\n  return name as HandlerName;\n}\n\n/**\n * Create a FieldKey from a string with validation\n * 从字符串创建 FieldKey (带验证)\n */\nexport function createFieldKey(key: string): FieldKey {\n  if (!key || typeof key !== 'string') {\n    throw new Error('Invalid field key: must be a non-empty string');\n  }\n  return key as FieldKey;\n}\n"],"names":[],"mappings":"aAAA;;;AAGG;AAgCH;;;AAGG;AACG,SAAU,cAAc,CAAC,EAAU,EAAA;IACvC,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE;AACjC,QAAA,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC;IAClE;AACA,IAAA,OAAO,EAAc;AACvB;AAEA;;;AAGG;AACG,SAAU,eAAe,CAAC,IAAY,EAAA;IAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AACrC,QAAA,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC;IACnE;AACA,IAAA,OAAO,IAAiB;AAC1B;AAEA;;;AAGG;AACG,SAAU,iBAAiB,CAAC,IAAY,EAAA;IAC5C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AACrC,QAAA,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC;IACrE;AACA,IAAA,OAAO,IAAmB;AAC5B;AAEA;;;AAGG;AACG,SAAU,iBAAiB,CAAC,IAAY,EAAA;IAC5C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AACrC,QAAA,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC;IACrE;AACA,IAAA,OAAO,IAAmB;AAC5B;AAEA;;;AAGG;AACG,SAAU,cAAc,CAAC,GAAW,EAAA;IACxC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AACnC,QAAA,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC;IAClE;AACA,IAAA,OAAO,GAAe;AACxB"}

package/dist/internal/types/BrandedTypes.mjs

@@ -0,0 +1,54 @@
+/**
+ * Brand Types for Type Safety
+ * 品牌类型用于增强类型安全
+ */
+/**
+ * Create a WindowId from a string with validation
+ * 从字符串创建 WindowId (带验证)
+ */
+function createWindowId(id) {
+    if (!id || typeof id !== 'string') {
+        throw new Error('Invalid window ID: must be a non-empty string');
+    }
+    return id;
+}
+/**
+ * Create an EventName from a string with validation
+ * 从字符串创建 EventName (带验证)
+ */
+function createEventName(name) {
+    if (!name || typeof name !== 'string') {
+        throw new Error('Invalid event name: must be a non-empty string');
+    }
+    return name;
+}
+/**
+ * Create a ChannelName from a string with validation
+ * 从字符串创建 ChannelName (带验证)
+ */
+function createChannelName(name) {
+    if (!name || typeof name !== 'string') {
+        throw new Error('Invalid channel name: must be a non-empty string');
+    }
+    return name;
+}
+/**
+ * Create a HandlerName from a string with validation
+ * 从字符串创建 HandlerName (带验证)
+ */
+function createHandlerName(name) {
+    if (!name || typeof name !== 'string') {
+        throw new Error('Invalid handler name: must be a non-empty string');
+    }
+    return name;
+}
+/**
+ * Create a FieldKey from a string with validation
+ * 从字符串创建 FieldKey (带验证)
+ */
+function createFieldKey(key) {
+    if (!key || typeof key !== 'string') {
+        throw new Error('Invalid field key: must be a non-empty string');
+    }
+    return key;
+}export{createChannelName,createEventName,createFieldKey,createHandlerName,createWindowId};//# sourceMappingURL=BrandedTypes.mjs.map

package/dist/internal/types/BrandedTypes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandedTypes.mjs","sources":["../../../src/internal/types/BrandedTypes.ts"],"sourcesContent":["/**\n * Brand Types for Type Safety\n * 品牌类型用于增强类型安全\n */\n\n/**\n * Window ID - Branded string type\n * 窗口 ID - 品牌字符串类型\n */\nexport type WindowId = string & { readonly __brand: 'WindowId' };\n\n/**\n * Event Name - Branded string type\n * 事件名称 - 品牌字符串类型\n */\nexport type EventName = string & { readonly __brand: 'EventName' };\n\n/**\n * Channel Name - Branded string type\n * 频道名称 - 品牌字符串类型\n */\nexport type ChannelName = string & { readonly __brand: 'ChannelName' };\n\n/**\n * Handler Name - Branded string type\n * 处理器名称 - 品牌字符串类型\n */\nexport type HandlerName = string & { readonly __brand: 'HandlerName' };\n\n/**\n * Field Key - Branded string type for MessageBus fields\n * 字段键 - MessageBus 字段的品牌字符串类型\n */\nexport type FieldKey = string & { readonly __brand: 'FieldKey' };\n\n/**\n * Create a WindowId from a string with validation\n * 从字符串创建 WindowId (带验证)\n */\nexport function createWindowId(id: string): WindowId {\n  if (!id || typeof id !== 'string') {\n    throw new Error('Invalid window ID: must be a non-empty string');\n  }\n  return id as WindowId;\n}\n\n/**\n * Create an EventName from a string with validation\n * 从字符串创建 EventName (带验证)\n */\nexport function createEventName(name: string): EventName {\n  if (!name || typeof name !== 'string') {\n    throw new Error('Invalid event name: must be a non-empty string');\n  }\n  return name as EventName;\n}\n\n/**\n * Create a ChannelName from a string with validation\n * 从字符串创建 ChannelName (带验证)\n */\nexport function createChannelName(name: string): ChannelName {\n  if (!name || typeof name !== 'string') {\n    throw new Error('Invalid channel name: must be a non-empty string');\n  }\n  return name as ChannelName;\n}\n\n/**\n * Create a HandlerName from a string with validation\n * 从字符串创建 HandlerName (带验证)\n */\nexport function createHandlerName(name: string): HandlerName {\n  if (!name || typeof name !== 'string') {\n    throw new Error('Invalid handler name: must be a non-empty string');\n  }\n  return name as HandlerName;\n}\n\n/**\n * Create a FieldKey from a string with validation\n * 从字符串创建 FieldKey (带验证)\n */\nexport function createFieldKey(key: string): FieldKey {\n  if (!key || typeof key !== 'string') {\n    throw new Error('Invalid field key: must be a non-empty string');\n  }\n  return key as FieldKey;\n}\n"],"names":[],"mappings":"AAAA;;;AAGG;AAgCH;;;AAGG;AACG,SAAU,cAAc,CAAC,EAAU,EAAA;IACvC,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE;AACjC,QAAA,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC;IAClE;AACA,IAAA,OAAO,EAAc;AACvB;AAEA;;;AAGG;AACG,SAAU,eAAe,CAAC,IAAY,EAAA;IAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AACrC,QAAA,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC;IACnE;AACA,IAAA,OAAO,IAAiB;AAC1B;AAEA;;;AAGG;AACG,SAAU,iBAAiB,CAAC,IAAY,EAAA;IAC5C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AACrC,QAAA,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC;IACrE;AACA,IAAA,OAAO,IAAmB;AAC5B;AAEA;;;AAGG;AACG,SAAU,iBAAiB,CAAC,IAAY,EAAA;IAC5C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AACrC,QAAA,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC;IACrE;AACA,IAAA,OAAO,IAAmB;AAC5B;AAEA;;;AAGG;AACG,SAAU,cAAc,CAAC,GAAW,EAAA;IACxC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AACnC,QAAA,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC;IAClE;AACA,IAAA,OAAO,GAAe;AACxB"}

package/dist/internal/types/PerformanceOptions.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Performance Monitoring Options
+ * 性能监控选项
+ */
+export interface StateKeeperOptions {
+    /**
+     * Delay before saving state to disk (in milliseconds)
+     * 保存状态到磁盘前的延迟时间（毫秒）
+     * @default 500
+     */
+    saveDelay?: number;
+    /**
+     * Save strategy: 'debounce' or 'throttle'
+     * 保存策略：'debounce'（防抖）或 'throttle'（节流）
+     * @default 'debounce'
+     */
+    saveStrategy?: 'debounce' | 'throttle';
+    /**
+     * Custom logger instance
+     * 自定义日志实例
+     */
+    logger?: any;
+    /**
+     * Custom state file path
+     * 自定义状态文件路径
+     */
+    stateFilePath?: string;
+}
+/**
+ * MessageBus Subscription Options
+ * MessageBus 订阅选项
+ */
+export interface MessageBusSubscriptionOptions {
+    /**
+     * Filter function to determine if the update should be processed
+     * 过滤函数，用于确定是否应处理更新
+     */
+    filter?: (key: string, value: unknown) => boolean;
+    /**
+     * Specific keys to subscribe to (if not provided, subscribes to all)
+     * 要订阅的特定键（如果未提供，则订阅所有）
+     */
+    keys?: string[];
+    /**
+     * Debounce time in milliseconds (0 = no debounce)
+     * 防抖时间（毫秒）（0 = 不防抖）
+     * @default 0
+     */
+    debounce?: number;
+}
+/**
+ * Performance Monitoring Options
+ * 性能监控选项
+ */
+export interface PerformanceOptions {
+    /**
+     * Enable performance monitoring
+     * 启用性能监控
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Sample rate (0-1, where 1 = 100%)
+     * 采样率（0-1，其中 1 = 100%）
+     * @default 1
+     */
+    sampleRate?: number;
+    /**
+     * Callback for performance metrics
+     * 性能指标回调
+     */
+    onMetric?: (metric: PerformanceMetric) => void;
+}
+/**
+ * Performance Metric
+ * 性能指标
+ */
+export interface PerformanceMetric {
+    /** Metric name */
+    name: string;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Timestamp */
+    timestamp: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}

package/dist/internal/types/branded.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Branded Types for Type Safety
+ * 品牌类型用于增强类型安全
+ *
+ * These are type-only definitions without runtime logic
+ * 这些是纯类型定义，不包含运行时逻辑
+ */
+/**
+ * Window ID - Branded string type
+ * 窗口 ID - 品牌字符串类型
+ */
+export type WindowId = string & {
+    readonly __brand: 'WindowId';
+};
+/**
+ * Event Name - Branded string type
+ * 事件名称 - 品牌字符串类型
+ */
+export type EventName = string & {
+    readonly __brand: 'EventName';
+};
+/**
+ * Channel Name - Branded string type
+ * 频道名称 - 品牌字符串类型
+ */
+export type ChannelName = string & {
+    readonly __brand: 'ChannelName';
+};
+/**
+ * Handler Name - Branded string type
+ * 处理器名称 - 品牌字符串类型
+ */
+export type HandlerName = string & {
+    readonly __brand: 'HandlerName';
+};
+/**
+ * Field Key - Branded string type for MessageBus fields
+ * 字段键 - MessageBus 字段的品牌字符串类型
+ */
+export type FieldKey = string & {
+    readonly __brand: 'FieldKey';
+};

package/dist/internal/utils/MessageDispatcher.d.ts

@@ -0,0 +1,67 @@
+import { ILogger } from '@/infrastructure/logger';
+/**
+ * Handler Callback Type
+ * 处理器回调类型
+ */
+export type HandlerCallback<Context, T = any, R = any> = (context: Context, data: T) => R | Promise<R>;
+/**
+ * Message Dispatcher - Generic event/message dispatching utility
+ * 消息分发器 - 通用的事件/消息分发工具
+ *
+ * Unifies the message dispatching logic across different bridges (MessageBus, IpcRouter).
+ * 统一不同桥接器（MessageBus, IpcRouter）的消息分发逻辑。
+ *
+ * @template Context - The context type passed to handlers (传递给处理器的上下文类型)
+ */
+export declare class MessageDispatcher<Context = any> {
+    private handlers;
+    private logger;
+    private errorHandler?;
+    constructor(name: string, logger?: ILogger, errorHandler?: (error: any, name: string) => any);
+    /**
+     * Register a handler
+     * 注册处理器
+     * @param name - Handler name (处理器名称)
+     * @param handler - Handler function (处理函数)
+     * @param metadata - Optional metadata (e.g., validation schema)
+     */
+    register<T = any, R = any>(name: string, handler: HandlerCallback<Context, T, R>, metadata?: any): void;
+    /**
+     * Unregister a handler
+     * 注销处理器
+     * @param name - Handler name (处理器名称)
+     * @returns True if removed (如果移除成功返回 true)
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get handler metadata
+     * 获取处理器元数据
+     */
+    getMetadata(name: string): any | undefined;
+    /**
+     * Dispatch a message to a handler
+     * 分发消息给处理器
+     * @param name - Handler name (处理器名称)
+     * @param context - Context to pass to handler (传递给处理器的上下文)
+     * @param data - Data to pass to handler (传递给处理器的数据)
+     * @returns Handler result (处理器结果)
+     * @throws Error if handler execution fails (如果处理器执行失败抛出错误)
+     */
+    dispatch<T = any, R = any>(name: string, context: Context, data: T): R | undefined;
+    /**
+     * Check if handler exists
+     * 检查处理器是否存在
+     * @param name - Handler name (处理器名称)
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered handler names
+     * 获取所有注册的处理器名称
+     */
+    getHandlerNames(): string[];
+    /**
+     * Clear all handlers
+     * 清空所有处理器
+     */
+    clear(): void;
+}

package/dist/internal/utils/MessageDispatcher.js

@@ -0,0 +1,96 @@
+'use strict';var ElectronLogger=require('../../infrastructure/logger/ElectronLogger.js');/**
+ * Message Dispatcher - Generic event/message dispatching utility
+ * 消息分发器 - 通用的事件/消息分发工具
+ *
+ * Unifies the message dispatching logic across different bridges (MessageBus, IpcRouter).
+ * 统一不同桥接器（MessageBus, IpcRouter）的消息分发逻辑。
+ *
+ * @template Context - The context type passed to handlers (传递给处理器的上下文类型)
+ */
+class MessageDispatcher {
+    // Store handler along with optional metadata (like validation schema)
+    handlers = new Map();
+    logger;
+    errorHandler;
+    constructor(name, logger, errorHandler) {
+        this.logger = logger || new ElectronLogger.ElectronLogger({ appName: name });
+        this.errorHandler = errorHandler;
+    }
+    /**
+     * Register a handler
+     * 注册处理器
+     * @param name - Handler name (处理器名称)
+     * @param handler - Handler function (处理函数)
+     * @param metadata - Optional metadata (e.g., validation schema)
+     */
+    register(name, handler, metadata) {
+        if (this.handlers.has(name)) {
+            this.logger.warn(`Handler "${name}" is being overwritten / 处理器 "${name}" 被覆盖`);
+        }
+        this.handlers.set(name, { callback: handler, metadata });
+    }
+    /**
+     * Unregister a handler
+     * 注销处理器
+     * @param name - Handler name (处理器名称)
+     * @returns True if removed (如果移除成功返回 true)
+     */
+    unregister(name) {
+        return this.handlers.delete(name);
+    }
+    /**
+     * Get handler metadata
+     * 获取处理器元数据
+     */
+    getMetadata(name) {
+        return this.handlers.get(name)?.metadata;
+    }
+    /**
+     * Dispatch a message to a handler
+     * 分发消息给处理器
+     * @param name - Handler name (处理器名称)
+     * @param context - Context to pass to handler (传递给处理器的上下文)
+     * @param data - Data to pass to handler (传递给处理器的数据)
+     * @returns Handler result (处理器结果)
+     * @throws Error if handler execution fails (如果处理器执行失败抛出错误)
+     */
+    dispatch(name, context, data) {
+        const entry = this.handlers.get(name);
+        if (!entry) {
+            this.logger.warn(`No handler found for "${name}" / 未找到处理器 "${name}"`);
+            return undefined;
+        }
+        try {
+            return entry.callback(context, data);
+        }
+        catch (error) {
+            this.logger.error(`Error in handler "${name}": ${error} / 处理器 "${name}" 执行错误: ${error}`);
+            if (this.errorHandler) {
+                return this.errorHandler(error, name);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Check if handler exists
+     * 检查处理器是否存在
+     * @param name - Handler name (处理器名称)
+     */
+    has(name) {
+        return this.handlers.has(name);
+    }
+    /**
+     * Get all registered handler names
+     * 获取所有注册的处理器名称
+     */
+    getHandlerNames() {
+        return Array.from(this.handlers.keys());
+    }
+    /**
+     * Clear all handlers
+     * 清空所有处理器
+     */
+    clear() {
+        this.handlers.clear();
+    }
+}exports.MessageDispatcher=MessageDispatcher;//# sourceMappingURL=MessageDispatcher.js.map

package/dist/internal/utils/MessageDispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageDispatcher.js","sources":["../../../src/internal/utils/MessageDispatcher.ts"],"sourcesContent":["import { Logger, ILogger } from '@/infrastructure/logger';\n\n/**\n * Handler Callback Type\n * 处理器回调类型\n */\nexport type HandlerCallback<Context, T = any, R = any> = (\n  context: Context,\n  data: T\n) => R | Promise<R>;\n\n/**\n * Message Dispatcher - Generic event/message dispatching utility\n * 消息分发器 - 通用的事件/消息分发工具\n *\n * Unifies the message dispatching logic across different bridges (MessageBus, IpcRouter).\n * 统一不同桥接器（MessageBus, IpcRouter）的消息分发逻辑。\n *\n * @template Context - The context type passed to handlers (传递给处理器的上下文类型)\n */\nexport class MessageDispatcher<Context = any> {\n  // Store handler along with optional metadata (like validation schema)\n  private handlers = new Map<\n    string,\n    {\n      callback: HandlerCallback<Context, any, any>;\n      metadata?: any;\n    }\n  >();\n  private logger: ILogger;\n  private errorHandler?: (error: any, name: string) => any;\n\n  constructor(name: string, logger?: ILogger, errorHandler?: (error: any, name: string) => any) {\n    this.logger = logger || new Logger({ appName: name });\n    this.errorHandler = errorHandler;\n  }\n\n  /**\n   * Register a handler\n   * 注册处理器\n   * @param name - Handler name (处理器名称)\n   * @param handler - Handler function (处理函数)\n   * @param metadata - Optional metadata (e.g., validation schema)\n   */\n  register<T = any, R = any>(\n    name: string,\n    handler: HandlerCallback<Context, T, R>,\n    metadata?: any\n  ): void {\n    if (this.handlers.has(name)) {\n      this.logger.warn(`Handler \"${name}\" is being overwritten / 处理器 \"${name}\" 被覆盖`);\n    }\n    this.handlers.set(name, { callback: handler, metadata });\n  }\n\n  /**\n   * Unregister a handler\n   * 注销处理器\n   * @param name - Handler name (处理器名称)\n   * @returns True if removed (如果移除成功返回 true)\n   */\n  unregister(name: string): boolean {\n    return this.handlers.delete(name);\n  }\n\n  /**\n   * Get handler metadata\n   * 获取处理器元数据\n   */\n  getMetadata(name: string): any | undefined {\n    return this.handlers.get(name)?.metadata;\n  }\n\n  /**\n   * Dispatch a message to a handler\n   * 分发消息给处理器\n   * @param name - Handler name (处理器名称)\n   * @param context - Context to pass to handler (传递给处理器的上下文)\n   * @param data - Data to pass to handler (传递给处理器的数据)\n   * @returns Handler result (处理器结果)\n   * @throws Error if handler execution fails (如果处理器执行失败抛出错误)\n   */\n  dispatch<T = any, R = any>(name: string, context: Context, data: T): R | undefined {\n    const entry = this.handlers.get(name);\n    if (!entry) {\n      this.logger.warn(`No handler found for \"${name}\" / 未找到处理器 \"${name}\"`);\n      return undefined;\n    }\n\n    try {\n      return entry.callback(context, data);\n    } catch (error) {\n      this.logger.error(\n        `Error in handler \"${name}\": ${error} / 处理器 \"${name}\" 执行错误: ${error}`\n      );\n      if (this.errorHandler) {\n        return this.errorHandler(error, name);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Check if handler exists\n   * 检查处理器是否存在\n   * @param name - Handler name (处理器名称)\n   */\n  has(name: string): boolean {\n    return this.handlers.has(name);\n  }\n\n  /**\n   * Get all registered handler names\n   * 获取所有注册的处理器名称\n   */\n  getHandlerNames(): string[] {\n    return Array.from(this.handlers.keys());\n  }\n\n  /**\n   * Clear all handlers\n   * 清空所有处理器\n   */\n  clear(): void {\n    this.handlers.clear();\n  }\n}\n"],"names":["Logger"],"mappings":"yFAWA;;;;;;;;AAQG;MACU,iBAAiB,CAAA;;AAEpB,IAAA,QAAQ,GAAG,IAAI,GAAG,EAMvB;AACK,IAAA,MAAM;AACN,IAAA,YAAY;AAEpB,IAAA,WAAA,CAAY,IAAY,EAAE,MAAgB,EAAE,YAAgD,EAAA;AAC1F,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAIA,6BAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACrD,QAAA,IAAI,CAAC,YAAY,GAAG,YAAY;IAClC;AAEA;;;;;;AAMG;AACH,IAAA,QAAQ,CACN,IAAY,EACZ,OAAuC,EACvC,QAAc,EAAA;QAEd,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA,SAAA,EAAY,IAAI,CAAA,8BAAA,EAAiC,IAAI,CAAA,KAAA,CAAO,CAAC;QAChF;AACA,QAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC1D;AAEA;;;;;AAKG;AACH,IAAA,UAAU,CAAC,IAAY,EAAA;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;IACnC;AAEA;;;AAGG;AACH,IAAA,WAAW,CAAC,IAAY,EAAA;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ;IAC1C;AAEA;;;;;;;;AAQG;AACH,IAAA,QAAQ,CAAmB,IAAY,EAAE,OAAgB,EAAE,IAAO,EAAA;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE;YACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA,sBAAA,EAAyB,IAAI,CAAA,YAAA,EAAe,IAAI,CAAA,CAAA,CAAG,CAAC;AACrE,YAAA,OAAO,SAAS;QAClB;AAEA,QAAA,IAAI;YACF,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;QACtC;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,CAAA,kBAAA,EAAqB,IAAI,CAAA,GAAA,EAAM,KAAK,WAAW,IAAI,CAAA,QAAA,EAAW,KAAK,CAAA,CAAE,CACtE;AACD,YAAA,IAAI,IAAI,CAAC,YAAY,EAAE;gBACrB,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC;YACvC;AACA,YAAA,MAAM,KAAK;QACb;IACF;AAEA;;;;AAIG;AACH,IAAA,GAAG,CAAC,IAAY,EAAA;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;IAChC;AAEA;;;AAGG;IACH,eAAe,GAAA;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzC;AAEA;;;AAGG;IACH,KAAK,GAAA;AACH,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;IACvB;AACD"}