electron-infra-kit 0.0.2

package/dist/internal/utils/MessageDispatcher.mjs

@@ -0,0 +1,96 @@
+import {ElectronLogger}from'../../infrastructure/logger/ElectronLogger.mjs';/**
+ * 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({ 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();
+    }
+}export{MessageDispatcher};//# sourceMappingURL=MessageDispatcher.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MessageDispatcher.mjs","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":"4EAWA;;;;;;;;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,cAAM,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"}

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

@@ -0,0 +1,41 @@
+import { ILogger } from '@/infrastructure/logger';
+export interface RateLimitConfig {
+    limit: number;
+    interval: number;
+}
+export declare class RateLimiter {
+    private limits;
+    private state;
+    private defaultLimit;
+    private logger?;
+    private cleanupTimer;
+    private cleanupInterval;
+    constructor(options?: {
+        logger?: ILogger;
+        defaultLimit?: RateLimitConfig;
+        cleanupInterval?: number;
+    });
+    private startCleanup;
+    stopCleanup(): void;
+    /**
+     * Set rate limit for a specific key pattern
+     * @param keyPattern - The key pattern to limit (e.g., "handlerName")
+     * @param config - Rate limit configuration
+     */
+    setLimit(keyPattern: string, config: RateLimitConfig): void;
+    /**
+     * Check if the action is allowed for the given key
+     * @param key - Unique key for the action (e.g., "windowId:handlerName")
+     * @param ruleKey - Key to lookup configuration (e.g., "handlerName")
+     * @returns true if allowed, false if rate limit exceeded
+     */
+    check(key: string, ruleKey: string): boolean;
+    /**
+     * Clear all state
+     */
+    clear(): void;
+    /**
+     * Clean up expired entries to prevent memory leaks
+     */
+    cleanup(): void;
+}

package/dist/internal/utils/RateLimiter.js

@@ -0,0 +1,83 @@
+'use strict';class RateLimiter {
+    limits = new Map();
+    state = new Map();
+    defaultLimit = null;
+    logger;
+    cleanupTimer = null;
+    cleanupInterval;
+    constructor(options = {}) {
+        this.logger = options.logger;
+        this.defaultLimit = options.defaultLimit || null;
+        this.cleanupInterval = options.cleanupInterval || 60000;
+        this.startCleanup();
+    }
+    startCleanup() {
+        if (this.cleanupTimer)
+            return;
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, this.cleanupInterval);
+        // Unref to prevent preventing process exit
+        this.cleanupTimer.unref();
+    }
+    stopCleanup() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    /**
+     * Set rate limit for a specific key pattern
+     * @param keyPattern - The key pattern to limit (e.g., "handlerName")
+     * @param config - Rate limit configuration
+     */
+    setLimit(keyPattern, config) {
+        this.limits.set(keyPattern, config);
+    }
+    /**
+     * Check if the action is allowed for the given key
+     * @param key - Unique key for the action (e.g., "windowId:handlerName")
+     * @param ruleKey - Key to lookup configuration (e.g., "handlerName")
+     * @returns true if allowed, false if rate limit exceeded
+     */
+    check(key, ruleKey) {
+        const config = this.limits.get(ruleKey) || this.defaultLimit;
+        // If no limit configured, allow
+        if (!config)
+            return true;
+        const now = Date.now();
+        let record = this.state.get(key);
+        if (!record || now > record.resetTime) {
+            record = {
+                count: 0,
+                resetTime: now + config.interval,
+            };
+            this.state.set(key, record);
+        }
+        if (record.count >= config.limit) {
+            if (this.logger) {
+                this.logger.warn(`Rate limit exceeded for ${key} (Rule: ${ruleKey}, Limit: ${config.limit}/${config.interval}ms)`);
+            }
+            return false;
+        }
+        record.count++;
+        return true;
+    }
+    /**
+     * Clear all state
+     */
+    clear() {
+        this.state.clear();
+    }
+    /**
+     * Clean up expired entries to prevent memory leaks
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, record] of this.state.entries()) {
+            if (now > record.resetTime) {
+                this.state.delete(key);
+            }
+        }
+    }
+}exports.RateLimiter=RateLimiter;//# sourceMappingURL=RateLimiter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.js","sources":["../../../src/internal/utils/RateLimiter.ts"],"sourcesContent":["import { ILogger } from '@/infrastructure/logger';\n\nexport interface RateLimitConfig {\n  limit: number;\n  interval: number; // in milliseconds\n}\n\ninterface RateLimitState {\n  count: number;\n  resetTime: number;\n}\n\nexport class RateLimiter {\n  private limits = new Map<string, RateLimitConfig>();\n  private state = new Map<string, RateLimitState>();\n  private defaultLimit: RateLimitConfig | null = null;\n  private logger?: ILogger;\n\n  private cleanupTimer: NodeJS.Timeout | null = null;\n  private cleanupInterval: number;\n\n  constructor(\n    options: {\n      logger?: ILogger;\n      defaultLimit?: RateLimitConfig;\n      cleanupInterval?: number; // default: 60000ms (1 minute)\n    } = {}\n  ) {\n    this.logger = options.logger;\n    this.defaultLimit = options.defaultLimit || null;\n    this.cleanupInterval = options.cleanupInterval || 60000;\n\n    this.startCleanup();\n  }\n\n  private startCleanup() {\n    if (this.cleanupTimer) return;\n    this.cleanupTimer = setInterval(() => {\n      this.cleanup();\n    }, this.cleanupInterval);\n    // Unref to prevent preventing process exit\n    this.cleanupTimer.unref();\n  }\n\n  stopCleanup() {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = null;\n    }\n  }\n\n  /**\n   * Set rate limit for a specific key pattern\n   * @param keyPattern - The key pattern to limit (e.g., \"handlerName\")\n   * @param config - Rate limit configuration\n   */\n  setLimit(keyPattern: string, config: RateLimitConfig): void {\n    this.limits.set(keyPattern, config);\n  }\n\n  /**\n   * Check if the action is allowed for the given key\n   * @param key - Unique key for the action (e.g., \"windowId:handlerName\")\n   * @param ruleKey - Key to lookup configuration (e.g., \"handlerName\")\n   * @returns true if allowed, false if rate limit exceeded\n   */\n  check(key: string, ruleKey: string): boolean {\n    const config = this.limits.get(ruleKey) || this.defaultLimit;\n\n    // If no limit configured, allow\n    if (!config) return true;\n\n    const now = Date.now();\n    let record = this.state.get(key);\n\n    if (!record || now > record.resetTime) {\n      record = {\n        count: 0,\n        resetTime: now + config.interval,\n      };\n      this.state.set(key, record);\n    }\n\n    if (record.count >= config.limit) {\n      if (this.logger) {\n        this.logger.warn(\n          `Rate limit exceeded for ${key} (Rule: ${ruleKey}, Limit: ${config.limit}/${config.interval}ms)`\n        );\n      }\n      return false;\n    }\n\n    record.count++;\n    return true;\n  }\n\n  /**\n   * Clear all state\n   */\n  clear(): void {\n    this.state.clear();\n  }\n\n  /**\n   * Clean up expired entries to prevent memory leaks\n   */\n  cleanup(): void {\n    const now = Date.now();\n    for (const [key, record] of this.state.entries()) {\n      if (now > record.resetTime) {\n        this.state.delete(key);\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/internal/utils/RateLimiter.mjs

@@ -0,0 +1,83 @@
+class RateLimiter {
+    limits = new Map();
+    state = new Map();
+    defaultLimit = null;
+    logger;
+    cleanupTimer = null;
+    cleanupInterval;
+    constructor(options = {}) {
+        this.logger = options.logger;
+        this.defaultLimit = options.defaultLimit || null;
+        this.cleanupInterval = options.cleanupInterval || 60000;
+        this.startCleanup();
+    }
+    startCleanup() {
+        if (this.cleanupTimer)
+            return;
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, this.cleanupInterval);
+        // Unref to prevent preventing process exit
+        this.cleanupTimer.unref();
+    }
+    stopCleanup() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    /**
+     * Set rate limit for a specific key pattern
+     * @param keyPattern - The key pattern to limit (e.g., "handlerName")
+     * @param config - Rate limit configuration
+     */
+    setLimit(keyPattern, config) {
+        this.limits.set(keyPattern, config);
+    }
+    /**
+     * Check if the action is allowed for the given key
+     * @param key - Unique key for the action (e.g., "windowId:handlerName")
+     * @param ruleKey - Key to lookup configuration (e.g., "handlerName")
+     * @returns true if allowed, false if rate limit exceeded
+     */
+    check(key, ruleKey) {
+        const config = this.limits.get(ruleKey) || this.defaultLimit;
+        // If no limit configured, allow
+        if (!config)
+            return true;
+        const now = Date.now();
+        let record = this.state.get(key);
+        if (!record || now > record.resetTime) {
+            record = {
+                count: 0,
+                resetTime: now + config.interval,
+            };
+            this.state.set(key, record);
+        }
+        if (record.count >= config.limit) {
+            if (this.logger) {
+                this.logger.warn(`Rate limit exceeded for ${key} (Rule: ${ruleKey}, Limit: ${config.limit}/${config.interval}ms)`);
+            }
+            return false;
+        }
+        record.count++;
+        return true;
+    }
+    /**
+     * Clear all state
+     */
+    clear() {
+        this.state.clear();
+    }
+    /**
+     * Clean up expired entries to prevent memory leaks
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, record] of this.state.entries()) {
+            if (now > record.resetTime) {
+                this.state.delete(key);
+            }
+        }
+    }
+}export{RateLimiter};//# sourceMappingURL=RateLimiter.mjs.map

package/dist/internal/utils/RateLimiter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.mjs","sources":["../../../src/internal/utils/RateLimiter.ts"],"sourcesContent":["import { ILogger } from '@/infrastructure/logger';\n\nexport interface RateLimitConfig {\n  limit: number;\n  interval: number; // in milliseconds\n}\n\ninterface RateLimitState {\n  count: number;\n  resetTime: number;\n}\n\nexport class RateLimiter {\n  private limits = new Map<string, RateLimitConfig>();\n  private state = new Map<string, RateLimitState>();\n  private defaultLimit: RateLimitConfig | null = null;\n  private logger?: ILogger;\n\n  private cleanupTimer: NodeJS.Timeout | null = null;\n  private cleanupInterval: number;\n\n  constructor(\n    options: {\n      logger?: ILogger;\n      defaultLimit?: RateLimitConfig;\n      cleanupInterval?: number; // default: 60000ms (1 minute)\n    } = {}\n  ) {\n    this.logger = options.logger;\n    this.defaultLimit = options.defaultLimit || null;\n    this.cleanupInterval = options.cleanupInterval || 60000;\n\n    this.startCleanup();\n  }\n\n  private startCleanup() {\n    if (this.cleanupTimer) return;\n    this.cleanupTimer = setInterval(() => {\n      this.cleanup();\n    }, this.cleanupInterval);\n    // Unref to prevent preventing process exit\n    this.cleanupTimer.unref();\n  }\n\n  stopCleanup() {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = null;\n    }\n  }\n\n  /**\n   * Set rate limit for a specific key pattern\n   * @param keyPattern - The key pattern to limit (e.g., \"handlerName\")\n   * @param config - Rate limit configuration\n   */\n  setLimit(keyPattern: string, config: RateLimitConfig): void {\n    this.limits.set(keyPattern, config);\n  }\n\n  /**\n   * Check if the action is allowed for the given key\n   * @param key - Unique key for the action (e.g., \"windowId:handlerName\")\n   * @param ruleKey - Key to lookup configuration (e.g., \"handlerName\")\n   * @returns true if allowed, false if rate limit exceeded\n   */\n  check(key: string, ruleKey: string): boolean {\n    const config = this.limits.get(ruleKey) || this.defaultLimit;\n\n    // If no limit configured, allow\n    if (!config) return true;\n\n    const now = Date.now();\n    let record = this.state.get(key);\n\n    if (!record || now > record.resetTime) {\n      record = {\n        count: 0,\n        resetTime: now + config.interval,\n      };\n      this.state.set(key, record);\n    }\n\n    if (record.count >= config.limit) {\n      if (this.logger) {\n        this.logger.warn(\n          `Rate limit exceeded for ${key} (Rule: ${ruleKey}, Limit: ${config.limit}/${config.interval}ms)`\n        );\n      }\n      return false;\n    }\n\n    record.count++;\n    return true;\n  }\n\n  /**\n   * Clear all state\n   */\n  clear(): void {\n    this.state.clear();\n  }\n\n  /**\n   * Clean up expired entries to prevent memory leaks\n   */\n  cleanup(): void {\n    const now = Date.now();\n    for (const [key, record] of this.state.entries()) {\n      if (now > record.resetTime) {\n        this.state.delete(key);\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,125 @@
+/**
+ * StateKeeper.ts
+ * 窗口状态管理器，负责持久化和恢复 Electron 窗口的位置、大小等状态
+ *
+ * 主要功能：
+ * - 保存窗口状态到文件系统
+ * - 从文件系统加载窗口状态
+ * - 验证窗口状态的有效性（确保窗口在可用显示器范围内）
+ * - 支持延迟保存机制，避免频繁 IO 操作
+ */
+import { ILogger } from '@/infrastructure/logger';
+/**
+ * 窗口状态接口，定义了需要持久化的窗口属性
+ */
+export interface WindowState {
+    x?: number;
+    y?: number;
+    width: number;
+    height: number;
+    isMaximized: boolean;
+    isFullScreen: boolean;
+    displayBounds?: Electron.Rectangle;
+    groups?: string[];
+}
+/**
+ * StateKeeper Configuration Options
+ * StateKeeper 配置选项
+ */
+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?: ILogger;
+    /**
+     * Custom state file path
+     * 自定义状态文件路径
+     */
+    stateFilePath?: string;
+}
+/**
+ * 窗口状态管理器类
+ * 实现了窗口状态的持久化存储和加载功能
+ */
+export default class StateKeeper {
+    private stateFile;
+    private state;
+    private logger;
+    private saveTimer;
+    private throttleLastSave;
+    private readonly saveDelay;
+    private readonly saveStrategy;
+    private static activeFiles;
+    private hasLock;
+    private isWriting;
+    private pendingWrite;
+    private lastSavedHash;
+    /**
+     * 构造函数
+     * @param options 配置选项
+     */
+    constructor(options?: StateKeeperOptions);
+    /**
+     * 从文件加载窗口状态
+     * 私有方法，仅在构造函数中调用
+     */
+    private loadState;
+    /**
+     * 保存指定窗口的状态
+     * @param windowName 窗口名称，用于标识不同窗口的状态
+     * @param windowState 窗口状态对象
+     */
+    saveState(windowName: string, windowState: WindowState): void;
+    /**
+     * 立即同步保存状态（不使用延迟）
+     */
+    flushSync(): void;
+    /**
+     * 将内存中的状态持久化到文件
+     * 私有方法，使用延迟保存机制避免频繁 IO 操作
+     */
+    private persist;
+    /**
+     * 执行实际的保存操作
+     * 私有方法
+     */
+    private performSave;
+    /**
+     * 获取指定窗口的状态
+     * @param windowName 窗口名称
+     * @param defaultWidth 默认宽度，当没有保存状态或状态无效时使用
+     * @param defaultHeight 默认高度，当没有保存状态或状态无效时使用
+     * @returns 窗口状态对象
+     */
+    getWindowState(windowName: string, defaultWidth?: number, defaultHeight?: number): WindowState;
+    /**
+     * 验证窗口状态是否有效
+     * 主要检查窗口是否在当前可用显示器范围内
+     * @param state 要验证的窗口状态
+     * @returns 状态是否有效
+     */
+    private isValidState;
+    /**
+     * 移除指定窗口的状态
+     * @param windowName 窗口名称
+     */
+    removeState(windowName: string): void;
+    /**
+     * Dispose StateKeeper instance
+     * 释放 StateKeeper 实例
+     */
+    dispose(): void;
+}