@vlian/infrastructure 0.9.10

package/dist/cjs/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":["DictionaryManager","initializeModules","options","storage","enablePersistentCache","storageManager","StorageManager","strategy","environment","logger","errorHandler","ErrorHandler","monitoring","sanitizeErrors","isProduction","loggingManager","LoggingManager","enableLogging","context","instanceId","monitoringManager","MonitoringManager","enableMonitoring","performanceMonitor","PerformanceMonitor","enableDetailedMetrics","eventManager","EventManager","eventBus","eventNamespace","enableEvents","debug","args","error","undefined","trackEvent","name","props","captureError","ctx","stateManager","StateManagerWrapper","cacheManager","CacheManager","defaultTTL","cacheExpiry","concurrencyController","ConcurrencyController","concurrencyStrategy","maxQueueSize","operationTimeout","indexManager","IndexManager","indexKeyField","keyField","enableIndex","diffCalculator","DiffCalculator","itemComparator","itemChangeDetector","validator","DictionaryValidator","dictionaryValidator","dataManager","DictionaryDataManager","dictionaryFetcher","dictionariesFetcher","dictionaryConfig","enableCache","dictionaryKeyPrefix","formatter","DictionaryFormatter","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","DictionaryEventType","DICTIONARY_LOADED","timestamp","getDictionarySync","_options","getDictionaryValue","key","item","find","itemKey","String","getLabel","getDictionaryValueSync","formatDictionary","value","format","defaultValue","getDictionaries","codes","dictionaries","count","getDictionariesSync","getDictionaryValues","queries","DictionaryBatchProcessor","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","EnvironmentDetector","detectEnvironment","checkIsProduction","Math","random","toString","substr","DEFAULT_OPTIONS","PRODUCTION_OVERRIDES","validation","errorMsg","join","devMode","DictionaryError","DictionaryErrorCode","CONFIG_ERROR","forEach","warning","warn"],"mappings":"AAAA;;;;;;CAMC;;;;+BA4EYA;;;eAAAA;;;uBArDN;2BAC+C;sBAW/C;qCAG6B;0CACK;+BAQlC;yBAG2D;;;;;;;;;;;;;;AA0B3D,IAAA,AAAMA,oBAAN,MAAMA;IAsGX;;GAEC,GACD,AAAQC,oBAA0B;QAChC,UAAU;QACV,IAAI,IAAI,CAACC,OAAO,CAACC,OAAO,IAAI,IAAI,CAACD,OAAO,CAACE,qBAAqB,EAAE;YAC9D,IAAI,CAACC,cAAc,GAAG,IAAIC,uBAAc,CAAC;gBACvCH,SAAS,IAAI,CAACD,OAAO,CAACC,OAAO,IAAI;oBAAEI,UAAU;gBAAQ;gBACrDC,aAAa,IAAI,CAACA,WAAW;gBAC7BC,QAAQ,IAAI,CAACP,OAAO,CAACO,MAAM;YAC7B;QACF;QAEA,IAAI,CAACC,YAAY,GAAG,IAAIC,qBAAY,CAAC;YACnCF,QAAQ,IAAI,CAACP,OAAO,CAACO,MAAM;YAC3BG,YAAY,IAAI,CAACV,OAAO,CAACU,UAAU;YACnCC,gBAAgB,IAAI,CAACC,YAAY;QACnC;QAEA,sBAAsB;QACtB,IAAI,CAACC,cAAc,GAAG,IAAIC,6BAAc,CAAC;YACvCP,QAAQ,IAAI,CAACP,OAAO,CAACO,MAAM;YAC3BQ,eAAe,IAAI,CAACf,OAAO,CAACe,aAAa;YACzCC,SAAS;gBAAEC,YAAY,IAAI,CAACA,UAAU;YAAC;QACzC;QAEA,IAAI,CAACC,iBAAiB,GAAG,IAAIC,gCAAiB,CAAC;YAC7CT,YAAY,IAAI,CAACV,OAAO,CAACU,UAAU;YACnCU,kBAAkB,IAAI,CAACpB,OAAO,CAACoB,gBAAgB;QACjD;QAEA,IAAI,CAACC,kBAAkB,GAAG,IAAIC,iCAAkB,CAAC;YAC/CZ,YAAY,IAAI,CAACV,OAAO,CAACU,UAAU;YACnCa,uBAAuB,IAAI,CAACvB,OAAO,CAACuB,qBAAqB;QAC3D;QAEA,IAAI,CAACC,YAAY,GAAG,IAAIC,2BAAY,CAAC;YACnCC,UAAU,IAAI,CAAC1B,OAAO,CAAC0B,QAAQ;YAC/BC,gBAAgB,IAAI,CAAC3B,OAAO,CAAC2B,cAAc;YAC3CC,cAAc,IAAI,CAAC5B,OAAO,CAAC4B,YAAY;YACvCrB,QAAQ,IAAI,CAACP,OAAO,CAACe,aAAa,GAAG;gBACnCc,OAAO,CAAC,GAAGC,OAAS,IAAI,CAACjB,cAAc,CAACgB,KAAK,IAAIC;gBACjDC,OAAO,CAAC,GAAGD,OAAS,IAAI,CAACjB,cAAc,CAACkB,KAAK,IAAID;YACnD,IAAIE;YACJtB,YAAY,IAAI,CAACV,OAAO,CAACoB,gBAAgB,GAAG;gBAC1Ca,YAAY,CAACC,MAAMC,QAAU,IAAI,CAACjB,iBAAiB,CAACe,UAAU,CAACC,MAAMC;gBACrEC,cAAc,CAACL,OAAOM,MAAQ,IAAI,CAACnB,iBAAiB,CAACkB,YAAY,CAACL,OAAOM;YAC3E,IAAIL;QACN;QAEA,aAAa;QACb,IAAI,CAACM,YAAY,GAAG,IAAI,CAACtC,OAAO,CAACsC,YAAY,GACzC,IAAIC,yBAAmB,CAAC;YACtBD,cAAc,IAAI,CAACtC,OAAO,CAACsC,YAAY;YACvC/B,QAAQ,IAAI,CAACP,OAAO,CAACO,MAAM;QAC7B,KACAyB;QAEJ,IAAI,CAACQ,YAAY,GAAG,IAAIC,kBAAY,CAAkC;YACpEC,YAAY,IAAI,CAAC1C,OAAO,CAAC2C,WAAW;QACtC;QAEA,IAAI,CAACC,qBAAqB,GAAG,IAAIC,2BAAqB,CAAC;YACrDxC,UAAU,IAAI,CAACL,OAAO,CAAC8C,mBAAmB;YAC1CC,cAAc,IAAI,CAAC/C,OAAO,CAAC+C,YAAY;YACvCC,kBAAkB,IAAI,CAAChD,OAAO,CAACgD,gBAAgB;QACjD;QAEA,IAAI,CAACC,YAAY,GAAG,IAAIC,kBAAY,CAAkB;YACpDC,eAAe,IAAI,CAACnD,OAAO,CAACmD,aAAa;YACzCC,UAAU,IAAI,CAACpD,OAAO,CAACoD,QAAQ;YAC/BC,aAAa,IAAI,CAACrD,OAAO,CAACqD,WAAW;QACvC;QAEA,IAAI,CAACC,cAAc,GAAG,IAAIC,oBAAc,CAAkB;YACxDC,gBAAgB,IAAI,CAACxD,OAAO,CAACwD,cAAc;YAC3CC,oBAAoB,IAAI,CAACzD,OAAO,CAACyD,kBAAkB;YACnDN,eAAe,IAAI,CAACnD,OAAO,CAACmD,aAAa,IAAI,IAAI,CAACnD,OAAO,CAACoD,QAAQ;QACpE;QAEA,IAAI,CAACM,SAAS,GAAG,IAAIC,yBAAmB,CAAkB;YACxDD,WAAW,IAAI,CAAC1D,OAAO,CAAC4D,mBAAmB;QAC7C;QAEA,IAAI,CAACC,WAAW,GAAG,IAAIC,2BAAqB,CAAkB;YAC5DtB,cAAc,IAAI,CAACA,YAAY;YAC/BF,cAAc,IAAI,CAACA,YAAY;YAC/BnC,gBAAgB,IAAI,CAACA,cAAc;YACnC8C,cAAc,IAAI,CAACA,YAAY;YAC/BS,WAAW,IAAI,CAACA,SAAS;YACzBK,mBAAmB,IAAI,CAAC/D,OAAO,CAAC+D,iBAAiB;YACjDC,qBAAqB,IAAI,CAAChE,OAAO,CAACgE,mBAAmB;YACrDC,kBAAkB,IAAI,CAACjE,OAAO,CAACiE,gBAAgB;YAC/CC,aAAa,IAAI,CAAClE,OAAO,CAACkE,WAAW;YACrChE,uBAAuB,IAAI,CAACF,OAAO,CAACE,qBAAqB;YACzDyC,aAAa,IAAI,CAAC3C,OAAO,CAAC2C,WAAW;YACrCwB,qBAAqB,IAAI,CAACnE,OAAO,CAACmE,mBAAmB;QACvD;QAEA,gBAAgB;QAChB,IAAI,CAACC,SAAS,GAAG,IAAIC,wCAAmB,CAAkB;YACxDD,WAAW,IAAI,CAACpE,OAAO,CAACoE,SAAS;YACjChB,UAAU,IAAI,CAACpD,OAAO,CAACoD,QAAQ;YAC/BkB,YAAY,IAAI,CAACtE,OAAO,CAACsE,UAAU;QACrC;IACF;IAEA;;GAEC,GACD,MAAcC,wBAAuC;QACnD,IAAI,IAAI,CAACvE,OAAO,CAACwE,mBAAmB,IAAI,IAAI,CAACxE,OAAO,CAACwE,mBAAmB,CAACC,MAAM,GAAG,GAAG;YACnF,eAAe;YACf,IAAI,CAACD,mBAAmB,CAAC,IAAI,CAACxE,OAAO,CAACwE,mBAAmB,EAAEE,KAAK,CAAC,CAAC3C;gBAChE,IAAI,CAACvB,YAAY,CAACmE,WAAW,CAAC5C,OAAO;oBAAE6C,WAAW;gBAAc;YAClE;QACF;IACF;IAEA;;GAEC,GACD,AAAQC,eAAe7E,OAAmD,EAIxE;QACA,MAAM8E,SAAmB,EAAE;QAC3B,MAAMC,WAAqB,EAAE;QAE7B,SAAS;QACT,IAAI,CAAC/E,QAAQ+D,iBAAiB,IAAI,CAAC/D,QAAQgE,mBAAmB,IAAI,CAAChE,QAAQiE,gBAAgB,EAAE;YAC3Fc,SAASC,IAAI,CAAC;QAChB;QAEA,SAAS;QACT,IAAIhF,QAAQqD,WAAW,IAAI,CAACrD,QAAQmD,aAAa,IAAI,CAACnD,QAAQoD,QAAQ,EAAE;YACtE0B,OAAOE,IAAI,CAAC;QACd;QAEA,OAAO;YACLC,OAAOH,OAAOL,MAAM,KAAK;YACzBK;YACAC;QACF;IACF;IAEA;;GAEC,GACD,MAAMG,cACJC,IAAY,EACZnF,OAA8B,EACF;QAC5B,MAAMoF,YAAYC,KAAKC,GAAG;QAC1B,MAAMC,gBAAgB;QAEtB,OAAO,IAAI,CAAC3C,qBAAqB,CAAC4C,OAAO,CACvC;YACE,IAAI;gBACF,MAAMC,QAAQ,MAAM,IAAI,CAAC5B,WAAW,CAACqB,aAAa,CAACC,MAAM;oBACvDO,OAAO1F,SAAS0F;oBAChBC,oBAAoB3F,SAAS2F;gBAC/B;gBAEA,SAAS;gBACT,MAAMC,WAAWP,KAAKC,GAAG,KAAKF;gBAC9B,IAAI,CAAC/D,kBAAkB,CAACwE,YAAY,CAACN,eAAeK,UAAU;oBAAET;gBAAK;gBAErE,OAAO;gBACP,IAAI,CAAC3D,YAAY,CAACsE,SAAS,CAACC,0BAAmB,CAACC,iBAAiB,EAAE;oBACjEb;oBACAM;oBACAQ,WAAWZ,KAAKC,GAAG;gBACrB;gBAEA,OAAOG;YACT,EAAE,OAAO1D,OAAO;gBACd,MAAM6D,WAAWP,KAAKC,GAAG,KAAKF;gBAC9B,IAAI,CAAC/D,kBAAkB,CAACwE,YAAY,CAACN,eAAeK,UAAU;oBAAET;oBAAMpD,OAAO;gBAAK;gBAClF,MAAM,IAAI,CAACvB,YAAY,CAACmE,WAAW,CAAC5C,OAAO;oBAAE6C,WAAWW;oBAAeJ;gBAAK;YAC9E;QACF,GACAI;IAEJ;IAEA;;GAEC,GACDW,kBACEf,IAAY,EACZgB,QAAmC,EAChB;QACnB,MAAMV,QAAQ,IAAI,CAAC5B,WAAW,CAACqC,iBAAiB,CAACf;QACjD,OAAOM,SAAS,EAAE;IACpB;IAEA;;GAEC,GACD,MAAMW,mBACJjB,IAAY,EACZkB,GAAoB,EACpBrG,OAA8B,EACN;QACxB,MAAMyF,QAAQ,MAAM,IAAI,CAACP,aAAa,CAACC,MAAMnF;QAC7C,MAAMsG,OAAOb,MAAMc,IAAI,CAAC,CAACD;YACvB,MAAME,UAAU,AAACF,IAAgC,CAAC,IAAI,CAACtG,OAAO,CAACoD,QAAQ,CAAC;YACxE,OAAOqD,OAAOD,aAAaC,OAAOJ;QACpC;QAEA,IAAI,CAACC,MAAM;YACT,OAAO;QACT;QAEA,OAAO,IAAI,CAAClC,SAAS,CAACsC,QAAQ,CAACJ;IACjC;IAEA;;GAEC,GACDK,uBACExB,IAAY,EACZkB,GAAoB,EACpBF,QAAmC,EACpB;QACf,MAAMV,QAAQ,IAAI,CAACS,iBAAiB,CAACf;QACrC,MAAMmB,OAAOb,MAAMc,IAAI,CAAC,CAACD;YACvB,MAAME,UAAU,AAACF,IAAgC,CAAC,IAAI,CAACtG,OAAO,CAACoD,QAAQ,CAAC;YACxE,OAAOqD,OAAOD,aAAaC,OAAOJ;QACpC;QAEA,IAAI,CAACC,MAAM;YACT,OAAO;QACT;QAEA,OAAO,IAAI,CAAClC,SAAS,CAACsC,QAAQ,CAACJ;IACjC;IAEA;;GAEC,GACD,MAAMM,iBACJzB,IAAY,EACZ0B,KAAsB,EACtB7G,OAAiC,EAChB;QACjB,MAAMyF,QAAQ,MAAM,IAAI,CAACP,aAAa,CAACC;QACvC,MAAMmB,OAAOb,MAAMc,IAAI,CAAC,CAACD;YACvB,MAAME,UAAU,AAACF,IAAgC,CAAC,IAAI,CAACtG,OAAO,CAACoD,QAAQ,CAAC;YACxE,OAAOqD,OAAOD,aAAaC,OAAOI;QACpC;QAEA,OAAO,IAAI,CAACzC,SAAS,CAAC0C,MAAM,CAACR,QAAQ,MAAMO,OAAO7G,SAAS+G;IAC7D;IAEA;;GAEC,GACD,MAAMC,gBACJC,KAAe,EACfjH,OAA8B,EACc;QAC5C,MAAMoF,YAAYC,KAAKC,GAAG;QAC1B,MAAMC,gBAAgB;QAEtB,OAAO,IAAI,CAAC3C,qBAAqB,CAAC4C,OAAO,CACvC;YACE,IAAI;gBACF,MAAM0B,eAAe,MAAM,IAAI,CAACrD,WAAW,CAACmD,eAAe,CAACC,OAAO;oBACjEvB,OAAO1F,SAAS0F;oBAChBC,oBAAoB3F,SAAS2F;gBAC/B;gBAEA,MAAMC,WAAWP,KAAKC,GAAG,KAAKF;gBAC9B,IAAI,CAAC/D,kBAAkB,CAACwE,YAAY,CAACN,eAAeK,UAAU;oBAAEuB,OAAOF,MAAMxC,MAAM;gBAAC;gBAEpF,OAAOyC;YACT,EAAE,OAAOnF,OAAO;gBACd,MAAM6D,WAAWP,KAAKC,GAAG,KAAKF;gBAC9B,IAAI,CAAC/D,kBAAkB,CAACwE,YAAY,CAACN,eAAeK,UAAU;oBAAEuB,OAAOF,MAAMxC,MAAM;oBAAE1C,OAAO;gBAAK;gBACjG,MAAM,IAAI,CAACvB,YAAY,CAACmE,WAAW,CAAC5C,OAAO;oBAAE6C,WAAWW;oBAAe0B;gBAAM;YAC/E;QACF,GACA1B;IAEJ;IAEA;;GAEC,GACD6B,oBACEH,KAAe,EACfd,QAAmC,EACA;QACnC,OAAO,IAAI,CAACtC,WAAW,CAACuD,mBAAmB,CAACH;IAC9C;IAEA;;GAEC,GACD,MAAMI,oBACJC,OAA+B,EAC/BtH,OAA8B,EACU;QACxC,OAAOuH,kDAAwB,CAACF,mBAAmB,CACjDC,SACA,OAAOnC,MAAMkB;YACX,MAAMZ,QAAQ,MAAM,IAAI,CAACP,aAAa,CAACC,MAAMnF;YAC7C,OAAOyF,MAAMc,IAAI,CAAC,CAACD;gBACjB,MAAME,UAAU,AAACF,IAAgC,CAAC,IAAI,CAACtG,OAAO,CAACoD,QAAQ,CAAC;gBACxE,OAAOqD,OAAOD,aAAaC,OAAOJ;YACpC,MAAM;QACR,GACA,CAACC,OAAS,IAAI,CAAClC,SAAS,CAACsC,QAAQ,CAACJ;IAEtC;IAEA;;GAEC,GACDkB,wBACEF,OAA+B,EAC/BnB,QAAmC,EACJ;QAC/B,OAAOoB,kDAAwB,CAACC,uBAAuB,CACrDF,SACA,CAACnC,MAAMkB;YACL,MAAMZ,QAAQ,IAAI,CAACS,iBAAiB,CAACf;YACrC,OAAOM,MAAMc,IAAI,CAAC,CAACD;gBACjB,MAAME,UAAU,AAACF,IAAgC,CAAC,IAAI,CAACtG,OAAO,CAACoD,QAAQ,CAAC;gBACxE,OAAOqD,OAAOD,aAAaC,OAAOJ;YACpC,MAAM;QACR,GACA,CAACC,OAAS,IAAI,CAAClC,SAAS,CAACsC,QAAQ,CAACJ;IAEtC;IAEA;;GAEC,GACD,MAAMmB,2BAA8C;QAClD,MAAMR,QAAkB,EAAE;QAE1B,QAAQ;QACRA,MAAMjC,IAAI,IAAI,IAAI,CAACnB,WAAW,CAAC6D,4BAA4B;QAE3D,QAAQ;QACR,IAAI,IAAI,CAAC1H,OAAO,CAACiE,gBAAgB,EAAE;YACjC,KAAK,MAAMkB,QAAQwC,OAAOC,IAAI,CAAC,IAAI,CAAC5H,OAAO,CAACiE,gBAAgB,EAAG;gBAC7D,IAAI,CAACgD,MAAMY,QAAQ,CAAC1C,OAAO;oBACzB8B,MAAMjC,IAAI,CAACG;gBACb;YACF;QACF;QAEA,OAAO8B;IACT;IAEA;;GAEC,GACDS,+BAAyC;QACvC,OAAO,IAAI,CAAC7D,WAAW,CAAC6D,4BAA4B;IACtD;IAEA;;GAEC,GACD,MAAMI,kBAAkB3C,IAAa,EAAEO,QAAiB,IAAI,EAAiB;QAC3E,MAAMN,YAAYC,KAAKC,GAAG;QAC1B,MAAMC,gBAAgB;QAEtB,OAAO,IAAI,CAAC3C,qBAAqB,CAAC4C,OAAO,CACvC;YACE,IAAI;gBACF,IAAIL,MAAM;oBACR,MAAM,IAAI,CAACtB,WAAW,CAACqB,aAAa,CAACC,MAAM;wBAAEO;wBAAOC,oBAAoB;oBAAM;gBAChF,OAAO;oBACL,SAAS;oBACT,MAAMsB,QAAQ,MAAM,IAAI,CAACQ,wBAAwB;oBACjD,MAAM,IAAI,CAAC5D,WAAW,CAACmD,eAAe,CAACC,OAAO;wBAAEvB;wBAAOC,oBAAoB;oBAAM;gBACnF;gBAEA,MAAMC,WAAWP,KAAKC,GAAG,KAAKF;gBAC9B,IAAI,CAAC/D,kBAAkB,CAACwE,YAAY,CAACN,eAAeK,UAAU;oBAAET,MAAMA,QAAQ;gBAAM;gBAEpF,IAAI,CAAC3D,YAAY,CAACsE,SAAS,CAACC,0BAAmB,CAACgC,oBAAoB,EAAE;oBACpE5C,MAAMA,QAAQ;oBACdc,WAAWZ,KAAKC,GAAG;gBACrB;YACF,EAAE,OAAOvD,OAAO;gBACd,MAAM6D,WAAWP,KAAKC,GAAG,KAAKF;gBAC9B,IAAI,CAAC/D,kBAAkB,CAACwE,YAAY,CAACN,eAAeK,UAAU;oBAAET,MAAMA,QAAQ;oBAAOpD,OAAO;gBAAK;gBACjG,MAAM,IAAI,CAACvB,YAAY,CAACmE,WAAW,CAAC5C,OAAO;oBAAE6C,WAAWW;oBAAeJ;gBAAK;YAC9E;QACF,GACAI;IAEJ;IAEA;;GAEC,GACD,MAAMyC,oBAAoBf,KAAe,EAAEvB,QAAiB,IAAI,EAAiB;QAC/E,MAAM,IAAI,CAAC7B,WAAW,CAACmD,eAAe,CAACC,OAAO;YAAEvB;YAAOC,oBAAoB;QAAM;QAEjF,IAAI,CAACnE,YAAY,CAACsE,SAAS,CAACC,0BAAmB,CAACgC,oBAAoB,EAAE;YACpEd;YACAhB,WAAWZ,KAAKC,GAAG;QACrB;IACF;IAEA;;GAEC,GACD,MAAM2C,WAAW9C,IAAa,EAAiB;QAC7C,MAAM,IAAI,CAACtB,WAAW,CAACoE,UAAU,CAAC9C;QAElC,IAAI,CAAC3D,YAAY,CAACsE,SAAS,CAACC,0BAAmB,CAACmC,wBAAwB,EAAE;YACxE/C,MAAMA,QAAQ;YACdc,WAAWZ,KAAKC,GAAG;QACrB;IACF;IAEA;;GAEC,GACD,MAAMd,oBAAoByC,KAAe,EAAiB;QACxD,MAAM7B,YAAYC,KAAKC,GAAG;QAC1B,MAAMC,gBAAgB;QAEtB,OAAO,IAAI,CAAC3C,qBAAqB,CAAC4C,OAAO,CACvC;YACE,IAAI;gBACF,UAAU;gBACV,KAAK,MAAML,QAAQ8B,MAAO;oBACxB,IAAI,CAACkB,aAAa,CAACC,GAAG,CAACjD,MAAM;wBAAEA;wBAAMkD,QAAQ;oBAAU;gBACzD;gBAEA,MAAM,IAAI,CAACxE,WAAW,CAACmD,eAAe,CAACC,OAAO;oBAC5CvB,OAAO;oBACPC,oBAAoB,IAAI,CAAC3F,OAAO,CAACE,qBAAqB;gBACxD;gBAEA,UAAU;gBACV,KAAK,MAAMiF,QAAQ8B,MAAO;oBACxB,IAAI,CAACkB,aAAa,CAACC,GAAG,CAACjD,MAAM;wBAAEA;wBAAMkD,QAAQ;oBAAS;gBACxD;gBAEA,MAAMzC,WAAWP,KAAKC,GAAG,KAAKF;gBAC9B,IAAI,CAAC/D,kBAAkB,CAACwE,YAAY,CAACN,eAAeK,UAAU;oBAAEuB,OAAOF,MAAMxC,MAAM;gBAAC;gBAEpF,IAAI,CAACjD,YAAY,CAACsE,SAAS,CAACC,0BAAmB,CAACuC,oBAAoB,EAAE;oBACpErB;oBACAhB,WAAWZ,KAAKC,GAAG;gBACrB;YACF,EAAE,OAAOvD,OAAO;gBACd,UAAU;gBACV,KAAK,MAAMoD,QAAQ8B,MAAO;oBACxB,IAAI,CAACkB,aAAa,CAACC,GAAG,CAACjD,MAAM;wBAAEA;wBAAMkD,QAAQ;wBAAStG,OAAOA,iBAAiBwG,QAAQxG,QAAQ,IAAIwG,MAAM9B,OAAO1E;oBAAQ;gBACzH;gBAEA,MAAM6D,WAAWP,KAAKC,GAAG,KAAKF;gBAC9B,IAAI,CAAC/D,kBAAkB,CAACwE,YAAY,CAACN,eAAeK,UAAU;oBAAEuB,OAAOF,MAAMxC,MAAM;oBAAE1C,OAAO;gBAAK;gBACjG,MAAM,IAAI,CAACvB,YAAY,CAACmE,WAAW,CAAC5C,OAAO;oBAAE6C,WAAWW;oBAAe0B;gBAAM;YAC/E;QACF,GACA1B;IAEJ;IAEA;;GAEC,GACD,MAAMiD,iBAAiBrD,IAAa,EAA0D;QAC5F,IAAIA,MAAM;YACR,OAAO,IAAI,CAACgD,aAAa,CAACM,GAAG,CAACtD,SAAS;gBAAEA;gBAAMkD,QAAQ;YAAU;QACnE;QAEA,OAAOV,OAAOe,WAAW,CAAC,IAAI,CAACP,aAAa;IAC9C;IAEA;;GAEC,GACD,MAAMQ,yBACJxD,IAAY,EACZyD,QAAgB,EAChB5I,OAA8B,EACG;QACjC,MAAM,IAAI,CAAC6D,WAAW,CAACqB,aAAa,CAACC,MAAMnF;QAC3C,MAAM6I,iBAAiB,IAAI,CAAChF,WAAW,CAACiF,iBAAiB,CAAC3D;QAE1D,IAAI,CAAC0D,kBAAkB,CAACA,eAAeE,KAAK,EAAE;YAC5C,OAAO;QACT;QAEA,OAAO,IAAI,CAAC9F,YAAY,CAAC+F,cAAc,CAACH,eAAeE,KAAK,EAAEH;IAChE;IAEA;;GAEC,GACDK,6BACE9D,IAAY,EACZyD,QAAgB,EAChBzC,QAAmC,EACX;QACxB,MAAM0C,iBAAiB,IAAI,CAAChF,WAAW,CAACiF,iBAAiB,CAAC3D;QAE1D,IAAI,CAAC0D,kBAAkB,CAACA,eAAeE,KAAK,EAAE;YAC5C,OAAO;QACT;QAEA,OAAO,IAAI,CAAC9F,YAAY,CAAC+F,cAAc,CAACH,eAAeE,KAAK,EAAEH;IAChE;IAEA;;GAEC,GACD,MAAMM,mBACJ/D,IAAY,EACZnF,OAA8B,EACS;QACvC,MAAM,IAAI,CAACkF,aAAa,CAACC,MAAMnF;QAC/B,MAAM6I,iBAAiB,IAAI,CAAChF,WAAW,CAACiF,iBAAiB,CAAC3D;QAE1D,OAAO0D,gBAAgBE,SAAS,IAAII;IACtC;IAEA;;GAEC,GACDC,uBACEjE,IAAY,EACZgB,QAAmC,EACL;QAC9B,MAAM0C,iBAAiB,IAAI,CAAChF,WAAW,CAACiF,iBAAiB,CAAC3D;QAC1D,OAAO0D,gBAAgBE,SAAS,IAAII;IACtC;IAEA;;GAEC,GACD,MAAME,wBACJlE,IAAY,EACZmE,QAA2B,EAC3BC,QAA4B,EACc;QAC1C,MAAMC,MAAMD,YAAY,IAAI,CAAC1F,WAAW,CAACqC,iBAAiB,CAACf,SAAS,EAAE;QACtE,OAAO,IAAI,CAAC7B,cAAc,CAACmG,aAAa,CAACH,UAAUE;IACrD;IAEA;;GAEC,GACD,MAAME,qBACJvE,IAAY,EACZwE,IAAqC,EACtB;QACf,MAAMC,eAAe,IAAI,CAAC/F,WAAW,CAACqC,iBAAiB,CAACf,SAAS,EAAE;QAEnE,OAAO;QACP,MAAMmE,WAA8B;eAAIM;SAAa;QAErD,SAAS;QACT,KAAK,MAAMC,WAAWF,KAAKE,OAAO,CAAE;YAClC,MAAMd,QAAQO,SAASQ,SAAS,CAAC,CAACxD;gBAChC,MAAME,UAAU,AAACF,IAAgC,CAAC,IAAI,CAACtG,OAAO,CAACoD,QAAQ,CAAC;gBACxE,MAAM2G,aAAa,AAACF,OAAmC,CAAC,IAAI,CAAC7J,OAAO,CAACoD,QAAQ,CAAC;gBAC9E,OAAOqD,OAAOD,aAAaC,OAAOsD;YACpC;YACA,IAAIhB,UAAU,CAAC,GAAG;gBAChBO,SAASU,MAAM,CAACjB,OAAO;YACzB;QACF;QAEA,SAAS;QACTO,SAAStE,IAAI,IAAI2E,KAAKM,KAAK;QAE3B,SAAS;QACT,KAAK,MAAM,EAAEC,MAAM,EAAEC,KAAK,EAAE,IAAIR,KAAKS,OAAO,CAAE;YAC5C,MAAMrB,QAAQO,SAASQ,SAAS,CAAC,CAACxD;gBAChC,MAAME,UAAU,AAACF,IAAgC,CAAC,IAAI,CAACtG,OAAO,CAACoD,QAAQ,CAAC;gBACxE,MAAMiH,YAAY,AAACH,MAAkC,CAAC,IAAI,CAAClK,OAAO,CAACoD,QAAQ,CAAC;gBAC5E,OAAOqD,OAAOD,aAAaC,OAAO4D;YACpC;YACA,IAAItB,UAAU,CAAC,GAAG;gBAChBO,QAAQ,CAACP,MAAM,GAAGoB;YACpB;QACF;QAEA,QAAQ;QACR,MAAM,EAAEZ,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC1F,WAAW,CAACyG,aAAa,CAACnF,MAAMmE,UAAU,IAAI,CAACtJ,OAAO,CAACE,qBAAqB;QAE5G,qBAAqB;QACrB,IAAI,CAACsB,YAAY,CAACsE,SAAS,CAACC,0BAAmB,CAACwE,kBAAkB,EAAE;YAClEpF;YACAM,OAAO6D;YACPkB,eAAejB;YACfI;YACA1D,WAAWZ,KAAKC,GAAG;QACrB;IACF;IAEA;;GAEC,GACDmF,GACEC,KAA0B,EAC1BC,QAA4E,EAC5E3K,OAA8B,EAClB;QACZ,OAAO,IAAI,CAACwB,YAAY,CAACiJ,EAAE,CAACC,OAAOC,UAAU3K;IAC/C;IAEA;;GAEC,GACD4K,IACEF,KAA0B,EAC1BC,QAA6E,EACvE;QACN,IAAI,CAACnJ,YAAY,CAACoJ,GAAG,CAACF,OAAOC;IAC/B;IAEA;;GAEC,GACDE,KACEH,KAA0B,EAC1BC,QAA4E,EAChE;QACZ,OAAO,IAAI,CAACnJ,YAAY,CAACqJ,IAAI,CAACH,OAAOC;IACvC;IAEA;;GAEC,GACD,MAAMG,cAA0C;QAC9C,MAAMC,SAAsC,CAAC;QAE7C,OAAO;QACP,IAAI,IAAI,CAAC5K,cAAc,EAAE;YACvB,IAAI;gBACF,MAAM,IAAI,CAACA,cAAc,CAACsI,GAAG,CAAC;gBAC9BsC,OAAO9K,OAAO,GAAG;oBAAE+K,SAAS;gBAAK;YACnC,EAAE,OAAOjJ,OAAO;gBACdgJ,OAAO9K,OAAO,GAAG;oBACf+K,SAAS;oBACTjJ,OAAOA,iBAAiBwG,QAAQxG,MAAMkJ,OAAO,GAAGxE,OAAO1E;gBACzD;YACF;QACF;QAEA,SAAS;QACT,IAAI,IAAI,CAACO,YAAY,EAAE;YACrB,IAAI;gBACF,IAAI,CAACA,YAAY,CAACmG,GAAG,CAAC;gBACtBsC,OAAOzI,YAAY,GAAG;oBAAE0I,SAAS;gBAAK;YACxC,EAAE,OAAOjJ,OAAO;gBACdgJ,OAAOzI,YAAY,GAAG;oBACpB0I,SAAS;oBACTjJ,OAAOA,iBAAiBwG,QAAQxG,MAAMkJ,OAAO,GAAGxE,OAAO1E;gBACzD;YACF;QACF;QAEA,SAAS;QACT,IAAI,IAAI,CAAC/B,OAAO,CAAC4B,YAAY,EAAE;YAC7B,IAAI;gBACF,IAAI,CAACJ,YAAY,CAACsE,SAAS,CAACC,0BAAmB,CAACC,iBAAiB,EAAE;oBAAEb,MAAM;oBAAoBM,OAAO,EAAE;oBAAEQ,WAAWZ,KAAKC,GAAG;gBAAG;gBAChIyF,OAAOrJ,QAAQ,GAAG;oBAAEsJ,SAAS;gBAAK;YACpC,EAAE,OAAOjJ,OAAO;gBACdgJ,OAAOrJ,QAAQ,GAAG;oBAChBsJ,SAAS;oBACTjJ,OAAOA,iBAAiBwG,QAAQxG,MAAMkJ,OAAO,GAAGxE,OAAO1E;gBACzD;YACF;QACF;QAEA,MAAMiJ,UAAUrD,OAAOuD,MAAM,CAACH,QAAQI,KAAK,CAACC,CAAAA,QAASA,OAAOJ,YAAY;QAExE,OAAO;YACLA;YACAD;QACF;IACF;IAEA;;GAEC,GACDM,wBAA8C;QAC5C,OAAO,IAAI,CAAChK,kBAAkB,CAACiK,UAAU;IAC3C;IAEA;;GAEC,GACDC,0BAAgC;QAC9B,IAAI,CAAClK,kBAAkB,CAACmK,YAAY;IACtC;IAEA;;GAEC,GACDC,qBAAsC;QACpC,MAAMC,QAAQ,IAAI,CAAClJ,YAAY,CAACmJ,aAAa;QAC7C,OAAO;YACLC,MAAMF,MAAME,IAAI;YAChBC,MAAMH,MAAMG,IAAI;YAChBC,QAAQJ,MAAMI,MAAM;YACpBC,SAASL,MAAMK,OAAO;YACtBnE,MAAM8D,MAAM9D,IAAI;QAClB;IACF;IAEA;;GAEC,GACDoE,uBAA6B;QAC3B,IAAI,CAACxJ,YAAY,CAACyJ,eAAe;IACnC;IAEA;;GAEC,GACDC,UAAgB;QACd,SAAS;QACT,IAAI,CAAC1K,YAAY,CAAC2K,OAAO;QAEzB,OAAO;QACP,IAAI,CAAC3J,YAAY,CAAC4J,KAAK;QAEvB,UAAU;QACV,IAAI,CAACjE,aAAa,CAACiE,KAAK;QAExB,UAAU;QACV,IAAI,CAACxJ,qBAAqB,CAACwJ,KAAK;IAClC;IA5yBA;;GAEC,GACD,YAAYpM,OAA2C,CAAE;QAjCzD,uBAAQA,WAAR,KAAA;QACA,uBAAQM,eAAR,KAAA;QACA,uBAAQM,gBAAR,KAAA;QACA,uBAAQK,cAAR,KAAA;QAEA,OAAO;QACP,uBAAQd,kBAAR,KAAA;QACA,uBAAQmC,gBAAR,KAAA;QACA,uBAAQ9B,gBAAR,KAAA;QAEA,SAAS;QACT,uBAAQgC,gBAAR,KAAA;QACA,uBAAQI,yBAAR,KAAA;QACA,uBAAQK,gBAAR,KAAA;QACA,uBAAQK,kBAAR,KAAA;QACA,uBAAQI,aAAR,KAAA;QACA,uBAAQG,eAAR,KAAA;QAEA,YAAY;QACZ,uBAAQO,aAAR,KAAA;QAEA,kBAAkB;QAClB,uBAAQvD,kBAAR,KAAA;QACA,uBAAQK,qBAAR,KAAA;QACA,uBAAQG,sBAAR,KAAA;QACA,uBAAQG,gBAAR,KAAA;QAEA,QAAQ;QACR,uBAAQ2G,iBAA4C,IAAIgB;QAMtD,OAAO;QACP,IAAI,CAAC7I,WAAW,GAAG+L,4BAAmB,CAACC,iBAAiB;QACxD,IAAI,CAAC1L,YAAY,GAAGyL,4BAAmB,CAACE,iBAAiB;QACzD,IAAI,CAACtL,UAAU,GAAGjB,QAAQiB,UAAU,IAAI,CAAC,KAAK,EAAEoE,KAAKC,GAAG,GAAG,CAAC,EAAEkH,KAAKC,MAAM,GAAGC,QAAQ,CAAC,IAAIC,MAAM,CAAC,GAAG,IAAI;QAEvG,SAAS;QACT,IAAI,CAAC3M,OAAO,GAAG;YACb,GAAG4M,0BAAe;YAClB,GAAG5M,OAAO;YACVC,SAASD,QAAQC,OAAO;YACxBqC,cAActC,QAAQsC,YAAY;YAClCZ,UAAU1B,QAAQ0B,QAAQ;YAC1BnB,QAAQP,QAAQO,MAAM;YACtBG,YAAYV,QAAQU,UAAU;YAC9BqD,mBAAmB/D,QAAQ+D,iBAAiB;YAC5CC,qBAAqBhE,QAAQgE,mBAAmB;YAChDC,kBAAkBjE,QAAQiE,gBAAgB;YAC1CL,qBAAqB5D,QAAQ4D,mBAAmB;YAChDQ,WAAWpE,QAAQoE,SAAS;YAC5BnD,YAAY,IAAI,CAACA,UAAU;QAC7B;QAEA,WAAW;QACX,IAAI,IAAI,CAACL,YAAY,EAAE;YACrB,IAAI,CAACZ,OAAO,GAAG;gBACb,GAAG,IAAI,CAACA,OAAO;gBACf,GAAG6M,+BAAoB;YACzB;QACF;QAEA,OAAO;QACP,IAAI,IAAI,CAAC7M,OAAO,CAAC6E,cAAc,KAAK,OAAO;YACzC,MAAMiI,aAAa,IAAI,CAACjI,cAAc,CAAC,IAAI,CAAC7E,OAAO;YACnD,IAAI,CAAC8M,WAAW7H,KAAK,EAAE;gBACrB,MAAM8H,WAAW,CAAC,iCAAiC,EAAED,WAAWhI,MAAM,CAACkI,IAAI,CAAC,OAAO;gBACnF,IAAI,IAAI,CAAChN,OAAO,CAACiN,OAAO,EAAE;oBACxB,MAAM,IAAIC,sBAAe,CACvB,GAAGH,SAAS,YAAY,EAAED,WAAW/H,QAAQ,CAACiI,IAAI,CAAC,OAAO,EAC1DG,0BAAmB,CAACC,YAAY;gBAEpC,OAAO;oBACL,MAAM,IAAIF,sBAAe,CAACH,UAAUI,0BAAmB,CAACC,YAAY;gBACtE;YACF;YACA,IAAIN,WAAW/H,QAAQ,CAACN,MAAM,GAAG,KAAK,IAAI,CAACzE,OAAO,CAACiN,OAAO,EAAE;gBAC1DH,WAAW/H,QAAQ,CAACsI,OAAO,CAACC,CAAAA;oBAC1B,IAAI,CAACtN,OAAO,CAACO,MAAM,EAAEgN,KAAK,CAAC,gBAAgB,EAAED,SAAS;gBACxD;YACF;QACF;QAEA,QAAQ;QACR,IAAI,CAACvN,iBAAiB;QAEtB,SAAS;QACT,IAAI,IAAI,CAACC,OAAO,CAACiN,OAAO,IAAI,IAAI,CAACjN,OAAO,CAACe,aAAa,EAAE;YACtD,IAAI,CAACF,cAAc,EAAEgB,MAAM,iCAAiC;gBAC1DvB,aAAa,IAAI,CAACA,WAAW;gBAC7BM,cAAc,IAAI,CAACA,YAAY;gBAC/BK,YAAY,IAAI,CAACA,UAAU;YAC7B;QACF;QAEA,YAAY;QACZ,IAAI,CAACsD,qBAAqB;IAC5B;AAwuBF"}

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

@@ -0,0 +1,97 @@
+/**
+ * DictionaryManager 常量定义
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get DEFAULT_OPTIONS () {
+        return DEFAULT_OPTIONS;
+    },
+    get DICTIONARY_EVENT_TYPES () {
+        return DICTIONARY_EVENT_TYPES;
+    },
+    get PRODUCTION_OVERRIDES () {
+        return PRODUCTION_OVERRIDES;
+    }
+});
+const _types = require("./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();
+}
+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
+};
+const PRODUCTION_OVERRIDES = {
+    devMode: false,
+    enableDetailedMetrics: false
+};
+const DICTIONARY_EVENT_TYPES = {
+    DICTIONARY_LOADED: _types.DictionaryEventType.DICTIONARY_LOADED,
+    DICTIONARY_UPDATED: _types.DictionaryEventType.DICTIONARY_UPDATED,
+    DICTIONARY_REFRESHED: _types.DictionaryEventType.DICTIONARY_REFRESHED,
+    DICTIONARY_CACHED: _types.DictionaryEventType.DICTIONARY_CACHED,
+    DICTIONARY_CACHE_CLEARED: _types.DictionaryEventType.DICTIONARY_CACHE_CLEARED,
+    DICTIONARY_PRELOADED: _types.DictionaryEventType.DICTIONARY_PRELOADED
+};
+
+//# sourceMappingURL=constants.js.map

package/dist/cjs/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":["DEFAULT_OPTIONS","DICTIONARY_EVENT_TYPES","PRODUCTION_OVERRIDES","isProduction","process","env","NODE_ENV","globalThis","location","hostname","includes","isDevMode","DEBUG","eventNamespace","enableEvents","dictionaryKeyPrefix","enablePersistentCache","keyField","labelField","enableCache","cacheExpiry","undefined","enableIndex","concurrencyStrategy","maxQueueSize","operationTimeout","enableDiff","enableLogging","enableMonitoring","enableDetailedMetrics","isolationMode","devMode","validateConfig","DICTIONARY_LOADED","DictionaryEventType","DICTIONARY_UPDATED","DICTIONARY_REFRESHED","DICTIONARY_CACHED","DICTIONARY_CACHE_CLEARED","DICTIONARY_PRELOADED"],"mappings":"AAAA;;CAEC;;;;;;;;;;;QAkCYA;eAAAA;;QAsDAC;eAAAA;;QARAC;eAAAA;;;uBA9EuB;AAEpC;;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;AAKO,MAAMH,kBAAkB;IAC7B,OAAO;IACPa,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,SAASpB;IACTqB,gBAAgB;AAClB;AAKO,MAAM9B,uBAAuB;IAClC6B,SAAS;IACTF,uBAAuB;AACzB;AAKO,MAAM5B,yBAAyB;IACpCgC,mBAAmBC,0BAAmB,CAACD,iBAAiB;IACxDE,oBAAoBD,0BAAmB,CAACC,kBAAkB;IAC1DC,sBAAsBF,0BAAmB,CAACE,oBAAoB;IAC9DC,mBAAmBH,0BAAmB,CAACG,iBAAiB;IACxDC,0BAA0BJ,0BAAmB,CAACI,wBAAwB;IACtEC,sBAAsBL,0BAAmB,CAACK,oBAAoB;AAChE"}

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

@@ -0,0 +1,143 @@
+/**
+ * 缓存管理模块
+ * 负责内存缓存管理
+ */ /**
+ * 缓存项
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "CacheManager", {
+    enumerable: true,
+    get: function() {
+        return CacheManager;
+    }
+});
+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;
+}
+let CacheManager = 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/cjs/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/cjs/managers/DictionaryManager/core/ConcurrencyController.js

@@ -0,0 +1,164 @@
+/**
+ * 并发控制模块
+ * 控制字典管理操作的并发执行
+ * 支持 auto/queue/latest 三种策略
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "ConcurrencyController", {
+    enumerable: true,
+    get: function() {
+        return ConcurrencyController;
+    }
+});
+const _types = require("../types");
+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;
+}
+let ConcurrencyController = 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 _types.DictionaryError(`Queue overflow: maximum queue size (${this.maxQueueSize}) exceeded`, _types.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 _types.DictionaryError(`Operation timeout after ${this.operationTimeout}ms`, _types.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 _types.DictionaryError('Queue cleared', _types.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/cjs/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":["ConcurrencyController","execute","operation","operationType","actualStrategy","strategy","selectStrategy","Promise","resolve","reject","taskId","Date","now","Math","random","version","versionCounter","undefined","queue","length","maxQueueSize","DictionaryError","DictionaryErrorCode","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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"}