tiktok-live-api 1.0.0 → 1.0.1

package/README.md

@@ -54,6 +54,78 @@ client.connect();
 
 That's it. **No complex setup, no protobuf, no reverse engineering, no breakages when TikTok updates.**
 
+---
+
+## 🚀 Try It Now — 60-Second Live Demo
+
+Copy-paste this into a file and run it. Connects to a live TikTok stream, prints every event for 60 seconds, then exits. Works on the free Sandbox tier.
+
+**Save as `demo.mjs` and run with `node demo.mjs`:**
+
+```javascript
+// demo.mjs — TikTok LIVE in 60 seconds
+// npm install tiktok-live-api
+import { TikTokLive } from 'tiktok-live-api';
+
+const API_KEY       = 'YOUR_API_KEY';        // Get free key → https://tik.tools
+const LIVE_USERNAME = 'tv_asahi_news';       // Any live TikTok username
+
+const client = new TikTokLive(LIVE_USERNAME, { apiKey: API_KEY });
+let events = 0;
+
+client.on('chat',        e => { events++; console.log(`💬 ${e.user.uniqueId}: ${e.comment}`); });
+client.on('gift',        e => { events++; console.log(`🎁 ${e.user.uniqueId} sent ${e.giftName} (${e.diamondCount}💎)`); });
+client.on('like',        e => { events++; console.log(`❤️  ${e.user.uniqueId} liked × ${e.likeCount}`); });
+client.on('member',      e => { events++; console.log(`👋 ${e.user.uniqueId} joined`); });
+client.on('follow',      e => { events++; console.log(`➕ ${e.user.uniqueId} followed`); });
+client.on('roomUserSeq', e => { events++; console.log(`👀 Viewers: ${e.viewerCount}`); });
+
+client.on('connected',    () => console.log(`\n✅ Connected to @${LIVE_USERNAME} — listening for 60s...\n`));
+client.on('disconnected', () => console.log(`\n📊 Done! Received ${events} events.\n`));
+
+client.connect();
+setTimeout(() => { client.disconnect(); }, 60_000);
+```
+
+<details>
+<summary><strong>🔌 Pure WebSocket version (no SDK, any language)</strong></summary>
+
+```javascript
+// ws-demo.mjs — Pure WebSocket, zero SDK
+// npm install ws
+import WebSocket from 'ws';
+
+const API_KEY       = 'YOUR_API_KEY';
+const LIVE_USERNAME = 'tv_asahi_news';
+
+const ws = new WebSocket(`wss://api.tik.tools?uniqueId=${LIVE_USERNAME}&apiKey=${API_KEY}`);
+let events = 0;
+
+ws.on('open', () => console.log(`\n✅ Connected to @${LIVE_USERNAME} — listening for 60s...\n`));
+ws.on('message', (raw) => {
+  const msg = JSON.parse(raw);
+  events++;
+  const d = msg.data || {};
+  const user = d.user?.uniqueId || '';
+  switch (msg.event) {
+    case 'chat':        console.log(`💬 ${user}: ${d.comment}`); break;
+    case 'gift':        console.log(`🎁 ${user} sent ${d.giftName} (${d.diamondCount}💎)`); break;
+    case 'like':        console.log(`❤️  ${user} liked × ${d.likeCount}`); break;
+    case 'member':      console.log(`👋 ${user} joined`); break;
+    case 'roomUserSeq': console.log(`👀 Viewers: ${d.viewerCount}`); break;
+    case 'roomInfo':    console.log(`📡 Room: ${msg.roomId}`); break;
+    default:            console.log(`📦 ${msg.event}`); break;
+  }
+});
+ws.on('close', () => console.log(`\n📊 Done! Received ${events} events.\n`));
+
+setTimeout(() => ws.close(), 60_000);
+```
+
+</details>
+
+---
+
 ## JavaScript (CommonJS)
 
 ```javascript

package/package.json

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