paul-ai-assistant 1.0.2 → 1.0.4

package/es/utils/websocketLogger.d.ts

@@ -1,176 +0,0 @@
-/**
- * WebSocket 日志管理器
- *
- * 提供统一的日志输出接口，支持：
- * - 日志分级（info/warn/error/debug）
- * - 环境区分（开发/生产）
- * - 调试模式控制
- * - 时间戳和格式化
- *
- * @example
- * ```typescript
- * import { logger } from '@/utils/websocketLogger';
- *
- * logger.info('连接成功', { bizId: 'xxx' });
- * logger.warn('连接超时');
- * logger.error('连接失败', error);
- *
- * // 启用调试模式
- * localStorage.setItem('ws_debug', 'true');
- * logger.debug('调试信息', data);
- * ```
- */
-export declare class WebSocketLogger {
-    private prefix;
-    private isDev;
-    /**
-     * 构造函数
-     * @param prefix 日志前缀，默认为 '[WebSocket]'
-     */
-    constructor(prefix?: string);
-    /**
-     * 获取带格式的时间戳
-     * @returns ISO 格式的时间戳字符串
-     */
-    private getTimestamp;
-    /**
-     * 构建完整的日志消息
-     * @param level 日志级别
-     * @param message 日志消息
-     * @returns 格式化的日志消息
-     */
-    private buildMessage;
-    /**
-     * 信息日志（仅在开发环境输出）
-     *
-     * 用于记录一般性信息，如连接成功、参数变化等
-     *
-     * @param message 日志消息
-     * @param data 附加数据（可选）
-     *
-     * @example
-     * ```typescript
-     * logger.info('连接成功', { bizId: 'xxx', reconnectCount: 0 });
-     * logger.info('连接参数未变化，跳过重复建连');
-     * ```
-     */
-    info(message: string, data?: any): void;
-    /**
-     * 警告日志（所有环境都输出）
-     *
-     * 用于记录需要注意但不影响功能的问题，如重连尝试、超时等
-     *
-     * @param message 日志消息
-     * @param data 附加数据（可选）
-     *
-     * @example
-     * ```typescript
-     * logger.warn('正在重连', { reconnectCount: 5, maxCount: 50 });
-     * logger.warn('重连次数已达 30 次，请检查网络连接');
-     * ```
-     */
-    warn(message: string, data?: any): void;
-    /**
-     * 错误日志（所有环境都输出）
-     *
-     * 用于记录错误和异常情况
-     *
-     * @param message 日志消息
-     * @param error 错误对象或附加数据（可选）
-     *
-     * @example
-     * ```typescript
-     * logger.error('连接失败', error);
-     * logger.error('重连次数超过上限，停止重连', { reconnectCount: 50 });
-     * ```
-     */
-    error(message: string, error?: any): void;
-    /**
-     * 调试日志（需要显式启用）
-     *
-     * 仅在开发环境且 URL 包含 ws_debug=true 参数时输出
-     * 用于详细的调试信息，不会在正常开发时打印
-     *
-     * @param message 日志消息
-     * @param data 附加数据（可选）
-     *
-     * @example
-     * ```typescript
-     * // 启用调试模式：在 URL 中添加参数
-     * // https://example.com/page?ws_debug=true
-     *
-     * // 打印调试信息
-     * logger.debug('获取连接状态', { status: 'connected', hasInstance: true });
-     * logger.debug('消息详情', msgBody);
-     * ```
-     */
-    debug(message: string, data?: any): void;
-    /**
-     * 检查是否启用了调试模式
-     * 通过 URL 参数 ws_debug=true 来启用
-     * @returns 是否启用调试
-     */
-    private isDebugEnabled;
-    /**
-     * 设置日志前缀
-     * @param prefix 新的前缀
-     */
-    setPrefix(prefix: string): void;
-    /**
-     * 获取当前日志前缀
-     * @returns 当前前缀
-     */
-    getPrefix(): string;
-    /**
-     * 检查当前是否处于调试模式
-     * @returns 是否启用调试
-     *
-     * @example
-     * ```typescript
-     * if (logger.isDebugMode()) {
-     *   console.log('当前处于调试模式');
-     * }
-     * ```
-     */
-    isDebugMode(): boolean;
-    /**
-     * 获取启用调试模式的 URL
-     * @returns 带有 ws_debug=true 参数的 URL
-     *
-     * @example
-     * ```typescript
-     * console.log('调试模式 URL:', logger.getDebugUrl());
-     * // 输出: https://example.com/page?ws_debug=true
-     * ```
-     */
-    getDebugUrl(): string;
-}
-/**
- * 默认的 WebSocket 日志实例
- *
- * @example
- * ```typescript
- * import { logger } from '@/utils/websocketLogger';
- *
- * logger.info('连接成功');
- * logger.warn('正在重连');
- * logger.error('连接失败', error);
- * ```
- */
-export declare const logger: WebSocketLogger;
-/**
- * 创建自定义前缀的日志实例
- *
- * @param prefix 日志前缀
- * @returns 新的日志实例
- *
- * @example
- * ```typescript
- * import { createLogger } from '@/utils/websocketLogger';
- *
- * const customLogger = createLogger('[MyModule]');
- * customLogger.info('自定义模块日志');
- * ```
- */
-export declare const createLogger: (prefix: string) => WebSocketLogger;
-export default logger;