@tiktool/live 2.10.1 → 2.11.1

package/dist/index.mjs

@@ -2468,6 +2468,52 @@ var TikTokLive = class _TikTokLive extends EventEmitter {
       hlsPullUrl: d.hls_pull_url || void 0
     };
   }
+  /**
+   * Resolve a TikTok username to the streamer's full public profile —
+   * numeric user ID, secUid, nickname, bio, avatars, follower stats.
+   *
+   * Useful when you need the numeric TikTok ID for a username (the inverse
+   * of `resolve_user_ids`, which only goes userId → username).
+   *
+   * Requires Pro tier+. Cached server-side for 24h.
+   *
+   * @example
+   * ```ts
+   * const profile = await TikTokLive.getUserProfile({
+   *   uniqueId: 'dalga.ahmedov',
+   *   apiKey: 'YOUR_KEY',
+   * });
+   * console.log(profile.id);                    // "7355610677036581896" (numeric)
+   * console.log(profile.nickname);              // display name
+   * console.log(profile.stats.followerCount);   // 12345
+   * console.log(profile.avatarLarger);          // CDN URL
+   * ```
+   */
+  static async getUserProfile(options) {
+    const serverUrl = (options.signServerUrl || DEFAULT_SIGN_SERVER).replace(/\/$/, "");
+    const uname = options.uniqueId.replace(/^@/, "");
+    const qs = new URLSearchParams({ unique_id: uname });
+    if (options.nocache) qs.set("nocache", "1");
+    const resp = await fetch(`${serverUrl}/webcast/user_profile?${qs}`, {
+      headers: { "x-api-key": options.apiKey }
+    });
+    const data = await resp.json();
+    if (data.status_code !== 0 || !data.data?.profile) {
+      throw new Error(data.error || `Failed to get user profile for @${uname}`);
+    }
+    return data.data.profile;
+  }
+  /**
+   * Instance shortcut — fetch the profile of the streamer this client is
+   * connected to (or any other user if `uniqueId` is passed).
+   */
+  async getUserProfile(uniqueId) {
+    return _TikTokLive.getUserProfile({
+      uniqueId: uniqueId || this.uniqueId,
+      apiKey: this.apiKey,
+      signServerUrl: this.signServerUrl
+    });
+  }
   on(event, listener) {
     return super.on(event, listener);
   }