@tiktool/live 2.11.2 → 2.12.1

package/README.md

@@ -401,15 +401,32 @@ Returns full profile JSON. Pro tier and above. Cached server-side for 24h — re
 
 All API requests require an API key. Get yours at [tik.tools](https://tik.tools).
 
-| Tier | Price (USD / week) | WS Connections | Rate limit |
-|------|--------------------|----------------|------------|
-| **Free** | $0 | 1 | 5 req/min |
-| **Basic** | $9 | 25 | 30 req/min |
-| **Pro** | $19 | 100 | 120 req/min |
-| **Ultra** | $58 | 250 | 600 req/min |
+| Tier | Price | Requests/day | WS Connections | Notes |
+|------|-------|--------------|----------------|-------|
+| **Community** | Free forever | 2,500 | 15 (2h per WS) | Masked leaderboards. No datacenter proxies — calls run from your own IP. |
+| **Pro** | from $59/mo | 75,000 | 50 (8h) | Unmasked leaderboards · CAPTCHA Solver · Feed Discovery · 5 AI caption streams · priority routing |
+| **Ultra** | from $219/mo | 300,000 | 250 (8h) | Unmasked leagues · 20 AI caption streams · 99.5% uptime SLA · priority chat support |
+| **Global Agency** | $549/mo | 300,000 | 500 + Firehose | Everything in Ultra + **Live Gifter Firehose WS** (region/league/global + min-diamond filters) + VIP Telegram alerts + VIP Web Vault |
 
 The SDK calls the sign server **once per connection**, then stays connected
-via WebSocket. A free key is sufficient for most use cases.
+via WebSocket. The free Community tier caps each WebSocket at 2 hours and
+is sufficient for most use cases.
+
+### Live Gifter Firehose — Global Agency
+
+Real-time gift event stream from Dragonfly fan-out. Filter by region, league,
+or globally; cap by minimum diamond threshold. Mid-stream filter updates
+supported via `update_filter` frame.
+
+```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, creator, gift, region }
+})
+```
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tiktool/live",
-    "version": "2.11.2",
+    "version": "2.12.1",
     "description": "TikTok LIVE API Client — Real-time chat, gifts, viewers, PK battles with MVP breakdown, x2/x3 boosters, gloves, mist, match-guide & 20+ event types from any TikTok livestream. Direct WebSocket connection.",
     "author": "tiktool",
     "license": "MIT",