@vlian/infrastructure 0.9.10

package/dist/esm/managers/DictionaryManager/DictionaryManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/managers/DictionaryManager/DictionaryManager.ts"],"sourcesContent":["/**\n * DictionaryManager - 字典管理器\n * \n * 提供字典数据管理能力\n * 完全泛型化，字典项类型由用户定义\n * 基于 @vlian/framework 的 Storage、StateManager 和 AppEventBus\n */\n\nimport type {\n  DictionaryOptions,\n  DictionaryItem,\n  DictionaryData,\n  GetDictionaryOptions,\n  GetDictionarySyncOptions,\n  FormatDictionaryOptions,\n  DictionaryValueQuery,\n  PreloadStatus,\n  HealthCheckResult,\n  PerformanceMetrics,\n  CacheStatistics,\n  DictionaryDiff,\n  EventMetadata,\n  EventListenerOptions,\n  Environment,\n} from './types';\nimport {\n  DictionaryError,\n  DictionaryErrorCode,\n  DictionaryEventType,\n} from './types';\nimport { DEFAULT_OPTIONS, PRODUCTION_OVERRIDES } from './constants';\n\n// 导入 Core 层\nimport {\n  CacheManager,\n  ConcurrencyController,\n  IndexManager,\n  DiffCalculator,\n  DictionaryValidator,\n  StateManagerWrapper,\n  DictionaryDataManager,\n} from './core';\n\n// 导入 Runtime 层\nimport { DictionaryFormatter } from './runtime/DictionaryFormatter';\nimport { DictionaryBatchProcessor } from './runtime/DictionaryBatchProcessor';\n\n// 导入 Observability 层\nimport {\n  EventManager,\n  PerformanceMonitor,\n  LoggingManager,\n  MonitoringManager,\n} from './observability';\n\n// 导入公共模块\nimport { StorageManager, EnvironmentDetector, ErrorHandler } from './modules';\n\n/**\n * 内部配置类型\n */\ntype InternalDictionaryOptions<TDictionaryItem = DictionaryItem> = Required<Omit<DictionaryOptions<TDictionaryItem>,\n  'storage' | 'stateManager' | 'eventBus' | 'logger' | 'monitoring' |\n  'dictionaryFetcher' | 'dictionariesFetcher' | 'dictionaryConfig' |\n  'dictionaryValidator' | 'formatter' | 'instanceId'\n>> & {\n  storage?: DictionaryOptions<TDictionaryItem>['storage'];\n  stateManager?: DictionaryOptions<TDictionaryItem>['stateManager'];\n  eventBus?: DictionaryOptions<TDictionaryItem>['eventBus'];\n  logger?: DictionaryOptions<TDictionaryItem>['logger'];\n  monitoring?: DictionaryOptions<TDictionaryItem>['monitoring'];\n  dictionaryFetcher?: DictionaryOptions<TDictionaryItem>['dictionaryFetcher'];\n  dictionariesFetcher?: DictionaryOptions<TDictionaryItem>['dictionariesFetcher'];\n  dictionaryConfig?: DictionaryOptions<TDictionaryItem>['dictionaryConfig'];\n  dictionaryValidator?: DictionaryOptions<TDictionaryItem>['dictionaryValidator'];\n  formatter?: DictionaryOptions<TDictionaryItem>['formatter'];\n  instanceId?: DictionaryOptions<TDictionaryItem>['instanceId'];\n};\n\n/**\n * DictionaryManager 类\n */\nexport class DictionaryManager<TDictionaryItem = DictionaryItem> {\n  private options: InternalDictionaryOptions<TDictionaryItem>;\n  private environment: Environment;\n  private isProduction: boolean;\n  private instanceId: string;\n  \n  // 模块实例\n  private storageManager?: StorageManager;\n  private stateManager?: StateManagerWrapper;\n  private errorHandler!: ErrorHandler;\n  \n  // Core 层\n  private cacheManager!: CacheManager<DictionaryData<TDictionaryItem>>;\n  private concurrencyController!: ConcurrencyController;\n  private indexManager!: IndexManager<TDictionaryItem>;\n  private diffCalculator!: DiffCalculator<TDictionaryItem>;\n  private validator!: DictionaryValidator<TDictionaryItem>;\n  private dataManager!: DictionaryDataManager<TDictionaryItem>;\n  \n  // Runtime 层\n  private formatter!: DictionaryFormatter<TDictionaryItem>;\n  \n  // Observability 层\n  private loggingManager!: LoggingManager;\n  private monitoringManager!: MonitoringManager;\n  private performanceMonitor!: PerformanceMonitor;\n  private eventManager!: EventManager;\n  \n  // 预加载状态\n  private preloadStatus: Map<string, PreloadStatus> = new Map();\n\n  /**\n   * 构造函数\n   */\n  constructor(options: DictionaryOptions<TDictionaryItem>) {\n    // 检测环境\n    this.environment = EnvironmentDetector.detectEnvironment();\n    this.isProduction = EnvironmentDetector.checkIsProduction();\n    this.instanceId = options.instanceId || `dict_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n\n    // 合并默认配置\n    this.options = {\n      ...DEFAULT_OPTIONS,\n      ...options,\n      storage: options.storage,\n      stateManager: options.stateManager,\n      eventBus: options.eventBus,\n      logger: options.logger,\n      monitoring: options.monitoring,\n      dictionaryFetcher: options.dictionaryFetcher,\n      dictionariesFetcher: options.dictionariesFetcher,\n      dictionaryConfig: options.dictionaryConfig,\n      dictionaryValidator: options.dictionaryValidator,\n      formatter: options.formatter,\n      instanceId: this.instanceId,\n    } as InternalDictionaryOptions<TDictionaryItem>;\n\n    // 应用生产环境覆盖\n    if (this.isProduction) {\n      this.options = {\n        ...this.options,\n        ...PRODUCTION_OVERRIDES,\n      };\n    }\n\n    // 配置验证\n    if (this.options.validateConfig !== false) {\n      const validation = this.validateConfig(this.options);\n      if (!validation.valid) {\n        const errorMsg = `Configuration validation failed: ${validation.errors.join(', ')}`;\n        if (this.options.devMode) {\n          throw new DictionaryError(\n            `${errorMsg}\\nWarnings: ${validation.warnings.join(', ')}`,\n            DictionaryErrorCode.CONFIG_ERROR\n          );\n        } else {\n          throw new DictionaryError(errorMsg, DictionaryErrorCode.CONFIG_ERROR);\n        }\n      }\n      if (validation.warnings.length > 0 && this.options.devMode) {\n        validation.warnings.forEach(warning => {\n          this.options.logger?.warn(`Config warning: ${warning}`);\n        });\n      }\n    }\n\n    // 初始化模块\n    this.initializeModules();\n\n    // 开发模式日志\n    if (this.options.devMode && this.options.enableLogging) {\n      this.loggingManager?.debug('DictionaryManager initialized', {\n        environment: this.environment,\n        isProduction: this.isProduction,\n        instanceId: this.instanceId,\n      });\n    }\n\n    // 初始化时自动预加载\n    this.initializeAutoPreload();\n  }\n\n  /**\n   * 初始化所有模块\n   */\n  private initializeModules(): void {\n    // 初始化公共模块\n    if (this.options.storage || this.options.enablePersistentCache) {\n      this.storageManager = new StorageManager({\n        storage: this.options.storage || { strategy: 'local' },\n        environment: this.environment,\n        logger: this.options.logger,\n      });\n    }\n\n    this.errorHandler = new ErrorHandler({\n      logger: this.options.logger,\n      monitoring: this.options.monitoring,\n      sanitizeErrors: this.isProduction,\n    });\n\n    // 初始化 Observability 层\n    this.loggingManager = new LoggingManager({\n      logger: this.options.logger,\n      enableLogging: this.options.enableLogging,\n      context: { instanceId: this.instanceId },\n    });\n\n    this.monitoringManager = new MonitoringManager({\n      monitoring: this.options.monitoring,\n      enableMonitoring: this.options.enableMonitoring,\n    });\n\n    this.performanceMonitor = new PerformanceMonitor({\n      monitoring: this.options.monitoring,\n      enableDetailedMetrics: this.options.enableDetailedMetrics,\n    });\n\n    this.eventManager = new EventManager({\n      eventBus: this.options.eventBus,\n      eventNamespace: this.options.eventNamespace,\n      enableEvents: this.options.enableEvents,\n      logger: this.options.enableLogging ? {\n        debug: (...args) => this.loggingManager.debug(...args),\n        error: (...args) => this.loggingManager.error(...args),\n      } : undefined,\n      monitoring: this.options.enableMonitoring ? {\n        trackEvent: (name, props) => this.monitoringManager.trackEvent(name, props),\n        captureError: (error, ctx) => this.monitoringManager.captureError(error, ctx),\n      } : undefined,\n    });\n\n    // 初始化 Core 层\n    this.stateManager = this.options.stateManager\n      ? new StateManagerWrapper({\n          stateManager: this.options.stateManager,\n          logger: this.options.logger,\n        })\n      : undefined;\n\n    this.cacheManager = new CacheManager<DictionaryData<TDictionaryItem>>({\n      defaultTTL: this.options.cacheExpiry,\n    });\n\n    this.concurrencyController = new ConcurrencyController({\n      strategy: this.options.concurrencyStrategy,\n      maxQueueSize: this.options.maxQueueSize,\n      operationTimeout: this.options.operationTimeout,\n    });\n\n    this.indexManager = new IndexManager<TDictionaryItem>({\n      indexKeyField: this.options.indexKeyField,\n      keyField: this.options.keyField,\n      enableIndex: this.options.enableIndex,\n    });\n\n    this.diffCalculator = new DiffCalculator<TDictionaryItem>({\n      itemComparator: this.options.itemComparator,\n      itemChangeDetector: this.options.itemChangeDetector,\n      indexKeyField: this.options.indexKeyField || this.options.keyField,\n    });\n\n    this.validator = new DictionaryValidator<TDictionaryItem>({\n      validator: this.options.dictionaryValidator,\n    });\n\n    this.dataManager = new DictionaryDataManager<TDictionaryItem>({\n      cacheManager: this.cacheManager,\n      stateManager: this.stateManager,\n      storageManager: this.storageManager,\n      indexManager: this.indexManager,\n      validator: this.validator,\n      dictionaryFetcher: this.options.dictionaryFetcher,\n      dictionariesFetcher: this.options.dictionariesFetcher,\n      dictionaryConfig: this.options.dictionaryConfig,\n      enableCache: this.options.enableCache,\n      enablePersistentCache: this.options.enablePersistentCache,\n      cacheExpiry: this.options.cacheExpiry,\n      dictionaryKeyPrefix: this.options.dictionaryKeyPrefix,\n    });\n\n    // 初始化 Runtime 层\n    this.formatter = new DictionaryFormatter<TDictionaryItem>({\n      formatter: this.options.formatter,\n      keyField: this.options.keyField,\n      labelField: this.options.labelField,\n    });\n  }\n\n  /**\n   * 初始化时自动预加载\n   */\n  private async initializeAutoPreload(): Promise<void> {\n    if (this.options.preloadDictionaries && this.options.preloadDictionaries.length > 0) {\n      // 异步预加载，不阻塞初始化\n      this.preloadDictionaries(this.options.preloadDictionaries).catch((error) => {\n        this.errorHandler.handleError(error, { operation: 'autoPreload' });\n      });\n    }\n  }\n\n  /**\n   * 配置验证\n   */\n  private validateConfig(options: InternalDictionaryOptions<TDictionaryItem>): {\n    valid: boolean;\n    errors: string[];\n    warnings: string[];\n  } {\n    const errors: string[] = [];\n    const warnings: string[] = [];\n\n    // 验证数据来源\n    if (!options.dictionaryFetcher && !options.dictionariesFetcher && !options.dictionaryConfig) {\n      warnings.push('No dictionary data source provided. DictionaryManager will return empty arrays.');\n    }\n\n    // 验证索引配置\n    if (options.enableIndex && !options.indexKeyField && !options.keyField) {\n      errors.push('keyField is required when enableIndex is true');\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n      warnings,\n    };\n  }\n\n  /**\n   * 获取字典数据（异步）\n   */\n  async getDictionary(\n    code: string,\n    options?: GetDictionaryOptions\n  ): Promise<TDictionaryItem[]> {\n    const startTime = Date.now();\n    const operationType = 'getDictionary';\n\n    return this.concurrencyController.execute(\n      async () => {\n        try {\n          const items = await this.dataManager.getDictionary(code, {\n            force: options?.force,\n            usePersistentCache: options?.usePersistentCache,\n          });\n\n          // 记录性能指标\n          const duration = Date.now() - startTime;\n          this.performanceMonitor.recordMetric(operationType, duration, { code });\n\n          // 触发事件\n          this.eventManager.emitEvent(DictionaryEventType.DICTIONARY_LOADED, {\n            code,\n            items,\n            timestamp: Date.now(),\n          });\n\n          return items;\n        } catch (error) {\n          const duration = Date.now() - startTime;\n          this.performanceMonitor.recordMetric(operationType, duration, { code, error: true });\n          throw this.errorHandler.handleError(error, { operation: operationType, code });\n        }\n      },\n      operationType\n    );\n  }\n\n  /**\n   * 获取字典数据（同步，仅读取缓存）\n   */\n  getDictionarySync(\n    code: string,\n    _options?: GetDictionarySyncOptions\n  ): TDictionaryItem[] {\n    const items = this.dataManager.getDictionarySync(code);\n    return items || [];\n  }\n\n  /**\n   * 获取字典值（异步）\n   */\n  async getDictionaryValue(\n    code: string,\n    key: string | number,\n    options?: GetDictionaryOptions\n  ): Promise<string | null> {\n    const items = await this.getDictionary(code, options);\n    const item = items.find((item) => {\n      const itemKey = (item as Record<string, unknown>)[this.options.keyField];\n      return String(itemKey) === String(key);\n    });\n\n    if (!item) {\n      return null;\n    }\n\n    return this.formatter.getLabel(item);\n  }\n\n  /**\n   * 获取字典值（同步，仅读取缓存）\n   */\n  getDictionaryValueSync(\n    code: string,\n    key: string | number,\n    _options?: GetDictionarySyncOptions\n  ): string | null {\n    const items = this.getDictionarySync(code);\n    const item = items.find((item) => {\n      const itemKey = (item as Record<string, unknown>)[this.options.keyField];\n      return String(itemKey) === String(key);\n    });\n\n    if (!item) {\n      return null;\n    }\n\n    return this.formatter.getLabel(item);\n  }\n\n  /**\n   * 格式化字典值\n   */\n  async formatDictionary(\n    code: string,\n    value: string | number,\n    options?: FormatDictionaryOptions\n  ): Promise<string> {\n    const items = await this.getDictionary(code);\n    const item = items.find((item) => {\n      const itemKey = (item as Record<string, unknown>)[this.options.keyField];\n      return String(itemKey) === String(value);\n    });\n\n    return this.formatter.format(item || null, value, options?.defaultValue);\n  }\n\n  /**\n   * 批量获取字典数据（异步）\n   */\n  async getDictionaries(\n    codes: string[],\n    options?: GetDictionaryOptions\n  ): Promise<Record<string, TDictionaryItem[]>> {\n    const startTime = Date.now();\n    const operationType = 'batch';\n\n    return this.concurrencyController.execute(\n      async () => {\n        try {\n          const dictionaries = await this.dataManager.getDictionaries(codes, {\n            force: options?.force,\n            usePersistentCache: options?.usePersistentCache,\n          });\n\n          const duration = Date.now() - startTime;\n          this.performanceMonitor.recordMetric(operationType, duration, { count: codes.length });\n\n          return dictionaries;\n        } catch (error) {\n          const duration = Date.now() - startTime;\n          this.performanceMonitor.recordMetric(operationType, duration, { count: codes.length, error: true });\n          throw this.errorHandler.handleError(error, { operation: operationType, codes });\n        }\n      },\n      operationType\n    );\n  }\n\n  /**\n   * 批量获取字典数据（同步，仅读取缓存）\n   */\n  getDictionariesSync(\n    codes: string[],\n    _options?: GetDictionarySyncOptions\n  ): Record<string, TDictionaryItem[]> {\n    return this.dataManager.getDictionariesSync(codes);\n  }\n\n  /**\n   * 批量获取字典值（异步）\n   */\n  async getDictionaryValues(\n    queries: DictionaryValueQuery[],\n    options?: GetDictionaryOptions\n  ): Promise<Record<string, string | null>> {\n    return DictionaryBatchProcessor.getDictionaryValues(\n      queries,\n      async (code, key) => {\n        const items = await this.getDictionary(code, options);\n        return items.find((item) => {\n          const itemKey = (item as Record<string, unknown>)[this.options.keyField];\n          return String(itemKey) === String(key);\n        }) || null;\n      },\n      (item) => this.formatter.getLabel(item)\n    );\n  }\n\n  /**\n   * 批量获取字典值（同步，仅读取缓存）\n   */\n  getDictionaryValuesSync(\n    queries: DictionaryValueQuery[],\n    _options?: GetDictionarySyncOptions\n  ): Record<string, string | null> {\n    return DictionaryBatchProcessor.getDictionaryValuesSync(\n      queries,\n      (code, key) => {\n        const items = this.getDictionarySync(code);\n        return items.find((item) => {\n          const itemKey = (item as Record<string, unknown>)[this.options.keyField];\n          return String(itemKey) === String(key);\n        }) || null;\n      },\n      (item) => this.formatter.getLabel(item)\n    );\n  }\n\n  /**\n   * 获取可用字典列表\n   */\n  async getAvailableDictionaries(): Promise<string[]> {\n    const codes: string[] = [];\n\n    // 从缓存获取\n    codes.push(...this.dataManager.getAvailableDictionariesSync());\n\n    // 从配置获取\n    if (this.options.dictionaryConfig) {\n      for (const code of Object.keys(this.options.dictionaryConfig)) {\n        if (!codes.includes(code)) {\n          codes.push(code);\n        }\n      }\n    }\n\n    return codes;\n  }\n\n  /**\n   * 获取可用字典列表（同步，仅读取缓存）\n   */\n  getAvailableDictionariesSync(): string[] {\n    return this.dataManager.getAvailableDictionariesSync();\n  }\n\n  /**\n   * 刷新字典数据\n   */\n  async refreshDictionary(code?: string, force: boolean = true): Promise<void> {\n    const startTime = Date.now();\n    const operationType = 'refresh';\n\n    return this.concurrencyController.execute(\n      async () => {\n        try {\n          if (code) {\n            await this.dataManager.getDictionary(code, { force, usePersistentCache: false });\n          } else {\n            // 刷新所有字典\n            const codes = await this.getAvailableDictionaries();\n            await this.dataManager.getDictionaries(codes, { force, usePersistentCache: false });\n          }\n\n          const duration = Date.now() - startTime;\n          this.performanceMonitor.recordMetric(operationType, duration, { code: code || 'all' });\n\n          this.eventManager.emitEvent(DictionaryEventType.DICTIONARY_REFRESHED, {\n            code: code || 'all',\n            timestamp: Date.now(),\n          });\n        } catch (error) {\n          const duration = Date.now() - startTime;\n          this.performanceMonitor.recordMetric(operationType, duration, { code: code || 'all', error: true });\n          throw this.errorHandler.handleError(error, { operation: operationType, code });\n        }\n      },\n      operationType\n    );\n  }\n\n  /**\n   * 刷新多个字典数据\n   */\n  async refreshDictionaries(codes: string[], force: boolean = true): Promise<void> {\n    await this.dataManager.getDictionaries(codes, { force, usePersistentCache: false });\n    \n    this.eventManager.emitEvent(DictionaryEventType.DICTIONARY_REFRESHED, {\n      codes,\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * 清除字典缓存\n   */\n  async clearCache(code?: string): Promise<void> {\n    await this.dataManager.clearCache(code);\n    \n    this.eventManager.emitEvent(DictionaryEventType.DICTIONARY_CACHE_CLEARED, {\n      code: code || 'all',\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * 预加载字典数据\n   */\n  async preloadDictionaries(codes: string[]): Promise<void> {\n    const startTime = Date.now();\n    const operationType = 'preload';\n\n    return this.concurrencyController.execute(\n      async () => {\n        try {\n          // 更新预加载状态\n          for (const code of codes) {\n            this.preloadStatus.set(code, { code, status: 'loading' });\n          }\n\n          await this.dataManager.getDictionaries(codes, {\n            force: false,\n            usePersistentCache: this.options.enablePersistentCache,\n          });\n\n          // 更新预加载状态\n          for (const code of codes) {\n            this.preloadStatus.set(code, { code, status: 'loaded' });\n          }\n\n          const duration = Date.now() - startTime;\n          this.performanceMonitor.recordMetric(operationType, duration, { count: codes.length });\n\n          this.eventManager.emitEvent(DictionaryEventType.DICTIONARY_PRELOADED, {\n            codes,\n            timestamp: Date.now(),\n          });\n        } catch (error) {\n          // 更新预加载状态\n          for (const code of codes) {\n            this.preloadStatus.set(code, { code, status: 'error', error: error instanceof Error ? error : new Error(String(error)) });\n          }\n\n          const duration = Date.now() - startTime;\n          this.performanceMonitor.recordMetric(operationType, duration, { count: codes.length, error: true });\n          throw this.errorHandler.handleError(error, { operation: operationType, codes });\n        }\n      },\n      operationType\n    );\n  }\n\n  /**\n   * 获取预加载状态\n   */\n  async getPreloadStatus(code?: string): Promise<PreloadStatus | Record<string, PreloadStatus>> {\n    if (code) {\n      return this.preloadStatus.get(code) || { code, status: 'pending' };\n    }\n\n    return Object.fromEntries(this.preloadStatus);\n  }\n\n  /**\n   * 获取字典项索引（通过索引键）\n   */\n  async getDictionaryItemByIndex(\n    code: string,\n    indexKey: string,\n    options?: GetDictionaryOptions\n  ): Promise<TDictionaryItem | null> {\n    await this.dataManager.getDictionary(code, options);\n    const dictionaryData = this.dataManager.getDictionaryData(code);\n    \n    if (!dictionaryData || !dictionaryData.index) {\n      return null;\n    }\n\n    return this.indexManager.getItemByIndex(dictionaryData.index, indexKey);\n  }\n\n  /**\n   * 获取字典项索引（同步，仅读取缓存）\n   */\n  getDictionaryItemByIndexSync(\n    code: string,\n    indexKey: string,\n    _options?: GetDictionarySyncOptions\n  ): TDictionaryItem | null {\n    const dictionaryData = this.dataManager.getDictionaryData(code);\n    \n    if (!dictionaryData || !dictionaryData.index) {\n      return null;\n    }\n\n    return this.indexManager.getItemByIndex(dictionaryData.index, indexKey);\n  }\n\n  /**\n   * 获取字典索引 Map\n   */\n  async getDictionaryIndex(\n    code: string,\n    options?: GetDictionaryOptions\n  ): Promise<Map<string, TDictionaryItem>> {\n    await this.getDictionary(code, options);\n    const dictionaryData = this.dataManager.getDictionaryData(code);\n    \n    return dictionaryData?.index || new Map();\n  }\n\n  /**\n   * 获取字典索引 Map（同步，仅读取缓存）\n   */\n  getDictionaryIndexSync(\n    code: string,\n    _options?: GetDictionarySyncOptions\n  ): Map<string, TDictionaryItem> {\n    const dictionaryData = this.dataManager.getDictionaryData(code);\n    return dictionaryData?.index || new Map();\n  }\n\n  /**\n   * 计算字典差异\n   */\n  async calculateDictionaryDiff(\n    code: string,\n    newItems: TDictionaryItem[],\n    oldItems?: TDictionaryItem[]\n  ): Promise<DictionaryDiff<TDictionaryItem>> {\n    const old = oldItems || this.dataManager.getDictionarySync(code) || [];\n    return this.diffCalculator.calculateDiff(newItems, old);\n  }\n\n  /**\n   * 应用字典差异（Patch）\n   */\n  async applyDictionaryPatch(\n    code: string,\n    diff: DictionaryDiff<TDictionaryItem>\n  ): Promise<void> {\n    const currentItems = this.dataManager.getDictionarySync(code) || [];\n    \n    // 应用差异\n    const newItems: TDictionaryItem[] = [...currentItems];\n    \n    // 移除删除的项\n    for (const removed of diff.removed) {\n      const index = newItems.findIndex((item) => {\n        const itemKey = (item as Record<string, unknown>)[this.options.keyField];\n        const removedKey = (removed as Record<string, unknown>)[this.options.keyField];\n        return String(itemKey) === String(removedKey);\n      });\n      if (index !== -1) {\n        newItems.splice(index, 1);\n      }\n    }\n    \n    // 添加新增的项\n    newItems.push(...diff.added);\n    \n    // 更新变更的项\n    for (const { before, after } of diff.changed) {\n      const index = newItems.findIndex((item) => {\n        const itemKey = (item as Record<string, unknown>)[this.options.keyField];\n        const beforeKey = (before as Record<string, unknown>)[this.options.keyField];\n        return String(itemKey) === String(beforeKey);\n      });\n      if (index !== -1) {\n        newItems[index] = after;\n      }\n    }\n\n    // 保存新数据\n    const { oldItems } = await this.dataManager.setDictionary(code, newItems, this.options.enablePersistentCache);\n\n    // 触发更新事件（包含 Diff 信息）\n    this.eventManager.emitEvent(DictionaryEventType.DICTIONARY_UPDATED, {\n      code,\n      items: newItems,\n      previousItems: oldItems,\n      diff,\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * 订阅事件\n   */\n  on<EventData = unknown>(\n    event: DictionaryEventType,\n    listener: (data: EventData, metadata: EventMetadata) => void | Promise<void>,\n    options?: EventListenerOptions\n  ): () => void {\n    return this.eventManager.on(event, listener, options);\n  }\n\n  /**\n   * 取消订阅\n   */\n  off<EventData = unknown>(\n    event: DictionaryEventType,\n    listener?: (data: EventData, metadata: EventMetadata) => void | Promise<void>\n  ): void {\n    this.eventManager.off(event, listener);\n  }\n\n  /**\n   * 一次性订阅\n   */\n  once<EventData = unknown>(\n    event: DictionaryEventType,\n    listener: (data: EventData, metadata: EventMetadata) => void | Promise<void>\n  ): () => void {\n    return this.eventManager.once(event, listener);\n  }\n\n  /**\n   * 健康检查\n   */\n  async healthCheck(): Promise<HealthCheckResult> {\n    const checks: HealthCheckResult['checks'] = {};\n\n    // 检查存储\n    if (this.storageManager) {\n      try {\n        await this.storageManager.get('__health_check__');\n        checks.storage = { healthy: true };\n      } catch (error) {\n        checks.storage = {\n          healthy: false,\n          error: error instanceof Error ? error.message : String(error),\n        };\n      }\n    }\n\n    // 检查状态管理\n    if (this.stateManager) {\n      try {\n        this.stateManager.get('__health_check__');\n        checks.stateManager = { healthy: true };\n      } catch (error) {\n        checks.stateManager = {\n          healthy: false,\n          error: error instanceof Error ? error.message : String(error),\n        };\n      }\n    }\n\n    // 检查事件总线\n    if (this.options.enableEvents) {\n      try {\n        this.eventManager.emitEvent(DictionaryEventType.DICTIONARY_LOADED, { code: '__health_check__', items: [], timestamp: Date.now() });\n        checks.eventBus = { healthy: true };\n      } catch (error) {\n        checks.eventBus = {\n          healthy: false,\n          error: error instanceof Error ? error.message : String(error),\n        };\n      }\n    }\n\n    const healthy = Object.values(checks).every(check => check?.healthy !== false);\n\n    return {\n      healthy,\n      checks,\n    };\n  }\n\n  /**\n   * 获取性能指标\n   */\n  getPerformanceMetrics(): PerformanceMetrics[] {\n    return this.performanceMonitor.getMetrics();\n  }\n\n  /**\n   * 清除性能指标\n   */\n  clearPerformanceMetrics(): void {\n    this.performanceMonitor.clearMetrics();\n  }\n\n  /**\n   * 获取缓存统计信息\n   */\n  getCacheStatistics(): CacheStatistics {\n    const stats = this.cacheManager.getStatistics();\n    return {\n      size: stats.size,\n      hits: stats.hits,\n      misses: stats.misses,\n      hitRate: stats.hitRate,\n      keys: stats.keys,\n    };\n  }\n\n  /**\n   * 重置缓存统计信息\n   */\n  resetCacheStatistics(): void {\n    this.cacheManager.resetStatistics();\n  }\n\n  /**\n   * 销毁实例（清理资源）\n   */\n  destroy(): void {\n    // 清理事件订阅\n    this.eventManager.cleanup();\n    \n    // 清理缓存\n    this.cacheManager.clear();\n    \n    // 清理预加载状态\n    this.preloadStatus.clear();\n    \n    // 清理并发控制器\n    this.concurrencyController.clear();\n  }\n}\n"],"names":["DictionaryError","DictionaryErrorCode","DictionaryEventType","DEFAULT_OPTIONS","PRODUCTION_OVERRIDES","CacheManager","ConcurrencyController","IndexManager","DiffCalculator","DictionaryValidator","StateManagerWrapper","DictionaryDataManager","DictionaryFormatter","DictionaryBatchProcessor","EventManager","PerformanceMonitor","LoggingManager","MonitoringManager","StorageManager","EnvironmentDetector","ErrorHandler","DictionaryManager","initializeModules","options","storage","enablePersistentCache","storageManager","strategy","environment","logger","errorHandler","monitoring","sanitizeErrors","isProduction","loggingManager","enableLogging","context","instanceId","monitoringManager","enableMonitoring","performanceMonitor","enableDetailedMetrics","eventManager","eventBus","eventNamespace","enableEvents","debug","args","error","undefined","trackEvent","name","props","captureError","ctx","stateManager","cacheManager","defaultTTL","cacheExpiry","concurrencyController","concurrencyStrategy","maxQueueSize","operationTimeout","indexManager","indexKeyField","keyField","enableIndex","diffCalculator","itemComparator","itemChangeDetector","validator","dictionaryValidator","dataManager","dictionaryFetcher","dictionariesFetcher","dictionaryConfig","enableCache","dictionaryKeyPrefix","formatter","labelField","initializeAutoPreload","preloadDictionaries","length","catch","handleError","operation","validateConfig","errors","warnings","push","valid","getDictionary","code","startTime","Date","now","operationType","execute","items","force","usePersistentCache","duration","recordMetric","emitEvent","DICTIONARY_LOADED","timestamp","getDictionarySync","_options","getDictionaryValue","key","item","find","itemKey","String","getLabel","getDictionaryValueSync","formatDictionary","value","format","defaultValue","getDictionaries","codes","dictionaries","count","getDictionariesSync","getDictionaryValues","queries","getDictionaryValuesSync","getAvailableDictionaries","getAvailableDictionariesSync","Object","keys","includes","refreshDictionary","DICTIONARY_REFRESHED","refreshDictionaries","clearCache","DICTIONARY_CACHE_CLEARED","preloadStatus","set","status","DICTIONARY_PRELOADED","Error","getPreloadStatus","get","fromEntries","getDictionaryItemByIndex","indexKey","dictionaryData","getDictionaryData","index","getItemByIndex","getDictionaryItemByIndexSync","getDictionaryIndex","Map","getDictionaryIndexSync","calculateDictionaryDiff","newItems","oldItems","old","calculateDiff","applyDictionaryPatch","diff","currentItems","removed","findIndex","removedKey","splice","added","before","after","changed","beforeKey","setDictionary","DICTIONARY_UPDATED","previousItems","on","event","listener","off","once","healthCheck","checks","healthy","message","values","every","check","getPerformanceMetrics","getMetrics","clearPerformanceMetrics","clearMetrics","getCacheStatistics","stats","getStatistics","size","hits","misses","hitRate","resetCacheStatistics","resetStatistics","destroy","cleanup","clear","detectEnvironment","checkIsProduction","Math","random","toString","substr","validation","errorMsg","join","devMode","CONFIG_ERROR","forEach","warning","warn"],"mappings":"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"}

package/dist/esm/managers/DictionaryManager/constants.js

@@ -0,0 +1,82 @@
+/**
+ * DictionaryManager 常量定义
+ */ import { DictionaryEventType } from "./types";
+/**
+ * 检测是否为生产环境
+ */ function isProduction() {
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env.NODE_ENV === 'production';
+    }
+    // 浏览器环境：检查 hostname
+    if (typeof globalThis !== 'undefined' && 'location' in globalThis) {
+        const location = globalThis.location;
+        if (location?.hostname) {
+            return ![
+                'localhost',
+                '127.0.0.1',
+                '0.0.0.0'
+            ].includes(location.hostname);
+        }
+    }
+    return false;
+}
+/**
+ * 检测是否为开发模式
+ */ function isDevMode() {
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env.NODE_ENV === 'development' || process.env.DEBUG === 'true';
+    }
+    return !isProduction();
+}
+/**
+ * 默认配置值
+ */ export const DEFAULT_OPTIONS = {
+    // 事件配置
+    eventNamespace: 'dictionary:',
+    enableEvents: false,
+    // 存储配置
+    dictionaryKeyPrefix: 'dictionary:',
+    enablePersistentCache: false,
+    // 字典配置
+    keyField: 'key',
+    labelField: 'label',
+    // 缓存配置
+    enableCache: true,
+    cacheExpiry: undefined,
+    // 索引配置
+    enableIndex: true,
+    // 并发控制配置
+    concurrencyStrategy: 'auto',
+    maxQueueSize: 100,
+    operationTimeout: 30000,
+    // Diff & Patch 配置
+    enableDiff: true,
+    // 可观测性配置
+    enableLogging: false,
+    enableMonitoring: false,
+    // 性能配置
+    enableDetailedMetrics: false,
+    // 实例隔离配置
+    isolationMode: 'isolated',
+    // 其他配置
+    devMode: isDevMode(),
+    validateConfig: true
+};
+/**
+ * 生产环境配置覆盖
+ */ export const PRODUCTION_OVERRIDES = {
+    devMode: false,
+    enableDetailedMetrics: false
+};
+/**
+ * 事件类型映射（用于类型检查）
+ */ export const DICTIONARY_EVENT_TYPES = {
+    DICTIONARY_LOADED: DictionaryEventType.DICTIONARY_LOADED,
+    DICTIONARY_UPDATED: DictionaryEventType.DICTIONARY_UPDATED,
+    DICTIONARY_REFRESHED: DictionaryEventType.DICTIONARY_REFRESHED,
+    DICTIONARY_CACHED: DictionaryEventType.DICTIONARY_CACHED,
+    DICTIONARY_CACHE_CLEARED: DictionaryEventType.DICTIONARY_CACHE_CLEARED,
+    DICTIONARY_PRELOADED: DictionaryEventType.DICTIONARY_PRELOADED
+};
+
+//# sourceMappingURL=constants.js.map

package/dist/esm/managers/DictionaryManager/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/managers/DictionaryManager/constants.ts"],"sourcesContent":["/**\n * DictionaryManager 常量定义\n */\n\nimport { DictionaryEventType } from './types';\n\n/**\n * 检测是否为生产环境\n */\nfunction isProduction(): boolean {\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env.NODE_ENV === 'production';\n  }\n  // 浏览器环境：检查 hostname\n  if (typeof globalThis !== 'undefined' && 'location' in globalThis) {\n    const location = (globalThis as { location?: { hostname?: string } }).location;\n    if (location?.hostname) {\n      return !['localhost', '127.0.0.1', '0.0.0.0'].includes(location.hostname);\n    }\n  }\n  return false;\n}\n\n/**\n * 检测是否为开发模式\n */\nfunction isDevMode(): boolean {\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env.NODE_ENV === 'development' || process.env.DEBUG === 'true';\n  }\n  return !isProduction();\n}\n\n/**\n * 默认配置值\n */\nexport const DEFAULT_OPTIONS = {\n  // 事件配置\n  eventNamespace: 'dictionary:',\n  enableEvents: false,\n  \n  // 存储配置\n  dictionaryKeyPrefix: 'dictionary:',\n  enablePersistentCache: false,\n  \n  // 字典配置\n  keyField: 'key',\n  labelField: 'label',\n  \n  // 缓存配置\n  enableCache: true,\n  cacheExpiry: undefined, // 无过期\n  \n  // 索引配置\n  enableIndex: true,\n  \n  // 并发控制配置\n  concurrencyStrategy: 'auto' as const,\n  maxQueueSize: 100,\n  operationTimeout: 30000,\n  \n  // Diff & Patch 配置\n  enableDiff: true,\n  \n  // 可观测性配置\n  enableLogging: false,\n  enableMonitoring: false,\n  \n  // 性能配置\n  enableDetailedMetrics: false,\n  \n  // 实例隔离配置\n  isolationMode: 'isolated' as const,\n  \n  // 其他配置\n  devMode: isDevMode(),\n  validateConfig: true,\n} as const;\n\n/**\n * 生产环境配置覆盖\n */\nexport const PRODUCTION_OVERRIDES = {\n  devMode: false,\n  enableDetailedMetrics: false,\n} as const;\n\n/**\n * 事件类型映射（用于类型检查）\n */\nexport const DICTIONARY_EVENT_TYPES = {\n  DICTIONARY_LOADED: DictionaryEventType.DICTIONARY_LOADED,\n  DICTIONARY_UPDATED: DictionaryEventType.DICTIONARY_UPDATED,\n  DICTIONARY_REFRESHED: DictionaryEventType.DICTIONARY_REFRESHED,\n  DICTIONARY_CACHED: DictionaryEventType.DICTIONARY_CACHED,\n  DICTIONARY_CACHE_CLEARED: DictionaryEventType.DICTIONARY_CACHE_CLEARED,\n  DICTIONARY_PRELOADED: DictionaryEventType.DICTIONARY_PRELOADED,\n} as const;\n"],"names":["DictionaryEventType","isProduction","process","env","NODE_ENV","globalThis","location","hostname","includes","isDevMode","DEBUG","DEFAULT_OPTIONS","eventNamespace","enableEvents","dictionaryKeyPrefix","enablePersistentCache","keyField","labelField","enableCache","cacheExpiry","undefined","enableIndex","concurrencyStrategy","maxQueueSize","operationTimeout","enableDiff","enableLogging","enableMonitoring","enableDetailedMetrics","isolationMode","devMode","validateConfig","PRODUCTION_OVERRIDES","DICTIONARY_EVENT_TYPES","DICTIONARY_LOADED","DICTIONARY_UPDATED","DICTIONARY_REFRESHED","DICTIONARY_CACHED","DICTIONARY_CACHE_CLEARED","DICTIONARY_PRELOADED"],"mappings":"AAAA;;CAEC,GAED,SAASA,mBAAmB,QAAQ,UAAU;AAE9C;;CAEC,GACD,SAASC;IACP,IAAI,OAAOC,YAAY,eAAeA,QAAQC,GAAG,EAAE;QACjD,OAAOD,QAAQC,GAAG,CAACC,QAAQ,KAAK;IAClC;IACA,oBAAoB;IACpB,IAAI,OAAOC,eAAe,eAAe,cAAcA,YAAY;QACjE,MAAMC,WAAW,AAACD,WAAoDC,QAAQ;QAC9E,IAAIA,UAAUC,UAAU;YACtB,OAAO,CAAC;gBAAC;gBAAa;gBAAa;aAAU,CAACC,QAAQ,CAACF,SAASC,QAAQ;QAC1E;IACF;IACA,OAAO;AACT;AAEA;;CAEC,GACD,SAASE;IACP,IAAI,OAAOP,YAAY,eAAeA,QAAQC,GAAG,EAAE;QACjD,OAAOD,QAAQC,GAAG,CAACC,QAAQ,KAAK,iBAAiBF,QAAQC,GAAG,CAACO,KAAK,KAAK;IACzE;IACA,OAAO,CAACT;AACV;AAEA;;CAEC,GACD,OAAO,MAAMU,kBAAkB;IAC7B,OAAO;IACPC,gBAAgB;IAChBC,cAAc;IAEd,OAAO;IACPC,qBAAqB;IACrBC,uBAAuB;IAEvB,OAAO;IACPC,UAAU;IACVC,YAAY;IAEZ,OAAO;IACPC,aAAa;IACbC,aAAaC;IAEb,OAAO;IACPC,aAAa;IAEb,SAAS;IACTC,qBAAqB;IACrBC,cAAc;IACdC,kBAAkB;IAElB,kBAAkB;IAClBC,YAAY;IAEZ,SAAS;IACTC,eAAe;IACfC,kBAAkB;IAElB,OAAO;IACPC,uBAAuB;IAEvB,SAAS;IACTC,eAAe;IAEf,OAAO;IACPC,SAASrB;IACTsB,gBAAgB;AAClB,EAAW;AAEX;;CAEC,GACD,OAAO,MAAMC,uBAAuB;IAClCF,SAAS;IACTF,uBAAuB;AACzB,EAAW;AAEX;;CAEC,GACD,OAAO,MAAMK,yBAAyB;IACpCC,mBAAmBlC,oBAAoBkC,iBAAiB;IACxDC,oBAAoBnC,oBAAoBmC,kBAAkB;IAC1DC,sBAAsBpC,oBAAoBoC,oBAAoB;IAC9DC,mBAAmBrC,oBAAoBqC,iBAAiB;IACxDC,0BAA0BtC,oBAAoBsC,wBAAwB;IACtEC,sBAAsBvC,oBAAoBuC,oBAAoB;AAChE,EAAW"}

package/dist/esm/managers/DictionaryManager/core/CacheManager.js

@@ -0,0 +1,135 @@
+/**
+ * 缓存管理模块
+ * 负责内存缓存管理
+ */ /**
+ * 缓存项
+ */ function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * 缓存管理器
+ */ export class CacheManager {
+    /**
+   * 获取缓存值
+   */ get(key) {
+        const item = this.cache.get(key);
+        if (!item) {
+            this.misses++;
+            return null;
+        }
+        // 检查是否过期
+        if (item.expiresAt && Date.now() >= item.expiresAt) {
+            this.cache.delete(key);
+            this.misses++;
+            return null;
+        }
+        this.hits++;
+        return item.value;
+    }
+    /**
+   * 设置缓存值
+   */ set(key, value, ttl) {
+        const expiresAt = ttl ? Date.now() + ttl : this.defaultTTL ? Date.now() + this.defaultTTL : undefined;
+        const item = {
+            value,
+            timestamp: Date.now(),
+            expiresAt
+        };
+        // 检查大小限制
+        if (this.maxSize && this.cache.size >= this.maxSize) {
+            // 删除最旧的项
+            const oldestKey = this.getOldestKey();
+            if (oldestKey) {
+                this.cache.delete(oldestKey);
+            }
+        }
+        this.cache.set(key, item);
+    }
+    /**
+   * 检查是否存在
+   */ has(key) {
+        const item = this.cache.get(key);
+        if (!item) {
+            return false;
+        }
+        // 检查是否过期
+        if (item.expiresAt && Date.now() >= item.expiresAt) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+   * 删除缓存
+   */ delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+   * 清除所有缓存
+   */ clear() {
+        this.cache.clear();
+    }
+    /**
+   * 获取缓存大小
+   */ size() {
+        return this.cache.size;
+    }
+    /**
+   * 获取所有键
+   */ keys() {
+        return Array.from(this.cache.keys());
+    }
+    /**
+   * 获取最旧的键
+   */ getOldestKey() {
+        let oldestKey = null;
+        let oldestTimestamp = Infinity;
+        for (const [key, item] of this.cache.entries()){
+            if (item.timestamp < oldestTimestamp) {
+                oldestTimestamp = item.timestamp;
+                oldestKey = key;
+            }
+        }
+        return oldestKey;
+    }
+    /**
+   * 获取缓存统计信息
+   */ getStatistics() {
+        const total = this.hits + this.misses;
+        const hitRate = total > 0 ? this.hits / total : 0;
+        return {
+            size: this.cache.size,
+            hits: this.hits,
+            misses: this.misses,
+            hitRate,
+            keys: Array.from(this.cache.keys())
+        };
+    }
+    /**
+   * 重置统计信息
+   */ resetStatistics() {
+        this.hits = 0;
+        this.misses = 0;
+    }
+    constructor(options){
+        _define_property(this, "cache", new Map());
+        _define_property(this, "defaultTTL", void 0);
+        _define_property(this, "maxSize", void 0);
+        _define_property(this, "hits", 0);
+        _define_property(this, "misses", 0);
+        this.defaultTTL = options?.defaultTTL;
+        this.maxSize = options?.maxSize;
+    }
+}
+
+//# sourceMappingURL=CacheManager.js.map

package/dist/esm/managers/DictionaryManager/core/CacheManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/DictionaryManager/core/CacheManager.ts"],"sourcesContent":["/**\n * 缓存管理模块\n * 负责内存缓存管理\n */\n\n/**\n * 缓存项\n */\ninterface CacheItem<T> {\n  value: T;\n  timestamp: number;\n  expiresAt?: number;\n}\n\n/**\n * 缓存管理器\n */\nexport class CacheManager<T> {\n  private cache: Map<string, CacheItem<T>> = new Map();\n  private defaultTTL?: number;\n  private maxSize?: number;\n  private hits = 0;\n  private misses = 0;\n\n  constructor(options?: {\n    defaultTTL?: number;\n    maxSize?: number;\n  }) {\n    this.defaultTTL = options?.defaultTTL;\n    this.maxSize = options?.maxSize;\n  }\n\n  /**\n   * 获取缓存值\n   */\n  get(key: string): T | null {\n    const item = this.cache.get(key);\n    if (!item) {\n      this.misses++;\n      return null;\n    }\n\n    // 检查是否过期\n    if (item.expiresAt && Date.now() >= item.expiresAt) {\n      this.cache.delete(key);\n      this.misses++;\n      return null;\n    }\n\n    this.hits++;\n    return item.value;\n  }\n\n  /**\n   * 设置缓存值\n   */\n  set(key: string, value: T, ttl?: number): void {\n    const expiresAt = ttl\n      ? Date.now() + ttl\n      : this.defaultTTL\n        ? Date.now() + this.defaultTTL\n        : undefined;\n\n    const item: CacheItem<T> = {\n      value,\n      timestamp: Date.now(),\n      expiresAt,\n    };\n\n    // 检查大小限制\n    if (this.maxSize && this.cache.size >= this.maxSize) {\n      // 删除最旧的项\n      const oldestKey = this.getOldestKey();\n      if (oldestKey) {\n        this.cache.delete(oldestKey);\n      }\n    }\n\n    this.cache.set(key, item);\n  }\n\n  /**\n   * 检查是否存在\n   */\n  has(key: string): boolean {\n    const item = this.cache.get(key);\n    if (!item) {\n      return false;\n    }\n\n    // 检查是否过期\n    if (item.expiresAt && Date.now() >= item.expiresAt) {\n      this.cache.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * 删除缓存\n   */\n  delete(key: string): boolean {\n    return this.cache.delete(key);\n  }\n\n  /**\n   * 清除所有缓存\n   */\n  clear(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * 获取缓存大小\n   */\n  size(): number {\n    return this.cache.size;\n  }\n\n  /**\n   * 获取所有键\n   */\n  keys(): string[] {\n    return Array.from(this.cache.keys());\n  }\n\n  /**\n   * 获取最旧的键\n   */\n  private getOldestKey(): string | null {\n    let oldestKey: string | null = null;\n    let oldestTimestamp = Infinity;\n\n    for (const [key, item] of this.cache.entries()) {\n      if (item.timestamp < oldestTimestamp) {\n        oldestTimestamp = item.timestamp;\n        oldestKey = key;\n      }\n    }\n\n    return oldestKey;\n  }\n\n  /**\n   * 获取缓存统计信息\n   */\n  getStatistics(): {\n    size: number;\n    hits: number;\n    misses: number;\n    hitRate: number;\n    keys: string[];\n  } {\n    const total = this.hits + this.misses;\n    const hitRate = total > 0 ? this.hits / total : 0;\n\n    return {\n      size: this.cache.size,\n      hits: this.hits,\n      misses: this.misses,\n      hitRate,\n      keys: Array.from(this.cache.keys()),\n    };\n  }\n\n  /**\n   * 重置统计信息\n   */\n  resetStatistics(): void {\n    this.hits = 0;\n    this.misses = 0;\n  }\n}\n"],"names":["CacheManager","get","key","item","cache","misses","expiresAt","Date","now","delete","hits","value","set","ttl","defaultTTL","undefined","timestamp","maxSize","size","oldestKey","getOldestKey","has","clear","keys","Array","from","oldestTimestamp","Infinity","entries","getStatistics","total","hitRate","resetStatistics","options","Map"],"mappings":"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"}

package/dist/esm/managers/DictionaryManager/core/ConcurrencyController.js

@@ -0,0 +1,156 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * 并发控制模块
+ * 控制字典管理操作的并发执行
+ * 支持 auto/queue/latest 三种策略
+ */ import { DictionaryError, DictionaryErrorCode } from "../types";
+/**
+ * 并发控制器
+ */ export class ConcurrencyController {
+    /**
+   * 执行操作（带并发控制）
+   */ async execute(operation, operationType) {
+        // auto 策略：根据操作类型自动选择策略
+        const actualStrategy = this.strategy === 'auto' ? this.selectStrategy(operationType) : this.strategy;
+        if (actualStrategy === 'none') {
+            // 无控制，直接执行
+            return operation();
+        }
+        return new Promise((resolve, reject)=>{
+            const taskId = `${Date.now()}_${Math.random()}`;
+            const version = actualStrategy === 'latest' ? ++this.versionCounter : undefined;
+            // 检查队列溢出
+            if (actualStrategy === 'queue' && this.queue.length >= this.maxQueueSize) {
+                reject(new DictionaryError(`Queue overflow: maximum queue size (${this.maxQueueSize}) exceeded`, DictionaryErrorCode.CONCURRENCY_ERROR));
+                return;
+            }
+            const task = {
+                id: taskId,
+                execute: operation,
+                resolve: resolve,
+                reject,
+                version,
+                operationType
+            };
+            // 设置超时
+            if (this.operationTimeout > 0) {
+                task.timeout = setTimeout(()=>{
+                    const index = this.queue.findIndex((t)=>t.id === taskId);
+                    if (index !== -1) {
+                        this.queue.splice(index, 1);
+                        reject(new DictionaryError(`Operation timeout after ${this.operationTimeout}ms`, DictionaryErrorCode.CONCURRENCY_ERROR));
+                    }
+                }, this.operationTimeout);
+            }
+            this.queue.push(task);
+            this.processQueue();
+        });
+    }
+    /**
+   * 根据操作类型选择策略（auto 模式）
+   */ selectStrategy(operationType) {
+        if (!operationType) {
+            return 'queue'; // 默认使用队列策略
+        }
+        // preload / refresh -> queue（保证顺序）
+        if (operationType === 'preload' || operationType === 'refresh' || operationType === 'batch') {
+            return 'queue';
+        }
+        // 高频 getDictionary -> latest（只应用最新）
+        if (operationType === 'getDictionary' || operationType === 'getDictionaryValue') {
+            return 'latest';
+        }
+        // 其他操作使用队列策略
+        return 'queue';
+    }
+    /**
+   * 处理队列
+   */ async processQueue() {
+        if (this.isProcessing || this.queue.length === 0) {
+            return;
+        }
+        this.isProcessing = true;
+        try {
+            while(this.queue.length > 0){
+                const actualStrategy = this.strategy === 'auto' ? this.selectStrategy(this.queue[0]?.operationType) : this.strategy;
+                if (actualStrategy === 'latest') {
+                    // 最新策略：只处理最新版本
+                    const latestVersion = Math.max(...this.queue.map((t)=>t.version || 0));
+                    const latestTasks = this.queue.filter((t)=>(t.version || 0) === latestVersion);
+                    // 执行最新版本的任务
+                    for (const task of latestTasks){
+                        await this.executeTask(task);
+                    }
+                    // 移除所有旧版本的任务
+                    this.queue = this.queue.filter((t)=>(t.version || 0) < latestVersion);
+                } else {
+                    // 串行队列：按顺序执行
+                    const task = this.queue.shift();
+                    if (task) {
+                        await this.executeTask(task);
+                    }
+                }
+            }
+        } finally{
+            this.isProcessing = false;
+        }
+    }
+    /**
+   * 执行任务
+   */ async executeTask(task) {
+        // 清除超时定时器
+        if (task.timeout) {
+            clearTimeout(task.timeout);
+        }
+        try {
+            const result = await task.execute();
+            task.resolve(result);
+        } catch (error) {
+            task.reject(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+   * 清除队列
+   */ clear() {
+        // 拒绝所有待处理的任务
+        for (const task of this.queue){
+            if (task.timeout) {
+                clearTimeout(task.timeout);
+            }
+            task.reject(new DictionaryError('Queue cleared', DictionaryErrorCode.CONCURRENCY_ERROR));
+        }
+        this.queue = [];
+        this.isProcessing = false;
+        this.versionCounter = 0;
+    }
+    /**
+   * 获取队列长度
+   */ getQueueLength() {
+        return this.queue.length;
+    }
+    constructor(options){
+        _define_property(this, "strategy", void 0);
+        _define_property(this, "maxQueueSize", void 0);
+        _define_property(this, "operationTimeout", void 0);
+        _define_property(this, "queue", []);
+        _define_property(this, "isProcessing", false);
+        _define_property(this, "versionCounter", 0);
+        this.strategy = options.strategy;
+        this.maxQueueSize = options.maxQueueSize;
+        this.operationTimeout = options.operationTimeout;
+    }
+}
+
+//# sourceMappingURL=ConcurrencyController.js.map

package/dist/esm/managers/DictionaryManager/core/ConcurrencyController.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/DictionaryManager/core/ConcurrencyController.ts"],"sourcesContent":["/**\n * 并发控制模块\n * 控制字典管理操作的并发执行\n * 支持 auto/queue/latest 三种策略\n */\n\nimport { DictionaryError, DictionaryErrorCode } from '../types';\n\n/**\n * 操作任务\n */\ninterface OperationTask {\n  id: string;\n  execute: () => Promise<unknown>;\n  resolve: (value: unknown) => void;\n  reject: (error: Error) => void;\n  version?: number;\n  timeout?: NodeJS.Timeout;\n  operationType?: string; // 操作类型，用于 auto 策略\n}\n\n/**\n * 并发控制器\n */\nexport class ConcurrencyController {\n  private strategy: 'auto' | 'queue' | 'latest';\n  private maxQueueSize: number;\n  private operationTimeout: number;\n  private queue: OperationTask[] = [];\n  private isProcessing = false;\n  private versionCounter = 0;\n\n  constructor(options: {\n    strategy: 'auto' | 'queue' | 'latest';\n    maxQueueSize: number;\n    operationTimeout: number;\n  }) {\n    this.strategy = options.strategy;\n    this.maxQueueSize = options.maxQueueSize;\n    this.operationTimeout = options.operationTimeout;\n  }\n\n  /**\n   * 执行操作（带并发控制）\n   */\n  async execute<T>(\n    operation: () => Promise<T>,\n    operationType?: string\n  ): Promise<T> {\n    // auto 策略：根据操作类型自动选择策略\n    const actualStrategy = this.strategy === 'auto' \n      ? this.selectStrategy(operationType)\n      : this.strategy;\n\n    if (actualStrategy === 'none') {\n      // 无控制，直接执行\n      return operation();\n    }\n\n    return new Promise<T>((resolve, reject) => {\n      const taskId = `${Date.now()}_${Math.random()}`;\n      const version = actualStrategy === 'latest' ? ++this.versionCounter : undefined;\n\n      // 检查队列溢出\n      if (actualStrategy === 'queue' && this.queue.length >= this.maxQueueSize) {\n        reject(new DictionaryError(\n          `Queue overflow: maximum queue size (${this.maxQueueSize}) exceeded`,\n          DictionaryErrorCode.CONCURRENCY_ERROR\n        ));\n        return;\n      }\n\n      const task: OperationTask = {\n        id: taskId,\n        execute: operation as () => Promise<unknown>,\n        resolve: resolve as (value: unknown) => void,\n        reject,\n        version,\n        operationType,\n      };\n\n      // 设置超时\n      if (this.operationTimeout > 0) {\n        task.timeout = setTimeout(() => {\n          const index = this.queue.findIndex(t => t.id === taskId);\n          if (index !== -1) {\n            this.queue.splice(index, 1);\n            reject(new DictionaryError(\n              `Operation timeout after ${this.operationTimeout}ms`,\n              DictionaryErrorCode.CONCURRENCY_ERROR\n            ));\n          }\n        }, this.operationTimeout);\n      }\n\n      this.queue.push(task);\n      this.processQueue();\n    });\n  }\n\n  /**\n   * 根据操作类型选择策略（auto 模式）\n   */\n  private selectStrategy(operationType?: string): 'queue' | 'latest' | 'none' {\n    if (!operationType) {\n      return 'queue'; // 默认使用队列策略\n    }\n\n    // preload / refresh -> queue（保证顺序）\n    if (operationType === 'preload' || operationType === 'refresh' || operationType === 'batch') {\n      return 'queue';\n    }\n\n    // 高频 getDictionary -> latest（只应用最新）\n    if (operationType === 'getDictionary' || operationType === 'getDictionaryValue') {\n      return 'latest';\n    }\n\n    // 其他操作使用队列策略\n    return 'queue';\n  }\n\n  /**\n   * 处理队列\n   */\n  private async processQueue(): Promise<void> {\n    if (this.isProcessing || this.queue.length === 0) {\n      return;\n    }\n\n    this.isProcessing = true;\n\n    try {\n      while (this.queue.length > 0) {\n        const actualStrategy = this.strategy === 'auto' \n          ? this.selectStrategy(this.queue[0]?.operationType)\n          : this.strategy;\n\n        if (actualStrategy === 'latest') {\n          // 最新策略：只处理最新版本\n          const latestVersion = Math.max(...this.queue.map(t => t.version || 0));\n          const latestTasks = this.queue.filter(t => (t.version || 0) === latestVersion);\n          \n          // 执行最新版本的任务\n          for (const task of latestTasks) {\n            await this.executeTask(task);\n          }\n          \n          // 移除所有旧版本的任务\n          this.queue = this.queue.filter(t => (t.version || 0) < latestVersion);\n        } else {\n          // 串行队列：按顺序执行\n          const task = this.queue.shift();\n          if (task) {\n            await this.executeTask(task);\n          }\n        }\n      }\n    } finally {\n      this.isProcessing = false;\n    }\n  }\n\n  /**\n   * 执行任务\n   */\n  private async executeTask(task: OperationTask): Promise<void> {\n    // 清除超时定时器\n    if (task.timeout) {\n      clearTimeout(task.timeout);\n    }\n\n    try {\n      const result = await task.execute();\n      task.resolve(result);\n    } catch (error) {\n      task.reject(error instanceof Error ? error : new Error(String(error)));\n    }\n  }\n\n  /**\n   * 清除队列\n   */\n  clear(): void {\n    // 拒绝所有待处理的任务\n    for (const task of this.queue) {\n      if (task.timeout) {\n        clearTimeout(task.timeout);\n      }\n      task.reject(new DictionaryError(\n        'Queue cleared',\n        DictionaryErrorCode.CONCURRENCY_ERROR\n      ));\n    }\n    this.queue = [];\n    this.isProcessing = false;\n    this.versionCounter = 0;\n  }\n\n  /**\n   * 获取队列长度\n   */\n  getQueueLength(): number {\n    return this.queue.length;\n  }\n}\n"],"names":["DictionaryError","DictionaryErrorCode","ConcurrencyController","execute","operation","operationType","actualStrategy","strategy","selectStrategy","Promise","resolve","reject","taskId","Date","now","Math","random","version","versionCounter","undefined","queue","length","maxQueueSize","CONCURRENCY_ERROR","task","id","operationTimeout","timeout","setTimeout","index","findIndex","t","splice","push","processQueue","isProcessing","latestVersion","max","map","latestTasks","filter","executeTask","shift","clearTimeout","result","error","Error","String","clear","getQueueLength","options"],"mappings":"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"}