tiktok-live-api 1.2.12 → 1.2.15

package/bin/demo.mjs

@@ -193,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());
     });
   }
@@ -207,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();
     }
@@ -215,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");
@@ -241,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');
@@ -250,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' });
@@ -259,7 +272,182 @@ function runScaffold(choice, targetDir, pm) {
       execSync(createCmd + ' "' + targetDir + '" -- --template react', { stdio: 'inherit' });
     }
 
-    if (isNuxt) {
+    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;
 
@@ -278,7 +466,7 @@ function runScaffold(choice, targetDir, pm) {
         '</template>'
       ].join('\n') + '\n');
     } 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) {
@@ -325,10 +513,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);

package/package.json

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