tiktok-live-api 1.4.5 → 1.4.6

package/README.md

@@ -1,427 +1,531 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/tiktool/tiktok-live-api/main/banner.png" alt="tiktok-live-api" width="100%" />
-</p>
-
-# tiktok-live-api
-
-> 📖 **Full documentation, guides, and dashboard → [tik.tools](https://tik.tools)** &nbsp;|&nbsp; 🐍 **Python SDK → [tik.tools/guides/python-tiktok-live](https://tik.tools/guides/python-tiktok-live)** &nbsp;|&nbsp; 🔌 **WebSocket API → [tik.tools/websocket](https://tik.tools/websocket)**
-
-**Unofficial TikTok LIVE API Client for Node.js & TypeScript** - Connect to any TikTok LIVE stream and receive real-time chat messages, gifts, likes, follows, viewer counts, battles, and more. Includes AI-powered live captions (speech-to-text). Powered by the [TikTool](https://tik.tools) managed API.
-
-[![npm](https://img.shields.io/npm/v/tiktok-live-api)](https://www.npmjs.com/package/tiktok-live-api)
-[![npm downloads](https://img.shields.io/npm/dm/tiktok-live-api)](https://www.npmjs.com/package/tiktok-live-api)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue)](https://www.typescriptlang.org/)
-[![License](https://img.shields.io/npm/l/tiktok-live-api)](https://github.com/tiktool/tiktok-live-api/blob/main/LICENSE)
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/tiktool/tiktok-live-api/main/tiktok-live-api.gif" alt="TikTok Live API Demo - real-time chat, gifts, and viewer events" width="700">
-</p>
-
-> This package is **not affiliated with or endorsed by TikTok**. It connects to the [TikTool Live](https://tik.tools) managed API service - 99.9% uptime, no reverse engineering, no maintenance required. Also available for [Python](https://pypi.org/project/tiktok-live-api/) and [any language via WebSocket](https://tik.tools/docs).
-
-## Install
-
-```bash
-npm install tiktok-live-api
-```
-
-```bash
-# or with yarn / pnpm / bun
-yarn add tiktok-live-api
-pnpm add tiktok-live-api
-bun add tiktok-live-api
-```
-
-## Quick Start
-
-```typescript
-import { TikTokLive } from 'tiktok-live-api';
-
-const client = new TikTokLive('streamer_username', { apiKey: 'YOUR_API_KEY' });
-
-client.on('chat', (event) => {
-  console.log(`${event.user.uniqueId}: ${event.comment}`);
-});
-
-client.on('gift', (event) => {
-  console.log(`${event.user.uniqueId} sent ${event.giftName} (${event.diamondCount} 💎)`);
-});
-
-client.on('like', (event) => {
-  console.log(`${event.user.uniqueId} liked (total: ${event.totalLikes})`);
-});
-
-client.on('follow', (event) => {
-  console.log(`${event.user.uniqueId} followed!`);
-});
-
-client.on('roomUserSeq', (event) => {
-  console.log(`${event.viewerCount} viewers watching`);
-});
-
-client.connect();
-```
-
-That's it. **No complex setup, no protobuf, no reverse engineering, no breakages when TikTok updates.**
-
----
-
-## 🚀 Try It Now - Live Demo
-
-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 real time
-// 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} - streaming events...\n`));
-client.on('disconnected', () => console.log(`\n📊 Disconnected. Received ${events} events.\n`));
-
-client.connect();
-// Press Ctrl+C to stop. Community tier caps each WebSocket at 2 hours.
-```
-
-<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} - streaming events...\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📊 Disconnected. Received ${events} events.\n`));
-// Press Ctrl+C to stop. Community tier caps each WebSocket at 2 hours.
-```
-
-</details>
-
----
-
-## JavaScript (CommonJS)
-
-```javascript
-const { TikTokLive } = require('tiktok-live-api');
-
-const client = new TikTokLive('streamer_username', { apiKey: 'YOUR_API_KEY' });
-client.on('chat', (e) => console.log(`${e.user.uniqueId}: ${e.comment}`));
-client.connect();
-```
-
-## Get a Free API Key
-
-1. Go to [tik.tools](https://tik.tools)
-2. Sign up (no credit card required)
-3. Copy your API key
-
-The free **Community** tier gives you 2,500 requests/day and 15 WebSocket connections (2 hours per connection). Forever free.
-
-## Environment Variable
-
-Instead of passing `apiKey` directly, you can set it as an environment variable:
-
-```bash
-# Linux / macOS
-export TIKTOOL_API_KEY=your_api_key_here
-
-# Windows (CMD)
-set TIKTOOL_API_KEY=your_api_key_here
-
-# Windows (PowerShell)
-$env:TIKTOOL_API_KEY="your_api_key_here"
-```
-
-```typescript
-import { TikTokLive } from 'tiktok-live-api';
-
-// Automatically reads TIKTOOL_API_KEY from environment
-const client = new TikTokLive('streamer_username');
-client.on('chat', (e) => console.log(e.comment));
-client.connect();
-```
-
-## Events
-
-| Event | Description | Key Fields |
-|-------|-------------|------------|
-| `chat` | Chat message | `user`, `comment`, `emotes`, `starred?` |
-| `gift` | Virtual gift | `user`, `giftName`, `diamondCount`, `repeatCount` |
-| `like` | Like event | `user`, `likeCount`, `totalLikes` |
-| `follow` | New follower | `user` |
-| `share` | Stream share | `user` |
-| `member` | Viewer joined | `user` |
-| `subscribe` | New subscriber | `user` |
-| `roomUserSeq` | Viewer count | `viewerCount`, `topViewers` |
-| `battle` | PK start / end / status change | `battleId`, `status` (1=ACTIVE / 2=STARTING / 3=ENDED / 4=PREPARING), `battleDuration`, `teams` |
-| `battleArmies` | Live PK score update | `battleId`, `status`, `matchId`, `sessionId`, `durationSec`, `secsRemaining`, `hosts[]` - each host has `teamTotalScore` + `contributors[]` (MVP first) |
-| `battleItemCard` | Booster multipliers, gloves, mist, match-guide, thunder, extra-time | `effect` (`'gloves'` / `'mist'` / `'booster_x2'` / `'booster_x3'` / `'match_guide'` / ...), `multiplier` (2 or 3), `senderUserId`, `senderNickname`, `activatedAtSec`, `durationSec`, `endsAtSec`, `commentTemplate` |
-| `roomPin` | Pinned/starred message | `user`, `comment`, `action`, `durationSeconds` |
-| `envelope` | Treasure chest | `diamonds`, `user` |
-| `streamEnd` | Stream ended | `reason` |
-| `connected` | Connected | `uniqueId` |
-| `disconnected` | Disconnected | `uniqueId` |
-| `error` | Error occurred | `error` |
-| `event` | Catch-all | Full raw event |
-
-All events are fully typed with TypeScript interfaces. Your IDE will show autocompletion for every field.
-
-### Battle / PK example
-
-```typescript
-import { TikTokLive } from 'tiktok-live-api';
-
-const client = new TikTokLive({ uniqueId: 'creator_username', apiKey: 'tk_...' });
-
-client.on('battle', e => console.log('PK', e.status, e.battleId, 'duration=', e.battleDuration));
-
-client.on('battleArmies', e => {
-  console.log('Countdown:', e.secsRemaining, 's');
-  for (const host of e.hosts ?? []) {
-    console.log(`@${host.hostUserId} team total=${host.teamTotalScore}`);
-    const mvp = host.contributors[0];
-    if (mvp) console.log(`  MVP @${mvp.nickname} score=${mvp.score}`);
-  }
-});
-
-client.on('battleItemCard', e => {
-  if (e.multiplier > 0) console.log(`x${e.multiplier} booster from @${e.senderUniqueId}`);
-  else console.log(`Effect ${e.effect} from @${e.senderUniqueId} (${e.durationSec}s)`);
-});
-
-await client.connect();
-```
-
-
-## Live Captions (Speech-to-Text)
-
-Transcribe and translate any TikTok LIVE stream in real-time. **This feature is unique to TikTool Live - no other TikTok library offers it.**
-
-```typescript
-import { TikTokCaptions } from 'tiktok-live-api';
-
-const captions = new TikTokCaptions('streamer_username', {
-  apiKey: 'YOUR_API_KEY',
-  translate: 'en',       // translate to English
-  diarization: true,     // identify who is speaking
-});
-
-captions.on('caption', (event) => {
-  const speaker = event.speaker ? `[${event.speaker}] ` : '';
-  console.log(`${speaker}${event.text}${event.isFinal ? ' ✓' : '...'}`);
-});
-
-captions.on('translation', (event) => {
-  console.log(`  → ${event.text}`);
-});
-
-captions.on('credits', (event) => {
-  console.log(`${event.remaining}/${event.total} minutes remaining`);
-});
-
-captions.connect();
-```
-
-### Caption Events
-
-| Event | Description | Key Fields |
-|-------|-------------|------------|
-| `caption` | Real-time caption text | `text`, `speaker`, `isFinal`, `language` |
-| `translation` | Translated caption | `text`, `sourceLanguage`, `targetLanguage` |
-| `credits` | Credit balance update | `total`, `used`, `remaining` |
-| `credits_low` | Low credit warning | `remaining`, `percentage` |
-| `status` | Session status | `status`, `message` |
-
-## Chat Bot Example
-
-```typescript
-import { TikTokLive } from 'tiktok-live-api';
-
-const client = new TikTokLive('streamer_username', { apiKey: 'YOUR_API_KEY' });
-const giftLeaderboard = new Map<string, number>();
-let messageCount = 0;
-
-client.on('chat', (event) => {
-  messageCount++;
-  const msg = event.comment.toLowerCase().trim();
-  const user = event.user.uniqueId;
-
-  if (msg === '!hello') {
-    console.log(`>> BOT: Welcome ${user}! 👋`);
-  } else if (msg === '!stats') {
-    console.log(`>> BOT: ${messageCount} messages, ${giftLeaderboard.size} gifters`);
-  } else if (msg === '!top') {
-    const top = [...giftLeaderboard.entries()]
-      .sort((a, b) => b[1] - a[1])
-      .slice(0, 5);
-    top.forEach(([name, diamonds], i) => {
-      console.log(`  ${i + 1}. ${name} - ${diamonds} 💎`);
-    });
-  }
-});
-
-client.on('gift', (event) => {
-  const user = event.user.uniqueId;
-  const diamonds = event.diamondCount || 0;
-  giftLeaderboard.set(user, (giftLeaderboard.get(user) || 0) + diamonds);
-});
-
-client.connect();
-```
-
-## TypeScript
-
-This package ships with full TypeScript support. All events are typed:
-
-```typescript
-import { TikTokLive, ChatEvent, GiftEvent } from 'tiktok-live-api';
-
-const client = new TikTokLive('streamer', { apiKey: 'KEY' });
-
-// Full autocompletion - your IDE knows the type of `event`
-client.on('chat', (event: ChatEvent) => {
-  console.log(event.user.uniqueId);  // ✓ typed
-  console.log(event.comment);        // ✓ typed
-});
-
-client.on('gift', (event: GiftEvent) => {
-  console.log(event.giftName);       // ✓ typed
-  console.log(event.diamondCount);   // ✓ typed
-});
-```
-
-## API Reference
-
-### `new TikTokLive(uniqueId, options?)`
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `apiKey` | `string` | `process.env.TIKTOOL_API_KEY` | Your TikTool API key |
-| `autoReconnect` | `boolean` | `true` | Auto-reconnect on disconnect |
-| `maxReconnectAttempts` | `number` | `5` | Max reconnection attempts |
-
-**Methods:**
-- `client.on(event, handler)` - Register event handler
-- `client.off(event, handler)` - Remove event handler
-- `client.connect()` - Connect to stream (returns Promise)
-- `client.disconnect()` - Disconnect from stream
-- `client.connected` - Whether currently connected
-- `client.eventCount` - Total events received
-
-### `new TikTokCaptions(uniqueId, options?)`
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `apiKey` | `string` | `process.env.TIKTOOL_API_KEY` | Your TikTool API key |
-| `translate` | `string` | `undefined` | Target translation language |
-| `diarization` | `boolean` | `true` | Enable speaker identification |
-| `maxDurationMinutes` | `number` | `60` | Auto-disconnect timer |
-
-**Methods:**
-- `captions.on(event, handler)` - Register event handler
-- `captions.off(event, handler)` - Remove event handler
-- `captions.connect()` - Start receiving captions (returns Promise)
-- `captions.disconnect()` - Stop receiving captions
-- `captions.connected` - Whether currently connected
-
-## Why tiktok-live-api?
-
-| | tiktok-live-api | tiktok-live-connector | TikTokLive (Python) |
-|---|---|---|---|
-| **Stability** | ✓ Managed API, 99.9% uptime | ✗ Breaks on TikTok updates | ✗ Breaks on TikTok updates |
-| **TypeScript** | ✓ First-class, fully typed | Partial | N/A |
-| **Live Captions** | ✓ AI speech-to-text | ✗ | ✗ |
-| **Translation** | ✓ Real-time, 50+ languages | ✗ | ✗ |
-| **Maintenance** | ✓ Zero - we handle it | ✗ You fix breakages | ✗ You fix breakages |
-| **CAPTCHA Solving** | ✓ Built-in (Pro+) | ✗ | ✗ |
-| **Feed Discovery** | ✓ See who's live | ✗ | ✗ |
-| **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 (2h per WS) | Free forever |
-| Pro | 75,000 | 50 (8h per WS) | from $19/wk +tax |
-| Ultra | 300,000 | 250 (8h per WS) | from $69/wk +tax |
-| **Global Agency** | 300,000 | 500 (8h per WS) + Firehose | $149/wk or $549/mo +tax |
-
-Full plan details at [tik.tools/pricing](https://tik.tools/pricing). Highlights:
-
-- **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** ($19/wk): 75K req/day · 50 WS · unmasked leaderboards · Feed Discovery · 5 AI caption streams · priority routing · chat support
-- **Ultra** ($69/wk): 300K req/day · 250 WS · 20 AI caption streams · **League Rankings API** unmasked · 99.5% uptime SLA · priority chat support
-- **Global Agency** ($149/wk or $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)
-
-### Live Gifter Firehose - Global Agency
-
-Real-time gift event stream from our Dragonfly fan-out. Filter by region, league, or globally; cap by minimum diamond threshold. Mid-stream filter updates supported via `update_filter` frame, no reconnect needed.
-
-```js
-const ws = new WebSocket(
-  `wss://api.tik.tools/firehose/gifters?apiKey=${KEY}&mode=region&region=US%2B&min_diamonds=1000`
-)
-ws.on('message', (raw) => {
-  const evt = JSON.parse(raw)
-  // evt: { type:'gifter_alert', ts, gifter:{username,displayName,isAnonymous},
-  //        creator:{uniqueId}, gift:{name,totalDiamonds}, region }
-})
-// Update filter without reconnect
-ws.send(JSON.stringify({ type: 'update_filter', mode: 'global', min_diamonds: 5000 }))
-```
-
-Modes: `global` (all regions), `region` (single region code), `league` (region + league class, e.g. `B2`).
-
-## Also Available
-
-- **Python**: [`pip install tiktok-live-api`](https://pypi.org/project/tiktok-live-api/)
-- **Any language**: Connect via WebSocket: `wss://api.tik.tools?uniqueId=USERNAME&apiKey=KEY`
-- **Unreal Engine**: Native C++/Blueprint plugin
-
-## Links
-
-- 🌐 **Website**: [tik.tools](https://tik.tools)
-- 📖 **Documentation**: [tik.tools/docs](https://tik.tools/docs)
-- 🐍 **Python SDK**: [pypi.org/project/tiktok-live-api](https://pypi.org/project/tiktok-live-api/)
-- 💻 **GitHub**: [github.com/tiktool/tiktok-live-api](https://github.com/tiktool/tiktok-live-api)
-
-## License
-
-MIT
+<p align="center">
+  <img src="https://raw.githubusercontent.com/tiktool/tiktok-live-api/main/banner.png" alt="tiktok-live-api" width="100%" />
+</p>
+
+<p align="center">
+  <a href="https://discord.com/oauth2/authorize?client_id=1482386543233597470">
+    <img src="https://img.shields.io/badge/Add%20TikTool%20Bot%20to%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Add TikTool Bot to Discord" height="46">
+  </a>
+</p>
+
+<p align="center"><b>Agency rank feeds in Discord</b>: gaming ranks, creator ranks and 99+ movers across all 30 regions, copy-paste usernames for backstage. Run <code>/ranks</code> to start (Global Agency).</p>
+
+# tiktok-live-api
+
+> 📖 **Full documentation, guides, and dashboard → [tik.tools](https://tik.tools)** &nbsp;|&nbsp; 🐍 **Python SDK → [tik.tools/guides/python-tiktok-live](https://tik.tools/guides/python-tiktok-live)** &nbsp;|&nbsp; 🔌 **WebSocket API → [tik.tools/websocket](https://tik.tools/websocket)**
+
+**Unofficial TikTok LIVE API Client for Node.js & TypeScript** - Connect to any TikTok LIVE stream and receive real-time chat messages, gifts, likes, follows, viewer counts, battles, and more. Includes AI-powered live captions (speech-to-text). Powered by the [TikTool](https://tik.tools) managed API.
+
+[![npm](https://img.shields.io/npm/v/tiktok-live-api)](https://www.npmjs.com/package/tiktok-live-api)
+[![npm downloads](https://img.shields.io/npm/dm/tiktok-live-api)](https://www.npmjs.com/package/tiktok-live-api)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue)](https://www.typescriptlang.org/)
+[![License](https://img.shields.io/npm/l/tiktok-live-api)](https://github.com/tiktool/tiktok-live-api/blob/main/LICENSE)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/tiktool/tiktok-live-api/main/tiktok-live-api.gif" alt="TikTok Live API Demo - real-time chat, gifts, and viewer events" width="700">
+</p>
+
+> This package is **not affiliated with or endorsed by TikTok**. It connects to the [TikTool Live](https://tik.tools) managed API service - 99.9% uptime, no reverse engineering, no maintenance required. Also available for [Python](https://pypi.org/project/tiktok-live-api/) and [any language via WebSocket](https://tik.tools/docs).
+
+## Install
+
+```bash
+npm install tiktok-live-api
+```
+
+```bash
+# or with yarn / pnpm / bun
+yarn add tiktok-live-api
+pnpm add tiktok-live-api
+bun add tiktok-live-api
+```
+
+## Quick Start
+
+```typescript
+import { TikTokLive } from 'tiktok-live-api';
+
+const client = new TikTokLive('streamer_username', { apiKey: 'YOUR_API_KEY' });
+
+client.on('chat', (event) => {
+  console.log(`${event.user.uniqueId}: ${event.comment}`);
+});
+
+client.on('gift', (event) => {
+  console.log(`${event.user.uniqueId} sent ${event.giftName} (${event.diamondCount} 💎)`);
+});
+
+client.on('like', (event) => {
+  console.log(`${event.user.uniqueId} liked (total: ${event.totalLikes})`);
+});
+
+client.on('follow', (event) => {
+  console.log(`${event.user.uniqueId} followed!`);
+});
+
+client.on('roomUserSeq', (event) => {
+  console.log(`${event.viewerCount} viewers watching`);
+});
+
+client.connect();
+```
+
+That's it. **No complex setup, no protobuf, no reverse engineering, no breakages when TikTok updates.**
+
+---
+
+## 🚀 Try It Now - Live Demo
+
+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 real time
+// 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} - streaming events...\n`));
+client.on('disconnected', () => console.log(`\n📊 Disconnected. Received ${events} events.\n`));
+
+client.connect();
+// Press Ctrl+C to stop. Community tier caps each WebSocket at 2 hours.
+```
+
+<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} - streaming events...\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📊 Disconnected. Received ${events} events.\n`));
+// Press Ctrl+C to stop. Community tier caps each WebSocket at 2 hours.
+```
+
+</details>
+
+---
+
+## JavaScript (CommonJS)
+
+```javascript
+const { TikTokLive } = require('tiktok-live-api');
+
+const client = new TikTokLive('streamer_username', { apiKey: 'YOUR_API_KEY' });
+client.on('chat', (e) => console.log(`${e.user.uniqueId}: ${e.comment}`));
+client.connect();
+```
+
+## Get a Free API Key
+
+1. Go to [tik.tools](https://tik.tools)
+2. Sign up (no credit card required)
+3. Copy your API key
+
+The free **Community** tier gives you 2,500 requests/day and 15 WebSocket connections (2 hours per connection). Forever free.
+
+## Environment Variable
+
+Instead of passing `apiKey` directly, you can set it as an environment variable:
+
+```bash
+# Linux / macOS
+export TIKTOOL_API_KEY=your_api_key_here
+
+# Windows (CMD)
+set TIKTOOL_API_KEY=your_api_key_here
+
+# Windows (PowerShell)
+$env:TIKTOOL_API_KEY="your_api_key_here"
+```
+
+```typescript
+import { TikTokLive } from 'tiktok-live-api';
+
+// Automatically reads TIKTOOL_API_KEY from environment
+const client = new TikTokLive('streamer_username');
+client.on('chat', (e) => console.log(e.comment));
+client.connect();
+```
+
+## Events (54 v3 event types)
+
+Every event is dispatched by name. `client.on('chat', e => ...)` is fully typed end-to-end. Each event payload extends `BaseEvent` (`type`, `timestamp`, `msgId`, optional `protoVersion: 1 | 2 | 3`).
+
+### Core live events
+
+| Event | Description |
+|---|---|
+| `connected` | WebSocket open. |
+| `disconnected` | WebSocket close. |
+| `roomInfo` | One-shot post-connect: `{ roomId, wsHost, clusterRegion, connectedAt }`. |
+| `chat` | Chat message. `user`, `comment`, `emotes`, optional `starred`. **v3** adds `language` (auto-detected ISO 639-1) + `messageUuid` (moderation correlation). |
+| `gift` | Virtual gift. `giftId`, `giftName`, `diamondCount`, `repeatCount`, `repeatEnd`, `giftType`. **v3** adds `transactionId` (dedup key), `senderUserId`, `relationship` (`joinDayNumber`, `fromUser`, `toUser`). |
+| `like` | Like batch. `likeCount`, `totalLikes`. |
+| `member` | Viewer joined. **v3** adds `actionCode`, `entrySource` (`"homepage_hot-live_cell"`, `"follow-tab"`, ...), `entryAction` (`"draw"`/`"click"`), `entryType` (`"rec"` = algorithmic). |
+| `social` | Follow / share. |
+| `roomUserSeq` | Periodic viewer count tick. |
+| `subscribe` | A viewer subscribed. |
+
+### PK / battle events
+
+| Event | Description |
+|---|---|
+| `battle` | PK lifecycle. `status` (1=ACTIVE, 2=STARTING, 3=ENDED, 4=PREPARING), `battleDuration`, `teams`. **v3** adds `extraHostUserIds`, `layoutSubtype`. |
+| `battleArmies` | Per-host MVP breakdown ticking through the PK. `hosts[].contributors[]` sorted MVP first. **v3** adds `transactionId`. |
+| `battleItemCard` | Booster card: x2 / x3 multipliers, gloves (crit), mist, thunder, extra-time, match-guide. Includes overlay assets from TikTok's CDN. |
+| `battlePunishFinish` | Loser-side punishment screen ended. |
+| `battleNotice` | PK notice (version-mismatch toast, invite-failure). |
+| `battleGameplay` | PK mini-game state (Whack-A-Mole, Tic-Tac-Toe variants). |
+| `linkLayer` | PK / link-mic negotiation (invite, cancel, accept, source change). |
+| `linkMicOpponentGift` | Per-gift breakdown from the OPPONENT side of a PK. |
+| `linkScreenChange` | PK split-screen layout flip (1v1 / 1vN / cohost mode swap). |
+| `cohostLayoutUpdate` | Cohost layout subtype change. |
+| `linkMic`, `linkMicLayoutState`, `link` | Generic link-mic envelopes. |
+| `competition`, `competitionContributor` | Cross-stream competition + per-contributor breakdown. |
+| `guestShowdown` | Guest showdown lifecycle. |
+
+### Native captions (v3)
+
+| Event | Description |
+|---|---|
+| `caption` | **NEW in v3.** TikTok native auto-captions on the LIVE WebSocket. `text`, `isFinal`, `startedAtMs`, `endsAtMs`. Independent of the operator-managed [TikTok Live Captions](https://tik.tools/captions) product. |
+
+### Creator-side events
+
+| Event | Description |
+|---|---|
+| `goalUpdate` | Stream goal progress (subscriber / gift / watch-time goals). |
+| `commentTray` | Comment tray UI state change. |
+| `roomPin` | A chat got pinned by the host or a moderator. |
+| `hostBoard` | Host leaderboard board update. |
+| `privilegeAdvance` | Viewer privilege tier-up notification with overlay assets. |
+| `anchorToolModification` | Creator modified a panel/widget. |
+| `inRoomBanner` | In-room activity banner. |
+| `roomSticker` | Room-wide sticker drop. |
+| `bottomMessage` | Bottom-bar safety / risk notice. |
+| `accessRecall`, `roomVerify` | Content-classification recheck events. |
+| `smbBoard` | SMB (small-business) board overlay. |
+| `streamStatus` | Stream status flip. |
+| `shareRevenueNotice` | Share-revenue subscriber count change. |
+| `capsule` | TikTok service-plus pin reminder. |
+| `hotRoom` | TikTok promoted the room to a high-traffic slot. |
+| `linkMicAnchorGuide` | Anchor (creator) guide nudges. |
+
+### Moderation / safety
+
+| Event | Description |
+|---|---|
+| `imDelete` | Chat moderation delete. Correlate via `chat.messageUuid` (v3). |
+| `unauthorizedMember` | Unauthorized viewer hit a gated feature. |
+| `barrage` | Raw barrage feed (announcements, special effects). |
+| `superFan`, `superFanJoin`, `superFanBox` | Super-fan lifecycle. |
+| `emoteChat` | Inline emote message. |
+
+### Gift catalog + ecommerce
+
+| Event | Description |
+|---|---|
+| `giftPanelUpdate` | Real-time gift catalog change. Cache-bust your local catalog. |
+| `giftDynamicRestriction` | Per-room gift availability flip / age-gating. |
+| `giftGallery` | Host-side gift wall snapshot. |
+| `giftUnlock` | Host unlocked a gated gift. |
+| `viewerPicksUpdate` | TikTok-promoted viewer-pick gift highlights. |
+| `oecLiveShopping`, `oecLiveManager`, `oecLiveBillboard` | OEC live-shopping events. |
+| `ecShortItemRefresh` | Lucky-bag drop refreshed. |
+
+### Engagement + AI
+
+| Event | Description |
+|---|---|
+| `aiSummary` | TikTok AI summary of the room (entry-time recap, multi-language). |
+| `poll`, `shortTouch` | In-stream poll lifecycle. |
+| `rankText`, `rankUpdate`, `hourlyRank` | Rank events. |
+| `question`, `questionSelected`, `questionSlideDown` | Q&A round events. |
+| `pictionaryUpdate`, `pictionaryEnd`, `pictionaryExit` | Drawing-game round events. |
+| `fansEvent`, `fanTicket` | Fan-club events. |
+| `envelope`, `envelopePortal` | Red-envelope drops + multi-room portal chain. |
+| `gameMoment`, `gameServerFeature` | TikTok Gaming live integration. |
+| `groupLiveMemberNotify` | Group-live member join / leave. |
+| `perception` | Perception event (mute cancel, TikTok hint signal). |
+| `control`, `room`, `liveIntro` | Stream control + room metadata. |
+
+### Catch-all
+
+- `event` - Fires for every decoded event (dump-to-queue pattern).
+- `unknown` - Fires when TikTok ships a method we don't yet model (forward-compat hook).
+
+All events are fully typed with TypeScript interfaces. Your IDE will show autocompletion for every field. See [full per-event JSON examples + field tables](https://tik.tools/docs).
+
+### Battle / PK example
+
+```typescript
+import { TikTokLive } from 'tiktok-live-api';
+
+const client = new TikTokLive({ uniqueId: 'creator_username', apiKey: 'tk_...' });
+
+client.on('battle', e => console.log('PK', e.status, e.battleId, 'duration=', e.battleDuration));
+
+client.on('battleArmies', e => {
+  console.log('Countdown:', e.secsRemaining, 's');
+  for (const host of e.hosts ?? []) {
+    console.log(`@${host.hostUserId} team total=${host.teamTotalScore}`);
+    const mvp = host.contributors[0];
+    if (mvp) console.log(`  MVP @${mvp.nickname} score=${mvp.score}`);
+  }
+});
+
+client.on('battleItemCard', e => {
+  if (e.multiplier > 0) console.log(`x${e.multiplier} booster from @${e.senderUniqueId}`);
+  else console.log(`Effect ${e.effect} from @${e.senderUniqueId} (${e.durationSec}s)`);
+});
+
+await client.connect();
+```
+
+
+## Live Captions (Speech-to-Text)
+
+Transcribe and translate any TikTok LIVE stream in real-time. **This feature is unique to TikTool Live - no other TikTok library offers it.**
+
+```typescript
+import { TikTokCaptions } from 'tiktok-live-api';
+
+const captions = new TikTokCaptions('streamer_username', {
+  apiKey: 'YOUR_API_KEY',
+  translate: 'en',       // translate to English
+  diarization: true,     // identify who is speaking
+});
+
+captions.on('caption', (event) => {
+  const speaker = event.speaker ? `[${event.speaker}] ` : '';
+  console.log(`${speaker}${event.text}${event.isFinal ? ' ✓' : '...'}`);
+});
+
+captions.on('translation', (event) => {
+  console.log(`  → ${event.text}`);
+});
+
+captions.on('credits', (event) => {
+  console.log(`${event.remaining}/${event.total} minutes remaining`);
+});
+
+captions.connect();
+```
+
+### Caption Events
+
+| Event | Description | Key Fields |
+|-------|-------------|------------|
+| `caption` | Real-time caption text | `text`, `speaker`, `isFinal`, `language` |
+| `translation` | Translated caption | `text`, `sourceLanguage`, `targetLanguage` |
+| `credits` | Credit balance update | `total`, `used`, `remaining` |
+| `credits_low` | Low credit warning | `remaining`, `percentage` |
+| `status` | Session status | `status`, `message` |
+
+## Chat Bot Example
+
+```typescript
+import { TikTokLive } from 'tiktok-live-api';
+
+const client = new TikTokLive('streamer_username', { apiKey: 'YOUR_API_KEY' });
+const giftLeaderboard = new Map<string, number>();
+let messageCount = 0;
+
+client.on('chat', (event) => {
+  messageCount++;
+  const msg = event.comment.toLowerCase().trim();
+  const user = event.user.uniqueId;
+
+  if (msg === '!hello') {
+    console.log(`>> BOT: Welcome ${user}! 👋`);
+  } else if (msg === '!stats') {
+    console.log(`>> BOT: ${messageCount} messages, ${giftLeaderboard.size} gifters`);
+  } else if (msg === '!top') {
+    const top = [...giftLeaderboard.entries()]
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, 5);
+    top.forEach(([name, diamonds], i) => {
+      console.log(`  ${i + 1}. ${name} - ${diamonds} 💎`);
+    });
+  }
+});
+
+client.on('gift', (event) => {
+  const user = event.user.uniqueId;
+  const diamonds = event.diamondCount || 0;
+  giftLeaderboard.set(user, (giftLeaderboard.get(user) || 0) + diamonds);
+});
+
+client.connect();
+```
+
+## TypeScript
+
+This package ships with full TypeScript support. All events are typed:
+
+```typescript
+import { TikTokLive, ChatEvent, GiftEvent } from 'tiktok-live-api';
+
+const client = new TikTokLive('streamer', { apiKey: 'KEY' });
+
+// Full autocompletion - your IDE knows the type of `event`
+client.on('chat', (event: ChatEvent) => {
+  console.log(event.user.uniqueId);  // ✓ typed
+  console.log(event.comment);        // ✓ typed
+});
+
+client.on('gift', (event: GiftEvent) => {
+  console.log(event.giftName);       // ✓ typed
+  console.log(event.diamondCount);   // ✓ typed
+});
+```
+
+## API Reference
+
+### `new TikTokLive(uniqueId, options?)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | `process.env.TIKTOOL_API_KEY` | Your TikTool API key |
+| `autoReconnect` | `boolean` | `true` | Auto-reconnect on disconnect |
+| `maxReconnectAttempts` | `number` | `5` | Max reconnection attempts |
+
+**Methods:**
+- `client.on(event, handler)` - Register event handler
+- `client.off(event, handler)` - Remove event handler
+- `client.connect()` - Connect to stream (returns Promise)
+- `client.disconnect()` - Disconnect from stream
+- `client.connected` - Whether currently connected
+- `client.eventCount` - Total events received
+
+### `new TikTokCaptions(uniqueId, options?)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | `process.env.TIKTOOL_API_KEY` | Your TikTool API key |
+| `translate` | `string` | `undefined` | Target translation language |
+| `diarization` | `boolean` | `true` | Enable speaker identification |
+| `maxDurationMinutes` | `number` | `60` | Auto-disconnect timer |
+
+**Methods:**
+- `captions.on(event, handler)` - Register event handler
+- `captions.off(event, handler)` - Remove event handler
+- `captions.connect()` - Start receiving captions (returns Promise)
+- `captions.disconnect()` - Stop receiving captions
+- `captions.connected` - Whether currently connected
+
+## Why tiktok-live-api?
+
+| | tiktok-live-api | tiktok-live-connector | TikTokLive (Python) |
+|---|---|---|---|
+| **Type** | Managed agency-grade platform | Self-hosted client | Self-hosted client |
+| **Hosting** | ✓ Fully managed, 99.9% uptime | You run the client; signing via paid backend | You run the client; signing via paid backend |
+| **TypeScript** | ✓ First-class, fully typed | ✓ Typed | N/A (Python) |
+| **AI Live Captions (STT + translation)** | ✓ 60+ languages | ✗ | ✗ |
+| **Unreal Engine plugin** | ✓ | ✗ | ✗ |
+| **Gifter Intel (LTV, archetypes)** | ✓ | ✗ | ✗ |
+| **Live Leaderboards (real-time)** | ✓ Regional + global | ✗ | ✗ |
+| **Battle History + Per-Match Timeline** | ✓ | ✗ | ✗ |
+| **League Rankings (Diamond Rush)** | ✓ | ✗ | ✗ |
+| **Real-time Discord + Telegram Alerts** | ✓ | ✗ | ✗ |
+| **Sniper Gap (live battle tracker)** | ✓ | ✗ | ✗ |
+| **Agency CRM + Watchlists** | ✓ | ✗ | ✗ |
+| **Public Profile Pages (creator + gifter)** | ✓ Indexed | ✗ | ✗ |
+| **CAPTCHA Solving** | ✓ Built-in (Pro+) | Via signing backend | Via signing backend |
+| **Feed Discovery** | ✓ See who's live | ✗ | ✗ |
+| **Free Tier** | ✓ 2,500 req/day, 15 WS, 2h per WS | ✓ MIT-licensed | ✓ MIT-licensed |
+| **ESM + CJS** | ✓ Both supported | ✓ | N/A (Python) |
+
+## Pricing
+
+Tier is enforced server-side by your API key. Snapshot below; the full feature matrix lives at [tik.tools/pricing](https://tik.tools/pricing).
+
+| Tier | Weekly | Monthly | Req/min | Req/day | Concurrent WS | WS max duration | Bulk check |
+|---|---|---|---|---|---|---|---|
+| Community | free | free | 5 (300/h) | 2,500 | 1 | 2h | - |
+| Basic | $7 | $19 | 60 | 10,000 | 20 | 8h | 10/req |
+| Pro | $15 | $49 | 300 | 75,000 | 50 | 12h | 50/req |
+| Ultra | $45 | $149 | 1,000 | 300,000 | 250 | 24h | 100/req |
+| **Global Agency** | $119 | $399 | 5,000 | 1,000,000 | 500 | 24h | 200/req |
+
+- **Community** ($0 forever): 1 concurrent WS, 2h per session, masked leaderboards. Designed for devs building apps - upgrade when you need real usernames. No datacenter proxies; calls come from your own IP.
+- **Basic** ($7/wk - $19/mo): 60 req/min, 20 concurrent WS, 8h per WS, datacenter proxies, masked leaderboards, **12h/wk - 60h/mo of bundled AI Live Captions**.
+- **Pro** ($15/wk - $49/mo): 300 req/min, 50 concurrent WS, 12h per WS, **unmasked leaderboards**, Feed Discovery, regional leaderboard signed URLs, **30h/wk - 140h/mo of bundled AI Live Captions**.
+- **Ultra** ($45/wk - $149/mo): 1,000 req/min, 250 concurrent WS, 24h per WS, **Gift Catalog API** (full TikTok gift catalog continuously re-synced), **League Rankings unmasked**, CSV exports, 99.5% uptime SLA, **60h/wk - 260h/mo of bundled AI Live Captions**.
+- **Global Agency** ($119/wk - $399/mo): Everything in Ultra plus **Live Gifter Firehose WS** (region / league / global filters + min-diamond threshold), VIP Telegram alerts, VIP Web Vault (unmasked historical visual access), **gifter intel unmasked**, 500 concurrent WS, **120h/wk - 500h/mo of bundled AI Live Captions**.
+
+Standalone AI Live Captions plans (no API key needed) on [tik.tools/captions](https://tik.tools/captions): Casual ($7/wk - $29/mo for 12h/wk - 60h/mo), Pro ($15/wk - $59/mo for 30h/wk - 140h/mo), Extreme ($29/wk - $99/mo for 60h/wk - 260h/mo). Auto-renew + early-renewal on exhaust so captions never drop mid-stream.
+
+### Live Gifter Firehose - Global Agency
+
+Real-time gift event stream from our Dragonfly fan-out. Filter by region, league, or globally; cap by minimum diamond threshold. Mid-stream filter updates supported via `update_filter` frame, no reconnect needed.
+
+```js
+const ws = new WebSocket(
+  `wss://api.tik.tools/firehose/gifters?apiKey=${KEY}&mode=region&region=US%2B&min_diamonds=1000`
+)
+ws.on('message', (raw) => {
+  const evt = JSON.parse(raw)
+  // evt: { type:'gifter_alert', ts, gifter:{username,displayName,isAnonymous},
+  //        creator:{uniqueId}, gift:{name,totalDiamonds}, region }
+})
+// Update filter without reconnect
+ws.send(JSON.stringify({ type: 'update_filter', mode: 'global', min_diamonds: 5000 }))
+```
+
+Modes: `global` (all regions), `region` (single region code), `league` (region + league class, e.g. `B2`).
+
+## Also Available
+
+- **Python**: [`pip install tiktok-live-api`](https://pypi.org/project/tiktok-live-api/)
+- **Any language**: Connect via WebSocket: `wss://api.tik.tools?uniqueId=USERNAME&apiKey=KEY`
+- **Unreal Engine**: Native C++/Blueprint plugin
+
+## Links
+
+- 🌐 **Website**: [tik.tools](https://tik.tools)
+- 📖 **Documentation**: [tik.tools/docs](https://tik.tools/docs)
+- 🐍 **Python SDK**: [pypi.org/project/tiktok-live-api](https://pypi.org/project/tiktok-live-api/)
+- 💻 **GitHub**: [github.com/tiktool/tiktok-live-api](https://github.com/tiktool/tiktok-live-api)
+
+## License
+
+MIT

package/package.json

@@ -1,84 +1,84 @@
-{
-  "name": "tiktok-live-api",
-  "version": "1.4.5",
-  "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",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "tiktok",
-    "tiktok-live",
-    "tiktok-api",
-    "tiktok-live-api",
-    "tiktok-live-connector",
-    "tiktok-live-sdk",
-    "tiktok-websocket",
-    "tiktok-chat",
-    "tiktok-gifts",
-    "tiktok-bot",
-    "tiktok-data",
-    "tiktok-stream",
-    "tiktok-events",
-    "tiktok-viewer",
-    "live-streaming",
-    "live-chat",
-    "webcast",
-    "websocket",
-    "real-time",
-    "speech-to-text",
-    "captions",
-    "transcription",
-    "translation",
-    "tiktok-live-python",
-    "tiktok-tools",
-    "euler-stream",
-    "tiktoklive",
-    "tiktok-connector",
-    "tiktok-live-node",
-    "tiktok-live-js",
-    "tiktok-scraper",
-    "tiktok-monitoring",
-    "livestream-api"
-  ],
-  "author": {
-    "name": "TikTool",
-    "email": "support@tik.tools",
-    "url": "https://tik.tools"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/tiktool/tiktok-live-api"
-  },
-  "bugs": {
-    "url": "https://github.com/tiktool/tiktok-live-api/issues"
-  },
-  "homepage": "https://tik.tools",
-  "dependencies": {
-    "ws": "^8.16.0"
-  },
-  "devDependencies": {
-    "@types/ws": "^8.5.10",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  }
-}
+{
+  "name": "tiktok-live-api",
+  "version": "1.4.6",
+  "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",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "tiktok",
+    "tiktok-live",
+    "tiktok-api",
+    "tiktok-live-api",
+    "tiktok-live-connector",
+    "tiktok-live-sdk",
+    "tiktok-websocket",
+    "tiktok-chat",
+    "tiktok-gifts",
+    "tiktok-bot",
+    "tiktok-data",
+    "tiktok-stream",
+    "tiktok-events",
+    "tiktok-viewer",
+    "live-streaming",
+    "live-chat",
+    "webcast",
+    "websocket",
+    "real-time",
+    "speech-to-text",
+    "captions",
+    "transcription",
+    "translation",
+    "tiktok-live-python",
+    "tiktok-tools",
+    "euler-stream",
+    "tiktoklive",
+    "tiktok-connector",
+    "tiktok-live-node",
+    "tiktok-live-js",
+    "tiktok-scraper",
+    "tiktok-monitoring",
+    "livestream-api"
+  ],
+  "author": {
+    "name": "TikTool",
+    "email": "support@tik.tools",
+    "url": "https://tik.tools"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tiktool/tiktok-live-api"
+  },
+  "bugs": {
+    "url": "https://github.com/tiktool/tiktok-live-api/issues"
+  },
+  "homepage": "https://tik.tools",
+  "dependencies": {
+    "ws": "^8.16.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.10",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}