tiktok-live-api 1.2.3 → 1.2.4

package/README.md

@@ -18,6 +18,17 @@
 
 > 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

package/bin/demo.mjs

@@ -1,185 +1,368 @@
 #!/usr/bin/env node
 
-/**
- * tiktok-live-api CLI
- * Instantly connects to a live TikTok stream and prints real-time events.
- *
- * Usage:
- *   npx tiktok-live-api                  auto-find a live stream
- *   npx tiktok-live-api @username        connect to a specific stream
- *   npx tiktok-live-api --key YOUR_KEY   use your own API key
- *
- * Unofficial third-party API by TikTool · https://tik.tools
- * Not affiliated with TikTok or ByteDance.
- */
-
 import WebSocket from 'ws';
+import readline from 'readline';
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
 
-const WS_BASE = 'wss://api.tik.tools';
-const DEMO_KEY = 'demo_tiktokliveapi_public_2026';
+// ── Boilerplate Components ─────────────────────────────────────────────
 
-const CHANNELS = [
-    'aljazeeraenglish', 'cgtnofficial', 'france24_en',
-    'weathernewslive', 'gbnews', 'bbcnews',
-    'skynews', 'tv_asahi_news', 'abc7chicago', 'thairath_news',
-];
+const REACT_TEMPLATE = [
+  '"use client";',
+  "import React, { useEffect, useState } from 'react';",
+  "import { TikTokLive } from 'tiktok-live-api';",
+  "",
+  "export default function TikTokLiveComponent() {",
+  "  const [events, setEvents] = useState([]);",
+  "  const [username, setUsername] = useState('aljazeeraenglish');",
+  "  const [connected, setConnected] = useState(false);",
+  "  ",
+  "  useEffect(() => {",
+  "    const client = new TikTokLive(username, { apiKey: 'demo_tiktokliveapi_public_2026' });",
+  "    ",
+  '    client.on(\'chat\', (e) => setEvents(prev => [...prev.slice(-20), "💬 " + e.user.uniqueId + ": " + e.comment]));',
+  '    client.on(\'gift\', (e) => setEvents(prev => [...prev.slice(-20), "🎁 " + e.user.uniqueId + " sent " + e.giftName]));',
+  "    client.on('connected', () => setConnected(true));",
+  "    client.on('disconnected', () => setConnected(false));",
+  "    ",
+  "    client.connect();",
+  "    return () => client.disconnect();",
+  "  }, [username]);",
+  "",
+  "  return (",
+  "    <div style={{ fontFamily: 'sans-serif', maxWidth: 400, margin: '40px auto', border: '1px solid #e5e7eb', padding: '24px', borderRadius: '12px', boxShadow: '0 10px 15px -3px rgba(0, 0, 0, 0.1)' }}>",
+  "      <h2 style={{ margin: '0 0 16px 0', fontSize: '1.25rem', fontWeight: 600 }}>TikTok Live SDK Test</h2>",
+  "      <div style={{ marginBottom: '16px', display: 'flex', alignItems: 'center', gap: '8px' }}>",
+  "        <div style={{ width: 10, height: 10, borderRadius: '50%', background: connected ? '#10b981' : '#ef4444' }}></div>",
+  "        <span style={{ fontSize: '0.875rem', color: '#374151' }}>{connected ? 'Connected to @' + username : 'Disconnected'}</span>",
+  "      </div>",
+  "      <div style={{ height: 320, overflowY: 'auto', background: '#f9fafb', padding: '12px', borderRadius: '8px', border: '1px solid #e5e7eb', fontSize: '0.875rem' }}>",
+  "        {events.map((e, i) => <div key={i} style={{ padding: '6px 0', borderBottom: '1px solid #f3f4f6' }}>{e}</div>)}",
+  "        {events.length === 0 && <div style={{ color: '#9ca3af', textAlign: 'center', marginTop: 120 }}>Waiting for events...</div>}",
+  "      </div>",
+  "    </div>",
+  "  );",
+  "}"
+].join('\n') + "\n";
 
-// ── ANSI ───────────────────────────────────────────────────────────────
-const R = '\x1b[0m';
-const B = '\x1b[1m';
-const D = '\x1b[2m';
-const I = '\x1b[3m';
-const C = {
-    cyan: '\x1b[38;5;80m', green: '\x1b[38;5;114m', yellow: '\x1b[38;5;222m',
-    mag: '\x1b[38;5;176m', blue: '\x1b[38;5;111m', red: '\x1b[38;5;203m',
-    gray: '\x1b[38;5;242m', white: '\x1b[38;5;252m', pink: '\x1b[38;5;218m',
-};
+const VUE_TEMPLATE = [
+  "<template>",
+  '  <div style="font-family: sans-serif; max-width: 400px; margin: 40px auto; border: 1px solid #e5e7eb; padding: 24px; border-radius: 12px; box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1)">',
+  '    <h2 style="margin: 0 0 16px 0; font-size: 1.25rem; font-weight: 600">TikTok Live SDK Test</h2>',
+  '    <div style="margin-bottom: 16px; display: flex; align-items: center; gap: 8px">',
+  "      <div :style=\"{ width: '10px', height: '10px', borderRadius: '50%', background: connected ? '#10b981' : '#ef4444' }\"></div>",
+  "      <span style=\"font-size: 0.875rem; color: '#374151'\">{{ connected ? 'Connected to @' + username : 'Disconnected' }}</span>",
+  "    </div>",
+  '    <div style="height: 320px; overflow-y: auto; background: #f9fafb; padding: 12px; border-radius: 8px; border: 1px solid #e5e7eb; font-size: 0.875rem">',
+  '      <div v-for="(e, i) in events" :key="i" style="padding: 6px 0; border-bottom: 1px solid #f3f4f6">',
+  "        {{ e }}",
+  "      </div>",
+  '      <div v-if="events.length === 0" style="color: #9ca3af; text-align: center; margin-top: 120px">Waiting for events...</div>',
+  "    </div>",
+  "  </div>",
+  "</template>",
+  "",
+  "<script setup>",
+  "import { ref, onMounted, onUnmounted } from 'vue'",
+  "import { TikTokLive } from 'tiktok-live-api'",
+  "",
+  "const username = ref('aljazeeraenglish')",
+  "const connected = ref(false)",
+  "const events = ref([])",
+  "let client = null",
+  "",
+  "onMounted(() => {",
+  "  client = new TikTokLive(username.value, { apiKey: 'demo_tiktokliveapi_public_2026' })",
+  "  ",
+  "  client.on('chat', (e) => {",
+  '    events.value.push("💬 " + e.user.uniqueId + ": " + e.comment)',
+  "    if (events.value.length > 20) events.value.shift()",
+  "  })",
+  "  ",
+  "  client.on('gift', (e) => {",
+  '    events.value.push("🎁 " + e.user.uniqueId + " sent " + e.giftName)',
+  "    if (events.value.length > 20) events.value.shift()",
+  "  })",
+  "",
+  "  client.on('connected', () => connected.value = true)",
+  "  client.on('disconnected', () => connected.value = false)",
+  "  ",
+  "  client.connect()",
+  "})",
+  "",
+  "onUnmounted(() => {",
+  "  if (client) client.disconnect()",
+  "})",
+  "</script>"
+].join('\n') + "\n";
 
-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}`,
+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",
 };
 
-// ── Parse args ─────────────────────────────────────────────────────────
-let target = '';
-let apiKey = DEMO_KEY;
+// ── Interactive Prompt ──────────────────────────────────────────────────
 
 const args = process.argv.slice(2);
-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(/^@/, ''); }
-}
+const isInteractive = args.length === 0;
 
-function help() {
-    console.log(`
-  ${B}tiktok-live-api${R}  ${D}Real-time TikTok Live events in your terminal${R}
+if (!isInteractive) {
+  runDemo();
+} else {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
 
-  ${B}Usage${R}
-    ${C.cyan}npx tiktok-live-api${R}                  ${D}auto-find a live stream${R}
-    ${C.cyan}npx tiktok-live-api${R} ${C.white}@username${R}        ${D}connect to a specific user${R}
-    ${C.cyan}npx tiktok-live-api${R} ${C.gray}--key KEY${R}        ${D}use your own API key${R}
+  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 + " (Default)");
+  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 + "\n");
 
-  ${D}Unofficial third-party API by TikTool${R}
-  ${D}https://tik.tools · Not affiliated with TikTok or ByteDance${R}
-`);
-}
+  const timeoutId = setTimeout(() => {
+    console.log(D + "\r  No input received. Auto-starting Terminal Demo..." + R + "\n");
+    rl.close();
+    runDemo();
+  }, 10000);
 
-// ── WebSocket probe ────────────────────────────────────────────────────
-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); });
+  rl.question("  Choose [1-4]: ", (answer) => {
+    clearTimeout(timeoutId);
+    handleMenu(answer.trim() || '1');
+  });
+
+  function handleMenu(choice) {
+    if (choice === '1') {
+      rl.close();
+      return runDemo();
+    }
+
+    if (!['2', '3', '4'].includes(choice)) {
+      console.log("  " + C.red + "Invalid choice." + R);
+      rl.close();
+      process.exit(1);
+    }
+
+    rl.question("\n  Target directory (e.g. ./my-app) [./tiktok-live-project]: ", (dir) => {
+      dir = dir.trim() || './tiktok-live-project';
+      rl.close();
+      runScaffold(choice, dir);
     });
+  }
 }
 
-// ── Banner ─────────────────────────────────────────────────────────────
-function banner() {
-    console.log();
-    console.log(`  ${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}`);
-    console.log();
+// ── Scaffolding Logic ───────────────────────────────────────────────────
+
+function runScaffold(choice, targetDir) {
+  const isNuxt = choice === '2';
+  const isNext = choice === '3';
+  const isVite = choice === '4';
+  const fullPath = path.resolve(process.cwd(), targetDir);
+
+  console.log("\n  " + B + "🚀 Scaffolding project into " + targetDir + "..." + R + "\n");
+
+  try {
+    if (isNuxt) {
+      execSync('npx --yes nuxi@latest init "' + targetDir + '" --packageManager npm', { stdio: 'inherit' });
+    } else if (isNext) {
+      execSync('npx --yes create-next-app@latest "' + targetDir + '" --js --eslint --tailwind --app --src-dir --import-alias "@/*" --use-npm', { stdio: 'inherit' });
+    } else if (isVite) {
+      execSync('npm create vite@latest "' + targetDir + '" -- --template react', { stdio: 'inherit' });
+    }
+
+    console.log("\n  " + B + "📦 Installing " + C.cyan + "tiktok-live-api" + B + " SDK..." + R + "\n");
+    execSync('npm install tiktok-live-api', { cwd: fullPath, stdio: 'inherit' });
+
+    if (isNuxt) {
+      const compDir = path.join(fullPath, 'components');
+      if (!fs.existsSync(compDir)) fs.mkdirSync(compDir, { recursive: true });
+      fs.writeFileSync(path.join(compDir, 'TikTokLive.vue'), VUE_TEMPLATE);
+
+      const appVue = path.join(fullPath, 'app.vue');
+      if (fs.existsSync(appVue)) {
+        fs.writeFileSync(appVue, [
+          '<template>',
+          '  <div style="min-height: 100vh; background: #fdfdfd; padding-top: 40px;">',
+          '    <TikTokLive />',
+          '  </div>',
+          '</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);
+
+      const pageJs = path.join(fullPath, 'src', 'app', 'page.js');
+      if (fs.existsSync(pageJs)) {
+        fs.writeFileSync(pageJs, [
+          "import TikTokLive from '@/components/TikTokLive';",
+          "",
+          "export default function Home() {",
+          "  return (",
+          '    <main className="min-h-screen bg-neutral-50 pt-10">',
+          "      <TikTokLive />",
+          "    </main>",
+          "  );",
+          "}"
+        ].join('\n') + '\n');
+      }
+    } else if (isVite) {
+      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);
+
+      const appJsx = path.join(fullPath, 'src', 'App.jsx');
+      if (fs.existsSync(appJsx)) {
+        fs.writeFileSync(appJsx, [
+          "import TikTokLive from './components/TikTokLive';",
+          "",
+          "export default function App() {",
+          "  return (",
+          "    <div style={{ minHeight: '100vh', background: '#fdfdfd', paddingTop: '40px' }}>",
+          "      <TikTokLive />",
+          "    </div>",
+          "  );",
+          "}"
+        ].join('\n') + '\n');
+      }
+    }
+
+    console.log("\n  " + C.green + "✔ Project successfully scaffolded!" + R + "\n");
+    console.log("  " + B + "Next steps:" + R);
+    console.log("    cd " + targetDir);
+    console.log("    npm run dev\n");
+
+  } catch (err) {
+    console.error("\n  " + C.red + "Error during scaffolding:" + R, err.message);
+    process.exit(1);
+  }
 }
 
-// ── Format ─────────────────────────────────────────────────────────────
-function ts() {
+// ── Terminal Demo Logic ─────────────────────────────────────────────────
+
+async function runDemo() {
+  const WS_BASE = 'wss://api.tik.tools';
+  const DEMO_KEY = 'demo_tiktokliveapi_public_2026';
+  const CHANNELS = [
+    'aljazeeraenglish', '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}`;
-}
+    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}`;
+  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': {
-            const name = data.giftName || 'gift';
-            const n = data.repeatCount || 1;
-            const d2 = data.diamondCount || 0;
-            return `${ts()} ${tag}${pad}  ${B}${u}${R}  ${C.yellow}${name}${R} x${n} ${D}(${d2}💎)${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 'viewer':
-            return `${ts()} ${tag}  ${B}${(data.viewerCount || 0).toLocaleString()}${R}`;
-        case 'share':
-            return `${ts()} ${tag} ${u}`;
-        default:
-            return null; // skip noisy unknown events
+      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");
 
-// ── Main ───────────────────────────────────────────────────────────────
-async function main() {
-    banner();
-    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);
-        }
+  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();
-    console.log(`  ${C.green}●${R} ${B}@${who}${R}  ${D}— streaming events. Ctrl+C to stop.${R}`);
-    console.log(`  ${D}${'─'.repeat(50)}${R}`);
-    console.log();
-
-    let count = 0;
-    ws.on('message', raw => {
-        try {
-            const m = JSON.parse(raw.toString());
-            const ev = m.event || 'unknown';
-            const d = m.data || m;
-            const line = fmt(ev, d);
-            if (line) { count++; console.log(`  ${line}`); }
-        } catch { }
-    });
+  console.log("\n  " + C.green + "●" + R + " " + B + "@" + who + R + "  " + D + "— streaming events. Ctrl+C to stop." + R);
+  console.log("  " + D + "──────────────────────────────────────────────────" + R + "\n");
 
-    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);
-    });
+  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('error', e => console.error(`  ${C.red}error${R} ${e.message}`));
+  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);
+  });
 
-    process.on('SIGINT', () => {
-        console.log(`\n\n  ${D}stopped — ${B}${count}${R}${D} events received${R}`);
-        console.log(`  ${D}Get your own key:${R} ${C.cyan}https://tik.tools${R}\n`);
-        ws.close();
-        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);
+  });
 }
-
-main().catch(e => { console.error(`  ${C.red}${e.message}${R}`); process.exit(1); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiktok-live-api",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "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",