tiktok-live-api 1.2.19 → 2.0.0

package/dist/index.mjs

@@ -1,7 +1,20 @@
 // src/client.ts
 import WebSocket from "ws";
 var WS_BASE = "wss://api.tik.tools";
-var VERSION = "1.0.0";
+var VERSION = "2.0.0";
+var EVENT_ALIASES = {
+  roomUserSeq: ["roomUser"],
+  question: ["questionNew"],
+  battle: ["linkMicBattle"],
+  battleArmies: ["linkMicArmies"],
+  emoteChat: ["emote"]
+};
+var REVERSE_ALIASES = {};
+for (const [native, aliases] of Object.entries(EVENT_ALIASES)) {
+  for (const alias of aliases) {
+    REVERSE_ALIASES[alias] = native;
+  }
+}
 var TikTokLive = class {
   /**
    * Create a new TikTokLive client.
@@ -21,8 +34,10 @@ var TikTokLive = class {
     this._intentionalClose = false;
     this._reconnectAttempts = 0;
     this._eventCount = 0;
+    this._roomId = "";
+    this._roomInfo = null;
     this.uniqueId = uniqueId.replace(/^@/, "");
-    this.apiKey = options.apiKey || process.env.TIKTOOL_API_KEY || "";
+    this.apiKey = options.apiKey || options.signApiKey || process.env.TIKTOOL_API_KEY || "";
     if (!this.apiKey) {
       throw new Error("apiKey is required. Get a free key at https://tik.tools");
     }
@@ -38,10 +53,17 @@ var TikTokLive = class {
     return this._eventCount;
   }
   on(event, handler) {
-    if (!this._handlers.has(event)) {
-      this._handlers.set(event, /* @__PURE__ */ new Set());
+    const nativeEvent = REVERSE_ALIASES[event] || event;
+    if (!this._handlers.has(nativeEvent)) {
+      this._handlers.set(nativeEvent, /* @__PURE__ */ new Set());
+    }
+    this._handlers.get(nativeEvent).add(handler);
+    if (nativeEvent !== event) {
+      if (!this._handlers.has(event)) {
+        this._handlers.set(event, /* @__PURE__ */ new Set());
+      }
+      this._handlers.get(event).add(handler);
     }
-    this._handlers.get(event).add(handler);
     return this;
   }
   /**
@@ -51,22 +73,47 @@ var TikTokLive = class {
    * @param handler - The handler to remove
    */
   off(event, handler) {
-    this._handlers.get(event)?.delete(handler);
+    const nativeEvent = REVERSE_ALIASES[event] || event;
+    this._handlers.get(nativeEvent)?.delete(handler);
+    if (nativeEvent !== event) {
+      this._handlers.get(event)?.delete(handler);
+    }
     return this;
   }
   _emit(event, data) {
     const handlers = this._handlers.get(event);
-    if (!handlers) return;
-    for (const handler of handlers) {
-      try {
-        const result = handler(data);
-        if (result instanceof Promise) {
-          result.catch(
-            (err) => console.error(`Error in '${event}' handler:`, err)
-          );
+    if (handlers) {
+      for (const handler of handlers) {
+        try {
+          const result = handler(data);
+          if (result instanceof Promise) {
+            result.catch(
+              (err) => console.error(`Error in '${event}' handler:`, err)
+            );
+          }
+        } catch (err) {
+          console.error(`Error in '${event}' handler:`, err);
+        }
+      }
+    }
+    const aliases = EVENT_ALIASES[event];
+    if (aliases) {
+      for (const alias of aliases) {
+        const aliasHandlers = this._handlers.get(alias);
+        if (aliasHandlers) {
+          for (const handler of aliasHandlers) {
+            try {
+              const result = handler(data);
+              if (result instanceof Promise) {
+                result.catch(
+                  (err) => console.error(`Error in '${alias}' handler:`, err)
+                );
+              }
+            } catch (err) {
+              console.error(`Error in '${alias}' handler:`, err);
+            }
+          }
         }
-      } catch (err) {
-        console.error(`Error in '${event}' handler:`, err);
       }
     }
   }
@@ -91,6 +138,7 @@ var TikTokLive = class {
         this._connected = true;
         this._reconnectAttempts = 0;
         this._emit("connected", { uniqueId: this.uniqueId });
+        this._emit("websocketConnected", { uniqueId: this.uniqueId });
         resolve();
       });
       this._ws.on("message", (raw) => {
@@ -99,14 +147,27 @@ var TikTokLive = class {
           this._eventCount++;
           const eventType = event.event || "unknown";
           const data = event.data || event;
+          if (eventType === "roomInfo") {
+            this._roomId = event.roomId || data.roomId || this._roomId;
+            this._roomInfo = data;
+          }
           this._emit("event", event);
+          this._emit("rawData", event);
+          this._emit("decodedData", event);
           this._emit(eventType, data);
+          if (eventType === "control" && data.action === 3) {
+            this._emit("streamEnd", data);
+          }
         } catch {
         }
       });
-      this._ws.on("close", () => {
+      this._ws.on("close", (code, reason) => {
         this._connected = false;
-        this._emit("disconnected", { uniqueId: this.uniqueId });
+        this._emit("disconnected", {
+          uniqueId: this.uniqueId,
+          code,
+          reason: reason?.toString()
+        });
         this._maybeReconnect();
       });
       this._ws.on("error", (err) => {
@@ -126,6 +187,23 @@ var TikTokLive = class {
     }
     this._connected = false;
   }
+  /**
+   * Get current connection state (TTLC-compatible).
+   */
+  getState() {
+    return {
+      isConnected: this._connected,
+      roomId: this._roomId,
+      roomInfo: this._roomInfo,
+      uniqueId: this.uniqueId
+    };
+  }
+  /**
+   * Get room info (TTLC-compatible).
+   */
+  getRoomInfo() {
+    return this._roomInfo;
+  }
   async _maybeReconnect() {
     if (this._intentionalClose || !this.autoReconnect || this._reconnectAttempts >= this.maxReconnectAttempts) {
       return;
@@ -247,7 +325,77 @@ var TikTokCaptions = class {
     this._connected = false;
   }
 };
+
+// src/compat.ts
+var ControlEvents = {
+  CONNECTED: "connected",
+  DISCONNECTED: "disconnected",
+  ERROR: "error",
+  RAWDATA: "rawData",
+  DECODEDDATA: "decodedData",
+  STREAMEND: "streamEnd",
+  WSCONNECTED: "websocketConnected"
+};
+var MessageEvents = {
+  CHAT: "chat",
+  MEMBER: "member",
+  GIFT: "gift",
+  ROOMUSER: "roomUser",
+  SOCIAL: "social",
+  LIKE: "like",
+  QUESTIONNEW: "questionNew",
+  LINKMICBATTLE: "linkMicBattle",
+  LINKMICARMIES: "linkMicArmies",
+  LIVEINTRO: "liveIntro",
+  EMOTE: "emote",
+  ENVELOPE: "envelope",
+  SUBSCRIBE: "subscribe",
+  BARRAGE: "barrage",
+  SUPERFAN: "superFan",
+  SUPERFANJOIN: "superFanJoin",
+  SUPERFANBOX: "superFanBox",
+  ROOMPIN: "roomPin"
+};
+var CustomEvents = {
+  FOLLOW: "follow",
+  SHARE: "share"
+};
+var WebcastPushConnection = class extends TikTokLive {
+  constructor(uniqueId, options = {}) {
+    const opts = {
+      ...options,
+      apiKey: options.apiKey || options.signApiKey
+    };
+    super(uniqueId, opts);
+  }
+  /**
+   * Get current connection state — TTLC-compatible shape.
+   *
+   * Returns the same structure as TikTok-Live-Connector's `getState()`.
+   */
+  getState() {
+    return {
+      isConnected: this._connected,
+      upgradedToWebsocket: this._connected,
+      roomId: this._roomId,
+      roomInfo: this._roomInfo,
+      availableGifts: [],
+      uniqueId: this.uniqueId
+    };
+  }
+  /**
+   * Get available gifts — TTLC-compatible.
+   * Note: Gift info is included in event payloads automatically.
+   */
+  getAvailableGifts() {
+    return [];
+  }
+};
 export {
+  ControlEvents,
+  CustomEvents,
+  MessageEvents,
   TikTokCaptions,
-  TikTokLive
+  TikTokLive,
+  WebcastPushConnection
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiktok-live-api",
-  "version": "1.2.19",
+  "version": "2.0.0",
   "description": "Unofficial TikTok LIVE API Client — Real-time chat, gifts, viewers, battles, and AI live captions from any TikTok livestream. Managed WebSocket API with 99.9% uptime.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -85,4 +85,4 @@
   "engines": {
     "node": ">=16.0.0"
   }
-}
+}