@vlian/framework 1.2.25 → 1.2.38

package/dist/utils/errors.cjs

@@ -13,10 +13,10 @@ _export(exports, {
         return ConfigError;
     },
     get ErrorCode () {
-        return _ErrorCodes.ErrorCode;
+        return ErrorCode;
     },
     get ErrorMessages () {
-        return _ErrorCodes.ErrorMessages;
+        return ErrorMessages;
     },
     get ErrorSeverity () {
         return ErrorSeverity;
@@ -46,341 +46,68 @@ _export(exports, {
         return errorUtils;
     },
     get getErrorMessage () {
-        return _ErrorCodes.getErrorMessage;
+        return getErrorMessage;
     },
     get getUserFriendlyMessage () {
-        return _ErrorCodes.getUserFriendlyMessage;
+        return getUserFriendlyMessage;
     }
 });
-const _ErrorCodes = require("./errors/ErrorCodes");
-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;
+const _utils = /*#__PURE__*/ _interop_require_wildcard(require("@vlian/utils"));
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
 }
-var ErrorType = /*#__PURE__*/ function(ErrorType) {
-    /**
-   * 初始化错误
-   */ ErrorType["INITIALIZATION"] = "INITIALIZATION";
-    /**
-   * 配置错误
-   */ ErrorType["CONFIG"] = "CONFIG";
-    /**
-   * 存储错误
-   */ ErrorType["STORAGE"] = "STORAGE";
-    /**
-   * 网络错误
-   */ ErrorType["NETWORK"] = "NETWORK";
-    /**
-   * 验证错误
-   */ ErrorType["VALIDATION"] = "VALIDATION";
-    /**
-   * 安全错误
-   */ ErrorType["SECURITY"] = "SECURITY";
-    /**
-   * 运行时错误
-   */ ErrorType["RUNTIME"] = "RUNTIME";
-    /**
-   * 未知错误
-   */ ErrorType["UNKNOWN"] = "UNKNOWN";
-    return ErrorType;
-}({});
-var ErrorSeverity = /*#__PURE__*/ function(ErrorSeverity) {
-    /**
-   * 低 - 不影响核心功能
-   */ ErrorSeverity["LOW"] = "LOW";
-    /**
-   * 中 - 影响部分功能
-   */ ErrorSeverity["MEDIUM"] = "MEDIUM";
-    /**
-   * 高 - 影响核心功能
-   */ ErrorSeverity["HIGH"] = "HIGH";
-    /**
-   * 严重 - 导致应用无法使用
-   */ ErrorSeverity["CRITICAL"] = "CRITICAL";
-    return ErrorSeverity;
-}({});
-let FrameworkError = class FrameworkError extends Error {
-    /**
-   * 转换为 JSON
-   */ toJSON() {
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
         return {
-            name: this.name,
-            message: this.message,
-            type: this.type,
-            severity: this.severity,
-            code: this.code,
-            recoverable: this.recoverable,
-            context: this.context,
-            stack: this.stack,
-            originalError: this.originalError ? {
-                name: this.originalError.name,
-                message: this.originalError.message,
-                stack: this.originalError.stack
-            } : undefined
+            default: obj
         };
     }
-    constructor(message, type = "UNKNOWN", severity = "MEDIUM", options){
-        super(message), /**
-   * 错误类型
-   */ _define_property(this, "type", void 0), /**
-   * 错误严重程度
-   */ _define_property(this, "severity", void 0), /**
-   * 错误代码
-   */ _define_property(this, "code", void 0), /**
-   * 原始错误
-   */ _define_property(this, "originalError", void 0), /**
-   * 错误上下文
-   */ _define_property(this, "context", void 0), /**
-   * 是否可恢复
-   */ _define_property(this, "recoverable", void 0);
-        this.name = 'FrameworkError';
-        this.type = type;
-        this.severity = severity;
-        this.code = options?.code || `${type}_ERROR`;
-        this.originalError = options?.originalError;
-        this.context = options?.context;
-        this.recoverable = options?.recoverable ?? false;
-        // 保持正确的堆栈跟踪
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, FrameworkError);
-        }
-    }
-};
-let InitializationError = class InitializationError extends FrameworkError {
-    constructor(message, originalError, context, errorCode){
-        const code = errorCode || _ErrorCodes.ErrorCode.INITIALIZATION_FAILED;
-        super((0, _ErrorCodes.getUserFriendlyMessage)(code, message), "INITIALIZATION", "CRITICAL", {
-            code: _ErrorCodes.ErrorCode[code],
-            originalError,
-            context,
-            recoverable: false
-        });
-        this.name = 'InitializationError';
-    }
-};
-let ConfigError = class ConfigError extends FrameworkError {
-    constructor(message, originalError, context, errorCode){
-        const code = errorCode || _ErrorCodes.ErrorCode.CONFIG_LOAD_FAILED;
-        super((0, _ErrorCodes.getUserFriendlyMessage)(code, message), "CONFIG", "HIGH", {
-            code: _ErrorCodes.ErrorCode[code],
-            originalError,
-            context,
-            recoverable: true
-        });
-        this.name = 'ConfigError';
-    }
-};
-let StorageError = class StorageError extends FrameworkError {
-    constructor(message, originalError, context){
-        super(message, "STORAGE", "MEDIUM", {
-            code: 'STORAGE_ERROR',
-            originalError,
-            context,
-            recoverable: true
-        });
-        this.name = 'StorageError';
-    }
-};
-let NetworkError = class NetworkError extends FrameworkError {
-    constructor(message, originalError, context, errorCode){
-        const code = errorCode || _ErrorCodes.ErrorCode.NETWORK_ERROR;
-        super((0, _ErrorCodes.getUserFriendlyMessage)(code, message), "NETWORK", "MEDIUM", {
-            code: _ErrorCodes.ErrorCode[code],
-            originalError,
-            context,
-            recoverable: true
-        });
-        this.name = 'NetworkError';
-    }
-};
-let ValidationError = class ValidationError extends FrameworkError {
-    constructor(message, context){
-        super(message, "VALIDATION", "LOW", {
-            code: 'VALIDATION_ERROR',
-            context,
-            recoverable: true
-        });
-        this.name = 'ValidationError';
-    }
-};
-let SecurityError = class SecurityError extends FrameworkError {
-    constructor(message, originalError, context){
-        super(message, "SECURITY", "HIGH", {
-            code: 'SECURITY_ERROR',
-            originalError,
-            context,
-            recoverable: false
-        });
-        this.name = 'SecurityError';
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
     }
-};
-const errorUtils = {
-    /**
-   * 安全地将未知错误转换为可展示的消息
-   * 避免 String(error) 对 null-prototype 对象再次抛错
-   */ getSafeErrorMessage (error) {
-        if (typeof error === 'string') {
-            return error;
-        }
-        if (typeof error === 'number' || typeof error === 'boolean' || typeof error === 'bigint' || typeof error === 'symbol' || error === null || error === undefined) {
-            try {
-                return String(error);
-            } catch  {
-                return 'Unknown error';
-            }
-        }
-        if (typeof error === 'object') {
-            try {
-                const maybeMessage = error.message;
-                if (typeof maybeMessage === 'string' && maybeMessage.trim()) {
-                    return maybeMessage;
-                }
-            } catch  {
-            // ignore
-            }
-            try {
-                const json = JSON.stringify(error);
-                if (json) {
-                    return json;
-                }
-            } catch  {
-            // ignore
-            }
-            try {
-                return `Non-Error throwable: ${Object.prototype.toString.call(error)}`;
-            } catch  {
-                return 'Non-Error throwable';
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
             }
         }
-        try {
-            return String(error);
-        } catch  {
-            return 'Unknown error';
-        }
-    },
-    /**
-   * 判断错误是否可恢复
-   */ isRecoverable (error) {
-        if (error instanceof FrameworkError) {
-            return error.recoverable;
-        }
-        return false;
-    },
-    /**
-   * 获取错误类型
-   */ getErrorType (error) {
-        if (error instanceof FrameworkError) {
-            return error.type;
-        }
-        return "UNKNOWN";
-    },
-    /**
-   * 获取错误严重程度
-   */ getErrorSeverity (error) {
-        if (error instanceof FrameworkError) {
-            return error.severity;
-        }
-        return "MEDIUM";
-    },
-    /**
-   * 标准化错误对象
-   */ normalizeError (error) {
-        if (error instanceof FrameworkError) {
-            return error;
-        }
-        if (error instanceof Error) {
-            return new FrameworkError(error.message, "UNKNOWN", "MEDIUM", {
-                originalError: error
-            });
-        }
-        return new FrameworkError(errorUtils.getSafeErrorMessage(error), "UNKNOWN", "MEDIUM");
-    },
-    /**
-   * 提取错误信息
-   */ extractErrorInfo (error) {
-        const normalized = errorUtils.normalizeError(error);
-        return {
-            message: normalized.message,
-            type: normalized.type,
-            severity: normalized.severity,
-            code: normalized.code,
-            stack: normalized.stack
-        };
-    },
-    /**
-   * 获取错误修复建议
-   * 
-   * 优化：根据错误类型和代码提供修复建议
-   */ getErrorSuggestions (error) {
-        const normalized = errorUtils.normalizeError(error);
-        const suggestions = [];
-        // 根据错误代码提供建议
-        switch(normalized.code){
-            case 'CONTAINER_NOT_FOUND':
-                suggestions.push('请确保页面中存在 id="root" 的元素，或通过 container 选项指定挂载容器');
-                suggestions.push('检查 DOM 是否已加载完成，确保在 DOMContentLoaded 事件后调用 start()');
-                break;
-            case 'NETWORK_ERROR':
-                suggestions.push('检查网络连接是否正常');
-                suggestions.push('检查服务器是否正常运行');
-                suggestions.push('检查 CORS 配置是否正确');
-                break;
-            case 'TIMEOUT_ERROR':
-                suggestions.push('增加超时时间配置');
-                suggestions.push('检查网络连接是否稳定');
-                suggestions.push('检查服务器响应速度');
-                break;
-            case 'VALIDATION_ERROR':
-                suggestions.push('检查配置项是否符合要求');
-                suggestions.push('查看配置验证错误详情');
-                suggestions.push('参考配置文档确认配置格式');
-                break;
-            case 'INITIALIZATION_ERROR':
-                suggestions.push('检查初始化配置是否正确');
-                suggestions.push('查看初始化日志了解详细错误');
-                suggestions.push('尝试简化配置，逐步排查问题');
-                break;
-            default:
-                if (normalized.type === "SECURITY") {
-                    suggestions.push('检查输入内容是否包含不安全字符');
-                    suggestions.push('确保配置项来源可信');
-                    suggestions.push('查看安全配置文档');
-                }
-        }
-        // 如果是可恢复的错误，提供恢复建议
-        if (normalized.recoverable) {
-            suggestions.push('此错误可以自动恢复，请稍后重试');
-        }
-        return suggestions;
-    },
-    /**
-   * 格式化错误信息（用于开发环境）
-   * 
-   * 优化：提供更详细的错误信息，包括修复建议
-   */ formatErrorForDev (error) {
-        const normalized = errorUtils.normalizeError(error);
-        const suggestions = errorUtils.getErrorSuggestions(error);
-        let message = `[${normalized.code}] ${normalized.message}`;
-        if (normalized.stack) {
-            message += `\n\n堆栈信息:\n${normalized.stack}`;
-        }
-        if (suggestions.length > 0) {
-            message += `\n\n修复建议:\n${suggestions.map((s, i)=>`${i + 1}. ${s}`).join('\n')}`;
-        }
-        if (normalized.context) {
-            message += `\n\n上下文信息:\n${JSON.stringify(normalized.context, null, 2)}`;
-        }
-        return message;
     }
-};
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+const utils = _utils;
+const ErrorCode = utils.ErrorCode;
+const ErrorMessages = utils.ErrorMessages;
+const getErrorMessage = utils.getErrorMessage;
+const getUserFriendlyMessage = utils.getUserFriendlyMessage;
+const ErrorType = utils.ErrorType;
+const ErrorSeverity = utils.ErrorSeverity;
+const FrameworkError = utils.FrameworkError;
+const InitializationError = utils.InitializationError;
+const ConfigError = utils.ConfigError;
+const StorageError = utils.StorageError;
+const NetworkError = utils.NetworkError;
+const ValidationError = utils.ValidationError;
+const SecurityError = utils.SecurityError;
+const errorUtils = utils.errorUtils;
 
 //# sourceMappingURL=errors.js.map

package/dist/utils/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/errors.ts"],"sourcesContent":["import { ErrorCode, getUserFriendlyMessage } from './errors/ErrorCodes';\n\n// 导出错误码相关类型和函数\nexport { ErrorCode, ErrorMessages, getErrorMessage, getUserFriendlyMessage } from './errors/ErrorCodes';\n\n/**\n * 错误类型枚举\n */\nexport enum ErrorType {\n  /**\n   * 初始化错误\n   */\n  INITIALIZATION = 'INITIALIZATION',\n  /**\n   * 配置错误\n   */\n  CONFIG = 'CONFIG',\n  /**\n   * 存储错误\n   */\n  STORAGE = 'STORAGE',\n  /**\n   * 网络错误\n   */\n  NETWORK = 'NETWORK',\n  /**\n   * 验证错误\n   */\n  VALIDATION = 'VALIDATION',\n  /**\n   * 安全错误\n   */\n  SECURITY = 'SECURITY',\n  /**\n   * 运行时错误\n   */\n  RUNTIME = 'RUNTIME',\n  /**\n   * 未知错误\n   */\n  UNKNOWN = 'UNKNOWN',\n}\n\n/**\n * 错误严重程度\n */\nexport enum ErrorSeverity {\n  /**\n   * 低 - 不影响核心功能\n   */\n  LOW = 'LOW',\n  /**\n   * 中 - 影响部分功能\n   */\n  MEDIUM = 'MEDIUM',\n  /**\n   * 高 - 影响核心功能\n   */\n  HIGH = 'HIGH',\n  /**\n   * 严重 - 导致应用无法使用\n   */\n  CRITICAL = 'CRITICAL',\n}\n\n/**\n * 框架错误基类\n */\nexport class FrameworkError extends Error {\n  /**\n   * 错误类型\n   */\n  public readonly type: ErrorType;\n\n  /**\n   * 错误严重程度\n   */\n  public readonly severity: ErrorSeverity;\n\n  /**\n   * 错误代码\n   */\n  public readonly code: string;\n\n  /**\n   * 原始错误\n   */\n  public readonly originalError?: Error;\n\n  /**\n   * 错误上下文\n   */\n  public readonly context?: Record<string, unknown>;\n\n  /**\n   * 是否可恢复\n   */\n  public readonly recoverable: boolean;\n\n  constructor(\n    message: string,\n    type: ErrorType = ErrorType.UNKNOWN,\n    severity: ErrorSeverity = ErrorSeverity.MEDIUM,\n    options?: {\n      code?: string;\n      originalError?: Error;\n      context?: Record<string, unknown>;\n      recoverable?: boolean;\n    }\n  ) {\n    super(message);\n    this.name = 'FrameworkError';\n    this.type = type;\n    this.severity = severity;\n    this.code = options?.code || `${type}_ERROR`;\n    this.originalError = options?.originalError;\n    this.context = options?.context;\n    this.recoverable = options?.recoverable ?? false;\n\n    // 保持正确的堆栈跟踪\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, FrameworkError);\n    }\n  }\n\n  /**\n   * 转换为 JSON\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      type: this.type,\n      severity: this.severity,\n      code: this.code,\n      recoverable: this.recoverable,\n      context: this.context,\n      stack: this.stack,\n      originalError: this.originalError\n        ? {\n            name: this.originalError.name,\n            message: this.originalError.message,\n            stack: this.originalError.stack,\n          }\n        : undefined,\n    };\n  }\n}\n\n/**\n * 初始化错误\n */\nexport class InitializationError extends FrameworkError {\n  constructor(\n    message: string,\n    originalError?: Error,\n    context?: Record<string, unknown>,\n    errorCode?: ErrorCode\n  ) {\n    const code = errorCode || ErrorCode.INITIALIZATION_FAILED;\n    super(getUserFriendlyMessage(code, message), ErrorType.INITIALIZATION, ErrorSeverity.CRITICAL, {\n      code: ErrorCode[code],\n      originalError,\n      context,\n      recoverable: false,\n    });\n    this.name = 'InitializationError';\n  }\n}\n\n/**\n * 配置错误\n */\nexport class ConfigError extends FrameworkError {\n  constructor(\n    message: string,\n    originalError?: Error,\n    context?: Record<string, unknown>,\n    errorCode?: ErrorCode\n  ) {\n    const code = errorCode || ErrorCode.CONFIG_LOAD_FAILED;\n    super(getUserFriendlyMessage(code, message), ErrorType.CONFIG, ErrorSeverity.HIGH, {\n      code: ErrorCode[code],\n      originalError,\n      context,\n      recoverable: true,\n    });\n    this.name = 'ConfigError';\n  }\n}\n\n/**\n * 存储错误\n */\nexport class StorageError extends FrameworkError {\n  constructor(message: string, originalError?: Error, context?: Record<string, unknown>) {\n    super(message, ErrorType.STORAGE, ErrorSeverity.MEDIUM, {\n      code: 'STORAGE_ERROR',\n      originalError,\n      context,\n      recoverable: true,\n    });\n    this.name = 'StorageError';\n  }\n}\n\n/**\n * 网络错误\n */\nexport class NetworkError extends FrameworkError {\n  constructor(\n    message: string,\n    originalError?: Error,\n    context?: Record<string, unknown>,\n    errorCode?: ErrorCode\n  ) {\n    const code = errorCode || ErrorCode.NETWORK_ERROR;\n    super(getUserFriendlyMessage(code, message), ErrorType.NETWORK, ErrorSeverity.MEDIUM, {\n      code: ErrorCode[code],\n      originalError,\n      context,\n      recoverable: true,\n    });\n    this.name = 'NetworkError';\n  }\n}\n\n/**\n * 验证错误\n */\nexport class ValidationError extends FrameworkError {\n  constructor(message: string, context?: Record<string, unknown>) {\n    super(message, ErrorType.VALIDATION, ErrorSeverity.LOW, {\n      code: 'VALIDATION_ERROR',\n      context,\n      recoverable: true,\n    });\n    this.name = 'ValidationError';\n  }\n}\n\n/**\n * 安全错误\n */\nexport class SecurityError extends FrameworkError {\n  constructor(message: string, originalError?: Error, context?: Record<string, unknown>) {\n    super(message, ErrorType.SECURITY, ErrorSeverity.HIGH, {\n      code: 'SECURITY_ERROR',\n      originalError,\n      context,\n      recoverable: false,\n    });\n    this.name = 'SecurityError';\n  }\n}\n\n/**\n * 错误处理工具函数\n */\nexport const errorUtils = {\n  /**\n   * 安全地将未知错误转换为可展示的消息\n   * 避免 String(error) 对 null-prototype 对象再次抛错\n   */\n  getSafeErrorMessage(error: unknown): string {\n    if (typeof error === 'string') {\n      return error;\n    }\n\n    if (\n      typeof error === 'number' ||\n      typeof error === 'boolean' ||\n      typeof error === 'bigint' ||\n      typeof error === 'symbol' ||\n      error === null ||\n      error === undefined\n    ) {\n      try {\n        return String(error);\n      } catch {\n        return 'Unknown error';\n      }\n    }\n\n    if (typeof error === 'object') {\n      try {\n        const maybeMessage = (error as { message?: unknown }).message;\n        if (typeof maybeMessage === 'string' && maybeMessage.trim()) {\n          return maybeMessage;\n        }\n      } catch {\n        // ignore\n      }\n\n      try {\n        const json = JSON.stringify(error);\n        if (json) {\n          return json;\n        }\n      } catch {\n        // ignore\n      }\n\n      try {\n        return `Non-Error throwable: ${Object.prototype.toString.call(error)}`;\n      } catch {\n        return 'Non-Error throwable';\n      }\n    }\n\n    try {\n      return String(error);\n    } catch {\n      return 'Unknown error';\n    }\n  },\n\n  /**\n   * 判断错误是否可恢复\n   */\n  isRecoverable(error: unknown): boolean {\n    if (error instanceof FrameworkError) {\n      return error.recoverable;\n    }\n    return false;\n  },\n\n  /**\n   * 获取错误类型\n   */\n  getErrorType(error: unknown): ErrorType {\n    if (error instanceof FrameworkError) {\n      return error.type;\n    }\n    return ErrorType.UNKNOWN;\n  },\n\n  /**\n   * 获取错误严重程度\n   */\n  getErrorSeverity(error: unknown): ErrorSeverity {\n    if (error instanceof FrameworkError) {\n      return error.severity;\n    }\n    return ErrorSeverity.MEDIUM;\n  },\n\n  /**\n   * 标准化错误对象\n   */\n  normalizeError(error: unknown): FrameworkError {\n    if (error instanceof FrameworkError) {\n      return error;\n    }\n\n    if (error instanceof Error) {\n      return new FrameworkError(error.message, ErrorType.UNKNOWN, ErrorSeverity.MEDIUM, {\n        originalError: error,\n      });\n    }\n\n    return new FrameworkError(errorUtils.getSafeErrorMessage(error), ErrorType.UNKNOWN, ErrorSeverity.MEDIUM);\n  },\n\n  /**\n   * 提取错误信息\n   */\n  extractErrorInfo(error: unknown): {\n    message: string;\n    type: ErrorType;\n    severity: ErrorSeverity;\n    code: string;\n    stack?: string;\n  } {\n    const normalized = errorUtils.normalizeError(error);\n    return {\n      message: normalized.message,\n      type: normalized.type,\n      severity: normalized.severity,\n      code: normalized.code,\n      stack: normalized.stack,\n    };\n  },\n\n  /**\n   * 获取错误修复建议\n   * \n   * 优化：根据错误类型和代码提供修复建议\n   */\n  getErrorSuggestions(error: unknown): string[] {\n    const normalized = errorUtils.normalizeError(error);\n    const suggestions: string[] = [];\n\n    // 根据错误代码提供建议\n    switch (normalized.code) {\n      case 'CONTAINER_NOT_FOUND':\n        suggestions.push('请确保页面中存在 id=\"root\" 的元素，或通过 container 选项指定挂载容器');\n        suggestions.push('检查 DOM 是否已加载完成，确保在 DOMContentLoaded 事件后调用 start()');\n        break;\n      case 'NETWORK_ERROR':\n        suggestions.push('检查网络连接是否正常');\n        suggestions.push('检查服务器是否正常运行');\n        suggestions.push('检查 CORS 配置是否正确');\n        break;\n      case 'TIMEOUT_ERROR':\n        suggestions.push('增加超时时间配置');\n        suggestions.push('检查网络连接是否稳定');\n        suggestions.push('检查服务器响应速度');\n        break;\n      case 'VALIDATION_ERROR':\n        suggestions.push('检查配置项是否符合要求');\n        suggestions.push('查看配置验证错误详情');\n        suggestions.push('参考配置文档确认配置格式');\n        break;\n      case 'INITIALIZATION_ERROR':\n        suggestions.push('检查初始化配置是否正确');\n        suggestions.push('查看初始化日志了解详细错误');\n        suggestions.push('尝试简化配置，逐步排查问题');\n        break;\n      default:\n        if (normalized.type === ErrorType.SECURITY) {\n          suggestions.push('检查输入内容是否包含不安全字符');\n          suggestions.push('确保配置项来源可信');\n          suggestions.push('查看安全配置文档');\n        }\n    }\n\n    // 如果是可恢复的错误，提供恢复建议\n    if (normalized.recoverable) {\n      suggestions.push('此错误可以自动恢复，请稍后重试');\n    }\n\n    return suggestions;\n  },\n\n  /**\n   * 格式化错误信息（用于开发环境）\n   * \n   * 优化：提供更详细的错误信息，包括修复建议\n   */\n  formatErrorForDev(error: unknown): string {\n    const normalized = errorUtils.normalizeError(error);\n    const suggestions = errorUtils.getErrorSuggestions(error);\n    \n    let message = `[${normalized.code}] ${normalized.message}`;\n    \n    if (normalized.stack) {\n      message += `\\n\\n堆栈信息:\\n${normalized.stack}`;\n    }\n    \n    if (suggestions.length > 0) {\n      message += `\\n\\n修复建议:\\n${suggestions.map((s, i) => `${i + 1}. ${s}`).join('\\n')}`;\n    }\n    \n    if (normalized.context) {\n      message += `\\n\\n上下文信息:\\n${JSON.stringify(normalized.context, null, 2)}`;\n    }\n    \n    return message;\n  },\n};\n"],"names":["ConfigError","ErrorCode","ErrorMessages","ErrorSeverity","ErrorType","FrameworkError","InitializationError","NetworkError","SecurityError","StorageError","ValidationError","errorUtils","getErrorMessage","getUserFriendlyMessage","Error","toJSON","name","message","type","severity","code","recoverable","context","stack","originalError","undefined","options","captureStackTrace","errorCode","INITIALIZATION_FAILED","CONFIG_LOAD_FAILED","NETWORK_ERROR","getSafeErrorMessage","error","String","maybeMessage","trim","json","JSON","stringify","Object","prototype","toString","call","isRecoverable","getErrorType","getErrorSeverity","normalizeError","extractErrorInfo","normalized","getErrorSuggestions","suggestions","push","formatErrorForDev","length","map","s","i","join"],"mappings":"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"}
+{"version":3,"sources":["../../src/utils/errors.ts"],"sourcesContent":["import * as vlianUtils from '@vlian/utils';\n\nconst utils = vlianUtils as typeof import('@vlian/utils');\n\nexport const ErrorCode = utils.ErrorCode;\nexport const ErrorMessages = utils.ErrorMessages;\nexport const getErrorMessage = utils.getErrorMessage;\nexport const getUserFriendlyMessage = utils.getUserFriendlyMessage;\nexport const ErrorType = utils.ErrorType;\nexport const ErrorSeverity = utils.ErrorSeverity;\nexport const FrameworkError = utils.FrameworkError;\nexport const InitializationError = utils.InitializationError;\nexport const ConfigError = utils.ConfigError;\nexport const StorageError = utils.StorageError;\nexport const NetworkError = utils.NetworkError;\nexport const ValidationError = utils.ValidationError;\nexport const SecurityError = utils.SecurityError;\nexport const errorUtils = utils.errorUtils;\n"],"names":["ConfigError","ErrorCode","ErrorMessages","ErrorSeverity","ErrorType","FrameworkError","InitializationError","NetworkError","SecurityError","StorageError","ValidationError","errorUtils","getErrorMessage","getUserFriendlyMessage","utils","vlianUtils"],"mappings":";;;;;;;;;;;QAYaA;eAAAA;;QARAC;eAAAA;;QACAC;eAAAA;;QAIAC;eAAAA;;QADAC;eAAAA;;QAEAC;eAAAA;;QACAC;eAAAA;;QAGAC;eAAAA;;QAEAC;eAAAA;;QAHAC;eAAAA;;QAEAC;eAAAA;;QAEAC;eAAAA;;QAXAC;eAAAA;;QACAC;eAAAA;;;+DAPe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE5B,MAAMC,QAAQC;AAEP,MAAMd,YAAYa,MAAMb,SAAS;AACjC,MAAMC,gBAAgBY,MAAMZ,aAAa;AACzC,MAAMU,kBAAkBE,MAAMF,eAAe;AAC7C,MAAMC,yBAAyBC,MAAMD,sBAAsB;AAC3D,MAAMT,YAAYU,MAAMV,SAAS;AACjC,MAAMD,gBAAgBW,MAAMX,aAAa;AACzC,MAAME,iBAAiBS,MAAMT,cAAc;AAC3C,MAAMC,sBAAsBQ,MAAMR,mBAAmB;AACrD,MAAMN,cAAcc,MAAMd,WAAW;AACrC,MAAMS,eAAeK,MAAML,YAAY;AACvC,MAAMF,eAAeO,MAAMP,YAAY;AACvC,MAAMG,kBAAkBI,MAAMJ,eAAe;AAC7C,MAAMF,gBAAgBM,MAAMN,aAAa;AACzC,MAAMG,aAAaG,MAAMH,UAAU"}

package/dist/utils/errors.d.ts

@@ -1,183 +1,30 @@
-import { ErrorCode } from './errors/ErrorCodes';
-export { ErrorCode, ErrorMessages, getErrorMessage, getUserFriendlyMessage } from './errors/ErrorCodes';
-/**
- * 错误类型枚举
- */
-export declare enum ErrorType {
-    /**
-     * 初始化错误
-     */
-    INITIALIZATION = "INITIALIZATION",
-    /**
-     * 配置错误
-     */
-    CONFIG = "CONFIG",
-    /**
-     * 存储错误
-     */
-    STORAGE = "STORAGE",
-    /**
-     * 网络错误
-     */
-    NETWORK = "NETWORK",
-    /**
-     * 验证错误
-     */
-    VALIDATION = "VALIDATION",
-    /**
-     * 安全错误
-     */
-    SECURITY = "SECURITY",
-    /**
-     * 运行时错误
-     */
-    RUNTIME = "RUNTIME",
-    /**
-     * 未知错误
-     */
-    UNKNOWN = "UNKNOWN"
-}
-/**
- * 错误严重程度
- */
-export declare enum ErrorSeverity {
-    /**
-     * 低 - 不影响核心功能
-     */
-    LOW = "LOW",
-    /**
-     * 中 - 影响部分功能
-     */
-    MEDIUM = "MEDIUM",
-    /**
-     * 高 - 影响核心功能
-     */
-    HIGH = "HIGH",
-    /**
-     * 严重 - 导致应用无法使用
-     */
-    CRITICAL = "CRITICAL"
-}
-/**
- * 框架错误基类
- */
-export declare class FrameworkError extends Error {
-    /**
-     * 错误类型
-     */
-    readonly type: ErrorType;
-    /**
-     * 错误严重程度
-     */
-    readonly severity: ErrorSeverity;
-    /**
-     * 错误代码
-     */
-    readonly code: string;
-    /**
-     * 原始错误
-     */
-    readonly originalError?: Error;
-    /**
-     * 错误上下文
-     */
-    readonly context?: Record<string, unknown>;
-    /**
-     * 是否可恢复
-     */
-    readonly recoverable: boolean;
-    constructor(message: string, type?: ErrorType, severity?: ErrorSeverity, options?: {
-        code?: string;
-        originalError?: Error;
-        context?: Record<string, unknown>;
-        recoverable?: boolean;
-    });
-    /**
-     * 转换为 JSON
-     */
-    toJSON(): Record<string, unknown>;
-}
-/**
- * 初始化错误
- */
-export declare class InitializationError extends FrameworkError {
-    constructor(message: string, originalError?: Error, context?: Record<string, unknown>, errorCode?: ErrorCode);
-}
-/**
- * 配置错误
- */
-export declare class ConfigError extends FrameworkError {
-    constructor(message: string, originalError?: Error, context?: Record<string, unknown>, errorCode?: ErrorCode);
-}
-/**
- * 存储错误
- */
-export declare class StorageError extends FrameworkError {
-    constructor(message: string, originalError?: Error, context?: Record<string, unknown>);
-}
-/**
- * 网络错误
- */
-export declare class NetworkError extends FrameworkError {
-    constructor(message: string, originalError?: Error, context?: Record<string, unknown>, errorCode?: ErrorCode);
-}
-/**
- * 验证错误
- */
-export declare class ValidationError extends FrameworkError {
-    constructor(message: string, context?: Record<string, unknown>);
-}
-/**
- * 安全错误
- */
-export declare class SecurityError extends FrameworkError {
-    constructor(message: string, originalError?: Error, context?: Record<string, unknown>);
-}
-/**
- * 错误处理工具函数
- */
+import * as vlianUtils from '@vlian/utils';
+export declare const ErrorCode: typeof vlianUtils.ErrorCode;
+export declare const ErrorMessages: Record<vlianUtils.ErrorCode, string>;
+export declare const getErrorMessage: typeof vlianUtils.getErrorMessage;
+export declare const getUserFriendlyMessage: typeof vlianUtils.getUserFriendlyMessage;
+export declare const ErrorType: typeof vlianUtils.ErrorType;
+export declare const ErrorSeverity: typeof vlianUtils.ErrorSeverity;
+export declare const FrameworkError: typeof vlianUtils.FrameworkError;
+export declare const InitializationError: typeof vlianUtils.InitializationError;
+export declare const ConfigError: typeof vlianUtils.ConfigError;
+export declare const StorageError: typeof vlianUtils.StorageError;
+export declare const NetworkError: typeof vlianUtils.NetworkError;
+export declare const ValidationError: typeof vlianUtils.ValidationError;
+export declare const SecurityError: typeof vlianUtils.SecurityError;
 export declare const errorUtils: {
-    /**
-     * 安全地将未知错误转换为可展示的消息
-     * 避免 String(error) 对 null-prototype 对象再次抛错
-     */
     getSafeErrorMessage(error: unknown): string;
-    /**
-     * 判断错误是否可恢复
-     */
     isRecoverable(error: unknown): boolean;
-    /**
-     * 获取错误类型
-     */
-    getErrorType(error: unknown): ErrorType;
-    /**
-     * 获取错误严重程度
-     */
-    getErrorSeverity(error: unknown): ErrorSeverity;
-    /**
-     * 标准化错误对象
-     */
-    normalizeError(error: unknown): FrameworkError;
-    /**
-     * 提取错误信息
-     */
+    getErrorType(error: unknown): vlianUtils.ErrorType;
+    getErrorSeverity(error: unknown): vlianUtils.ErrorSeverity;
+    normalizeError(error: unknown): vlianUtils.FrameworkError;
     extractErrorInfo(error: unknown): {
         message: string;
-        type: ErrorType;
-        severity: ErrorSeverity;
+        type: vlianUtils.ErrorType;
+        severity: vlianUtils.ErrorSeverity;
         code: string;
         stack?: string;
     };
-    /**
-     * 获取错误修复建议
-     *
-     * 优化：根据错误类型和代码提供修复建议
-     */
     getErrorSuggestions(error: unknown): string[];
-    /**
-     * 格式化错误信息（用于开发环境）
-     *
-     * 优化：提供更详细的错误信息，包括修复建议
-     */
     formatErrorForDev(error: unknown): string;
 };