tiktok-live-api 1.2.11 → 1.2.13

package/bin/demo.mjs

@@ -15,9 +15,9 @@ const REACT_TEMPLATE = [
   "",
   "export default function TikTokLiveComponent() {",
   "  const [events, setEvents] = useState([]);",
-  "  const [username, setUsername] = useState('aljazeeraenglish');",
+  "  const [username, setUsername] = useState('gbnews');",
   "  const [apiKey, setApiKey] = useState('demo_tiktokliveapi_public_2026');",
-  "  const [inputUsername, setInputUsername] = useState('aljazeeraenglish');",
+  "  const [inputUsername, setInputUsername] = useState('gbnews');",
   "  const [connected, setConnected] = useState(false);",
   "  const clientRef = useRef(null);",
   "",
@@ -59,7 +59,7 @@ const REACT_TEMPLATE = [
   "        <form onSubmit={handleConnect} style={{ display: 'flex', flexDirection: 'column', gap: '16px', marginBottom: '24px' }}>",
   "          <div>",
   "            <label style={{ display: 'block', fontSize: '0.875rem', fontWeight: 500, marginBottom: '6px' }}>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' }} placeholder=\"e.g. aljazeeraenglish\" />",
+  "            <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' }} placeholder=\"e.g. gbnews\" />",
   "          </div>",
   "          <div>",
   "            <label style={{ display: 'block', fontSize: '0.875rem', fontWeight: 500, marginBottom: '6px' }}>API Key</label>",
@@ -95,7 +95,7 @@ const VUE_TEMPLATE = [
   '      <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. aljazeeraenglish" />',
+  '          <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>',
@@ -119,53 +119,52 @@ const VUE_TEMPLATE = [
   "</template>",
   "",
   "<script setup>",
-  "import { ref, watch, onMounted } from 'vue'",
+  "import { ref, onMounted, onUnmounted } from 'vue'",
   "",
-  "const inputUsername = ref('aljazeeraenglish')",
-  "const activeUsername = ref('aljazeeraenglish')",
+  "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",
   "",
-  "let hook = null;",
-  "try { if (typeof useTikTokLive !== 'undefined') hook = useTikTokLive; } catch (e) { }",
-  "const proxyUsername = { replace: (r, s) => (activeUsername.value || '').replace(r, s) }",
-  "const tiktok = hook ? hook(proxyUsername, { apiKey, autoConnect: false }) : { connected: ref(false), allEvents: ref([]) }",
-  "const connected = tiktok.connected",
-  "",
-  "watch(() => tiktok.allEvents.value, (all) => {",
-  "  if (all && all.length) {",
-  "    const last = all[all.length - 1];",
-  "    if (last.type === 'chat') addEvent(`💬 ${last.data.user.uniqueId}: ${last.data.comment}`)",
-  "    if (last.type === 'gift') addEvent(`🎁 ${last.data.user.uniqueId} sent ${last.data.giftName}`)",
-  "    if (last.type === 'like') addEvent(`❤️ ${last.data.user.uniqueId} liked`)",
-  "    if (last.type === 'member') addEvent(`👋 ${last.data.user.uniqueId} joined`)",
-  "    if (last.type === 'connected') addEvent('✅ Connected successfully!')",
-  "    if (last.type === 'disconnected') addEvent('❌ Disconnected from stream.')",
-  "  }",
-  "}, { deep: true })",
-  "",
-  "watch(() => tiktok.error ? tiktok.error.value : null, (e) => {",
-  "  if(e) addEvent('⚠️ Error: ' + e)",
-  "})",
-  "",
-  "const addEvent = (str) => {",
+  "function addEvent(str) {",
   "  events.value.push(str)",
-  "  if(events.value.length > 50) events.value.shift()",
+  "  if (events.value.length > 50) events.value.shift()",
   "}",
   "",
-  "const handleConnect = () => {",
-  "  if (tiktok.disconnect) tiktok.disconnect()",
+  "function connectStream() {",
+  "  if (ws) { ws.close(); ws = null }",
   "  events.value = []",
+  "  connected.value = false",
   "  activeUsername.value = inputUsername.value",
-  "  if (!activeUsername.value) return",
-  "  if (tiktok.connect) {",
-  "    tiktok.connect().catch(e => addEvent('⚠️ Failed: ' + e.message))",
+  "  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) {}",
   "  }",
   "}",
   "",
-  "onMounted(() => {",
-  "  handleConnect()",
-  "})",
+  "const handleConnect = () => { connectStream() }",
+  "",
+  "onMounted(() => { connectStream() })",
+  "onUnmounted(() => { if (ws) ws.close() })",
   "</script>"
 ].join('\n') + "\n";
 
@@ -194,10 +193,12 @@ if (!isInteractive) {
   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 + "\n");
+  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-4]: ", (answer) => {
+    rl.question("  Choose [1-6]: ", (answer) => {
       handleMenu(answer.trim());
     });
   }
@@ -208,7 +209,7 @@ if (!isInteractive) {
       return runDemo();
     }
 
-    if (!['2', '3', '4'].includes(choice)) {
+    if (!['2', '3', '4', '5', '6'].includes(choice)) {
       console.log("  " + C.red + "Invalid choice." + R);
       return promptAction();
     }
@@ -216,6 +217,11 @@ if (!isInteractive) {
     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");
@@ -242,6 +248,8 @@ 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');
@@ -251,7 +259,11 @@ function runScaffold(choice, targetDir, pm) {
   console.log("\n  " + B + "🚀 Scaffolding project into " + targetDir + " using " + pm + "..." + R + "\n");
 
   try {
-    if (isNuxt) {
+    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' });
@@ -260,11 +272,174 @@ function runScaffold(choice, targetDir, pm) {
       execSync(createCmd + ' "' + targetDir + '" -- --template react', { stdio: 'inherit' });
     }
 
-    if (isNuxt) {
-      console.log("\\n  " + B + "📦 Installing " + C.cyan + "tiktok-live-nuxt" + B + " Module..." + R + "\\n");
-      const nuxtInstallCmd = pm === 'npm' ? 'npm install tiktok-live-nuxt' : pm === 'yarn' ? 'yarn add tiktok-live-nuxt' : pm === 'pnpm' ? 'pnpm add tiktok-live-nuxt' : 'bun add tiktok-live-nuxt';
-      execSync(nuxtInstallCmd, { cwd: fullPath, 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',
+        '',
+        '# ── Configuration ───────────────────────────────────────',
+        "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}\\n")',
+        '            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":',
+        '                        print(f"💬 {user}: {data.get(\"comment\", \"\")}")',
+        '                    elif event == "gift":',
+        '                        print(f"🎁 {user} sent {data.get(\"giftName\", \"a gift\")} x{data.get(\"repeatCount\", 1)}")',
+        '                    elif event == "like":',
+        '                        print(f"❤️  {user} liked (total: {data.get(\"totalLikeCount\", 0)})")',
+        '                    elif event == "member":',
+        '                        print(f"👋 {user} joined")',
+        '                    elif event == "roomUserSeq":',
+        '                        print(f"👀 Viewers: {data.get(\"viewerCount\", 0)}")',
+        '                except json.JSONDecodeError:',
+        '                    pass',
+        '    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;
 
@@ -276,21 +451,14 @@ function runScaffold(choice, targetDir, pm) {
       fs.writeFileSync(appVue, [
         '<template>',
         '  <main style="min-height: 100vh; background: #f9fafb; padding-top: 40px;">',
-        '    <TikTokLive />',
+        '    <ClientOnly>',
+        '      <TikTokLive />',
+        '    </ClientOnly>',
         '  </main>',
         '</template>'
       ].join('\n') + '\n');
-
-      const nuxtConfig = path.join(fullPath, 'nuxt.config.ts');
-      if (fs.existsSync(nuxtConfig)) {
-        let config = fs.readFileSync(nuxtConfig, 'utf8');
-        if (config.includes('defineNuxtConfig({')) {
-          config = config.replace('defineNuxtConfig({', "defineNuxtConfig({\n  modules: ['tiktok-live-nuxt'],\n");
-          fs.writeFileSync(nuxtConfig, config);
-        }
-      }
     } else {
-      console.log("\\n  " + B + "📦 Installing " + C.cyan + "tiktok-live-api" + B + " SDK..." + R + "\\n");
+      console.log("\n  " + B + "📦 Installing " + C.cyan + "tiktok-live-api" + B + " SDK..." + R + "\n");
       execSync(installCmd, { cwd: fullPath, stdio: 'inherit' });
 
       if (isNext) {
@@ -337,10 +505,16 @@ function runScaffold(choice, targetDir, pm) {
     console.log("\n  " + C.green + "✔ Project successfully scaffolded!" + R + "\n");
     console.log("  " + B + "Next steps:" + R);
     console.log("    cd " + targetDir);
-    if (isVite && pm !== 'bun') {
-      console.log("    " + pm + " install");
+    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");
     }
-    console.log("    " + devCmd + "\n");
 
   } catch (err) {
     console.error("\n  " + C.red + "Error during scaffolding:" + R, err.message);
@@ -354,7 +528,7 @@ async function runDemo() {
   const WS_BASE = 'wss://api.tik.tools';
   const DEMO_KEY = 'demo_tiktokliveapi_public_2026';
   const CHANNELS = [
-    'aljazeeraenglish', 'cgtnofficial', 'france24_en',
+    'gbnews', 'cgtnofficial', 'france24_en',
     'weathernewslive', 'gbnews', 'bbcnews',
     'skynews', 'tv_asahi_news', 'abc7chicago', 'thairath_news',
   ];

package/package.json

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