@tiktool/live 2.11.0 → 2.11.1

package/README.md

@@ -349,10 +349,29 @@ live.on('battle', (e) => {
 | `connect()` | `Promise<void>` | Connect to livestream |
 | `disconnect()` | `void` | Disconnect |
 | `getStreamUrl()` | `Promise<StreamInfo>` | Get FLV/HLS playback URLs for the live video |
+| `getUserProfile(uniqueId?)` | `Promise<UserProfile>` | Resolve any TikTok username → numeric `id`, `secUid`, nickname, bio, avatars, follower stats |
 | `connected` | `boolean` | Connection status |
 | `eventCount` | `number` | Total events received |
 | `roomId` | `string` | Current room ID |
 
+### Static methods (no connection required)
+
+```typescript
+// Get numeric TikTok user ID + full profile for any @username (Pro tier+)
+const profile = await TikTokLive.getUserProfile({
+    uniqueId: 'dalga.ahmedov',
+    apiKey: 'YOUR_KEY',
+});
+profile.id;                  // "7355610677036581896"  ← numeric streamer ID
+profile.nickname;            // "🤍DENIZ🖤🌊"
+profile.secUid;              // signed TikTok user identifier
+profile.stats.followerCount; // 7945
+profile.avatarLarger;        // CDN URL
+
+// Get FLV/HLS playback URLs for any creator
+const stream = await TikTokLive.getStreamUrl({ uniqueId, apiKey });
+```
+
 ### REST endpoints (companion to the WS SDK)
 
 For lookups outside the live event stream, hit the sign server directly with your API key:

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tiktool/live",
-    "version": "2.11.0",
+    "version": "2.11.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",