liangzimixin 0.3.35 → 0.3.36

package/dist/index.cjs

@@ -18929,7 +18929,11 @@ var quantumImPlugin = {
     })
   },
   messaging: {
-    normalizeTarget: (raw) => raw ?? void 0
+    normalizeTarget: (raw) => {
+      if (!raw) return void 0;
+      const normalized = parseChannelAddress(raw).trim();
+      return normalized || void 0;
+    }
   },
   outbound: quantumImOutbound,
   setup: {
@@ -19865,6 +19869,9 @@ var WSClient = class extends import_node_events.EventEmitter {
       ws.on("message", (data) => {
         this.emit("message", data);
       });
+      ws.on("pong", () => {
+        this.emit("pong");
+      });
       ws.on("close", (code, reason) => {
         log19.info("ws:closed", { code, reason: reason.toString() });
         this.emit("close", code, reason.toString());
@@ -19887,6 +19894,12 @@ var WSClient = class extends import_node_events.EventEmitter {
     }
     this.ws.send(data);
   }
+  /** 发送 WebSocket 协议级 Ping 帧 */
+  ping() {
+    if (this.ws && this.ws.readyState === wrapper_default.OPEN) {
+      this.ws.ping();
+    }
+  }
   /** 关闭连接 */
   close(code, reason) {
     if (this.ws) {
@@ -20243,6 +20256,8 @@ var ConnectionManager = class {
   appId = "";
   /** 是否正在重连中 (防止并发重连) */
   reconnecting = false;
+  /** 是否收到了最近一次 pong 响应 */
+  pongReceived = true;
   constructor(client, options) {
     this.client = client;
     this.options = {
@@ -20276,6 +20291,15 @@ var ConnectionManager = class {
         ...this.appId ? { "X-App-ID": this.appId } : {}
       }
     });
+    this.registerEvents();
+    this.startHeartbeat();
+    log22.info("ConnectionManager started \u2713", { url: url2 });
+  }
+  /** 注册 close / error / pong 事件 */
+  registerEvents() {
+    this.client.removeAllListeners("close");
+    this.client.removeAllListeners("error");
+    this.client.removeAllListeners("pong");
     this.client.on("close", () => {
       if (this.running) {
         log22.warn("ws:disconnected, scheduling reconnect");
@@ -20285,17 +20309,29 @@ var ConnectionManager = class {
     this.client.on("error", (err) => {
       log22.error("ws:connection-error", { error: err.message });
     });
-    this.startHeartbeat();
-    log22.info("ConnectionManager started \u2713", { url: url2 });
+    this.client.on("pong", () => {
+      this.pongReceived = true;
+    });
   }
-  /** 启动心跳保活 — 定时检查连接状态 */
+  /** 启动心跳保活 — 定时发送 WebSocket Ping 帧 */
   startHeartbeat() {
     this.stopHeartbeat();
+    this.pongReceived = true;
     this.heartbeatTimer = setInterval(() => {
       if (this.client.readyState !== wrapper_default.OPEN) {
         log22.warn("heartbeat: connection not open, scheduling reconnect");
         this.scheduleReconnect();
+        return;
+      }
+      if (!this.pongReceived) {
+        log22.warn("heartbeat: pong timeout, connection dead");
+        this.client.close(4e3, "pong timeout");
+        this.scheduleReconnect();
+        return;
       }
+      this.pongReceived = false;
+      this.client.ping();
+      log22.debug?.("heartbeat: ping sent");
     }, this.options.heartbeatIntervalMs);
   }
   /** 停止心跳定时器 */
@@ -20337,6 +20373,7 @@ var ConnectionManager = class {
           }
         });
         this.reconnectAttempts = 0;
+        this.registerEvents();
         this.startHeartbeat();
         log22.info("ws:reconnected", { attempt: this.reconnectAttempts, url: this.url });
         return;

package/dist/index.d.cts

@@ -684,6 +684,8 @@ declare class WSClient extends EventEmitter {
     connect(options: WSClientOptions): Promise<void>;
     /** 发送数据到服务器 — 前置检查连接状态 */
     send(data: string | Buffer): void;
+    /** 发送 WebSocket 协议级 Ping 帧 */
+    ping(): void;
     /** 关闭连接 */
     close(code?: number, reason?: string): void;
     /** 当前连接状态 (0=CONNECTING, 1=OPEN, 2=CLOSING, 3=CLOSED) */
@@ -865,6 +867,8 @@ declare class ConnectionManager {
     private appId;
     /** 是否正在重连中 (防止并发重连) */
     private reconnecting;
+    /** 是否收到了最近一次 pong 响应 */
+    private pongReceived;
     constructor(client: WSClient, options?: ConnectionManagerOptions);
     /**
      * 启动连接 — 连接 WS + 开始心跳 + 注册重连逻辑
@@ -873,7 +877,9 @@ declare class ConnectionManager {
      * @param appId - 应用 ID (用于 X-App-ID 头)
      */
     start(url: string, tokenFn: () => Promise<string>, appId?: string): Promise<void>;
-    /** 启动心跳保活 — 定时检查连接状态 */
+    /** 注册 close / error / pong 事件 */
+    private registerEvents;
+    /** 启动心跳保活 — 定时发送 WebSocket Ping 帧 */
     private startHeartbeat;
     /** 停止心跳定时器 */
     private stopHeartbeat;

package/dist/setup-entry.cjs

@@ -18928,6 +18928,9 @@ var WSClient = class extends import_node_events.EventEmitter {
       ws.on("message", (data) => {
         this.emit("message", data);
       });
+      ws.on("pong", () => {
+        this.emit("pong");
+      });
       ws.on("close", (code, reason) => {
         log10.info("ws:closed", { code, reason: reason.toString() });
         this.emit("close", code, reason.toString());
@@ -18950,6 +18953,12 @@ var WSClient = class extends import_node_events.EventEmitter {
     }
     this.ws.send(data);
   }
+  /** 发送 WebSocket 协议级 Ping 帧 */
+  ping() {
+    if (this.ws && this.ws.readyState === wrapper_default.OPEN) {
+      this.ws.ping();
+    }
+  }
   /** 关闭连接 */
   close(code, reason) {
     if (this.ws) {
@@ -19306,6 +19315,8 @@ var ConnectionManager = class {
   appId = "";
   /** 是否正在重连中 (防止并发重连) */
   reconnecting = false;
+  /** 是否收到了最近一次 pong 响应 */
+  pongReceived = true;
   constructor(client, options) {
     this.client = client;
     this.options = {
@@ -19339,6 +19350,15 @@ var ConnectionManager = class {
         ...this.appId ? { "X-App-ID": this.appId } : {}
       }
     });
+    this.registerEvents();
+    this.startHeartbeat();
+    log13.info("ConnectionManager started \u2713", { url: url2 });
+  }
+  /** 注册 close / error / pong 事件 */
+  registerEvents() {
+    this.client.removeAllListeners("close");
+    this.client.removeAllListeners("error");
+    this.client.removeAllListeners("pong");
     this.client.on("close", () => {
       if (this.running) {
         log13.warn("ws:disconnected, scheduling reconnect");
@@ -19348,17 +19368,29 @@ var ConnectionManager = class {
     this.client.on("error", (err) => {
       log13.error("ws:connection-error", { error: err.message });
     });
-    this.startHeartbeat();
-    log13.info("ConnectionManager started \u2713", { url: url2 });
+    this.client.on("pong", () => {
+      this.pongReceived = true;
+    });
   }
-  /** 启动心跳保活 — 定时检查连接状态 */
+  /** 启动心跳保活 — 定时发送 WebSocket Ping 帧 */
   startHeartbeat() {
     this.stopHeartbeat();
+    this.pongReceived = true;
     this.heartbeatTimer = setInterval(() => {
       if (this.client.readyState !== wrapper_default.OPEN) {
         log13.warn("heartbeat: connection not open, scheduling reconnect");
         this.scheduleReconnect();
+        return;
       }
+      if (!this.pongReceived) {
+        log13.warn("heartbeat: pong timeout, connection dead");
+        this.client.close(4e3, "pong timeout");
+        this.scheduleReconnect();
+        return;
+      }
+      this.pongReceived = false;
+      this.client.ping();
+      log13.debug?.("heartbeat: ping sent");
     }, this.options.heartbeatIntervalMs);
   }
   /** 停止心跳定时器 */
@@ -19400,6 +19432,7 @@ var ConnectionManager = class {
           }
         });
         this.reconnectAttempts = 0;
+        this.registerEvents();
         this.startHeartbeat();
         log13.info("ws:reconnected", { attempt: this.reconnectAttempts, url: this.url });
         return;
@@ -20661,7 +20694,11 @@ var quantumImPlugin = {
     })
   },
   messaging: {
-    normalizeTarget: (raw) => raw ?? void 0
+    normalizeTarget: (raw) => {
+      if (!raw) return void 0;
+      const normalized = parseChannelAddress(raw).trim();
+      return normalized || void 0;
+    }
   },
   outbound: quantumImOutbound,
   setup: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "liangzimixin",
-  "version": "0.3.35",
+  "version": "0.3.36",
   "description": "Quantum-encrypted IM channel plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.cjs",