tiktok-live-api 1.2.18 → 1.3.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 TikTool
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 TikTool
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,9 +1,11 @@
 <p align="center">
-  <img src="banner.png" alt="tiktok-live-api" width="100%" />
+  <img src="https://raw.githubusercontent.com/tiktool/tiktok-live-api/main/banner.png" alt="tiktok-live-api" width="100%" />
 </p>
 
 # tiktok-live-api
 
+> 📖 **Full documentation, guides, and dashboard → [tik.tools](https://tik.tools)** &nbsp;|&nbsp; 🐍 **Python SDK → [tik.tools/guides/python-tiktok-live](https://tik.tools/guides/python-tiktok-live)** &nbsp;|&nbsp; 🔌 **WebSocket API → [tik.tools/websocket](https://tik.tools/websocket)**
+
 **Unofficial TikTok LIVE API Client for Node.js & TypeScript** — Connect to any TikTok LIVE stream and receive real-time chat messages, gifts, likes, follows, viewer counts, battles, and more. Includes AI-powered live captions (speech-to-text). Powered by the [TikTool](https://tik.tools) managed API.
 
 [![npm](https://img.shields.io/npm/v/tiktok-live-api)](https://www.npmjs.com/package/tiktok-live-api)
@@ -18,17 +20,6 @@
 
 > This package is **not affiliated with or endorsed by TikTok**. It connects to the [TikTool Live](https://tik.tools) managed API service — 99.9% uptime, no reverse engineering, no maintenance required. Also available for [Python](https://pypi.org/project/tiktok-live-api/) and [any language via WebSocket](https://tik.tools/docs).
 
-## 🚀 One-Command Quick Start
-
-Instantly connect to a live TikTok stream and print real-time events to your terminal. No signup, no install:
-
-```bash
-npx tiktok-live-api
-```
-*Or connect to a specific stream:* `npx tiktok-live-api @username`
-
----
-
 ## Install
 
 ```bash
@@ -200,7 +191,9 @@ client.connect();
 | `member` | Viewer joined | `user` |
 | `subscribe` | New subscriber | `user` |
 | `roomUserSeq` | Viewer count | `viewerCount`, `topViewers` |
-| `battle` | Battle event | `type`, `teams`, `scores` |
+| `battle` | PK start / end / status change | `battleId`, `status` (1=ACTIVE / 2=STARTING / 3=ENDED / 4=PREPARING), `battleDuration`, `teams` |
+| `battleArmies` | Live PK score update | `battleId`, `status`, `matchId`, `sessionId`, `durationSec`, `secsRemaining`, `hosts[]` — each host has `teamTotalScore` + `contributors[]` (MVP first) |
+| `battleItemCard` | Booster multipliers, gloves, mist, match-guide, thunder, extra-time | `effect` (`'gloves'` / `'mist'` / `'booster_x2'` / `'booster_x3'` / `'match_guide'` / ...), `multiplier` (2 or 3), `senderUserId`, `senderNickname`, `activatedAtSec`, `durationSec`, `endsAtSec`, `commentTemplate` |
 | `roomPin` | Pinned/starred message | `user`, `comment`, `action`, `durationSeconds` |
 | `envelope` | Treasure chest | `diamonds`, `user` |
 | `streamEnd` | Stream ended | `reason` |
@@ -211,80 +204,44 @@ client.connect();
 
 All events are fully typed with TypeScript interfaces. Your IDE will show autocompletion for every field.
 
-## Live Captions (Speech-to-Text)
-
-Transcribe and translate any TikTok LIVE stream in real-time. **This feature is unique to TikTool Live — no other TikTok library offers it.**
+### Battle / PK example
 
 ```typescript
-import { TikTokCaptions } from 'tiktok-live-api';
+import { TikTokLive } from 'tiktok-live-api';
 
-<<<<<<< HEAD
-live.on('event', (event) => {
-    console.log(event.type, event);
-});
-```
+const client = new TikTokLive({ uniqueId: 'creator_username', apiKey: 'tk_...' });
 
-### Reference
-
-| Event | Type | Description | Fields |
-|-------|------|-------------|--------|
-| `chat` | `ChatEvent` | Chat message | `user`, `comment`, `starred?` |
-| `member` | `MemberEvent` | User joined | `user`, `action` |
-| `like` | `LikeEvent` | User liked | `user`, `likeCount`, `totalLikes` |
-| `gift` | `GiftEvent` | Gift sent | `user`, `giftName`, `diamondCount`, `repeatCount`, `combo` |
-| `social` | `SocialEvent` | Follow / Share | `user`, `action` |
-| `roomUserSeq` | `RoomUserSeqEvent` | Viewer count | `viewerCount`, `totalViewers` |
-| `battle` | `BattleEvent` | Link Mic battle | `status` |
-| `battleArmies` | `BattleArmiesEvent` | Battle teams | — |
-| `subscribe` | `SubscribeEvent` | New subscriber | `user`, `subMonth` |
-| `emoteChat` | `EmoteChatEvent` | Emote in chat | `user`, `emoteId` |
-| `envelope` | `EnvelopeEvent` | Treasure chest | `diamondCount` |
-| `question` | `QuestionEvent` | Q&A question | `user`, `questionText` |
-| `control` | `ControlEvent` | Stream control | `action` (3 = ended) |
-| `room` | `RoomEvent` | Room status | `status` |
-| `liveIntro` | `LiveIntroEvent` | Stream intro | `title` |
-| `rankUpdate` | `RankUpdateEvent` | Rank update | `rankType` |
-| `linkMic` | `LinkMicEvent` | Link Mic | `action` |
-| `roomPin` | `RoomPinEvent` | Pinned/starred message | `user`, `comment`, `action`, `durationSeconds` |
-| `unknown` | `UnknownEvent` | Unrecognized | `method` |
-
-### Connection Events
-
-| Event | Callback | Description |
-|-------|----------|-------------|
-| `connected` | `() => void` | Connected to stream |
-| `disconnected` | `(code, reason) => void` | Disconnected |
-| `roomInfo` | `(info: RoomInfo) => void` | Room info |
-| `error` | `(error: Error) => void` | Error |
+client.on('battle', e => console.log('PK', e.status, e.battleId, 'duration=', e.battleDuration));
 
----
+client.on('battleArmies', e => {
+  console.log('Countdown:', e.secsRemaining, 's');
+  for (const host of e.hosts ?? []) {
+    console.log(`@${host.hostUserId} team total=${host.teamTotalScore}`);
+    const mvp = host.contributors[0];
+    if (mvp) console.log(`  MVP @${mvp.nickname} score=${mvp.score}`);
+  }
+});
 
-## 🎤 Real-Time Live Captions
+client.on('battleItemCard', e => {
+  if (e.multiplier > 0) console.log(`x${e.multiplier} booster from @${e.senderUniqueId}`);
+  else console.log(`Effect ${e.effect} from @${e.senderUniqueId} (${e.durationSec}s)`);
+});
 
-AI-powered speech-to-text transcription and translation for TikTok LIVE streams. Features include:
+await client.connect();
+```
 
-- **Auto-detect language** — Automatically identifies the spoken language
-- **Speaker diarization** — Identifies individual speakers in multi-person streams
-- **Real-time translation** — Translate to any supported language with sub-second latency
-- **Partial + final results** — Get streaming partial transcripts and confirmed final text
-- **Credit-based billing** — 1 credit = 1 minute of transcription/translation
 
-### Quick Start
+## Live Captions (Speech-to-Text)
+
+Transcribe and translate any TikTok LIVE stream in real-time. **This feature is unique to TikTool Live — no other TikTok library offers it.**
 
 ```typescript
-import { TikTokCaptions } from '@tiktool/live';
-
-const captions = new TikTokCaptions({
-    uniqueId: 'streamer_name',
-    apiKey: 'YOUR_API_KEY',
-    translate: 'en',
-    diarization: true,
-=======
+import { TikTokCaptions } from 'tiktok-live-api';
+
 const captions = new TikTokCaptions('streamer_username', {
   apiKey: 'YOUR_API_KEY',
   translate: 'en',       // translate to English
   diarization: true,     // identify who is speaking
->>>>>>> ac7990ac0be77c4206d9d8fa0bccbe1c85a2bbe6
 });
 
 captions.on('caption', (event) => {
@@ -424,9 +381,16 @@ client.on('gift', (event: GiftEvent) => {
 | Tier | Requests/Day | WebSocket Connections | Price |
 |------|-------------|----------------------|-------|
 | Sandbox | 50 | 1 (5 min) | Free |
-| Basic | 10,000 | 3 (8h) | $7/week |
-| Pro | 75,000 | 50 (8h) | $15/week |
-| Ultra | 300,000 | 500 (8h) | $45/week |
+| Basic | 10,000 | 3 (8h) | $9/wk +tax |
+| Pro | 75,000 | 50 (8h) | $19/wk +tax |
+| Ultra | 300,000 | 250 (8h) | $58/wk +tax |
+
+Full plan details at [tik.tools/pricing](https://tik.tools/pricing). Highlights:
+
+- **Sandbox** ($0): 50 req/day · 1 WS (5 min limit) · basic endpoints · signatures included
+- **Basic** ($9/wk): 10K req/day · 3 WS · all endpoints · 1 AI caption stream
+- **Pro** ($19/wk, **most popular**): 75K req/day · 50 WS · all endpoints · 5 AI caption streams · priority routing · chat support
+- **Ultra** ($58/wk): 300K req/day · 250 WS · 20 AI caption streams · **League Rankings API** (Ultra only) · 99.5% uptime SLA · priority chat support
 
 ## Also Available
 

package/dist/index.d.mts

@@ -59,12 +59,70 @@ interface RoomUserSeqEvent {
     viewerCount: number;
     topViewers: TikTokUser[];
 }
-/** Payload for `battle` events. */
+/** Payload for `battle` events (PK start / end / countdown). */
 interface BattleEvent {
     type: string;
+    battleId: string;
+    /** 1=ACTIVE, 2=STARTING, 3=ENDED, 4=PREPARING */
+    status: number;
+    battleDuration: number;
     teams: Array<Record<string, unknown>>;
     scores: number[];
 }
+/** One host on a battle side — present per-host in multi-guest PK. */
+interface BattleHost {
+    hostUserId: string;
+    teamTotalScore: number;
+    teamIdx: number;
+    /** Sorted MVP first (highest score → lowest). */
+    contributors: BattleContributor[];
+}
+interface BattleContributor {
+    userId: string;
+    score: number;
+    nickname: string;
+}
+/** Payload for `battleArmies` events — score updates during PK. */
+interface BattleArmiesEvent {
+    battleId: string;
+    /** 1=ACTIVE, 2=STARTING, 3=ENDED, 4=PREPARING */
+    status: number;
+    teams: Array<Record<string, unknown>>;
+    matchId?: string;
+    sessionId?: string;
+    startedAtMs?: number;
+    serverTsMs?: number;
+    sessionTag?: string;
+    durationSec?: number;
+    secsRemaining?: number;
+    /** Per-host breakdown with MVP contributors. */
+    hosts?: BattleHost[];
+}
+/** Payload for `battleItemCard` events — multipliers (x2/x3), gloves, mist, etc. */
+interface BattleItemCardEvent {
+    battleId: string;
+    cardType: number;
+    /** 'gloves' | 'mist' | 'booster_x2' | 'booster_x3' | 'match_guide' |
+     *  'thunder' | 'extra_time' | raw resource key. */
+    effect: string;
+    effectKey: string;
+    /** 2 or 3 for booster_x2/x3, otherwise 0. */
+    multiplier: number;
+    senderUserId: string;
+    senderNickname: string;
+    senderUniqueId: string;
+    senderAvatarUrl: string;
+    activatedAtSec: number;
+    durationSec: number;
+    endsAtSec: number;
+    commentTemplate: string;
+    /** Full TikTok CDN URL for the card art (webp/jpeg). */
+    iconUrl: string;
+    /** Short identifier e.g. 'card_mist_v3' / 'card_crit_v3' / 'top3_buffer'. */
+    iconKey: string;
+    /** Hex e.g. '#BCD9E0' (mist blue), '#E0D4BC' (gloves tan). */
+    accentColor: string;
+}
 /** Payload for `roomPin` (starred/pinned message) events. */
 interface RoomPinEvent {
     /** User who wrote the pinned message. */
@@ -128,6 +186,8 @@ interface TikTokLiveEventMap {
     subscribe: SocialEvent;
     roomUserSeq: RoomUserSeqEvent;
     battle: BattleEvent;
+    battleArmies: BattleArmiesEvent;
+    battleItemCard: BattleItemCardEvent;
     roomPin: RoomPinEvent;
     envelope: Record<string, unknown>;
     streamEnd: Record<string, unknown>;

package/dist/index.d.ts

@@ -59,12 +59,70 @@ interface RoomUserSeqEvent {
     viewerCount: number;
     topViewers: TikTokUser[];
 }
-/** Payload for `battle` events. */
+/** Payload for `battle` events (PK start / end / countdown). */
 interface BattleEvent {
     type: string;
+    battleId: string;
+    /** 1=ACTIVE, 2=STARTING, 3=ENDED, 4=PREPARING */
+    status: number;
+    battleDuration: number;
     teams: Array<Record<string, unknown>>;
     scores: number[];
 }
+/** One host on a battle side — present per-host in multi-guest PK. */
+interface BattleHost {
+    hostUserId: string;
+    teamTotalScore: number;
+    teamIdx: number;
+    /** Sorted MVP first (highest score → lowest). */
+    contributors: BattleContributor[];
+}
+interface BattleContributor {
+    userId: string;
+    score: number;
+    nickname: string;
+}
+/** Payload for `battleArmies` events — score updates during PK. */
+interface BattleArmiesEvent {
+    battleId: string;
+    /** 1=ACTIVE, 2=STARTING, 3=ENDED, 4=PREPARING */
+    status: number;
+    teams: Array<Record<string, unknown>>;
+    matchId?: string;
+    sessionId?: string;
+    startedAtMs?: number;
+    serverTsMs?: number;
+    sessionTag?: string;
+    durationSec?: number;
+    secsRemaining?: number;
+    /** Per-host breakdown with MVP contributors. */
+    hosts?: BattleHost[];
+}
+/** Payload for `battleItemCard` events — multipliers (x2/x3), gloves, mist, etc. */
+interface BattleItemCardEvent {
+    battleId: string;
+    cardType: number;
+    /** 'gloves' | 'mist' | 'booster_x2' | 'booster_x3' | 'match_guide' |
+     *  'thunder' | 'extra_time' | raw resource key. */
+    effect: string;
+    effectKey: string;
+    /** 2 or 3 for booster_x2/x3, otherwise 0. */
+    multiplier: number;
+    senderUserId: string;
+    senderNickname: string;
+    senderUniqueId: string;
+    senderAvatarUrl: string;
+    activatedAtSec: number;
+    durationSec: number;
+    endsAtSec: number;
+    commentTemplate: string;
+    /** Full TikTok CDN URL for the card art (webp/jpeg). */
+    iconUrl: string;
+    /** Short identifier e.g. 'card_mist_v3' / 'card_crit_v3' / 'top3_buffer'. */
+    iconKey: string;
+    /** Hex e.g. '#BCD9E0' (mist blue), '#E0D4BC' (gloves tan). */
+    accentColor: string;
+}
 /** Payload for `roomPin` (starred/pinned message) events. */
 interface RoomPinEvent {
     /** User who wrote the pinned message. */
@@ -128,6 +186,8 @@ interface TikTokLiveEventMap {
     subscribe: SocialEvent;
     roomUserSeq: RoomUserSeqEvent;
     battle: BattleEvent;
+    battleArmies: BattleArmiesEvent;
+    battleItemCard: BattleItemCardEvent;
     roomPin: RoomPinEvent;
     envelope: Record<string, unknown>;
     streamEnd: Record<string, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiktok-live-api",
-  "version": "1.2.18",
+  "version": "1.3.1",
   "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",
@@ -12,12 +12,8 @@
       "require": "./dist/index.js"
     }
   },
-  "bin": {
-    "tiktok-live-api": "./bin/demo.mjs"
-  },
   "files": [
     "dist",
-    "bin",
     "README.md",
     "LICENSE"
   ],

package/bin/demo.mjs

@@ -1,685 +0,0 @@
-#!/usr/bin/env node
-
-import WebSocket from 'ws';
-import readline from 'readline';
-import { execSync } from 'child_process';
-import fs from 'fs';
-import path from 'path';
-
-// ── Boilerplate Components ─────────────────────────────────────────────
-
-const REACT_TEMPLATE = [
-  '"use client";',
-  "import React, { useEffect, useState, useRef } from 'react';",
-  "",
-  "export default function TikTokLiveComponent() {",
-  "  const [events, setEvents] = useState([]);",
-  "  const [inputUsername, setInputUsername] = useState('gbnews');",
-  "  const [apiKey, setApiKey] = useState('demo_tiktokliveapi_public_2026');",
-  "  const [connected, setConnected] = useState(false);",
-  "  const wsRef = useRef(null);",
-  "",
-  "  function addEvent(str) {",
-  "    setEvents(prev => [...prev.slice(-50), str]);",
-  "  }",
-  "",
-  "  function connectStream(e) {",
-  "    if (e) e.preventDefault();",
-  "    if (wsRef.current) { wsRef.current.close(); wsRef.current = null; }",
-  "    setEvents([]);",
-  "    setConnected(false);",
-  "    const user = (inputUsername || '').replace(/^@/, '');",
-  "    if (!user) return;",
-  "    try {",
-  "      const ws = new WebSocket('wss://api.tik.tools?uniqueId=' + user + '&apiKey=' + apiKey);",
-  "      wsRef.current = ws;",
-  "      ws.onopen = () => { setConnected(true); addEvent('Connected to @' + user); };",
-  "      ws.onclose = () => { setConnected(false); wsRef.current = null; };",
-  "      ws.onerror = () => { addEvent('WebSocket error'); };",
-  "      ws.onmessage = (evt) => {",
-  "        try {",
-  "          const msg = JSON.parse(evt.data);",
-  "          const t = msg.event || '';",
-  "          const d = msg.data || {};",
-  "          const u = d.user ? d.user.uniqueId : '';",
-  "          if (t === 'chat') addEvent('[chat] ' + u + ': ' + d.comment);",
-  "          else if (t === 'gift') addEvent('[gift] ' + u + ' sent ' + (d.giftName || 'a gift'));",
-  "          else if (t === 'like') addEvent('[like] ' + u + ' liked');",
-  "          else if (t === 'member') addEvent('[join] ' + u + ' joined');",
-  "          else if (t === 'roomUserSeq') addEvent('[viewers] ' + (d.viewerCount || 0));",
-  "        } catch (err) {}",
-  "      };",
-  "    } catch (err) { addEvent('Connection failed: ' + err.message); }",
-  "  }",
-  "",
-  "  useEffect(() => { return () => { if (wsRef.current) wsRef.current.close(); }; }, []);",
-  "",
-  "  return (",
-  "    <div style={{ fontFamily: 'system-ui, sans-serif', maxWidth: 600, margin: '40px auto', border: '1px solid #e5e7eb', borderRadius: '12px', boxShadow: '0 10px 15px -3px rgba(0, 0, 0, 0.1)', background: '#fff' }}>",
-  "      <div style={{ padding: '24px', borderBottom: '1px solid #e5e7eb' }}>",
-  "        <h2 style={{ margin: '0 0 8px 0', fontSize: '1.5rem', fontWeight: 700, color: '#111827' }}>TikTok Live SDK</h2>",
-  "        <p style={{ margin: 0, fontSize: '0.875rem', color: '#4b5563' }}>",
-  '          Get your own API key at <a href="https://tik.tools" target="_blank" style={{ color: \'#3b82f6\', textDecoration: \'none\' }}>tik.tools</a>',
-  "        </p>",
-  "      </div>",
-  "      <div style={{ padding: '24px' }}>",
-  "        <form onSubmit={connectStream} style={{ display: 'flex', flexDirection: 'column', gap: '16px', marginBottom: '24px' }}>",
-  "          <div>",
-  "            <label style={{ display: 'block', fontSize: '0.875rem', fontWeight: 600, marginBottom: '6px', color: '#111827' }}>TikTok Username</label>",
-  '            <input type="text" value={inputUsername} onChange={(e) => setInputUsername(e.target.value)} style={{ width: \'100%\', padding: \'8px 12px\', borderRadius: \'6px\', border: \'1px solid #d1d5db\', boxSizing: \'border-box\', color: \'#111827\' }} placeholder="e.g. gbnews" />',
-  "          </div>",
-  "          <div>",
-  "            <label style={{ display: 'block', fontSize: '0.875rem', fontWeight: 600, marginBottom: '6px', color: '#111827' }}>API Key</label>",
-  '            <input type="text" value={apiKey} onChange={(e) => setApiKey(e.target.value)} style={{ width: \'100%\', padding: \'8px 12px\', borderRadius: \'6px\', border: \'1px solid #d1d5db\', boxSizing: \'border-box\', fontFamily: \'monospace\', color: \'#111827\' }} />',
-  "            <p style={{ margin: '4px 0 0 0', fontSize: '0.75rem', color: '#6b7280' }}>The demo key is rate-limited. Replace with your own key for production.</p>",
-  "          </div>",
-  '          <button type="submit" style={{ background: \'#111827\', color: \'#fff\', padding: \'10px 16px\', borderRadius: \'6px\', border: \'none\', fontWeight: 600, cursor: \'pointer\', fontSize: \'0.875rem\' }}>Connect Stream</button>',
-  "        </form>",
-  "        <div style={{ marginBottom: '16px', display: 'flex', alignItems: 'center', gap: '8px' }}>",
-  "          <div style={{ width: 10, height: 10, borderRadius: '50%', background: connected ? '#10b981' : '#ef4444', transition: 'background 0.3s' }}></div>",
-  "          <span style={{ fontSize: '0.875rem', color: '#111827', fontWeight: 600 }}>{connected ? 'Connected' : 'Disconnected'}</span>",
-  "        </div>",
-  "        <div style={{ height: 350, overflowY: 'auto', background: '#f9fafb', padding: '12px', borderRadius: '8px', border: '1px solid #e5e7eb', fontSize: '0.875rem', display: 'flex', flexDirection: 'column' }}>",
-  "          {events.map((e, i) => <div key={i} style={{ padding: '6px 0', borderBottom: '1px solid #f3f4f6', wordBreak: 'break-word', color: '#374151' }}>{e}</div>)}",
-  "          {events.length === 0 && <div style={{ color: '#9ca3af', textAlign: 'center', margin: 'auto 0' }}>{connected ? 'Waiting for events...' : 'Connect to see events'}</div>}",
-  "        </div>",
-  "      </div>",
-  "    </div>",
-  "  );",
-  "}",
-].join('\n') + "\n";
-
-const VUE_TEMPLATE = [
-  "<template>",
-  '  <div style="font-family: system-ui, sans-serif; max-width: 600px; margin: 40px auto; border: 1px solid #e5e7eb; border-radius: 12px; box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1); background: #fff">',
-  '    <div style="padding: 24px; border-bottom: 1px solid #e5e7eb">',
-  '      <h2 style="margin: 0 0 8px 0; font-size: 1.5rem; font-weight: 600">TikTok Live SDK</h2>',
-  '      <p style="margin: 0; font-size: 0.875rem; color: #6b7280">',
-  '        Get your own API key and unlock unlimited connections at <a href="https://tik.tools" target="_blank" style="color: #3b82f6; text-decoration: none">tik.tools</a>',
-  "      </p>",
-  "    </div>",
-  '    <div style="padding: 24px">',
-  '      <form @submit.prevent="handleConnect" style="display: flex; flex-direction: column; gap: 16px; margin-bottom: 24px">',
-  "        <div>",
-  '          <label style="display: block; font-size: 0.875rem; font-weight: 500; margin-bottom: 6px">TikTok Username</label>',
-  '          <input type="text" v-model="inputUsername" style="width: 100%; padding: 8px 12px; border-radius: 6px; border: 1px solid #d1d5db; box-sizing: border-box" placeholder="e.g. gbnews" />',
-  "        </div>",
-  "        <div>",
-  '          <label style="display: block; font-size: 0.875rem; font-weight: 500; margin-bottom: 6px">API Key</label>',
-  '          <input type="text" v-model="apiKey" style="width: 100%; padding: 8px 12px; border-radius: 6px; border: 1px solid #d1d5db; box-sizing: border-box; font-family: monospace" />',
-  '          <p style="margin: 4px 0 0 0; font-size: 0.75rem; color: #9ca3af">The demo key is rate-limited. Replace with your own key for production.</p>',
-  "        </div>",
-  '        <button type="submit" style="background: #000; color: #fff; padding: 10px 16px; border-radius: 6px; border: none; font-weight: 500; cursor: pointer">Connect Stream</button>',
-  "      </form>",
-  '      <div style="margin-bottom: 16px; display: flex; align-items: center; gap: 8px">',
-  "        <div :style=\"{ width: '10px', height: '10px', borderRadius: '50%', background: connected ? '#10b981' : '#ef4444', transition: 'background 0.3s' }\"></div>",
-  "        <span style=\"font-size: 0.875rem; color: '#374151'; font-weight: 500\">{{ connected ? 'Connected to @' + activeUsername : 'Disconnected' }}</span>",
-  "      </div>",
-  '      <div style="height: 350px; overflow-y: auto; background: #f9fafb; padding: 12px; border-radius: 8px; border: 1px solid #e5e7eb; font-size: 0.875rem; display: flex; flex-direction: column">',
-  '        <div v-for="(e, i) in events" :key="i" style="padding: 6px 0; border-bottom: 1px solid #f3f4f6; word-break: break-word">',
-  "          {{ e }}",
-  "        </div>",
-  '        <div v-if="events.length === 0" style="color: #9ca3af; text-align: center; margin: auto 0">{{ connected ? "Waiting for events..." : "Connect to a valid stream to see events" }}</div>',
-  "      </div>",
-  "    </div>",
-  "  </div>",
-  "</template>",
-  "",
-  "<script setup>",
-  "import { ref, onMounted, onUnmounted } from 'vue'",
-  "",
-  "const inputUsername = ref('gbnews')",
-  "const activeUsername = ref('gbnews')",
-  "const apiKey = ref('demo_tiktokliveapi_public_2026')",
-  "const connected = ref(false)",
-  "const events = ref([])",
-  "let ws = null",
-  "",
-  "function addEvent(str) {",
-  "  events.value.push(str)",
-  "  if (events.value.length > 50) events.value.shift()",
-  "}",
-  "",
-  "function connectStream() {",
-  "  if (ws) { ws.close(); ws = null }",
-  "  events.value = []",
-  "  connected.value = false",
-  "  activeUsername.value = inputUsername.value",
-  "  const user = (activeUsername.value || '').replace(/^@/, '')",
-  "  if (!user) return",
-  "  const key = apiKey.value || ''",
-  "  try {",
-  "    ws = new WebSocket('wss://api.tik.tools?uniqueId=' + user + '&apiKey=' + key)",
-  "  } catch (e) { addEvent('⚠️ Connection failed: ' + e.message); return }",
-  "  ws.onopen = () => { connected.value = true; addEvent('✅ Connected to @' + user) }",
-  "  ws.onclose = () => { connected.value = false; ws = null; addEvent('❌ Disconnected') }",
-  "  ws.onerror = () => { addEvent('⚠️ WebSocket error') }",
-  "  ws.onmessage = (evt) => {",
-  "    try {",
-  "      const msg = JSON.parse(evt.data)",
-  "      const t = msg.event || ''",
-  "      const d = msg.data || {}",
-  "      const u = d.user ? d.user.uniqueId : ''",
-  "      if (t === 'chat') addEvent('💬 ' + u + ': ' + d.comment)",
-  "      else if (t === 'gift') addEvent('🎁 ' + u + ' sent ' + (d.giftName || 'a gift'))",
-  "      else if (t === 'like') addEvent('❤️ ' + u + ' liked')",
-  "      else if (t === 'member') addEvent('👋 ' + u + ' joined')",
-  "    } catch (e) {}",
-  "  }",
-  "}",
-  "",
-  "const handleConnect = () => { connectStream() }",
-  "",
-  "onMounted(() => { connectStream() })",
-  "onUnmounted(() => { if (ws) ws.close() })",
-  "</script>"
-].join('\n') + "\n";
-
-const E = String.fromCharCode(27);
-const R = E + "[0m";
-const B = E + "[1m";
-const D = E + "[2m";
-const C = {
-  cyan: E + "[38;5;80m", green: E + "[38;5;114m", yellow: E + "[38;5;222m",
-  mag: E + "[38;5;176m", blue: E + "[38;5;111m", red: E + "[38;5;203m",
-  gray: E + "[38;5;242m", white: E + "[38;5;252m", pink: E + "[38;5;218m",
-};
-
-// ── Interactive Prompt ──────────────────────────────────────────────────
-
-const args = process.argv.slice(2);
-const isInteractive = args.length === 0;
-
-if (!isInteractive) {
-  runDemo();
-} else {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-
-  console.log("\n  " + B + "tiktok-live-api" + R + "\n  Unofficial TikTok LIVE SDK by TikTool\n");
-  console.log("  What would you like to do?");
-  console.log("  1) " + C.cyan + "Watch Live Terminal Demo" + R);
-  console.log("  2) " + C.green + "Scaffold a Nuxt 3 (Vue) App" + R);
-  console.log("  3) " + C.blue + "Scaffold a Next.js (React) App" + R);
-  console.log("  4) " + C.yellow + "Scaffold a Vite (React) App" + R);
-  console.log("  5) " + C.mag + "Scaffold a Plain Node.js Project" + R);
-  console.log("  6) " + C.pink + "Scaffold a Python Project" + R + "\n");
-
-  function promptAction() {
-    rl.question("  Choose [1-6]: ", (answer) => {
-      handleMenu(answer.trim());
-    });
-  }
-
-  function handleMenu(choice) {
-    if (choice === '1') {
-      rl.close();
-      return runDemo();
-    }
-
-    if (!['2', '3', '4', '5', '6'].includes(choice)) {
-      console.log("  " + C.red + "Invalid choice." + R);
-      return promptAction();
-    }
-
-    rl.question("\n  Target directory (e.g. ./my-app) [./tiktok-live-project]: ", (dir) => {
-      dir = dir.trim() || './tiktok-live-project';
-
-      if (choice === '6') {
-        rl.close();
-        return runScaffold(choice, dir, 'pip');
-      }
-
-      console.log("\n  Select Package Manager:");
-      console.log("  1) npm " + D + "(Default)" + R);
-      console.log("  2) yarn");
-      console.log("  3) pnpm");
-      console.log("  4) bun");
-
-      rl.question("\n  Choose [1-4]: ", (pmAnswer) => {
-        const pmChoice = pmAnswer.trim() || '1';
-        const pmMap = { '1': 'npm', '2': 'yarn', '3': 'pnpm', '4': 'bun' };
-        const pm = pmMap[pmChoice] || 'npm';
-
-        rl.close();
-        runScaffold(choice, dir, pm);
-      });
-    });
-  }
-
-  promptAction();
-}
-
-// ── Scaffolding Logic ───────────────────────────────────────────────────
-
-function runScaffold(choice, targetDir, pm) {
-  const isNuxt = choice === '2';
-  const isNext = choice === '3';
-  const isVite = choice === '4';
-  const isNode = choice === '5';
-  const isPython = choice === '6';
-  const fullPath = path.resolve(process.cwd(), targetDir);
-
-  const npxCmd = pm === 'bun' ? 'bunx' : (pm === 'pnpm' ? 'pnpm dlx' : 'npx');
-  const installCmd = pm === 'npm' ? 'npm install tiktok-live-api' : pm === 'yarn' ? 'yarn add tiktok-live-api' : pm === 'pnpm' ? 'pnpm add tiktok-live-api' : 'bun add tiktok-live-api';
-  const devCmd = pm === 'npm' ? 'npm run dev' : pm === 'yarn' ? 'yarn dev' : pm === 'pnpm' ? 'pnpm dev' : 'bun run dev';
-
-  console.log("\n  " + B + "🚀 Scaffolding project into " + targetDir + " using " + pm + "..." + R + "\n");
-
-  try {
-    if (isNode) {
-      if (!fs.existsSync(fullPath)) fs.mkdirSync(fullPath, { recursive: true });
-    } else if (isPython) {
-      if (!fs.existsSync(fullPath)) fs.mkdirSync(fullPath, { recursive: true });
-    } else if (isNuxt) {
-      execSync(npxCmd + ' nuxi@latest init "' + targetDir + '" --packageManager ' + pm, { stdio: 'inherit' });
-    } else if (isNext) {
-      execSync(npxCmd + ' create-next-app@latest "' + targetDir + '" --js --eslint --tailwind --app --src-dir --import-alias "@/*" --use-' + pm, { stdio: 'inherit' });
-    } else if (isVite) {
-      execSync(npxCmd + ' create-vite@latest "' + targetDir + '" --no-interactive --template react', { stdio: 'inherit' });
-    }
-
-    if (isNode) {
-      // ── Plain Node.js Starter Kit ──
-      const pkgJson = {
-        name: path.basename(fullPath),
-        version: '1.0.0',
-        type: 'module',
-        scripts: { start: 'node index.mjs', dev: 'node --watch index.mjs' },
-        dependencies: {}
-      };
-      fs.writeFileSync(path.join(fullPath, 'package.json'), JSON.stringify(pkgJson, null, 2) + '\n');
-
-      console.log("\n  " + B + "📦 Installing " + C.cyan + "tiktok-live-api" + B + " SDK..." + R + "\n");
-      execSync(installCmd, { cwd: fullPath, stdio: 'inherit' });
-
-      fs.writeFileSync(path.join(fullPath, 'index.mjs'), [
-        "import { TikTokLive } from 'tiktok-live-api';",
-        "",
-        "// ── Configuration ───────────────────────────────────────",
-        "const USERNAME = 'gbnews';            // TikTok @username",
-        "const API_KEY  = 'demo_tiktokliveapi_public_2026'; // Get yours at https://tik.tools",
-        "",
-        "// ── Connect ─────────────────────────────────────────────",
-        "const client = new TikTokLive(USERNAME, { apiKey: API_KEY });",
-        "",
-        "client.on('connected', () => {",
-        "  console.log('\\n✅ Connected to @' + USERNAME + '\\n');",
-        "});",
-        "",
-        "client.on('chat', (data) => {",
-        "  console.log(`💬 ${data.user.uniqueId}: ${data.comment}`);",
-        "});",
-        "",
-        "client.on('gift', (data) => {",
-        "  console.log(`🎁 ${data.user.uniqueId} sent ${data.giftName} x${data.repeatCount}`);",
-        "});",
-        "",
-        "client.on('like', (data) => {",
-        "  console.log(`❤️  ${data.user.uniqueId} liked (total: ${data.totalLikeCount})`);",
-        "});",
-        "",
-        "client.on('member', (data) => {",
-        "  console.log(`👋 ${data.user.uniqueId} joined`);",
-        "});",
-        "",
-        "client.on('roomUserSeq', (data) => {",
-        "  console.log(`👀 Viewers: ${data.viewerCount}`);",
-        "});",
-        "",
-        "client.on('disconnected', () => {",
-        "  console.log('\\n❌ Disconnected\\n');",
-        "});",
-        "",
-        "client.on('error', (err) => {",
-        "  console.error('⚠️  Error:', err.message);",
-        "});",
-        "",
-        "console.log('🔄 Connecting to @' + USERNAME + '...');",
-        "client.connect().catch((err) => {",
-        "  console.error('Failed to connect:', err.message);",
-        "  process.exit(1);",
-        "});",
-      ].join('\n') + '\n');
-
-      fs.writeFileSync(path.join(fullPath, 'README.md'), [
-        '# TikTok Live - Node.js Starter',
-        '',
-        'A ready-to-run Node.js project connecting to TikTok LIVE streams.',
-        '',
-        '## Quick Start',
-        '',
-        '```bash',
-        'node index.mjs',
-        '```',
-        '',
-        '## Configuration',
-        '',
-        'Edit `index.mjs` to change:',
-        '- `USERNAME` — the TikTok @username to watch',
-        '- `API_KEY` — get your own at [tik.tools](https://tik.tools)',
-        '',
-        '## Events',
-        '',
-        'The demo listens for: `chat`, `gift`, `like`, `member`, `roomUserSeq`.',
-        'See the [full docs](https://www.npmjs.com/package/tiktok-live-api) for all available events.',
-        '',
-      ].join('\n'));
-
-    } else if (isPython) {
-      // ── Python Starter Kit ──
-      fs.writeFileSync(path.join(fullPath, 'main.py'), [
-        '"""TikTok Live - Python Starter Kit"""',
-        '',
-        'import asyncio',
-        'import json',
-        'import websockets',
-        '',
-        '# \u2500\u2500 Configuration \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500',
-        "USERNAME = 'gbnews'             # TikTok @username",
-        "API_KEY  = 'demo_tiktokliveapi_public_2026'  # Get yours at https://tik.tools",
-        '',
-        '',
-        'async def main():',
-        '    """Connect to TikTok LIVE and print events."""',
-        '    uri = f"wss://api.tik.tools?uniqueId={USERNAME}&apiKey={API_KEY}"',
-        '    print(f"Connecting to @{USERNAME}...")',
-        '',
-        '    try:',
-        '        async with websockets.connect(uri) as ws:',
-        '            print(f"Connected to @{USERNAME}")',
-        '            print()',
-        '            async for raw in ws:',
-        '                try:',
-        "                    msg = json.loads(raw)",
-        "                    event = msg.get('event', '')",
-        "                    data = msg.get('data', {})",
-        "                    user = data.get('user', {}).get('uniqueId', '?')",
-        '',
-        "                    if event == 'chat':",
-        "                        comment = data.get('comment', '')",
-        '                        print(f"[chat] {user}: {comment}")',
-        "                    elif event == 'gift':",
-        "                        gift = data.get('giftName', 'a gift')",
-        "                        count = data.get('repeatCount', 1)",
-        '                        print(f"[gift] {user} sent {gift} x{count}")',
-        "                    elif event == 'like':",
-        "                        total = data.get('totalLikeCount', 0)",
-        '                        print(f"[like] {user} liked (total: {total})")',
-        "                    elif event == 'member':",
-        '                        print(f"[join] {user} joined")',
-        "                    elif event == 'roomUserSeq':",
-        "                        viewers = data.get('viewerCount', 0)",
-        '                        print(f"[viewers] {viewers}")',
-        '                except json.JSONDecodeError:',
-        '                    pass',
-        '    except KeyboardInterrupt:',
-        '        print("Disconnected.")',
-        '    except Exception as e:',
-        '        print(f"Error: {e}")',
-        '',
-        '',
-        'if __name__ == "__main__":',
-        '    asyncio.run(main())',
-      ].join('\n') + '\n');
-
-      fs.writeFileSync(path.join(fullPath, 'requirements.txt'), 'websockets>=12.0\n');
-
-      fs.writeFileSync(path.join(fullPath, 'README.md'), [
-        '# TikTok Live - Python Starter',
-        '',
-        'A ready-to-run Python project connecting to TikTok LIVE streams.',
-        '',
-        '## Quick Start',
-        '',
-        '```bash',
-        'pip install -r requirements.txt',
-        'python main.py',
-        '```',
-        '',
-        '## Configuration',
-        '',
-        'Edit `main.py` to change:',
-        '- `USERNAME` — the TikTok @username to watch',
-        '- `API_KEY` — get your own at [tik.tools](https://tik.tools)',
-        '',
-        '## Events',
-        '',
-        'The demo listens for: `chat`, `gift`, `like`, `member`, `roomUserSeq`.',
-        '',
-      ].join('\n'));
-
-      console.log("\n  " + B + "📦 Installing " + C.cyan + "websockets" + B + "..." + R + "\n");
-      try { execSync('pip install websockets', { cwd: fullPath, stdio: 'inherit' }); } catch (e) {
-        console.log("  " + C.yellow + "Note: run 'pip install -r requirements.txt' manually if pip failed." + R);
-      }
-
-    } else if (isNuxt) {
-      const isNuxt4 = fs.existsSync(path.join(fullPath, 'app', 'app.vue')) || !fs.existsSync(path.join(fullPath, 'app.vue'));
-      const baseApp = isNuxt4 ? path.join(fullPath, 'app') : fullPath;
-
-      const compDir = path.join(baseApp, 'components');
-      if (!fs.existsSync(compDir)) fs.mkdirSync(compDir, { recursive: true });
-      fs.writeFileSync(path.join(compDir, 'TikTokLive.vue'), VUE_TEMPLATE);
-
-      const appVue = path.join(baseApp, 'app.vue');
-      fs.writeFileSync(appVue, [
-        '<template>',
-        '  <main style="min-height: 100vh; background: #f9fafb; padding-top: 40px;">',
-        '    <ClientOnly>',
-        '      <TikTokLive />',
-        '    </ClientOnly>',
-        '  </main>',
-        '</template>'
-      ].join('\n') + '\n');
-    } else {
-      if (isNext) {
-        const compDir = path.join(fullPath, 'src', 'components');
-        if (!fs.existsSync(compDir)) fs.mkdirSync(compDir, { recursive: true });
-        fs.writeFileSync(path.join(compDir, 'TikTokLive.jsx'), REACT_TEMPLATE);
-
-        // Write page.js — create the directory if needed
-        const pageDir = path.join(fullPath, 'src', 'app');
-        if (!fs.existsSync(pageDir)) fs.mkdirSync(pageDir, { recursive: true });
-        fs.writeFileSync(path.join(pageDir, 'page.js'), [
-          "import TikTokLive from '@/components/TikTokLive';",
-          "",
-          "export default function Home() {",
-          "  return (",
-          '    <main style={{ minHeight: "100vh", background: "#f9fafb", paddingTop: "40px" }}>',
-          "      <TikTokLive />",
-          "    </main>",
-          "  );",
-          "}",
-        ].join('\n') + '\n');
-      } else if (isVite) {
-        const srcDir = path.join(fullPath, 'src');
-        const compDir = path.join(srcDir, 'components');
-        if (!fs.existsSync(compDir)) fs.mkdirSync(compDir, { recursive: true });
-        fs.writeFileSync(path.join(compDir, 'TikTokLive.jsx'), REACT_TEMPLATE);
-
-        // Write App.jsx
-        fs.writeFileSync(path.join(srcDir, 'App.jsx'), [
-          "import TikTokLive from './components/TikTokLive';",
-          "",
-          "export default function App() {",
-          "  return (",
-          '    <main style={{ minHeight: "100vh", background: "#f9fafb", paddingTop: "40px" }}>',
-          "      <TikTokLive />",
-          "    </main>",
-          "  );",
-          "}",
-        ].join('\n') + '\n');
-
-        // Write main.jsx entry point
-        fs.writeFileSync(path.join(srcDir, 'main.jsx'), [
-          "import React from 'react';",
-          "import ReactDOM from 'react-dom/client';",
-          "import App from './App';",
-          "",
-          "ReactDOM.createRoot(document.getElementById('root')).render(",
-          "  <React.StrictMode>",
-          "    <App />",
-          "  </React.StrictMode>",
-          ");",
-        ].join('\n') + '\n');
-
-        // Clean up TypeScript files that conflict with our JSX files
-        for (const f of ['App.tsx', 'App.ts', 'main.tsx', 'main.ts']) {
-          const fp = path.join(srcDir, f);
-          if (fs.existsSync(fp)) fs.unlinkSync(fp);
-        }
-
-        // Update index.html to reference main.jsx instead of main.ts/main.tsx
-        const indexHtml = path.join(fullPath, 'index.html');
-        if (fs.existsSync(indexHtml)) {
-          let html = fs.readFileSync(indexHtml, 'utf8');
-          html = html.replace(/src=\/src\/main\.tsx?/g, 'src=/src/main.jsx');
-          html = html.replace(/src="\/src\/main\.tsx?"/g, 'src="/src/main.jsx"');
-          fs.writeFileSync(indexHtml, html);
-        }
-      }
-    }
-
-    console.log("\n  " + C.green + "✔ Project successfully scaffolded!" + R + "\n");
-    console.log("  " + B + "Next steps:" + R);
-    console.log("    cd " + targetDir);
-    if (isPython) {
-      console.log("    python main.py\n");
-    } else if (isNode) {
-      console.log("    node index.mjs\n");
-    } else {
-      if (isVite && pm !== 'bun') {
-        console.log("    " + pm + " install");
-      }
-      console.log("    " + devCmd + "\n");
-    }
-
-  } catch (err) {
-    console.error("\n  " + C.red + "Error during scaffolding:" + R, err.message);
-    process.exit(1);
-  }
-}
-
-// ── Terminal Demo Logic ─────────────────────────────────────────────────
-
-async function runDemo() {
-  const WS_BASE = 'wss://api.tik.tools';
-  const DEMO_KEY = 'demo_tiktokliveapi_public_2026';
-  const CHANNELS = [
-    'gbnews', 'cgtnofficial', 'france24_en',
-    'weathernewslive', 'gbnews', 'bbcnews',
-    'skynews', 'tv_asahi_news', 'abc7chicago', 'thairath_news',
-  ];
-
-  const TAG = {
-    chat: C.cyan + "chat" + R,
-    gift: C.yellow + "gift" + R,
-    like: C.mag + "like" + R,
-    member: C.green + "join" + R,
-    follow: C.green + "follow" + R,
-    viewer: C.blue + "viewers" + R,
-    share: C.white + "share" + R,
-  };
-
-  let target = '';
-  let apiKey = DEMO_KEY;
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
-    if (a === '--key' || a === '-k') { apiKey = args[++i] || DEMO_KEY; }
-    else if (a === '--help' || a === '-h') { help(); process.exit(0); }
-    else if (!a.startsWith('-')) { target = a.replace(/^@/, ''); }
-  }
-
-  function help() {
-    console.log("\n  " + B + "tiktok-live-api" + R + "  " + D + "Real-time TikTok Live SDK" + R);
-    console.log("\n  " + B + "Usage" + R);
-    console.log("    " + C.cyan + "npx tiktok-live-api" + R + "                  " + D + "interactive menu (demo or scaffold)" + R);
-    console.log("    " + C.cyan + "npx tiktok-live-api" + R + " " + C.white + "@username" + R + "        " + D + "connect to a specific user" + R);
-    console.log("    " + C.cyan + "npx tiktok-live-api" + R + " " + C.gray + "--key KEY" + R + "        " + D + "use your own API key" + R);
-    console.log("\n  " + D + "Unofficial API by TikTool · https://tik.tools" + R + "\n");
-  }
-
-  function probe(uid, ms = 8000) {
-    return new Promise(resolve => {
-      const ws = new WebSocket(WS_BASE + "?uniqueId=" + uid + "&apiKey=" + apiKey);
-      const t = setTimeout(() => { ws.close(); resolve(null); }, ms);
-      ws.on('message', () => { clearTimeout(t); resolve(ws); });
-      ws.on('error', () => { clearTimeout(t); resolve(null); });
-      ws.on('close', () => { clearTimeout(t); });
-    });
-  }
-
-  function ts() {
-    const d = new Date();
-    return C.gray + String(d.getHours()).padStart(2, '0') + ":" + String(d.getMinutes()).padStart(2, '0') + ":" + String(d.getSeconds()).padStart(2, '0') + R;
-  }
-
-  function fmt(event, data) {
-    const tag = TAG[event] || (C.gray + event.padEnd(7) + R);
-    const u = data.user?.uniqueId || '';
-    const pad = tag.length < 20 ? '  ' : ' ';
-
-    switch (event) {
-      case 'chat': return ts() + " " + tag + pad + "  " + B + u + R + "  " + (data.comment || '');
-      case 'gift': return ts() + " " + tag + pad + "  " + B + u + R + "  " + C.yellow + (data.giftName || 'gift') + R + " x" + (data.repeatCount || 1) + " " + D + "(" + (data.diamondCount || 0) + "💎)" + R;
-      case 'like': return ts() + " " + tag + pad + "  " + B + u + R + "  " + D + "total " + (data.totalLikeCount || 0).toLocaleString() + R;
-      case 'member': return ts() + " " + tag + pad + "  " + C.green + u + R;
-      case 'follow': return ts() + " " + tag + "  " + C.green + u + R;
-      case 'roomUserSeq':
-      case 'viewer': return ts() + " " + TAG.viewer + "  " + B + (data.viewerCount || 0).toLocaleString() + R;
-      case 'share': return ts() + " " + tag + " " + u;
-      default: return null;
-    }
-  }
-
-  console.log("\n  " + B + "tiktok-live-api" + R + "  " + D + "·" + R + "  " + D + "Real-time TikTok Live events" + R);
-  console.log("  " + D + "Unofficial API by TikTool · https://tik.tools" + R + "\n");
-
-  let ws = null, who = '';
-
-  if (target) {
-    process.stdout.write("  " + D + "connecting to" + R + " " + B + "@" + target + R + " " + D + "..." + R);
-    ws = await probe(target);
-    if (ws) { who = target; console.log(" " + C.green + "●" + R); }
-    else { console.log(" " + C.red + "✗" + R + "\n\n  " + C.red + "Stream not found." + R + " Make sure " + B + "@" + target + R + " is live.\n"); process.exit(1); }
-  } else {
-    console.log("  " + D + "scanning for live streams..." + R + "\n");
-    for (const uid of CHANNELS) {
-      process.stdout.write("  " + C.gray + "@" + uid + R);
-      ws = await probe(uid);
-      if (ws) { who = uid; console.log("  " + C.green + "● live" + R); break; }
-      else { console.log("  " + D + "—" + R); }
-    }
-    if (!ws) {
-      console.log("\n  " + C.red + "No live streams found." + R + " Try: " + C.cyan + "npx tiktok-live-api @username" + R + "\n");
-      console.log("  " + D + "Get your own API key at" + R + " " + C.cyan + "https://tik.tools" + R + "\n");
-      process.exit(1);
-    }
-  }
-
-  console.log("\n  " + C.green + "●" + R + " " + B + "@" + who + R + "  " + D + "— streaming events. Ctrl+C to stop." + R);
-  console.log("  " + D + "──────────────────────────────────────────────────" + R + "\n");
-
-  let count = 0;
-  ws.on('message', raw => {
-    try {
-      const m = JSON.parse(raw.toString());
-      const line = fmt(m.event || 'unknown', m.data || m);
-      if (line) { count++; console.log("  " + line); }
-    } catch { }
-  });
-
-  ws.on('close', () => {
-    console.log("\n  " + D + "disconnected — " + B + count + R + D + " events received" + R);
-    console.log("  " + D + "Get unlimited access:" + R + " " + C.cyan + "https://tik.tools" + R + "\n");
-    process.exit(0);
-  });
-
-  ws.on('error', e => console.error("  " + C.red + "error" + R + " " + e.message));
-  process.on('SIGINT', () => {
-    console.log("\n\n  " + D + "stopped — " + B + count + R + D + " events received" + R);
-    console.log("  " + D + "Get unlimited access:" + R + " " + C.cyan + "https://tik.tools" + R + "\n");
-    ws.close();
-    process.exit(0);
-  });
-}