tiktok-live-api 1.2.12 → 1.2.13

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,174 @@ 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',
+        '',
+        '# ── 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;
 
@@ -278,7 +458,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 +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);

package/package.json

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