@vlian/infrastructure 0.9.10

package/dist/cjs/managers/SystemConfigManager/runtime/ConfigFormatter.js

@@ -0,0 +1,36 @@
+/**
+ * 配置格式化模块
+ * 负责配置值的格式化
+ */ /**
+ * 配置格式化器
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "ConfigFormatter", {
+    enumerable: true,
+    get: function() {
+        return ConfigFormatter;
+    }
+});
+let ConfigFormatter = class ConfigFormatter {
+    /**
+   * 格式化配置值
+   */ format(value, defaultValue) {
+        if (value === null || value === undefined) {
+            return defaultValue ?? '';
+        }
+        if (typeof value === 'string') {
+            return value;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean') {
+            return String(value);
+        }
+        if (typeof value === 'object') {
+            return JSON.stringify(value);
+        }
+        return String(value);
+    }
+};
+
+//# sourceMappingURL=ConfigFormatter.js.map

package/dist/cjs/managers/SystemConfigManager/runtime/ConfigFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/SystemConfigManager/runtime/ConfigFormatter.ts"],"sourcesContent":["/**\n * 配置格式化模块\n * 负责配置值的格式化\n */\n\n/**\n * 配置格式化器\n */\nexport class ConfigFormatter {\n  /**\n   * 格式化配置值\n   */\n  format(value: unknown, defaultValue?: string): string {\n    if (value === null || value === undefined) {\n      return defaultValue ?? '';\n    }\n\n    if (typeof value === 'string') {\n      return value;\n    }\n\n    if (typeof value === 'number' || typeof value === 'boolean') {\n      return String(value);\n    }\n\n    if (typeof value === 'object') {\n      return JSON.stringify(value);\n    }\n\n    return String(value);\n  }\n}\n"],"names":["ConfigFormatter","format","value","defaultValue","undefined","String","JSON","stringify"],"mappings":"AAAA;;;CAGC,GAED;;CAEC;;;;+BACYA;;;eAAAA;;;AAAN,IAAA,AAAMA,kBAAN,MAAMA;IACX;;GAEC,GACDC,OAAOC,KAAc,EAAEC,YAAqB,EAAU;QACpD,IAAID,UAAU,QAAQA,UAAUE,WAAW;YACzC,OAAOD,gBAAgB;QACzB;QAEA,IAAI,OAAOD,UAAU,UAAU;YAC7B,OAAOA;QACT;QAEA,IAAI,OAAOA,UAAU,YAAY,OAAOA,UAAU,WAAW;YAC3D,OAAOG,OAAOH;QAChB;QAEA,IAAI,OAAOA,UAAU,UAAU;YAC7B,OAAOI,KAAKC,SAAS,CAACL;QACxB;QAEA,OAAOG,OAAOH;IAChB;AACF"}

package/dist/cjs/managers/SystemConfigManager/runtime/ConfigMerger.js

@@ -0,0 +1,43 @@
+/**
+ * 配置合并模块
+ * 支持默认配置与用户配置的深度合并
+ */ /**
+ * 配置合并器
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "ConfigMerger", {
+    enumerable: true,
+    get: function() {
+        return ConfigMerger;
+    }
+});
+let ConfigMerger = class ConfigMerger {
+    /**
+   * 深度合并配置
+   */ merge(defaultConfig, userConfig) {
+        const result = {
+            ...defaultConfig
+        };
+        for(const key in userConfig){
+            const userValue = userConfig[key];
+            const defaultValue = defaultConfig[key];
+            if (this.isPlainObject(userValue) && this.isPlainObject(defaultValue)) {
+                // 递归合并对象
+                result[key] = this.merge(defaultValue, userValue);
+            } else {
+                // 直接覆盖
+                result[key] = userValue;
+            }
+        }
+        return result;
+    }
+    /**
+   * 判断是否为普通对象
+   */ isPlainObject(value) {
+        return typeof value === 'object' && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === '[object Object]';
+    }
+};
+
+//# sourceMappingURL=ConfigMerger.js.map

package/dist/cjs/managers/SystemConfigManager/runtime/ConfigMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/SystemConfigManager/runtime/ConfigMerger.ts"],"sourcesContent":["/**\n * 配置合并模块\n * 支持默认配置与用户配置的深度合并\n */\n\n/**\n * 配置合并器\n */\nexport class ConfigMerger {\n  /**\n   * 深度合并配置\n   */\n  merge<TConfig = Record<string, unknown>>(\n    defaultConfig: Partial<TConfig>,\n    userConfig: Partial<TConfig>\n  ): TConfig {\n    const result = { ...defaultConfig } as TConfig;\n\n    for (const key in userConfig) {\n      const userValue = userConfig[key];\n      const defaultValue = defaultConfig[key];\n\n      if (this.isPlainObject(userValue) && this.isPlainObject(defaultValue)) {\n        // 递归合并对象\n        (result as Record<string, unknown>)[key] = this.merge(\n          defaultValue as Record<string, unknown>,\n          userValue as Record<string, unknown>\n        ) as TConfig;\n      } else {\n        // 直接覆盖\n        (result as Record<string, unknown>)[key] = userValue;\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * 判断是否为普通对象\n   */\n  private isPlainObject(value: unknown): value is Record<string, unknown> {\n    return (\n      typeof value === 'object' &&\n      value !== null &&\n      !Array.isArray(value) &&\n      Object.prototype.toString.call(value) === '[object Object]'\n    );\n  }\n}\n"],"names":["ConfigMerger","merge","defaultConfig","userConfig","result","key","userValue","defaultValue","isPlainObject","value","Array","isArray","Object","prototype","toString","call"],"mappings":"AAAA;;;CAGC,GAED;;CAEC;;;;+BACYA;;;eAAAA;;;AAAN,IAAA,AAAMA,eAAN,MAAMA;IACX;;GAEC,GACDC,MACEC,aAA+B,EAC/BC,UAA4B,EACnB;QACT,MAAMC,SAAS;YAAE,GAAGF,aAAa;QAAC;QAElC,IAAK,MAAMG,OAAOF,WAAY;YAC5B,MAAMG,YAAYH,UAAU,CAACE,IAAI;YACjC,MAAME,eAAeL,aAAa,CAACG,IAAI;YAEvC,IAAI,IAAI,CAACG,aAAa,CAACF,cAAc,IAAI,CAACE,aAAa,CAACD,eAAe;gBACrE,SAAS;gBACRH,MAAkC,CAACC,IAAI,GAAG,IAAI,CAACJ,KAAK,CACnDM,cACAD;YAEJ,OAAO;gBACL,OAAO;gBACNF,MAAkC,CAACC,IAAI,GAAGC;YAC7C;QACF;QAEA,OAAOF;IACT;IAEA;;GAEC,GACD,AAAQI,cAAcC,KAAc,EAAoC;QACtE,OACE,OAAOA,UAAU,YACjBA,UAAU,QACV,CAACC,MAAMC,OAAO,CAACF,UACfG,OAAOC,SAAS,CAACC,QAAQ,CAACC,IAAI,CAACN,WAAW;IAE9C;AACF"}

package/dist/cjs/managers/SystemConfigManager/runtime/DiffCalculator.js

@@ -0,0 +1,82 @@
+/**
+ * 配置差异计算模块
+ * 计算配置变更的差异信息（added、removed、changed）
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "DiffCalculator", {
+    enumerable: true,
+    get: function() {
+        return DiffCalculator;
+    }
+});
+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 DiffCalculator = class DiffCalculator {
+    /**
+   * 计算配置差异
+   */ calculateDiff(newConfig, oldConfig) {
+        const old = oldConfig || {};
+        const added = {};
+        const removed = {};
+        const changed = {};
+        // 找出新增的配置项
+        for(const key in newConfig){
+            if (!(key in old)) {
+                added[key] = newConfig[key];
+            }
+        }
+        // 找出删除的配置项
+        for(const key in old){
+            if (!(key in newConfig)) {
+                removed[key] = old[key];
+            }
+        }
+        // 找出变更的配置项
+        for(const key in newConfig){
+            if (key in old) {
+                const oldValue = old[key];
+                const newValue = newConfig[key];
+                if (this.isChanged(oldValue, newValue)) {
+                    changed[key] = {
+                        before: oldValue,
+                        after: newValue
+                    };
+                }
+            }
+        }
+        return {
+            added,
+            removed,
+            changed
+        };
+    }
+    /**
+   * 判断配置值是否发生变更
+   */ isChanged(before, after) {
+        // 使用自定义变更检测函数
+        if (this.configChangeDetector) {
+            return this.configChangeDetector(before, after);
+        }
+        // 默认：深度比较
+        return JSON.stringify(before) !== JSON.stringify(after);
+    }
+    constructor(options){
+        _define_property(this, "configChangeDetector", void 0);
+        this.configChangeDetector = options?.configChangeDetector;
+    }
+};
+
+//# sourceMappingURL=DiffCalculator.js.map

package/dist/cjs/managers/SystemConfigManager/runtime/DiffCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/SystemConfigManager/runtime/DiffCalculator.ts"],"sourcesContent":["/**\n * 配置差异计算模块\n * 计算配置变更的差异信息（added、removed、changed）\n */\n\nimport type { ConfigDiff } from '../types';\n\n/**\n * 差异计算器\n */\nexport class DiffCalculator<TConfig extends Record<string, unknown> = Record<string, unknown>> {\n  private configChangeDetector?: (before: unknown, after: unknown) => boolean;\n\n  constructor(options?: {\n    configChangeDetector?: (before: unknown, after: unknown) => boolean;\n  }) {\n    this.configChangeDetector = options?.configChangeDetector;\n  }\n\n  /**\n   * 计算配置差异\n   */\n  calculateDiff(\n    newConfig: TConfig,\n    oldConfig?: TConfig\n  ): ConfigDiff<TConfig> {\n    const old = oldConfig || ({} as TConfig);\n    const added: Partial<TConfig> = {};\n    const removed: Partial<TConfig> = {};\n    const changed: Record<string, { before: unknown; after: unknown }> = {};\n\n    // 找出新增的配置项\n    for (const key in newConfig) {\n      if (!(key in old)) {\n        added[key] = newConfig[key];\n      }\n    }\n\n    // 找出删除的配置项\n    for (const key in old) {\n      if (!(key in newConfig)) {\n        removed[key] = old[key];\n      }\n    }\n\n    // 找出变更的配置项\n    for (const key in newConfig) {\n      if (key in old) {\n        const oldValue = old[key];\n        const newValue = newConfig[key];\n        \n        if (this.isChanged(oldValue, newValue)) {\n          changed[key] = {\n            before: oldValue,\n            after: newValue,\n          };\n        }\n      }\n    }\n\n    return {\n      added,\n      removed,\n      changed,\n    };\n  }\n\n  /**\n   * 判断配置值是否发生变更\n   */\n  private isChanged(before: unknown, after: unknown): boolean {\n    // 使用自定义变更检测函数\n    if (this.configChangeDetector) {\n      return this.configChangeDetector(before, after);\n    }\n\n    // 默认：深度比较\n    return JSON.stringify(before) !== JSON.stringify(after);\n  }\n}\n"],"names":["DiffCalculator","calculateDiff","newConfig","oldConfig","old","added","removed","changed","key","oldValue","newValue","isChanged","before","after","configChangeDetector","JSON","stringify","options"],"mappings":"AAAA;;;CAGC;;;;+BAOYA;;;eAAAA;;;;;;;;;;;;;;;;AAAN,IAAA,AAAMA,iBAAN,MAAMA;IASX;;GAEC,GACDC,cACEC,SAAkB,EAClBC,SAAmB,EACE;QACrB,MAAMC,MAAMD,aAAc,CAAC;QAC3B,MAAME,QAA0B,CAAC;QACjC,MAAMC,UAA4B,CAAC;QACnC,MAAMC,UAA+D,CAAC;QAEtE,WAAW;QACX,IAAK,MAAMC,OAAON,UAAW;YAC3B,IAAI,CAAEM,CAAAA,OAAOJ,GAAE,GAAI;gBACjBC,KAAK,CAACG,IAAI,GAAGN,SAAS,CAACM,IAAI;YAC7B;QACF;QAEA,WAAW;QACX,IAAK,MAAMA,OAAOJ,IAAK;YACrB,IAAI,CAAEI,CAAAA,OAAON,SAAQ,GAAI;gBACvBI,OAAO,CAACE,IAAI,GAAGJ,GAAG,CAACI,IAAI;YACzB;QACF;QAEA,WAAW;QACX,IAAK,MAAMA,OAAON,UAAW;YAC3B,IAAIM,OAAOJ,KAAK;gBACd,MAAMK,WAAWL,GAAG,CAACI,IAAI;gBACzB,MAAME,WAAWR,SAAS,CAACM,IAAI;gBAE/B,IAAI,IAAI,CAACG,SAAS,CAACF,UAAUC,WAAW;oBACtCH,OAAO,CAACC,IAAI,GAAG;wBACbI,QAAQH;wBACRI,OAAOH;oBACT;gBACF;YACF;QACF;QAEA,OAAO;YACLL;YACAC;YACAC;QACF;IACF;IAEA;;GAEC,GACD,AAAQI,UAAUC,MAAe,EAAEC,KAAc,EAAW;QAC1D,cAAc;QACd,IAAI,IAAI,CAACC,oBAAoB,EAAE;YAC7B,OAAO,IAAI,CAACA,oBAAoB,CAACF,QAAQC;QAC3C;QAEA,UAAU;QACV,OAAOE,KAAKC,SAAS,CAACJ,YAAYG,KAAKC,SAAS,CAACH;IACnD;IAjEA,YAAYI,OAEX,CAAE;QAJH,uBAAQH,wBAAR,KAAA;QAKE,IAAI,CAACA,oBAAoB,GAAGG,SAASH;IACvC;AA8DF"}

package/dist/cjs/managers/SystemConfigManager/runtime/index.js

@@ -0,0 +1,28 @@
+/**
+ * Runtime 层导出
+ */ "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 ConfigFormatter () {
+        return _ConfigFormatter.ConfigFormatter;
+    },
+    get ConfigMerger () {
+        return _ConfigMerger.ConfigMerger;
+    },
+    get DiffCalculator () {
+        return _DiffCalculator.DiffCalculator;
+    }
+});
+const _DiffCalculator = require("./DiffCalculator");
+const _ConfigMerger = require("./ConfigMerger");
+const _ConfigFormatter = require("./ConfigFormatter");
+
+//# sourceMappingURL=index.js.map

package/dist/cjs/managers/SystemConfigManager/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/SystemConfigManager/runtime/index.ts"],"sourcesContent":["/**\n * Runtime 层导出\n */\n\nexport { DiffCalculator } from './DiffCalculator';\nexport { ConfigMerger } from './ConfigMerger';\nexport { ConfigFormatter } from './ConfigFormatter';\n"],"names":["ConfigFormatter","ConfigMerger","DiffCalculator"],"mappings":"AAAA;;CAEC;;;;;;;;;;;QAIQA;eAAAA,gCAAe;;QADfC;eAAAA,0BAAY;;QADZC;eAAAA,8BAAc;;;gCAAQ;8BACF;iCACG"}

package/dist/cjs/managers/SystemConfigManager/types.js

@@ -0,0 +1,74 @@
+/**
+ * SystemConfigManager 类型定义
+ * 完全泛型化的系统配置管理类型
+ */ // ========== 框架服务类型声明 ==========
+/**
+ * @vlian/framework AppEventBus 类型声明
+ */ "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 SystemConfigError () {
+        return SystemConfigError;
+    },
+    get SystemConfigErrorCode () {
+        return SystemConfigErrorCode;
+    },
+    get SystemConfigEventType () {
+        return SystemConfigEventType;
+    }
+});
+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;
+}
+var SystemConfigEventType = /*#__PURE__*/ function(SystemConfigEventType) {
+    SystemConfigEventType["CONFIG_LOADED"] = "system_config:loaded";
+    SystemConfigEventType["CONFIG_UPDATED"] = "system_config:updated";
+    SystemConfigEventType["CONFIG_REFRESHED"] = "system_config:refreshed";
+    SystemConfigEventType["CONFIG_CACHED"] = "system_config:cached";
+    SystemConfigEventType["CONFIG_CACHE_CLEARED"] = "system_config:cache:cleared";
+    SystemConfigEventType["CONFIG_SYNC_STARTED"] = "system_config:sync:started";
+    SystemConfigEventType["CONFIG_SYNC_COMPLETED"] = "system_config:sync:completed";
+    SystemConfigEventType["CONFIG_SYNC_FAILED"] = "system_config:sync:failed";
+    return SystemConfigEventType;
+}({});
+var SystemConfigErrorCode = /*#__PURE__*/ function(SystemConfigErrorCode) {
+    SystemConfigErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    SystemConfigErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    SystemConfigErrorCode["STORAGE_ERROR"] = "STORAGE_ERROR";
+    SystemConfigErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    SystemConfigErrorCode["CONFIG_NOT_FOUND"] = "CONFIG_NOT_FOUND";
+    SystemConfigErrorCode["CONCURRENCY_ERROR"] = "CONCURRENCY_ERROR";
+    SystemConfigErrorCode["SYNC_ERROR"] = "SYNC_ERROR";
+    SystemConfigErrorCode["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
+    return SystemConfigErrorCode;
+}({});
+let SystemConfigError = class SystemConfigError extends Error {
+    constructor(message, code, context, originalError){
+        super(message), _define_property(this, "code", void 0), _define_property(this, "context", void 0), _define_property(this, "originalError", void 0), this.code = code, this.context = context, this.originalError = originalError;
+        this.name = 'SystemConfigError';
+        // 保持原型链
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, SystemConfigError);
+        }
+    }
+};
+
+//# sourceMappingURL=types.js.map

package/dist/cjs/managers/SystemConfigManager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/managers/SystemConfigManager/types.ts"],"sourcesContent":["/**\n * SystemConfigManager 类型定义\n * 完全泛型化的系统配置管理类型\n */\n\n// ========== 框架服务类型声明 ==========\n\n/**\n * @vlian/framework AppEventBus 类型声明\n */\nexport interface AppEventBus {\n  on<T = unknown>(\n    event: string,\n    listener: (data: T, metadata: EventMetadata) => void | Promise<void>,\n    options?: EventListenerOptions\n  ): () => void;\n  \n  off<T = unknown>(\n    event: string,\n    listener?: (data: T, metadata: EventMetadata) => void | Promise<void>\n  ): void;\n  \n  once<T = unknown>(\n    event: string,\n    listener: (data: T, metadata: EventMetadata) => void | Promise<void>,\n    options?: Omit<EventListenerOptions, 'once'>\n  ): () => void;\n  \n  emit<T = unknown>(\n    event: string,\n    data: T,\n    metadata?: Partial<EventMetadata>\n  ): void | Promise<void>;\n}\n\n/**\n * @vlian/framework Logger 类型声明\n */\nexport interface Logger {\n  info(message: string, ...args: unknown[]): void;\n  warn(message: string, ...args: unknown[]): void;\n  error(message: string, ...args: unknown[]): void;\n  debug(message: string, ...args: unknown[]): void;\n}\n\n/**\n * @vlian/framework MonitoringService 类型声明\n */\nexport interface MonitoringService {\n  captureError(error: unknown, context?: Record<string, unknown>): void;\n  trackEvent(eventName: string, properties?: Record<string, unknown>): void;\n  reportPerformance(metrics: Record<string, number>, context?: Record<string, unknown>): void;\n}\n\n/**\n * @vlian/framework StorageInstance 类型声明\n */\nexport interface StorageInstance {\n  get(key: string): Promise<string | null>;\n  set(key: string, value: string): Promise<void>;\n  remove(key: string): Promise<void>;\n}\n\n/**\n * @vlian/framework StateManagerInstance 类型声明\n */\nexport interface StateManagerInstance {\n  get<T>(key: string): T | null;\n  set<T>(key: string, value: T): void;\n  remove(key: string): void;\n  subscribe<T>(key: string, callback: (value: T) => void): () => void;\n}\n\n/**\n * 存储策略\n */\nexport type StorageStrategy = 'local' | 'session' | 'indexedDB' | 'memory';\n\n// ========== 环境类型 ==========\n\n/**\n * 环境类型\n */\nexport type Environment = 'browser' | 'node' | 'ssr' | 'worker' | 'unknown';\n\n// ========== 事件类型 ==========\n\n/**\n * 系统配置事件类型枚举\n */\nexport enum SystemConfigEventType {\n  CONFIG_LOADED = 'system_config:loaded',\n  CONFIG_UPDATED = 'system_config:updated',\n  CONFIG_REFRESHED = 'system_config:refreshed',\n  CONFIG_CACHED = 'system_config:cached',\n  CONFIG_CACHE_CLEARED = 'system_config:cache:cleared',\n  CONFIG_SYNC_STARTED = 'system_config:sync:started',\n  CONFIG_SYNC_COMPLETED = 'system_config:sync:completed',\n  CONFIG_SYNC_FAILED = 'system_config:sync:failed',\n}\n\n/**\n * 事件元数据\n */\nexport interface EventMetadata {\n  timestamp: number;\n  instanceId?: string;\n  [key: string]: unknown;\n}\n\n/**\n * 事件监听器选项\n */\nexport interface EventListenerOptions {\n  once?: boolean;\n  priority?: number;\n}\n\n/**\n * 配置更新事件数据\n */\nexport interface ConfigUpdatedEventData {\n  key: string;\n  value: unknown;\n  previousValue?: unknown;\n  consistencyLevel?: ConsistencyLevel;\n  timestamp: number;\n}\n\n/**\n * 配置批量更新事件数据\n */\nexport interface ConfigBatchUpdatedEventData {\n  configs: Record<string, unknown>;\n  previousConfigs?: Record<string, unknown>;\n  diff?: ConfigDiff<Record<string, unknown>>;\n  timestamp: number;\n}\n\n// ========== 一致性级别 ==========\n\n/**\n * 一致性级别类型\n */\nexport type ConsistencyLevel =\n  | 'local'        // 只保证本地一致（本地已更新，但远程未同步）\n  | 'synced'       // 已与远端同步成功（本地和远程都已更新）\n  | 'eventual';    // 最终一致（正在同步中，或同步失败但会重试）\n\n// ========== 配置差异 ==========\n\n/**\n * 配置差异信息\n * @template TConfig 配置对象类型\n */\nexport interface ConfigDiff<TConfig = Record<string, unknown>> {\n  /**\n   * 新增的配置项（键名 -> 配置值）\n   */\n  added: Partial<TConfig>;\n  \n  /**\n   * 删除的配置项（键名 -> 配置值）\n   */\n  removed: Partial<TConfig>;\n  \n  /**\n   * 变更的配置项（键名 -> 变更前后的值）\n   */\n  changed: Record<string, {\n    before: unknown;\n    after: unknown;\n  }>;\n}\n\n// ========== 配置类型定义 ==========\n\n/**\n * 配置类型定义\n */\nexport interface ConfigTypeDefinition {\n  /**\n   * 类型名称\n   */\n  type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'any';\n  \n  /**\n   * 是否必填（默认：false）\n   */\n  required?: boolean;\n  \n  /**\n   * 默认值（可选）\n   */\n  defaultValue?: unknown;\n  \n  /**\n   * 值范围验证（可选）\n   */\n  validator?: (value: unknown) => true | string;\n  \n  /**\n   * 子类型定义（对象或数组类型时使用）\n   */\n  schema?: Record<string, ConfigTypeDefinition> | ConfigTypeDefinition;\n}\n\n// ========== 配置选项 ==========\n\n/**\n * SystemConfigManager 配置选项\n * @template TConfig 配置对象类型，完全由用户定义\n */\nexport interface SystemConfigOptions<TConfig = Record<string, unknown>> {\n  // ========== @vlian/framework 依赖注入 ==========\n  /**\n   * @vlian/framework Storage 配置（可选）\n   */\n  storage?: {\n    instance?: StorageInstance;\n    strategy?: StorageStrategy;\n  };\n  \n  /**\n   * @vlian/framework StateManager 配置（可选）\n   */\n  stateManager?: {\n    instance?: StateManagerInstance;\n    namespace?: string;\n  };\n  \n  // ========== 可观测性配置（完全可选，默认禁用）==========\n  /**\n   * 是否启用日志（默认：false）\n   */\n  enableLogging?: boolean;\n  \n  /**\n   * @vlian/framework Logger 实例（可选）\n   */\n  logger?: Logger;\n  \n  /**\n   * 是否启用监控（默认：false）\n   */\n  enableMonitoring?: boolean;\n  \n  /**\n   * @vlian/framework MonitoringService 实例（可选）\n   */\n  monitoring?: MonitoringService;\n  \n  /**\n   * 是否启用事件（默认：false）\n   */\n  enableEvents?: boolean;\n  \n  /**\n   * @vlian/framework AppEventBus 实例（可选）\n   */\n  eventBus?: AppEventBus;\n  \n  // ========== 实例隔离配置 ==========\n  /**\n   * 实例隔离模式（默认：'isolated'）\n   */\n  isolationMode?: 'isolated' | 'shared' | 'hybrid';\n  \n  // ========== 配置来源配置 ==========\n  /**\n   * 配置获取函数（可选）\n   */\n  configFetcher?: (key?: string) => Promise<TConfig | unknown>;\n  \n  /**\n   * 配置更新函数（可选）\n   */\n  configUpdater?: (key: string, value: unknown) => Promise<void>;\n  \n  /**\n   * 批量配置更新函数（可选）\n   */\n  configBatchUpdater?: (configs: Partial<TConfig>) => Promise<void>;\n  \n  /**\n   * 配置数据配置（可选）\n   */\n  configData?: TConfig;\n  \n  /**\n   * 默认配置（可选）\n   */\n  defaultConfig?: Partial<TConfig>;\n  \n  // ========== 存储配置 ==========\n  /**\n   * 配置数据存储键名前缀（默认：'system_config:'）\n   */\n  configKeyPrefix?: string;\n  \n  /**\n   * 是否启用持久化缓存（默认：false）\n   */\n  enablePersistentCache?: boolean;\n  \n  // ========== 事件配置 ==========\n  /**\n   * 事件命名空间前缀（默认：'system_config:'）\n   */\n  eventNamespace?: string;\n  \n  // ========== 验证配置 ==========\n  /**\n   * 配置验证函数（可选）\n   */\n  configValidator?: (key: string, value: unknown) => true | string;\n  \n  /**\n   * 配置类型定义（可选）\n   */\n  configTypes?: Record<string, ConfigTypeDefinition>;\n  \n  // ========== 缓存配置 ==========\n  /**\n   * 是否启用配置缓存（默认：true）\n   */\n  enableCache?: boolean;\n  \n  /**\n   * 缓存过期时间（毫秒，默认：不过期）\n   */\n  cacheExpiry?: number;\n  \n  // ========== 同步配置 ==========\n  /**\n   * 同步策略（默认：'queue'）\n   */\n  syncStrategy?: 'immediate' | 'batch' | 'queue';\n  \n  /**\n   * 批量同步延迟（毫秒，默认：1000）\n   */\n  batchSyncDelay?: number;\n  \n  /**\n   * 同步失败重试配置\n   */\n  syncRetryConfig?: {\n    maxRetries?: number;\n    retryDelay?: number;\n    backoffMultiplier?: number;\n  };\n  \n  /**\n   * 是否启用离线队列（默认：true）\n   */\n  enableOfflineQueue?: boolean;\n  \n  // ========== 性能配置 ==========\n  /**\n   * 是否启用详细性能指标（默认：false）\n   */\n  enableDetailedMetrics?: boolean;\n  \n  // ========== 并发控制配置 ==========\n  /**\n   * 并发控制策略（默认：'auto'）\n   */\n  concurrencyStrategy?: 'auto' | 'queue' | 'latest';\n  \n  /**\n   * 队列最大长度（默认：100）\n   */\n  maxQueueSize?: number;\n  \n  /**\n   * 操作超时时间（毫秒，默认：30000）\n   */\n  operationTimeout?: number;\n  \n  // ========== 其他配置 ==========\n  /**\n   * 实例 ID（可选）\n   */\n  instanceId?: string;\n  \n  /**\n   * 是否启用开发模式（默认：自动检测）\n   */\n  devMode?: boolean;\n  \n  /**\n   * 是否启用配置验证（默认：true）\n   */\n  validateConfig?: boolean;\n  \n  // ========== 一致性级别配置 ==========\n  /**\n   * 是否启用一致性级别管理（默认：true）\n   */\n  enableConsistencyLevel?: boolean;\n  \n  // ========== Diff 配置 ==========\n  /**\n   * 是否启用配置差异计算（默认：true）\n   */\n  enableDiff?: boolean;\n  \n  /**\n   * 配置项变更检测函数（可选）\n   */\n  configChangeDetector?: (before: unknown, after: unknown) => boolean;\n}\n\n// ========== 获取选项 ==========\n\n/**\n * 获取配置选项（异步）\n */\nexport interface GetConfigOptions {\n  /**\n   * 是否强制刷新（忽略缓存）\n   */\n  force?: boolean;\n  \n  /**\n   * 是否使用持久化缓存\n   */\n  usePersistentCache?: boolean;\n  \n  /**\n   * 并发策略（可选，覆盖全局配置）\n   */\n  concurrencyStrategy?: 'auto' | 'queue' | 'latest';\n}\n\n/**\n * 获取配置选项（同步）\n */\nexport interface GetConfigSyncOptions {\n  /**\n   * 如果缓存中不存在，是否返回 null/默认值（默认：true）\n   */\n  returnEmptyIfNotCached?: boolean;\n}\n\n/**\n * 更新配置选项\n */\nexport interface UpdateConfigOptions {\n  /**\n   * 是否跳过验证（默认：false）\n   */\n  skipValidation?: boolean;\n  \n  /**\n   * 是否立即同步（默认：根据 syncStrategy 决定）\n   */\n  immediateSync?: boolean;\n  \n  /**\n   * 并发策略（可选，覆盖全局配置）\n   */\n  concurrencyStrategy?: 'auto' | 'queue' | 'latest';\n}\n\n// ========== 验证结果 ==========\n\n/**\n * 验证结果\n */\nexport interface ValidationResult {\n  valid: boolean;\n  errors: Record<string, string>;\n}\n\n// ========== 批量更新结果 ==========\n\n/**\n * 批量更新结果\n */\nexport interface BatchUpdateResult {\n  success: boolean;\n  updated: string[];\n  failed: Record<string, string>;\n}\n\n// ========== 健康检查 ==========\n\n/**\n * 健康检查结果\n */\nexport interface HealthCheckResult {\n  healthy: boolean;\n  checks: {\n    storage?: { available: boolean; error?: string };\n    stateManager?: { available: boolean; error?: string };\n    eventBus?: { available: boolean; error?: string };\n    logger?: { available: boolean; error?: string };\n    monitoring?: { available: boolean; error?: string };\n  };\n}\n\n// ========== 性能指标 ==========\n\n/**\n * 性能指标\n */\nexport interface PerformanceMetrics {\n  operation: string;\n  duration: number;\n  timestamp: number;\n  metadata?: Record<string, unknown>;\n}\n\n// ========== 缓存统计 ==========\n\n/**\n * 缓存统计信息\n */\nexport interface CacheStatistics {\n  hits: number;\n  misses: number;\n  size: number;\n  hitRate: number;\n}\n\n// ========== 错误类型 ==========\n\n/**\n * 系统配置错误代码\n */\nexport enum SystemConfigErrorCode {\n  UNKNOWN_ERROR = 'UNKNOWN_ERROR',\n  NETWORK_ERROR = 'NETWORK_ERROR',\n  STORAGE_ERROR = 'STORAGE_ERROR',\n  VALIDATION_FAILED = 'VALIDATION_FAILED',\n  CONFIG_NOT_FOUND = 'CONFIG_NOT_FOUND',\n  CONCURRENCY_ERROR = 'CONCURRENCY_ERROR',\n  SYNC_ERROR = 'SYNC_ERROR',\n  TIMEOUT_ERROR = 'TIMEOUT_ERROR',\n}\n\n/**\n * 系统配置错误\n */\nexport class SystemConfigError extends Error {\n  constructor(\n    message: string,\n    public code: SystemConfigErrorCode,\n    public context?: Record<string, unknown>,\n    public originalError?: unknown\n  ) {\n    super(message);\n    this.name = 'SystemConfigError';\n    \n    // 保持原型链\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, SystemConfigError);\n    }\n  }\n}\n"],"names":["SystemConfigError","SystemConfigErrorCode","SystemConfigEventType","Error","message","code","context","originalError","name","captureStackTrace"],"mappings":"AAAA;;;CAGC,GAED,iCAAiC;AAEjC;;CAEC;;;;;;;;;;;QAyhBYA;eAAAA;;QAdDC;eAAAA;;QA1bAC;eAAAA;;;;;;;;;;;;;;;;AAAL,IAAA,AAAKA,+CAAAA;;;;;;;;;WAAAA;;AA0bL,IAAA,AAAKD,+CAAAA;;;;;;;;;WAAAA;;AAcL,IAAA,AAAMD,oBAAN,MAAMA,0BAA0BG;IACrC,YACEC,OAAe,EACf,AAAOC,IAA2B,EAClC,AAAOC,OAAiC,EACxC,AAAOC,aAAuB,CAC9B;QACA,KAAK,CAACH,mJAJCC,OAAAA,WACAC,UAAAA,cACAC,gBAAAA;QAGP,IAAI,CAACC,IAAI,GAAG;QAEZ,QAAQ;QACR,IAAIL,MAAMM,iBAAiB,EAAE;YAC3BN,MAAMM,iBAAiB,CAAC,IAAI,EAAET;QAChC;IACF;AACF"}