@vlian/framework 1.2.56 → 1.2.59

package/dist/core/error/ErrorHandler.js

@@ -1,261 +1 @@
-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;
-}
-/**
- * 统一错误处理器
- * 
- * 优化：
- * 1. 统一错误处理策略：记录、上报、恢复、降级
- * 2. 错误分类：致命、可恢复、警告
- * 3. 错误恢复机制：自动重试、降级方案
- */ import { logger } from "@vlian/logger";
-import { errorUtils, ErrorSeverity, FrameworkError } from "@vlian/utils";
-/**
- * 错误处理策略
- */ export var ErrorHandlingStrategy = /*#__PURE__*/ function(ErrorHandlingStrategy) {
-    /**
-   * 记录错误（日志）
-   */ ErrorHandlingStrategy["LOG"] = "LOG";
-    /**
-   * 上报错误（监控服务）
-   */ ErrorHandlingStrategy["REPORT"] = "REPORT";
-    /**
-   * 尝试恢复错误
-   */ ErrorHandlingStrategy["RECOVER"] = "RECOVER";
-    /**
-   * 降级处理
-   */ ErrorHandlingStrategy["FALLBACK"] = "FALLBACK";
-    /**
-   * 忽略错误
-   */ ErrorHandlingStrategy["IGNORE"] = "IGNORE";
-    return ErrorHandlingStrategy;
-}({});
-/**
- * 统一错误处理器
- */ export class ErrorHandler {
-    /**
-   * 设置监控服务
-   */ setMonitoring(monitoring) {
-        this.monitoring = monitoring;
-    }
-    /**
-   * 处理错误
-   * 
-   * @param error - 错误对象
-   * @param context - 错误上下文
-   * @returns 错误处理结果
-   */ async handleError(error, context) {
-        // 标准化错误对象
-        const normalizedError = errorUtils.normalizeError(error);
-        // 创建包含上下文信息的错误对象（由于 context 是只读的，需要创建新对象）
-        const errorWithContext = context ? new FrameworkError(normalizedError.message, normalizedError.type, normalizedError.severity, {
-            code: normalizedError.code,
-            originalError: normalizedError.originalError,
-            context: {
-                ...normalizedError.context,
-                ...context
-            },
-            recoverable: normalizedError.recoverable
-        }) : normalizedError;
-        // 确定处理策略
-        const strategies = this.determineStrategies(errorWithContext);
-        // 执行处理策略
-        const handled = await this.executeStrategies(errorWithContext, strategies);
-        // 尝试恢复错误
-        let recoveredValue;
-        let recoverable = false;
-        if (handled && errorWithContext.recoverable && this.config.recoveryOptions) {
-            const recoveryResult = await this.attemptRecovery(errorWithContext);
-            recoverable = recoveryResult.recoverable;
-            recoveredValue = recoveryResult.value;
-        }
-        return {
-            handled,
-            recoverable,
-            recoveredValue,
-            strategies,
-            error: errorWithContext
-        };
-    }
-    /**
-   * 确定错误处理策略
-   */ determineStrategies(error) {
-        // 1. 检查错误类型对应的策略
-        if (this.config.typeStrategies[error.type]) {
-            return this.config.typeStrategies[error.type];
-        }
-        // 2. 检查错误严重程度对应的策略
-        if (this.config.severityStrategies[error.severity]) {
-            return this.config.severityStrategies[error.severity];
-        }
-        // 3. 使用默认策略
-        return this.config.defaultStrategies;
-    }
-    /**
-   * 执行处理策略
-   */ async executeStrategies(error, strategies) {
-        let handled = false;
-        for (const strategy of strategies){
-            try {
-                switch(strategy){
-                    case "LOG":
-                        this.logError(error);
-                        handled = true;
-                        break;
-                    case "REPORT":
-                        await this.reportError(error);
-                        handled = true;
-                        break;
-                    case "RECOVER":
-                        // 恢复策略在 handleError 中统一处理
-                        handled = true;
-                        break;
-                    case "FALLBACK":
-                        // 降级策略在 attemptRecovery 中处理
-                        handled = true;
-                        break;
-                    case "IGNORE":
-                        // 忽略错误，不做任何处理
-                        handled = true;
-                        break;
-                }
-            } catch (strategyError) {
-                logger.warn(`错误处理策略 ${strategy} 执行失败:`, strategyError);
-            }
-        }
-        return handled;
-    }
-    /**
-   * 记录错误
-   */ logError(error) {
-        const errorInfo = errorUtils.extractErrorInfo(error);
-        // 根据错误严重程度选择日志级别
-        switch(error.severity){
-            case ErrorSeverity.CRITICAL:
-            case ErrorSeverity.HIGH:
-                logger.error('错误:', errorInfo);
-                break;
-            case ErrorSeverity.MEDIUM:
-                logger.warn('警告:', errorInfo);
-                break;
-            case ErrorSeverity.LOW:
-                logger.info('信息:', errorInfo);
-                break;
-        }
-        // 开发环境显示详细错误信息
-        if (this.config.showDetailedErrorsInDev && process.env.NODE_ENV === 'development') {
-            const detailedError = errorUtils.formatErrorForDev(error);
-            console.error(detailedError);
-        }
-    }
-    /**
-   * 上报错误
-   */ async reportError(error) {
-        if (!this.monitoring) {
-            logger.debug('监控服务未配置，跳过错误上报');
-            return;
-        }
-        try {
-            this.monitoring.captureError(error, {
-                severity: error.severity,
-                type: error.type,
-                code: error.code,
-                context: error.context
-            });
-        } catch (reportError) {
-            logger.warn('错误上报失败:', reportError);
-        }
-    }
-    /**
-   * 尝试恢复错误
-   */ async attemptRecovery(error) {
-        const options = this.config.recoveryOptions;
-        if (!options) {
-            return {
-                recoverable: false
-            };
-        }
-        const maxRetries = options.maxRetries ?? 3;
-        const retryDelay = options.retryDelay ?? 1000;
-        const exponentialBackoff = options.exponentialBackoff ?? true;
-        const shouldRetry = options.shouldRetry ?? (()=>true);
-        // 如果有降级方案，先尝试降级
-        if (options.fallback) {
-            try {
-                const fallbackValue = await Promise.resolve(options.fallback());
-                logger.info('错误已通过降级方案恢复');
-                return {
-                    recoverable: true,
-                    value: fallbackValue
-                };
-            } catch (fallbackError) {
-                logger.warn('降级方案执行失败:', fallbackError);
-            }
-        }
-        // 尝试重试（如果错误可恢复且满足重试条件）
-        if (error.recoverable && shouldRetry(error, 0)) {
-            for(let attempt = 0; attempt < maxRetries; attempt++){
-                if (!shouldRetry(error, attempt)) {
-                    break;
-                }
-                const delay = exponentialBackoff ? retryDelay * Math.pow(2, attempt) : retryDelay;
-                logger.debug(`错误恢复重试 ${attempt + 1}/${maxRetries}，${delay}ms 后重试...`);
-                await new Promise((resolve)=>setTimeout(resolve, delay));
-            // 这里应该调用原始操作的重试逻辑
-            // 由于错误处理器不知道原始操作，这里只返回可恢复状态
-            // 实际的重试应该在调用方实现
-            }
-        }
-        return {
-            recoverable: error.recoverable
-        };
-    }
-    /**
-   * 创建错误处理器的便捷方法
-   */ static create(config) {
-        return new ErrorHandler(config);
-    }
-    constructor(config = {}){
-        _define_property(this, "config", void 0);
-        _define_property(this, "monitoring", void 0);
-        this.monitoring = config.monitoring;
-        this.config = {
-            defaultStrategies: config.defaultStrategies ?? [
-                "LOG",
-                "REPORT"
-            ],
-            severityStrategies: config.severityStrategies ?? {},
-            typeStrategies: config.typeStrategies ?? {},
-            recoveryOptions: config.recoveryOptions ?? {},
-            showDetailedErrorsInDev: config.showDetailedErrorsInDev ?? true
-        };
-    }
-}
-/**
- * 默认错误处理器实例（单例）
- */ let defaultErrorHandler = null;
-/**
- * 获取默认错误处理器
- */ export function getDefaultErrorHandler() {
-    if (!defaultErrorHandler) {
-        defaultErrorHandler = new ErrorHandler();
-    }
-    return defaultErrorHandler;
-}
-/**
- * 设置默认错误处理器
- */ export function setDefaultErrorHandler(handler) {
-    defaultErrorHandler = handler;
-}
-
-//# sourceMappingURL=ErrorHandler.js.map
+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}import{logger}from"@vlian/logger";import{errorUtils,ErrorSeverity,FrameworkError}from"@vlian/utils";export var ErrorHandlingStrategy=/*#__PURE__*/function(ErrorHandlingStrategy){ErrorHandlingStrategy["LOG"]="LOG";ErrorHandlingStrategy["REPORT"]="REPORT";ErrorHandlingStrategy["RECOVER"]="RECOVER";ErrorHandlingStrategy["FALLBACK"]="FALLBACK";ErrorHandlingStrategy["IGNORE"]="IGNORE";return ErrorHandlingStrategy}({});export class ErrorHandler{setMonitoring(monitoring){this.monitoring=monitoring}async handleError(error,context){const normalizedError=errorUtils.normalizeError(error);const errorWithContext=context?new FrameworkError(normalizedError.message,normalizedError.type,normalizedError.severity,{code:normalizedError.code,originalError:normalizedError.originalError,context:{...normalizedError.context,...context},recoverable:normalizedError.recoverable}):normalizedError;const strategies=this.determineStrategies(errorWithContext);const handled=await this.executeStrategies(errorWithContext,strategies);let recoveredValue;let recoverable=false;if(handled&&errorWithContext.recoverable&&this.config.recoveryOptions){const recoveryResult=await this.attemptRecovery(errorWithContext);recoverable=recoveryResult.recoverable;recoveredValue=recoveryResult.value}return{handled,recoverable,recoveredValue,strategies,error:errorWithContext}}determineStrategies(error){if(this.config.typeStrategies[error.type]){return this.config.typeStrategies[error.type]}if(this.config.severityStrategies[error.severity]){return this.config.severityStrategies[error.severity]}return this.config.defaultStrategies}async executeStrategies(error,strategies){let handled=false;for(const strategy of strategies){try{switch(strategy){case"LOG":this.logError(error);handled=true;break;case"REPORT":await this.reportError(error);handled=true;break;case"RECOVER":handled=true;break;case"FALLBACK":handled=true;break;case"IGNORE":handled=true;break}}catch(strategyError){logger.warn(`错误处理策略 ${strategy} 执行失败:`,strategyError)}}return handled}logError(error){const errorInfo=errorUtils.extractErrorInfo(error);switch(error.severity){case ErrorSeverity.CRITICAL:case ErrorSeverity.HIGH:logger.error("错误:",errorInfo);break;case ErrorSeverity.MEDIUM:logger.warn("警告:",errorInfo);break;case ErrorSeverity.LOW:logger.info("信息:",errorInfo);break}if(this.config.showDetailedErrorsInDev&&process.env.NODE_ENV==="development"){const detailedError=errorUtils.formatErrorForDev(error);console.error(detailedError)}}async reportError(error){if(!this.monitoring){logger.debug("监控服务未配置，跳过错误上报");return}try{this.monitoring.captureError(error,{severity:error.severity,type:error.type,code:error.code,context:error.context})}catch(reportError){logger.warn("错误上报失败:",reportError)}}async attemptRecovery(error){const options=this.config.recoveryOptions;if(!options){return{recoverable:false}}const maxRetries=options.maxRetries??3;const retryDelay=options.retryDelay??1e3;const exponentialBackoff=options.exponentialBackoff??true;const shouldRetry=options.shouldRetry??(()=>true);if(options.fallback){try{const fallbackValue=await Promise.resolve(options.fallback());logger.info("错误已通过降级方案恢复");return{recoverable:true,value:fallbackValue}}catch(fallbackError){logger.warn("降级方案执行失败:",fallbackError)}}if(error.recoverable&&shouldRetry(error,0)){for(let attempt=0;attempt<maxRetries;attempt++){if(!shouldRetry(error,attempt)){break}const delay=exponentialBackoff?retryDelay*Math.pow(2,attempt):retryDelay;logger.debug(`错误恢复重试 ${attempt+1}/${maxRetries}，${delay}ms 后重试...`);await new Promise(resolve=>setTimeout(resolve,delay))}}return{recoverable:error.recoverable}}static create(config){return new ErrorHandler(config)}constructor(config={}){_define_property(this,"config",void 0);_define_property(this,"monitoring",void 0);this.monitoring=config.monitoring;this.config={defaultStrategies:config.defaultStrategies??["LOG","REPORT"],severityStrategies:config.severityStrategies??{},typeStrategies:config.typeStrategies??{},recoveryOptions:config.recoveryOptions??{},showDetailedErrorsInDev:config.showDetailedErrorsInDev??true}}}let defaultErrorHandler=null;export function getDefaultErrorHandler(){if(!defaultErrorHandler){defaultErrorHandler=new ErrorHandler}return defaultErrorHandler}export function setDefaultErrorHandler(handler){defaultErrorHandler=handler}

package/dist/core/error/index.cjs

@@ -32,5 +32,3 @@ _export(exports, {
 });
 const _ErrorBoundary = require("./ErrorBoundary");
 const _ErrorHandler = require("./ErrorHandler");
-
-//# sourceMappingURL=index.js.map

package/dist/core/error/index.js

@@ -1,6 +1 @@
-/**
- * 错误处理模块统一导出
- */ export { ErrorBoundary, withErrorBoundary, useErrorHandler } from "./ErrorBoundary";
-export { ErrorHandler, getDefaultErrorHandler, setDefaultErrorHandler } from "./ErrorHandler";
-
-//# sourceMappingURL=index.js.map
+export{ErrorBoundary,withErrorBoundary,useErrorHandler}from"./ErrorBoundary";export{ErrorHandler,getDefaultErrorHandler,setDefaultErrorHandler}from"./ErrorHandler";

package/dist/core/event/AppEventBus.cjs

@@ -442,5 +442,3 @@ let AppEventBus = class AppEventBus {
         };
     }
 };
-
-//# sourceMappingURL=AppEventBus.js.map