@vlian/infrastructure 0.9.10

package/dist/cjs/managers/SystemConfigManager/modules/EnvironmentDetector.js

@@ -0,0 +1,62 @@
+/**
+ * 环境检测模块
+ * 复用其他 Manager 的环境检测逻辑
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "EnvironmentDetector", {
+    enumerable: true,
+    get: function() {
+        return EnvironmentDetector;
+    }
+});
+let EnvironmentDetector = class EnvironmentDetector {
+    /**
+   * 检测运行环境
+   */ static detectEnvironment() {
+        // SSR 环境检测
+        const globalWindow = typeof globalThis !== 'undefined' && 'window' in globalThis ? globalThis.window : undefined;
+        if (globalWindow === undefined && typeof global !== 'undefined') {
+            // 检查是否在 SSR 渲染过程中
+            if (typeof process !== 'undefined' && process.env?.SSR === 'true') {
+                return 'ssr';
+            }
+            return 'node';
+        }
+        // Worker 环境检测
+        const globalSelf = typeof globalThis !== 'undefined' ? globalThis : undefined;
+        if (globalSelf && typeof globalSelf.WorkerGlobalScope !== 'undefined') {
+            const WorkerGlobalScope = globalSelf.WorkerGlobalScope;
+            if (globalSelf instanceof WorkerGlobalScope) {
+                return 'worker';
+            }
+        }
+        // 浏览器环境
+        if (globalWindow !== undefined) {
+            return 'browser';
+        }
+        return 'unknown';
+    }
+    /**
+   * 检查是否为生产环境
+   */ static checkIsProduction() {
+        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;
+    }
+};
+
+//# sourceMappingURL=EnvironmentDetector.js.map

package/dist/cjs/managers/SystemConfigManager/modules/EnvironmentDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/SystemConfigManager/modules/EnvironmentDetector.ts"],"sourcesContent":["/**\n * 环境检测模块\n * 复用其他 Manager 的环境检测逻辑\n */\n\nimport type { Environment } from '../types';\n\n/**\n * 环境检测器\n */\nexport class EnvironmentDetector {\n  /**\n   * 检测运行环境\n   */\n  static detectEnvironment(): Environment {\n    // SSR 环境检测\n    const globalWindow = typeof globalThis !== 'undefined' && 'window' in globalThis \n      ? (globalThis as { window?: unknown }).window \n      : undefined;\n    \n    if (globalWindow === undefined && typeof global !== 'undefined') {\n      // 检查是否在 SSR 渲染过程中\n      if (typeof process !== 'undefined' && process.env?.SSR === 'true') {\n        return 'ssr';\n      }\n      return 'node';\n    }\n\n    // Worker 环境检测\n    const globalSelf = typeof globalThis !== 'undefined' ? globalThis : undefined;\n    if (globalSelf && typeof (globalSelf as any).WorkerGlobalScope !== 'undefined') {\n      const WorkerGlobalScope = (globalSelf as any).WorkerGlobalScope;\n      if (globalSelf instanceof WorkerGlobalScope) {\n        return 'worker';\n      }\n    }\n\n    // 浏览器环境\n    if (globalWindow !== undefined) {\n      return 'browser';\n    }\n\n    return 'unknown';\n  }\n\n  /**\n   * 检查是否为生产环境\n   */\n  static checkIsProduction(): 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"],"names":["EnvironmentDetector","detectEnvironment","globalWindow","globalThis","window","undefined","global","process","env","SSR","globalSelf","WorkerGlobalScope","checkIsProduction","NODE_ENV","location","hostname","includes"],"mappings":"AAAA;;;CAGC;;;;+BAOYA;;;eAAAA;;;AAAN,IAAA,AAAMA,sBAAN,MAAMA;IACX;;GAEC,GACD,OAAOC,oBAAiC;QACtC,WAAW;QACX,MAAMC,eAAe,OAAOC,eAAe,eAAe,YAAYA,aAClE,AAACA,WAAoCC,MAAM,GAC3CC;QAEJ,IAAIH,iBAAiBG,aAAa,OAAOC,WAAW,aAAa;YAC/D,kBAAkB;YAClB,IAAI,OAAOC,YAAY,eAAeA,QAAQC,GAAG,EAAEC,QAAQ,QAAQ;gBACjE,OAAO;YACT;YACA,OAAO;QACT;QAEA,cAAc;QACd,MAAMC,aAAa,OAAOP,eAAe,cAAcA,aAAaE;QACpE,IAAIK,cAAc,OAAO,AAACA,WAAmBC,iBAAiB,KAAK,aAAa;YAC9E,MAAMA,oBAAoB,AAACD,WAAmBC,iBAAiB;YAC/D,IAAID,sBAAsBC,mBAAmB;gBAC3C,OAAO;YACT;QACF;QAEA,QAAQ;QACR,IAAIT,iBAAiBG,WAAW;YAC9B,OAAO;QACT;QAEA,OAAO;IACT;IAEA;;GAEC,GACD,OAAOO,oBAA6B;QAClC,IAAI,OAAOL,YAAY,eAAeA,QAAQC,GAAG,EAAE;YACjD,OAAOD,QAAQC,GAAG,CAACK,QAAQ,KAAK;QAClC;QACA,oBAAoB;QACpB,IAAI,OAAOV,eAAe,eAAe,cAAcA,YAAY;YACjE,MAAMW,WAAW,AAACX,WAAoDW,QAAQ;YAC9E,IAAIA,UAAUC,UAAU;gBACtB,OAAO,CAAC;oBAAC;oBAAa;oBAAa;iBAAU,CAACC,QAAQ,CAACF,SAASC,QAAQ;YAC1E;QACF;QACA,OAAO;IACT;AACF"}

package/dist/cjs/managers/SystemConfigManager/modules/ErrorHandler.js

@@ -0,0 +1,108 @@
+/**
+ * 错误处理模块
+ * 使用 @vlian/framework Logger 和 MonitoringService 进行错误处理
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "ErrorHandler", {
+    enumerable: true,
+    get: function() {
+        return ErrorHandler;
+    }
+});
+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 ErrorHandler = class ErrorHandler {
+    /**
+   * 处理错误
+   */ handleError(error, context) {
+        // 如果已经是 SystemConfigError，直接返回
+        if (error instanceof _types.SystemConfigError) {
+            this.logError(error, context);
+            this.reportError(error, context);
+            return error;
+        }
+        // 转换为 SystemConfigError
+        const systemConfigError = this.normalizeError(error, context);
+        this.logError(systemConfigError, context);
+        this.reportError(systemConfigError, context);
+        return systemConfigError;
+    }
+    /**
+   * 标准化错误
+   */ normalizeError(error, context) {
+        if (error instanceof Error) {
+            // 尝试从错误消息中推断错误代码
+            let code = _types.SystemConfigErrorCode.UNKNOWN_ERROR;
+            const message = error.message.toLowerCase();
+            if (message.includes('network') || message.includes('fetch')) {
+                code = _types.SystemConfigErrorCode.NETWORK_ERROR;
+            } else if (message.includes('storage')) {
+                code = _types.SystemConfigErrorCode.STORAGE_ERROR;
+            } else if (message.includes('validation')) {
+                code = _types.SystemConfigErrorCode.VALIDATION_FAILED;
+            } else if (message.includes('timeout')) {
+                code = _types.SystemConfigErrorCode.TIMEOUT_ERROR;
+            }
+            return new _types.SystemConfigError(this.sanitizeErrors ? this.sanitizeErrorMessage(error.message) : error.message, code, context, error);
+        }
+        return new _types.SystemConfigError(this.sanitizeErrors ? 'An unknown error occurred' : String(error), _types.SystemConfigErrorCode.UNKNOWN_ERROR, context, error);
+    }
+    /**
+   * 记录错误日志
+   */ logError(error, context) {
+        if (!this.logger) {
+            return;
+        }
+        const logContext = {
+            code: error.code,
+            ...context,
+            ...error.context
+        };
+        this.logger.error(`[SystemConfig] ${error.message}`, logContext);
+        if (error.originalError && this.logger.debug) {
+            this.logger.debug('Original error:', error.originalError);
+        }
+    }
+    /**
+   * 上报错误
+   */ reportError(error, context) {
+        if (!this.monitoring) {
+            return;
+        }
+        this.monitoring.captureError(error, {
+            code: error.code,
+            ...context,
+            ...error.context
+        });
+    }
+    /**
+   * 脱敏错误消息
+   */ sanitizeErrorMessage(message) {
+        // 移除可能的敏感信息（如 token、密码等）
+        return message.replace(/token[=:]\s*[\w-]+/gi, 'token=***').replace(/password[=:]\s*\S+/gi, 'password=***').replace(/api[_-]?key[=:]\s*[\w-]+/gi, 'api_key=***');
+    }
+    constructor(options){
+        _define_property(this, "logger", void 0);
+        _define_property(this, "monitoring", void 0);
+        _define_property(this, "sanitizeErrors", void 0);
+        this.logger = options?.logger;
+        this.monitoring = options?.monitoring;
+        this.sanitizeErrors = options?.sanitizeErrors ?? true;
+    }
+};
+
+//# sourceMappingURL=ErrorHandler.js.map

package/dist/cjs/managers/SystemConfigManager/modules/ErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/SystemConfigManager/modules/ErrorHandler.ts"],"sourcesContent":["/**\n * 错误处理模块\n * 使用 @vlian/framework Logger 和 MonitoringService 进行错误处理\n */\n\nimport type { Logger, MonitoringService } from '../types';\nimport { SystemConfigError, SystemConfigErrorCode } from '../types';\n\n/**\n * 错误处理器\n */\nexport class ErrorHandler {\n  private logger?: Logger;\n  private monitoring?: MonitoringService;\n  private sanitizeErrors: boolean;\n\n  constructor(options?: {\n    logger?: Logger;\n    monitoring?: MonitoringService;\n    sanitizeErrors?: boolean;\n  }) {\n    this.logger = options?.logger;\n    this.monitoring = options?.monitoring;\n    this.sanitizeErrors = options?.sanitizeErrors ?? true;\n  }\n\n  /**\n   * 处理错误\n   */\n  handleError(\n    error: unknown,\n    context?: {\n      operation?: string;\n      [key: string]: unknown;\n    }\n  ): SystemConfigError {\n    // 如果已经是 SystemConfigError，直接返回\n    if (error instanceof SystemConfigError) {\n      this.logError(error, context);\n      this.reportError(error, context);\n      return error;\n    }\n\n    // 转换为 SystemConfigError\n    const systemConfigError = this.normalizeError(error, context);\n    this.logError(systemConfigError, context);\n    this.reportError(systemConfigError, context);\n    return systemConfigError;\n  }\n\n  /**\n   * 标准化错误\n   */\n  private normalizeError(\n    error: unknown,\n    context?: Record<string, unknown>\n  ): SystemConfigError {\n    if (error instanceof Error) {\n      // 尝试从错误消息中推断错误代码\n      let code = SystemConfigErrorCode.UNKNOWN_ERROR;\n      const message = error.message.toLowerCase();\n      \n      if (message.includes('network') || message.includes('fetch')) {\n        code = SystemConfigErrorCode.NETWORK_ERROR;\n      } else if (message.includes('storage')) {\n        code = SystemConfigErrorCode.STORAGE_ERROR;\n      } else if (message.includes('validation')) {\n        code = SystemConfigErrorCode.VALIDATION_FAILED;\n      } else if (message.includes('timeout')) {\n        code = SystemConfigErrorCode.TIMEOUT_ERROR;\n      }\n\n      return new SystemConfigError(\n        this.sanitizeErrors ? this.sanitizeErrorMessage(error.message) : error.message,\n        code,\n        context,\n        error\n      );\n    }\n\n    return new SystemConfigError(\n      this.sanitizeErrors ? 'An unknown error occurred' : String(error),\n      SystemConfigErrorCode.UNKNOWN_ERROR,\n      context,\n      error\n    );\n  }\n\n  /**\n   * 记录错误日志\n   */\n  private logError(error: SystemConfigError, context?: Record<string, unknown>): void {\n    if (!this.logger) {\n      return;\n    }\n\n    const logContext = {\n      code: error.code,\n      ...context,\n      ...error.context,\n    };\n\n    this.logger.error(`[SystemConfig] ${error.message}`, logContext);\n    \n    if (error.originalError && this.logger.debug) {\n      this.logger.debug('Original error:', error.originalError);\n    }\n  }\n\n  /**\n   * 上报错误\n   */\n  private reportError(error: SystemConfigError, context?: Record<string, unknown>): void {\n    if (!this.monitoring) {\n      return;\n    }\n\n    this.monitoring.captureError(error, {\n      code: error.code,\n      ...context,\n      ...error.context,\n    });\n  }\n\n  /**\n   * 脱敏错误消息\n   */\n  private sanitizeErrorMessage(message: string): string {\n    // 移除可能的敏感信息（如 token、密码等）\n    return message\n      .replace(/token[=:]\\s*[\\w-]+/gi, 'token=***')\n      .replace(/password[=:]\\s*\\S+/gi, 'password=***')\n      .replace(/api[_-]?key[=:]\\s*[\\w-]+/gi, 'api_key=***');\n  }\n}\n"],"names":["ErrorHandler","handleError","error","context","SystemConfigError","logError","reportError","systemConfigError","normalizeError","Error","code","SystemConfigErrorCode","UNKNOWN_ERROR","message","toLowerCase","includes","NETWORK_ERROR","STORAGE_ERROR","VALIDATION_FAILED","TIMEOUT_ERROR","sanitizeErrors","sanitizeErrorMessage","String","logger","logContext","originalError","debug","monitoring","captureError","replace","options"],"mappings":"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"}

package/dist/cjs/managers/SystemConfigManager/modules/StorageManager.js

@@ -0,0 +1,154 @@
+/**
+ * 存储管理模块
+ * 封装 @vlian/framework Storage，负责存储实例初始化
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "StorageManager", {
+    enumerable: true,
+    get: function() {
+        return StorageManager;
+    }
+});
+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 StorageManager = class StorageManager {
+    /**
+   * 初始化存储实例（带缓存优化）
+   */ initStorage(storageConfig) {
+        // 如果直接提供了实例，直接使用（最快路径）
+        if (storageConfig.instance) {
+            return storageConfig.instance;
+        }
+        // 如果没有提供实例，尝试从 @vlian/framework 获取
+        const strategy = storageConfig.strategy || 'local';
+        const cacheKey = `${strategy}_${this.environment}`;
+        // 检查缓存
+        if (StorageManager.storageCache.has(cacheKey)) {
+            return StorageManager.storageCache.get(cacheKey);
+        }
+        try {
+            // SSR 环境特殊处理
+            if (this.environment === 'ssr') {
+                // SSR 环境应该使用内存存储
+                const data = new Map();
+                const memoryStorage = {
+                    async get (key) {
+                        return data.get(key) || null;
+                    },
+                    async set (key, value) {
+                        data.set(key, value);
+                    },
+                    async remove (key) {
+                        data.delete(key);
+                    }
+                };
+                StorageManager.storageCache.set(cacheKey, memoryStorage);
+                return memoryStorage;
+            }
+            // Worker 环境特殊处理
+            if (this.environment === 'worker') {
+                // Worker 环境不支持 localStorage，使用 IndexedDB 或内存存储
+                if (strategy === 'local' || strategy === 'session') {
+                    this.logger?.warn(`${strategy} storage is not available in Worker environment, falling back to memory storage`);
+                    const data = new Map();
+                    const memoryStorage = {
+                        async get (key) {
+                            return data.get(key) || null;
+                        },
+                        async set (key, value) {
+                            data.set(key, value);
+                        },
+                        async remove (key) {
+                            data.delete(key);
+                        }
+                    };
+                    StorageManager.storageCache.set(cacheKey, memoryStorage);
+                    return memoryStorage;
+                }
+            }
+            // 优化的获取逻辑：按优先级检查
+            let storageModule;
+            // 1. 检查全局变量（最快，无需动态导入）
+            if (typeof globalThis !== 'undefined') {
+                const global = globalThis;
+                storageModule = global.window?.vlianFramework || global.vlianFramework;
+            }
+            // 2. 如果全局变量不存在，尝试使用 require（仅 Node.js/CommonJS 环境）
+            if (!storageModule && typeof require !== 'undefined') {
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-require-imports
+                    storageModule = require('@vlian/framework');
+                } catch  {
+                // require 失败，继续抛出错误
+                }
+            }
+            // 如果仍然没有找到，抛出错误
+            if (!storageModule) {
+                throw new _types.SystemConfigError('@vlian/framework is not available. ' + 'Please provide storage.instance or ensure @vlian/framework is installed and accessible.', _types.SystemConfigErrorCode.STORAGE_ERROR);
+            }
+            // 获取 storage 对象（优化：减少属性访问）
+            const storage = storageModule.storage || storageModule.default?.storage;
+            if (!storage) {
+                throw new _types.SystemConfigError('Storage not found in @vlian/framework', _types.SystemConfigErrorCode.STORAGE_ERROR);
+            }
+            // 根据策略返回对应的存储实例（优化：使用映射表）
+            const strategyMap = {
+                local: storage.local,
+                session: storage.session,
+                indexedDB: storage.indexedDB
+            };
+            const storageInstance = strategyMap[strategy] || storage.local || storage;
+            // 缓存存储实例
+            StorageManager.storageCache.set(cacheKey, storageInstance);
+            return storageInstance;
+        } catch (error) {
+            throw new _types.SystemConfigError(`Failed to initialize storage: ${error instanceof Error ? error.message : String(error)}. ` + 'Please provide storage.instance or ensure @vlian/framework is installed and provides storage API.', _types.SystemConfigErrorCode.STORAGE_ERROR, undefined, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+   * 获取存储实例
+   */ getStorage() {
+        return this.storage;
+    }
+    /**
+   * 获取值
+   */ async get(key) {
+        return this.storage.get(key);
+    }
+    /**
+   * 设置值
+   */ async set(key, value) {
+        return this.storage.set(key, value);
+    }
+    /**
+   * 删除值
+   */ async remove(key) {
+        return this.storage.remove(key);
+    }
+    constructor(options){
+        _define_property(this, "storage", void 0);
+        _define_property(this, "environment", void 0);
+        _define_property(this, "logger", void 0);
+        this.environment = options.environment;
+        this.logger = options.logger;
+        this.storage = this.initStorage(options.storage);
+    }
+};
+// 存储初始化缓存（优化性能）
+_define_property(StorageManager, "storageCache", new Map());
+
+//# sourceMappingURL=StorageManager.js.map

package/dist/cjs/managers/SystemConfigManager/modules/StorageManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/SystemConfigManager/modules/StorageManager.ts"],"sourcesContent":["/**\n * 存储管理模块\n * 封装 @vlian/framework Storage，负责存储实例初始化\n */\n\nimport type { StorageInstance, StorageStrategy, Environment } from '../types';\nimport { SystemConfigError, SystemConfigErrorCode } from '../types';\n\n/**\n * 存储管理器\n */\nexport class StorageManager {\n  private storage: StorageInstance;\n  private environment: Environment;\n  private logger?: { warn: (message: string, ...args: unknown[]) => void; error: (message: string, ...args: unknown[]) => void };\n  \n  // 存储初始化缓存（优化性能）\n  private static storageCache: Map<string, StorageInstance> = new Map();\n\n  constructor(\n    options: {\n      storage: { instance?: StorageInstance; strategy?: StorageStrategy };\n      environment: Environment;\n      logger?: { warn: (message: string, ...args: unknown[]) => void; error: (message: string, ...args: unknown[]) => void };\n    }\n  ) {\n    this.environment = options.environment;\n    this.logger = options.logger;\n    this.storage = this.initStorage(options.storage);\n  }\n\n  /**\n   * 初始化存储实例（带缓存优化）\n   */\n  private initStorage(storageConfig: { instance?: StorageInstance; strategy?: StorageStrategy }): StorageInstance {\n    // 如果直接提供了实例，直接使用（最快路径）\n    if (storageConfig.instance) {\n      return storageConfig.instance;\n    }\n\n    // 如果没有提供实例，尝试从 @vlian/framework 获取\n    const strategy = storageConfig.strategy || 'local';\n    const cacheKey = `${strategy}_${this.environment}`;\n    \n    // 检查缓存\n    if (StorageManager.storageCache.has(cacheKey)) {\n      return StorageManager.storageCache.get(cacheKey)!;\n    }\n    \n    try {\n      // SSR 环境特殊处理\n      if (this.environment === 'ssr') {\n        // SSR 环境应该使用内存存储\n        const data = new Map<string, string>();\n        const memoryStorage: StorageInstance = {\n          async get(key: string): Promise<string | null> {\n            return data.get(key) || null;\n          },\n          async set(key: string, value: string): Promise<void> {\n            data.set(key, value);\n          },\n          async remove(key: string): Promise<void> {\n            data.delete(key);\n          },\n        };\n        StorageManager.storageCache.set(cacheKey, memoryStorage);\n        return memoryStorage;\n      }\n\n      // Worker 环境特殊处理\n      if (this.environment === 'worker') {\n        // Worker 环境不支持 localStorage，使用 IndexedDB 或内存存储\n        if (strategy === 'local' || strategy === 'session') {\n          this.logger?.warn(\n            `${strategy} storage is not available in Worker environment, falling back to memory storage`\n          );\n          const data = new Map<string, string>();\n          const memoryStorage: StorageInstance = {\n            async get(key: string): Promise<string | null> {\n              return data.get(key) || null;\n            },\n            async set(key: string, value: string): Promise<void> {\n              data.set(key, value);\n            },\n            async remove(key: string): Promise<void> {\n              data.delete(key);\n            },\n          };\n          StorageManager.storageCache.set(cacheKey, memoryStorage);\n          return memoryStorage;\n        }\n      }\n\n      // 优化的获取逻辑：按优先级检查\n      let storageModule: any;\n      \n      // 1. 检查全局变量（最快，无需动态导入）\n      if (typeof globalThis !== 'undefined') {\n        const global = globalThis as any;\n        storageModule = global.window?.vlianFramework || global.vlianFramework;\n      }\n      \n      // 2. 如果全局变量不存在，尝试使用 require（仅 Node.js/CommonJS 环境）\n      if (!storageModule && typeof require !== 'undefined') {\n        try {\n          // eslint-disable-next-line @typescript-eslint/no-require-imports\n          storageModule = require('@vlian/framework');\n        } catch {\n          // require 失败，继续抛出错误\n        }\n      }\n      \n      // 如果仍然没有找到，抛出错误\n      if (!storageModule) {\n        throw new SystemConfigError(\n          '@vlian/framework is not available. ' +\n          'Please provide storage.instance or ensure @vlian/framework is installed and accessible.',\n          SystemConfigErrorCode.STORAGE_ERROR\n        );\n      }\n      \n      // 获取 storage 对象（优化：减少属性访问）\n      const storage = storageModule.storage || storageModule.default?.storage;\n      if (!storage) {\n        throw new SystemConfigError(\n          'Storage not found in @vlian/framework',\n          SystemConfigErrorCode.STORAGE_ERROR\n        );\n      }\n      \n      // 根据策略返回对应的存储实例（优化：使用映射表）\n      const strategyMap: Record<string, StorageInstance | undefined> = {\n        local: storage.local,\n        session: storage.session,\n        indexedDB: storage.indexedDB,\n      };\n      \n      const storageInstance = strategyMap[strategy] || storage.local || storage;\n      \n      // 缓存存储实例\n      StorageManager.storageCache.set(cacheKey, storageInstance);\n      \n      return storageInstance;\n    } catch (error) {\n      throw new SystemConfigError(\n        `Failed to initialize storage: ${error instanceof Error ? error.message : String(error)}. ` +\n        'Please provide storage.instance or ensure @vlian/framework is installed and provides storage API.',\n        SystemConfigErrorCode.STORAGE_ERROR,\n        undefined,\n        error instanceof Error ? error : new Error(String(error))\n      );\n    }\n  }\n\n  /**\n   * 获取存储实例\n   */\n  getStorage(): StorageInstance {\n    return this.storage;\n  }\n\n  /**\n   * 获取值\n   */\n  async get(key: string): Promise<string | null> {\n    return this.storage.get(key);\n  }\n\n  /**\n   * 设置值\n   */\n  async set(key: string, value: string): Promise<void> {\n    return this.storage.set(key, value);\n  }\n\n  /**\n   * 删除值\n   */\n  async remove(key: string): Promise<void> {\n    return this.storage.remove(key);\n  }\n}\n"],"names":["StorageManager","initStorage","storageConfig","instance","strategy","cacheKey","environment","storageCache","has","get","data","Map","memoryStorage","key","set","value","remove","delete","logger","warn","storageModule","globalThis","global","window","vlianFramework","require","SystemConfigError","SystemConfigErrorCode","STORAGE_ERROR","storage","default","strategyMap","local","session","indexedDB","storageInstance","error","Error","message","String","undefined","getStorage","options"],"mappings":"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"}

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

@@ -0,0 +1,28 @@
+/**
+ * 公共模块导出
+ */ "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 EnvironmentDetector () {
+        return _EnvironmentDetector.EnvironmentDetector;
+    },
+    get ErrorHandler () {
+        return _ErrorHandler.ErrorHandler;
+    },
+    get StorageManager () {
+        return _StorageManager.StorageManager;
+    }
+});
+const _EnvironmentDetector = require("./EnvironmentDetector");
+const _ErrorHandler = require("./ErrorHandler");
+const _StorageManager = require("./StorageManager");
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/SystemConfigManager/modules/index.ts"],"sourcesContent":["/**\n * 公共模块导出\n */\n\nexport { EnvironmentDetector } from './EnvironmentDetector';\nexport { ErrorHandler } from './ErrorHandler';\nexport { StorageManager } from './StorageManager';\n"],"names":["EnvironmentDetector","ErrorHandler","StorageManager"],"mappings":"AAAA;;CAEC;;;;;;;;;;;QAEQA;eAAAA,wCAAmB;;QACnBC;eAAAA,0BAAY;;QACZC;eAAAA,8BAAc;;;qCAFa;8BACP;gCACE"}