@vlian/framework 1.0.0

package/dist/utils/errors.cjs

@@ -0,0 +1,343 @@
+"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 ConfigError () {
+        return ConfigError;
+    },
+    get ErrorCode () {
+        return _ErrorCodes.ErrorCode;
+    },
+    get ErrorMessages () {
+        return _ErrorCodes.ErrorMessages;
+    },
+    get ErrorSeverity () {
+        return ErrorSeverity;
+    },
+    get ErrorType () {
+        return ErrorType;
+    },
+    get FrameworkError () {
+        return FrameworkError;
+    },
+    get InitializationError () {
+        return InitializationError;
+    },
+    get NetworkError () {
+        return NetworkError;
+    },
+    get SecurityError () {
+        return SecurityError;
+    },
+    get StorageError () {
+        return StorageError;
+    },
+    get ValidationError () {
+        return ValidationError;
+    },
+    get errorUtils () {
+        return errorUtils;
+    },
+    get getErrorMessage () {
+        return _ErrorCodes.getErrorMessage;
+    },
+    get getUserFriendlyMessage () {
+        return _ErrorCodes.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;
+}
+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() {
+        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
+        };
+    }
+    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';
+    }
+};
+const errorUtils = {
+    /**
+   * 判断错误是否可恢复
+   */ 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(String(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;
+    }
+};
+
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.cjs.map

@@ -0,0 +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   */\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(String(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","isRecoverable","error","getErrorType","getErrorSeverity","normalizeError","String","extractErrorInfo","normalized","getErrorSuggestions","suggestions","push","formatErrorForDev","length","map","s","i","join","JSON","stringify"],"mappings":";;;;;;;;;;;QA6KaA;eAAAA;;QA1KJC;eAAAA,qBAAS;;QAAEC;eAAAA,yBAAa;;QA2CrBC;eAAAA;;QAtCAC;eAAAA;;QA4DCC;eAAAA;;QAoFAC;eAAAA;;QAyDAC;eAAAA;;QAmCAC;eAAAA;;QAlDAC;eAAAA;;QAoCAC;eAAAA;;QA6BAC;eAAAA;;QAhQsBC;eAAAA,2BAAe;;QAAEC;eAAAA,kCAAsB;;;4BAHxB;;;;;;;;;;;;;;AAQ3C,IAAA,AAAKT,mCAAAA;IACV;;GAEC;IAED;;GAEC;IAED;;GAEC;IAED;;GAEC;IAED;;GAEC;IAED;;GAEC;IAED;;GAEC;IAED;;GAEC;WA/BSA;;AAsCL,IAAA,AAAKD,uCAAAA;IACV;;GAEC;IAED;;GAEC;IAED;;GAEC;IAED;;GAEC;WAfSA;;AAsBL,IAAA,AAAME,iBAAN,MAAMA,uBAAuBS;IAyDlC;;GAEC,GACDC,SAAkC;QAChC,OAAO;YACLC,MAAM,IAAI,CAACA,IAAI;YACfC,SAAS,IAAI,CAACA,OAAO;YACrBC,MAAM,IAAI,CAACA,IAAI;YACfC,UAAU,IAAI,CAACA,QAAQ;YACvBC,MAAM,IAAI,CAACA,IAAI;YACfC,aAAa,IAAI,CAACA,WAAW;YAC7BC,SAAS,IAAI,CAACA,OAAO;YACrBC,OAAO,IAAI,CAACA,KAAK;YACjBC,eAAe,IAAI,CAACA,aAAa,GAC7B;gBACER,MAAM,IAAI,CAACQ,aAAa,CAACR,IAAI;gBAC7BC,SAAS,IAAI,CAACO,aAAa,CAACP,OAAO;gBACnCM,OAAO,IAAI,CAACC,aAAa,CAACD,KAAK;YACjC,IACAE;QACN;IACF;IA/CA,YACER,OAAe,EACfC,gBAAmC,EACnCC,mBAA8C,EAC9CO,OAKC,CACD;QACA,KAAK,CAACT,UAzCR;;GAEC,GACD,uBAAgBC,QAAhB,KAAA,IAEA;;GAEC,GACD,uBAAgBC,YAAhB,KAAA,IAEA;;GAEC,GACD,uBAAgBC,QAAhB,KAAA,IAEA;;GAEC,GACD,uBAAgBI,iBAAhB,KAAA,IAEA;;GAEC,GACD,uBAAgBF,WAAhB,KAAA,IAEA;;GAEC,GACD,uBAAgBD,eAAhB,KAAA;QAcE,IAAI,CAACL,IAAI,GAAG;QACZ,IAAI,CAACE,IAAI,GAAGA;QACZ,IAAI,CAACC,QAAQ,GAAGA;QAChB,IAAI,CAACC,IAAI,GAAGM,SAASN,QAAQ,GAAGF,KAAK,MAAM,CAAC;QAC5C,IAAI,CAACM,aAAa,GAAGE,SAASF;QAC9B,IAAI,CAACF,OAAO,GAAGI,SAASJ;QACxB,IAAI,CAACD,WAAW,GAAGK,SAASL,eAAe;QAE3C,YAAY;QACZ,IAAIP,MAAMa,iBAAiB,EAAE;YAC3Bb,MAAMa,iBAAiB,CAAC,IAAI,EAAEtB;QAChC;IACF;AAwBF;AAKO,IAAA,AAAMC,sBAAN,MAAMA,4BAA4BD;IACvC,YACEY,OAAe,EACfO,aAAqB,EACrBF,OAAiC,EACjCM,SAAqB,CACrB;QACA,MAAMR,OAAOQ,aAAa3B,qBAAS,CAAC4B,qBAAqB;QACzD,KAAK,CAAChB,IAAAA,kCAAsB,EAACO,MAAMH,wCAA4D;YAC7FG,MAAMnB,qBAAS,CAACmB,KAAK;YACrBI;YACAF;YACAD,aAAa;QACf;QACA,IAAI,CAACL,IAAI,GAAG;IACd;AACF;AAKO,IAAA,AAAMhB,cAAN,MAAMA,oBAAoBK;IAC/B,YACEY,OAAe,EACfO,aAAqB,EACrBF,OAAiC,EACjCM,SAAqB,CACrB;QACA,MAAMR,OAAOQ,aAAa3B,qBAAS,CAAC6B,kBAAkB;QACtD,KAAK,CAACjB,IAAAA,kCAAsB,EAACO,MAAMH,4BAAgD;YACjFG,MAAMnB,qBAAS,CAACmB,KAAK;YACrBI;YACAF;YACAD,aAAa;QACf;QACA,IAAI,CAACL,IAAI,GAAG;IACd;AACF;AAKO,IAAA,AAAMP,eAAN,MAAMA,qBAAqBJ;IAChC,YAAYY,OAAe,EAAEO,aAAqB,EAAEF,OAAiC,CAAE;QACrF,KAAK,CAACL,8BAAkD;YACtDG,MAAM;YACNI;YACAF;YACAD,aAAa;QACf;QACA,IAAI,CAACL,IAAI,GAAG;IACd;AACF;AAKO,IAAA,AAAMT,eAAN,MAAMA,qBAAqBF;IAChC,YACEY,OAAe,EACfO,aAAqB,EACrBF,OAAiC,EACjCM,SAAqB,CACrB;QACA,MAAMR,OAAOQ,aAAa3B,qBAAS,CAAC8B,aAAa;QACjD,KAAK,CAAClB,IAAAA,kCAAsB,EAACO,MAAMH,+BAAmD;YACpFG,MAAMnB,qBAAS,CAACmB,KAAK;YACrBI;YACAF;YACAD,aAAa;QACf;QACA,IAAI,CAACL,IAAI,GAAG;IACd;AACF;AAKO,IAAA,AAAMN,kBAAN,MAAMA,wBAAwBL;IACnC,YAAYY,OAAe,EAAEK,OAAiC,CAAE;QAC9D,KAAK,CAACL,8BAAkD;YACtDG,MAAM;YACNE;YACAD,aAAa;QACf;QACA,IAAI,CAACL,IAAI,GAAG;IACd;AACF;AAKO,IAAA,AAAMR,gBAAN,MAAMA,sBAAsBH;IACjC,YAAYY,OAAe,EAAEO,aAAqB,EAAEF,OAAiC,CAAE;QACrF,KAAK,CAACL,6BAAiD;YACrDG,MAAM;YACNI;YACAF;YACAD,aAAa;QACf;QACA,IAAI,CAACL,IAAI,GAAG;IACd;AACF;AAKO,MAAML,aAAa;IACxB;;GAEC,GACDqB,eAAcC,KAAc;QAC1B,IAAIA,iBAAiB5B,gBAAgB;YACnC,OAAO4B,MAAMZ,WAAW;QAC1B;QACA,OAAO;IACT;IAEA;;GAEC,GACDa,cAAaD,KAAc;QACzB,IAAIA,iBAAiB5B,gBAAgB;YACnC,OAAO4B,MAAMf,IAAI;QACnB;QACA;IACF;IAEA;;GAEC,GACDiB,kBAAiBF,KAAc;QAC7B,IAAIA,iBAAiB5B,gBAAgB;YACnC,OAAO4B,MAAMd,QAAQ;QACvB;QACA;IACF;IAEA;;GAEC,GACDiB,gBAAeH,KAAc;QAC3B,IAAIA,iBAAiB5B,gBAAgB;YACnC,OAAO4B;QACT;QAEA,IAAIA,iBAAiBnB,OAAO;YAC1B,OAAO,IAAIT,eAAe4B,MAAMhB,OAAO,uBAA2C;gBAChFO,eAAeS;YACjB;QACF;QAEA,OAAO,IAAI5B,eAAegC,OAAOJ;IACnC;IAEA;;GAEC,GACDK,kBAAiBL,KAAc;QAO7B,MAAMM,aAAa5B,WAAWyB,cAAc,CAACH;QAC7C,OAAO;YACLhB,SAASsB,WAAWtB,OAAO;YAC3BC,MAAMqB,WAAWrB,IAAI;YACrBC,UAAUoB,WAAWpB,QAAQ;YAC7BC,MAAMmB,WAAWnB,IAAI;YACrBG,OAAOgB,WAAWhB,KAAK;QACzB;IACF;IAEA;;;;GAIC,GACDiB,qBAAoBP,KAAc;QAChC,MAAMM,aAAa5B,WAAWyB,cAAc,CAACH;QAC7C,MAAMQ,cAAwB,EAAE;QAEhC,aAAa;QACb,OAAQF,WAAWnB,IAAI;YACrB,KAAK;gBACHqB,YAAYC,IAAI,CAAC;gBACjBD,YAAYC,IAAI,CAAC;gBACjB;YACF,KAAK;gBACHD,YAAYC,IAAI,CAAC;gBACjBD,YAAYC,IAAI,CAAC;gBACjBD,YAAYC,IAAI,CAAC;gBACjB;YACF,KAAK;gBACHD,YAAYC,IAAI,CAAC;gBACjBD,YAAYC,IAAI,CAAC;gBACjBD,YAAYC,IAAI,CAAC;gBACjB;YACF,KAAK;gBACHD,YAAYC,IAAI,CAAC;gBACjBD,YAAYC,IAAI,CAAC;gBACjBD,YAAYC,IAAI,CAAC;gBACjB;YACF,KAAK;gBACHD,YAAYC,IAAI,CAAC;gBACjBD,YAAYC,IAAI,CAAC;gBACjBD,YAAYC,IAAI,CAAC;gBACjB;YACF;gBACE,IAAIH,WAAWrB,IAAI,iBAAyB;oBAC1CuB,YAAYC,IAAI,CAAC;oBACjBD,YAAYC,IAAI,CAAC;oBACjBD,YAAYC,IAAI,CAAC;gBACnB;QACJ;QAEA,mBAAmB;QACnB,IAAIH,WAAWlB,WAAW,EAAE;YAC1BoB,YAAYC,IAAI,CAAC;QACnB;QAEA,OAAOD;IACT;IAEA;;;;GAIC,GACDE,mBAAkBV,KAAc;QAC9B,MAAMM,aAAa5B,WAAWyB,cAAc,CAACH;QAC7C,MAAMQ,cAAc9B,WAAW6B,mBAAmB,CAACP;QAEnD,IAAIhB,UAAU,CAAC,CAAC,EAAEsB,WAAWnB,IAAI,CAAC,EAAE,EAAEmB,WAAWtB,OAAO,EAAE;QAE1D,IAAIsB,WAAWhB,KAAK,EAAE;YACpBN,WAAW,CAAC,WAAW,EAAEsB,WAAWhB,KAAK,EAAE;QAC7C;QAEA,IAAIkB,YAAYG,MAAM,GAAG,GAAG;YAC1B3B,WAAW,CAAC,WAAW,EAAEwB,YAAYI,GAAG,CAAC,CAACC,GAAGC,IAAM,GAAGA,IAAI,EAAE,EAAE,EAAED,GAAG,EAAEE,IAAI,CAAC,OAAO;QACnF;QAEA,IAAIT,WAAWjB,OAAO,EAAE;YACtBL,WAAW,CAAC,YAAY,EAAEgC,KAAKC,SAAS,CAACX,WAAWjB,OAAO,EAAE,MAAM,IAAI;QACzE;QAEA,OAAOL;IACT;AACF"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,179 @@
+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>);
+}
+/**
+ * 错误处理工具函数
+ */
+export declare const errorUtils: {
+    /**
+     * 判断错误是否可恢复
+     */
+    isRecoverable(error: unknown): boolean;
+    /**
+     * 获取错误类型
+     */
+    getErrorType(error: unknown): ErrorType;
+    /**
+     * 获取错误严重程度
+     */
+    getErrorSeverity(error: unknown): ErrorSeverity;
+    /**
+     * 标准化错误对象
+     */
+    normalizeError(error: unknown): FrameworkError;
+    /**
+     * 提取错误信息
+     */
+    extractErrorInfo(error: unknown): {
+        message: string;
+        type: ErrorType;
+        severity: ErrorSeverity;
+        code: string;
+        stack?: string;
+    };
+    /**
+     * 获取错误修复建议
+     *
+     * 优化：根据错误类型和代码提供修复建议
+     */
+    getErrorSuggestions(error: unknown): string[];
+    /**
+     * 格式化错误信息（用于开发环境）
+     *
+     * 优化：提供更详细的错误信息，包括修复建议
+     */
+    formatErrorForDev(error: unknown): string;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}