@vlian/infrastructure 0.9.10

package/dist/esm/managers/SystemConfigManager/core/ConfigDataManager.js

@@ -0,0 +1,361 @@
+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;
+}
+/**
+ * 配置数据管理模块（Core 层）
+ * 负责配置数据的获取、更新、缓存管理
+ */ import { SystemConfigError, SystemConfigErrorCode } from "../types";
+import { ConfigMerger } from "../runtime/ConfigMerger";
+/**
+ * 配置数据管理器
+ */ export class ConfigDataManager {
+    /**
+   * 获取配置值（异步）
+   */ async getConfig(key, options) {
+        const force = options?.force ?? false;
+        const usePersistentCache = options?.usePersistentCache ?? this.enablePersistentCache;
+        // 如果不强制刷新，先尝试从缓存获取
+        if (!force) {
+            const cached = this.getConfigFromCache(key, usePersistentCache);
+            if (cached !== null) {
+                return cached;
+            }
+        }
+        // 从配置数据获取（静态配置）
+        if (this.configData && typeof this.configData === 'object' && this.configData !== null && key in this.configData) {
+            let value = this.configData[key];
+            // 如果有默认配置，进行合并
+            if (this.defaultConfig) {
+                const defaultValue = this.defaultConfig[key];
+                if (defaultValue !== undefined && typeof value === 'object' && value !== null && typeof defaultValue === 'object' && defaultValue !== null) {
+                    value = this.configMerger.merge(defaultValue, value);
+                }
+            }
+            await this.setConfig(key, value, false);
+            return value;
+        }
+        // 从 API 获取
+        if (this.configFetcher) {
+            try {
+                const result = await this.configFetcher(key);
+                let value = key ? result[key] : result;
+                // 如果有默认配置，进行合并
+                if (value !== undefined && this.defaultConfig) {
+                    if (key && typeof value === 'object' && value !== null) {
+                        const defaultValue = this.defaultConfig[key];
+                        if (defaultValue !== undefined && typeof defaultValue === 'object' && defaultValue !== null) {
+                            value = this.configMerger.merge(defaultValue, value);
+                        }
+                    }
+                }
+                if (value !== undefined) {
+                    await this.setConfig(key, value, usePersistentCache);
+                    // 从服务器获取的配置，一致性级别为 synced
+                    this.consistencyManager.setConsistency(key, 'synced');
+                }
+                return value || null;
+            } catch (error) {
+                throw new SystemConfigError(`Failed to fetch config for key "${key}": ${error instanceof Error ? error.message : String(error)}`, SystemConfigErrorCode.NETWORK_ERROR, {
+                    key
+                }, error);
+            }
+        }
+        // 如果都没有，返回 null
+        return null;
+    }
+    /**
+   * 获取配置值（同步，仅读取缓存）
+   */ getConfigSync(key, options) {
+        const returnEmptyIfNotCached = options?.returnEmptyIfNotCached ?? true;
+        // 从内存缓存获取
+        const cached = this.cacheManager.get(key);
+        if (cached !== null) {
+            return cached;
+        }
+        // 从状态管理获取
+        if (this.stateManager) {
+            const stateValue = this.stateManager.get(key);
+            if (stateValue !== null) {
+                return stateValue;
+            }
+        }
+        // 从配置数据获取（静态配置）
+        if (this.configData && typeof this.configData === 'object' && this.configData !== null && key in this.configData) {
+            let value = this.configData[key];
+            // 如果有默认配置，进行合并
+            if (this.defaultConfig) {
+                const defaultValue = this.defaultConfig[key];
+                if (defaultValue !== undefined && typeof value === 'object' && value !== null && typeof defaultValue === 'object' && defaultValue !== null) {
+                    value = this.configMerger.merge(defaultValue, value);
+                }
+            }
+            return value;
+        }
+        // 如果允许返回空值，返回 null
+        if (returnEmptyIfNotCached) {
+            return null;
+        }
+        // 否则抛出错误
+        throw new SystemConfigError(`Config "${key}" not found in cache`, SystemConfigErrorCode.CONFIG_NOT_FOUND, {
+            key
+        });
+    }
+    /**
+   * 获取所有配置（异步）
+   */ async getAllConfig(options) {
+        const force = options?.force ?? false;
+        const usePersistentCache = options?.usePersistentCache ?? this.enablePersistentCache;
+        // 如果不强制刷新，先尝试从缓存获取
+        if (!force) {
+            const cached = this.getAllConfigFromCache(usePersistentCache);
+            if (cached) {
+                return cached;
+            }
+        }
+        // 从配置数据获取（静态配置）
+        if (this.configData) {
+            let config = this.configData;
+            // 如果有默认配置，进行合并
+            if (this.defaultConfig) {
+                config = this.configMerger.merge(this.defaultConfig, config);
+            }
+            await this.setAllConfig(config, false);
+            return config;
+        }
+        // 从 API 获取
+        if (this.configFetcher) {
+            try {
+                const result = await this.configFetcher();
+                let config = result || {};
+                // 如果有默认配置，进行合并
+                if (this.defaultConfig && typeof config === 'object' && config !== null) {
+                    config = this.configMerger.merge(this.defaultConfig, config);
+                }
+                await this.setAllConfig(config, usePersistentCache);
+                // 从服务器获取的配置，一致性级别为 synced
+                if (typeof config === 'object' && config !== null) {
+                    for (const key of Object.keys(config)){
+                        this.consistencyManager.setConsistency(key, 'synced');
+                    }
+                }
+                return config;
+            } catch (error) {
+                throw new SystemConfigError(`Failed to fetch all config: ${error instanceof Error ? error.message : String(error)}`, SystemConfigErrorCode.NETWORK_ERROR, undefined, error);
+            }
+        }
+        // 如果都没有，返回空对象
+        return {};
+    }
+    /**
+   * 获取所有配置（同步，仅读取缓存）
+   */ getAllConfigSync(options) {
+        const returnEmptyIfNotCached = options?.returnEmptyIfNotCached ?? true;
+        // 从内存缓存获取
+        const keys = this.cacheManager.keys();
+        if (keys.length > 0) {
+            const config = {};
+            for (const key of keys){
+                const value = this.cacheManager.get(key);
+                if (value !== null) {
+                    config[key] = value;
+                }
+            }
+            return config;
+        }
+        // 从状态管理获取
+        if (this.stateManager) {
+        // 注意：StateManager 可能不支持获取所有键，这里需要根据实际实现调整
+        // 暂时返回空对象
+        }
+        // 从配置数据获取（静态配置）
+        if (this.configData) {
+            return this.configData;
+        }
+        // 如果允许返回空值，返回空对象
+        if (returnEmptyIfNotCached) {
+            return {};
+        }
+        // 否则抛出错误
+        throw new SystemConfigError('Config not found in cache', SystemConfigErrorCode.CONFIG_NOT_FOUND);
+    }
+    /**
+   * 更新配置值
+   */ async setConfig(key, value, usePersistentCache) {
+        // 验证配置
+        const validationResult = this.validator.validate(key, value);
+        if (validationResult !== true) {
+            throw new SystemConfigError(`Config validation failed for key "${key}": ${validationResult}`, SystemConfigErrorCode.VALIDATION_FAILED, {
+                key,
+                value
+            });
+        }
+        // 更新内存缓存
+        if (this.enableCache) {
+            this.cacheManager.set(key, value, this.cacheExpiry);
+        }
+        // 更新状态管理
+        if (this.stateManager) {
+            this.stateManager.set(key, value);
+        }
+        // 更新持久化缓存
+        const shouldPersist = usePersistentCache ?? this.enablePersistentCache;
+        if (shouldPersist && this.storageManager) {
+            try {
+                const storageKey = `${this.configKeyPrefix}${key}`;
+                await this.storageManager.set(storageKey, JSON.stringify(value));
+            } catch (error) {
+                // 持久化失败不影响内存缓存
+                console.warn('Failed to persist config to storage:', error);
+            }
+        }
+        // 更新一致性级别为 local（本地已更新，但远程未同步）
+        this.consistencyManager.setConsistency(key, 'local');
+    }
+    /**
+   * 批量更新配置值
+   */ async setAllConfig(configs, usePersistentCache) {
+        // 验证所有配置
+        const validationResult = this.validator.validateAll(configs);
+        if (!validationResult.valid) {
+            throw new SystemConfigError(`Config validation failed: ${JSON.stringify(validationResult.errors)}`, SystemConfigErrorCode.VALIDATION_FAILED, {
+                errors: validationResult.errors
+            });
+        }
+        // 批量更新
+        for (const [key, value] of Object.entries(configs)){
+            await this.setConfig(key, value, usePersistentCache);
+        }
+    }
+    /**
+   * 从缓存获取配置
+   */ getConfigFromCache(key, _usePersistentCache) {
+        // 从内存缓存获取
+        const cached = this.cacheManager.get(key);
+        if (cached !== null) {
+            return cached;
+        }
+        // 从状态管理获取
+        if (this.stateManager) {
+            const stateValue = this.stateManager.get(key);
+            if (stateValue !== null) {
+                return stateValue;
+            }
+        }
+        // 从持久化缓存获取
+        if (_usePersistentCache && this.storageManager) {
+        // 注意：这里需要异步读取，但为了保持同步接口，暂时不实现
+        // 实际使用时应该通过异步方法获取
+        }
+        return null;
+    }
+    /**
+   * 从缓存获取所有配置
+   */ getAllConfigFromCache(_usePersistentCache) {
+        // 从内存缓存获取
+        const keys = this.cacheManager.keys();
+        if (keys.length > 0) {
+            const config = {};
+            for (const key of keys){
+                const value = this.cacheManager.get(key);
+                if (value !== null) {
+                    config[key] = value;
+                }
+            }
+            let mergedConfig = config;
+            // 如果有默认配置，进行合并
+            if (this.defaultConfig) {
+                mergedConfig = this.configMerger.merge(this.defaultConfig, mergedConfig);
+            }
+            return mergedConfig;
+        }
+        // 从配置数据获取（静态配置）
+        if (this.configData) {
+            let config = this.configData;
+            // 如果有默认配置，进行合并
+            if (this.defaultConfig) {
+                config = this.configMerger.merge(this.defaultConfig, config);
+            }
+            return config;
+        }
+        return null;
+    }
+    /**
+   * 删除配置
+   */ async deleteConfig(key) {
+        // 从内存缓存删除
+        this.cacheManager.delete(key);
+        // 从状态管理删除
+        if (this.stateManager) {
+            this.stateManager.remove(key);
+        }
+        // 从持久化缓存删除
+        if (this.storageManager) {
+            try {
+                const storageKey = `${this.configKeyPrefix}${key}`;
+                await this.storageManager.remove(storageKey);
+            } catch (error) {
+                console.warn('Failed to remove config from storage:', error);
+            }
+        }
+        // 删除一致性级别
+        this.consistencyManager.deleteConsistency(key);
+    }
+    /**
+   * 清除所有配置缓存
+   */ async clearCache(key) {
+        if (key) {
+            await this.deleteConfig(key);
+        } else {
+            // 清除所有缓存
+            this.cacheManager.clear();
+            this.consistencyManager.clear();
+            // 清除状态管理（如果支持）
+            if (this.stateManager) {
+                const keys = this.cacheManager.keys();
+                for (const configKey of keys){
+                    this.stateManager.remove(configKey);
+                }
+            }
+        }
+    }
+    constructor(options){
+        _define_property(this, "cacheManager", void 0);
+        _define_property(this, "stateManager", void 0);
+        _define_property(this, "storageManager", void 0);
+        _define_property(this, "validator", void 0);
+        _define_property(this, "consistencyManager", void 0);
+        _define_property(this, "configFetcher", void 0);
+        _define_property(this, "configData", void 0);
+        _define_property(this, "defaultConfig", void 0);
+        _define_property(this, "configMerger", void 0);
+        _define_property(this, "enableCache", void 0);
+        _define_property(this, "enablePersistentCache", void 0);
+        _define_property(this, "cacheExpiry", void 0);
+        _define_property(this, "configKeyPrefix", void 0);
+        this.cacheManager = options.cacheManager;
+        this.stateManager = options.stateManager;
+        this.storageManager = options.storageManager;
+        this.validator = options.validator;
+        this.consistencyManager = options.consistencyManager;
+        this.configFetcher = options.configFetcher;
+        this.configData = options.configData;
+        this.defaultConfig = options.defaultConfig;
+        this.enableCache = options.enableCache;
+        this.enablePersistentCache = options.enablePersistentCache;
+        this.cacheExpiry = options.cacheExpiry;
+        this.configKeyPrefix = options.configKeyPrefix;
+        this.configMerger = new ConfigMerger();
+    }
+}
+
+//# sourceMappingURL=ConfigDataManager.js.map

package/dist/esm/managers/SystemConfigManager/core/ConfigDataManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/SystemConfigManager/core/ConfigDataManager.ts"],"sourcesContent":["/**\n * 配置数据管理模块（Core 层）\n * 负责配置数据的获取、更新、缓存管理\n */\n\nimport { SystemConfigError, SystemConfigErrorCode } from '../types';\nimport { CacheManager } from './CacheManager';\nimport { StateManagerWrapper } from './StateManagerWrapper';\nimport { ConfigValidator } from './ConfigValidator';\nimport { ConsistencyManager } from './ConsistencyManager';\nimport { StorageManager } from '../modules/StorageManager';\nimport { ConfigMerger } from '../runtime/ConfigMerger';\n\n/**\n * 配置数据管理器\n */\nexport class ConfigDataManager<TConfig = Record<string, unknown>> {\n  private cacheManager: CacheManager<unknown>;\n  private stateManager?: StateManagerWrapper;\n  private storageManager?: StorageManager;\n  private validator: ConfigValidator;\n  private consistencyManager: ConsistencyManager;\n  \n  private configFetcher?: (key?: string) => Promise<TConfig | unknown>;\n  private configData?: TConfig;\n  private defaultConfig?: Partial<TConfig>;\n  private configMerger: ConfigMerger;\n  \n  private enableCache: boolean;\n  private enablePersistentCache: boolean;\n  private cacheExpiry?: number;\n  private configKeyPrefix: string;\n\n  constructor(options: {\n    cacheManager: CacheManager<unknown>;\n    stateManager?: StateManagerWrapper;\n    storageManager?: StorageManager;\n    validator: ConfigValidator;\n    consistencyManager: ConsistencyManager;\n    configFetcher?: (key?: string) => Promise<TConfig | unknown>;\n    configData?: TConfig;\n    defaultConfig?: Partial<TConfig>;\n    enableCache: boolean;\n    enablePersistentCache: boolean;\n    cacheExpiry?: number;\n    configKeyPrefix: string;\n  }) {\n    this.cacheManager = options.cacheManager;\n    this.stateManager = options.stateManager;\n    this.storageManager = options.storageManager;\n    this.validator = options.validator;\n    this.consistencyManager = options.consistencyManager;\n    this.configFetcher = options.configFetcher;\n    this.configData = options.configData;\n    this.defaultConfig = options.defaultConfig;\n    this.enableCache = options.enableCache;\n    this.enablePersistentCache = options.enablePersistentCache;\n    this.cacheExpiry = options.cacheExpiry;\n    this.configKeyPrefix = options.configKeyPrefix;\n    this.configMerger = new ConfigMerger();\n  }\n\n  /**\n   * 获取配置值（异步）\n   */\n  async getConfig<T = unknown>(\n    key: string,\n    options?: { force?: boolean; usePersistentCache?: boolean }\n  ): Promise<T | null> {\n    const force = options?.force ?? false;\n    const usePersistentCache = options?.usePersistentCache ?? this.enablePersistentCache;\n\n    // 如果不强制刷新，先尝试从缓存获取\n    if (!force) {\n      const cached = this.getConfigFromCache<T>(key, usePersistentCache);\n      if (cached !== null) {\n        return cached;\n      }\n    }\n\n    // 从配置数据获取（静态配置）\n    if (this.configData && typeof this.configData === 'object' && this.configData !== null && key in (this.configData as Record<string, unknown>)) {\n      let value = (this.configData as Record<string, unknown>)[key] as T;\n      \n      // 如果有默认配置，进行合并\n      if (this.defaultConfig) {\n        const defaultValue = (this.defaultConfig as Record<string, unknown>)[key];\n        if (defaultValue !== undefined && typeof value === 'object' && value !== null && typeof defaultValue === 'object' && defaultValue !== null) {\n          value = this.configMerger.merge(\n            defaultValue as Record<string, unknown>,\n            value as Record<string, unknown>\n          ) as T;\n        }\n      }\n      \n      await this.setConfig(key, value, false);\n      return value;\n    }\n\n    // 从 API 获取\n    if (this.configFetcher) {\n      try {\n        const result = await this.configFetcher(key);\n        let value = key ? (result as Record<string, unknown>)[key] as T : result as T;\n        \n        // 如果有默认配置，进行合并\n        if (value !== undefined && this.defaultConfig) {\n          if (key && typeof value === 'object' && value !== null) {\n            const defaultValue = (this.defaultConfig as Record<string, unknown>)[key];\n            if (defaultValue !== undefined && typeof defaultValue === 'object' && defaultValue !== null) {\n              value = this.configMerger.merge(\n                defaultValue as Record<string, unknown>,\n                value as Record<string, unknown>\n              ) as T;\n            }\n          }\n        }\n        \n        if (value !== undefined) {\n          await this.setConfig(key, value, usePersistentCache);\n          // 从服务器获取的配置，一致性级别为 synced\n          this.consistencyManager.setConsistency(key, 'synced');\n        }\n        return value || null;\n      } catch (error) {\n        throw new SystemConfigError(\n          `Failed to fetch config for key \"${key}\": ${error instanceof Error ? error.message : String(error)}`,\n          SystemConfigErrorCode.NETWORK_ERROR,\n          { key },\n          error\n        );\n      }\n    }\n\n    // 如果都没有，返回 null\n    return null;\n  }\n\n  /**\n   * 获取配置值（同步，仅读取缓存）\n   */\n  getConfigSync<T = unknown>(\n    key: string,\n    options?: { returnEmptyIfNotCached?: boolean }\n  ): T | null {\n    const returnEmptyIfNotCached = options?.returnEmptyIfNotCached ?? true;\n\n    // 从内存缓存获取\n    const cached = this.cacheManager.get(key);\n    if (cached !== null) {\n      return cached as T;\n    }\n\n    // 从状态管理获取\n    if (this.stateManager) {\n      const stateValue = this.stateManager.get<T>(key);\n      if (stateValue !== null) {\n        return stateValue;\n      }\n    }\n\n    // 从配置数据获取（静态配置）\n    if (this.configData && typeof this.configData === 'object' && this.configData !== null && key in (this.configData as Record<string, unknown>)) {\n      let value = (this.configData as Record<string, unknown>)[key] as T;\n      \n      // 如果有默认配置，进行合并\n      if (this.defaultConfig) {\n        const defaultValue = (this.defaultConfig as Record<string, unknown>)[key];\n        if (defaultValue !== undefined && typeof value === 'object' && value !== null && typeof defaultValue === 'object' && defaultValue !== null) {\n          value = this.configMerger.merge(\n            defaultValue as Record<string, unknown>,\n            value as Record<string, unknown>\n          ) as T;\n        }\n      }\n      \n      return value;\n    }\n\n    // 如果允许返回空值，返回 null\n    if (returnEmptyIfNotCached) {\n      return null;\n    }\n\n    // 否则抛出错误\n    throw new SystemConfigError(\n      `Config \"${key}\" not found in cache`,\n      SystemConfigErrorCode.CONFIG_NOT_FOUND,\n      { key }\n    );\n  }\n\n  /**\n   * 获取所有配置（异步）\n   */\n  async getAllConfig<TConfig extends Record<string, unknown> = Record<string, unknown>>(\n    options?: { force?: boolean; usePersistentCache?: boolean }\n  ): Promise<TConfig> {\n    const force = options?.force ?? false;\n    const usePersistentCache = options?.usePersistentCache ?? this.enablePersistentCache;\n\n    // 如果不强制刷新，先尝试从缓存获取\n    if (!force) {\n      const cached = this.getAllConfigFromCache<TConfig>(usePersistentCache);\n      if (cached) {\n        return cached;\n      }\n    }\n\n    // 从配置数据获取（静态配置）\n    if (this.configData) {\n      let config = this.configData as TConfig;\n      \n      // 如果有默认配置，进行合并\n      if (this.defaultConfig) {\n        config = this.configMerger.merge(\n          this.defaultConfig as Record<string, unknown>,\n          config as Record<string, unknown>\n        ) as unknown as TConfig;\n      }\n      \n      await this.setAllConfig(config as unknown as Partial<TConfig>, false);\n      return config;\n    }\n\n    // 从 API 获取\n    if (this.configFetcher) {\n      try {\n        const result = await this.configFetcher();\n        let config = (result || {}) as TConfig;\n        \n        // 如果有默认配置，进行合并\n        if (this.defaultConfig && typeof config === 'object' && config !== null) {\n          config = this.configMerger.merge(\n            this.defaultConfig as Record<string, unknown>,\n            config as Record<string, unknown>\n          ) as unknown as TConfig;\n        }\n        \n        await this.setAllConfig(config as unknown as Partial<TConfig>, usePersistentCache);\n        // 从服务器获取的配置，一致性级别为 synced\n        if (typeof config === 'object' && config !== null) {\n          for (const key of Object.keys(config as Record<string, unknown>)) {\n            this.consistencyManager.setConsistency(key, 'synced');\n          }\n        }\n        return config;\n      } catch (error) {\n        throw new SystemConfigError(\n          `Failed to fetch all config: ${error instanceof Error ? error.message : String(error)}`,\n          SystemConfigErrorCode.NETWORK_ERROR,\n          undefined,\n          error\n        );\n      }\n    }\n\n    // 如果都没有，返回空对象\n    return {} as TConfig;\n  }\n\n  /**\n   * 获取所有配置（同步，仅读取缓存）\n   */\n  getAllConfigSync<TConfig = Record<string, unknown>>(\n    options?: { returnEmptyIfNotCached?: boolean }\n  ): TConfig {\n    const returnEmptyIfNotCached = options?.returnEmptyIfNotCached ?? true;\n\n    // 从内存缓存获取\n    const keys = this.cacheManager.keys();\n    if (keys.length > 0) {\n      const config: Record<string, unknown> = {};\n      for (const key of keys) {\n        const value = this.cacheManager.get(key);\n        if (value !== null) {\n          config[key] = value;\n        }\n      }\n      return config as TConfig;\n    }\n\n    // 从状态管理获取\n    if (this.stateManager) {\n      // 注意：StateManager 可能不支持获取所有键，这里需要根据实际实现调整\n      // 暂时返回空对象\n    }\n\n    // 从配置数据获取（静态配置）\n    if (this.configData) {\n      return this.configData as TConfig;\n    }\n\n    // 如果允许返回空值，返回空对象\n    if (returnEmptyIfNotCached) {\n      return {} as TConfig;\n    }\n\n    // 否则抛出错误\n    throw new SystemConfigError(\n      'Config not found in cache',\n      SystemConfigErrorCode.CONFIG_NOT_FOUND\n    );\n  }\n\n  /**\n   * 更新配置值\n   */\n  async setConfig<T = unknown>(\n    key: string,\n    value: T,\n    usePersistentCache?: boolean\n  ): Promise<void> {\n    // 验证配置\n    const validationResult = this.validator.validate(key, value);\n    if (validationResult !== true) {\n      throw new SystemConfigError(\n        `Config validation failed for key \"${key}\": ${validationResult}`,\n        SystemConfigErrorCode.VALIDATION_FAILED,\n        { key, value }\n      );\n    }\n\n    // 更新内存缓存\n    if (this.enableCache) {\n      this.cacheManager.set(key, value, this.cacheExpiry);\n    }\n\n    // 更新状态管理\n    if (this.stateManager) {\n      this.stateManager.set(key, value);\n    }\n\n    // 更新持久化缓存\n    const shouldPersist = usePersistentCache ?? this.enablePersistentCache;\n    if (shouldPersist && this.storageManager) {\n      try {\n        const storageKey = `${this.configKeyPrefix}${key}`;\n        await this.storageManager.set(storageKey, JSON.stringify(value));\n      } catch (error) {\n        // 持久化失败不影响内存缓存\n        console.warn('Failed to persist config to storage:', error);\n      }\n    }\n\n    // 更新一致性级别为 local（本地已更新，但远程未同步）\n    this.consistencyManager.setConsistency(key, 'local');\n  }\n\n  /**\n   * 批量更新配置值\n   */\n  async setAllConfig<TConfig = Record<string, unknown>>(\n    configs: Partial<TConfig>,\n    usePersistentCache?: boolean\n  ): Promise<void> {\n    // 验证所有配置\n    const validationResult = this.validator.validateAll(configs);\n    if (!validationResult.valid) {\n      throw new SystemConfigError(\n        `Config validation failed: ${JSON.stringify(validationResult.errors)}`,\n        SystemConfigErrorCode.VALIDATION_FAILED,\n        { errors: validationResult.errors }\n      );\n    }\n\n    // 批量更新\n    for (const [key, value] of Object.entries(configs)) {\n      await this.setConfig(key, value, usePersistentCache);\n    }\n  }\n\n  /**\n   * 从缓存获取配置\n   */\n  private getConfigFromCache<T = unknown>(\n    key: string,\n    _usePersistentCache: boolean\n  ): T | null {\n    // 从内存缓存获取\n    const cached = this.cacheManager.get(key);\n    if (cached !== null) {\n      return cached as T;\n    }\n\n    // 从状态管理获取\n    if (this.stateManager) {\n      const stateValue = this.stateManager.get<T>(key);\n      if (stateValue !== null) {\n        return stateValue;\n      }\n    }\n\n    // 从持久化缓存获取\n    if (_usePersistentCache && this.storageManager) {\n      // 注意：这里需要异步读取，但为了保持同步接口，暂时不实现\n      // 实际使用时应该通过异步方法获取\n    }\n\n    return null;\n  }\n\n  /**\n   * 从缓存获取所有配置\n   */\n  private getAllConfigFromCache<TConfig extends Record<string, unknown> = Record<string, unknown>>(\n    _usePersistentCache: boolean\n  ): TConfig | null {\n    // 从内存缓存获取\n    const keys = this.cacheManager.keys();\n    if (keys.length > 0) {\n      const config: Record<string, unknown> = {};\n      for (const key of keys) {\n        const value = this.cacheManager.get(key);\n        if (value !== null) {\n          config[key] = value;\n        }\n      }\n      let mergedConfig = config as TConfig;\n      \n      // 如果有默认配置，进行合并\n      if (this.defaultConfig) {\n        mergedConfig = this.configMerger.merge(\n          this.defaultConfig as Record<string, unknown>,\n          mergedConfig as Record<string, unknown>\n        ) as unknown as TConfig;\n      }\n      \n      return mergedConfig;\n    }\n\n    // 从配置数据获取（静态配置）\n    if (this.configData) {\n      let config = this.configData as TConfig;\n      \n      // 如果有默认配置，进行合并\n      if (this.defaultConfig) {\n        config = this.configMerger.merge(\n          this.defaultConfig as Record<string, unknown>,\n          config as Record<string, unknown>\n        ) as unknown as TConfig;\n      }\n      \n      return config;\n    }\n\n    return null;\n  }\n\n  /**\n   * 删除配置\n   */\n  async deleteConfig(key: string): Promise<void> {\n    // 从内存缓存删除\n    this.cacheManager.delete(key);\n\n    // 从状态管理删除\n    if (this.stateManager) {\n      this.stateManager.remove(key);\n    }\n\n    // 从持久化缓存删除\n    if (this.storageManager) {\n      try {\n        const storageKey = `${this.configKeyPrefix}${key}`;\n        await this.storageManager.remove(storageKey);\n      } catch (error) {\n        console.warn('Failed to remove config from storage:', error);\n      }\n    }\n\n    // 删除一致性级别\n    this.consistencyManager.deleteConsistency(key);\n  }\n\n  /**\n   * 清除所有配置缓存\n   */\n  async clearCache(key?: string): Promise<void> {\n    if (key) {\n      await this.deleteConfig(key);\n    } else {\n      // 清除所有缓存\n      this.cacheManager.clear();\n      this.consistencyManager.clear();\n      \n      // 清除状态管理（如果支持）\n      if (this.stateManager) {\n        const keys = this.cacheManager.keys();\n        for (const configKey of keys) {\n          this.stateManager.remove(configKey);\n        }\n      }\n    }\n  }\n}\n"],"names":["SystemConfigError","SystemConfigErrorCode","ConfigMerger","ConfigDataManager","getConfig","key","options","force","usePersistentCache","enablePersistentCache","cached","getConfigFromCache","configData","value","defaultConfig","defaultValue","undefined","configMerger","merge","setConfig","configFetcher","result","consistencyManager","setConsistency","error","Error","message","String","NETWORK_ERROR","getConfigSync","returnEmptyIfNotCached","cacheManager","get","stateManager","stateValue","CONFIG_NOT_FOUND","getAllConfig","getAllConfigFromCache","config","setAllConfig","Object","keys","getAllConfigSync","length","validationResult","validator","validate","VALIDATION_FAILED","enableCache","set","cacheExpiry","shouldPersist","storageManager","storageKey","configKeyPrefix","JSON","stringify","console","warn","configs","validateAll","valid","errors","entries","_usePersistentCache","mergedConfig","deleteConfig","delete","remove","deleteConsistency","clearCache","clear","configKey"],"mappings":"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"}

package/dist/esm/managers/SystemConfigManager/core/ConfigValidator.js

@@ -0,0 +1,141 @@
+/**
+ * 配置验证模块
+ * 负责配置数据的验证
+ */ 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 ConfigValidator {
+    /**
+   * 验证配置值
+   */ validate(key, value) {
+        if (!this.validateConfig) {
+            return true;
+        }
+        // 自定义验证函数
+        if (this.configValidator) {
+            const result = this.configValidator(key, value);
+            if (result !== true) {
+                return result;
+            }
+        }
+        // 类型定义验证
+        if (this.configTypes && this.configTypes[key]) {
+            const typeDef = this.configTypes[key];
+            const result = this.validateByType(key, value, typeDef);
+            if (result !== true) {
+                return result;
+            }
+        }
+        return true;
+    }
+    /**
+   * 根据类型定义验证
+   */ validateByType(key, value, typeDef) {
+        // 检查必填项
+        if (typeDef.required && (value === undefined || value === null)) {
+            return `配置项 ${key} 是必填项`;
+        }
+        // 如果值为空且不是必填项，跳过类型检查
+        if (value === undefined || value === null) {
+            return true;
+        }
+        // 类型检查
+        const typeCheck = this.checkType(value, typeDef.type);
+        if (typeCheck !== true) {
+            return typeCheck;
+        }
+        // 自定义验证器
+        if (typeDef.validator) {
+            const result = typeDef.validator(value);
+            if (result !== true) {
+                return result;
+            }
+        }
+        // 对象类型：递归验证子属性
+        if (typeDef.type === 'object' && typeof typeDef.schema === 'object' && !Array.isArray(typeDef.schema)) {
+            if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                const schema = typeDef.schema;
+                for (const [subKey, subTypeDef] of Object.entries(schema)){
+                    const subValue = value[subKey];
+                    const result = this.validateByType(`${key}.${subKey}`, subValue, subTypeDef);
+                    if (result !== true) {
+                        return result;
+                    }
+                }
+            }
+        }
+        // 数组类型：验证数组元素
+        if (typeDef.type === 'array' && typeof typeDef.schema === 'object' && !Array.isArray(typeDef.schema)) {
+            if (Array.isArray(value)) {
+                const itemTypeDef = typeDef.schema;
+                for(let i = 0; i < value.length; i++){
+                    const result = this.validateByType(`${key}[${i}]`, value[i], itemTypeDef);
+                    if (result !== true) {
+                        return result;
+                    }
+                }
+            }
+        }
+        return true;
+    }
+    /**
+   * 检查类型
+   */ checkType(value, expectedType) {
+        const actualType = this.getType(value);
+        if (expectedType === 'any') {
+            return true;
+        }
+        if (actualType !== expectedType) {
+            return `期望类型为 ${expectedType}，实际类型为 ${actualType}`;
+        }
+        return true;
+    }
+    /**
+   * 获取值的类型
+   */ getType(value) {
+        if (value === null) {
+            return 'null';
+        }
+        if (Array.isArray(value)) {
+            return 'array';
+        }
+        return typeof value;
+    }
+    /**
+   * 验证所有配置
+   */ validateAll(configs) {
+        const errors = {};
+        for (const [key, value] of Object.entries(configs)){
+            const result = this.validate(key, value);
+            if (result !== true) {
+                errors[key] = result;
+            }
+        }
+        return {
+            valid: Object.keys(errors).length === 0,
+            errors
+        };
+    }
+    constructor(options){
+        _define_property(this, "configValidator", void 0);
+        _define_property(this, "configTypes", void 0);
+        _define_property(this, "validateConfig", void 0);
+        this.configValidator = options.configValidator;
+        this.configTypes = options.configTypes;
+        this.validateConfig = options.validateConfig;
+    }
+}
+
+//# sourceMappingURL=ConfigValidator.js.map

package/dist/esm/managers/SystemConfigManager/core/ConfigValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/SystemConfigManager/core/ConfigValidator.ts"],"sourcesContent":["/**\n * 配置验证模块\n * 负责配置数据的验证\n */\n\nimport type { ConfigTypeDefinition, ValidationResult } from '../types';\n\n/**\n * 配置验证器\n */\nexport class ConfigValidator {\n  private configValidator?: (key: string, value: unknown) => true | string;\n  private configTypes?: Record<string, ConfigTypeDefinition>;\n  private validateConfig: boolean;\n\n  constructor(options: {\n    configValidator?: (key: string, value: unknown) => true | string;\n    configTypes?: Record<string, ConfigTypeDefinition>;\n    validateConfig: boolean;\n  }) {\n    this.configValidator = options.configValidator;\n    this.configTypes = options.configTypes;\n    this.validateConfig = options.validateConfig;\n  }\n\n  /**\n   * 验证配置值\n   */\n  validate<T = unknown>(key: string, value: T): true | string {\n    if (!this.validateConfig) {\n      return true;\n    }\n\n    // 自定义验证函数\n    if (this.configValidator) {\n      const result = this.configValidator(key, value);\n      if (result !== true) {\n        return result;\n      }\n    }\n\n    // 类型定义验证\n    if (this.configTypes && this.configTypes[key]) {\n      const typeDef = this.configTypes[key];\n      const result = this.validateByType(key, value, typeDef);\n      if (result !== true) {\n        return result;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * 根据类型定义验证\n   */\n  private validateByType(\n    key: string,\n    value: unknown,\n    typeDef: ConfigTypeDefinition\n  ): true | string {\n    // 检查必填项\n    if (typeDef.required && (value === undefined || value === null)) {\n      return `配置项 ${key} 是必填项`;\n    }\n\n    // 如果值为空且不是必填项，跳过类型检查\n    if (value === undefined || value === null) {\n      return true;\n    }\n\n    // 类型检查\n    const typeCheck = this.checkType(value, typeDef.type);\n    if (typeCheck !== true) {\n      return typeCheck;\n    }\n\n    // 自定义验证器\n    if (typeDef.validator) {\n      const result = typeDef.validator(value);\n      if (result !== true) {\n        return result;\n      }\n    }\n\n    // 对象类型：递归验证子属性\n    if (typeDef.type === 'object' && typeof typeDef.schema === 'object' && !Array.isArray(typeDef.schema)) {\n      if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n        const schema = typeDef.schema as Record<string, ConfigTypeDefinition>;\n        for (const [subKey, subTypeDef] of Object.entries(schema)) {\n          const subValue = (value as Record<string, unknown>)[subKey];\n          const result = this.validateByType(`${key}.${subKey}`, subValue, subTypeDef);\n          if (result !== true) {\n            return result;\n          }\n        }\n      }\n    }\n\n    // 数组类型：验证数组元素\n    if (typeDef.type === 'array' && typeof typeDef.schema === 'object' && !Array.isArray(typeDef.schema)) {\n      if (Array.isArray(value)) {\n        const itemTypeDef = typeDef.schema as ConfigTypeDefinition;\n        for (let i = 0; i < value.length; i++) {\n          const result = this.validateByType(`${key}[${i}]`, value[i], itemTypeDef);\n          if (result !== true) {\n            return result;\n          }\n        }\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * 检查类型\n   */\n  private checkType(value: unknown, expectedType: string): true | string {\n    const actualType = this.getType(value);\n    \n    if (expectedType === 'any') {\n      return true;\n    }\n    \n    if (actualType !== expectedType) {\n      return `期望类型为 ${expectedType}，实际类型为 ${actualType}`;\n    }\n    \n    return true;\n  }\n\n  /**\n   * 获取值的类型\n   */\n  private getType(value: unknown): string {\n    if (value === null) {\n      return 'null';\n    }\n    if (Array.isArray(value)) {\n      return 'array';\n    }\n    return typeof value;\n  }\n\n  /**\n   * 验证所有配置\n   */\n  validateAll<TConfig extends Record<string, unknown> = Record<string, unknown>>(configs: TConfig): ValidationResult {\n    const errors: Record<string, string> = {};\n\n    for (const [key, value] of Object.entries(configs as Record<string, unknown>)) {\n      const result = this.validate(key, value);\n      if (result !== true) {\n        errors[key] = result;\n      }\n    }\n\n    return {\n      valid: Object.keys(errors).length === 0,\n      errors,\n    };\n  }\n}\n"],"names":["ConfigValidator","validate","key","value","validateConfig","configValidator","result","configTypes","typeDef","validateByType","required","undefined","typeCheck","checkType","type","validator","schema","Array","isArray","subKey","subTypeDef","Object","entries","subValue","itemTypeDef","i","length","expectedType","actualType","getType","validateAll","configs","errors","valid","keys","options"],"mappings":"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"}

package/dist/esm/managers/SystemConfigManager/core/ConsistencyManager.js

@@ -0,0 +1,92 @@
+/**
+ * 一致性级别管理模块
+ * 管理配置的一致性级别（local/synced/eventual）
+ */ 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 ConsistencyManager {
+    /**
+   * 获取配置的一致性级别
+   */ getConsistency(key) {
+        if (!this.enableConsistencyLevel) {
+            return null;
+        }
+        return this.cacheManager.get(key) || null;
+    }
+    /**
+   * 设置配置的一致性级别
+   */ setConsistency(key, level) {
+        if (!this.enableConsistencyLevel) {
+            return;
+        }
+        this.cacheManager.set(key, level);
+    }
+    /**
+   * 获取所有配置的一致性级别
+   */ getAllConsistency() {
+        if (!this.enableConsistencyLevel) {
+            return {};
+        }
+        const result = {};
+        const keys = this.cacheManager.keys();
+        for (const key of keys){
+            const level = this.cacheManager.get(key);
+            if (level) {
+                result[key] = level;
+            }
+        }
+        return result;
+    }
+    /**
+   * 按一致性级别过滤配置键名
+   */ getConfigsByConsistency(level) {
+        if (!this.enableConsistencyLevel) {
+            return [];
+        }
+        const result = [];
+        const keys = this.cacheManager.keys();
+        for (const key of keys){
+            const configLevel = this.cacheManager.get(key);
+            if (configLevel === level) {
+                result.push(key);
+            }
+        }
+        return result;
+    }
+    /**
+   * 删除配置的一致性级别
+   */ deleteConsistency(key) {
+        if (!this.enableConsistencyLevel) {
+            return;
+        }
+        this.cacheManager.delete(key);
+    }
+    /**
+   * 清除所有一致性级别
+   */ clear() {
+        if (!this.enableConsistencyLevel) {
+            return;
+        }
+        this.cacheManager.clear();
+    }
+    constructor(options){
+        _define_property(this, "cacheManager", void 0);
+        _define_property(this, "enableConsistencyLevel", void 0);
+        this.cacheManager = options.cacheManager;
+        this.enableConsistencyLevel = options.enableConsistencyLevel;
+    }
+}
+
+//# sourceMappingURL=ConsistencyManager.js.map