tiktok-live-api 1.2.18 → 2.0.0

package/README.md

@@ -18,6 +18,54 @@
 
 > 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).
 
+---
+
+## 🔄 Migrating from TikTok-Live-Connector?
+
+**One import, zero code changes.** If you use `tiktok-live-connector`, switch to the managed TikTools API in seconds:
+
+### Step 1: Install
+
+```bash
+npm install tiktok-live-api
+```
+
+### Step 2: Change one line
+
+```diff
+- const { WebcastPushConnection } = require('tiktok-live-connector');
++ const { WebcastPushConnection } = require('tiktok-live-api');
+```
+
+### Step 3: Replace your Euler key with a TikTools key
+
+```diff
+  const connection = new WebcastPushConnection('username', {
+-   signApiKey: 'EULER_API_KEY',
++   signApiKey: 'TIKTOOL_API_KEY',  // Get free at tik.tools
+  });
+```
+
+**That's it.** All your existing event handlers (`chat`, `gift`, `member`, `roomUser`, `like`, `follow`, `share`, `emote`, `linkMicBattle`, `linkMicArmies`, `questionNew`, etc.) work identically. `getState()`, `connect()`, `disconnect()` — all the same.
+
+<details>
+<summary><strong>Why switch?</strong></summary>
+
+| | tiktok-live-api | tiktok-live-connector |
+|---|---|---|
+| **Stability** | ✓ Managed API, 99.9% uptime | ✗ Breaks on TikTok updates |
+| **Maintenance** | ✓ Zero — we handle it | ✗ You fix breakages |
+| **CAPTCHA Solving** | ✓ Built-in (Pro+) | ✗ |
+| **Live Captions** | ✓ AI speech-to-text | ✗ |
+| **Translation** | ✓ Real-time, 50+ languages | ✗ |
+| **Feed Discovery** | ✓ See who's live | ✗ |
+| **TypeScript** | ✓ First-class, fully typed | Partial |
+| **Free Tier** | ✓ 50 requests/day | ✓ Free (unreliable) |
+
+</details>
+
+---
+
 ## 🚀 One-Command Quick Start
 
 Instantly connect to a live TikTok stream and print real-time events to your terminal. No signup, no install:
@@ -190,6 +238,8 @@ client.connect();
 
 ## Events
 
+### Stream Events
+
 | Event | Description | Key Fields |
 |-------|-------------|------------|
 | `chat` | Chat message | `user`, `comment`, `emotes`, `starred?` |
@@ -201,90 +251,57 @@ client.connect();
 | `subscribe` | New subscriber | `user` |
 | `roomUserSeq` | Viewer count | `viewerCount`, `topViewers` |
 | `battle` | Battle event | `type`, `teams`, `scores` |
+| `battleArmies` | Battle teams | `teams` |
 | `roomPin` | Pinned/starred message | `user`, `comment`, `action`, `durationSeconds` |
 | `envelope` | Treasure chest | `diamonds`, `user` |
+| `emoteChat` | Emote in chat | `user`, `emoteId`, `emoteUrl` |
+| `question` | Q&A question | `user`, `questionText` |
+| `liveIntro` | Stream intro | `title` |
+| `rankUpdate` | Rank update | `rankType` |
+| `control` | Stream control | `action` |
+| `superFan` | Someone became Super Fan | `user`, `level`, `displayType` |
+| `superFanJoin` | Super Fan joined chat | `user`, `displayType` |
+| `superFanBox` | Super Fan Box gift | `user`, `diamondCount` |
+| `barrage` | Raw barrage signal | `user`, `label`, `displayType`, `content` |
 | `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.
 
-## Live Captions (Speech-to-Text)
+### TTLC-Compatible Aliases
 
-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';
-
-<<<<<<< HEAD
-live.on('event', (event) => {
-    console.log(event.type, event);
-});
-```
+These aliases ensure 100% compatibility with TikTok-Live-Connector event names:
 
-### Reference
-
-| Event | Type | Description | Fields |
-|-------|------|-------------|--------|
-| `chat` | `ChatEvent` | Chat message | `user`, `comment`, `starred?` |
-| `member` | `MemberEvent` | User joined | `user`, `action` |
-| `like` | `LikeEvent` | User liked | `user`, `likeCount`, `totalLikes` |
-| `gift` | `GiftEvent` | Gift sent | `user`, `giftName`, `diamondCount`, `repeatCount`, `combo` |
-| `social` | `SocialEvent` | Follow / Share | `user`, `action` |
-| `roomUserSeq` | `RoomUserSeqEvent` | Viewer count | `viewerCount`, `totalViewers` |
-| `battle` | `BattleEvent` | Link Mic battle | `status` |
-| `battleArmies` | `BattleArmiesEvent` | Battle teams | — |
-| `subscribe` | `SubscribeEvent` | New subscriber | `user`, `subMonth` |
-| `emoteChat` | `EmoteChatEvent` | Emote in chat | `user`, `emoteId` |
-| `envelope` | `EnvelopeEvent` | Treasure chest | `diamondCount` |
-| `question` | `QuestionEvent` | Q&A question | `user`, `questionText` |
-| `control` | `ControlEvent` | Stream control | `action` (3 = ended) |
-| `room` | `RoomEvent` | Room status | `status` |
-| `liveIntro` | `LiveIntroEvent` | Stream intro | `title` |
-| `rankUpdate` | `RankUpdateEvent` | Rank update | `rankType` |
-| `linkMic` | `LinkMicEvent` | Link Mic | `action` |
-| `roomPin` | `RoomPinEvent` | Pinned/starred message | `user`, `comment`, `action`, `durationSeconds` |
-| `unknown` | `UnknownEvent` | Unrecognized | `method` |
+| TTLC Name | Maps To | Notes |
+|-----------|---------|-------|
+| `roomUser` | `roomUserSeq` | Both fire simultaneously |
+| `questionNew` | `question` | Both fire simultaneously |
+| `linkMicBattle` | `battle` | Both fire simultaneously |
+| `linkMicArmies` | `battleArmies` | Both fire simultaneously |
+| `emote` | `emoteChat` | Both fire simultaneously |
 
 ### Connection Events
 
-| Event | Callback | Description |
-|-------|----------|-------------|
-| `connected` | `() => void` | Connected to stream |
-| `disconnected` | `(code, reason) => void` | Disconnected |
-| `roomInfo` | `(info: RoomInfo) => void` | Room info |
-| `error` | `(error: Error) => void` | Error |
+| Event | Description |
+|-------|-------------|
+| `connected` | Connected to stream |
+| `disconnected` | Disconnected |
+| `error` | Error occurred |
+| `event` | Catch-all (full raw payload) |
+| `rawData` | Same as `event` (TTLC compat) |
+| `decodedData` | Same as `event` (TTLC compat) |
+| `websocketConnected` | WebSocket connected (TTLC compat) |
 
----
+All events are fully typed with TypeScript interfaces. Your IDE will show autocompletion for every field.
 
 ## 🎤 Real-Time Live Captions
 
-AI-powered speech-to-text transcription and translation for TikTok LIVE streams. Features include:
-
-- **Auto-detect language** — Automatically identifies the spoken language
-- **Speaker diarization** — Identifies individual speakers in multi-person streams
-- **Real-time translation** — Translate to any supported language with sub-second latency
-- **Partial + final results** — Get streaming partial transcripts and confirmed final text
-- **Credit-based billing** — 1 credit = 1 minute of transcription/translation
-
-### Quick Start
+AI-powered speech-to-text transcription and translation for TikTok LIVE streams. **This feature is unique to TikTool Live — no other TikTok library offers it.**
 
 ```typescript
-import { TikTokCaptions } from '@tiktool/live';
-
-const captions = new TikTokCaptions({
-    uniqueId: 'streamer_name',
-    apiKey: 'YOUR_API_KEY',
-    translate: 'en',
-    diarization: true,
-=======
+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
->>>>>>> ac7990ac0be77c4206d9d8fa0bccbe1c85a2bbe6
 });
 
 captions.on('caption', (event) => {
@@ -378,6 +395,7 @@ client.on('gift', (event: GiftEvent) => {
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `apiKey` | `string` | `process.env.TIKTOOL_API_KEY` | Your TikTool API key |
+| `signApiKey` | `string` | — | Alias for `apiKey` (TTLC compat) |
 | `autoReconnect` | `boolean` | `true` | Auto-reconnect on disconnect |
 | `maxReconnectAttempts` | `number` | `5` | Max reconnection attempts |
 
@@ -388,6 +406,15 @@ client.on('gift', (event: GiftEvent) => {
 - `client.disconnect()` — Disconnect from stream
 - `client.connected` — Whether currently connected
 - `client.eventCount` — Total events received
+- `client.getState()` — Get connection state (TTLC compat)
+- `client.getRoomInfo()` — Get room info (TTLC compat)
+
+### `new WebcastPushConnection(uniqueId, options?)`
+
+Drop-in replacement for TikTok-Live-Connector. See [Migration Guide](#-migrating-from-tiktok-live-connector).
+
+All `TikTokLive` options are supported, plus TTLC-specific options that are accepted silently:
+`processInitialData`, `fetchRoomInfoOnConnect`, `enableExtendedGiftInfo`, `enableWebsocketUpgrade`, `sessionId`, `clientParams`, `requestHeaders`, `websocketHeaders`, `signProviderOptions`.
 
 ### `new TikTokCaptions(uniqueId, options?)`
 
@@ -438,6 +465,7 @@ client.on('gift', (event: GiftEvent) => {
 
 - 🌐 **Website**: [tik.tools](https://tik.tools)
 - 📖 **Documentation**: [tik.tools/docs](https://tik.tools/docs)
+- 🔄 **Migration Guide**: [tik.tools/migrate](https://tik.tools/migrate)
 - 🐍 **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)
 

package/bin/demo.mjs

@@ -537,6 +537,13 @@ function runScaffold(choice, targetDir, pm) {
           html = html.replace(/src="\/src\/main\.tsx?"/g, 'src="/src/main.jsx"');
           fs.writeFileSync(indexHtml, html);
         }
+
+        // Install dependencies for Vite (create-vite --no-interactive doesn't auto-install)
+        if (isVite) {
+          const installBase = pm === 'npm' ? 'npm install' : pm === 'yarn' ? 'yarn' : pm === 'pnpm' ? 'pnpm install' : 'bun install';
+          console.log("\n  " + B + "📦 Installing dependencies..." + R + "\n");
+          execSync(installBase, { cwd: fullPath, stdio: 'inherit' });
+        }
       }
     }
 
@@ -548,9 +555,6 @@ function runScaffold(choice, targetDir, pm) {
     } else if (isNode) {
       console.log("    node index.mjs\n");
     } else {
-      if (isVite && pm !== 'bun') {
-        console.log("    " + pm + " install");
-      }
       console.log("    " + devCmd + "\n");
     }
 

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import WebSocket from 'ws';
+
 /**
  * Type definitions for TikTok LIVE API events.
  *
@@ -54,12 +56,12 @@ interface SocialEvent {
     user: TikTokUser;
     eventType: string;
 }
-/** Payload for `roomUserSeq` (viewer count) events. */
+/** Payload for `roomUserSeq` / `roomUser` (viewer count) events. */
 interface RoomUserSeqEvent {
     viewerCount: number;
     topViewers: TikTokUser[];
 }
-/** Payload for `battle` events. */
+/** Payload for `battle` / `linkMicBattle` events. */
 interface BattleEvent {
     type: string;
     teams: Array<Record<string, unknown>>;
@@ -84,6 +86,60 @@ interface RoomPinEvent {
     /** User ID of the operator who pinned the message. */
     operatorUserId: string;
 }
+/** Payload for `superFan` events. */
+interface SuperFanEvent {
+    user: TikTokUser;
+    level: number;
+    displayType: string;
+}
+/** Payload for `superFanJoin` events. */
+interface SuperFanJoinEvent {
+    user: TikTokUser;
+    displayType: string;
+}
+/** Payload for `superFanBox` events. */
+interface SuperFanBoxEvent {
+    user: TikTokUser;
+    envelopeId: string;
+    diamondCount: number;
+}
+/** Payload for `barrage` events. */
+interface BarrageEvent {
+    user: TikTokUser;
+    label: string;
+    displayType: string;
+    content: string;
+}
+/** Payload for `emoteChat` / `emote` events. */
+interface EmoteChatEvent {
+    user: TikTokUser;
+    emoteId: string;
+    emoteUrl: string;
+}
+/** Payload for `question` / `questionNew` events. */
+interface QuestionEvent {
+    user: TikTokUser;
+    questionText: string;
+}
+/** Payload for `control` events. */
+interface ControlEvent {
+    action: number;
+}
+/** Payload for `liveIntro` events. */
+interface LiveIntroEvent {
+    title: string;
+    [key: string]: unknown;
+}
+/** Payload for `rankUpdate` events. */
+interface RankUpdateEvent {
+    rankType: string;
+    [key: string]: unknown;
+}
+/** Payload for `linkMic` events. */
+interface LinkMicEvent {
+    action: string;
+    [key: string]: unknown;
+}
 /** Payload for `caption` events from {@link TikTokCaptions}. */
 interface CaptionEvent {
     text: string;
@@ -117,6 +173,8 @@ interface ErrorEvent {
 }
 /**
  * Map of event names to their payload types for {@link TikTokLive}.
+ *
+ * Includes native TikTools events and TTLC-compatible aliases.
  */
 interface TikTokLiveEventMap {
     chat: ChatEvent;
@@ -126,16 +184,47 @@ interface TikTokLiveEventMap {
     share: SocialEvent;
     member: MemberEvent;
     subscribe: SocialEvent;
+    social: SocialEvent;
     roomUserSeq: RoomUserSeqEvent;
     battle: BattleEvent;
     roomPin: RoomPinEvent;
     envelope: Record<string, unknown>;
     streamEnd: Record<string, unknown>;
     roomInfo: Record<string, unknown>;
+    emoteChat: EmoteChatEvent;
+    question: QuestionEvent;
+    control: ControlEvent;
+    liveIntro: LiveIntroEvent;
+    rankUpdate: RankUpdateEvent;
+    linkMic: LinkMicEvent;
+    battleArmies: Record<string, unknown>;
+    room: Record<string, unknown>;
+    unknown: Record<string, unknown>;
+    superFan: SuperFanEvent;
+    superFanJoin: SuperFanJoinEvent;
+    superFanBox: SuperFanBoxEvent;
+    barrage: BarrageEvent;
+    /** @alias roomUserSeq */
+    roomUser: RoomUserSeqEvent;
+    /** @alias question */
+    questionNew: QuestionEvent;
+    /** @alias battle */
+    linkMicBattle: BattleEvent;
+    /** @alias battleArmies */
+    linkMicArmies: Record<string, unknown>;
+    /** @alias emoteChat */
+    emote: EmoteChatEvent;
     connected: ConnectedEvent;
     disconnected: DisconnectedEvent;
     error: ErrorEvent;
+    /** Catch-all: fires for every incoming event with full raw payload. */
     event: Record<string, unknown>;
+    /** rawData: fires for every event (TTLC compat). Same as `event`. */
+    rawData: Record<string, unknown>;
+    /** decodedData: fires for every event (TTLC compat). Same as `event`. */
+    decodedData: Record<string, unknown>;
+    /** websocketConnected: fires when WS connects (TTLC compat). */
+    websocketConnected: Record<string, unknown>;
 }
 /**
  * Map of event names to their payload types for {@link TikTokCaptions}.
@@ -177,10 +266,28 @@ interface TikTokCaptionsEventMap {
 interface TikTokLiveOptions {
     /** Your TikTool API key. Get one free at https://tik.tools */
     apiKey?: string;
+    /**
+     * Euler Stream API key — for users migrating from TikTok-Live-Connector.
+     * If provided and `apiKey` is not set, this is used as the API key.
+     * @alias apiKey
+     */
+    signApiKey?: string;
     /** Auto-reconnect on disconnect (default: true). */
     autoReconnect?: boolean;
     /** Max reconnection attempts (default: 5). */
     maxReconnectAttempts?: number;
+    /** @deprecated Handled server-side. Accepted for TTLC compatibility. */
+    processInitialData?: boolean;
+    /** @deprecated Handled server-side. Accepted for TTLC compatibility. */
+    fetchRoomInfoOnConnect?: boolean;
+    /** @deprecated Always enabled server-side. Accepted for TTLC compatibility. */
+    enableExtendedGiftInfo?: boolean;
+    /** @deprecated Accepted for TTLC compatibility. */
+    enableWebsocketUpgrade?: boolean;
+    /** @deprecated Accepted for TTLC compatibility. */
+    requestPollingIntervalMs?: number;
+    /** TikTok session ID for authenticated features. */
+    sessionId?: string;
 }
 type EventHandler$1<T> = (data: T) => void | Promise<void>;
 /**
@@ -203,12 +310,14 @@ declare class TikTokLive {
     readonly autoReconnect: boolean;
     /** Maximum reconnection attempts. */
     readonly maxReconnectAttempts: number;
-    private _handlers;
-    private _ws;
-    private _connected;
-    private _intentionalClose;
-    private _reconnectAttempts;
-    private _eventCount;
+    protected _handlers: Map<string, Set<EventHandler$1<any>>>;
+    protected _ws: WebSocket | null;
+    protected _connected: boolean;
+    protected _intentionalClose: boolean;
+    protected _reconnectAttempts: number;
+    protected _eventCount: number;
+    protected _roomId: string;
+    protected _roomInfo: Record<string, any> | null;
     /**
      * Create a new TikTokLive client.
      *
@@ -228,15 +337,16 @@ declare class TikTokLive {
     /**
      * Register an event handler.
      *
+     * Supports both native TikTools event names and TTLC-compatible aliases:
+     * - `roomUser` → `roomUserSeq`
+     * - `questionNew` → `question`
+     * - `linkMicBattle` → `battle`
+     * - `linkMicArmies` → `battleArmies`
+     * - `emote` → `emoteChat`
+     *
      * @param event - Event name (chat, gift, like, follow, etc.)
      * @param handler - Callback function
      * @returns this (for chaining)
-     *
-     * @example
-     * ```typescript
-     * client.on('chat', (event) => console.log(event.comment));
-     * client.on('gift', (event) => console.log(event.giftName));
-     * ```
      */
     on<K extends keyof TikTokLiveEventMap>(event: K, handler: EventHandler$1<TikTokLiveEventMap[K]>): this;
     on(event: string, handler: EventHandler$1<any>): this;
@@ -247,7 +357,7 @@ declare class TikTokLive {
      * @param handler - The handler to remove
      */
     off(event: string, handler: EventHandler$1<any>): this;
-    private _emit;
+    protected _emit(event: string, data: any): void;
     /**
      * Connect to the TikTok LIVE stream.
      *
@@ -263,6 +373,19 @@ declare class TikTokLive {
      * Disconnect from the stream.
      */
     disconnect(): void;
+    /**
+     * Get current connection state (TTLC-compatible).
+     */
+    getState(): {
+        isConnected: boolean;
+        roomId: string;
+        roomInfo: Record<string, any> | null;
+        uniqueId: string;
+    };
+    /**
+     * Get room info (TTLC-compatible).
+     */
+    getRoomInfo(): Record<string, any> | null;
     private _maybeReconnect;
 }
 
@@ -371,4 +494,140 @@ declare class TikTokCaptions {
     disconnect(): void;
 }
 
-export { type BattleEvent, type CaptionEvent, type ChatEvent, type ConnectedEvent, type CreditsEvent, type DisconnectedEvent, type ErrorEvent, type GiftEvent, type LikeEvent, type MemberEvent, type RoomUserSeqEvent, type SocialEvent, TikTokCaptions, type TikTokCaptionsEventMap, type TikTokCaptionsOptions, TikTokLive, type TikTokLiveEventMap, type TikTokLiveOptions, type TikTokUser, type TranslationEvent };
+/**
+ * TikTok-Live-Connector (TTLC) compatibility layer.
+ *
+ * Drop-in replacement for `WebcastPushConnection` from `tiktok-live-connector`.
+ * Users can switch to TikTools by changing a single import line:
+ *
+ * ```diff
+ * - const { WebcastPushConnection } = require('tiktok-live-connector');
+ * + const { WebcastPushConnection } = require('tiktok-live-api');
+ * ```
+ *
+ * All TTLC event names, constructor options, and methods are supported.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Control events matching TikTok-Live-Connector's ControlEvents.
+ */
+declare const ControlEvents: {
+    readonly CONNECTED: "connected";
+    readonly DISCONNECTED: "disconnected";
+    readonly ERROR: "error";
+    readonly RAWDATA: "rawData";
+    readonly DECODEDDATA: "decodedData";
+    readonly STREAMEND: "streamEnd";
+    readonly WSCONNECTED: "websocketConnected";
+};
+/**
+ * Message events matching TikTok-Live-Connector's MessageEvents.
+ */
+declare const MessageEvents: {
+    readonly CHAT: "chat";
+    readonly MEMBER: "member";
+    readonly GIFT: "gift";
+    readonly ROOMUSER: "roomUser";
+    readonly SOCIAL: "social";
+    readonly LIKE: "like";
+    readonly QUESTIONNEW: "questionNew";
+    readonly LINKMICBATTLE: "linkMicBattle";
+    readonly LINKMICARMIES: "linkMicArmies";
+    readonly LIVEINTRO: "liveIntro";
+    readonly EMOTE: "emote";
+    readonly ENVELOPE: "envelope";
+    readonly SUBSCRIBE: "subscribe";
+    readonly BARRAGE: "barrage";
+    readonly SUPERFAN: "superFan";
+    readonly SUPERFANJOIN: "superFanJoin";
+    readonly SUPERFANBOX: "superFanBox";
+    readonly ROOMPIN: "roomPin";
+};
+/**
+ * Custom events matching TikTok-Live-Connector's CustomEvents.
+ */
+declare const CustomEvents: {
+    readonly FOLLOW: "follow";
+    readonly SHARE: "share";
+};
+interface WebcastPushConnectionOptions extends TikTokLiveOptions {
+    /** Euler Stream API key (maps to TikTools apiKey). */
+    signApiKey?: string;
+    /** @deprecated Handled server-side. Accepted for compatibility. */
+    processInitialData?: boolean;
+    /** @deprecated Handled server-side. Accepted for compatibility. */
+    fetchRoomInfoOnConnect?: boolean;
+    /** @deprecated Always enabled. Accepted for compatibility. */
+    enableExtendedGiftInfo?: boolean;
+    /** @deprecated Always true. Accepted for compatibility. */
+    enableWebsocketUpgrade?: boolean;
+    /** @deprecated Not used. Accepted for compatibility. */
+    enableRequestPolling?: boolean;
+    /** @deprecated Not used. Accepted for compatibility. */
+    requestPollingIntervalMs?: number;
+    /** TikTok session ID. */
+    sessionId?: string;
+    /** @deprecated Not used. Accepted for compatibility. */
+    clientParams?: Record<string, any>;
+    /** @deprecated Not used. Accepted for compatibility. */
+    requestHeaders?: Record<string, string>;
+    /** @deprecated Not used. Accepted for compatibility. */
+    websocketHeaders?: Record<string, string>;
+    /** @deprecated Not used. Accepted for compatibility. */
+    requestOptions?: Record<string, any>;
+    /** @deprecated Not used. Accepted for compatibility. */
+    websocketOptions?: Record<string, any>;
+    /** @deprecated Not used. Accepted for compatibility. */
+    signProviderOptions?: Record<string, any>;
+}
+/**
+ * Drop-in replacement for TikTok-Live-Connector's `WebcastPushConnection`.
+ *
+ * Accepts the exact same constructor signature and event names.
+ * Under the hood, connects to the TikTools managed WebSocket API
+ * for 99.9% uptime and zero maintenance.
+ *
+ * @example
+ * ```typescript
+ * // Before (TikTok-Live-Connector):
+ * // const { WebcastPushConnection } = require('tiktok-live-connector');
+ *
+ * // After (TikTools — one-line change):
+ * const { WebcastPushConnection } = require('tiktok-live-api');
+ *
+ * const connection = new WebcastPushConnection('username', {
+ *   signApiKey: 'YOUR_TIKTOOL_API_KEY', // Get free at tik.tools
+ * });
+ *
+ * connection.on('chat', (data) => {
+ *   console.log(`${data.uniqueId}: ${data.comment}`);
+ * });
+ *
+ * connection.connect();
+ * ```
+ */
+declare class WebcastPushConnection extends TikTokLive {
+    constructor(uniqueId: string, options?: WebcastPushConnectionOptions);
+    /**
+     * Get current connection state — TTLC-compatible shape.
+     *
+     * Returns the same structure as TikTok-Live-Connector's `getState()`.
+     */
+    getState(): {
+        isConnected: boolean;
+        upgradedToWebsocket: boolean;
+        roomId: string;
+        roomInfo: Record<string, any> | null;
+        availableGifts: never[];
+        uniqueId: string;
+    };
+    /**
+     * Get available gifts — TTLC-compatible.
+     * Note: Gift info is included in event payloads automatically.
+     */
+    getAvailableGifts(): any[];
+}
+
+export { type BarrageEvent, type BattleEvent, type CaptionEvent, type ChatEvent, type ConnectedEvent, type ControlEvent, ControlEvents, type CreditsEvent, CustomEvents, type DisconnectedEvent, type EmoteChatEvent, type ErrorEvent, type GiftEvent, type LikeEvent, type LinkMicEvent, type LiveIntroEvent, type MemberEvent, MessageEvents, type QuestionEvent, type RankUpdateEvent, type RoomPinEvent, type RoomUserSeqEvent, type SocialEvent, type SuperFanBoxEvent, type SuperFanEvent, type SuperFanJoinEvent, TikTokCaptions, type TikTokCaptionsEventMap, type TikTokCaptionsOptions, TikTokLive, type TikTokLiveEventMap, type TikTokLiveOptions, type TikTokUser, type TranslationEvent, WebcastPushConnection, type WebcastPushConnectionOptions };