@tiktool/live 2.6.6 → 2.6.7

package/README.md

@@ -1,17 +1,18 @@
-# @tiktool/live
+# TikTok LIVE API — Node.js & TypeScript
 
-### Connect to any TikTok LIVE stream in 4 lines of code.
+### The managed TikTok Live Connector — receive chat, gifts, viewers, battles & 18+ events from any TikTok LIVE stream via WebSocket.
 
 [![npm version](https://img.shields.io/npm/v/@tiktool/live?color=%23ff0050&label=npm&logo=npm)](https://www.npmjs.com/package/@tiktool/live)
+[![npm downloads](https://img.shields.io/npm/dm/@tiktool/live)](https://www.npmjs.com/package/@tiktool/live)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green?logo=node.js)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?logo=typescript)](https://www.typescriptlang.org)
 
-Real-time chat, gifts, viewers, battles, follows & 18+ event types from any TikTok livestream.
+> **99.9% uptime** — Never breaks when TikTok updates. No protobuf, no reverse engineering, no maintenance. Also available for [Python](https://pypi.org/project/tiktok-live-api/), [Java, Go, C#, and any language via WebSocket](https://tik.tools/docs).
 
-**NEW:** 🎤 [Real-Time Live Captions](#-real-time-live-captions) — AI-powered speech-to-text transcription & translation with speaker diarization and sub-second latency.
+**🎤 NEW:** [Real-Time Live Captions](#-real-time-live-captions) — AI-powered speech-to-text transcription & translation with speaker diarization. **No other TikTok library offers this.**
 
-[Quick Start](#-quick-start) · [Events](#-events) · [Live Captions](#-real-time-live-captions) · [API](#-api-reference) · [Rate Limits](#-rate-limits) · [Get API Key](https://tik.tools)
+[Try It Now](#-try-it-now--5-minute-live-demo) · [Events](#-events) · [Live Captions](#-real-time-live-captions) · [API](#-api-reference) · [Rate Limits](#-rate-limits) · [Get API Key](https://tik.tools)
 
 ---
 
@@ -21,34 +22,16 @@ Real-time chat, gifts, viewers, battles, follows & 18+ event types from any TikT
 npm install @tiktool/live
 ```
 
-Get your free API key at [tik.tools](https://tik.tools)
+Get your free API key at [tik.tools](https://tik.tools) — then run the demo below.
 
-```typescript
-import { TikTokLive } from '@tiktool/live';
-
-const live = new TikTokLive({
-    uniqueId: 'tv_asahi_news',
-    apiKey: 'YOUR_API_KEY',
-});
-
-live.on('chat', e => console.log(`${e.user.uniqueId}: ${e.comment}`));
-live.on('gift', e => console.log(`${e.user.uniqueId} sent ${e.giftName} (${e.diamondCount} diamonds)`));
-live.on('member', e => console.log(`${e.user.uniqueId} joined`));
-live.on('roomUserSeq', e => console.log(`Viewers: ${e.viewerCount}`));
-
-await live.connect();
-```
-
----
-
-## 🚀 Try It Now — 60-Second Live Demo
+## 🚀 Try It Now — 5-Minute 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.
+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.
 
 **Save as `demo.mjs` and run with `node demo.mjs`:**
 
 ```javascript
-// demo.mjs — TikTok LIVE in 60 seconds
+// demo.mjs — TikTok LIVE in 5 minutes
 // npm install @tiktool/live
 import { TikTokLive } from '@tiktool/live';
 
@@ -68,11 +51,11 @@ live.on('roomUserSeq', e => { events++; console.log(`👀 Viewers: ${e.viewerCou
 live.on('subscribe',   e => { events++; console.log(`⭐ ${e.user.uniqueId} subscribed`); });
 live.on('battle',      e => { events++; console.log(`⚔️  Battle update`); });
 
-live.on('connected',   () => console.log(`\n✅ Connected to @${LIVE_USERNAME} — listening for 60s...\n`));
+live.on('connected',   () => console.log(`\n✅ Connected to @${LIVE_USERNAME} — listening for 5 min...\n`));
 live.on('disconnected', () => console.log(`\n📊 Done! Received ${events} events.\n`));
 
 await live.connect();
-setTimeout(() => { live.disconnect(); }, 60_000);
+setTimeout(() => { live.disconnect(); }, 300_000);
 ```
 
 <details>
@@ -91,7 +74,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 60s...\n`));
+ws.on('open', () => console.log(`\n✅ Connected to @${LIVE_USERNAME} — listening for 5 min...\n`));
 ws.on('message', (raw) => {
   const msg = JSON.parse(raw);
   events++;
@@ -109,7 +92,7 @@ ws.on('message', (raw) => {
 });
 ws.on('close', () => console.log(`\n📊 Done! Received ${events} events.\n`));
 
-setTimeout(() => ws.close(), 60_000);
+setTimeout(() => ws.close(), 300_000);
 ```
 
 </details>
@@ -331,7 +314,7 @@ All API requests require an API key. Get yours at [tik.tools](https://tik.tools)
 
 | Tier | Requests/Day | Rate Limit | WS Connections | WS Duration | WS Connects | Bulk Check | CAPTCHA | Feed Discovery | Price |
 |------|-------------|-----------|----------------|-------------|-------------|------------|---------|----------------|-------|
-| **Sandbox** | 50 | 5/min | 1 | 60 sec | 10/hr · 30/day | 1 | ✕ | ✕ | Free |
+| **Sandbox** | 50 | 5/min | 1 | 5 min | 10/hr · 30/day | 1 | ✕ | ✕ | Free |
 | **Basic** | 10,000 | 60/min | 3 | 8 hours | 60/hr · 200/day | 10 | ✕ | ✕ | From $7/wk |
 | **Pro** | 75,000 | Unlimited | 50 | 8 hours | Unlimited | 50 | 50/day | 100/day | From $15/wk |
 | **Ultra** | 300,000 | Unlimited | 500 | 8 hours | Unlimited | 500 | 500/day | 2,000/day | From $45/wk |

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tiktool/live",
-    "version": "2.6.6",
+    "version": "2.6.7",
     "description": "TikTok LIVE API Client — Real-time chat, gifts, viewers, live captions (speech-to-text), AI transcription & translation from any TikTok livestream.",
     "author": "tiktool",
     "license": "MIT",
@@ -34,7 +34,7 @@
     "homepage": "https://tik.tools",
     "repository": {
         "type": "git",
-        "url": "https://github.com/tiktool/live"
+        "url": "git+https://github.com/tiktool/tiktok-live-api.git"
     },
     "bugs": {
         "url": "https://github.com/tiktool/live/issues"