@tiktool/live 1.0.0 → 1.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 # @tiktool/live
 
-### Connect to any TikTok LIVE stream in 3 lines of code.
+### Connect to any TikTok LIVE stream in 4 lines of code.
 
 [![npm version](https://img.shields.io/npm/v/@tiktool/live?color=%23ff0050&label=npm&logo=npm)](https://www.npmjs.com/package/@tiktool/live)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -11,9 +11,7 @@
 
 Real-time chat, gifts, viewers, battles, follows & 18+ event types from any TikTok livestream.
 
-**No API key required** · **Zero config** · **Direct connection**
-
-[Quick Start](#-quick-start) · [Events](#-events) · [API](#-api-reference) · [Rate Limits](#-rate-limits)
+[Quick Start](#-quick-start) · [Events](#-events) · [API](#-api-reference) · [Rate Limits](#-rate-limits) · [Get API Key](https://tik.tools)
 
 </div>
 
@@ -25,10 +23,15 @@ Real-time chat, gifts, viewers, battles, follows & 18+ event types from any TikT
 npm install @tiktool/live
 ```
 
+Get your free API key at [tik.tools](https://tik.tools)
+
 ```typescript
 import { TikTokLive } from '@tiktool/live';
 
-const live = new TikTokLive({ uniqueId: 'tv_asahi_news' });
+const live = new TikTokLive({
+    uniqueId: 'tv_asahi_news',
+    apiKey: 'YOUR_API_KEY',
+});
 
 live.on('chat', e => console.log(`${e.user.uniqueId}: ${e.comment}`));
 live.on('gift', e => console.log(`${e.user.uniqueId} sent ${e.giftName} (${e.diamondCount} diamonds)`));
@@ -38,8 +41,6 @@ live.on('roomUserSeq', e => console.log(`Viewers: ${e.viewerCount}`));
 await live.connect();
 ```
 
-No API key, no configuration, no server setup. Install and connect.
-
 ---
 
 ## How It Works
@@ -58,7 +59,7 @@ No API key, no configuration, no server setup. Install and connect.
 ```
 
 - Your app connects directly to TikTok from your IP address
-- The sign server only generates cryptographic signatures
+- The sign server only generates cryptographic signatures (requires API key)
 - TikTok never sees the sign server
 - Built-in protobuf parser, no external dependencies
 
@@ -120,8 +121,8 @@ live.on('event', (event) => {
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `uniqueId` | `string` | — | TikTok username (without @) |
+| `apiKey` | `string` | — | **Required.** API key from [tik.tools](https://tik.tools) |
 | `signServerUrl` | `string` | `https://api.tik.tools` | Sign server URL |
-| `apiKey` | `string` | — | API key for higher rate limits |
 | `autoReconnect` | `boolean` | `true` | Auto-reconnect on disconnect |
 | `maxReconnectAttempts` | `number` | `5` | Max reconnect attempts |
 | `heartbeatInterval` | `number` | `10000` | Heartbeat interval (ms) |
@@ -141,22 +142,15 @@ live.on('event', (event) => {
 
 ## Rate Limits
 
-| Tier | Rate Limit | API Key | Price |
-|------|-----------|---------|-------|
-| Free | 5 signs/min | No | Free |
-| Basic | 30 signs/min | Yes | Free (with key) |
-| Premium | 120 signs/min | Yes | Coming soon |
+All API requests require an API key. Get yours at [tik.tools](https://tik.tools).
 
-Most users only need the free tier. The SDK calls the sign server once per connection, then stays connected via WebSocket.
+| Tier | Rate Limit | Endpoints | Price |
+|------|-----------|-----------|-------|
+| **Free** | 5/min | `sign_url`, `check_alive` | Free |
+| **Basic** | 30/min | + `fetch`, `room_info`, `bulk_live_check`, WS relay | Free (with key) |
+| **Pro** | 120/min | + `room_video`, all endpoints | Coming soon |
 
-### Using an API Key
-
-```typescript
-const live = new TikTokLive({
-    uniqueId: 'username',
-    apiKey: 'your-api-key',
-});
-```
+The SDK calls the sign server **once per connection**, then stays connected via WebSocket. A free key is sufficient for most use cases.
 
 ---
 
@@ -167,7 +161,10 @@ const live = new TikTokLive({
 ```typescript
 import { TikTokLive } from '@tiktool/live';
 
-const live = new TikTokLive({ uniqueId: 'streamer_name' });
+const live = new TikTokLive({
+    uniqueId: 'streamer_name',
+    apiKey: 'YOUR_API_KEY',
+});
 
 live.on('chat', (e) => {
     if (e.comment.toLowerCase() === '!hello') {
@@ -191,7 +188,10 @@ import { TikTokLive } from '@tiktool/live';
 import { WebSocketServer } from 'ws';
 
 const wss = new WebSocketServer({ port: 8080 });
-const live = new TikTokLive({ uniqueId: 'streamer_name' });
+const live = new TikTokLive({
+    uniqueId: 'streamer_name',
+    apiKey: 'YOUR_API_KEY',
+});
 
 live.on('event', (event) => {
     for (const client of wss.clients) {
@@ -203,25 +203,6 @@ await live.connect();
 console.log('Forwarding events to ws://localhost:8080');
 ```
 
-### Gift Tracker
-
-```typescript
-import { TikTokLive } from '@tiktool/live';
-
-const live = new TikTokLive({ uniqueId: 'streamer_name' });
-let totalDiamonds = 0;
-
-live.on('gift', (e) => {
-    if (e.repeatEnd || !e.combo) {
-        const diamonds = e.diamondCount * (e.repeatCount || 1);
-        totalDiamonds += diamonds;
-        console.log(`${e.user.uniqueId}: ${e.giftName} = ${diamonds} diamonds (Total: ${totalDiamonds})`);
-    }
-});
-
-await live.connect();
-```
-
 ---
 
 ## TypeScript
@@ -231,7 +212,10 @@ Full TypeScript support with type inference:
 ```typescript
 import { TikTokLive, ChatEvent, GiftEvent } from '@tiktool/live';
 
-const live = new TikTokLive({ uniqueId: 'username' });
+const live = new TikTokLive({
+    uniqueId: 'username',
+    apiKey: 'YOUR_API_KEY',
+});
 
 live.on('chat', (event: ChatEvent) => {
     const username: string = event.user.uniqueId;

package/dist/index.d.mts

@@ -37,6 +37,8 @@ interface GiftEvent extends BaseEvent {
     repeatCount: number;
     repeatEnd: boolean;
     combo: boolean;
+    giftType: number;
+    groupId: string;
 }
 interface SocialEvent extends BaseEvent {
     type: 'social';
@@ -48,12 +50,26 @@ interface RoomUserSeqEvent extends BaseEvent {
     viewerCount: number;
     totalViewers: number;
 }
+interface BattleTeamUser {
+    user: TikTokUser;
+    score: number;
+}
+interface BattleTeam {
+    hostUserId: string;
+    score: number;
+    users: BattleTeamUser[];
+}
 interface BattleEvent extends BaseEvent {
     type: 'battle';
+    battleId: string;
     status: number;
+    battleDuration: number;
+    teams: BattleTeam[];
 }
 interface BattleArmiesEvent extends BaseEvent {
     type: 'battleArmies';
+    battleId: string;
+    teams: BattleTeam[];
 }
 interface SubscribeEvent extends BaseEvent {
     type: 'subscribe';
@@ -64,9 +80,11 @@ interface EmoteChatEvent extends BaseEvent {
     type: 'emoteChat';
     user: TikTokUser;
     emoteId: string;
+    emoteUrl: string;
 }
 interface EnvelopeEvent extends BaseEvent {
     type: 'envelope';
+    envelopeId: string;
     diamondCount: number;
 }
 interface QuestionEvent extends BaseEvent {
@@ -80,19 +98,26 @@ interface ControlEvent extends BaseEvent {
 }
 interface RoomEvent extends BaseEvent {
     type: 'room';
-    status: string;
+    status: number;
 }
 interface LiveIntroEvent extends BaseEvent {
     type: 'liveIntro';
+    roomId: string;
     title: string;
 }
 interface RankUpdateEvent extends BaseEvent {
     type: 'rankUpdate';
     rankType: string;
+    rankList: Array<{
+        user: TikTokUser;
+        rank: number;
+        score: number;
+    }>;
 }
 interface LinkMicEvent extends BaseEvent {
     type: 'linkMic';
-    action: number;
+    action: string;
+    users: TikTokUser[];
 }
 interface UnknownEvent extends BaseEvent {
     type: 'unknown';
@@ -133,7 +158,7 @@ interface RoomInfo {
 interface TikTokLiveOptions {
     uniqueId: string;
     signServerUrl?: string;
-    apiKey?: string;
+    apiKey: string;
     autoReconnect?: boolean;
     maxReconnectAttempts?: number;
     heartbeatInterval?: number;
@@ -150,7 +175,7 @@ declare class TikTokLive extends EventEmitter {
     private _roomId;
     private readonly uniqueId;
     private readonly signServerUrl;
-    private readonly apiKey?;
+    private readonly apiKey;
     private readonly autoReconnect;
     private readonly maxReconnectAttempts;
     private readonly heartbeatInterval;
@@ -170,4 +195,4 @@ declare class TikTokLive extends EventEmitter {
     private stopHeartbeat;
 }
 
-export { type BaseEvent, type BattleArmiesEvent, type BattleEvent, type ChatEvent, type ControlEvent, type EmoteChatEvent, type EnvelopeEvent, type GiftEvent, type LikeEvent, type LinkMicEvent, type LiveEvent, type LiveIntroEvent, type MemberEvent, type QuestionEvent, type RankUpdateEvent, type RoomEvent, type RoomInfo, type RoomUserSeqEvent, type SocialEvent, type SubscribeEvent, TikTokLive, type TikTokLiveEvents, type TikTokLiveOptions, type TikTokUser, type UnknownEvent };
+export { type BaseEvent, type BattleArmiesEvent, type BattleEvent, type BattleTeam, type BattleTeamUser, type ChatEvent, type ControlEvent, type EmoteChatEvent, type EnvelopeEvent, type GiftEvent, type LikeEvent, type LinkMicEvent, type LiveEvent, type LiveIntroEvent, type MemberEvent, type QuestionEvent, type RankUpdateEvent, type RoomEvent, type RoomInfo, type RoomUserSeqEvent, type SocialEvent, type SubscribeEvent, TikTokLive, type TikTokLiveEvents, type TikTokLiveOptions, type TikTokUser, type UnknownEvent };

package/dist/index.d.ts

@@ -37,6 +37,8 @@ interface GiftEvent extends BaseEvent {
     repeatCount: number;
     repeatEnd: boolean;
     combo: boolean;
+    giftType: number;
+    groupId: string;
 }
 interface SocialEvent extends BaseEvent {
     type: 'social';
@@ -48,12 +50,26 @@ interface RoomUserSeqEvent extends BaseEvent {
     viewerCount: number;
     totalViewers: number;
 }
+interface BattleTeamUser {
+    user: TikTokUser;
+    score: number;
+}
+interface BattleTeam {
+    hostUserId: string;
+    score: number;
+    users: BattleTeamUser[];
+}
 interface BattleEvent extends BaseEvent {
     type: 'battle';
+    battleId: string;
     status: number;
+    battleDuration: number;
+    teams: BattleTeam[];
 }
 interface BattleArmiesEvent extends BaseEvent {
     type: 'battleArmies';
+    battleId: string;
+    teams: BattleTeam[];
 }
 interface SubscribeEvent extends BaseEvent {
     type: 'subscribe';
@@ -64,9 +80,11 @@ interface EmoteChatEvent extends BaseEvent {
     type: 'emoteChat';
     user: TikTokUser;
     emoteId: string;
+    emoteUrl: string;
 }
 interface EnvelopeEvent extends BaseEvent {
     type: 'envelope';
+    envelopeId: string;
     diamondCount: number;
 }
 interface QuestionEvent extends BaseEvent {
@@ -80,19 +98,26 @@ interface ControlEvent extends BaseEvent {
 }
 interface RoomEvent extends BaseEvent {
     type: 'room';
-    status: string;
+    status: number;
 }
 interface LiveIntroEvent extends BaseEvent {
     type: 'liveIntro';
+    roomId: string;
     title: string;
 }
 interface RankUpdateEvent extends BaseEvent {
     type: 'rankUpdate';
     rankType: string;
+    rankList: Array<{
+        user: TikTokUser;
+        rank: number;
+        score: number;
+    }>;
 }
 interface LinkMicEvent extends BaseEvent {
     type: 'linkMic';
-    action: number;
+    action: string;
+    users: TikTokUser[];
 }
 interface UnknownEvent extends BaseEvent {
     type: 'unknown';
@@ -133,7 +158,7 @@ interface RoomInfo {
 interface TikTokLiveOptions {
     uniqueId: string;
     signServerUrl?: string;
-    apiKey?: string;
+    apiKey: string;
     autoReconnect?: boolean;
     maxReconnectAttempts?: number;
     heartbeatInterval?: number;
@@ -150,7 +175,7 @@ declare class TikTokLive extends EventEmitter {
     private _roomId;
     private readonly uniqueId;
     private readonly signServerUrl;
-    private readonly apiKey?;
+    private readonly apiKey;
     private readonly autoReconnect;
     private readonly maxReconnectAttempts;
     private readonly heartbeatInterval;
@@ -170,4 +195,4 @@ declare class TikTokLive extends EventEmitter {
     private stopHeartbeat;
 }
 
-export { type BaseEvent, type BattleArmiesEvent, type BattleEvent, type ChatEvent, type ControlEvent, type EmoteChatEvent, type EnvelopeEvent, type GiftEvent, type LikeEvent, type LinkMicEvent, type LiveEvent, type LiveIntroEvent, type MemberEvent, type QuestionEvent, type RankUpdateEvent, type RoomEvent, type RoomInfo, type RoomUserSeqEvent, type SocialEvent, type SubscribeEvent, TikTokLive, type TikTokLiveEvents, type TikTokLiveOptions, type TikTokUser, type UnknownEvent };
+export { type BaseEvent, type BattleArmiesEvent, type BattleEvent, type BattleTeam, type BattleTeamUser, type ChatEvent, type ControlEvent, type EmoteChatEvent, type EnvelopeEvent, type GiftEvent, type LikeEvent, type LinkMicEvent, type LiveEvent, type LiveIntroEvent, type MemberEvent, type QuestionEvent, type RankUpdateEvent, type RoomEvent, type RoomInfo, type RoomUserSeqEvent, type SocialEvent, type SubscribeEvent, TikTokLive, type TikTokLiveEvents, type TikTokLiveOptions, type TikTokUser, type UnknownEvent };

package/dist/index.js

@@ -123,6 +123,9 @@ function getInt(fields, fn) {
   const f = fields.find((x) => x.fn === fn && x.wt === 0);
   return f ? Number(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 Buffer.concat([
@@ -158,65 +161,202 @@ function parseUser(data) {
   const id = String(getInt(f, 1) || getStr(f, 1));
   const nickname = getStr(f, 3) || getStr(f, 5);
   const uniqueId = getStr(f, 38) || getStr(f, 4) || getStr(f, 2);
-  return { id, nickname, uniqueId: uniqueId || nickname || id };
+  let profilePicture;
+  const avatarBuf = getBytes(f, 9);
+  if (avatarBuf) {
+    try {
+      const avatarFields = decodeProto(avatarBuf);
+      const urlBuf = getBytes(avatarFields, 1);
+      if (urlBuf) profilePicture = urlBuf.toString("utf-8");
+    } catch {
+    }
+  }
+  return { id, nickname, uniqueId: uniqueId || nickname || id, profilePicture };
+}
+function parseBattleTeam(teamBuf) {
+  const fields = decodeProto(teamBuf);
+  const hostUserId = String(getInt(fields, 1));
+  const score = getInt(fields, 2);
+  const users = [];
+  const userFields = getAllBytes(fields, 3);
+  for (const uf of userFields) {
+    try {
+      const uFields = decodeProto(uf);
+      const userBuf = getBytes(uFields, 1);
+      const userScore = getInt(uFields, 2);
+      const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
+      users.push({ user, score: userScore });
+    } catch {
+    }
+  }
+  return { hostUserId, score, users };
 }
 function parseWebcastMessage(method, payload) {
   const f = decodeProto(payload);
-  const userBuf = getBytes(f, 2);
-  const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
   const base = { timestamp: Date.now(), msgId: String(getInt(f, 1) || "") };
   switch (method) {
-    case "WebcastChatMessage":
+    case "WebcastChatMessage": {
+      const userBuf = getBytes(f, 2);
+      const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
       return { ...base, type: "chat", user, comment: getStr(f, 3) };
-    case "WebcastMemberMessage":
-      return { ...base, type: "member", user, action: getInt(f, 3) };
-    case "WebcastLikeMessage":
-      return { ...base, type: "like", user, likeCount: getInt(f, 5), totalLikes: getInt(f, 6) || getInt(f, 7) };
+    }
+    case "WebcastMemberMessage": {
+      const userBuf = getBytes(f, 2);
+      const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
+      return { ...base, type: "member", user, action: getInt(f, 1) };
+    }
+    case "WebcastLikeMessage": {
+      const userBuf = getBytes(f, 5);
+      const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
+      return { ...base, type: "like", user, likeCount: getInt(f, 1), totalLikes: getInt(f, 2) || getInt(f, 7) };
+    }
     case "WebcastGiftMessage": {
-      const giftBuf = getBytes(f, 3);
-      let giftName = "", giftId = 0, diamondCount = 0;
-      if (giftBuf) {
-        const gf = decodeProto(giftBuf);
-        giftId = getInt(gf, 1);
-        giftName = getStr(gf, 2);
-        diamondCount = getInt(gf, 5);
-      }
+      const userBuf = getBytes(f, 7);
+      const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
+      const giftId = getInt(f, 1);
       const repeatCount = getInt(f, 5);
       const repeatEnd = getInt(f, 9) === 1;
-      return { ...base, type: "gift", user, giftId, giftName, diamondCount, repeatCount, repeatEnd, combo: repeatCount > 1 && !repeatEnd };
+      const giftType = getInt(f, 6);
+      const groupId = getStr(f, 11);
+      let giftName = "", diamondCount = 0;
+      const giftInfoBuf = getBytes(f, 15);
+      if (giftInfoBuf) {
+        const gf = decodeProto(giftInfoBuf);
+        giftName = getStr(gf, 1);
+        diamondCount = getInt(gf, 5) || getInt(gf, 2);
+      }
+      if (!giftName) {
+        const giftBuf3 = getBytes(f, 3);
+        if (giftBuf3) {
+          const gf3 = decodeProto(giftBuf3);
+          if (!giftName) giftName = getStr(gf3, 2);
+          if (!diamondCount) diamondCount = getInt(gf3, 5);
+        }
+      }
+      return {
+        ...base,
+        type: "gift",
+        user,
+        giftId,
+        giftName,
+        diamondCount,
+        repeatCount,
+        repeatEnd,
+        combo: repeatCount > 1 && !repeatEnd,
+        giftType,
+        groupId
+      };
     }
     case "WebcastSocialMessage": {
-      const action = getInt(f, 3);
+      const userBuf = getBytes(f, 2);
+      const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
+      const actionInt = getInt(f, 1);
       const actionMap = { 1: "follow", 2: "share", 3: "like" };
-      return { ...base, type: "social", user, action: actionMap[action] || `action_${action}` };
+      return { ...base, type: "social", user, action: actionMap[actionInt] || `action_${actionInt}` };
     }
     case "WebcastRoomUserSeqMessage":
-      return { ...base, type: "roomUserSeq", viewerCount: getInt(f, 3), totalViewers: getInt(f, 4) };
-    case "WebcastLinkMicBattle":
-      return { ...base, type: "battle", status: getInt(f, 3) };
-    case "WebcastLinkMicArmies":
-      return { ...base, type: "battleArmies" };
-    case "WebcastSubNotifyMessage":
-      return { ...base, type: "subscribe", user, subMonth: getInt(f, 8) };
-    case "WebcastEmoteChatMessage":
-      return { ...base, type: "emoteChat", user, emoteId: getStr(f, 3) };
-    case "WebcastEnvelopeMessage":
-      return { ...base, type: "envelope", diamondCount: getInt(f, 3) };
-    case "WebcastQuestionNewMessage":
-      return { ...base, type: "question", user, questionText: getStr(f, 3) };
+      return {
+        ...base,
+        type: "roomUserSeq",
+        totalViewers: getInt(f, 1) || getInt(f, 3),
+        viewerCount: getInt(f, 2) || getInt(f, 4)
+      };
+    case "WebcastLinkMicBattle": {
+      const battleId = String(getInt(f, 1) || getStr(f, 1));
+      const status = getInt(f, 2);
+      const battleDuration = getInt(f, 3);
+      const teams = [];
+      const teamBufs = getAllBytes(f, 7);
+      for (const tb of teamBufs) {
+        try {
+          teams.push(parseBattleTeam(tb));
+        } catch {
+        }
+      }
+      return { ...base, type: "battle", battleId, status, battleDuration, teams };
+    }
+    case "WebcastLinkMicArmies": {
+      const battleId = String(getInt(f, 1) || getStr(f, 1));
+      const teams = [];
+      const teamBufs = getAllBytes(f, 3);
+      for (const tb of teamBufs) {
+        try {
+          teams.push(parseBattleTeam(tb));
+        } catch {
+        }
+      }
+      return { ...base, type: "battleArmies", battleId, teams };
+    }
+    case "WebcastSubNotifyMessage": {
+      const userBuf = getBytes(f, 2);
+      const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
+      return { ...base, type: "subscribe", user, subMonth: getInt(f, 3) };
+    }
+    case "WebcastEmoteChatMessage": {
+      const userBuf = getBytes(f, 2);
+      const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
+      let emoteId = "", emoteUrl = "";
+      const emoteBuf = getBytes(f, 3);
+      if (emoteBuf) {
+        const ef = decodeProto(emoteBuf);
+        emoteId = getStr(ef, 1);
+        const imageBuf = getBytes(ef, 2);
+        if (imageBuf) {
+          const imgFields = decodeProto(imageBuf);
+          emoteUrl = getStr(imgFields, 1);
+        }
+      }
+      return { ...base, type: "emoteChat", user, emoteId, emoteUrl };
+    }
+    case "WebcastEnvelopeMessage": {
+      const envelopeId = String(getInt(f, 1) || getStr(f, 1));
+      return { ...base, type: "envelope", envelopeId, diamondCount: getInt(f, 3) };
+    }
+    case "WebcastQuestionNewMessage": {
+      const userBuf = getBytes(f, 2);
+      const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
+      return { ...base, type: "question", user, questionText: getStr(f, 3) || getStr(f, 4) };
+    }
     case "WebcastRankUpdateMessage":
-    case "WebcastHourlyRankMessage":
-      return { ...base, type: "rankUpdate", rankType: getStr(f, 3) };
+    case "WebcastHourlyRankMessage": {
+      const rankType = getStr(f, 1) || `rank_${getInt(f, 1)}`;
+      const rankList = [];
+      const listBufs = getAllBytes(f, 2);
+      for (const lb of listBufs) {
+        try {
+          const rf = decodeProto(lb);
+          const userBuf = getBytes(rf, 1);
+          const rank = getInt(rf, 2);
+          const score = getInt(rf, 3);
+          const user = userBuf ? parseUser(userBuf) : { id: "0", nickname: "", uniqueId: "" };
+          rankList.push({ user, rank, score });
+        } catch {
+        }
+      }
+      return { ...base, type: "rankUpdate", rankType, rankList };
+    }
     case "WebcastControlMessage":
-      return { ...base, type: "control", action: getInt(f, 2) };
+      return { ...base, type: "control", action: getInt(f, 2) || getInt(f, 1) };
     case "WebcastRoomMessage":
     case "RoomMessage":
-      return { ...base, type: "room", status: getStr(f, 3) };
-    case "WebcastLiveIntroMessage":
-      return { ...base, type: "liveIntro", title: getStr(f, 3) };
+      return { ...base, type: "room", status: getInt(f, 2) };
+    case "WebcastLiveIntroMessage": {
+      const roomId = String(getInt(f, 1));
+      return { ...base, type: "liveIntro", roomId, title: getStr(f, 4) || getStr(f, 2) };
+    }
     case "WebcastLinkMicMethod":
-    case "WebcastLinkmicBattleTaskMessage":
-      return { ...base, type: "linkMic", action: getInt(f, 3) };
+    case "WebcastLinkmicBattleTaskMessage": {
+      const action = getStr(f, 1) || `action_${getInt(f, 1)}`;
+      const users = [];
+      const userBufs = getAllBytes(f, 2);
+      for (const ub of userBufs) {
+        try {
+          users.push(parseUser(ub));
+        } catch {
+        }
+      }
+      return { ...base, type: "linkMic", action, users };
+    }
     default:
       return { ...base, type: "unknown", method };
   }
@@ -289,6 +429,7 @@ var TikTokLive = class extends import_events.EventEmitter {
     super();
     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");
     this.apiKey = options.apiKey;
     this.autoReconnect = options.autoReconnect ?? true;
     this.maxReconnectAttempts = options.maxReconnectAttempts ?? 5;
@@ -359,12 +500,15 @@ var TikTokLive = class extends import_events.EventEmitter {
       did_rule: "3"
     });
     const rawWsUrl = `https://${wsHost}/webcast/im/ws_proxy/ws_reuse_supplement/?${wsParams}`;
-    const signUrl = this.apiKey ? `${this.signServerUrl}/webcast/sign_url?apiKey=${this.apiKey}` : `${this.signServerUrl}/webcast/sign_url`;
+    const signUrl = `${this.signServerUrl}/webcast/sign_url`;
     let wsUrl;
     try {
       const signResp = await fetch(signUrl, {
         method: "POST",
-        headers: { "Content-Type": "application/json" },
+        headers: {
+          "Content-Type": "application/json",
+          "x-api-key": this.apiKey
+        },
         body: JSON.stringify({ url: rawWsUrl })
       });
       const signData = await signResp.json();