/**
 * 统一错误处理工具函数
 *
 * Phase 7+ 优化：合并相似的 catch 空块为统一错误处理
 * 提供一致的错误处理模式，减少代码重复
 */
export type ErrorSeverity = 'log' | 'warn' | 'error' | 'silent';
export interface ErrorHandlerOptions {
    /** 错误严重程度 */
    severity?: ErrorSeverity;
    /** 是否重新抛出错误 */
    rethrow?: boolean;
    /** 默认错误消息 */
    defaultMessage?: string;
    /** 错误上下文信息 */
    context?: Record<string, unknown>;
}
/**
 * 处理异步操作中的错误
 *
 * @param error - 捕获的错误
 * @param options - 错误处理选项
 * @returns 处理后的错误（如果 rethrow 为 true）
 */
export declare function handleError(error: unknown, options?: ErrorHandlerOptions): Error | undefined;
/**
 * 创建错误处理包装器，用于 Promise.catch()
 *
 * @param options - 错误处理选项
 * @returns Promise 错误处理函数
 */
export declare function createErrorHandler(options?: ErrorHandlerOptions): (error: unknown) => Promise<void>;
/**
 * 静默处理错误（不记录日志）
 *
 * @param error - 捕获的错误
 * @returns 标准化的错误对象
 */
export declare function silentHandle(error: unknown): Error;
/**
 * 标准化错误对象
 *
 * @param error - 原始错误
 * @param defaultMessage - 默认错误消息
 * @returns 标准化的 Error 对象
 */
export declare function normalizeError(error: unknown, defaultMessage?: string): Error;
/**
 * 处理连接相关的错误
 */
export declare function handleConnectionError(error: unknown, deviceId?: string): Error;
/**
 * 处理打印相关的错误
 */
export declare function handlePrintError(error: unknown, jobId?: string): Error;
/**
 * 处理队列相关的错误
 */
export declare function handleQueueError(error: unknown, queueName?: string): Error;
/**
 * 处理缓存相关的错误
 */
export declare function handleCacheError(error: unknown, cacheName?: string): Error;
/**
 * 用于替换空 catch 块的辅助函数
 * 用法：.catch(silentHandle)
 */
export declare const silentCatch: typeof silentHandle;
/**
 * 用于替换带注释的 catch 块的辅助函数
 * 用法：.catch(createErrorHandler({ severity: 'log' }))
 */
export declare const logCatch: (error: unknown) => Promise<void>;
/**
 * 用于替换带注释的 catch 块的辅助函数
 * 用法：.catch(createErrorHandler({ severity: 'warn' }))
 */
export declare const warnCatch: (error: unknown) => Promise<void>;