@zfadhli/tokrec 0.13.0 → 0.15.2

package/src/io/tiktok/parse.ts

@@ -0,0 +1,171 @@
+export interface SigiState {
+  LiveRoom?: {
+    liveRoomStatus?: number
+    liveRoomUserInfo?: {
+      user?: {
+        id?: string | number
+        roomId?: string | number
+      }
+      liveRoom?: {
+        status?: number // 2 = live, 4 = offline
+        title?: string
+        startTime?: number
+        streamData?: {
+          pull_data?: {
+            stream_data?: string // JSON string with FLV/HLS URLs
+          }
+        }
+      }
+    }
+  }
+  UserModule?: {
+    users?: {
+      [username: string]: {
+        id?: string // numeric user ID
+        uniqueId?: string
+        roomId?: string | { id: string }
+      }
+    }
+  }
+}
+
+// ─── HTML parsing ──────────────────────────────────────────
+
+/**
+ * @public Exported for testing.
+ */
+export function extractSigiState(html: string): SigiState | null {
+  const match = html.match(/<script\s+id="SIGI_STATE"\s+type="application\/json">(.*?)<\/script>/)
+  if (!match?.[1]) return null
+  try {
+    return JSON.parse(match[1]) as SigiState
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Extract the numeric user ID and optional room ID from TikTok's new
+ * page structure (__UNIVERSAL_DATA_FOR_REHYDRATION__).
+ *
+ * The profile page (/@user) includes "webapp.user-detail" which
+ * contains the user's numeric ID. When the user is live, the roomId
+ * is also embedded here.
+ *
+ * Returns { userId, roomId } where userId is always set when the data
+ * is found, and roomId is set only when the user is currently live.
+ *
+ * @public Exported for testing and fixture capture.
+ */
+export function extractUserFromUniversalData(html: string): {
+  userId: string | null
+  roomId: string | null
+} {
+  const match = html.match(
+    /<script\s+id="__UNIVERSAL_DATA_FOR_REHYDRATION__"\s+type="application\/json">(.*?)<\/script>/,
+  )
+  if (!match?.[1]) return { userId: null, roomId: null }
+  try {
+    const data = JSON.parse(match[1])
+    const scope = (data as Record<string, unknown>).__DEFAULT_SCOPE__ ?? data
+    const userDetail = scope?.["webapp.user-detail"]
+    const user = userDetail?.userInfo?.user
+    const userId = user?.id ? String(user.id) : null
+    const roomId = user?.roomId ? String(user.roomId) : null
+    return { userId, roomId }
+  } catch {
+    return { userId: null, roomId: null }
+  }
+}
+
+// ─── Stream URL extraction ─────────────────────────────────
+
+/**
+ * Fast-path: extract stream URL from the known SIGI_STATE location.
+ * This covers ~95% of cases without needing a full recursive search.
+ *
+ * Prefers FLV (lower latency) over HLS/other protocols.
+ */
+export function extractStreamUrlFast(
+  liveRoom: NonNullable<NonNullable<SigiState["LiveRoom"]>["liveRoomUserInfo"]>["liveRoom"],
+): string | null {
+  try {
+    const raw = liveRoom?.streamData?.pull_data?.stream_data
+    if (!raw) return null
+    const parsed = JSON.parse(raw) as Record<string, unknown>
+    const data = (parsed as Record<string, unknown>)?.data as Record<string, unknown> | undefined
+    if (!data) return null
+
+    // Try all known quality keys, preferring higher quality.
+    // FLV is preferred (lower latency); HLS is the fallback.
+    const qualities = ["origin", "fhd", "uhd", "hd", "sd", "ld"]
+    for (const q of qualities) {
+      const entry = data[q] as { main?: { flv?: string; hls?: string } } | undefined
+      // Prefer FLV over HLS when both are available
+      const url = entry?.main?.flv ?? entry?.main?.hls
+      if (url) return url
+    }
+    return null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Brute-force recursive search for a stream URL anywhere in a JSON value.
+ * Survives TikTok changing key names or nesting structure.
+ *
+ * Prefers FLV over HLS when both are present in the response.
+ *
+ * Inspired by PR #430 (Michele0303/tiktok-live-recorder).
+ */
+export function findStreamUrlRecursively(obj: unknown): string | null {
+  // Collect all candidate URLs with their preference
+  const flvUrls: string[] = []
+  const m3u8Urls: string[] = []
+
+  function walk(value: unknown): void {
+    if (typeof value === "string") {
+      // Direct URL match
+      if (
+        (value.startsWith("http://") || value.startsWith("https://")) &&
+        (value.includes(".flv") || value.includes(".m3u8"))
+      ) {
+        if (value.includes(".flv")) {
+          flvUrls.push(value)
+        } else {
+          m3u8Urls.push(value)
+        }
+        return
+      }
+      // JSON-encoded string — parse and recurse
+      if (value.startsWith("{") || value.startsWith("[")) {
+        try {
+          walk(JSON.parse(value))
+        } catch {
+          // skip
+        }
+      }
+      return
+    }
+
+    if (value && typeof value === "object") {
+      if (Array.isArray(value)) {
+        for (const item of value) {
+          walk(item)
+        }
+      } else {
+        for (const val of Object.values(value as Record<string, unknown>)) {
+          walk(val)
+        }
+      }
+    }
+  }
+
+  walk(obj)
+
+  // Prefer FLV (lower latency) over HLS
+  if (flvUrls.length > 0) return flvUrls[0] as string
+  if (m3u8Urls.length > 0) return m3u8Urls[0] as string
+  return null
+}

package/src/io/tiktok/webcast.ts

@@ -0,0 +1,162 @@
+import type { RoomRef, StreamRef } from "../../core/verdict"
+import type { HttpClient } from "../http"
+import { findStreamUrlRecursively } from "./parse"
+
+const WEBCAST_BASE = "https://webcast.tiktok.com"
+
+/**
+ * Discriminated room/info result: refusals (notably status_code 4003110)
+ * and transport failures surface as `{ ok: false }` instead of null.
+ * `statusCode: 0` means the request threw before a status was read.
+ */
+export type RoomApiResult<T> =
+  | { ok: true; value: T | null }
+  | { ok: false; statusCode: number; body: string }
+
+/** Authoritative room/info facts: the room plus its stream URL when present. */
+export interface RoomFacts {
+  readonly room: RoomRef
+  readonly stream: StreamRef | null
+}
+
+/** What discovery sources consume. `createWebcastApi` is the only implementation. */
+export interface WebcastReader {
+  fetchFromRoomApi: <T>(
+    roomId: string,
+    extract: (data: Record<string, unknown>) => T | null,
+  ) => Promise<RoomApiResult<T>>
+  fetchCheckAlive: (roomId: string) => Promise<boolean>
+  fetchStreamUrlFromApi: (roomId: string) => Promise<RoomApiResult<string>>
+  /** room/info as domain facts; 4003110 comes back as `{ ok: false }`. */
+  roomInfo: (roomId: string) => Promise<RoomApiResult<RoomFacts>>
+  /** Resolve a 4003110 refusal: alive → restricted candidate, else offline. */
+  refusedRoom: (roomId: string, title: string | null) => Promise<RoomRef>
+}
+
+export function createWebcastApi(
+  http: HttpClient,
+  debug: (msg: string) => void,
+  signal?: AbortSignal,
+): WebcastReader {
+  /**
+   * Shared boilerplate for Webcast room/info API calls.
+   * Handles URL construction, HTTP GET, JSON parsing, and error handling.
+   * Room-gate refusals (status_code 4003110) are reported to the caller
+   * instead of being collapsed into null; callers map failures.
+   * The caller provides an extractor for the response data.
+   */
+  async function fetchFromRoomApi<T>(
+    roomId: string,
+    extract: (data: Record<string, unknown>) => T | null,
+  ): Promise<RoomApiResult<T>> {
+    try {
+      const url = `${WEBCAST_BASE}/webcast/room/info/?aid=1988&room_id=${roomId}&type=live`
+      const res = await http.get(url, signal)
+      debug(`fetchFromRoomApi: roomId=${roomId} status=${res.status}, ok=${res.ok}`)
+      if (!res.ok) return { ok: false, statusCode: res.status, body: "" }
+
+      const text = await res.text()
+      debug(`fetchFromRoomApi: roomId=${roomId} returned ${text.length} bytes`)
+      if (text.length === 0) return { ok: true, value: null }
+
+      const data = JSON.parse(text) as Record<string, unknown>
+
+      // status_code 4003110 = age-protected/restricted room: report it
+      if ((data as { status_code?: unknown }).status_code === 4003110) {
+        return { ok: false, statusCode: 4003110, body: text }
+      }
+
+      return { ok: true, value: extract(data) }
+    } catch {
+      // statusCode 0 = transport/parse failure before a status was available.
+      return { ok: false, statusCode: 0, body: "" }
+    }
+  }
+
+  /**
+   * Check if a room is currently alive using the lightweight
+   * /webcast/room/check_alive/ endpoint.
+   *
+   * This is faster and cheaper than fetching the full room/info response.
+   * Returns `true` if the room is live, `false` otherwise (including errors).
+   *
+   * Endpoint: /webcast/room/check_alive/?aid=1988&region=CH&room_ids={id}&user_is_login=true
+   * Response: { "data": [{ "alive": true/false, "room_id": "..." }] }
+   */
+  async function fetchCheckAlive(roomId: string): Promise<boolean> {
+    try {
+      const url = `${WEBCAST_BASE}/webcast/room/check_alive/?aid=1988&region=CH&room_ids=${roomId}&user_is_login=true`
+      const res = await http.get(url, signal)
+      debug(`fetchCheckAlive: roomId=${roomId} status=${res.status}, ok=${res.ok}`)
+      if (!res.ok) return false
+
+      const text = await res.text()
+      debug(`fetchCheckAlive: roomId=${roomId} returned ${text.length} bytes`)
+      if (text.length === 0) return false
+
+      const data = JSON.parse(text) as Record<string, unknown>
+      const items = data?.data as Array<Record<string, unknown>> | undefined
+      const alive = items?.[0]?.alive === true
+      debug(`fetchCheckAlive: roomId=${roomId} alive=${alive}`)
+      return alive
+    } catch (err) {
+      debug(
+        `fetchCheckAlive: roomId=${roomId} error — ${err instanceof Error ? err.message : String(err)}`,
+      )
+      return false
+    }
+  }
+
+  /**
+   * Resolve a 4003110 room-gate refusal via check_alive: the room is live
+   * (restricted) when alive, offline otherwise. Single home for this mapping.
+   */
+  async function refusedRoom(roomId: string, title: string | null): Promise<RoomRef> {
+    debug(`refusedRoom: room/info refused roomId=${roomId} (status_code 4003110)`)
+    const live = await fetchCheckAlive(roomId)
+    return { id: roomId, title, live }
+  }
+
+  /**
+   * Fetch room/info as domain facts. Requires a known roomId. A 4003110
+   * refusal stays `{ ok: false, statusCode: 4003110 }` for the caller to map
+   * via `refusedRoom`.
+   */
+  async function roomInfo(roomId: string): Promise<RoomApiResult<RoomFacts>> {
+    const res = await fetchFromRoomApi<Record<string, unknown>>(
+      roomId,
+      (data) => (data as { data?: Record<string, unknown> }).data ?? null,
+    )
+    if (!res.ok) return res
+    const roomData = res.value
+    if (!roomData) return { ok: true, value: null }
+
+    const title = (roomData.title as string | undefined) ?? null
+    const streamUrl = findStreamUrlRecursively(roomData)
+    return {
+      ok: true,
+      value: {
+        room: { id: roomId, title, live: (roomData.status ?? 4) === 2 },
+        stream: streamUrl ? { url: streamUrl } : null,
+      },
+    }
+  }
+
+  /**
+   * Fetch stream URL from the Webcast API.
+   * Covers cases where SIGI_STATE doesn't include stream data.
+   * Refusals (4003110) and transport failures are reported so callers
+   * can distinguish restricted rooms from missing URLs.
+   */
+  async function fetchStreamUrlFromApi(roomId: string): Promise<RoomApiResult<string>> {
+    return fetchFromRoomApi(roomId, (data) => findStreamUrlRecursively(data))
+  }
+
+  return {
+    fetchFromRoomApi,
+    fetchCheckAlive,
+    fetchStreamUrlFromApi,
+    roomInfo,
+    refusedRoom,
+  }
+}

package/dist/bin.d.mts

@@ -1 +0,0 @@
-export { };

package/dist/bin.mjs

@@ -1,215 +0,0 @@
-#!/usr/bin/env bun
-import { TikTokError } from "./lib/config.mjs";
-import { bytesToHuman, relativeTime } from "./lib/utils.mjs";
-import { createRecorder } from "./core/recorder/index.mjs";
-import "./index.mjs";
-import { extractTikTokCookiesFromFirefox } from "./lib/browser-cookies.mjs";
-import { parseArgs } from "./lib/cli.mjs";
-import { tmuxStart, tmuxStatus, tmuxStop } from "./lib/tmux.mjs";
-import { createDisplay } from "./lib/ui.mjs";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { color } from "@zfadhli/koko-cli";
-//#region src/bin.ts
-/**
-* Entry point — parses CLI args, creates the recorder, and handles signals.
-* Uses the terminal Display manager for beautiful console output.
-*/
-async function loadCookies(cookiesPath) {
-	const path = cookiesPath ?? join(process.cwd(), "cookies.json");
-	if (!existsSync(path)) return;
-	try {
-		const content = readFileSync(path, "utf-8");
-		const data = JSON.parse(content);
-		if (data.sessionid_ss && data.sessionid_ss.length > 0) return data;
-		return;
-	} catch {
-		return;
-	}
-}
-async function main() {
-	let result;
-	try {
-		result = parseArgs();
-	} catch (err) {
-		if (err instanceof TikTokError && err.kind === "config-error") {
-			console.error(`${color.red("Error:")} ${err.message}`);
-			process.exit(1);
-		}
-		throw err;
-	}
-	if (result.command === "start") {
-		const userMatch = result.args.find((_, i, a) => a[i - 1] === "--user" || a[i - 1] === "-u");
-		if (!userMatch) {
-			console.error(`${color.red("Error:")} --user is required for "start" command`);
-			process.exit(1);
-		}
-		const cmd = `tokrec ${result.args.join(" ")}`;
-		try {
-			await tmuxStart(userMatch, cmd);
-			console.log(`${color.green("✓")} Session "tokrec-${userMatch}" started in background`);
-			console.log(`  tmux attach -t tokrec-${userMatch}   — view live output`);
-			console.log(`  tokrec stop -u ${userMatch}             — stop recording`);
-		} catch (err) {
-			console.error(`${color.red("Error:")} ${err instanceof Error ? err.message : String(err)}`);
-			process.exit(1);
-		}
-		return;
-	}
-	if (result.command === "stop") {
-		try {
-			await tmuxStop(result.user);
-			if (result.user) console.log(`${color.green("✓")} Session "tokrec-${result.user}" stopped`);
-			else console.log(`${color.green("✓")} All tokrec sessions stopped`);
-		} catch (err) {
-			console.error(`${color.red("Error:")} ${err instanceof Error ? err.message : String(err)}`);
-			process.exit(1);
-		}
-		return;
-	}
-	if (result.command === "status") {
-		const sessions = await tmuxStatus(result.user);
-		if (sessions.length === 0) console.log(`${color.gray("○")} No active session${result.user ? ` for "${result.user}"` : ""}`);
-		else for (const s of sessions) {
-			console.log(`${color.green("●")} tokrec-${s.user}`);
-			console.log(`  tmux attach -t ${s.session}   — view live output`);
-		}
-		return;
-	}
-	if (result.command === "setup") {
-		const firefoxCookies = extractTikTokCookiesFromFirefox();
-		if (firefoxCookies) {
-			const names = Object.keys(firefoxCookies);
-			const detail = names.length > 1 ? ` (${names.length} cookies)` : "";
-			console.log(`${color.green("✓")} Firefox cookies detected${detail}`);
-			console.log(`  No setup needed — tokrec auto-detects Firefox cookies.`);
-			return;
-		}
-		const cookiesPath = join(process.cwd(), "cookies.json");
-		if (existsSync(cookiesPath)) try {
-			if (JSON.parse(readFileSync(cookiesPath, "utf-8")).sessionid_ss) {
-				console.log(`${color.green("✓")} cookies.json found at ./cookies.json`);
-				return;
-			}
-		} catch {}
-		console.log(`${color.yellow("⚠")} No TikTok cookies found.`);
-		console.log();
-		console.log(`You need a valid sessionid_ss cookie to bypass TikTok's WAF.`);
-		console.log(`Either log in to TikTok in Firefox (auto-detected), or enter manually:`);
-		console.log();
-		const sessionid = prompt("  sessionid_ss cookie value:");
-		if (!sessionid || sessionid.trim().length === 0) {
-			console.log(`${color.red("✗")} No cookie provided. Setup cancelled.`);
-			return;
-		}
-		const cookies = { sessionid_ss: sessionid.trim() };
-		const idc = prompt("  tt-target-idc (optional, press Enter to skip):");
-		if (idc && idc.trim().length > 0) cookies["tt-target-idc"] = idc.trim();
-		writeFileSync(cookiesPath, `${JSON.stringify(cookies, null, 2)}\n`);
-		console.log();
-		console.log(`${color.green("✓")} cookies.json created at ./cookies.json`);
-		console.log(`  You can now run: tokrec -u <username>`);
-		return;
-	}
-	const config = result.config;
-	const firefoxCookies = extractTikTokCookiesFromFirefox();
-	config.cookies = firefoxCookies ?? await loadCookies(config.cookiesPath);
-	config.logConsole = false;
-	const display = createDisplay();
-	if (config.cookies) {
-		const source = firefoxCookies ? "Firefox" : "cookies.json";
-		const names = Object.keys(config.cookies);
-		const detail = names.length > 1 ? ` (${names.length} cookies)` : "";
-		display.showInfo(`${source} cookies loaded${detail}`);
-	} else display.showWarning("No TikTok cookies found — log in at tiktok.com in Firefox or create cookies.json");
-	const recorder = createRecorder(config);
-	let lastWasLive = null;
-	let firstOfflineTime = 0;
-	recorder.on("checking", (info) => {
-		display.checkingUser(info.user);
-	});
-	recorder.on("tick", (info) => {
-		if (info.isLive) display.userLive(info.user, info.roomId ?? "?");
-		else if (lastWasLive === null || lastWasLive === true) {
-			display.userOffline(info.user);
-			firstOfflineTime = Date.now();
-		} else {
-			const elapsed = Date.now() - firstOfflineTime;
-			display.userOfflineRepeat(info.user, relativeTime(elapsed));
-		}
-		lastWasLive = info.isLive;
-	});
-	recorder.on("recording:start", () => {
-		display.startRecording();
-	});
-	recorder.on("download:end", (info) => {
-		const parsed = info.file.split("/").pop() ?? info.file;
-		const sizeStr = bytesToHuman(info.size);
-		display.finishRecording(parsed, info.duration, sizeStr);
-	});
-	recorder.on("segmenting:start", () => {
-		display.startSegmenting();
-	});
-	recorder.on("segmenting:end", (info) => {
-		display.segmentsCreated(info.segments);
-	});
-	recorder.on("converting:start", () => {
-		display.startConverting();
-	});
-	recorder.on("converted", (info) => {
-		const parsed = info.output.split("/").pop() ?? info.output;
-		display.conversionDone(parsed);
-	});
-	recorder.on("recording:end", () => {});
-	recorder.on("error", (err) => {
-		display.showError(`[${err.kind}] ${err.message}`);
-	});
-	recorder.on("normalize:start", () => {
-		display.normalizeStart();
-	});
-	recorder.on("normalize:progress", (info) => {
-		display.normalizeProgress(info.percent, info.phase);
-	});
-	recorder.on("normalize:end", () => {
-		display.normalizeComplete();
-	});
-	recorder.on("normalize:error", (info) => {
-		display.normalizeError(info.error);
-	});
-	let stopping = false;
-	const handleSignal = async () => {
-		if (stopping) return;
-		stopping = true;
-		process.off("SIGINT", handleSignal);
-		process.off("SIGTERM", handleSignal);
-		process.off("SIGHUP", handleSignal);
-		display.showInfo("Shutting down gracefully...");
-		await recorder.stop();
-		display.stop();
-		process.exit(0);
-	};
-	process.on("SIGINT", handleSignal);
-	process.on("SIGTERM", handleSignal);
-	process.on("SIGHUP", handleSignal);
-	display.pollingStarted(config.interval ?? 3);
-	try {
-		await recorder.start();
-	} catch (err) {
-		if (err instanceof TikTokError) display.showError(`[${err.kind}] ${err.message}`);
-		else display.showError(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`);
-		process.off("SIGINT", handleSignal);
-		process.off("SIGTERM", handleSignal);
-		process.off("SIGHUP", handleSignal);
-		await recorder.stop();
-		display.stop();
-		process.exit(1);
-	}
-}
-main().catch((err) => {
-	console.error("Fatal:", err instanceof Error ? err.message : String(err));
-	process.exit(1);
-});
-//#endregion
-export {};
-
-//# sourceMappingURL=bin.mjs.map

package/dist/bin.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"bin.mjs","names":[],"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env bun\n/**\n * Entry point — parses CLI args, creates the recorder, and handles signals.\n * Uses the terminal Display manager for beautiful console output.\n */\n\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\"\nimport { join } from \"node:path\"\nimport { color } from \"@zfadhli/koko-cli\"\nimport { createRecorder } from \"./index\"\nimport { extractTikTokCookiesFromFirefox } from \"./lib/browser-cookies\"\nimport { type CLIResult, parseArgs } from \"./lib/cli\"\nimport type { RecorderConfig } from \"./lib/config\"\nimport { TikTokError } from \"./lib/config\"\nimport { tmuxStart, tmuxStatus, tmuxStop } from \"./lib/tmux\"\nimport { createDisplay } from \"./lib/ui\"\nimport { bytesToHuman, relativeTime } from \"./lib/utils\"\n\nasync function loadCookies(cookiesPath?: string): Promise<Record<string, string> | undefined> {\n  const path = cookiesPath ?? join(process.cwd(), \"cookies.json\")\n  if (!existsSync(path)) {\n    return undefined\n  }\n  try {\n    const content = readFileSync(path, \"utf-8\")\n    const data = JSON.parse(content) as Record<string, string | undefined>\n    if (data.sessionid_ss && data.sessionid_ss.length > 0) {\n      return data as Record<string, string>\n    }\n    return undefined\n  } catch {\n    return undefined\n  }\n}\n\nasync function main(): Promise<void> {\n  let result: CLIResult\n\n  try {\n    result = parseArgs()\n  } catch (err) {\n    if (err instanceof TikTokError && err.kind === \"config-error\") {\n      console.error(`${color.red(\"Error:\")} ${err.message}`)\n      process.exit(1)\n    }\n    throw err\n  }\n\n  // Handle tmux subcommands\n  if (result.command === \"start\") {\n    // Extract user from args to build session name\n    const userMatch = result.args.find((_, i, a) => a[i - 1] === \"--user\" || a[i - 1] === \"-u\")\n    if (!userMatch) {\n      console.error(`${color.red(\"Error:\")} --user is required for \"start\" command`)\n      process.exit(1)\n    }\n    const cmd = `tokrec ${result.args.join(\" \")}`\n    try {\n      await tmuxStart(userMatch, cmd)\n      console.log(`${color.green(\"✓\")} Session \"tokrec-${userMatch}\" started in background`)\n      console.log(`  tmux attach -t tokrec-${userMatch}   — view live output`)\n      console.log(`  tokrec stop -u ${userMatch}             — stop recording`)\n    } catch (err) {\n      console.error(`${color.red(\"Error:\")} ${err instanceof Error ? err.message : String(err)}`)\n      process.exit(1)\n    }\n    return\n  }\n\n  if (result.command === \"stop\") {\n    try {\n      await tmuxStop(result.user)\n      if (result.user) {\n        console.log(`${color.green(\"✓\")} Session \"tokrec-${result.user}\" stopped`)\n      } else {\n        console.log(`${color.green(\"✓\")} All tokrec sessions stopped`)\n      }\n    } catch (err) {\n      console.error(`${color.red(\"Error:\")} ${err instanceof Error ? err.message : String(err)}`)\n      process.exit(1)\n    }\n    return\n  }\n\n  if (result.command === \"status\") {\n    const sessions = await tmuxStatus(result.user)\n    if (sessions.length === 0) {\n      console.log(\n        `${color.gray(\"○\")} No active session${result.user ? ` for \"${result.user}\"` : \"\"}`,\n      )\n    } else {\n      for (const s of sessions) {\n        console.log(`${color.green(\"●\")} tokrec-${s.user}`)\n        console.log(`  tmux attach -t ${s.session}   — view live output`)\n      }\n    }\n    return\n  }\n\n  if (result.command === \"setup\") {\n    // 1. Check Firefox cookies\n    const firefoxCookies = extractTikTokCookiesFromFirefox()\n    if (firefoxCookies) {\n      const names = Object.keys(firefoxCookies)\n      const detail = names.length > 1 ? ` (${names.length} cookies)` : \"\"\n      console.log(`${color.green(\"✓\")} Firefox cookies detected${detail}`)\n      console.log(`  No setup needed — tokrec auto-detects Firefox cookies.`)\n      return\n    }\n\n    // 2. Check cookies.json\n    const cookiesPath = join(process.cwd(), \"cookies.json\")\n    if (existsSync(cookiesPath)) {\n      try {\n        const data = JSON.parse(readFileSync(cookiesPath, \"utf-8\"))\n        if (data.sessionid_ss) {\n          console.log(`${color.green(\"✓\")} cookies.json found at ./cookies.json`)\n          return\n        }\n      } catch {\n        // invalid JSON, fall through to setup\n      }\n    }\n\n    // 3. No cookies found — interactive setup\n    console.log(`${color.yellow(\"⚠\")} No TikTok cookies found.`)\n    console.log()\n    console.log(`You need a valid sessionid_ss cookie to bypass TikTok's WAF.`)\n    console.log(`Either log in to TikTok in Firefox (auto-detected), or enter manually:`)\n    console.log()\n\n    const sessionid = prompt(\"  sessionid_ss cookie value:\")\n    if (!sessionid || sessionid.trim().length === 0) {\n      console.log(`${color.red(\"✗\")} No cookie provided. Setup cancelled.`)\n      return\n    }\n\n    const cookies: Record<string, string> = { sessionid_ss: sessionid.trim() }\n\n    const idc = prompt(\"  tt-target-idc (optional, press Enter to skip):\")\n    if (idc && idc.trim().length > 0) {\n      cookies[\"tt-target-idc\"] = idc.trim()\n    }\n\n    writeFileSync(cookiesPath, `${JSON.stringify(cookies, null, 2)}\\n`)\n    console.log()\n    console.log(`${color.green(\"✓\")} cookies.json created at ./cookies.json`)\n    console.log(`  You can now run: tokrec -u <username>`)\n    return\n  }\n\n  // Record command — full recorder flow\n  const config: RecorderConfig = result.config\n\n  // Load cookies: try Firefox browser first, then fall back to cookies.json\n  const firefoxCookies = extractTikTokCookiesFromFirefox()\n  config.cookies = firefoxCookies ?? (await loadCookies(config.cookiesPath))\n\n  // Suppress internal logger's console output — the Display owns the terminal\n  config.logConsole = false\n\n  // Beautiful terminal display\n  const display = createDisplay()\n\n  if (config.cookies) {\n    const source = firefoxCookies ? \"Firefox\" : \"cookies.json\"\n    const names = Object.keys(config.cookies)\n    const detail = names.length > 1 ? ` (${names.length} cookies)` : \"\"\n    display.showInfo(`${source} cookies loaded${detail}`)\n  } else {\n    display.showWarning(\n      \"No TikTok cookies found — log in at tiktok.com in Firefox or create cookies.json\",\n    )\n  }\n\n  const recorder = createRecorder(config)\n\n  let lastWasLive: boolean | null = null\n  let firstOfflineTime = 0\n\n  // Subscribe to events for beautiful console output\n  recorder.on(\"checking\", (info) => {\n    display.checkingUser(info.user)\n  })\n\n  recorder.on(\"tick\", (info) => {\n    if (info.isLive) {\n      display.userLive(info.user, info.roomId ?? \"?\")\n    } else if (lastWasLive === null || lastWasLive === true) {\n      display.userOffline(info.user)\n      firstOfflineTime = Date.now()\n    } else {\n      const elapsed = Date.now() - firstOfflineTime\n      display.userOfflineRepeat(info.user, relativeTime(elapsed))\n    }\n    lastWasLive = info.isLive\n  })\n\n  recorder.on(\"recording:start\", () => {\n    display.startRecording()\n  })\n\n  recorder.on(\"download:end\", (info) => {\n    const parsed = info.file.split(\"/\").pop() ?? info.file\n    const sizeStr = bytesToHuman(info.size)\n    display.finishRecording(parsed, info.duration, sizeStr)\n  })\n\n  recorder.on(\"segmenting:start\", () => {\n    display.startSegmenting()\n  })\n\n  recorder.on(\"segmenting:end\", (info) => {\n    display.segmentsCreated(info.segments)\n  })\n\n  recorder.on(\"converting:start\", () => {\n    display.startConverting()\n  })\n\n  recorder.on(\"converted\", (info) => {\n    const parsed = info.output.split(\"/\").pop() ?? info.output\n    display.conversionDone(parsed)\n  })\n\n  recorder.on(\"recording:end\", () => {\n    // For simple conversion (no segmenting), recording:end fires once.\n    // For segmenting path, segmenting:end already acknowledges the result.\n    // This is a no-op since we handle the terminal output through download:end\n    // and segmenting:end / converted events.\n  })\n\n  recorder.on(\"error\", (err) => {\n    display.showError(`[${err.kind}] ${err.message}`)\n  })\n\n  recorder.on(\"normalize:start\", () => {\n    display.normalizeStart()\n  })\n\n  recorder.on(\"normalize:progress\", (info) => {\n    display.normalizeProgress(info.percent, info.phase)\n  })\n\n  recorder.on(\"normalize:end\", () => {\n    display.normalizeComplete()\n  })\n\n  recorder.on(\"normalize:error\", (info) => {\n    display.normalizeError(info.error)\n  })\n\n  // Signal handling\n  let stopping = false\n  const handleSignal = async () => {\n    if (stopping) return // ignore duplicate signals (e.g. SIGINT + SIGTERM from one Ctrl-C)\n    stopping = true\n    // Remove signal handlers so they don't accumulate if main() is called again\n    process.off(\"SIGINT\", handleSignal)\n    process.off(\"SIGTERM\", handleSignal)\n    process.off(\"SIGHUP\", handleSignal)\n    display.showInfo(\"Shutting down gracefully...\")\n    await recorder.stop()\n    display.stop()\n    process.exit(0)\n  }\n\n  process.on(\"SIGINT\", handleSignal)\n  process.on(\"SIGTERM\", handleSignal)\n  process.on(\"SIGHUP\", handleSignal)\n\n  // Show initial status and start the recorder\n  display.pollingStarted(config.interval ?? 3)\n  try {\n    await recorder.start()\n  } catch (err) {\n    if (err instanceof TikTokError) {\n      display.showError(`[${err.kind}] ${err.message}`)\n    } else {\n      display.showError(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`)\n    }\n    process.off(\"SIGINT\", handleSignal)\n    process.off(\"SIGTERM\", handleSignal)\n    process.off(\"SIGHUP\", handleSignal)\n    await recorder.stop()\n    display.stop()\n    process.exit(1)\n  }\n}\n\nmain().catch((err) => {\n  console.error(\"Fatal:\", err instanceof Error ? err.message : String(err))\n  process.exit(1)\n})\n"],"mappings":"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"}

package/dist/core/api/client.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.mjs","names":[],"sources":["../../../src/core/api/client.ts"],"sourcesContent":["/**\n * HTTP client — thin wrapper around wreq-js createSession.\n * Provides TLS fingerprint impersonation, cookie jar, proxy support,\n * and configurable rate limiting to prevent WAF triggering.\n */\n\nimport { createSession, type Session } from \"wreq-js\"\nimport type { RecorderConfig } from \"../../lib/config\"\nimport { createRateLimiter } from \"./rate-limiter\"\n\n// BodyInit is only available inside declare module \"bun\" in bun-types, not as a global\n// under the ES2022 lib. We explicitly import it to keep lib focused on ES2022.\ntype _BodyInit = import(\"bun\").BodyInit\n\nexport interface HttpClient {\n  get: (url: string) => Promise<Response>\n  post: (url: string, body?: _BodyInit, headers?: Record<string, string>) => Promise<Response>\n  close: () => Promise<void>\n}\n\nconst REQUEST_TIMEOUT_MS = 15_000\n\n/** Standard browser headers to avoid TikTok WAF detection. */\nconst BROWSER_HEADERS: Record<string, string> = {\n  \"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:149.0) Gecko/20100101 Firefox/149.0\",\n  Accept: \"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8\",\n  \"Accept-Language\": \"en-US,en;q=0.5\",\n  \"Accept-Encoding\": \"gzip, deflate, br\",\n  \"Upgrade-Insecure-Requests\": \"1\",\n  \"Sec-Fetch-Dest\": \"document\",\n  \"Sec-Fetch-Mode\": \"navigate\",\n  \"Sec-Fetch-Site\": \"none\",\n  \"Sec-Fetch-User\": \"?1\",\n}\n\nexport async function createHttpClient(config: RecorderConfig): Promise<HttpClient> {\n  const session: Session = await createSession({\n    browser: \"firefox_149\",\n    os: \"windows\",\n    proxy: config.proxy,\n  })\n\n  // Seed cookies into the session jar so all subsequent requests are authenticated.\n  // NOTE: Using a Cookie header does NOT populate wreq-js's cookie jar —\n  // we must use session.setCookie() instead.\n  // Seed for all TikTok domains since cookies may not propagate across\n  // subdomains automatically in wreq-js's cookie jar.\n  if (config.cookies && \"sessionid_ss\" in config.cookies) {\n    const domains = [\"https://www.tiktok.com\", \"https://webcast.tiktok.com\", \"https://m.tiktok.com\"]\n    for (const domain of domains) {\n      for (const [name, value] of Object.entries(config.cookies)) {\n        session.setCookie(name, value, domain)\n      }\n    }\n  }\n\n  const rateLimiter = createRateLimiter(config.ratePerSecond ?? 5)\n\n  async function rateLimitedFetch(\n    url: string,\n    options?: { method?: string; body?: unknown; headers?: Record<string, string> },\n  ): Promise<Response> {\n    const controller = new AbortController()\n    const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS)\n    try {\n      await rateLimiter.acquire(controller.signal)\n      const res = await session.fetch(url, {\n        method: options?.method,\n        body: options?.body as never,\n        headers: {\n          ...BROWSER_HEADERS,\n          ...options?.headers,\n        },\n        signal: controller.signal,\n      })\n      return res as unknown as Response\n    } finally {\n      clearTimeout(timeout)\n    }\n  }\n\n  return {\n    get: async (url: string) => rateLimitedFetch(url),\n    post: async (url: string, body?: _BodyInit, headers?: Record<string, string>) =>\n      rateLimitedFetch(url, {\n        method: \"POST\",\n        body: body as never,\n        headers: {\n          \"Content-Type\": \"application/x-www-form-urlencoded; charset=UTF-8\",\n          ...headers,\n        },\n      }),\n    close: async () => {\n      await session.close()\n    },\n  }\n}\n"],"mappings":";;;;;;;;AAoBA,MAAM,qBAAqB;;AAG3B,MAAM,kBAA0C;CAC9C,cAAc;CACd,QAAQ;CACR,mBAAmB;CACnB,mBAAmB;CACnB,6BAA6B;CAC7B,kBAAkB;CAClB,kBAAkB;CAClB,kBAAkB;CAClB,kBAAkB;AACpB;AAEA,eAAsB,iBAAiB,QAA6C;CAClF,MAAM,UAAmB,MAAM,cAAc;EAC3C,SAAS;EACT,IAAI;EACJ,OAAO,OAAO;CAChB,CAAC;CAOD,IAAI,OAAO,WAAW,kBAAkB,OAAO,SAE7C,KAAK,MAAM,UAAU;EADJ;EAA0B;EAA8B;CAC9C,GACzB,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,OAAO,OAAO,GACvD,QAAQ,UAAU,MAAM,OAAO,MAAM;CAK3C,MAAM,cAAc,kBAAkB,OAAO,iBAAiB,CAAC;CAE/D,eAAe,iBACb,KACA,SACmB;EACnB,MAAM,aAAa,IAAI,gBAAgB;EACvC,MAAM,UAAU,iBAAiB,WAAW,MAAM,GAAG,kBAAkB;EACvE,IAAI;GACF,MAAM,YAAY,QAAQ,WAAW,MAAM;GAU3C,OAAO,MATW,QAAQ,MAAM,KAAK;IACnC,QAAQ,SAAS;IACjB,MAAM,SAAS;IACf,SAAS;KACP,GAAG;KACH,GAAG,SAAS;IACd;IACA,QAAQ,WAAW;GACrB,CAAC;EAEH,UAAU;GACR,aAAa,OAAO;EACtB;CACF;CAEA,OAAO;EACL,KAAK,OAAO,QAAgB,iBAAiB,GAAG;EAChD,MAAM,OAAO,KAAa,MAAkB,YAC1C,iBAAiB,KAAK;GACpB,QAAQ;GACF;GACN,SAAS;IACP,gBAAgB;IAChB,GAAG;GACL;EACF,CAAC;EACH,OAAO,YAAY;GACjB,MAAM,QAAQ,MAAM;EACtB;CACF;AACF"}

package/dist/core/api/rate-limiter.mjs

@@ -1,29 +0,0 @@
-//#region src/core/api/rate-limiter.ts
-/**
-* Create a token-bucket rate limiter.
-*
-* @param tokensPerSecond  Max sustained requests per second.
-*                         0 or negative = unlimited (no waiting).
-*/
-function createRateLimiter(tokensPerSecond) {
-	if (tokensPerSecond <= 0) return { acquire: async () => {} };
-	const MIN_INTERVAL_MS = 1e3 / tokensPerSecond;
-	let lastTokenTime = 0;
-	return { async acquire(signal) {
-		if (signal?.aborted) return;
-		const now = Date.now();
-		const waitTime = Math.max(0, lastTokenTime + MIN_INTERVAL_MS - now);
-		if (waitTime > 0) await new Promise((resolve) => {
-			const timer = setTimeout(resolve, waitTime);
-			if (signal) signal.addEventListener("abort", () => {
-				clearTimeout(timer);
-				resolve();
-			}, { once: true });
-		});
-		lastTokenTime = Date.now();
-	} };
-}
-//#endregion
-export { createRateLimiter };
-
-//# sourceMappingURL=rate-limiter.mjs.map

package/dist/core/api/rate-limiter.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"rate-limiter.mjs","names":[],"sources":["../../../src/core/api/rate-limiter.ts"],"sourcesContent":["/**\n * Token-bucket rate limiter — limits API request frequency to prevent\n * TikTok WAF triggering on rapid polling or URL refresh loops.\n *\n * Design:\n * - Token bucket with configurable refill rate (tokens/sec)\n * - AbortSignal-aware wait so cancellation works through the queue\n * - Thread-safe for cooperative JS concurrency (all awaiters share\n *   the same monotonically-increasing last-token timestamp)\n */\n\nexport interface RateLimiter {\n  /** Wait until a rate-limit token is available, then consume it. */\n  acquire(signal?: AbortSignal): Promise<void>\n}\n\n/**\n * Create a token-bucket rate limiter.\n *\n * @param tokensPerSecond  Max sustained requests per second.\n *                         0 or negative = unlimited (no waiting).\n */\nexport function createRateLimiter(tokensPerSecond: number): RateLimiter {\n  // Unlimited mode — no-op acquire\n  if (tokensPerSecond <= 0) {\n    return { acquire: async () => {} }\n  }\n\n  const MIN_INTERVAL_MS = 1000 / tokensPerSecond\n  let lastTokenTime = 0\n\n  return {\n    async acquire(signal?: AbortSignal): Promise<void> {\n      if (signal?.aborted) return\n\n      const now = Date.now()\n      const waitTime = Math.max(0, lastTokenTime + MIN_INTERVAL_MS - now)\n\n      if (waitTime > 0) {\n        await new Promise<void>((resolve) => {\n          const timer = setTimeout(resolve, waitTime)\n          if (signal) {\n            signal.addEventListener(\n              \"abort\",\n              () => {\n                clearTimeout(timer)\n                resolve()\n              },\n              { once: true },\n            )\n          }\n        })\n      }\n\n      lastTokenTime = Date.now()\n    },\n  }\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,kBAAkB,iBAAsC;CAEtE,IAAI,mBAAmB,GACrB,OAAO,EAAE,SAAS,YAAY,CAAC,EAAE;CAGnC,MAAM,kBAAkB,MAAO;CAC/B,IAAI,gBAAgB;CAEpB,OAAO,EACL,MAAM,QAAQ,QAAqC;EACjD,IAAI,QAAQ,SAAS;EAErB,MAAM,MAAM,KAAK,IAAI;EACrB,MAAM,WAAW,KAAK,IAAI,GAAG,gBAAgB,kBAAkB,GAAG;EAElE,IAAI,WAAW,GACb,MAAM,IAAI,SAAe,YAAY;GACnC,MAAM,QAAQ,WAAW,SAAS,QAAQ;GAC1C,IAAI,QACF,OAAO,iBACL,eACM;IACJ,aAAa,KAAK;IAClB,QAAQ;GACV,GACA,EAAE,MAAM,KAAK,CACf;EAEJ,CAAC;EAGH,gBAAgB,KAAK,IAAI;CAC3B,EACF;AACF"}