tiktok-live-api 1.4.0 → 1.4.2

package/README.md

@@ -66,14 +66,14 @@ That's it. **No complex setup, no protobuf, no reverse engineering, no breakages
 
 ---
 
-## 🚀 Try It Now — 5-Minute Live Demo
+## 🚀 Try It Now — Live Demo
 
-Copy-paste this into a file and run it. Connects to a live TikTok stream, prints every event for 5 minutes, then exits. Works on the free Sandbox tier.
+Copy-paste this into a file and run it. Connects to a live TikTok stream and prints every event in real time. Works on the free Community tier — 2 hours per WebSocket connection.
 
 **Save as `demo.mjs` and run with `node demo.mjs`:**
 
 ```javascript
-// demo.mjs — TikTok LIVE in 5 minutes
+// demo.mjs — TikTok LIVE in real time
 // npm install tiktok-live-api
 import { TikTokLive } from 'tiktok-live-api';
 
@@ -90,11 +90,11 @@ client.on('member',      e => { events++; console.log(`👋 ${e.user.uniqueId} j
 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 5 min...\n`));
-client.on('disconnected', () => console.log(`\n📊 Done! Received ${events} events.\n`));
+client.on('connected',    () => console.log(`\n✅ Connected to @${LIVE_USERNAME} — streaming events...\n`));
+client.on('disconnected', () => console.log(`\n📊 Disconnected. Received ${events} events.\n`));
 
 client.connect();
-setTimeout(() => { client.disconnect(); }, 300_000);
+// Press Ctrl+C to stop. Community tier caps each WebSocket at 2 hours.
 ```
 
 <details>
@@ -111,7 +111,7 @@ 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 5 min...\n`));
+ws.on('open', () => console.log(`\n✅ Connected to @${LIVE_USERNAME} — streaming events...\n`));
 ws.on('message', (raw) => {
   const msg = JSON.parse(raw);
   events++;
@@ -127,9 +127,8 @@ ws.on('message', (raw) => {
     default:            console.log(`📦 ${msg.event}`); break;
   }
 });
-ws.on('close', () => console.log(`\n📊 Done! Received ${events} events.\n`));
-
-setTimeout(() => ws.close(), 300_000);
+ws.on('close', () => console.log(`\n📊 Disconnected. Received ${events} events.\n`));
+// Press Ctrl+C to stop. Community tier caps each WebSocket at 2 hours.
 ```
 
 </details>
@@ -152,7 +151,7 @@ client.connect();
 2. Sign up (no credit card required)
 3. Copy your API key
 
-The free Sandbox tier gives you 50 requests/day and 1 WebSocket connection.
+The free **Community** tier gives you 2,500 requests/day and 15 WebSocket connections (2 hours per connection). Forever free.
 
 ## Environment Variable
 
@@ -372,21 +371,21 @@ client.on('gift', (event: GiftEvent) => {
 | **Maintenance** | ✓ Zero — we handle it | ✗ You fix breakages | ✗ You fix breakages |
 | **CAPTCHA Solving** | ✓ Built-in (Pro+) | ✗ | ✗ |
 | **Feed Discovery** | ✓ See who's live | ✗ | ✗ |
-| **Free Tier** | ✓ 50 requests/day | ✓ Free (unreliable) | ✓ Free (unreliable) |
+| **Free Tier** | ✓ 2,500 req/day, 15 WS, 2h per WS | ✓ Free (unreliable) | ✓ Free (unreliable) |
 | **ESM + CJS** | ✓ Both supported | ✓ | N/A |
 
 ## Pricing
 
 | Tier | Requests/Day | WebSocket Connections | Price |
 |------|-------------|----------------------|-------|
-| Community | 2,500 | 15 (no time limit) | Free forever |
-| Pro | 75,000 | 50 (8h) | from $59/mo +tax |
-| Ultra | 300,000 | 250 (8h) | from $219/mo +tax |
-| **Global Agency** | 300,000 | 500 (8h) + Firehose | $549/mo +tax |
+| Community | 2,500 | 15 (2h per WS) | Free forever |
+| Pro | 75,000 | 50 (8h per WS) | from $59/mo +tax |
+| Ultra | 300,000 | 250 (8h per WS) | from $219/mo +tax |
+| **Global Agency** | 300,000 | 500 (8h per WS) + Firehose | $549/mo +tax |
 
 Full plan details at [tik.tools/pricing](https://tik.tools/pricing). Highlights:
 
-- **Community** ($0 forever): 2,500 req/day · 15 WS · no time limit · masked leaderboards. Designed for devs building apps — upgrade when you need real usernames. No datacenter proxies; calls must come from your own IP.
+- **Community** ($0 forever): 2,500 req/day · 15 WS · 2 hours per connection · masked leaderboards. Designed for devs building apps — upgrade when you need real usernames. No datacenter proxies; calls must come from your own IP.
 - **Pro** (monthly): 75K req/day · 50 WS · unmasked leaderboards · CAPTCHA Solver · Feed Discovery · 5 AI caption streams · priority routing · chat support
 - **Ultra** (monthly): 300K req/day · 250 WS · 20 AI caption streams · **League Rankings API** unmasked · 99.5% uptime SLA · priority chat support
 - **Global Agency** ($549/mo): Everything in Ultra + **Live Gifter Firehose WS** (region/league/global filters, min-diamond threshold) + VIP Telegram alerts + VIP Web Vault (unmasked historical visual access)

package/package.json

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