@tiktool/live 2.9.0 → 2.10.0

package/dist/index.mjs

@@ -2119,6 +2119,7 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
   _presetRoomId;
   _presetSessionId;
   proxyUrl;
+  mode;
   constructor(options) {
     super();
     this.setMaxListeners(20);
@@ -2133,6 +2134,7 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
     this._presetRoomId = options.roomId || "";
     this._presetSessionId = options.sessionId || "";
     this.proxyUrl = options.proxy || "";
+    this.mode = options.mode || "direct";
   }
   /**
    * Build an HttpsProxyAgent when `proxy` option is set, else undefined.
@@ -2152,6 +2154,9 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
   async connect() {
     if (this._destroyed) throw new Error("Client has been destroyed. Create a new instance.");
     this.intentionalClose = false;
+    if (this.mode === "relayed") {
+      return this._connectRelayed();
+    }
     let ttwid = this._presetSessionId;
     let roomId = this._presetRoomId;
     let clusterRegion = "";
@@ -2607,6 +2612,73 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
       this.heartbeatTimer = null;
     }
   }
+  /**
+   * Relayed-mode connect. Opens a plain WebSocket to TikTools' managed relay
+   * endpoint. Events arrive pre-decoded as `{event, data}` JSON envelopes.
+   * The SDK re-emits them on the same event names as Direct mode so user
+   * code is identical regardless of mode.
+   */
+  async _connectRelayed() {
+    const host = this.signServerUrl.replace(/^https:\/\//, "wss://").replace(/^http:\/\//, "ws://");
+    const wsUrl = `${host}/?uniqueId=${encodeURIComponent(this.uniqueId)}&apiKey=${encodeURIComponent(this.apiKey)}`;
+    if (this.debug) console.log(`[TikTokLive] Relayed mode: ${wsUrl.replace(this.apiKey, "***")}`);
+    return new Promise((resolve, reject) => {
+      this.ws = new WebSocket(wsUrl);
+      let firstOpen = true;
+      this.ws.on("open", () => {
+        this._connected = true;
+        this.reconnectAttempts = 0;
+        if (firstOpen) {
+          firstOpen = false;
+          resolve();
+        }
+        this.emit("connected");
+      });
+      this.ws.on("message", (raw) => {
+        try {
+          const msg = JSON.parse(raw.toString());
+          if (typeof msg !== "object" || !msg) return;
+          const evName = msg.event;
+          const evData = msg.data ?? msg;
+          if (!evName) return;
+          if (evName === "connected" || evName === "_journal" || evName === "ping" || evName === "pong") return;
+          if (evName === "roomInfo") {
+            const ri = {
+              roomId: evData.roomId || "",
+              wsHost: evData.wsHost || "",
+              clusterRegion: evData.clusterRegion || "",
+              connectedAt: evData.connectedAt || (/* @__PURE__ */ new Date()).toISOString()
+            };
+            this.emit("roomInfo", ri);
+            return;
+          }
+          this.emit(evName, evData);
+          this.emit("event", evData);
+        } catch {
+        }
+      });
+      this.ws.on("close", (code, reason) => {
+        this._connected = false;
+        const reasonStr = reason?.toString() || "";
+        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), 3e4);
+          if (this.debug) console.log(`[TikTokLive] Relayed reconnect in ${delay}ms (attempt ${this.reconnectAttempts}/${this.maxReconnectAttempts})`);
+          setTimeout(() => {
+            this._connectRelayed().catch(() => {
+            });
+          }, delay);
+        }
+      });
+      this.ws.on("error", (err) => {
+        if (firstOpen) {
+          firstOpen = false;
+          reject(err);
+        } else this.emit("error", err);
+      });
+    });
+  }
 };
 export {
   TikTokLive