a2bei4-utils 1.0.0 → 1.0.1

package/dist/webSocket.js

@@ -0,0 +1,407 @@
+/**
+ * @class WebSocketManager - 一个功能强大、高度可定制的 WebSocket 助手类
+ *
+ * @features
+ * - 智能断线重连 (指数退避算法)
+ * - 网络状态监听
+ * - 高度可定制的心跳保活机制 (通过注入函数实现)
+ * - 页面可见性 API 集成
+ * - 消息发送队列
+ * - 事件驱动的消息分发
+ * - 清晰的生命周期管理
+ * - 优雅的资源销毁
+ * - 可配置的数据序列化/反序列化
+ */
+class WebSocketManager {
+    /**
+     * @param {string} url - WebSocket 服务器的地址
+     * @param {object} [options={}] - 配置选项
+     * @param {number} [options.heartbeatInterval=30000] - 心跳间隔 (毫秒)
+     * @param {number} [options.heartbeatTimeout=10000] - 心跳超时时间 (毫秒)
+     * @param {number} [options.reconnectBaseInterval=1000] - 重连基础间隔 (毫秒)
+     * @param {number} [options.maxReconnectInterval=30000] - 最大重连间隔 (毫秒)
+     * @param {number} [options.maxReconnectAttempts=Infinity] - 最大重连次数
+     * @param {boolean} [options.autoConnect=true] - 是否在实例化后自动连接
+     * @param {boolean} [options.serializeData=false] - 发送数据时是否自动序列化为JSON字符串
+     * @param {boolean} [options.deserializeData=false] - 接收数据时是否自动反序列化为JSON对象
+     * @param {function|null} [options.getPingMessage=null] - 返回要发送的 ping 消息内容的函数。如果为 null，则不发送心跳。
+     * @param {function|null} [options.isPongMessage=null] - 判断接收到的消息是否为 pong 的函数。接收 MessageEvent 对象作为参数，返回布尔值。
+     * @param {object} [options.protocols] - WebSocket 协议
+     */
+    constructor(url, options = {}) {
+        this.url = url;
+
+        // 默认的心跳实现，用于向后兼容
+        const defaultGetPingMessage = () => JSON.stringify({ type: "ping" });
+        const defaultIsPongMessage = (event) => {
+            try {
+                const message = JSON.parse(event.data);
+                return message.type === "pong";
+            } catch (e) {
+                return false;
+            }
+        };
+
+        this.options = {
+            heartbeatInterval: 30000,
+            heartbeatTimeout: 10000,
+            reconnectBaseInterval: 1000,
+            maxReconnectInterval: 30000,
+            maxReconnectAttempts: Infinity,
+            autoConnect: true,
+            serializeData: false,
+            deserializeData: false,
+            getPingMessage: defaultGetPingMessage, // 默认提供 ping 消息生成器
+            isPongMessage: defaultIsPongMessage, // 默认提供 pong 消息判断器
+            ...options
+        };
+
+        // WebSocket 实例
+        this.ws = null;
+
+        // 状态管理
+        this.readyState = WebSocket.CLOSED;
+        this.reconnectAttempts = 0;
+        this.forcedClose = false;
+        this.isReconnecting = false;
+
+        // 定时器
+        this.heartbeatTimer = null;
+        this.heartbeatTimeoutTimer = null;
+        this.reconnectTimer = null;
+
+        // 消息队列
+        this.messageQueue = [];
+
+        // 事件监听器
+        this.listeners = new Map();
+
+        // 绑定方法上下文
+        this._onOpen = this._onOpen.bind(this);
+        this._onMessage = this._onMessage.bind(this);
+        this._onClose = this._onClose.bind(this);
+        this._onError = this._onError.bind(this);
+        this._handleVisibilityChange = this._handleVisibilityChange.bind(this);
+        this._handleOnline = this._handleOnline.bind(this);
+        this._handleOffline = this._handleOffline.bind(this);
+
+        this._setupEventListeners();
+
+        if (this.options.autoConnect) {
+            this.connect();
+        }
+    }
+
+    // --- 公共 API ---
+
+    /**
+     * 连接到 WebSocket 服务器
+     */
+    connect() {
+        if (this.ws && (this.ws.readyState === WebSocket.CONNECTING || this.ws.readyState === WebSocket.OPEN)) {
+            return;
+        }
+
+        this.forcedClose = false;
+        this._updateReadyState(WebSocket.CONNECTING);
+        console.log(`[WS] 正在连接到 ${this.url}...`);
+        this._emit("connecting");
+
+        try {
+            this.ws = new WebSocket(this.url, this.options.protocols);
+            this.ws.onopen = this._onOpen;
+            this.ws.onmessage = this._onMessage;
+            this.ws.onclose = this._onClose;
+            this.ws.onerror = this._onError;
+        } catch (error) {
+            console.error("[WS] 连接失败:", error);
+            this._onError(error);
+        }
+    }
+
+    /**
+     * 发送数据
+     * @param {string|object|ArrayBuffer|Blob} data - 要发送的数据
+     */
+    send(data) {
+        if (this.readyState === WebSocket.OPEN) {
+            let message;
+            // 根据配置决定是否序列化数据
+            if (this.options.serializeData) {
+                message = JSON.stringify(data);
+            } else {
+                message = data;
+            }
+            this.ws.send(message);
+            console.log("[WS] 消息已发送:", message);
+        } else {
+            console.warn("[WS] 连接未打开，消息已加入队列:", data);
+            this.messageQueue.push(data);
+        }
+    }
+
+    /**
+     * 主动关闭连接
+     * @param {number} [code=1000] - 关闭代码
+     * @param {string} [reason=''] - 关闭原因
+     */
+    close(code = 1000, reason = "Normal closure") {
+        this.forcedClose = true;
+        this._stopHeartbeat();
+        this._clearReconnectTimer();
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.close(code, reason);
+        } else {
+            this._updateReadyState(WebSocket.CLOSED);
+            this._emit("close", { code, reason, wasClean: true });
+        }
+    }
+
+    /**
+     * 彻底销毁实例，清理所有资源
+     */
+    destroy() {
+        console.log("[WS] 正在销毁实例...");
+        this.close(1000, "Instance destroyed");
+        this._removeEventListeners();
+        this.messageQueue = [];
+        this.listeners.clear();
+        this.ws = null;
+    }
+
+    /**
+     * 添加事件监听器
+     * @param {string} eventName - 事件名 (e.g., 'open', 'message', 'close', 'error', 'reconnect')
+     * @param {function} callback - 回调函数
+     */
+    on(eventName, callback) {
+        if (!this.listeners.has(eventName)) {
+            this.listeners.set(eventName, []);
+        }
+        this.listeners.get(eventName).push(callback);
+    }
+
+    /**
+     * 移除事件监听器
+     * @param {string} eventName - 事件名
+     * @param {function} callback - 回调函数
+     */
+    off(eventName, callback) {
+        if (this.listeners.has(eventName)) {
+            const callbacks = this.listeners.get(eventName);
+            const index = callbacks.indexOf(callback);
+            if (index > -1) {
+                callbacks.splice(index, 1);
+            }
+        }
+    }
+
+    // --- 内部方法 ---
+
+    _onOpen(event) {
+        console.log("[WS] 连接已建立");
+        this._updateReadyState(WebSocket.OPEN);
+        this.reconnectAttempts = 0;
+        this.isReconnecting = false;
+
+        // 如果配置了 getPingMessage，则启动心跳
+        if (this.options.getPingMessage) {
+            this._startHeartbeat();
+        }
+
+        this._flushMessageQueue();
+        this._emit("open", event);
+    }
+
+    /**
+     * 优化后的消息处理方法，使用注入的函数来判断心跳
+     * @param {MessageEvent} event
+     */
+    _onMessage(event) {
+        // --- 步骤 1: 使用注入的函数优先处理内部心跳机制 ---
+        if (this.options.isPongMessage && this.options.isPongMessage(event)) {
+            this._handlePong();
+            return; // 是心跳消息，处理完毕，直接返回
+        }
+
+        // --- 步骤 2: 根据用户配置处理业务消息 ---
+        if (this.options.deserializeData) {
+            try {
+                const parsedMessage = JSON.parse(event.data);
+                this._emit("message", parsedMessage);
+            } catch (e) {
+                this._emit("message", event.data);
+            }
+        } else {
+            this._emit("message", event.data);
+        }
+    }
+
+    _onClose(event) {
+        console.log("[WS] 连接已关闭", event);
+        this._updateReadyState(WebSocket.CLOSED);
+        this._stopHeartbeat();
+        this._emit("close", event);
+
+        if (!this.forcedClose) {
+            this._scheduleReconnect();
+        }
+    }
+
+    _onError(event) {
+        console.error("[WS] 连接发生错误:", event);
+        this._emit("error", event);
+    }
+
+    // --- 心跳机制 (重构) ---
+    _startHeartbeat() {
+        // 如果没有配置 getPingMessage，则无法启动心跳
+        if (!this.options.getPingMessage) {
+            return;
+        }
+
+        this._stopHeartbeat();
+        this.heartbeatTimer = setInterval(() => {
+            if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                try {
+                    // 调用注入的函数获取消息内容并发送
+                    const pingMessage = this.options.getPingMessage();
+                    this.ws.send(pingMessage);
+                    console.log("[WS] 发送 Ping:", pingMessage);
+                    this._setHeartbeatTimeout();
+                } catch (error) {
+                    console.error("[WS] 发送 Ping 消息失败:", error);
+                }
+            }
+        }, this.options.heartbeatInterval);
+    }
+
+    _stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        this._clearHeartbeatTimeout();
+    }
+
+    _setHeartbeatTimeout() {
+        this._clearHeartbeatTimeout();
+        this.heartbeatTimeoutTimer = setTimeout(() => {
+            console.error("[WS] 心跳超时，主动断开连接");
+            this.ws.close(1006, "Heartbeat timeout");
+        }, this.options.heartbeatTimeout);
+    }
+
+    _clearHeartbeatTimeout() {
+        if (this.heartbeatTimeoutTimer) {
+            clearTimeout(this.heartbeatTimeoutTimer);
+            this.heartbeatTimeoutTimer = null;
+        }
+    }
+
+    _handlePong() {
+        console.log("[WS] 收到 Pong");
+        this._clearHeartbeatTimeout();
+    }
+
+    // --- 重连机制 ---
+    _scheduleReconnect() {
+        if (this.forcedClose || this.isReconnecting || this.reconnectAttempts >= this.options.maxReconnectAttempts) {
+            if (this.reconnectAttempts >= this.options.maxReconnectAttempts) {
+                console.error("[WS] 已达到最大重连次数，停止重连");
+                this._emit("reconnect-failed");
+            }
+            return;
+        }
+
+        this.isReconnecting = true;
+        const interval = Math.min(this.options.reconnectBaseInterval * Math.pow(2, this.reconnectAttempts), this.options.maxReconnectInterval);
+
+        console.log(`[WS] ${interval / 1000}秒后将尝试第 ${this.reconnectAttempts + 1} 次重连...`);
+        this._emit("reconnect-attempt", { attempt: this.reconnectAttempts + 1, interval });
+
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectAttempts++;
+            this.connect();
+        }, interval);
+    }
+
+    _clearReconnectTimer() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+
+    // --- 消息队列 ---
+    _flushMessageQueue() {
+        if (this.messageQueue.length === 0) return;
+        console.log(`[WS] 发送队列中的 ${this.messageQueue.length} 条消息`);
+        const queue = [...this.messageQueue];
+        this.messageQueue = [];
+        queue.forEach((data) => this.send(data));
+    }
+
+    // --- 事件系统 ---
+    _emit(eventName, ...args) {
+        if (this.listeners.has(eventName)) {
+            this.listeners.get(eventName).forEach((callback) => callback(...args));
+        }
+    }
+
+    // --- 状态与监听器管理 ---
+    _updateReadyState(newState) {
+        this.readyState = newState;
+        this._emit("ready-state-change", newState);
+    }
+
+    _setupEventListeners() {
+        document.addEventListener("visibilitychange", this._handleVisibilityChange);
+        window.addEventListener("online", this._handleOnline);
+        window.addEventListener("offline", this._handleOffline);
+    }
+
+    _removeEventListeners() {
+        document.removeEventListener("visibilitychange", this._handleVisibilityChange);
+        window.removeEventListener("online", this._handleOnline);
+        window.removeEventListener("offline", this._handleOffline);
+    }
+
+    _handleVisibilityChange() {
+        // 如果未启用心跳，不需要处理页面可见性变化
+        if (!this.options.enableHeartbeat) {
+            return;
+        }
+
+        if (document.hidden) {
+            console.log("[WS] 页面隐藏，停止心跳");
+            this._stopHeartbeat();
+        } else {
+            console.log("[WS] 页面可见，检查连接状态");
+            if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                this._startHeartbeat();
+            } else if (!this.forcedClose && !this.isReconnecting) {
+                this.connect();
+            }
+        }
+    }
+
+    _handleOnline() {
+        console.log("[WS] 网络已恢复，尝试重连");
+        if (!this.forcedClose && this.readyState !== WebSocket.OPEN) {
+            this._clearReconnectTimer(); // 清除当前的重连计划
+            this.connect(); // 立即尝试连接
+        }
+    }
+
+    _handleOffline() {
+        console.log("[WS] 网络已断开");
+        this._clearReconnectTimer(); // 停止重连尝试
+        // ws.onclose 会被触发，从而启动重连逻辑，但我们已经停止了
+        // 所以这里可以手动触发一次 close 事件来通知应用层
+        if (this.ws) this.ws.onclose({ code: 1006, reason: "Network offline" });
+    }
+}
+
+export { WebSocketManager };
+//# sourceMappingURL=webSocket.js.map

package/dist/webSocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSocket.js","sources":["../src/source/webSocket.js"],"sourcesContent":["/**\n * @class WebSocketManager - 一个功能强大、高度可定制的 WebSocket 助手类\n *\n * @features\n * - 智能断线重连 (指数退避算法)\n * - 网络状态监听\n * - 高度可定制的心跳保活机制 (通过注入函数实现)\n * - 页面可见性 API 集成\n * - 消息发送队列\n * - 事件驱动的消息分发\n * - 清晰的生命周期管理\n * - 优雅的资源销毁\n * - 可配置的数据序列化/反序列化\n */\nexport class WebSocketManager {\n    /**\n     * @param {string} url - WebSocket 服务器的地址\n     * @param {object} [options={}] - 配置选项\n     * @param {number} [options.heartbeatInterval=30000] - 心跳间隔 (毫秒)\n     * @param {number} [options.heartbeatTimeout=10000] - 心跳超时时间 (毫秒)\n     * @param {number} [options.reconnectBaseInterval=1000] - 重连基础间隔 (毫秒)\n     * @param {number} [options.maxReconnectInterval=30000] - 最大重连间隔 (毫秒)\n     * @param {number} [options.maxReconnectAttempts=Infinity] - 最大重连次数\n     * @param {boolean} [options.autoConnect=true] - 是否在实例化后自动连接\n     * @param {boolean} [options.serializeData=false] - 发送数据时是否自动序列化为JSON字符串\n     * @param {boolean} [options.deserializeData=false] - 接收数据时是否自动反序列化为JSON对象\n     * @param {function|null} [options.getPingMessage=null] - 返回要发送的 ping 消息内容的函数。如果为 null，则不发送心跳。\n     * @param {function|null} [options.isPongMessage=null] - 判断接收到的消息是否为 pong 的函数。接收 MessageEvent 对象作为参数，返回布尔值。\n     * @param {object} [options.protocols] - WebSocket 协议\n     */\n    constructor(url, options = {}) {\n        this.url = url;\n\n        // 默认的心跳实现，用于向后兼容\n        const defaultGetPingMessage = () => JSON.stringify({ type: \"ping\" });\n        const defaultIsPongMessage = (event) => {\n            try {\n                const message = JSON.parse(event.data);\n                return message.type === \"pong\";\n            } catch (e) {\n                return false;\n            }\n        };\n\n        this.options = {\n            heartbeatInterval: 30000,\n            heartbeatTimeout: 10000,\n            reconnectBaseInterval: 1000,\n            maxReconnectInterval: 30000,\n            maxReconnectAttempts: Infinity,\n            autoConnect: true,\n            serializeData: false,\n            deserializeData: false,\n            getPingMessage: defaultGetPingMessage, // 默认提供 ping 消息生成器\n            isPongMessage: defaultIsPongMessage, // 默认提供 pong 消息判断器\n            ...options\n        };\n\n        // WebSocket 实例\n        this.ws = null;\n\n        // 状态管理\n        this.readyState = WebSocket.CLOSED;\n        this.reconnectAttempts = 0;\n        this.forcedClose = false;\n        this.isReconnecting = false;\n\n        // 定时器\n        this.heartbeatTimer = null;\n        this.heartbeatTimeoutTimer = null;\n        this.reconnectTimer = null;\n\n        // 消息队列\n        this.messageQueue = [];\n\n        // 事件监听器\n        this.listeners = new Map();\n\n        // 绑定方法上下文\n        this._onOpen = this._onOpen.bind(this);\n        this._onMessage = this._onMessage.bind(this);\n        this._onClose = this._onClose.bind(this);\n        this._onError = this._onError.bind(this);\n        this._handleVisibilityChange = this._handleVisibilityChange.bind(this);\n        this._handleOnline = this._handleOnline.bind(this);\n        this._handleOffline = this._handleOffline.bind(this);\n\n        this._setupEventListeners();\n\n        if (this.options.autoConnect) {\n            this.connect();\n        }\n    }\n\n    // --- 公共 API ---\n\n    /**\n     * 连接到 WebSocket 服务器\n     */\n    connect() {\n        if (this.ws && (this.ws.readyState === WebSocket.CONNECTING || this.ws.readyState === WebSocket.OPEN)) {\n            return;\n        }\n\n        this.forcedClose = false;\n        this._updateReadyState(WebSocket.CONNECTING);\n        console.log(`[WS] 正在连接到 ${this.url}...`);\n        this._emit(\"connecting\");\n\n        try {\n            this.ws = new WebSocket(this.url, this.options.protocols);\n            this.ws.onopen = this._onOpen;\n            this.ws.onmessage = this._onMessage;\n            this.ws.onclose = this._onClose;\n            this.ws.onerror = this._onError;\n        } catch (error) {\n            console.error(\"[WS] 连接失败:\", error);\n            this._onError(error);\n        }\n    }\n\n    /**\n     * 发送数据\n     * @param {string|object|ArrayBuffer|Blob} data - 要发送的数据\n     */\n    send(data) {\n        if (this.readyState === WebSocket.OPEN) {\n            let message;\n            // 根据配置决定是否序列化数据\n            if (this.options.serializeData) {\n                message = JSON.stringify(data);\n            } else {\n                message = data;\n            }\n            this.ws.send(message);\n            console.log(\"[WS] 消息已发送:\", message);\n        } else {\n            console.warn(\"[WS] 连接未打开，消息已加入队列:\", data);\n            this.messageQueue.push(data);\n        }\n    }\n\n    /**\n     * 主动关闭连接\n     * @param {number} [code=1000] - 关闭代码\n     * @param {string} [reason=''] - 关闭原因\n     */\n    close(code = 1000, reason = \"Normal closure\") {\n        this.forcedClose = true;\n        this._stopHeartbeat();\n        this._clearReconnectTimer();\n        if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n            this.ws.close(code, reason);\n        } else {\n            this._updateReadyState(WebSocket.CLOSED);\n            this._emit(\"close\", { code, reason, wasClean: true });\n        }\n    }\n\n    /**\n     * 彻底销毁实例，清理所有资源\n     */\n    destroy() {\n        console.log(\"[WS] 正在销毁实例...\");\n        this.close(1000, \"Instance destroyed\");\n        this._removeEventListeners();\n        this.messageQueue = [];\n        this.listeners.clear();\n        this.ws = null;\n    }\n\n    /**\n     * 添加事件监听器\n     * @param {string} eventName - 事件名 (e.g., 'open', 'message', 'close', 'error', 'reconnect')\n     * @param {function} callback - 回调函数\n     */\n    on(eventName, callback) {\n        if (!this.listeners.has(eventName)) {\n            this.listeners.set(eventName, []);\n        }\n        this.listeners.get(eventName).push(callback);\n    }\n\n    /**\n     * 移除事件监听器\n     * @param {string} eventName - 事件名\n     * @param {function} callback - 回调函数\n     */\n    off(eventName, callback) {\n        if (this.listeners.has(eventName)) {\n            const callbacks = this.listeners.get(eventName);\n            const index = callbacks.indexOf(callback);\n            if (index > -1) {\n                callbacks.splice(index, 1);\n            }\n        }\n    }\n\n    // --- 内部方法 ---\n\n    _onOpen(event) {\n        console.log(\"[WS] 连接已建立\");\n        this._updateReadyState(WebSocket.OPEN);\n        this.reconnectAttempts = 0;\n        this.isReconnecting = false;\n\n        // 如果配置了 getPingMessage，则启动心跳\n        if (this.options.getPingMessage) {\n            this._startHeartbeat();\n        }\n\n        this._flushMessageQueue();\n        this._emit(\"open\", event);\n    }\n\n    /**\n     * 优化后的消息处理方法，使用注入的函数来判断心跳\n     * @param {MessageEvent} event\n     */\n    _onMessage(event) {\n        // --- 步骤 1: 使用注入的函数优先处理内部心跳机制 ---\n        if (this.options.isPongMessage && this.options.isPongMessage(event)) {\n            this._handlePong();\n            return; // 是心跳消息，处理完毕，直接返回\n        }\n\n        // --- 步骤 2: 根据用户配置处理业务消息 ---\n        if (this.options.deserializeData) {\n            try {\n                const parsedMessage = JSON.parse(event.data);\n                this._emit(\"message\", parsedMessage);\n            } catch (e) {\n                this._emit(\"message\", event.data);\n            }\n        } else {\n            this._emit(\"message\", event.data);\n        }\n    }\n\n    _onClose(event) {\n        console.log(\"[WS] 连接已关闭\", event);\n        this._updateReadyState(WebSocket.CLOSED);\n        this._stopHeartbeat();\n        this._emit(\"close\", event);\n\n        if (!this.forcedClose) {\n            this._scheduleReconnect();\n        }\n    }\n\n    _onError(event) {\n        console.error(\"[WS] 连接发生错误:\", event);\n        this._emit(\"error\", event);\n    }\n\n    // --- 心跳机制 (重构) ---\n    _startHeartbeat() {\n        // 如果没有配置 getPingMessage，则无法启动心跳\n        if (!this.options.getPingMessage) {\n            return;\n        }\n\n        this._stopHeartbeat();\n        this.heartbeatTimer = setInterval(() => {\n            if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n                try {\n                    // 调用注入的函数获取消息内容并发送\n                    const pingMessage = this.options.getPingMessage();\n                    this.ws.send(pingMessage);\n                    console.log(\"[WS] 发送 Ping:\", pingMessage);\n                    this._setHeartbeatTimeout();\n                } catch (error) {\n                    console.error(\"[WS] 发送 Ping 消息失败:\", error);\n                }\n            }\n        }, this.options.heartbeatInterval);\n    }\n\n    _stopHeartbeat() {\n        if (this.heartbeatTimer) {\n            clearInterval(this.heartbeatTimer);\n            this.heartbeatTimer = null;\n        }\n        this._clearHeartbeatTimeout();\n    }\n\n    _setHeartbeatTimeout() {\n        this._clearHeartbeatTimeout();\n        this.heartbeatTimeoutTimer = setTimeout(() => {\n            console.error(\"[WS] 心跳超时，主动断开连接\");\n            this.ws.close(1006, \"Heartbeat timeout\");\n        }, this.options.heartbeatTimeout);\n    }\n\n    _clearHeartbeatTimeout() {\n        if (this.heartbeatTimeoutTimer) {\n            clearTimeout(this.heartbeatTimeoutTimer);\n            this.heartbeatTimeoutTimer = null;\n        }\n    }\n\n    _handlePong() {\n        console.log(\"[WS] 收到 Pong\");\n        this._clearHeartbeatTimeout();\n    }\n\n    // --- 重连机制 ---\n    _scheduleReconnect() {\n        if (this.forcedClose || this.isReconnecting || this.reconnectAttempts >= this.options.maxReconnectAttempts) {\n            if (this.reconnectAttempts >= this.options.maxReconnectAttempts) {\n                console.error(\"[WS] 已达到最大重连次数，停止重连\");\n                this._emit(\"reconnect-failed\");\n            }\n            return;\n        }\n\n        this.isReconnecting = true;\n        const interval = Math.min(this.options.reconnectBaseInterval * Math.pow(2, this.reconnectAttempts), this.options.maxReconnectInterval);\n\n        console.log(`[WS] ${interval / 1000}秒后将尝试第 ${this.reconnectAttempts + 1} 次重连...`);\n        this._emit(\"reconnect-attempt\", { attempt: this.reconnectAttempts + 1, interval });\n\n        this.reconnectTimer = setTimeout(() => {\n            this.reconnectAttempts++;\n            this.connect();\n        }, interval);\n    }\n\n    _clearReconnectTimer() {\n        if (this.reconnectTimer) {\n            clearTimeout(this.reconnectTimer);\n            this.reconnectTimer = null;\n        }\n    }\n\n    // --- 消息队列 ---\n    _flushMessageQueue() {\n        if (this.messageQueue.length === 0) return;\n        console.log(`[WS] 发送队列中的 ${this.messageQueue.length} 条消息`);\n        const queue = [...this.messageQueue];\n        this.messageQueue = [];\n        queue.forEach((data) => this.send(data));\n    }\n\n    // --- 事件系统 ---\n    _emit(eventName, ...args) {\n        if (this.listeners.has(eventName)) {\n            this.listeners.get(eventName).forEach((callback) => callback(...args));\n        }\n    }\n\n    // --- 状态与监听器管理 ---\n    _updateReadyState(newState) {\n        this.readyState = newState;\n        this._emit(\"ready-state-change\", newState);\n    }\n\n    _setupEventListeners() {\n        document.addEventListener(\"visibilitychange\", this._handleVisibilityChange);\n        window.addEventListener(\"online\", this._handleOnline);\n        window.addEventListener(\"offline\", this._handleOffline);\n    }\n\n    _removeEventListeners() {\n        document.removeEventListener(\"visibilitychange\", this._handleVisibilityChange);\n        window.removeEventListener(\"online\", this._handleOnline);\n        window.removeEventListener(\"offline\", this._handleOffline);\n    }\n\n    _handleVisibilityChange() {\n        // 如果未启用心跳，不需要处理页面可见性变化\n        if (!this.options.enableHeartbeat) {\n            return;\n        }\n\n        if (document.hidden) {\n            console.log(\"[WS] 页面隐藏，停止心跳\");\n            this._stopHeartbeat();\n        } else {\n            console.log(\"[WS] 页面可见，检查连接状态\");\n            if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n                this._startHeartbeat();\n            } else if (!this.forcedClose && !this.isReconnecting) {\n                this.connect();\n            }\n        }\n    }\n\n    _handleOnline() {\n        console.log(\"[WS] 网络已恢复，尝试重连\");\n        if (!this.forcedClose && this.readyState !== WebSocket.OPEN) {\n            this._clearReconnectTimer(); // 清除当前的重连计划\n            this.connect(); // 立即尝试连接\n        }\n    }\n\n    _handleOffline() {\n        console.log(\"[WS] 网络已断开\");\n        this._clearReconnectTimer(); // 停止重连尝试\n        // ws.onclose 会被触发，从而启动重连逻辑，但我们已经停止了\n        // 所以这里可以手动触发一次 close 事件来通知应用层\n        if (this.ws) this.ws.onclose({ code: 1006, reason: \"Network offline\" });\n    }\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "a2bei4-utils",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "🧰 零依赖、ESM 的 JS 业务工具箱：数组乱序/深浅克隆、防抖节流、URL/query 解析、Date/时长格式化、随机汉字/字母、文件下载、事件总线、UUID/分布式短 ID、树结构互转等 40+ 常用函数 & 类，Tree-Shaking 友好。",
   "private": false,
   "type": "module",
@@ -20,6 +20,11 @@
       "import": "./dist/arr.js",
       "require": "./dist/arr.cjs"
     },
+    "./audio": {
+      "types": "./types/audio.d.ts",
+      "import": "./dist/audio.js",
+      "require": "./dist/audio.cjs"
+    },
     "./browser": {
       "types": "./types/browser.d.ts",
       "import": "./dist/browser.js",
@@ -59,6 +64,11 @@
       "types": "./types/tree.d.ts",
       "import": "./dist/tree.js",
       "require": "./dist/tree.cjs"
+    },
+    "./webSocket": {
+      "types": "./types/webSocket.d.ts",
+      "import": "./dist/webSocket.js",
+      "require": "./dist/webSocket.cjs"
     }
   },
   "files": [

package/readme.txt

@@ -1,10 +1,13 @@
-0、首次安装依赖
-pnpm i -D @rollup/plugin-commonjs @rollup/plugin-node-resolve @rollup/plugin-terser prettier rollup rollup-plugin-dts rollup-plugin-filesize typescript
+！！！写在最前面： dist 、 types 、 /src/temp 、 /src/index.js 是构建过程中生成的
 
-
--->  官方 npm 仓库地址：https://registry.npmjs.org/
+-->  官方 npm 仓库地址： https://registry.npmjs.org/
+-->  阿里云 npm 仓库地址： https://registry.npmmirror.com/
 -->  --registry 显示指定的仓库地址，如：http://192.168.x.x:4873
 
+
+0、首次安装依赖
+pnpm i -D @rollup/plugin-commonjs @rollup/plugin-node-resolve @rollup/plugin-terser prettier rollup rollup-plugin-dts rollup-plugin-filesize typescript
+
 1、如果没有用户，先注册用户
 pnpm adduser --registry https://registry.npmjs.org/
 
@@ -15,4 +18,4 @@ pnpm login --registry https://registry.npmjs.org/
 pnpm publish --registry https://registry.npmjs.org/
 
 4、撤销发布
-pnpm unpublish a2bei4-utils --force --registry https://registry.npmjs.org/
+pnpm unpublish a2bei4-utils --force --registry https://registry.npmjs.org/

package/types/audio.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 将 16-bit 单声道 PCM 数据封装成标准 WAV Blob。
+ *
+ * @param {Int16Array} pcmData - PCM 采样数据
+ * @param {number} [sampleRate=16000] - 采样率，默认 16 kHz
+ * @returns {Blob} audio/wav Blob
+ */
+declare function pcmToWavBlob(pcmData: Int16Array, sampleRate?: number): Blob;
+/**
+ * 浏览器端实时音频流重采样器。
+ * 基于 AudioWorklet 将麦克风/媒体流转换为 16 kHz、16-bit、单声道 PCM，
+ * 并通过回调逐块输出，可选保存完整 PCM 用于后续合并。
+ */
+declare class AudioStreamResampler {
+    /**
+     * @param {object} config
+     * @param {function(Int16Array)} config.onData - 收到一个 chunk PCM 数据的回调
+     * @param {function(string, string)} [config.onStateChange] - 状态变化回调
+     * @param {object} [config.processorOptions] - 传递给 AudioWorklet 的选项
+     * @param {boolean} [config.saveFullPcm=false] - 是否在内部保存所有 PCM 用于 stop 时合并（长时间录音建议关闭）
+     */
+    constructor(config: {
+        onData: (arg0: Int16Array) => any;
+        onStateChange?: ((arg0: string, arg1: string) => any) | undefined;
+        processorOptions?: object | undefined;
+        saveFullPcm?: boolean | undefined;
+    });
+    onData: (arg0: Int16Array) => any;
+    onStateChange: (arg0: string, arg1: string) => any;
+    processorOptions: object;
+    saveFullPcm: boolean;
+    audioContext: AudioContext | null;
+    workletNode: AudioWorkletNode | null;
+    source: MediaStreamAudioSourceNode | null;
+    workletUrl: string | null;
+    fullPcmData: never[] | null;
+    isInitialized: boolean;
+    isProcessing: boolean;
+    /**
+     * 初始化 AudioContext 并加载 AudioWorklet。
+     * 完成后状态变为 `"ready"`。
+     */
+    init(): Promise<void>;
+    /**
+     * 绑定媒体流，开始实时处理。
+     * @param {MediaStream} stream - 通过 getUserMedia 或其他方式获得的流
+     */
+    setMediaStream(stream: MediaStream): void;
+    /**
+     * 停止处理并释放资源。
+     * @param {(fullPcm: Int16Array) => void} [callback] - 若构造时 `saveFullPcm=true`，会把合并后的完整 PCM 通过此回调传出
+     */
+    stop(callback?: (fullPcm: Int16Array) => void): void;
+    _cleanup(): void;
+}
+
+export { AudioStreamResampler, pcmToWavBlob };

package/types/download.d.ts

@@ -1,5 +1,6 @@
 /**
  * 通过动态创建 `<a>` 标签触发浏览器下载。
+ * 注意：此方法可能无法强制下载浏览器原生支持的文件（如图片、PDF），浏览器可能会选择直接打开。
  *
  * @param {string} url - 任意可下载地址（同源或允许跨域）
  * @param {string} [fileName] - 保存到本地的文件名；不传时使用时间戳
@@ -35,5 +36,15 @@ declare function downloadExcel(data: string | ArrayBufferView | ArrayBuffer | Bl
  * @param {string} [fileName] - 保存到本地的文件名
  */
 declare function downloadJSON(data: any, fileName?: string): void;
+/**
+ * 通过 `fetch` 获取资源并强制下载，避免浏览器直接打开文件。
+ * 此方法适用于下载图片、PDF 等浏览器默认会打开的文件类型。
+ * 如果 `fetch` 失败（如 CORS 策略阻止），会回退到 `downloadByUrl` 方法作为备选方案。
+ *
+ * @param {string} url - 文件的 URL 地址
+ * @param {string} [fileName] - 保存到本地的文件名。如果不提供，会尝试从 URL 中自动提取
+ * @returns {Promise<void>} 返回一个 Promise，在下载开始或失败后 resolve
+ */
+declare function fetchOrDownloadByUrl(url: string, fileName?: string): Promise<void>;
 
-export { downloadByBlob, downloadByData, downloadByUrl, downloadExcel, downloadJSON };
+export { downloadByBlob, downloadByData, downloadByUrl, downloadExcel, downloadJSON, fetchOrDownloadByUrl };