@tiktool/live 2.7.1 → 2.8.0

package/dist/index.mjs

@@ -396,27 +396,41 @@ function parseWebcastMessage(method, payload) {
     // Proto: WebcastLinkMicBattle { repeated WebcastLinkMicBattleItems battleUsers=10 }
     //   battleUsers → { battleGroup=2 → { LinkUser user=1 } }
     case "WebcastLinkMicBattle": {
-      const battleId = String(getInt(f, 1) || "");
-      const status = getInt(f, 2) || 1;
+      const battleId = String(getInt(f, 4) || getInt(f, 1) || "");
+      let status = getInt(f, 7);
+      if (!status) {
+        const fallback = getInt(f, 2);
+        status = fallback > 0 && fallback < 100 ? fallback : 1;
+      }
       const battleDuration = getInt(f, 3);
       const teams = [];
-      const battleUserBufs = getAllBytes(f, 10);
-      for (const bub of battleUserBufs) {
+      const hostBufs = getAllBytes(f, 14);
+      for (const hb of hostBufs) {
         try {
-          const bf = decodeProto(bub);
-          const groupBuf = getBytes(bf, 2);
-          if (groupBuf) {
-            const gf = decodeProto(groupBuf);
-            const linkUserBuf = getBytes(gf, 1);
-            if (linkUserBuf) {
-              const user = parseUser(linkUserBuf);
-              teams.push({
-                hostUserId: user.id,
-                score: 0,
-                users: [{ user, score: 0 }]
-              });
+          const hf = decodeProto(hb);
+          const hostUserId = String(getInt(hf, 1) || "");
+          const teamTotalScore = getInt(hf, 3);
+          const users = [];
+          const containerBuf = getBytes(hf, 4);
+          if (containerBuf) {
+            const cf = decodeProto(containerBuf);
+            const userBufs = getAllBytes(cf, 1);
+            for (const ub of userBufs) {
+              try {
+                const uf = decodeProto(ub);
+                users.push({
+                  user: {
+                    id: String(getInt(uf, 1) || ""),
+                    nickname: getStr(uf, 3) || "",
+                    uniqueId: getStr(uf, 3) || ""
+                  },
+                  score: getInt(uf, 2)
+                });
+              } catch {
+              }
             }
           }
+          teams.push({ hostUserId, score: teamTotalScore, users });
         } catch {
         }
       }
@@ -429,15 +443,42 @@ function parseWebcastMessage(method, payload) {
           }
         }
       }
+      if (teams.length === 0) {
+        const battleUserBufs = getAllBytes(f, 10);
+        for (const bub of battleUserBufs) {
+          try {
+            const bf = decodeProto(bub);
+            const groupBuf = getBytes(bf, 2);
+            if (groupBuf) {
+              const gf = decodeProto(groupBuf);
+              const linkUserBuf = getBytes(gf, 1);
+              if (linkUserBuf) {
+                const user = parseUser(linkUserBuf);
+                teams.push({
+                  hostUserId: user.id,
+                  score: 0,
+                  users: [{ user, score: 0 }]
+                });
+              }
+            }
+          } catch {
+          }
+        }
+      }
       return { ...base, type: "battle", battleId, status, battleDuration, teams };
     }
-    // Proto: WebcastLinkMicArmies { msg_header=1, session_id=2, repeated battleItems=3, status=7,
-    //   battle_config=18 { session_id=1, start_time_ms=2, duration_s=3 }, battle_id=17 }
-    //   battleItems → { hostUserId=1, repeated battleGroups=2 }
-    //     battleGroups → { repeated users=1, int32 points=2 }
+    // Proto: WebcastLinkMicArmies { msg_header=1, matchId=2, session_id=4, startedAtMs=5,
+    //   serverTsMs=6, repeated battleItems=3, status=7, sessionTag=17,
+    //   battle_config=18 { session_id=1, start_time_ms=2, duration_s=3 },
+    //   repeated hosts=14 { hostUserId=1, teamTotalScore=3, teamIdx=5,
+    //     userContainer=4 { repeated users=1 { userId=1, score=2, nickname=3 } } }
     case "WebcastLinkMicArmies": {
-      const battleId = getStr(f, 17) || String(getInt(f, 2) || "");
+      const sessionTag = getStr(f, 17);
+      const matchId = getIntStr(f, 2);
+      const sessionId = getIntStr(f, 4);
+      const battleId = sessionTag || matchId;
       const battleStatus = getInt(f, 7);
+      const serverTsMs = getInt(f, 6);
       const teams = [];
       const itemBufs = getAllBytes(f, 3);
       for (const ib of itemBufs) {
@@ -457,6 +498,10 @@ function parseWebcastMessage(method, payload) {
         } catch {
         }
       }
+      let secsRemaining = 0;
+      if (battleStartMs > 0 && battleDurationSeconds > 0 && serverTsMs > 0) {
+        secsRemaining = Math.max(0, battleDurationSeconds - Math.floor((serverTsMs - battleStartMs) / 1e3));
+      }
       let endTimeMs = 0;
       let timeLeftSeconds = 0;
       if (battleStartMs > 0 && battleDurationSeconds > 0) {
@@ -464,6 +509,36 @@ function parseWebcastMessage(method, payload) {
         const elapsedMs = Date.now() - battleStartMs;
         timeLeftSeconds = Math.max(0, battleDurationSeconds - Math.floor(elapsedMs / 1e3));
       }
+      const hosts = [];
+      const hostBufs = getAllBytes(f, 14);
+      for (const hb of hostBufs) {
+        try {
+          const hf = decodeProto(hb);
+          const hostUserId = getIntStr(hf, 1);
+          const teamTotalScore = getInt(hf, 3);
+          const teamIdx = getInt(hf, 5);
+          const contributors = [];
+          const containerBuf = getBytes(hf, 4);
+          if (containerBuf) {
+            const cf = decodeProto(containerBuf);
+            const userBufs = getAllBytes(cf, 1);
+            for (const ub of userBufs) {
+              try {
+                const uf = decodeProto(ub);
+                contributors.push({
+                  userId: getIntStr(uf, 1),
+                  score: getInt(uf, 2),
+                  nickname: getStr(uf, 3) || ""
+                });
+              } catch {
+              }
+            }
+            contributors.sort((a, b) => b.score - a.score);
+          }
+          hosts.push({ hostUserId, teamTotalScore, teamIdx, contributors });
+        } catch {
+        }
+      }
       return {
         ...base,
         type: "battleArmies",
@@ -473,7 +548,162 @@ function parseWebcastMessage(method, payload) {
         battleStartMs,
         battleDurationSeconds,
         timeLeftSeconds,
-        endTimeMs
+        endTimeMs,
+        matchId,
+        sessionId,
+        serverTsMs,
+        sessionTag,
+        durationSec: battleDurationSeconds,
+        secsRemaining,
+        hosts
+      };
+    }
+    // Proto: WebcastLinkMicBattleItemCard
+    //   #2 battleId
+    //   #3 cardType (2=gloves/crit, 3=mist, 4=match_guide, 10=x2?, 11=x3, ...)
+    //   #5/#6/#7/#14 inner (location varies with cardType — scan numerically):
+    //     #1.{
+    //       #1 effectKey
+    //       #2 icon block { #1 repeated CDN urls, #2 iconKey, #5 accentColor }
+    //       #3 activatedAtSec (unix seconds)
+    //       #4 sender block: #1 sub { #1 userId, #2 nickname, #3 avatar block, #4 uniqueId }
+    //       #5 durationSec
+    //       #8 senderUserId (new boosters)
+    //       #11 endsAtSec
+    //       #12 senderUserId (old gloves/mist)
+    //     }
+    //     #3 comment template msg → #2 commentText
+    case "WebcastLinkMicBattleItemCard": {
+      const battleId = getIntStr(f, 2);
+      const cardType = getInt(f, 3);
+      let inner = null;
+      for (const fn of [5, 6, 7, 14, 15, 16, 8, 9, 10, 11, 12, 13]) {
+        const buf = getBytes(f, fn);
+        if (buf) {
+          inner = decodeProto(buf);
+          break;
+        }
+      }
+      let effectKey = "";
+      let effect = "unknown";
+      let multiplier = 0;
+      let activatedAtSec = 0;
+      let durationSec = 0;
+      let endsAtSec = 0;
+      let senderUserId = "";
+      let senderNickname = "";
+      let senderUniqueId = "";
+      let senderAvatarUrl = "";
+      let commentTemplate = "";
+      let iconUrl = "";
+      let iconKey = "";
+      let accentColor = "";
+      if (inner) {
+        let nameBuf = getBytes(inner, 1);
+        let nf = nameBuf ? decodeProto(nameBuf) : [];
+        let probedKey = nf.length ? getStr(nf, 1) || "" : "";
+        if (!probedKey) {
+          const altBuf = getBytes(inner, 3);
+          if (altBuf) {
+            const altFields = decodeProto(altBuf);
+            const altKey = getStr(altFields, 1) || "";
+            if (altKey) {
+              nameBuf = altBuf;
+              nf = altFields;
+              probedKey = altKey;
+            }
+          }
+        }
+        if (nameBuf && nf.length) {
+          effectKey = probedKey;
+          if (effectKey === "pm_mt_boost_crit_name") effect = "hammer";
+          else if (effectKey === "pm_mt_boost_glove_name" || effectKey === "pm_mt_boost_gloves_name") effect = "gloves";
+          else if (effectKey === "pm_mt_boost_mist_name") effect = "mist";
+          else if (effectKey === "pm_mt_match_guide_gotPowerUps") effect = "match_guide";
+          else if (effectKey.includes("userSentBooster_no2") || effectKey.includes("gotPowerUp_panel_no2")) {
+            effect = "booster_x2";
+            multiplier = 2;
+          } else if (effectKey.includes("userSentBooster_no3") || effectKey.includes("gotPowerUp_panel_no3")) {
+            effect = "booster_x3";
+            multiplier = 3;
+          } else if (effectKey.includes("thunder")) effect = "thunder";
+          else if (effectKey.includes("extra_time") || effectKey.includes("extra_round")) effect = "extra_time";
+          else if (effectKey) effect = effectKey;
+          activatedAtSec = getInt(nf, 3);
+          durationSec = getInt(nf, 5);
+          endsAtSec = getInt(nf, 11) || getInt(nf, 7);
+          senderUserId = getIntStr(nf, 12);
+          if (senderUserId === "0") senderUserId = getIntStr(nf, 8);
+          if (senderUserId === "0") senderUserId = getStr(nf, 13) || getStr(nf, 9) || "";
+          const iconBuf = getBytes(nf, 2);
+          if (iconBuf) {
+            const icf = decodeProto(iconBuf);
+            const urlBufs = getAllBytes(icf, 1);
+            for (const ub of urlBufs) {
+              const candidate = ub.toString("utf-8");
+              if (candidate.includes("://")) {
+                iconUrl = candidate;
+                break;
+              }
+            }
+            iconKey = getStr(icf, 2) || "";
+            accentColor = getStr(icf, 5) || "";
+          }
+          const senderOuter = getBytes(nf, 4);
+          if (senderOuter) {
+            const sf = decodeProto(senderOuter);
+            const sub = getBytes(sf, 1);
+            if (sub) {
+              const su = decodeProto(sub);
+              const nickBuf = getBytes(su, 2);
+              if (nickBuf) {
+                try {
+                  senderNickname = nickBuf.toString("utf-8");
+                } catch {
+                }
+              }
+              senderUniqueId = getStr(su, 4) || "";
+              if (!senderUserId || senderUserId === "0") senderUserId = getIntStr(su, 1);
+              const avBuf = getBytes(su, 3);
+              if (avBuf) {
+                const af = decodeProto(avBuf);
+                const urlBufs = getAllBytes(af, 1);
+                for (const ub of urlBufs) {
+                  const candidate = ub.toString("utf-8");
+                  if (candidate.includes("://")) {
+                    senderAvatarUrl = candidate;
+                    break;
+                  }
+                }
+              }
+            }
+          }
+        }
+        const commentBuf = getBytes(inner, 3);
+        if (commentBuf) {
+          const cf = decodeProto(commentBuf);
+          commentTemplate = getStr(cf, 2) || "";
+        }
+      }
+      return {
+        ...base,
+        type: "battleItemCard",
+        battleId,
+        cardType,
+        effect,
+        effectKey,
+        multiplier,
+        senderUserId,
+        senderNickname,
+        senderUniqueId,
+        senderAvatarUrl,
+        activatedAtSec,
+        durationSec,
+        endsAtSec,
+        commentTemplate,
+        iconUrl,
+        iconKey,
+        accentColor
       };
     }
     // Proto: WebcastSubNotifyMessage { User user=2, ... subMonth=3 }
@@ -676,13 +906,13 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
             preSignedCookies = credData.data.cookies || "";
             preSignedUA = credData.data.user_agent || DEFAULT_UA;
             ttwid = "__presigned__";
-            console.log(`[TikTokLive] \u2705 Got pre-signed URL from sign server`);
+            console.log(`[TikTokLive] \xE2\u0153\u2026 Got pre-signed URL from sign server`);
           } else {
-            console.log(`[TikTokLive] \u26A0\uFE0F ws_credentials bad response: ${JSON.stringify(credData).substring(0, 120)}`);
+            console.log(`[TikTokLive] \xE2\u0161\xA0\xEF\xB8\x8F ws_credentials bad response: ${JSON.stringify(credData).substring(0, 120)}`);
           }
         }
       } catch (e) {
-        console.log(`[TikTokLive] \u274C ws_credentials failed: ${e.message}`);
+        console.log(`[TikTokLive] \xE2\x9D\u0152 ws_credentials failed: ${e.message}`);
       }
       if (!ttwid) {
         console.log(`[TikTokLive] Fallback: direct TikTok fetch for ttwid...`);
@@ -697,9 +927,9 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
               break;
             }
           }
-          console.log(`[TikTokLive] Direct fetch ttwid: ${ttwid ? "\u2705" : "\u274C none"}`);
+          console.log(`[TikTokLive] Direct fetch ttwid: ${ttwid ? "\xE2\u0153\u2026" : "\xE2\x9D\u0152 none"}`);
         } catch (e) {
-          console.log(`[TikTokLive] \u274C Direct TikTok fetch failed: ${e.message}`);
+          console.log(`[TikTokLive] \xE2\x9D\u0152 Direct TikTok fetch failed: ${e.message}`);
         }
       }
     } else {
@@ -715,13 +945,13 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
           const roomData = await roomResp.json();
           if (roomData.status_code === 0 && roomData.data?.room_id) {
             roomId = roomData.data.room_id;
-            console.log(`[TikTokLive] \u2705 Got roomId from sign server: ${roomId}`);
+            console.log(`[TikTokLive] \xE2\u0153\u2026 Got roomId from sign server: ${roomId}`);
           } else {
-            console.log(`[TikTokLive] \u26A0\uFE0F room_id response: ${JSON.stringify(roomData).substring(0, 120)}`);
+            console.log(`[TikTokLive] \xE2\u0161\xA0\xEF\xB8\x8F room_id response: ${JSON.stringify(roomData).substring(0, 120)}`);
           }
         }
       } catch (e) {
-        console.log(`[TikTokLive] \u274C room_id request failed: ${e.message}`);
+        console.log(`[TikTokLive] \xE2\x9D\u0152 room_id request failed: ${e.message}`);
       }
       if (roomId) {
         try {
@@ -737,14 +967,14 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
               const m = credData.data.cookies.match(/ttwid=([^;]+)/);
               if (m) {
                 ttwid = m[1];
-                console.log(`[TikTokLive] \u2705 Got ttwid from sign server`);
-              } else console.log(`[TikTokLive] \u26A0\uFE0F No ttwid in cookies: ${credData.data.cookies.substring(0, 60)}`);
+                console.log(`[TikTokLive] \xE2\u0153\u2026 Got ttwid from sign server`);
+              } else console.log(`[TikTokLive] \xE2\u0161\xA0\xEF\xB8\x8F No ttwid in cookies: ${credData.data.cookies.substring(0, 60)}`);
             } else {
-              console.log(`[TikTokLive] \u26A0\uFE0F No cookies in ws_credentials: ${JSON.stringify(credData).substring(0, 120)}`);
+              console.log(`[TikTokLive] \xE2\u0161\xA0\xEF\xB8\x8F No cookies in ws_credentials: ${JSON.stringify(credData).substring(0, 120)}`);
             }
           }
         } catch (e) {
-          console.log(`[TikTokLive] \u274C ws_credentials failed: ${e.message}`);
+          console.log(`[TikTokLive] \xE2\x9D\u0152 ws_credentials failed: ${e.message}`);
         }
       }
       if (!roomId || !ttwid) {
@@ -781,7 +1011,7 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
           }
           console.log(`[TikTokLive] Direct fetch result: roomId=${roomId || "none"}, ttwid=${ttwid ? "yes" : "none"}`);
         } catch (e) {
-          console.log(`[TikTokLive] \u274C Direct TikTok fetch failed: ${e.message}`);
+          console.log(`[TikTokLive] \xE2\x9D\u0152 Direct TikTok fetch failed: ${e.message}`);
         }
       }
     }
@@ -867,18 +1097,21 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
         this.handleFrame(Buffer.from(rawData));
       });
       this.ws.on("close", (code, reason) => {
+        const wasConnected = this._connected;
         this._connected = false;
         this.stopHeartbeat();
         const reasonStr = reason?.toString() || "";
         this.emit("disconnected", code, reasonStr);
-        if (!this.intentionalClose && this.autoReconnect && this.reconnectAttempts < this.maxReconnectAttempts) {
+        if (wasConnected && !this.intentionalClose && this.autoReconnect && this.reconnectAttempts < this.maxReconnectAttempts) {
           this.reconnectAttempts++;
           const delay = Math.min(1e3 * Math.pow(2, this.reconnectAttempts - 1), 3e4);
           setTimeout(() => this.connect().catch((e) => this.emit("error", e)), delay);
         }
       });
       this.ws.on("error", (err) => {
-        this.emit("error", err);
+        if (this._connected) {
+          this.emit("error", err);
+        }
         if (!this._connected) reject(err);
       });
     });
@@ -895,7 +1128,7 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
   }
   /**
    * Fully destroy the client, releasing all resources and listeners.
-   * After calling destroy(), the instance cannot be reused — create a new one.
+   * After calling destroy(), the instance cannot be reused — create a new one.
    */
   destroy() {
     this.disconnect();
@@ -920,7 +1153,7 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
   /**
    * Get live stream video URLs for a TikTok user.
    * Returns FLV & HLS URLs segmented by quality (FULL_HD1, HD1, SD1, SD2).
-   * This is a standalone method — no WebSocket connection required.
+   * This is a standalone method — no WebSocket connection required.
    * 
    * @example
    * ```ts