@tiktool/live 2.6.7 → 2.7.0

package/dist/index.js

@@ -30,12 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  TikTokCaptions: () => TikTokCaptions,
-  TikTokLive: () => TikTokLive,
-  fetchFeed: () => fetchFeed,
-  getLiveFeed: () => getLiveFeed,
-  getRanklist: () => getRanklist,
-  getRegionalRanklist: () => getRegionalRanklist
+  TikTokLive: () => TikTokLive
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -44,94 +39,9 @@ var import_events = require("events");
 var http = __toESM(require("http"));
 var https = __toESM(require("https"));
 var zlib = __toESM(require("zlib"));
-var import_url = require("url");
 var import_ws = __toESM(require("ws"));
 
 // src/proto.ts
-var encoder = new TextEncoder();
-var decoder = new TextDecoder();
-var TIKTOK_EMOTE_MAP = {
-  // Standard emojis
-  "happy": "\u{1F60A}",
-  "angry": "\u{1F621}",
-  "cry": "\u{1F622}",
-  "embarrassed": "\u{1F633}",
-  "surprised": "\u{1F62E}",
-  "wronged": "\u{1F61E}",
-  "shout": "\u{1F624}",
-  "flushed": "\u{1F633}",
-  "yummy": "\u{1F60B}",
-  "complacent": "\u{1F60C}",
-  "drool": "\u{1F924}",
-  "scream": "\u{1F631}",
-  "weep": "\u{1F62D}",
-  "speechless": "\u{1F636}",
-  "funnyface": "\u{1F92A}",
-  "laughwithtears": "\u{1F602}",
-  "wicked": "\u{1F608}",
-  "facewithrollingeyes": "\u{1F644}",
-  "sulk": "\u{1F612}",
-  "thinking": "\u{1F914}",
-  "lovely": "\u{1F970}",
-  "greedy": "\u{1F911}",
-  "wow": "\u{1F62F}",
-  "joyful": "\u{1F603}",
-  "hehe": "\u{1F601}",
-  "slap": "\u{1F44B}",
-  "tears": "\u{1F63F}",
-  "stun": "\u{1F635}",
-  "cute": "\u{1F97A}",
-  "blink": "\u{1F609}",
-  "disdain": "\u{1F60F}",
-  "astonish": "\u{1F632}",
-  "cool": "\u{1F60E}",
-  "excited": "\u{1F929}",
-  "proud": "\u{1F624}",
-  "smileface": "\u{1F60A}",
-  "evil": "\u{1F47F}",
-  "angel": "\u{1F607}",
-  "laugh": "\u{1F606}",
-  "pride": "\u{1F981}",
-  "nap": "\u{1F634}",
-  "loveface": "\u{1F60D}",
-  "awkward": "\u{1F62C}",
-  "shock": "\u{1F628}",
-  "funny": "\u{1F604}",
-  "rage": "\u{1F92C}",
-  // Common aliases used in TikTok LIVE
-  "laughcry": "\u{1F602}",
-  "heart": "\u2764\uFE0F",
-  "like": "\u{1F44D}",
-  "love": "\u{1F495}",
-  "shy": "\u{1F648}",
-  "smile": "\u{1F60A}"
-};
-function replaceEmotes(text, imageMap) {
-  return text.replace(/\[([a-zA-Z_]+)\]/g, (match, name) => {
-    const lower = name.toLowerCase();
-    const emoji = TIKTOK_EMOTE_MAP[lower];
-    return emoji || match;
-  });
-}
-function concatBytes(...arrays) {
-  let totalLength = 0;
-  for (const arr of arrays) totalLength += arr.length;
-  const result = new Uint8Array(totalLength);
-  let offset = 0;
-  for (const arr of arrays) {
-    result.set(arr, offset);
-    offset += arr.length;
-  }
-  return result;
-}
-function readInt32LE(buf, offset) {
-  return buf[offset] | buf[offset + 1] << 8 | buf[offset + 2] << 16 | buf[offset + 3] << 24;
-}
-function readBigInt64LE(buf, offset) {
-  const lo = BigInt(buf[offset] | buf[offset + 1] << 8 | buf[offset + 2] << 16 | buf[offset + 3] << 24 >>> 0);
-  const hi = BigInt(buf[offset + 4] | buf[offset + 5] << 8 | buf[offset + 6] << 16 | buf[offset + 7] << 24 >>> 0);
-  return hi << 32n | lo & 0xFFFFFFFFn;
-}
 function decodeVarint(buf, offset) {
   let result = 0, shift = 0;
   while (offset < buf.length) {
@@ -161,15 +71,15 @@ function encodeVarint(v) {
     if (n > 0n) b |= 128;
     bytes.push(b);
   } while (n > 0n);
-  return new Uint8Array(bytes);
+  return Buffer.from(bytes);
 }
 function encodeField(fn, wt, value) {
   const tag = encodeVarint(fn << 3 | wt);
   if (wt === 0) {
-    return concatBytes(tag, encodeVarint(typeof value === "number" ? BigInt(value) : value));
+    return Buffer.concat([tag, encodeVarint(typeof value === "number" ? BigInt(value) : value)]);
   }
-  const data = typeof value === "string" ? encoder.encode(value) : value;
-  return concatBytes(tag, encodeVarint(data.length), data);
+  const data = typeof value === "string" ? Buffer.from(value) : value;
+  return Buffer.concat([tag, encodeVarint(data.length), data]);
 }
 function decodeProto(buf) {
   const fields = [];
@@ -190,10 +100,10 @@ function decodeProto(buf) {
       offset += lenR.value;
       fields.push({ fn, wt, value: data });
     } else if (wt === 1) {
-      fields.push({ fn, wt, value: readBigInt64LE(buf, offset) });
+      fields.push({ fn, wt, value: buf.readBigInt64LE(offset) });
       offset += 8;
     } else if (wt === 5) {
-      fields.push({ fn, wt, value: BigInt(readInt32LE(buf, offset)) });
+      fields.push({ fn, wt, value: BigInt(buf.readInt32LE(offset)) });
       offset += 4;
     } else {
       break;
@@ -203,7 +113,7 @@ function decodeProto(buf) {
 }
 function getStr(fields, fn) {
   const f = fields.find((x) => x.fn === fn && x.wt === 2);
-  return f ? decoder.decode(f.value) : "";
+  return f ? f.value.toString("utf-8") : "";
 }
 function getBytes(fields, fn) {
   const f = fields.find((x) => x.fn === fn && x.wt === 2);
@@ -215,47 +125,47 @@ function getInt(fields, fn) {
 }
 function getIntStr(fields, fn) {
   const f = fields.find((x) => x.fn === fn && x.wt === 0);
-  return f ? String(f.value) : "";
+  return f ? String(f.value) : "0";
 }
 function getAllBytes(fields, fn) {
   return fields.filter((x) => x.fn === fn && x.wt === 2).map((x) => x.value);
 }
 function buildHeartbeat(roomId) {
   const payload = encodeField(1, 0, BigInt(roomId));
-  return concatBytes(
+  return Buffer.concat([
     encodeField(6, 2, "pb"),
     encodeField(7, 2, "hb"),
     encodeField(8, 2, payload)
-  );
+  ]);
 }
 function buildImEnterRoom(roomId) {
-  const inner = concatBytes(
+  const inner = Buffer.concat([
     encodeField(1, 0, BigInt(roomId)),
     encodeField(4, 0, 12n),
     encodeField(5, 2, "audience"),
     encodeField(6, 2, ""),
     encodeField(9, 2, ""),
     encodeField(10, 2, "")
-  );
-  return concatBytes(
+  ]);
+  return Buffer.concat([
     encodeField(6, 2, "pb"),
     encodeField(7, 2, "im_enter_room"),
     encodeField(8, 2, inner)
-  );
+  ]);
 }
 function buildAck(id) {
-  return concatBytes(
+  return Buffer.concat([
     encodeField(2, 0, id),
     encodeField(6, 2, "pb"),
     encodeField(7, 2, "ack")
-  );
+  ]);
 }
 function looksLikeUsername(s) {
   return s.length > 0 && s.length <= 50 && !s.includes("://") && !s.includes("\0");
 }
 function parseUser(data) {
   const f = decodeProto(data);
-  const id = getIntStr(f, 1) || getStr(f, 1);
+  const id = getIntStr(f, 1) !== "0" ? getIntStr(f, 1) : getStr(f, 1);
   const nickname = getStr(f, 3) || getStr(f, 2);
   let uniqueId = "";
   const uid4 = getStr(f, 4);
@@ -277,7 +187,7 @@ function parseUser(data) {
       const avatarFields = decodeProto(avatarBuf);
       const urlBufs = getAllBytes(avatarFields, 1);
       for (const urlBuf of urlBufs) {
-        const url = decoder.decode(urlBuf);
+        const url = urlBuf.toString("utf-8");
         if (url.includes("://")) {
           profilePicture = url;
           break;
@@ -286,25 +196,44 @@ function parseUser(data) {
     } catch {
     }
   }
-  const badges = [];
-  let payGrade;
-  const badgeBufs = getAllBytes(f, 64);
-  for (const badgeBuf of badgeBufs) {
+  let avatarLargeUrl;
+  const largeBuf = getBytes(f, 11);
+  if (largeBuf) {
     try {
-      const badgeFields = decodeProto(badgeBuf);
-      const badgeCategory = getInt(badgeFields, 2);
-      const badgeSubCat = getInt(badgeFields, 3);
-      if (badgeCategory === 20 && badgeSubCat === 8 && !payGrade) {
-        const privBuf = getBytes(badgeFields, 12);
-        if (privBuf) {
-          const privFields = decodeProto(privBuf);
-          const levelStr = getStr(privFields, 5);
-          if (levelStr) {
-            const level = parseInt(levelStr, 10);
-            if (level > 0) payGrade = level;
+      const largeFields = decodeProto(largeBuf);
+      const urlBufs = getAllBytes(largeFields, 1);
+      for (const urlBuf of urlBufs) {
+        const url = urlBuf.toString("utf-8");
+        if (url.includes("://")) {
+          avatarLargeUrl = url;
+          break;
+        }
+      }
+    } catch {
+    }
+  }
+  if (!avatarLargeUrl) {
+    const medBuf = getBytes(f, 10);
+    if (medBuf) {
+      try {
+        const medFields = decodeProto(medBuf);
+        const urlBufs = getAllBytes(medFields, 1);
+        for (const urlBuf of urlBufs) {
+          const url = urlBuf.toString("utf-8");
+          if (url.includes("://")) {
+            avatarLargeUrl = url;
+            break;
           }
         }
+      } catch {
       }
+    }
+  }
+  const badges = [];
+  const badgeBuf = getBytes(f, 64);
+  if (badgeBuf) {
+    try {
+      const badgeFields = decodeProto(badgeBuf);
       const badgeItems = getAllBytes(badgeFields, 21);
       for (const bi of badgeItems) {
         const bf = decodeProto(bi);
@@ -318,17 +247,16 @@ function parseUser(data) {
     id,
     nickname,
     uniqueId: uniqueId || nickname || id,
-    profilePictureUrl: profilePicture,
-    badges: badges.length > 0 ? badges : void 0,
-    payGrade
+    profilePicture,
+    avatarLargeUrl,
+    badges: badges.length > 0 ? badges : void 0
   };
 }
 function parseBattleTeamFromArmies(itemBuf) {
   const f = decodeProto(itemBuf);
-  const hostUserId = getIntStr(f, 1) || "0";
+  const hostUserId = getIntStr(f, 1);
   let teamScore = 0;
   const users = [];
-  let hostUser;
   const groups = getAllBytes(f, 2);
   for (const gb of groups) {
     try {
@@ -338,29 +266,15 @@ function parseBattleTeamFromArmies(itemBuf) {
       const userBufs = getAllBytes(gf, 1);
       for (const ub of userBufs) {
         try {
-          const userFields = decodeProto(ub);
-          const individualScore = getInt(userFields, 2);
           const user = parseUser(ub);
-          users.push({ user, score: individualScore });
+          users.push({ user, score: points });
         } catch {
         }
       }
     } catch {
     }
   }
-  for (const fieldNum of [3, 4, 5, 6, 7, 8]) {
-    if (hostUser) break;
-    const buf = getBytes(f, fieldNum);
-    if (!buf) continue;
-    try {
-      const parsed = parseUser(buf);
-      if (parsed && (parsed.nickname || parsed.uniqueId) && parsed.uniqueId !== parsed.id && looksLikeUsername(parsed.uniqueId || "")) {
-        hostUser = parsed;
-      }
-    } catch {
-    }
-  }
-  return { hostUserId, score: teamScore, users, hostUser };
+  return { hostUserId, score: teamScore, users };
 }
 function parseWebcastMessage(method, payload) {
   const f = decodeProto(payload);
@@ -375,29 +289,42 @@ function parseWebcastMessage(method, payload) {
     }
   }
   switch (method) {
+    // Proto: WebcastChatMessage { MessageType type=1, User user=2, string comment=3, ..., repeated WebcastSubEmote emotes=12 }
+    // WebcastSubEmote { int32 placeInComment=1, EmoteDetails emote=2 }
+    // EmoteDetails { string emoteId=1, EmoteImage image=2 }
+    // EmoteImage { string imageUrl=1 }
     case "WebcastChatMessage": {
       const userBuf = getBytes(f, 2);
       const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
-      const rawComment = getStr(f, 3);
-      const emoteImages = {};
-      for (const field of f) {
-        if (field.fn === 22 && field.wt === 2) {
-          try {
-            const ewi = decodeProto(field.value);
-            const emoteKey = getStr(ewi, 1);
-            const imgBuf = getBytes(ewi, 2);
-            if (imgBuf && emoteKey) {
-              const imgFields = decodeProto(imgBuf);
-              const url = getStr(imgFields, 1);
-              if (url) emoteImages[emoteKey] = url;
+      const comment = getStr(f, 3);
+      const emotes = [];
+      const emoteBufs12 = getAllBytes(f, 12);
+      const emoteBufs13 = getAllBytes(f, 13);
+      const emoteBufs = emoteBufs13.length > 0 ? emoteBufs13 : emoteBufs12;
+      for (const eb of emoteBufs) {
+        try {
+          const ef = decodeProto(eb);
+          const placeInComment = getInt(ef, 1);
+          const detailBuf = getBytes(ef, 2);
+          if (detailBuf) {
+            const df = decodeProto(detailBuf);
+            const emoteId = getStr(df, 1);
+            let imageUrl = "";
+            const imgBuf = getBytes(df, 2);
+            if (imgBuf) {
+              const imgf = decodeProto(imgBuf);
+              imageUrl = getStr(imgf, 1);
+            }
+            if (emoteId) {
+              emotes.push({ emoteId, imageUrl, placeInComment });
             }
-          } catch {
           }
+        } catch {
         }
       }
-      const comment = replaceEmotes(rawComment, emoteImages);
-      return { ...base, type: "chat", user, comment };
+      return { ...base, type: "chat", user, comment, emotes };
     }
+    // Proto: WebcastMemberMessage { User user=2, WebcastMessageEvent event=1 }
     case "WebcastMemberMessage": {
       const userBuf = getBytes(f, 2);
       const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
@@ -415,6 +342,7 @@ function parseWebcastMessage(method, payload) {
       }
       return { ...base, type: "member", user, action };
     }
+    // Proto: WebcastLikeMessage { User user=5, WebcastMessageEvent event=1, int32 likeCount=2, int32 totalLikeCount=3 }
     case "WebcastLikeMessage": {
       const userBuf = getBytes(f, 5);
       const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
@@ -426,6 +354,13 @@ function parseWebcastMessage(method, payload) {
         totalLikes: getInt(f, 3)
       };
     }
+    // Proto: WebcastGiftMessage {
+    //   User user=7, int32 giftId=2, int32 repeatCount=5, int32 repeatEnd=9,
+    //   GiftDetails giftDetails=15, GiftExtra giftExtra=23
+    // }
+    // GiftDetails { GiftImage giftImage=1, string giftName=16, string describe=2,
+    //               int32 giftType=11, int32 diamondCount=12 }
+    // GiftExtra { uint64 timestamp=6, uint64 toUserId=8 }
     case "WebcastGiftMessage": {
       const userBuf = getBytes(f, 7);
       const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
@@ -450,7 +385,7 @@ function parseWebcastMessage(method, payload) {
       const extraBuf = getBytes(f, 23);
       if (extraBuf) {
         const ef = decodeProto(extraBuf);
-        toUserId = getIntStr(ef, 8) || "";
+        toUserId = String(getInt(ef, 8));
       }
       const groupId = toUserId || getStr(f, 11);
       return {
@@ -464,10 +399,10 @@ function parseWebcastMessage(method, payload) {
         repeatEnd,
         combo: repeatCount > 1 && !repeatEnd,
         giftType,
-        groupId,
-        giftPictureUrl: giftImageUrl
+        groupId
       };
     }
+    // Proto: WebcastSocialMessage { User user=2, WebcastMessageEvent event=1 }
     case "WebcastSocialMessage": {
       const userBuf = getBytes(f, 2);
       const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
@@ -487,42 +422,19 @@ function parseWebcastMessage(method, payload) {
       }
       return { ...base, type: "social", user, action };
     }
+    // Proto: WebcastRoomUserSeqMessage { int32 viewerCount=3 }
     case "WebcastRoomUserSeqMessage": {
       const viewerCount = getInt(f, 3) || getInt(f, 2);
       const totalViewers = getInt(f, 1) || viewerCount;
       return { ...base, type: "roomUserSeq", totalViewers, viewerCount };
     }
+    // Proto: WebcastLinkMicBattle { repeated WebcastLinkMicBattleItems battleUsers=10 }
+    //   battleUsers → { battleGroup=2 → { LinkUser user=1 } }
     case "WebcastLinkMicBattle": {
-      const battleId = getIntStr(f, 2) || getIntStr(f, 1) || "";
-      const overallStatus = getInt(f, 4);
+      const battleId = String(getInt(f, 1) || "");
+      const status = getInt(f, 2) || 1;
+      const battleDuration = getInt(f, 3);
       const teams = [];
-      let battleDuration = 0;
-      let battleSettings;
-      const settingsBuf = getBytes(f, 3);
-      if (settingsBuf) {
-        try {
-          const sf = decodeProto(settingsBuf);
-          const startTimeMs = getInt(sf, 2);
-          const duration = getInt(sf, 3);
-          const phase = getInt(sf, 5);
-          const endTimeMs = getInt(sf, 10);
-          battleDuration = duration;
-          battleSettings = {
-            startTimeMs: startTimeMs || void 0,
-            duration: duration || void 0,
-            endTimeMs: endTimeMs || void 0
-          };
-        } catch {
-        }
-      }
-      const settingsPhase = settingsBuf ? (() => {
-        try {
-          return getInt(decodeProto(settingsBuf), 5);
-        } catch {
-          return 0;
-        }
-      })() : 0;
-      const status = settingsPhase || (overallStatus > 0 && overallStatus <= 10 ? overallStatus : 0) || 1;
       const battleUserBufs = getAllBytes(f, 10);
       for (const bub of battleUserBufs) {
         try {
@@ -543,23 +455,6 @@ function parseWebcastMessage(method, payload) {
         } catch {
         }
       }
-      if (teams.length === 0) {
-        const teamBufs5 = getAllBytes(f, 5);
-        for (const tb of teamBufs5) {
-          try {
-            const tf = decodeProto(tb);
-            const userId = getIntStr(tf, 1);
-            if (userId && userId !== "0") {
-              teams.push({
-                hostUserId: userId,
-                score: 0,
-                users: []
-              });
-            }
-          } catch {
-          }
-        }
-      }
       if (teams.length === 0) {
         const teamBufs7 = getAllBytes(f, 7);
         for (const tb of teamBufs7) {
@@ -569,48 +464,51 @@ function parseWebcastMessage(method, payload) {
           }
         }
       }
-      return { ...base, type: "battle", battleId, status, battleDuration, teams, battleSettings };
+      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 }
     case "WebcastLinkMicArmies": {
-      const battleId = getIntStr(f, 2) || getIntStr(f, 1) || "";
+      const battleId = getStr(f, 17) || String(getInt(f, 2) || "");
       const battleStatus = getInt(f, 7);
       const teams = [];
-      let battleSettings;
-      const settingsBuf18 = getBytes(f, 18);
-      if (settingsBuf18) {
+      const itemBufs = getAllBytes(f, 3);
+      for (const ib of itemBufs) {
         try {
-          const sf = decodeProto(settingsBuf18);
-          const startTimeMs = getInt(sf, 2);
-          const duration = getInt(sf, 3);
-          const endTimeMs = getInt(sf, 10);
-          battleSettings = {
-            startTimeMs: startTimeMs || void 0,
-            duration: duration || void 0,
-            endTimeMs: endTimeMs || void 0
-          };
+          teams.push(parseBattleTeamFromArmies(ib));
         } catch {
         }
       }
-      const scoreUpdateTime = getInt(f, 5);
-      const giftSentTime = getInt(f, 6);
-      const itemBufs = getAllBytes(f, 3);
-      for (const ib of itemBufs) {
+      let battleStartMs = 0;
+      let battleDurationSeconds = 0;
+      const configBuf = getBytes(f, 18);
+      if (configBuf) {
         try {
-          teams.push(parseBattleTeamFromArmies(ib));
+          const cf = decodeProto(configBuf);
+          battleStartMs = getInt(cf, 2);
+          battleDurationSeconds = getInt(cf, 3);
         } catch {
         }
       }
+      let timeLeftSeconds = 0;
+      if (battleStartMs > 0 && battleDurationSeconds > 0) {
+        const elapsedMs = Date.now() - battleStartMs;
+        timeLeftSeconds = Math.max(0, battleDurationSeconds - Math.floor(elapsedMs / 1e3));
+      }
       return {
         ...base,
         type: "battleArmies",
         battleId,
         teams,
         status: battleStatus,
-        battleSettings,
-        scoreUpdateTime,
-        giftSentTime
+        battleStartMs,
+        battleDurationSeconds,
+        timeLeftSeconds
       };
     }
+    // Proto: WebcastSubNotifyMessage { User user=2, ... subMonth=3 }
     case "WebcastSubNotifyMessage": {
       const userBuf = getBytes(f, 2);
       const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
@@ -636,6 +534,8 @@ function parseWebcastMessage(method, payload) {
       const envelopeId = String(getInt(f, 1) || getStr(f, 1));
       return { ...base, type: "envelope", envelopeId, diamondCount: getInt(f, 3) };
     }
+    // Proto: WebcastQuestionNewMessage { MessageType type=1, QuestionDetails questionDetails=2 }
+    //   QuestionDetails { string questionText=2, User user=5 }
     case "WebcastQuestionNewMessage": {
       let questionText = "", user = { id: "0", nickname: "", uniqueId: "" };
       const detailBuf = getBytes(f, 2);
@@ -665,17 +565,20 @@ function parseWebcastMessage(method, payload) {
       }
       return { ...base, type: "rankUpdate", rankType, rankList };
     }
+    // Proto: WebcastControlMessage { int32 action=2 }
     case "WebcastControlMessage":
       return { ...base, type: "control", action: getInt(f, 2) || getInt(f, 1) };
     case "WebcastRoomMessage":
     case "RoomMessage":
       return { ...base, type: "room", status: getInt(f, 2) };
+    // Proto: WebcastLiveIntroMessage { uint64 id=2, string description=4, User user=5 }
     case "WebcastLiveIntroMessage": {
       const roomId = String(getInt(f, 2));
       const title = getStr(f, 4) || getStr(f, 2);
       return { ...base, type: "liveIntro", roomId, title };
     }
-    case "WebcastLinkMicMethod": {
+    case "WebcastLinkMicMethod":
+    case "WebcastLinkmicBattleTaskMessage": {
       const action = getStr(f, 1) || `action_${getInt(f, 1)}`;
       const users = [];
       const userBufs = getAllBytes(f, 2);
@@ -687,152 +590,6 @@ function parseWebcastMessage(method, payload) {
       }
       return { ...base, type: "linkMic", action, users };
     }
-    case "WebcastLinkmicBattleTaskMessage": {
-      const taskAction = getInt(f, 2);
-      const battleRefId = getIntStr(f, 20) || "";
-      let timerType = 0;
-      let remainingSeconds = 0;
-      let endTimestampS = 0;
-      const timerBuf = getBytes(f, 5);
-      if (timerBuf) {
-        try {
-          const tf = decodeProto(timerBuf);
-          timerType = getInt(tf, 1);
-          remainingSeconds = getInt(tf, 2);
-          endTimestampS = getInt(tf, 3);
-        } catch {
-        }
-      }
-      let multiplier = 0;
-      let missionDuration = 0;
-      let missionTarget = 0;
-      let missionType = "";
-      const bonusBuf = getBytes(f, 3);
-      if (bonusBuf) {
-        try {
-          const bf = decodeProto(bonusBuf);
-          const missionBuf = getBytes(bf, 1);
-          if (missionBuf) {
-            const mf = decodeProto(missionBuf);
-            missionTarget = getInt(mf, 1);
-            const items = getAllBytes(mf, 2);
-            for (const item of items) {
-              try {
-                const itemFields = decodeProto(item);
-                const descBuf = getBytes(itemFields, 2);
-                if (descBuf) {
-                  const descFields = decodeProto(descBuf);
-                  const paramBufs = getAllBytes(descFields, 2);
-                  for (const pb of paramBufs) {
-                    try {
-                      const pf = decodeProto(pb);
-                      const key = getStr(pf, 1);
-                      const val = getStr(pf, 2);
-                      if (key === "multi" && val) multiplier = parseInt(val) || 0;
-                      if (key === "dur" && val) missionDuration = parseInt(val) || 0;
-                      if (key === "sum" && val) missionTarget = parseInt(val) || missionTarget;
-                    } catch {
-                    }
-                  }
-                  const typeStr = getStr(descFields, 1);
-                  if (typeStr) missionType = typeStr;
-                }
-              } catch {
-              }
-            }
-            const countdownBuf = getBytes(mf, 3);
-            if (countdownBuf) {
-              try {
-                const cf = decodeProto(countdownBuf);
-                if (!missionDuration) missionDuration = getInt(cf, 2);
-              } catch {
-              }
-            }
-          }
-        } catch {
-        }
-      }
-      if (!missionType) {
-        const descBuf6 = getBytes(f, 6);
-        if (descBuf6) {
-          try {
-            const d6 = decodeProto(descBuf6);
-            const innerBuf = getBytes(d6, 1);
-            if (innerBuf) {
-              const innerF = decodeProto(innerBuf);
-              const typeStr = getStr(innerF, 1);
-              if (typeStr) missionType = typeStr;
-              const paramBufs = getAllBytes(innerF, 2);
-              for (const pb of paramBufs) {
-                try {
-                  const pf = decodeProto(pb);
-                  const key = getStr(pf, 1);
-                  const val = getStr(pf, 2);
-                  if (key === "multi" && val) multiplier = parseInt(val) || 0;
-                  if (key === "sum" && val) missionTarget = parseInt(val) || missionTarget;
-                } catch {
-                }
-              }
-            }
-          } catch {
-          }
-        }
-      }
-      return {
-        ...base,
-        type: "battleTask",
-        taskAction,
-        battleRefId,
-        missionType,
-        multiplier,
-        missionDuration,
-        missionTarget,
-        remainingSeconds,
-        endTimestampS,
-        timerType
-      };
-    }
-    case "WebcastBarrageMessage": {
-      const msgType = getInt(f, 3);
-      const duration = getInt(f, 4);
-      const displayType = getInt(f, 5);
-      const subType = getInt(f, 6);
-      let defaultPattern = "";
-      let content = "";
-      const contentBuf = getBytes(f, 2);
-      if (contentBuf) {
-        try {
-          const cf = decodeProto(contentBuf);
-          defaultPattern = getStr(cf, 1) || "";
-          const paramBufs = getAllBytes(cf, 2);
-          const params = [];
-          for (const pb of paramBufs) {
-            try {
-              const pf = decodeProto(pb);
-              const key = getStr(pf, 1);
-              const val = getStr(pf, 2);
-              if (key && val) params.push(`${key}=${val}`);
-            } catch {
-            }
-          }
-          if (params.length > 0) content = params.join(", ");
-        } catch {
-        }
-      }
-      if (!defaultPattern) {
-        defaultPattern = getStr(f, 1) || "";
-      }
-      return {
-        ...base,
-        type: "barrage",
-        msgType,
-        subType,
-        displayType,
-        duration,
-        defaultPattern,
-        content
-      };
-    }
     default:
       return { ...base, type: "unknown", method };
   }
@@ -857,12 +614,10 @@ function parseWebcastResponse(payload) {
 // src/client.ts
 var DEFAULT_UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
 var DEFAULT_SIGN_SERVER = "https://api.tik.tools";
-function httpGet(url, headers, agent) {
+function httpGet(url, headers) {
   return new Promise((resolve, reject) => {
     const mod = url.startsWith("https") ? https : http;
-    const opts = { headers, agent };
-    const parsed = new import_url.URL(url);
-    const req = mod.get(parsed, opts, (res) => {
+    const req = mod.get(url, { headers }, (res) => {
       const chunks = [];
       const enc = res.headers["content-encoding"];
       const stream = enc === "gzip" || enc === "br" ? res.pipe(enc === "br" ? zlib.createBrotliDecompress() : zlib.createGunzip()) : res;
@@ -888,15 +643,21 @@ function getWsHost(clusterRegion) {
   if (r.startsWith("us") || r.includes("us")) return "webcast-ws.us.tiktok.com";
   return "webcast-ws.tiktok.com";
 }
-var TikTokLive = class extends import_events.EventEmitter {
+var TikTokLive = class _TikTokLive extends import_events.EventEmitter {
   ws = null;
   heartbeatTimer = null;
   reconnectAttempts = 0;
   intentionalClose = false;
   _connected = false;
+  _destroyed = false;
   _eventCount = 0;
   _roomId = "";
-  _ownerUserId = "";
+  // Cache host identities from battle events for enriching battleArmies
+  // Bounded to MAX_BATTLE_HOSTS entries to prevent unbounded memory growth
+  static MAX_BATTLE_HOSTS = 50;
+  _battleHosts = /* @__PURE__ */ new Map();
+  // Track in-flight host resolution requests to avoid duplicate API calls
+  _pendingHostResolves = /* @__PURE__ */ new Set();
   uniqueId;
   signServerUrl;
   apiKey;
@@ -904,13 +665,11 @@ var TikTokLive = class extends import_events.EventEmitter {
   maxReconnectAttempts;
   heartbeatInterval;
   debug;
-  _sessionId;
-  _ttTargetIdc;
-  proxyAgent;
   _presetRoomId;
-  _presetTtwid;
+  _presetSessionId;
   constructor(options) {
     super();
+    this.setMaxListeners(20);
     this.uniqueId = options.uniqueId.replace(/^@/, "");
     this.signServerUrl = (options.signServerUrl || DEFAULT_SIGN_SERVER).replace(/\/$/, "");
     if (!options.apiKey) throw new Error("apiKey is required. Get a free key at https://tik.tools");
@@ -919,35 +678,60 @@ var TikTokLive = class extends import_events.EventEmitter {
     this.maxReconnectAttempts = options.maxReconnectAttempts ?? 5;
     this.heartbeatInterval = options.heartbeatInterval ?? 1e4;
     this.debug = options.debug ?? false;
-    this._sessionId = options.sessionId;
-    this._ttTargetIdc = options.ttTargetIdc;
-    if (options.agent) {
-      this.proxyAgent = options.agent;
-    }
-    this._presetRoomId = options.roomId;
-    this._presetTtwid = options.ttwid;
+    this._presetRoomId = options.roomId || "";
+    this._presetSessionId = options.sessionId || "";
   }
   async connect() {
+    if (this._destroyed) throw new Error("Client has been destroyed. Create a new instance.");
     this.intentionalClose = false;
-    let ttwid = this._presetTtwid || "";
-    let roomId = this._presetRoomId || "";
-    let ownerUserId = "";
+    let ttwid = this._presetSessionId;
+    let roomId = this._presetRoomId;
     let clusterRegion = "";
-    if (!roomId || !ttwid) {
-      const targetUrl = `https://www.tiktok.com/@${this.uniqueId}/live`;
-      const resp = await httpGet(targetUrl, {
+    if (roomId && ttwid) {
+    } else if (roomId && !ttwid) {
+      try {
+        const credResp = await fetch(`${this.signServerUrl}/webcast/ws_credentials`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json", "x-api-key": this.apiKey },
+          body: JSON.stringify({ unique_id: this.uniqueId, room_id: roomId })
+        });
+        if (credResp.ok) {
+          const credData = await credResp.json();
+          if (credData.data?.cookies) {
+            const m = credData.data.cookies.match(/ttwid=([^;]+)/);
+            if (m) ttwid = m[1];
+          }
+        }
+      } catch {
+      }
+      if (!ttwid) {
+        try {
+          const resp = await httpGet(`https://www.tiktok.com/@${this.uniqueId}/live`, {
+            "User-Agent": DEFAULT_UA,
+            "Accept": "text/html"
+          });
+          for (const sc of [resp.headers["set-cookie"] || []].flat()) {
+            if (typeof sc === "string" && sc.startsWith("ttwid=")) {
+              ttwid = sc.split(";")[0].split("=").slice(1).join("=");
+              break;
+            }
+          }
+        } catch {
+        }
+      }
+    } else {
+      const resp = await httpGet(`https://www.tiktok.com/@${this.uniqueId}/live`, {
         "User-Agent": DEFAULT_UA,
         "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
         "Accept-Encoding": "gzip, deflate, br",
         "Accept-Language": "en-US,en;q=0.9"
-      }, this.proxyAgent);
+      });
       for (const sc of [resp.headers["set-cookie"] || []].flat()) {
         if (typeof sc === "string" && sc.startsWith("ttwid=")) {
           ttwid = sc.split(";")[0].split("=").slice(1).join("=");
           break;
         }
       }
-      if (!ttwid) throw new Error("Failed to obtain session cookie");
       const html = resp.body.toString();
       const sigiMatch = html.match(/id="SIGI_STATE"[^>]*>([^<]+)/);
       if (sigiMatch) {
@@ -956,19 +740,15 @@ var TikTokLive = class extends import_events.EventEmitter {
           const jsonStr = JSON.stringify(json);
           const m = jsonStr.match(/"roomId"\s*:\s*"(\d+)"/);
           if (m) roomId = m[1];
-          const ownerUser = json?.LiveRoom?.liveRoomUserInfo?.user;
-          if (ownerUser?.id) {
-            ownerUserId = String(ownerUser.id);
-          }
         } catch {
         }
       }
-      if (!roomId) throw new Error(`User @${this.uniqueId} is not currently live`);
       const crMatch = html.match(/"clusterRegion"\s*:\s*"([^"]+)"/);
       clusterRegion = crMatch ? crMatch[1] : "";
     }
+    if (!ttwid) throw new Error("Failed to obtain session cookie");
+    if (!roomId) throw new Error(`User @${this.uniqueId} is not currently live`);
     this._roomId = roomId;
-    this._ownerUserId = ownerUserId;
     const wsHost = getWsHost(clusterRegion);
     const wsParams = new URLSearchParams({
       version_code: "270000",
@@ -1022,21 +802,12 @@ var TikTokLive = class extends import_events.EventEmitter {
       wsUrl = rawWsUrl.replace(/^https:\/\//, "wss://");
     }
     return new Promise((resolve, reject) => {
-      let cookieHeader = ttwid ? `ttwid=${ttwid}` : "";
-      if (this._sessionId) {
-        const sessionCookies = `sessionid=${this._sessionId}; sessionid_ss=${this._sessionId}; sid_tt=${this._sessionId}`;
-        cookieHeader = cookieHeader ? `${cookieHeader}; ${sessionCookies}` : sessionCookies;
-        if (this._ttTargetIdc) {
-          cookieHeader += `; tt-target-idc=${this._ttTargetIdc}`;
-        }
-      }
       this.ws = new import_ws.default(wsUrl, {
         headers: {
           "User-Agent": DEFAULT_UA,
-          "Cookie": cookieHeader,
+          "Cookie": `ttwid=${ttwid}`,
           "Origin": "https://www.tiktok.com"
-        },
-        agent: this.proxyAgent
+        }
       });
       this.ws.on("open", () => {
         this._connected = true;
@@ -1048,8 +819,7 @@ var TikTokLive = class extends import_events.EventEmitter {
           roomId,
           wsHost,
           clusterRegion,
-          connectedAt: (/* @__PURE__ */ new Date()).toISOString(),
-          ownerUserId: ownerUserId || void 0
+          connectedAt: (/* @__PURE__ */ new Date()).toISOString()
         };
         this.emit("connected");
         this.emit("roomInfo", roomInfo);
@@ -1079,42 +849,76 @@ var TikTokLive = class extends import_events.EventEmitter {
     this.intentionalClose = true;
     this.stopHeartbeat();
     if (this.ws) {
+      this.ws.removeAllListeners();
       this.ws.close(1e3);
       this.ws = null;
     }
     this._connected = false;
   }
+  /**
+   * Fully destroy the client, releasing all resources and listeners.
+   * After calling destroy(), the instance cannot be reused — create a new one.
+   */
+  destroy() {
+    this.disconnect();
+    this._destroyed = true;
+    this._battleHosts.clear();
+    this._eventCount = 0;
+    this._roomId = "";
+    this.removeAllListeners();
+  }
   get connected() {
     return this._connected;
   }
+  get destroyed() {
+    return this._destroyed;
+  }
   get eventCount() {
     return this._eventCount;
   }
   get roomId() {
     return this._roomId;
   }
-  /** Get the stored session ID (if any) */
-  get sessionId() {
-    return this._sessionId;
-  }
-  /** Update the session ID at runtime (e.g. after TikTok login) */
-  setSession(sessionId, ttTargetIdc) {
-    this._sessionId = sessionId;
-    if (ttTargetIdc) this._ttTargetIdc = ttTargetIdc;
-  }
   /**
-   * Build a cookie header string for authenticated API requests (e.g. ranklist).
-   * Returns undefined if no session is set.
+   * 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.
+   * 
+   * @example
+   * ```ts
+   * const stream = await TikTokLive.getStreamUrl({
+   *   uniqueId: 'username',
+   *   apiKey: 'your-api-key',
+   * });
+   * if (stream.alive) {
+   *   console.log(stream.streamUrls.HD1?.hls); // HLS URL for HD quality
+   *   console.log(stream.flvPullUrl);           // Best FLV URL
+   * }
+   * ```
    */
-  buildSessionCookieHeader() {
-    if (!this._sessionId) return void 0;
-    const parts = [
-      `sessionid=${this._sessionId}`,
-      `sessionid_ss=${this._sessionId}`,
-      `sid_tt=${this._sessionId}`
-    ];
-    if (this._ttTargetIdc) parts.push(`tt-target-idc=${this._ttTargetIdc}`);
-    return parts.join("; ");
+  static async getStreamUrl(options) {
+    const serverUrl = (options.signServerUrl || DEFAULT_SIGN_SERVER).replace(/\/$/, "");
+    const resp = await fetch(`${serverUrl}/webcast/room_video`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": options.apiKey
+      },
+      body: JSON.stringify({ unique_id: options.uniqueId.replace(/^@/, "") })
+    });
+    const data = await resp.json();
+    if (data.status_code !== 0) {
+      throw new Error(data.error || "Failed to get stream URL");
+    }
+    const d = data.data;
+    return {
+      roomId: d.room_id,
+      alive: d.alive ?? false,
+      streamUrls: d.stream_urls || {},
+      defaultQuality: d.default_quality || "",
+      flvPullUrl: d.flv_pull_url || void 0,
+      hlsPullUrl: d.hls_pull_url || void 0
+    };
   }
   on(event, listener) {
     return super.on(event, listener);
@@ -1149,567 +953,120 @@ var TikTokLive = class extends import_events.EventEmitter {
         const events = parseWebcastResponse(inner);
         for (const evt of events) {
           this._eventCount++;
-          this.emit("event", evt);
-          this.emit(evt.type, evt);
-        }
-      }
-    } catch {
-    }
-  }
-  startHeartbeat(roomId) {
-    this.stopHeartbeat();
-    this.heartbeatTimer = setInterval(() => {
-      if (this.ws?.readyState === import_ws.default.OPEN) {
-        this.ws.send(buildHeartbeat(roomId));
-      }
-    }, this.heartbeatInterval);
-  }
-  stopHeartbeat() {
-    if (this.heartbeatTimer) {
-      clearInterval(this.heartbeatTimer);
-      this.heartbeatTimer = null;
-    }
-  }
-};
-
-// src/captions.ts
-var import_events2 = require("events");
-var import_ws2 = __toESM(require("ws"));
-var FLV_TAG_AUDIO = 8;
-var FLV_HEADER_SIZE = 9;
-var FLV_PREV_TAG_SIZE = 4;
-var FlvAudioExtractor = class {
-  buffer = new Uint8Array(0);
-  headerParsed = false;
-  onAudio;
-  aacProfile = 2;
-  sampleRateIndex = 4;
-  channelConfig = 2;
-  ascParsed = false;
-  constructor(onAudio) {
-    this.onAudio = onAudio;
-  }
-  parseASC(asc) {
-    if (asc.length < 2) return;
-    this.aacProfile = asc[0] >> 3 & 31;
-    this.sampleRateIndex = (asc[0] & 7) << 1 | asc[1] >> 7 & 1;
-    this.channelConfig = asc[1] >> 3 & 15;
-    this.ascParsed = true;
-  }
-  buildAdtsHeader(frameLength) {
-    const adts = new Uint8Array(7);
-    const fullLength = frameLength + 7;
-    const profile = this.aacProfile - 1;
-    adts[0] = 255;
-    adts[1] = 241;
-    adts[2] = (profile & 3) << 6 | (this.sampleRateIndex & 15) << 2 | this.channelConfig >> 2 & 1;
-    adts[3] = (this.channelConfig & 3) << 6 | fullLength >> 11 & 3;
-    adts[4] = fullLength >> 3 & 255;
-    adts[5] = (fullLength & 7) << 5 | 31;
-    adts[6] = 252;
-    return adts;
-  }
-  push(chunk) {
-    const newBuf = new Uint8Array(this.buffer.length + chunk.length);
-    newBuf.set(this.buffer, 0);
-    newBuf.set(chunk, this.buffer.length);
-    this.buffer = newBuf;
-    if (!this.headerParsed) {
-      if (this.buffer.length < FLV_HEADER_SIZE + FLV_PREV_TAG_SIZE) return;
-      if (this.buffer[0] !== 70 || this.buffer[1] !== 76 || this.buffer[2] !== 86) return;
-      const dv = new DataView(this.buffer.buffer, this.buffer.byteOffset, this.buffer.byteLength);
-      const dataOffset = dv.getUint32(5);
-      this.buffer = this.buffer.subarray(dataOffset + FLV_PREV_TAG_SIZE);
-      this.headerParsed = true;
-    }
-    while (this.buffer.length >= 11) {
-      const tagType = this.buffer[0] & 31;
-      const dataSize = this.buffer[1] << 16 | this.buffer[2] << 8 | this.buffer[3];
-      const totalTagSize = 11 + dataSize + FLV_PREV_TAG_SIZE;
-      if (this.buffer.length < totalTagSize) break;
-      if (tagType === FLV_TAG_AUDIO) {
-        const audioData = this.buffer.subarray(11, 11 + dataSize);
-        if (audioData.length > 0) {
-          const soundFormat = audioData[0] >> 4 & 15;
-          if (soundFormat === 10 && audioData.length > 2) {
-            const aacPacketType = audioData[1];
-            if (aacPacketType === 0) {
-              this.parseASC(audioData.subarray(2));
-            } else if (aacPacketType === 1 && this.ascParsed) {
-              const rawFrame = audioData.subarray(2);
-              const adtsHeader = this.buildAdtsHeader(rawFrame.length);
-              const adtsFrame = new Uint8Array(adtsHeader.length + rawFrame.length);
-              adtsFrame.set(adtsHeader, 0);
-              adtsFrame.set(rawFrame, adtsHeader.length);
-              this.onAudio(adtsFrame);
+          if (evt.type === "battle") {
+            for (const team of evt.teams) {
+              const host = team.users.find((u) => u.user.id === team.hostUserId);
+              if (host) {
+                this._battleHosts.set(team.hostUserId, host.user);
+                team.hostUser = host.user;
+              }
+            }
+            if (this._battleHosts.size > _TikTokLive.MAX_BATTLE_HOSTS) {
+              const excess = this._battleHosts.size - _TikTokLive.MAX_BATTLE_HOSTS;
+              const keys = [...this._battleHosts.keys()].slice(0, excess);
+              for (const key of keys) this._battleHosts.delete(key);
             }
           }
-        }
-      }
-      this.buffer = this.buffer.subarray(totalTagSize);
-    }
-  }
-  reset() {
-    this.buffer = new Uint8Array(0);
-    this.headerParsed = false;
-    this.ascParsed = false;
-  }
-};
-var DEFAULT_CAPTIONS_SERVER = "wss://api.tik.tools";
-var TikTokCaptions = class extends import_events2.EventEmitter {
-  ws = null;
-  _connected = false;
-  intentionalClose = false;
-  reconnectAttempts = 0;
-  uniqueId;
-  apiKey;
-  serverUrl;
-  autoReconnect;
-  maxReconnectAttempts;
-  debug;
-  _translate;
-  _diarization;
-  _maxDurationMinutes;
-  _language;
-  streamAbortController = null;
-  flvExtractor = null;
-  streamUrl = null;
-  constructor(options) {
-    super();
-    this.uniqueId = options.uniqueId.replace(/^@/, "");
-    if (!options.apiKey) throw new Error("apiKey is required. Get a free key at https://tik.tools");
-    this.apiKey = options.apiKey;
-    this._language = options.language || "";
-    this._translate = options.translate || "";
-    this._diarization = options.diarization ?? true;
-    this._maxDurationMinutes = options.maxDurationMinutes ?? 60;
-    this.serverUrl = (options.signServerUrl || DEFAULT_CAPTIONS_SERVER).replace(/\/$/, "");
-    this.autoReconnect = options.autoReconnect ?? true;
-    this.maxReconnectAttempts = options.maxReconnectAttempts ?? 5;
-    this.debug = options.debug ?? false;
-  }
-  /**
-   * Start real-time captions for the configured TikTok user.
-   * Connects to the captions WebSocket relay and begins transcription
-   * once the user goes live (or immediately if already live).
-   */
-  async start() {
-    this.intentionalClose = false;
-    const wsUrl = this.buildWsUrl();
-    if (this.debug) console.log(`[Captions] Connecting to ${wsUrl}`);
-    return new Promise((resolve, reject) => {
-      this.ws = new import_ws2.default(wsUrl);
-      this.ws.on("open", () => {
-        this._connected = true;
-        this.reconnectAttempts = 0;
-        if (this.debug) console.log("[Captions] Connected");
-        this.emit("connected");
-        resolve();
-      });
-      this.ws.on("message", (data) => {
-        this.handleMessage(typeof data === "string" ? data : data.toString());
-      });
-      this.ws.on("close", (code, reason) => {
-        this._connected = false;
-        const reasonStr = reason?.toString() || "";
-        if (this.debug) console.log(`[Captions] Disconnected: ${code} ${reasonStr}`);
-        this.emit("disconnected", code, reasonStr);
-        if (!this.intentionalClose && this.autoReconnect && this.reconnectAttempts < this.maxReconnectAttempts) {
-          this.reconnectAttempts++;
-          const delay = Math.min(1e3 * Math.pow(2, this.reconnectAttempts - 1), 3e4);
-          if (this.debug) console.log(`[Captions] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`);
-          setTimeout(() => this.start().catch((e) => this.emit("error", { code: "RECONNECT_FAILED", message: e.message })), delay);
-        }
-      });
-      this.ws.on("error", (err) => {
-        this.emit("error", { code: "WS_ERROR", message: err.message });
-        if (!this._connected) reject(err);
-      });
-    });
-  }
-  /**
-   * Stop captions and disconnect.
-   */
-  stop() {
-    this.intentionalClose = true;
-    if (this.streamAbortController) {
-      this.streamAbortController.abort();
-      this.streamAbortController = null;
-    }
-    if (this.flvExtractor) {
-      this.flvExtractor.reset();
-      this.flvExtractor = null;
-    }
-    if (this.ws) {
-      this.send({ action: "stop" });
-      this.ws.close(1e3);
-      this.ws = null;
-    }
-    this._connected = false;
-  }
-  /**
-   * Switch the translation target language on-the-fly.
-   * Causes a brief interruption while the transcription engine reconfigures.
-   */
-  setLanguage(language) {
-    this._language = language;
-    this.send({ action: "set_language", language });
-  }
-  /**
-   * Request a credit balance update from the server.
-   */
-  getCredits() {
-    this.send({ action: "get_credits" });
-  }
-  /** Whether the WebSocket is currently connected */
-  get connected() {
-    return this._connected;
-  }
-  /** The current target language */
-  get language() {
-    return this._language;
-  }
-  on(event, listener) {
-    return super.on(event, listener);
-  }
-  once(event, listener) {
-    return super.once(event, listener);
-  }
-  off(event, listener) {
-    return super.off(event, listener);
-  }
-  emit(event, ...args) {
-    return super.emit(event, ...args);
-  }
-  buildWsUrl() {
-    const base = this.serverUrl.replace(/^http/, "ws");
-    const params = new URLSearchParams({
-      uniqueId: this.uniqueId,
-      apiKey: this.apiKey
-    });
-    if (this._language) params.set("language", this._language);
-    if (this._translate) params.set("translate", this._translate);
-    if (this._diarization !== void 0) params.set("diarization", String(this._diarization));
-    if (this._maxDurationMinutes) params.set("max_duration_minutes", String(this._maxDurationMinutes));
-    return `${base}/captions?${params}`;
-  }
-  send(msg) {
-    if (this.ws?.readyState === import_ws2.default.OPEN) {
-      this.ws.send(JSON.stringify(msg));
-    }
-  }
-  handleMessage(raw) {
-    try {
-      const msg = JSON.parse(raw);
-      switch (msg.type) {
-        case "stream_info":
-          if (this.debug) console.log(`[Captions] Received stream_info: flv=${!!msg.flvUrl}, hls=${!!msg.hlsUrl}, ao=${!!msg.audioOnlyUrl}`);
-          this.connectToStream(msg);
-          break;
-        case "caption":
-          this.emit("caption", {
-            text: msg.text,
-            language: msg.language,
-            isFinal: msg.isFinal,
-            confidence: msg.confidence,
-            speaker: msg.speaker,
-            startMs: msg.startMs,
-            endMs: msg.endMs
-          });
-          break;
-        case "translation":
-          this.emit("translation", {
-            text: msg.text,
-            language: msg.language,
-            isFinal: msg.isFinal,
-            confidence: msg.confidence,
-            speaker: msg.speaker
-          });
-          break;
-        case "status":
-          this.emit("status", {
-            status: msg.status,
-            uniqueId: msg.uniqueId,
-            roomId: msg.roomId,
-            language: msg.language,
-            message: msg.message
-          });
-          break;
-        case "credits":
-          this.emit("credits", {
-            remaining: msg.remaining,
-            total: msg.total,
-            used: msg.used,
-            warning: msg.warning
-          });
-          break;
-        case "credits_low":
-          this.emit("credits_low", {
-            remaining: msg.remaining,
-            total: msg.total,
-            percent: msg.percent
-          });
-          break;
-        case "error":
-          this.emit("error", {
-            code: msg.code,
-            message: msg.message
-          });
-          break;
-        // Handle interim/final captions from server (sentence-level accumulation)
-        case "interim":
-          this.emit("caption", {
-            text: msg.text,
-            language: msg.language,
-            isFinal: false,
-            confidence: msg.confidence || 0,
-            speaker: msg.speaker
-          });
-          break;
-        case "final":
-          this.emit("caption", {
-            text: msg.text,
-            language: msg.language,
-            isFinal: true,
-            confidence: msg.confidence || 0,
-            speaker: msg.speaker
-          });
-          break;
-        case "translation_interim":
-          this.emit("translation", {
-            text: msg.text,
-            language: msg.language,
-            isFinal: false,
-            confidence: msg.confidence || 0,
-            speaker: msg.speaker
-          });
-          break;
-        case "translation_final":
-          this.emit("translation", {
-            text: msg.text,
-            language: msg.language,
-            isFinal: true,
-            confidence: msg.confidence || 0,
-            speaker: msg.speaker
-          });
-          break;
-        default:
-          if (this.debug) {
-            if (this.debug) console.log(`[Captions] Unknown message type: ${msg.type}`, msg);
+          if (evt.type === "battleArmies") {
+            const unresolvedIds = [];
+            for (const team of evt.teams) {
+              const host = team.users.find((u) => u.user.id === team.hostUserId);
+              if (host) {
+                team.hostUser = host.user;
+                this._battleHosts.set(team.hostUserId, host.user);
+              } else {
+                const cached = this._battleHosts.get(team.hostUserId);
+                if (cached) {
+                  team.hostUser = cached;
+                } else if (team.hostUserId && team.hostUserId !== "0") {
+                  unresolvedIds.push(team.hostUserId);
+                }
+              }
+            }
+            if (unresolvedIds.length > 0) {
+              this.resolveHostUsers(unresolvedIds, evt).catch(() => {
+              });
+              continue;
+            }
           }
+          this.emit("event", evt);
+          this.emit(evt.type, evt);
+        }
       }
     } catch {
-      if (this.debug) console.error("[Captions] Failed to parse message:", raw);
     }
   }
   /**
-   * Connect to the TikTok FLV stream and extract audio.
-   * Sends binary audio buffers to the server via WebSocket.
+   * Resolve unknown host user IDs via the sign server API.
+   * Caches results and re-emits the battleArmies event with enriched hostUser data.
    */
-  async connectToStream(streamInfo) {
-    const url = streamInfo.audioOnlyUrl || streamInfo.flvUrl;
-    if (!url) {
-      this.emit("error", { code: "NO_STREAM_URL", message: "Server did not provide a usable stream URL" });
+  async resolveHostUsers(userIds, originalEvt) {
+    const toResolve = userIds.filter((id) => !this._pendingHostResolves.has(id));
+    if (toResolve.length === 0) {
+      this.emit("event", originalEvt);
+      this.emit(originalEvt.type, originalEvt);
       return;
     }
-    this.streamUrl = url;
-    if (this.debug) console.log(`[Captions] connectToStream: URL selected: ${url.substring(0, 80)}...`);
-    if (this.streamAbortController) {
-      this.streamAbortController.abort();
-    }
-    this.streamAbortController = new AbortController();
-    let audioFramesSent = 0;
-    let audioBytesSent = 0;
-    this.flvExtractor = new FlvAudioExtractor((adtsFrame) => {
-      if (this.ws?.readyState === import_ws2.default.OPEN) {
-        this.ws.send(adtsFrame);
-        audioFramesSent++;
-        audioBytesSent += adtsFrame.length;
-        if (this.debug && (audioFramesSent <= 3 || audioFramesSent % 100 === 0)) {
-          if (this.debug) console.log(`[Captions] Audio frame #${audioFramesSent}: ${adtsFrame.length}b (total: ${audioBytesSent}b)`);
-        }
-      } else if (this.debug && audioFramesSent === 0) {
-        if (this.debug) console.log(`[Captions] WARNING: WS not open (readyState=${this.ws?.readyState}), cannot send audio`);
-      }
-    });
+    for (const id of toResolve) this._pendingHostResolves.add(id);
     try {
-      if (this.debug) console.log(`[Captions] connectToStream: calling fetch()...`);
-      const resp = await fetch(url, {
-        signal: this.streamAbortController.signal,
+      const url = `${this.signServerUrl}/webcast/resolve_user_ids`;
+      const res = await fetch(url, {
+        method: "POST",
         headers: {
-          "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
-        }
+          "Content-Type": "application/json",
+          "x-api-key": this.apiKey
+        },
+        body: JSON.stringify({ user_ids: toResolve }),
+        signal: AbortSignal.timeout(5e3)
       });
-      if (this.debug) console.log(`[Captions] connectToStream: fetch returned status=${resp.status}, hasBody=${!!resp.body}`);
-      if (!resp.ok || !resp.body) {
-        throw new Error(`FLV stream HTTP ${resp.status}`);
-      }
-      if (this.debug) console.log(`[Captions] FLV stream connected (${resp.status})`);
-      const reader = resp.body.getReader ? resp.body.getReader() : null;
-      if (this.debug) console.log(`[Captions] connectToStream: hasReader=${!!reader}, hasAsyncIterator=${typeof resp.body[Symbol.asyncIterator] === "function"}`);
-      if (reader) {
-        const processStream = async () => {
-          let chunks = 0;
-          try {
-            while (true) {
-              const { done, value } = await reader.read();
-              if (done || this.intentionalClose) {
-                if (this.debug) console.log(`[Captions] FLV stream ended (done=${done}, intentionalClose=${this.intentionalClose}), chunks=${chunks}, audioFrames=${audioFramesSent}`);
-                break;
-              }
-              chunks++;
-              if (value && this.flvExtractor) {
-                this.flvExtractor.push(value);
-              }
-              if (this.debug && chunks <= 3) {
-                if (this.debug) console.log(`[Captions] FLV chunk #${chunks}: ${value?.length || 0}b`);
-              }
-            }
-          } catch (err) {
-            if (err.name !== "AbortError" && !this.intentionalClose) {
-              if (this.debug) console.error("[Captions] FLV stream read error:", err.message);
-              this.emit("error", { code: "STREAM_READ_ERROR", message: err.message });
-            } else if (this.debug) {
-              if (this.debug) console.log(`[Captions] FLV stream aborted after ${chunks} chunks, ${audioFramesSent} audio frames`);
+      if (res.ok) {
+        const json = await res.json();
+        if (json.data) {
+          for (const [uid, info] of Object.entries(json.data)) {
+            if (info.username) {
+              const hostUser = {
+                id: uid,
+                uniqueId: info.username,
+                nickname: info.nickname || info.username,
+                profilePicture: info.avatarUrl || void 0
+              };
+              this._battleHosts.set(uid, hostUser);
             }
           }
-        };
-        processStream();
-      } else if (typeof resp.body[Symbol.asyncIterator] === "function") {
-        const processNodeStream = async () => {
-          let chunks = 0;
-          try {
-            for await (const chunk of resp.body) {
-              if (this.intentionalClose) break;
-              chunks++;
-              const u8 = chunk instanceof Uint8Array ? chunk : new Uint8Array(chunk);
-              if (this.flvExtractor) {
-                this.flvExtractor.push(u8);
+          if (originalEvt.type === "battleArmies") {
+            for (const team of originalEvt.teams) {
+              if (!team.hostUser) {
+                const cached = this._battleHosts.get(team.hostUserId);
+                if (cached) team.hostUser = cached;
               }
-              if (this.debug && chunks <= 3) {
-                if (this.debug) console.log(`[Captions] FLV chunk #${chunks}: ${u8.length}b`);
-              }
-            }
-            if (this.debug) console.log(`[Captions] Node stream ended, chunks=${chunks}, audioFrames=${audioFramesSent}`);
-          } catch (err) {
-            if (err.name !== "AbortError" && !this.intentionalClose) {
-              if (this.debug) console.error("[Captions] FLV stream read error:", err.message);
-              this.emit("error", { code: "STREAM_READ_ERROR", message: err.message });
-            } else if (this.debug) {
-              if (this.debug) console.log(`[Captions] FLV node stream aborted after ${chunks} chunks, ${audioFramesSent} audio frames`);
             }
           }
-        };
-        processNodeStream();
-      } else {
-        if (this.debug) console.error(`[Captions] ERROR: resp.body has no getReader() and no asyncIterator!`);
-      }
-    } catch (err) {
-      if (err.name !== "AbortError" && !this.intentionalClose) {
-        if (this.debug) console.error("[Captions] FLV stream connect error:", err.message);
-        this.emit("error", { code: "STREAM_CONNECT_ERROR", message: err.message });
+        }
       }
+    } catch {
+    } finally {
+      for (const id of toResolve) this._pendingHostResolves.delete(id);
+      this.emit("event", originalEvt);
+      this.emit(originalEvt.type, originalEvt);
     }
   }
-};
-
-// src/api.ts
-var DEFAULT_SIGN_SERVER2 = "https://api.tik.tools";
-var PAGE_CACHE_TTL = 5 * 60 * 1e3;
-async function getRanklist(opts) {
-  const base = (opts.serverUrl || DEFAULT_SIGN_SERVER2).replace(/\/$/, "");
-  const ak = encodeURIComponent(opts.apiKey);
-  const body = {};
-  if (opts.uniqueId) body.unique_id = opts.uniqueId;
-  if (opts.roomId) body.room_id = opts.roomId;
-  if (opts.anchorId) body.anchor_id = opts.anchorId;
-  if (opts.sessionCookie) body.session_cookie = opts.sessionCookie;
-  if (opts.type) body.type = opts.type;
-  if (opts.rankType) body.rank_type = opts.rankType;
-  const resp = await fetch(`${base}/webcast/ranklist?apiKey=${ak}`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(body)
-  });
-  const data = await resp.json();
-  if (data.status_code === 20003) {
-    throw new Error(
-      data.message || "TikTok requires login. Provide sessionCookie with your TikTok session."
-    );
-  }
-  if (data.status_code !== 0) {
-    throw new Error(data.error || `Ranklist failed (status ${data.status_code})`);
-  }
-  if (data.sign_and_return) {
-    return data;
-  }
-  return data.data;
-}
-async function getRegionalRanklist(opts) {
-  const base = (opts.serverUrl || DEFAULT_SIGN_SERVER2).replace(/\/$/, "");
-  const ak = encodeURIComponent(opts.apiKey);
-  const body = {};
-  if (opts.uniqueId) body.unique_id = opts.uniqueId;
-  if (opts.roomId) body.room_id = opts.roomId;
-  if (opts.anchorId) body.anchor_id = opts.anchorId;
-  if (opts.rankType) body.rank_type = opts.rankType;
-  if (opts.type) body.type = opts.type;
-  if (opts.gapInterval) body.gap_interval = opts.gapInterval;
-  if (opts.sessionCookie) body.session_cookie = opts.sessionCookie;
-  if (opts.clientIp) body.client_ip = opts.clientIp;
-  const resp = await fetch(`${base}/webcast/ranklist/regional?apiKey=${ak}`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(body)
-  });
-  const data = await resp.json();
-  if (data.status_code !== 0) {
-    throw new Error(data.error || `Regional ranklist failed (status ${data.status_code})`);
-  }
-  return data;
-}
-async function getLiveFeed(opts) {
-  const base = (opts.serverUrl || DEFAULT_SIGN_SERVER2).replace(/\/$/, "");
-  const params = new URLSearchParams();
-  params.set("apiKey", opts.apiKey);
-  if (opts.region) params.set("region", opts.region);
-  if (opts.channelId) params.set("channel_id", opts.channelId);
-  if (opts.count !== void 0) params.set("count", String(Math.min(opts.count, 50)));
-  if (opts.maxTime) params.set("max_time", opts.maxTime);
-  if (opts.sessionId) params.set("session_id", opts.sessionId);
-  if (opts.ttwid) params.set("ttwid", opts.ttwid);
-  if (opts.msToken) params.set("ms_token", opts.msToken);
-  const resp = await fetch(`${base}/webcast/feed?${params.toString()}`);
-  const data = await resp.json();
-  if (resp.status === 429) {
-    throw new Error(data.error || "Feed daily limit reached. Upgrade your plan for more calls.");
-  }
-  if (!resp.ok) {
-    throw new Error(data.error || `Feed request failed (HTTP ${resp.status})`);
-  }
-  return data;
-}
-async function fetchFeed(opts) {
-  const signed = await getLiveFeed(opts);
-  const headers = { ...signed.headers || {} };
-  if (signed.cookies) {
-    headers["Cookie"] = signed.cookies;
+  startHeartbeat(roomId) {
+    this.stopHeartbeat();
+    this.heartbeatTimer = setInterval(() => {
+      if (this.ws?.readyState === import_ws.default.OPEN) {
+        this.ws.send(buildHeartbeat(roomId));
+      }
+    }, this.heartbeatInterval);
   }
-  const resp = await fetch(signed.signed_url, { headers, redirect: "follow" });
-  const text = await resp.text();
-  try {
-    return JSON.parse(text);
-  } catch {
-    return null;
+  stopHeartbeat() {
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
   }
-}
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  TikTokCaptions,
-  TikTokLive,
-  fetchFeed,
-  getLiveFeed,
-  getRanklist,
-  getRegionalRanklist
+  TikTokLive
 });
 //# sourceMappingURL=index.js.map