@zfadhli/tokrec 0.13.0 → 0.15.0

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"}

package/dist/core/api/tiktok.mjs

@@ -1,394 +0,0 @@
-//#region src/core/api/tiktok.ts
-const TIKTOK_BASES = ["https://www.tiktok.com", "https://m.tiktok.com"];
-const WEBCAST_BASE = "https://webcast.tiktok.com";
-function createTikTokApi(http, logger, showDebug) {
-	const debug = (msg) => {
-		logger?.debug(msg);
-		if (showDebug) process.stderr.write(`[API_DEBUG] ${msg}\n`);
-	};
-	let cached = null;
-	let cachedUser = "";
-	async function ensureCache(user) {
-		if (cached && cachedUser === user) return cached;
-		cached = await fetchLiveInfo(user);
-		cachedUser = user;
-		return cached;
-	}
-	function invalidateCache() {
-		cached = null;
-		cachedUser = "";
-	}
-	return {
-		invalidateCache,
-		async getRoomId(user) {
-			return (await ensureCache(user))?.roomId ?? null;
-		},
-		async isRoomAlive(roomId) {
-			if (cached && String(cached.roomId) === String(roomId)) return cached.isLive;
-			return fetchCheckAlive(roomId);
-		},
-		async getLiveUrl(roomId) {
-			return (await ensureCache(cachedUser || roomId))?.streamUrl ?? null;
-		}
-	};
-	/**
-	* Try to fetch a TikTok user page from multiple domains.
-	* www.tiktok.com is increasingly blocked by Slardar WAF; m.tiktok.com
-	* often has different bot protection and may succeed.
-	* Returns the HTML and the base URL that worked, or null if all fail.
-	*/
-	async function tryFetchPage(user, path) {
-		for (const base of TIKTOK_BASES) {
-			const url = `${base}/@${user}${path}`;
-			const res = await http.get(url);
-			debug(`tryFetchPage: ${url} status=${res.status}, ok=${res.ok}`);
-			if (!res.ok) continue;
-			const html = await res.text();
-			if (html.length < 5e3 || html.includes("SlardarWAF")) {
-				debug(`tryFetchPage: ${url} WAF blocked (${html.length} bytes, slardar=${html.includes("SlardarWAF")})`);
-				continue;
-			}
-			debug(`tryFetchPage: ${url} succeeded (${html.length} bytes)`);
-			return {
-				html,
-				baseUrl: base
-			};
-		}
-		return null;
-	}
-	async function fetchLiveInfo(user) {
-		let sigi = null;
-		let html = "";
-		try {
-			const page = await tryFetchPage(user, "/live");
-			if (!page) {
-				debug("fetchLiveInfo: all domains blocked for /live page");
-				html = "";
-			} else {
-				html = page.html;
-				debug(`fetchLiveInfo: /live returned ${html.length} bytes (${page.baseUrl}), first 300: ${html.slice(0, 300).replace(/\n/g, "\\n")}`);
-				sigi = extractSigiState(html);
-				debug(`fetchLiveInfo: SIGI_STATE ${sigi ? "found" : "not found"}`);
-				if (sigi) {
-					const liveRoom = sigi.LiveRoom?.liveRoomUserInfo?.liveRoom;
-					const userInfo = sigi.LiveRoom?.liveRoomUserInfo?.user;
-					debug(`fetchLiveInfo: liveRoom=${!!liveRoom}, userInfo=${!!userInfo}, userInfo.roomId=${userInfo?.roomId ?? "null"}`);
-					if (liveRoom && userInfo?.roomId) {
-						const roomId = String(userInfo.roomId);
-						const isLive = liveRoom.status === 2;
-						debug(`fetchLiveInfo: primary path — roomId=${roomId}, status=${liveRoom.status}, isLive=${isLive}`);
-						let streamUrl = null;
-						if (isLive) {
-							streamUrl = extractStreamUrlFast(liveRoom);
-							if (!streamUrl) streamUrl = findStreamUrlRecursively(sigi);
-							if (!streamUrl) streamUrl = await fetchStreamUrlFromApi(roomId);
-						}
-						return {
-							roomId,
-							isLive,
-							streamUrl,
-							title: liveRoom.title ?? null
-						};
-					}
-					if (userInfo?.roomId) {
-						const roomId = String(userInfo.roomId);
-						debug(`fetchLiveInfo: userInfo fallback — roomId=${roomId}, querying Webcast API`);
-						const roomInfo = await fetchRoomInfoFromRoomApi(roomId);
-						debug(`fetchLiveInfo: Webcast API ${roomInfo ? "returned room info" : "returned null"}`);
-						if (roomInfo) return roomInfo;
-					}
-					debug("fetchLiveInfo: trying legacy fallback (UserModule)");
-					const legacy = await fetchLiveInfoFallback(sigi, user);
-					debug(`fetchLiveInfo: legacy fallback ${legacy ? "succeeded" : "returned null"}`);
-					if (legacy) return legacy;
-				}
-			}
-		} catch (_err) {
-			debug(`fetchLiveInfo: caught error — ${_err instanceof Error ? _err.message : String(_err)}`);
-			return null;
-		}
-		if (!html || html.length < 5e3) {
-			debug("fetchLiveInfo: trying API fallback (api-live/user/room)");
-			const apiResult = await fetchLiveInfoFromApi(user);
-			if (apiResult) return apiResult;
-		}
-		debug(`fetchLiveInfo: trying universal data fallback (html length ${html.length})`);
-		const { roomId } = extractUserFromUniversalData(html);
-		debug(`fetchLiveInfo: universal data roomId=${roomId ?? "null"}`);
-		if (roomId) {
-			const result = await fetchRoomInfoFromRoomApi(roomId);
-			debug(`fetchLiveInfo: universal data Webcast API ${result ? "succeeded" : "returned null"}`);
-			if (result) return result;
-		}
-		debug("fetchLiveInfo: trying profile page fallback");
-		const profileResult = await fetchLiveInfoFromProfile(user);
-		debug(`fetchLiveInfo: profile page ${profileResult ? "succeeded" : "returned null"}`);
-		return profileResult;
-	}
-	/**
-	* Fetch the main profile page to extract user info from
-	* __UNIVERSAL_DATA_FOR_REHYDRATION__. When the user is live, their
-	* roomId is embedded in the data, allowing us to fetch room info and
-	* stream URL via the /webcast/room/info/ endpoint (which works
-	* reliably). If no roomId is present the user is offline.
-	*/
-	async function fetchLiveInfoFromProfile(user) {
-		try {
-			const page = await tryFetchPage(user, "");
-			if (!page) {
-				debug("fetchLiveInfoFromProfile: all domains blocked for profile page");
-				return null;
-			}
-			debug(`fetchLiveInfoFromProfile: returned ${page.html.length} bytes (${page.baseUrl}), first 300: ${page.html.slice(0, 300).replace(/\n/g, "\\n")}`);
-			const { userId, roomId } = extractUserFromUniversalData(page.html);
-			if (!userId) return null;
-			if (roomId) return fetchRoomInfoFromRoomApi(roomId);
-			return null;
-		} catch {
-			return null;
-		}
-	}
-	/**
-	* Fetch live info from TikTok's internal API endpoint.
-	* This bypasses the Slardar WAF that blocks www.tiktok.com HTML pages.
-	*
-	* Endpoint: /api-live/user/room/?aid=1988&uniqueId=${user}&sourceType=54
-	* Returns the roomId, user status (2 = live), and other user metadata.
-	* When the user is live, also queries the Webcast API for a stream URL.
-	*/
-	async function fetchLiveInfoFromApi(user) {
-		try {
-			const url = `https://www.tiktok.com/api-live/user/room/?aid=1988&uniqueId=${encodeURIComponent(user)}&sourceType=54`;
-			const res = await http.get(url);
-			debug(`fetchLiveInfoFromApi: ${url} status=${res.status}`);
-			if (!res.ok) return null;
-			const text = await res.text();
-			debug(`fetchLiveInfoFromApi: returned ${text.length} bytes`);
-			if (text.length === 0) return null;
-			const userData = (JSON.parse(text)?.data)?.user;
-			if (!userData?.roomId) {
-				debug("fetchLiveInfoFromApi: no roomId in API response");
-				return null;
-			}
-			const roomId = String(userData.roomId);
-			const isLive = userData.status === 2;
-			debug(`fetchLiveInfoFromApi: roomId=${roomId}, status=${userData.status}, isLive=${isLive}`);
-			if (!isLive) return {
-				roomId,
-				isLive: false,
-				streamUrl: null,
-				title: null
-			};
-			return {
-				roomId,
-				isLive: true,
-				streamUrl: await fetchStreamUrlFromApi(roomId),
-				title: null
-			};
-		} catch {
-			return null;
-		}
-	}
-	/**
-	* Shared boilerplate for Webcast room/info API calls.
-	* Handles URL construction, HTTP GET, JSON parsing, status code checks,
-	* and error handling. The caller provides an extractor for the response data.
-	*/
-	async function fetchFromRoomApi(roomId, extract) {
-		try {
-			const url = `${WEBCAST_BASE}/webcast/room/info/?aid=1988&room_id=${roomId}&type=live`;
-			const res = await http.get(url);
-			debug(`fetchFromRoomApi: roomId=${roomId} status=${res.status}, ok=${res.ok}`);
-			if (!res.ok) return null;
-			const text = await res.text();
-			debug(`fetchFromRoomApi: roomId=${roomId} returned ${text.length} bytes`);
-			if (text.length === 0) return null;
-			const data = JSON.parse(text);
-			if (data.status_code === 4003110) return null;
-			return extract(data);
-		} catch {
-			return null;
-		}
-	}
-	/**
-	* 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) {
-		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);
-			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 alive = (JSON.parse(text)?.data)?.[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;
-		}
-	}
-	/**
-	* Fetch room info from the Webcast room/info API. Requires a known roomId.
-	*/
-	async function fetchRoomInfoFromRoomApi(roomId) {
-		return fetchFromRoomApi(roomId, (data) => {
-			const roomData = data.data;
-			if (!roomData) return null;
-			const isLive = (roomData.status ?? 4) === 2;
-			return {
-				roomId,
-				isLive,
-				streamUrl: isLive ? findStreamUrlRecursively(roomData) : null,
-				title: roomData.title ?? null
-			};
-		});
-	}
-	/**
-	* Secondary live-info extraction when SIGI_STATE's LiveRoom data is
-	* async-loaded.  Uses LiveRoom.liveRoomStatus for the live flag and
-	* UserModule.users[user].roomId for the room ID.  Stream URL is obtained
-	* from the Webcast API (room/info/) as a final fallback.
-	*/
-	async function fetchLiveInfoFallback(sigi, user) {
-		const isLive = sigi.LiveRoom?.liveRoomStatus === 2;
-		const userModule = sigi.UserModule?.users?.[user];
-		let roomId = null;
-		if (userModule?.roomId) roomId = typeof userModule.roomId === "object" ? String(userModule.roomId.id ?? "") : String(userModule.roomId);
-		if (roomId) {
-			const streamUrl = isLive ? await fetchStreamUrlFromApi(roomId) : null;
-			return {
-				roomId,
-				isLive,
-				streamUrl,
-				title: null
-			};
-		}
-		return null;
-	}
-	/**
-	* Fetch stream URL from the Webcast API.
-	* Covers cases where SIGI_STATE doesn't include stream data.
-	*/
-	async function fetchStreamUrlFromApi(roomId) {
-		return fetchFromRoomApi(roomId, (data) => findStreamUrlRecursively(data));
-	}
-}
-/**
-* @public Exported for testing.
-*/
-function extractSigiState(html) {
-	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]);
-	} 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.
-*/
-function extractUserFromUniversalData(html) {
-	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 user = ((data.__DEFAULT_SCOPE__ ?? data)?.["webapp.user-detail"])?.userInfo?.user;
-		return {
-			userId: user?.id ? String(user.id) : null,
-			roomId: user?.roomId ? String(user.roomId) : null
-		};
-	} catch {
-		return {
-			userId: null,
-			roomId: null
-		};
-	}
-}
-/**
-* 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.
-*/
-function extractStreamUrlFast(liveRoom) {
-	try {
-		const raw = liveRoom?.streamData?.pull_data?.stream_data;
-		if (!raw) return null;
-		const data = JSON.parse(raw)?.data;
-		if (!data) return null;
-		for (const q of [
-			"origin",
-			"fhd",
-			"uhd",
-			"hd",
-			"sd",
-			"ld"
-		]) {
-			const entry = data[q];
-			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).
-*/
-function findStreamUrlRecursively(obj) {
-	const flvUrls = [];
-	const m3u8Urls = [];
-	function walk(value) {
-		if (typeof value === "string") {
-			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;
-			}
-			if (value.startsWith("{") || value.startsWith("[")) try {
-				walk(JSON.parse(value));
-			} catch {}
-			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)) walk(val);
-	}
-	walk(obj);
-	if (flvUrls.length > 0) return flvUrls[0];
-	if (m3u8Urls.length > 0) return m3u8Urls[0];
-	return null;
-}
-//#endregion
-export { createTikTokApi };
-
-//# sourceMappingURL=tiktok.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tiktok.mjs","names":[],"sources":["../../../src/core/api/tiktok.ts"],"sourcesContent":["/**\n * TikTok API — resolves room IDs, live status, and stream URLs.\n *\n * Primary path: parse SIGI_STATE from the user's /live page (fast path for\n * older TikTok pages).  When SIGI_STATE is absent (TikTok's new unified page\n * structure), falls back to __UNIVERSAL_DATA_FOR_REHYDRATION__ on the profile\n * page to extract the room ID, then calls the Webcast room/info API for live\n * status and stream URL.\n *\n * Architecture:\n *   createTikTokApi(httpClient) → { getRoomId, isRoomAlive, getLiveUrl }\n *\n * All public methods share a per-tick cache so the page is fetched at most once\n * per poll cycle.\n *\n * Note: The room/enter Webcast endpoint has been deprecated due to frequent\n * 403 errors. All lookups go through room/info (reliable for live + offline).\n */\n\nimport type { Logger } from \"../../lib/logger\"\nimport type { HttpClient } from \"./client\"\n\nexport interface TikTokApi {\n  /** Resolve a username to a room ID. Returns null if not found. */\n  getRoomId(user: string): Promise<string | null>\n  /** Check if a room is currently live. */\n  isRoomAlive(roomId: string): Promise<boolean>\n  /** Get the best-quality FLV stream URL for a room. Returns null on failure. */\n  getLiveUrl(roomId: string): Promise<string | null>\n  /** Invalidate per-tick cache (call at start of each poll tick). */\n  invalidateCache(): void\n}\n\nconst TIKTOK_BASES = [\"https://www.tiktok.com\", \"https://m.tiktok.com\"]\nconst WEBCAST_BASE = \"https://webcast.tiktok.com\"\n\nexport function createTikTokApi(http: HttpClient, logger?: Logger, showDebug?: boolean): TikTokApi {\n  // Debug logging helper — writes to stderr only when --debug is passed.\n  const debug = (msg: string) => {\n    logger?.debug(msg)\n    if (showDebug) process.stderr.write(`[API_DEBUG] ${msg}\\n`)\n  }\n  let cached: LiveInfo | null = null\n  let cachedUser = \"\"\n\n  async function ensureCache(user: string): Promise<LiveInfo | null> {\n    if (cached && cachedUser === user) return cached\n    cached = await fetchLiveInfo(user)\n    cachedUser = user\n    return cached\n  }\n\n  function invalidateCache(): void {\n    cached = null\n    cachedUser = \"\"\n  }\n\n  return {\n    invalidateCache,\n\n    async getRoomId(user: string): Promise<string | null> {\n      const info = await ensureCache(user)\n      return info?.roomId ?? null\n    },\n\n    async isRoomAlive(roomId: string): Promise<boolean> {\n      if (cached && String(cached.roomId) === String(roomId)) {\n        return cached.isLive\n      }\n      // Use the lightweight check_alive endpoint instead of re-fetching\n      // the full room/info response.\n      return fetchCheckAlive(roomId)\n    },\n\n    async getLiveUrl(roomId: string): Promise<string | null> {\n      const info = await ensureCache(cachedUser || roomId)\n      return info?.streamUrl ?? null\n    },\n  }\n\n  // ─── Internal: fetch and parse SIGI_STATE / Universal Data ──\n\n  /**\n   * Try to fetch a TikTok user page from multiple domains.\n   * www.tiktok.com is increasingly blocked by Slardar WAF; m.tiktok.com\n   * often has different bot protection and may succeed.\n   * Returns the HTML and the base URL that worked, or null if all fail.\n   */\n  async function tryFetchPage(\n    user: string,\n    path: string,\n  ): Promise<{ html: string; baseUrl: string } | null> {\n    for (const base of TIKTOK_BASES) {\n      const url = `${base}/@${user}${path}`\n      const res = await http.get(url)\n      debug(`tryFetchPage: ${url} status=${res.status}, ok=${res.ok}`)\n      if (!res.ok) continue\n\n      const html = await res.text()\n      // Reject Slardar WAF challenge pages (small + keyword)\n      if (html.length < 5000 || html.includes(\"SlardarWAF\")) {\n        debug(\n          `tryFetchPage: ${url} WAF blocked (${html.length} bytes, slardar=${html.includes(\"SlardarWAF\")})`,\n        )\n        continue\n      }\n\n      debug(`tryFetchPage: ${url} succeeded (${html.length} bytes)`)\n      return { html, baseUrl: base }\n    }\n    return null\n  }\n\n  async function fetchLiveInfo(user: string): Promise<LiveInfo | null> {\n    let sigi: SigiState | null = null\n    let html = \"\"\n\n    try {\n      const page = await tryFetchPage(user, \"/live\")\n      if (!page) {\n        debug(\"fetchLiveInfo: all domains blocked for /live page\")\n        // Fall through to universal data / profile page fallback\n        html = \"\"\n      } else {\n        html = page.html\n        debug(\n          `fetchLiveInfo: /live returned ${html.length} bytes (${page.baseUrl}), first 300: ${html.slice(0, 300).replace(/\\n/g, \"\\\\n\")}`,\n        )\n\n        sigi = extractSigiState(html)\n        debug(`fetchLiveInfo: SIGI_STATE ${sigi ? \"found\" : \"not found\"}`)\n\n        if (sigi) {\n          const liveRoom = sigi.LiveRoom?.liveRoomUserInfo?.liveRoom\n          const userInfo = sigi.LiveRoom?.liveRoomUserInfo?.user\n\n          debug(\n            `fetchLiveInfo: liveRoom=${!!liveRoom}, userInfo=${!!userInfo}, userInfo.roomId=${userInfo?.roomId ?? \"null\"}`,\n          )\n\n          // ── Primary path: liveRoom is populated (server-rendered) ──\n          if (liveRoom && userInfo?.roomId) {\n            const roomId = String(userInfo.roomId)\n            const isLive = liveRoom.status === 2 // 2 = live, 4 = offline\n            debug(\n              `fetchLiveInfo: primary path — roomId=${roomId}, status=${liveRoom.status}, isLive=${isLive}`,\n            )\n\n            // Extract stream URL: try SIGI_STATE first, then Webcast API fallback\n            let streamUrl: string | null = null\n            if (isLive) {\n              streamUrl = extractStreamUrlFast(liveRoom)\n              if (!streamUrl) streamUrl = findStreamUrlRecursively(sigi)\n              if (!streamUrl) streamUrl = await fetchStreamUrlFromApi(roomId)\n            }\n\n            return { roomId, isLive, streamUrl, title: liveRoom.title ?? null }\n          }\n\n          // ── Fallback: userInfo has roomId, but liveRoom is async-loaded ──\n          // TikTok may omit liveRoom from the server-rendered page and load it\n          // via JavaScript. Query the Webcast API directly — it's authoritative.\n          if (userInfo?.roomId) {\n            const roomId = String(userInfo.roomId)\n            debug(`fetchLiveInfo: userInfo fallback — roomId=${roomId}, querying Webcast API`)\n            const roomInfo = await fetchRoomInfoFromRoomApi(roomId)\n            debug(`fetchLiveInfo: Webcast API ${roomInfo ? \"returned room info\" : \"returned null\"}`)\n            if (roomInfo) return roomInfo\n          }\n\n          // ── Legacy fallback: async-loaded SIGI_STATE ──\n          debug(\"fetchLiveInfo: trying legacy fallback (UserModule)\")\n          const legacy = await fetchLiveInfoFallback(sigi, user)\n          debug(`fetchLiveInfo: legacy fallback ${legacy ? \"succeeded\" : \"returned null\"}`)\n          if (legacy) return legacy\n        } // end if (sigi)\n      } // end else (page loaded)\n    } catch (_err) {\n      // Timeout (15s) or network error → treat as offline\n      debug(`fetchLiveInfo: caught error — ${_err instanceof Error ? _err.message : String(_err)}`)\n      return null\n    }\n\n    // ── API fallback: when page scraping fails (WAF), use TikTok API directly ──\n    // The /api-live/user/room/ endpoint returns roomId + live status without\n    // the Slardar WAF that blocks www.tiktok.com HTML pages.\n    if (!html || html.length < 5000) {\n      debug(\"fetchLiveInfo: trying API fallback (api-live/user/room)\")\n      const apiResult = await fetchLiveInfoFromApi(user)\n      if (apiResult) return apiResult\n    }\n\n    // ── New fallback: TikTok's unified page structure ──\n    // TikTok migrated from SIGI_STATE to __UNIVERSAL_DATA_FOR_REHYDRATION__.\n    // The /live page may not have it, so try the main profile page.\n    debug(`fetchLiveInfo: trying universal data fallback (html length ${html.length})`)\n    const { roomId } = extractUserFromUniversalData(html)\n    debug(`fetchLiveInfo: universal data roomId=${roomId ?? \"null\"}`)\n    if (roomId) {\n      // If the /live page has the roomId, use room/info (reliable)\n      const result = await fetchRoomInfoFromRoomApi(roomId)\n      debug(`fetchLiveInfo: universal data Webcast API ${result ? \"succeeded\" : \"returned null\"}`)\n      if (result) return result\n    }\n    // No roomId available — fall through to profile page to check for\n    // __UNIVERSAL_DATA_FOR_REHYDRATION__ which may have the roomId when live.\n\n    // Final fallback: fetch the main profile page for webapp.user-detail\n    debug(\"fetchLiveInfo: trying profile page fallback\")\n    const profileResult = await fetchLiveInfoFromProfile(user)\n    debug(`fetchLiveInfo: profile page ${profileResult ? \"succeeded\" : \"returned null\"}`)\n    return profileResult\n  }\n\n  /**\n   * Fetch the main profile page to extract user info from\n   * __UNIVERSAL_DATA_FOR_REHYDRATION__. When the user is live, their\n   * roomId is embedded in the data, allowing us to fetch room info and\n   * stream URL via the /webcast/room/info/ endpoint (which works\n   * reliably). If no roomId is present the user is offline.\n   */\n  async function fetchLiveInfoFromProfile(user: string): Promise<LiveInfo | null> {\n    try {\n      const page = await tryFetchPage(user, \"\")\n      if (!page) {\n        debug(\"fetchLiveInfoFromProfile: all domains blocked for profile page\")\n        return null\n      }\n      debug(\n        `fetchLiveInfoFromProfile: returned ${page.html.length} bytes (${page.baseUrl}), first 300: ${page.html.slice(0, 300).replace(/\\n/g, \"\\\\n\")}`,\n      )\n      const { userId, roomId } = extractUserFromUniversalData(page.html)\n      if (!userId) return null\n\n      // If roomId is embedded in the profile page, the user is live.\n      // Use room/info which works reliably for both live and offline rooms.\n      if (roomId) {\n        return fetchRoomInfoFromRoomApi(roomId)\n      }\n\n      // No roomId means the user is offline (room/enter was unreliable).\n      return null\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Fetch live info from TikTok's internal API endpoint.\n   * This bypasses the Slardar WAF that blocks www.tiktok.com HTML pages.\n   *\n   * Endpoint: /api-live/user/room/?aid=1988&uniqueId=${user}&sourceType=54\n   * Returns the roomId, user status (2 = live), and other user metadata.\n   * When the user is live, also queries the Webcast API for a stream URL.\n   */\n  async function fetchLiveInfoFromApi(user: string): Promise<LiveInfo | null> {\n    try {\n      const url = `https://www.tiktok.com/api-live/user/room/?aid=1988&uniqueId=${encodeURIComponent(user)}&sourceType=54`\n      const res = await http.get(url)\n      debug(`fetchLiveInfoFromApi: ${url} status=${res.status}`)\n      if (!res.ok) return null\n\n      const text = await res.text()\n      debug(`fetchLiveInfoFromApi: returned ${text.length} bytes`)\n      if (text.length === 0) return null\n\n      const data = JSON.parse(text) as Record<string, unknown>\n      const userData = (data?.data as Record<string, unknown> | undefined)?.user as\n        | { roomId?: string; status?: number; uniqueId?: string }\n        | undefined\n\n      if (!userData?.roomId) {\n        debug(\"fetchLiveInfoFromApi: no roomId in API response\")\n        return null\n      }\n\n      const roomId = String(userData.roomId)\n      // status: 2 = live, 4 = offline, 1 = ...\n      const isLive = userData.status === 2\n      debug(`fetchLiveInfoFromApi: roomId=${roomId}, status=${userData.status}, isLive=${isLive}`)\n\n      if (!isLive) {\n        return { roomId, isLive: false, streamUrl: null, title: null }\n      }\n\n      // Query Webcast API for stream URL\n      const streamUrl = await fetchStreamUrlFromApi(roomId)\n      return { roomId, isLive: true, streamUrl, title: null }\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Shared boilerplate for Webcast room/info API calls.\n   * Handles URL construction, HTTP GET, JSON parsing, status code checks,\n   * and error handling. The caller provides an extractor for the response data.\n   */\n  async function fetchFromRoomApi<T>(\n    roomId: string,\n    extract: (data: Record<string, unknown>) => T | null,\n  ): Promise<T | null> {\n    try {\n      const url = `${WEBCAST_BASE}/webcast/room/info/?aid=1988&room_id=${roomId}&type=live`\n      const res = await http.get(url)\n      debug(`fetchFromRoomApi: roomId=${roomId} status=${res.status}, ok=${res.ok}`)\n      if (!res.ok) return null\n\n      const text = await res.text()\n      debug(`fetchFromRoomApi: roomId=${roomId} returned ${text.length} bytes`)\n      if (text.length === 0) return null\n\n      const data = JSON.parse(text) as Record<string, unknown>\n\n      // status_code 4003110 = live restriction / room not found\n      if ((data as { status_code?: unknown }).status_code === 4003110) return null\n\n      return extract(data)\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Check if a room is currently alive using the lightweight\n   * /webcast/room/check_alive/ endpoint.\n   *\n   * This is faster and cheaper than fetching the full room/info response.\n   * Returns `true` if the room is live, `false` otherwise (including errors).\n   *\n   * Endpoint: /webcast/room/check_alive/?aid=1988&region=CH&room_ids={id}&user_is_login=true\n   * Response: { \"data\": [{ \"alive\": true/false, \"room_id\": \"...\" }] }\n   */\n  async function fetchCheckAlive(roomId: string): Promise<boolean> {\n    try {\n      const url = `${WEBCAST_BASE}/webcast/room/check_alive/?aid=1988&region=CH&room_ids=${roomId}&user_is_login=true`\n      const res = await http.get(url)\n      debug(`fetchCheckAlive: roomId=${roomId} status=${res.status}, ok=${res.ok}`)\n      if (!res.ok) return false\n\n      const text = await res.text()\n      debug(`fetchCheckAlive: roomId=${roomId} returned ${text.length} bytes`)\n      if (text.length === 0) return false\n\n      const data = JSON.parse(text) as Record<string, unknown>\n      const items = data?.data as Array<Record<string, unknown>> | undefined\n      const alive = items?.[0]?.alive === true\n      debug(`fetchCheckAlive: roomId=${roomId} alive=${alive}`)\n      return alive\n    } catch (err) {\n      debug(\n        `fetchCheckAlive: roomId=${roomId} error — ${err instanceof Error ? err.message : String(err)}`,\n      )\n      return false\n    }\n  }\n\n  /**\n   * Fetch room info from the Webcast room/info API. Requires a known roomId.\n   */\n  async function fetchRoomInfoFromRoomApi(roomId: string): Promise<LiveInfo | null> {\n    return fetchFromRoomApi(roomId, (data) => {\n      const roomData = (data as { data?: Record<string, unknown> }).data\n      if (!roomData) return null\n\n      const status = roomData.status ?? 4\n      const isLive = status === 2\n      const streamUrl = isLive ? findStreamUrlRecursively(roomData) : null\n\n      return { roomId, isLive, streamUrl, title: (roomData.title as string | undefined) ?? null }\n    })\n  }\n\n  /**\n   * Secondary live-info extraction when SIGI_STATE's LiveRoom data is\n   * async-loaded.  Uses LiveRoom.liveRoomStatus for the live flag and\n   * UserModule.users[user].roomId for the room ID.  Stream URL is obtained\n   * from the Webcast API (room/info/) as a final fallback.\n   */\n  async function fetchLiveInfoFallback(sigi: SigiState, user: string): Promise<LiveInfo | null> {\n    const liveRoomStatus = sigi.LiveRoom?.liveRoomStatus\n    const isLive = liveRoomStatus === 2 // 2 = live\n\n    // Try to get roomId from UserModule (usually populated even when LiveRoom is not)\n    const userModule = sigi.UserModule?.users?.[user]\n    let roomId: string | null = null\n\n    if (userModule?.roomId) {\n      roomId =\n        typeof userModule.roomId === \"object\"\n          ? String((userModule.roomId as { id: string }).id ?? \"\")\n          : String(userModule.roomId)\n    }\n\n    // If we have a roomId, use Webcast room/info for the stream URL\n    if (roomId) {\n      const streamUrl = isLive ? await fetchStreamUrlFromApi(roomId) : null\n      return { roomId, isLive, streamUrl, title: null }\n    }\n\n    // No roomId available — treat as offline (room/enter was unreliable).\n    return null\n  }\n\n  /**\n   * Fetch stream URL from the Webcast API.\n   * Covers cases where SIGI_STATE doesn't include stream data.\n   */\n  async function fetchStreamUrlFromApi(roomId: string): Promise<string | null> {\n    return fetchFromRoomApi(roomId, (data) => findStreamUrlRecursively(data))\n  }\n}\n\n// ─── Types ──────────────────────────────────────────────────\n\ninterface LiveInfo {\n  roomId: string\n  isLive: boolean\n  streamUrl: string | null\n  title: string | null\n}\n\ninterface SigiState {\n  LiveRoom?: {\n    liveRoomStatus?: number\n    liveRoomUserInfo?: {\n      user?: {\n        id?: string | number\n        roomId?: string | number\n      }\n      liveRoom?: {\n        status?: number // 2 = live, 4 = offline\n        title?: string\n        startTime?: number\n        streamData?: {\n          pull_data?: {\n            stream_data?: string // JSON string with FLV/HLS URLs\n          }\n        }\n      }\n    }\n  }\n  UserModule?: {\n    users?: {\n      [username: string]: {\n        id?: string // numeric user ID\n        uniqueId?: string\n        roomId?: string | { id: string }\n      }\n    }\n  }\n}\n\n// ─── HTML parsing ──────────────────────────────────────────\n\n/**\n * @public Exported for testing.\n */\nexport function extractSigiState(html: string): SigiState | null {\n  const match = html.match(/<script\\s+id=\"SIGI_STATE\"\\s+type=\"application\\/json\">(.*?)<\\/script>/)\n  if (!match?.[1]) return null\n  try {\n    return JSON.parse(match[1]) as SigiState\n  } catch {\n    return null\n  }\n}\n\n/**\n * Extract the numeric user ID and optional room ID from TikTok's new\n * page structure (__UNIVERSAL_DATA_FOR_REHYDRATION__).\n *\n * The profile page (/@user) includes \"webapp.user-detail\" which\n * contains the user's numeric ID. When the user is live, the roomId\n * is also embedded here.\n *\n * Returns { userId, roomId } where userId is always set when the data\n * is found, and roomId is set only when the user is currently live.\n *\n * @public Exported for testing and fixture capture.\n */\nexport function extractUserFromUniversalData(html: string): {\n  userId: string | null\n  roomId: string | null\n} {\n  const match = html.match(\n    /<script\\s+id=\"__UNIVERSAL_DATA_FOR_REHYDRATION__\"\\s+type=\"application\\/json\">(.*?)<\\/script>/,\n  )\n  if (!match?.[1]) return { userId: null, roomId: null }\n  try {\n    const data = JSON.parse(match[1])\n    const scope = (data as Record<string, unknown>).__DEFAULT_SCOPE__ ?? data\n    const userDetail = scope?.[\"webapp.user-detail\"]\n    const user = userDetail?.userInfo?.user\n    const userId = user?.id ? String(user.id) : null\n    const roomId = user?.roomId ? String(user.roomId) : null\n    return { userId, roomId }\n  } catch {\n    return { userId: null, roomId: null }\n  }\n}\n\n// ─── Stream URL extraction ─────────────────────────────────\n\n/**\n * Fast-path: extract stream URL from the known SIGI_STATE location.\n * This covers ~95% of cases without needing a full recursive search.\n *\n * Prefers FLV (lower latency) over HLS/other protocols.\n */\nfunction extractStreamUrlFast(\n  liveRoom: NonNullable<NonNullable<SigiState[\"LiveRoom\"]>[\"liveRoomUserInfo\"]>[\"liveRoom\"],\n): string | null {\n  try {\n    const raw = liveRoom?.streamData?.pull_data?.stream_data\n    if (!raw) return null\n    const parsed = JSON.parse(raw) as Record<string, unknown>\n    const data = (parsed as Record<string, unknown>)?.data as Record<string, unknown> | undefined\n    if (!data) return null\n\n    // Try all known quality keys, preferring higher quality.\n    // FLV is preferred (lower latency); HLS is the fallback.\n    const qualities = [\"origin\", \"fhd\", \"uhd\", \"hd\", \"sd\", \"ld\"]\n    for (const q of qualities) {\n      const entry = data[q] as { main?: { flv?: string; hls?: string } } | undefined\n      // Prefer FLV over HLS when both are available\n      const url = entry?.main?.flv ?? entry?.main?.hls\n      if (url) return url\n    }\n    return null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Brute-force recursive search for a stream URL anywhere in a JSON value.\n * Survives TikTok changing key names or nesting structure.\n *\n * Prefers FLV over HLS when both are present in the response.\n *\n * Inspired by PR #430 (Michele0303/tiktok-live-recorder).\n */\nexport function findStreamUrlRecursively(obj: unknown): string | null {\n  // Collect all candidate URLs with their preference\n  const flvUrls: string[] = []\n  const m3u8Urls: string[] = []\n\n  function walk(value: unknown): void {\n    if (typeof value === \"string\") {\n      // Direct URL match\n      if (\n        (value.startsWith(\"http://\") || value.startsWith(\"https://\")) &&\n        (value.includes(\".flv\") || value.includes(\".m3u8\"))\n      ) {\n        if (value.includes(\".flv\")) {\n          flvUrls.push(value)\n        } else {\n          m3u8Urls.push(value)\n        }\n        return\n      }\n      // JSON-encoded string — parse and recurse\n      if (value.startsWith(\"{\") || value.startsWith(\"[\")) {\n        try {\n          walk(JSON.parse(value))\n        } catch {\n          // skip\n        }\n      }\n      return\n    }\n\n    if (value && typeof value === \"object\") {\n      if (Array.isArray(value)) {\n        for (const item of value) {\n          walk(item)\n        }\n      } else {\n        for (const val of Object.values(value as Record<string, unknown>)) {\n          walk(val)\n        }\n      }\n    }\n  }\n\n  walk(obj)\n\n  // Prefer FLV (lower latency) over HLS\n  if (flvUrls.length > 0) return flvUrls[0] as string\n  if (m3u8Urls.length > 0) return m3u8Urls[0] as string\n  return null\n}\n"],"mappings":";AAiCA,MAAM,eAAe,CAAC,0BAA0B,sBAAsB;AACtE,MAAM,eAAe;AAErB,SAAgB,gBAAgB,MAAkB,QAAiB,WAAgC;CAEjG,MAAM,SAAS,QAAgB;EAC7B,QAAQ,MAAM,GAAG;EACjB,IAAI,WAAW,QAAQ,OAAO,MAAM,eAAe,IAAI,GAAG;CAC5D;CACA,IAAI,SAA0B;CAC9B,IAAI,aAAa;CAEjB,eAAe,YAAY,MAAwC;EACjE,IAAI,UAAU,eAAe,MAAM,OAAO;EAC1C,SAAS,MAAM,cAAc,IAAI;EACjC,aAAa;EACb,OAAO;CACT;CAEA,SAAS,kBAAwB;EAC/B,SAAS;EACT,aAAa;CACf;CAEA,OAAO;EACL;EAEA,MAAM,UAAU,MAAsC;GAEpD,QAAO,MADY,YAAY,IAAI,EAAA,EACtB,UAAU;EACzB;EAEA,MAAM,YAAY,QAAkC;GAClD,IAAI,UAAU,OAAO,OAAO,MAAM,MAAM,OAAO,MAAM,GACnD,OAAO,OAAO;GAIhB,OAAO,gBAAgB,MAAM;EAC/B;EAEA,MAAM,WAAW,QAAwC;GAEvD,QAAO,MADY,YAAY,cAAc,MAAM,EAAA,EACtC,aAAa;EAC5B;CACF;;;;;;;CAUA,eAAe,aACb,MACA,MACmD;EACnD,KAAK,MAAM,QAAQ,cAAc;GAC/B,MAAM,MAAM,GAAG,KAAK,IAAI,OAAO;GAC/B,MAAM,MAAM,MAAM,KAAK,IAAI,GAAG;GAC9B,MAAM,iBAAiB,IAAI,UAAU,IAAI,OAAO,OAAO,IAAI,IAAI;GAC/D,IAAI,CAAC,IAAI,IAAI;GAEb,MAAM,OAAO,MAAM,IAAI,KAAK;GAE5B,IAAI,KAAK,SAAS,OAAQ,KAAK,SAAS,YAAY,GAAG;IACrD,MACE,iBAAiB,IAAI,gBAAgB,KAAK,OAAO,kBAAkB,KAAK,SAAS,YAAY,EAAE,EACjG;IACA;GACF;GAEA,MAAM,iBAAiB,IAAI,cAAc,KAAK,OAAO,QAAQ;GAC7D,OAAO;IAAE;IAAM,SAAS;GAAK;EAC/B;EACA,OAAO;CACT;CAEA,eAAe,cAAc,MAAwC;EACnE,IAAI,OAAyB;EAC7B,IAAI,OAAO;EAEX,IAAI;GACF,MAAM,OAAO,MAAM,aAAa,MAAM,OAAO;GAC7C,IAAI,CAAC,MAAM;IACT,MAAM,mDAAmD;IAEzD,OAAO;GACT,OAAO;IACL,OAAO,KAAK;IACZ,MACE,iCAAiC,KAAK,OAAO,UAAU,KAAK,QAAQ,gBAAgB,KAAK,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,OAAO,KAAK,GAC7H;IAEA,OAAO,iBAAiB,IAAI;IAC5B,MAAM,6BAA6B,OAAO,UAAU,aAAa;IAEjE,IAAI,MAAM;KACR,MAAM,WAAW,KAAK,UAAU,kBAAkB;KAClD,MAAM,WAAW,KAAK,UAAU,kBAAkB;KAElD,MACE,2BAA2B,CAAC,CAAC,SAAS,aAAa,CAAC,CAAC,SAAS,oBAAoB,UAAU,UAAU,QACxG;KAGA,IAAI,YAAY,UAAU,QAAQ;MAChC,MAAM,SAAS,OAAO,SAAS,MAAM;MACrC,MAAM,SAAS,SAAS,WAAW;MACnC,MACE,wCAAwC,OAAO,WAAW,SAAS,OAAO,WAAW,QACvF;MAGA,IAAI,YAA2B;MAC/B,IAAI,QAAQ;OACV,YAAY,qBAAqB,QAAQ;OACzC,IAAI,CAAC,WAAW,YAAY,yBAAyB,IAAI;OACzD,IAAI,CAAC,WAAW,YAAY,MAAM,sBAAsB,MAAM;MAChE;MAEA,OAAO;OAAE;OAAQ;OAAQ;OAAW,OAAO,SAAS,SAAS;MAAK;KACpE;KAKA,IAAI,UAAU,QAAQ;MACpB,MAAM,SAAS,OAAO,SAAS,MAAM;MACrC,MAAM,6CAA6C,OAAO,uBAAuB;MACjF,MAAM,WAAW,MAAM,yBAAyB,MAAM;MACtD,MAAM,8BAA8B,WAAW,uBAAuB,iBAAiB;MACvF,IAAI,UAAU,OAAO;KACvB;KAGA,MAAM,oDAAoD;KAC1D,MAAM,SAAS,MAAM,sBAAsB,MAAM,IAAI;KACrD,MAAM,kCAAkC,SAAS,cAAc,iBAAiB;KAChF,IAAI,QAAQ,OAAO;IACrB;GACF;EACF,SAAS,MAAM;GAEb,MAAM,iCAAiC,gBAAgB,QAAQ,KAAK,UAAU,OAAO,IAAI,GAAG;GAC5F,OAAO;EACT;EAKA,IAAI,CAAC,QAAQ,KAAK,SAAS,KAAM;GAC/B,MAAM,yDAAyD;GAC/D,MAAM,YAAY,MAAM,qBAAqB,IAAI;GACjD,IAAI,WAAW,OAAO;EACxB;EAKA,MAAM,8DAA8D,KAAK,OAAO,EAAE;EAClF,MAAM,EAAE,WAAW,6BAA6B,IAAI;EACpD,MAAM,wCAAwC,UAAU,QAAQ;EAChE,IAAI,QAAQ;GAEV,MAAM,SAAS,MAAM,yBAAyB,MAAM;GACpD,MAAM,6CAA6C,SAAS,cAAc,iBAAiB;GAC3F,IAAI,QAAQ,OAAO;EACrB;EAKA,MAAM,6CAA6C;EACnD,MAAM,gBAAgB,MAAM,yBAAyB,IAAI;EACzD,MAAM,+BAA+B,gBAAgB,cAAc,iBAAiB;EACpF,OAAO;CACT;;;;;;;;CASA,eAAe,yBAAyB,MAAwC;EAC9E,IAAI;GACF,MAAM,OAAO,MAAM,aAAa,MAAM,EAAE;GACxC,IAAI,CAAC,MAAM;IACT,MAAM,gEAAgE;IACtE,OAAO;GACT;GACA,MACE,sCAAsC,KAAK,KAAK,OAAO,UAAU,KAAK,QAAQ,gBAAgB,KAAK,KAAK,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,OAAO,KAAK,GAC5I;GACA,MAAM,EAAE,QAAQ,WAAW,6BAA6B,KAAK,IAAI;GACjE,IAAI,CAAC,QAAQ,OAAO;GAIpB,IAAI,QACF,OAAO,yBAAyB,MAAM;GAIxC,OAAO;EACT,QAAQ;GACN,OAAO;EACT;CACF;;;;;;;;;CAUA,eAAe,qBAAqB,MAAwC;EAC1E,IAAI;GACF,MAAM,MAAM,gEAAgE,mBAAmB,IAAI,EAAE;GACrG,MAAM,MAAM,MAAM,KAAK,IAAI,GAAG;GAC9B,MAAM,yBAAyB,IAAI,UAAU,IAAI,QAAQ;GACzD,IAAI,CAAC,IAAI,IAAI,OAAO;GAEpB,MAAM,OAAO,MAAM,IAAI,KAAK;GAC5B,MAAM,kCAAkC,KAAK,OAAO,OAAO;GAC3D,IAAI,KAAK,WAAW,GAAG,OAAO;GAG9B,MAAM,YADO,KAAK,MAAM,IACH,CAAC,EAAE,KAAA,EAA8C;GAItE,IAAI,CAAC,UAAU,QAAQ;IACrB,MAAM,iDAAiD;IACvD,OAAO;GACT;GAEA,MAAM,SAAS,OAAO,SAAS,MAAM;GAErC,MAAM,SAAS,SAAS,WAAW;GACnC,MAAM,gCAAgC,OAAO,WAAW,SAAS,OAAO,WAAW,QAAQ;GAE3F,IAAI,CAAC,QACH,OAAO;IAAE;IAAQ,QAAQ;IAAO,WAAW;IAAM,OAAO;GAAK;GAK/D,OAAO;IAAE;IAAQ,QAAQ;IAAM,WAAA,MADP,sBAAsB,MAAM;IACV,OAAO;GAAK;EACxD,QAAQ;GACN,OAAO;EACT;CACF;;;;;;CAOA,eAAe,iBACb,QACA,SACmB;EACnB,IAAI;GACF,MAAM,MAAM,GAAG,aAAa,uCAAuC,OAAO;GAC1E,MAAM,MAAM,MAAM,KAAK,IAAI,GAAG;GAC9B,MAAM,4BAA4B,OAAO,UAAU,IAAI,OAAO,OAAO,IAAI,IAAI;GAC7E,IAAI,CAAC,IAAI,IAAI,OAAO;GAEpB,MAAM,OAAO,MAAM,IAAI,KAAK;GAC5B,MAAM,4BAA4B,OAAO,YAAY,KAAK,OAAO,OAAO;GACxE,IAAI,KAAK,WAAW,GAAG,OAAO;GAE9B,MAAM,OAAO,KAAK,MAAM,IAAI;GAG5B,IAAK,KAAmC,gBAAgB,SAAS,OAAO;GAExE,OAAO,QAAQ,IAAI;EACrB,QAAQ;GACN,OAAO;EACT;CACF;;;;;;;;;;;CAYA,eAAe,gBAAgB,QAAkC;EAC/D,IAAI;GACF,MAAM,MAAM,GAAG,aAAa,yDAAyD,OAAO;GAC5F,MAAM,MAAM,MAAM,KAAK,IAAI,GAAG;GAC9B,MAAM,2BAA2B,OAAO,UAAU,IAAI,OAAO,OAAO,IAAI,IAAI;GAC5E,IAAI,CAAC,IAAI,IAAI,OAAO;GAEpB,MAAM,OAAO,MAAM,IAAI,KAAK;GAC5B,MAAM,2BAA2B,OAAO,YAAY,KAAK,OAAO,OAAO;GACvE,IAAI,KAAK,WAAW,GAAG,OAAO;GAI9B,MAAM,SAFO,KAAK,MAAM,IACP,CAAC,EAAE,KAAA,GACE,EAAE,EAAE,UAAU;GACpC,MAAM,2BAA2B,OAAO,SAAS,OAAO;GACxD,OAAO;EACT,SAAS,KAAK;GACZ,MACE,2BAA2B,OAAO,WAAW,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,GAC9F;GACA,OAAO;EACT;CACF;;;;CAKA,eAAe,yBAAyB,QAA0C;EAChF,OAAO,iBAAiB,SAAS,SAAS;GACxC,MAAM,WAAY,KAA4C;GAC9D,IAAI,CAAC,UAAU,OAAO;GAGtB,MAAM,UADS,SAAS,UAAU,OACR;GAG1B,OAAO;IAAE;IAAQ;IAAQ,WAFP,SAAS,yBAAyB,QAAQ,IAAI;IAE5B,OAAQ,SAAS,SAAgC;GAAK;EAC5F,CAAC;CACH;;;;;;;CAQA,eAAe,sBAAsB,MAAiB,MAAwC;EAE5F,MAAM,SADiB,KAAK,UAAU,mBACJ;EAGlC,MAAM,aAAa,KAAK,YAAY,QAAQ;EAC5C,IAAI,SAAwB;EAE5B,IAAI,YAAY,QACd,SACE,OAAO,WAAW,WAAW,WACzB,OAAQ,WAAW,OAA0B,MAAM,EAAE,IACrD,OAAO,WAAW,MAAM;EAIhC,IAAI,QAAQ;GACV,MAAM,YAAY,SAAS,MAAM,sBAAsB,MAAM,IAAI;GACjE,OAAO;IAAE;IAAQ;IAAQ;IAAW,OAAO;GAAK;EAClD;EAGA,OAAO;CACT;;;;;CAMA,eAAe,sBAAsB,QAAwC;EAC3E,OAAO,iBAAiB,SAAS,SAAS,yBAAyB,IAAI,CAAC;CAC1E;AACF;;;;AA+CA,SAAgB,iBAAiB,MAAgC;CAC/D,MAAM,QAAQ,KAAK,MAAM,sEAAsE;CAC/F,IAAI,CAAC,QAAQ,IAAI,OAAO;CACxB,IAAI;EACF,OAAO,KAAK,MAAM,MAAM,EAAE;CAC5B,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;;;;;;;AAeA,SAAgB,6BAA6B,MAG3C;CACA,MAAM,QAAQ,KAAK,MACjB,8FACF;CACA,IAAI,CAAC,QAAQ,IAAI,OAAO;EAAE,QAAQ;EAAM,QAAQ;CAAK;CACrD,IAAI;EACF,MAAM,OAAO,KAAK,MAAM,MAAM,EAAE;EAGhC,MAAM,SAFS,KAAiC,qBAAqB,KAAA,GAC1C,sBAAA,EACF,UAAU;EAGnC,OAAO;GAAE,QAFM,MAAM,KAAK,OAAO,KAAK,EAAE,IAAI;GAE3B,QADF,MAAM,SAAS,OAAO,KAAK,MAAM,IAAI;EAC5B;CAC1B,QAAQ;EACN,OAAO;GAAE,QAAQ;GAAM,QAAQ;EAAK;CACtC;AACF;;;;;;;AAUA,SAAS,qBACP,UACe;CACf,IAAI;EACF,MAAM,MAAM,UAAU,YAAY,WAAW;EAC7C,IAAI,CAAC,KAAK,OAAO;EAEjB,MAAM,OADS,KAAK,MAAM,GACP,CAAC,EAA8B;EAClD,IAAI,CAAC,MAAM,OAAO;EAKlB,KAAK,MAAM,KAAK;GADG;GAAU;GAAO;GAAO;GAAM;GAAM;EAC/B,GAAG;GACzB,MAAM,QAAQ,KAAK;GAEnB,MAAM,MAAM,OAAO,MAAM,OAAO,OAAO,MAAM;GAC7C,IAAI,KAAK,OAAO;EAClB;EACA,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;;AAUA,SAAgB,yBAAyB,KAA6B;CAEpE,MAAM,UAAoB,CAAC;CAC3B,MAAM,WAAqB,CAAC;CAE5B,SAAS,KAAK,OAAsB;EAClC,IAAI,OAAO,UAAU,UAAU;GAE7B,KACG,MAAM,WAAW,SAAS,KAAK,MAAM,WAAW,UAAU,OAC1D,MAAM,SAAS,MAAM,KAAK,MAAM,SAAS,OAAO,IACjD;IACA,IAAI,MAAM,SAAS,MAAM,GACvB,QAAQ,KAAK,KAAK;SAElB,SAAS,KAAK,KAAK;IAErB;GACF;GAEA,IAAI,MAAM,WAAW,GAAG,KAAK,MAAM,WAAW,GAAG,GAC/C,IAAI;IACF,KAAK,KAAK,MAAM,KAAK,CAAC;GACxB,QAAQ,CAER;GAEF;EACF;EAEA,IAAI,SAAS,OAAO,UAAU,UAC5B,IAAI,MAAM,QAAQ,KAAK,GACrB,KAAK,MAAM,QAAQ,OACjB,KAAK,IAAI;OAGX,KAAK,MAAM,OAAO,OAAO,OAAO,KAAgC,GAC9D,KAAK,GAAG;CAIhB;CAEA,KAAK,GAAG;CAGR,IAAI,QAAQ,SAAS,GAAG,OAAO,QAAQ;CACvC,IAAI,SAAS,SAAS,GAAG,OAAO,SAAS;CACzC,OAAO;AACT"}

package/dist/core/monitor.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"monitor.mjs","names":[],"sources":["../../src/core/monitor.ts"],"sourcesContent":["/**\n * Polling monitor — calls a tick function on a configurable interval.\n * Fires the first tick immediately, then every N minutes.\n *\n * Uses an AbortController so stop() can interrupt the sleep between\n * ticks immediately, avoiding a busy 1-second polling loop.\n */\n\nimport type { Logger } from \"../lib/logger\"\nimport { sleep } from \"../lib/utils\"\n\nexport interface PollingMonitor {\n  start: () => Promise<void>\n  stop: () => Promise<void>\n  /** Schedule the monitor to stop after the current tick completes. */\n  stopAfterCurrentTick: () => void\n}\n\nexport function createPollingMonitor(opts: {\n  intervalMinutes: number\n  onTick: () => Promise<void>\n  logger?: Logger\n}): PollingMonitor {\n  const intervalMs = opts.intervalMinutes * 60 * 1000\n  const stopSignal = new AbortController()\n  let currentTick: Promise<void> | null = null\n  let stopAfterTick = false\n\n  async function start(): Promise<void> {\n    opts.logger?.info(`Polling started (interval: ${opts.intervalMinutes} min)`)\n\n    while (!stopSignal.signal.aborted) {\n      currentTick = opts.onTick()\n      try {\n        await currentTick\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err)\n        opts.logger?.error(`Tick error: ${msg}`)\n      } finally {\n        currentTick = null\n      }\n\n      if (stopAfterTick) {\n        stopSignal.abort()\n      }\n      if (stopSignal.signal.aborted) break\n\n      // Sleep for the full interval — stop() aborts the signal to wake us up early\n      await sleep(intervalMs, stopSignal.signal)\n    }\n\n    opts.logger?.info(\"Polling stopped\")\n  }\n\n  async function stop(): Promise<void> {\n    // Signal start() to exit the loop immediately\n    stopSignal.abort()\n    // Wait for in-flight tick to finish (e.g. recording → converting → MP4)\n    if (currentTick) {\n      await currentTick\n    }\n  }\n\n  function stopAfterCurrentTick(): void {\n    stopAfterTick = true\n  }\n\n  return { start, stop, stopAfterCurrentTick }\n}\n"],"mappings":";;AAkBA,SAAgB,qBAAqB,MAIlB;CACjB,MAAM,aAAa,KAAK,kBAAkB,KAAK;CAC/C,MAAM,aAAa,IAAI,gBAAgB;CACvC,IAAI,cAAoC;CACxC,IAAI,gBAAgB;CAEpB,eAAe,QAAuB;EACpC,KAAK,QAAQ,KAAK,8BAA8B,KAAK,gBAAgB,MAAM;EAE3E,OAAO,CAAC,WAAW,OAAO,SAAS;GACjC,cAAc,KAAK,OAAO;GAC1B,IAAI;IACF,MAAM;GACR,SAAS,KAAK;IACZ,MAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;IAC3D,KAAK,QAAQ,MAAM,eAAe,KAAK;GACzC,UAAU;IACR,cAAc;GAChB;GAEA,IAAI,eACF,WAAW,MAAM;GAEnB,IAAI,WAAW,OAAO,SAAS;GAG/B,MAAM,MAAM,YAAY,WAAW,MAAM;EAC3C;EAEA,KAAK,QAAQ,KAAK,iBAAiB;CACrC;CAEA,eAAe,OAAsB;EAEnC,WAAW,MAAM;EAEjB,IAAI,aACF,MAAM;CAEV;CAEA,SAAS,uBAA6B;EACpC,gBAAgB;CAClB;CAEA,OAAO;EAAE;EAAO;EAAM;CAAqB;AAC7C"}

package/dist/core/recorder/convert.mjs

@@ -1,55 +0,0 @@
-import { TikTokError } from "../../lib/config.mjs";
-import { findFfmpegPath } from "../../lib/utils.mjs";
-import { execa } from "execa";
-import { unlinkSync } from "node:fs";
-//#region src/core/recorder/convert.ts
-/**
-* Converter — spawns FFmpeg to convert TS → MP4 (stream copy by default).
-* Deletes the original file on success.
-*/
-function createConverter(logger, signal) {
-	async function convert(input) {
-		const output = input.replace(/\.(flv|ts)$/i, ".mp4");
-		logger?.info(`Converting: ${input} → ${output}`);
-		const ffmpegPath = findFfmpegPath();
-		if (!ffmpegPath) throw new TikTokError("ffmpeg-not-found", "FFmpeg not found. Install it:\n  Linux:  apt install ffmpeg / brew install ffmpeg / pacman -S ffmpeg\n  macOS:  brew install ffmpeg\n  Windows: choco install ffmpeg");
-		await runFfmpeg(ffmpegPath, input, output, signal);
-		try {
-			unlinkSync(input);
-			logger?.info(`Deleted original: ${input}`);
-		} catch {
-			logger?.warn(`Could not delete original: ${input}`);
-		}
-		logger?.info(`Converted: ${output}`);
-		return output;
-	}
-	return { convert };
-}
-async function runFfmpeg(ffmpegPath, input, output, signal) {
-	const args = [
-		"-i",
-		input,
-		"-c",
-		"copy",
-		"-y",
-		output
-	];
-	try {
-		await execa(ffmpegPath, args, {
-			cancelSignal: signal,
-			stdio: [
-				"ignore",
-				"pipe",
-				"pipe"
-			]
-		});
-	} catch (err) {
-		if (signal?.aborted) throw new TikTokError("aborted", "Aborted by user");
-		const stderr = err.stderr ?? "";
-		throw new TikTokError("ffmpeg-error", `FFmpeg exited with code ${err.exitCode}\n${stderr.slice(-500)}`);
-	}
-}
-//#endregion
-export { createConverter };
-
-//# sourceMappingURL=convert.mjs.map

package/dist/core/recorder/convert.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"convert.mjs","names":[],"sources":["../../../src/core/recorder/convert.ts"],"sourcesContent":["/**\n * Converter — spawns FFmpeg to convert TS → MP4 (stream copy by default).\n * Deletes the original file on success.\n */\n\nimport { unlinkSync } from \"node:fs\"\nimport { execa } from \"execa\"\nimport { TikTokError } from \"../../lib/config\"\nimport type { Logger } from \"../../lib/logger\"\nimport { findFfmpegPath } from \"../../lib/utils\"\n\nexport interface Converter {\n  /** Convert a TS file to MP4. Returns the output filepath. */\n  convert: (input: string) => Promise<string>\n}\n\nexport function createConverter(logger?: Logger, signal?: AbortSignal): Converter {\n  async function convert(input: string): Promise<string> {\n    const output = input.replace(/\\.(flv|ts)$/i, \".mp4\")\n\n    logger?.info(`Converting: ${input} → ${output}`)\n\n    const ffmpegPath = findFfmpegPath()\n    if (!ffmpegPath) {\n      throw new TikTokError(\n        \"ffmpeg-not-found\",\n        \"FFmpeg not found. Install it:\\n\" +\n          \"  Linux:  apt install ffmpeg / brew install ffmpeg / pacman -S ffmpeg\\n\" +\n          \"  macOS:  brew install ffmpeg\\n\" +\n          \"  Windows: choco install ffmpeg\",\n      )\n    }\n\n    await runFfmpeg(ffmpegPath, input, output, signal)\n\n    // Delete original TS\n    try {\n      unlinkSync(input)\n      logger?.info(`Deleted original: ${input}`)\n    } catch {\n      logger?.warn(`Could not delete original: ${input}`)\n    }\n\n    logger?.info(`Converted: ${output}`)\n    return output\n  }\n\n  return { convert }\n}\n\nasync function runFfmpeg(\n  ffmpegPath: string,\n  input: string,\n  output: string,\n  signal?: AbortSignal,\n): Promise<void> {\n  const args = [\"-i\", input, \"-c\", \"copy\", \"-y\", output]\n\n  try {\n    await execa(ffmpegPath, args, { cancelSignal: signal, stdio: [\"ignore\", \"pipe\", \"pipe\"] })\n  } catch (err: unknown) {\n    if (signal?.aborted) {\n      throw new TikTokError(\"aborted\", \"Aborted by user\")\n    }\n    const stderr = (err as { stderr?: string }).stderr ?? \"\"\n    throw new TikTokError(\n      \"ffmpeg-error\",\n      `FFmpeg exited with code ${(err as { exitCode?: number }).exitCode}\\n${stderr.slice(-500)}`,\n    )\n  }\n}\n"],"mappings":";;;;;;;;;AAgBA,SAAgB,gBAAgB,QAAiB,QAAiC;CAChF,eAAe,QAAQ,OAAgC;EACrD,MAAM,SAAS,MAAM,QAAQ,gBAAgB,MAAM;EAEnD,QAAQ,KAAK,eAAe,MAAM,KAAK,QAAQ;EAE/C,MAAM,aAAa,eAAe;EAClC,IAAI,CAAC,YACH,MAAM,IAAI,YACR,oBACA,sKAIF;EAGF,MAAM,UAAU,YAAY,OAAO,QAAQ,MAAM;EAGjD,IAAI;GACF,WAAW,KAAK;GAChB,QAAQ,KAAK,qBAAqB,OAAO;EAC3C,QAAQ;GACN,QAAQ,KAAK,8BAA8B,OAAO;EACpD;EAEA,QAAQ,KAAK,cAAc,QAAQ;EACnC,OAAO;CACT;CAEA,OAAO,EAAE,QAAQ;AACnB;AAEA,eAAe,UACb,YACA,OACA,QACA,QACe;CACf,MAAM,OAAO;EAAC;EAAM;EAAO;EAAM;EAAQ;EAAM;CAAM;CAErD,IAAI;EACF,MAAM,MAAM,YAAY,MAAM;GAAE,cAAc;GAAQ,OAAO;IAAC;IAAU;IAAQ;GAAM;EAAE,CAAC;CAC3F,SAAS,KAAc;EACrB,IAAI,QAAQ,SACV,MAAM,IAAI,YAAY,WAAW,iBAAiB;EAEpD,MAAM,SAAU,IAA4B,UAAU;EACtD,MAAM,IAAI,YACR,gBACA,2BAA4B,IAA8B,SAAS,IAAI,OAAO,MAAM,IAAI,GAC1F;CACF;AACF"}

package/dist/core/recorder/download.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"download.mjs","names":[],"sources":["../../../src/core/recorder/download.ts"],"sourcesContent":["/**\n * Live stream downloader — downloads a live stream via FFmpeg stdout pipe.\n *\n * Outputs MPEG-TS (.ts) format, which is crash-safe and append-friendly.\n * FFmpeg handles HTTP reconnection via -reconnect flags. When TikTok's\n * short-lived stream URL expires, FFmpeg exits and the outer loop fetches\n * a fresh URL via getNextUrl.\n *\n * Both FLV and HLS streams are handled by the same download function —\n * the only difference is an optional label in the log messages.\n */\n\nimport { createWriteStream, statSync } from \"node:fs\"\nimport { join } from \"node:path\"\nimport { TikTokError } from \"../../lib/config\"\nimport type { Logger } from \"../../lib/logger\"\nimport { bytesToHuman, findFfmpegPath, formatDuration, formatFilename } from \"../../lib/utils\"\nimport { pipeFfmpegSegment } from \"./ffmpeg-utils\"\nimport type { DownloadResult, ProgressInfo } from \"./stream\"\n\nexport async function downloadStream(\n  liveUrl: string,\n  user: string,\n  outputDir: string,\n  maxDuration: number,\n  onProgress: ((info: ProgressInfo) => void) | undefined,\n  getNextUrl: (() => Promise<string | null>) | undefined,\n  signal: AbortSignal,\n  logger?: Logger,\n  label?: string,\n  cookies?: Record<string, string>,\n): Promise<DownloadResult> {\n  const filename = formatFilename(user, \"ts\")\n  const filepath = join(outputDir, filename)\n  const prefix = label ? ` (${label})` : \"\"\n  logger?.info(`Recording${prefix}: ${filename}`)\n\n  const startTime = Date.now()\n\n  /** File size read directly from disk — authoritative, avoids in-memory counter drift. */\n  let fileSize = 0\n  let lastProgressTime = 0\n\n  const ffmpegPath = findFfmpegPath()\n  if (!ffmpegPath) {\n    throw new TikTokError(\n      \"ffmpeg-not-found\",\n      \"FFmpeg not found — required for stream download. Install it:\\n\" +\n        \"  Linux:  apt install ffmpeg\\n  macOS:  brew install ffmpeg\",\n    )\n  }\n\n  function elapsed(): number {\n    return (Date.now() - startTime) / 1000\n  }\n\n  const writer = createWriteStream(filepath)\n\n  try {\n    while (!signal.aborted) {\n      const remaining = maxDuration > 0 ? Math.max(1, maxDuration - elapsed()) : undefined\n      await pipeFfmpegSegment(ffmpegPath, liveUrl, writer, signal, remaining, cookies)\n\n      // Read actual file size from disk — always authoritative\n      try {\n        fileSize = statSync(filepath).size\n      } catch {\n        // File may not be accessible; leave fileSize at last known value\n      }\n\n      // Report progress after each segment\n      const now = Date.now()\n      const e = elapsed()\n      if (onProgress && now - lastProgressTime >= 1000) {\n        lastProgressTime = now\n        const speed = e > 0 ? fileSize / e : 0\n        onProgress({ bytes: fileSize, elapsed: e, speed })\n      }\n\n      if (signal.aborted) break\n      if (maxDuration > 0 && e >= maxDuration) {\n        logger?.info(`Duration limit reached (${maxDuration}s)`)\n        break\n      }\n      if (!getNextUrl) break\n\n      const nextUrl = await getNextUrl()\n      if (!nextUrl) {\n        logger?.info(\"No new stream URL — recording finished\")\n        break\n      }\n      liveUrl = nextUrl\n    }\n  } catch (err) {\n    logger?.error(`Recording error: ${err instanceof Error ? err.message : String(err)}`)\n  } finally {\n    await new Promise<void>((resolve) => writer.end(resolve))\n  }\n\n  const duration = elapsed()\n  // Final authoritative size after flush\n  try {\n    fileSize = statSync(filepath).size\n  } catch {\n    // keep last known value\n  }\n  if (onProgress) {\n    onProgress({\n      bytes: fileSize,\n      elapsed: duration,\n      speed: duration > 0 ? fileSize / duration : 0,\n    })\n  }\n  logger?.info(\n    `Recording finished: ${filename} (${formatDuration(duration)}, ${bytesToHuman(fileSize)})`,\n  )\n\n  return { file: filepath, duration, size: fileSize }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,eAAsB,eACpB,SACA,MACA,WACA,aACA,YACA,YACA,QACA,QACA,OACA,SACyB;CACzB,MAAM,WAAW,eAAe,MAAM,IAAI;CAC1C,MAAM,WAAW,KAAK,WAAW,QAAQ;CACzC,MAAM,SAAS,QAAQ,KAAK,MAAM,KAAK;CACvC,QAAQ,KAAK,YAAY,OAAO,IAAI,UAAU;CAE9C,MAAM,YAAY,KAAK,IAAI;;CAG3B,IAAI,WAAW;CACf,IAAI,mBAAmB;CAEvB,MAAM,aAAa,eAAe;CAClC,IAAI,CAAC,YACH,MAAM,IAAI,YACR,oBACA,2HAEF;CAGF,SAAS,UAAkB;EACzB,QAAQ,KAAK,IAAI,IAAI,aAAa;CACpC;CAEA,MAAM,SAAS,kBAAkB,QAAQ;CAEzC,IAAI;EACF,OAAO,CAAC,OAAO,SAAS;GACtB,MAAM,YAAY,cAAc,IAAI,KAAK,IAAI,GAAG,cAAc,QAAQ,CAAC,IAAI,KAAA;GAC3E,MAAM,kBAAkB,YAAY,SAAS,QAAQ,QAAQ,WAAW,OAAO;GAG/E,IAAI;IACF,WAAW,SAAS,QAAQ,CAAC,CAAC;GAChC,QAAQ,CAER;GAGA,MAAM,MAAM,KAAK,IAAI;GACrB,MAAM,IAAI,QAAQ;GAClB,IAAI,cAAc,MAAM,oBAAoB,KAAM;IAChD,mBAAmB;IACnB,MAAM,QAAQ,IAAI,IAAI,WAAW,IAAI;IACrC,WAAW;KAAE,OAAO;KAAU,SAAS;KAAG;IAAM,CAAC;GACnD;GAEA,IAAI,OAAO,SAAS;GACpB,IAAI,cAAc,KAAK,KAAK,aAAa;IACvC,QAAQ,KAAK,2BAA2B,YAAY,GAAG;IACvD;GACF;GACA,IAAI,CAAC,YAAY;GAEjB,MAAM,UAAU,MAAM,WAAW;GACjC,IAAI,CAAC,SAAS;IACZ,QAAQ,KAAK,wCAAwC;IACrD;GACF;GACA,UAAU;EACZ;CACF,SAAS,KAAK;EACZ,QAAQ,MAAM,oBAAoB,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,GAAG;CACtF,UAAU;EACR,MAAM,IAAI,SAAe,YAAY,OAAO,IAAI,OAAO,CAAC;CAC1D;CAEA,MAAM,WAAW,QAAQ;CAEzB,IAAI;EACF,WAAW,SAAS,QAAQ,CAAC,CAAC;CAChC,QAAQ,CAER;CACA,IAAI,YACF,WAAW;EACT,OAAO;EACP,SAAS;EACT,OAAO,WAAW,IAAI,WAAW,WAAW;CAC9C,CAAC;CAEH,QAAQ,KACN,uBAAuB,SAAS,IAAI,eAAe,QAAQ,EAAE,IAAI,aAAa,QAAQ,EAAE,EAC1F;CAEA,OAAO;EAAE,MAAM;EAAU;EAAU,MAAM;CAAS;AACpD"}

package/dist/core/recorder/ffmpeg-utils.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ffmpeg-utils.mjs","names":[],"sources":["../../../src/core/recorder/ffmpeg-utils.ts"],"sourcesContent":["/**\n * Shared FFmpeg utilities — stream-download pipe primitive and constants.\n */\n\nimport { type ChildProcess, spawn } from \"node:child_process\"\nimport type { WriteStream } from \"node:fs\"\nimport { TikTokError } from \"../../lib/config\"\n\n/** Kill FFmpeg if no output is received within this window after spawn. */\nexport const FFMPEG_STARTUP_TIMEOUT = 30_000\n\n/**\n * Build FFmpeg HTTP option arguments for cookies and headers.\n * TikTok's CDN requires session cookies and a Referer to serve the stream.\n */\nfunction buildHttpArgs(cookies?: Record<string, string>): string[] {\n  const args: string[] = []\n\n  // ponytail: user-agent header, CDNs tend to be picky\n  args.push(\n    \"-user_agent\",\n    \"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:149.0) Gecko/20100101 Firefox/149.0\",\n  )\n  args.push(\"-headers\", \"Referer: https://www.tiktok.com/\\r\\n\")\n\n  if (cookies && Object.keys(cookies).length > 0) {\n    const cookieStr = Object.entries(cookies)\n      .map(([k, v]) => `${k}=${v}`)\n      .join(\"\\r\\n\")\n    args.push(\"-cookies\", cookieStr)\n  }\n\n  return args\n}\n\n/** Standard FFmpeg reconnect + mpegts pipe arguments. */\nconst FFMPEG_BASE_ARGS = [\n  \"-reconnect\",\n  \"1\",\n  \"-reconnect_at_eof\",\n  \"1\",\n  \"-reconnect_streamed\",\n  \"1\",\n  \"-reconnect_delay_max\",\n  \"5\",\n  \"-c\",\n  \"copy\",\n  \"-f\",\n  \"mpegts\",\n  \"pipe:1\",\n]\n\n/**\n * Spawn an FFmpeg process to download from `url` and pipe its stdout to\n * `writer` with backpressure handling.\n *\n * Uses child_process.spawn directly (not execa) because execa v9 defaults\n * to encoding stdout as UTF-8, which corrupts binary MPEG-TS data.\n */\nexport async function pipeFfmpegSegment(\n  ffmpegPath: string,\n  url: string,\n  writer: WriteStream,\n  signal: AbortSignal,\n  maxDuration?: number,\n  cookies?: Record<string, string>,\n): Promise<void> {\n  const durationArgs = maxDuration ? [\"-t\", String(maxDuration)] : []\n  const httpArgs = buildHttpArgs(cookies)\n  // ponytail: input options (-headers, -cookies, -user_agent) must come before -i\n  const args = [...httpArgs, \"-i\", url, ...durationArgs, ...FFMPEG_BASE_ARGS]\n  const proc: ChildProcess = spawn(ffmpegPath, args, {\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  })\n\n  let stderr = \"\"\n  let firstDataTimer: ReturnType<typeof setTimeout> | null = null\n\n  const clearStartupTimer = () => {\n    if (firstDataTimer) {\n      clearTimeout(firstDataTimer)\n      firstDataTimer = null\n    }\n  }\n\n  // Forward abort signal to process\n  const onAbort = () => {\n    if (!proc.killed) proc.kill(\"SIGTERM\")\n  }\n  signal.addEventListener(\"abort\", onAbort, { once: true })\n\n  proc.stderr?.on(\"data\", (chunk: Buffer) => {\n    clearStartupTimer()\n    stderr += chunk.toString()\n    if (stderr.length > 10000) stderr = stderr.slice(-5000)\n  })\n\n  proc.stdout?.on(\"data\", (chunk: Buffer) => {\n    clearStartupTimer()\n    const canContinue = writer.write(chunk)\n    if (!canContinue) {\n      proc.stdout?.pause()\n      writer.once(\"drain\", () => proc.stdout?.resume())\n    }\n  })\n\n  await new Promise<void>((resolve, reject) => {\n    firstDataTimer = setTimeout(() => {\n      if (!proc.killed) {\n        proc.kill(\"SIGTERM\")\n        setTimeout(() => {\n          if (!proc.killed) proc.kill(\"SIGKILL\")\n        }, 2000)\n      }\n      reject(\n        new TikTokError(\n          \"ffmpeg-error\",\n          `FFmpeg startup timed out after ${FFMPEG_STARTUP_TIMEOUT / 1000}s\\n${stderr.slice(-500)}`,\n        ),\n      )\n    }, FFMPEG_STARTUP_TIMEOUT)\n\n    proc.on(\"close\", (code) => {\n      clearStartupTimer()\n      signal.removeEventListener(\"abort\", onAbort)\n      if (signal.aborted) {\n        resolve()\n        return\n      }\n      if (code === 0 || code === null) {\n        resolve()\n        return\n      }\n      reject(\n        new TikTokError(\"ffmpeg-error\", `FFmpeg exited with code ${code}\\n${stderr.slice(-500)}`),\n      )\n    })\n\n    proc.on(\"error\", (err) => {\n      clearStartupTimer()\n      signal.removeEventListener(\"abort\", onAbort)\n      reject(err)\n    })\n  })\n}\n"],"mappings":";;;;;;;AASA,MAAa,yBAAyB;;;;;AAMtC,SAAS,cAAc,SAA4C;CACjE,MAAM,OAAiB,CAAC;CAGxB,KAAK,KACH,eACA,kFACF;CACA,KAAK,KAAK,YAAY,sCAAsC;CAE5D,IAAI,WAAW,OAAO,KAAK,OAAO,CAAC,CAAC,SAAS,GAAG;EAC9C,MAAM,YAAY,OAAO,QAAQ,OAAO,CAAC,CACtC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,CAC5B,KAAK,MAAM;EACd,KAAK,KAAK,YAAY,SAAS;CACjC;CAEA,OAAO;AACT;;AAGA,MAAM,mBAAmB;CACvB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;AASA,eAAsB,kBACpB,YACA,KACA,QACA,QACA,aACA,SACe;CACf,MAAM,eAAe,cAAc,CAAC,MAAM,OAAO,WAAW,CAAC,IAAI,CAAC;CAIlE,MAAM,OAAqB,MAAM,YAAY;EAD/B,GAFG,cAAc,OAEP;EAAG;EAAM;EAAK,GAAG;EAAc,GAAG;CACV,GAAG,EACjD,OAAO;EAAC;EAAU;EAAQ;CAAM,EAClC,CAAC;CAED,IAAI,SAAS;CACb,IAAI,iBAAuD;CAE3D,MAAM,0BAA0B;EAC9B,IAAI,gBAAgB;GAClB,aAAa,cAAc;GAC3B,iBAAiB;EACnB;CACF;CAGA,MAAM,gBAAgB;EACpB,IAAI,CAAC,KAAK,QAAQ,KAAK,KAAK,SAAS;CACvC;CACA,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CAExD,KAAK,QAAQ,GAAG,SAAS,UAAkB;EACzC,kBAAkB;EAClB,UAAU,MAAM,SAAS;EACzB,IAAI,OAAO,SAAS,KAAO,SAAS,OAAO,MAAM,IAAK;CACxD,CAAC;CAED,KAAK,QAAQ,GAAG,SAAS,UAAkB;EACzC,kBAAkB;EAElB,IAAI,CADgB,OAAO,MAAM,KAClB,GAAG;GAChB,KAAK,QAAQ,MAAM;GACnB,OAAO,KAAK,eAAe,KAAK,QAAQ,OAAO,CAAC;EAClD;CACF,CAAC;CAED,MAAM,IAAI,SAAe,SAAS,WAAW;EAC3C,iBAAiB,iBAAiB;GAChC,IAAI,CAAC,KAAK,QAAQ;IAChB,KAAK,KAAK,SAAS;IACnB,iBAAiB;KACf,IAAI,CAAC,KAAK,QAAQ,KAAK,KAAK,SAAS;IACvC,GAAG,GAAI;GACT;GACA,OACE,IAAI,YACF,gBACA,kCAAkC,yBAAyB,IAAK,KAAK,OAAO,MAAM,IAAI,GACxF,CACF;EACF,GAAG,sBAAsB;EAEzB,KAAK,GAAG,UAAU,SAAS;GACzB,kBAAkB;GAClB,OAAO,oBAAoB,SAAS,OAAO;GAC3C,IAAI,OAAO,SAAS;IAClB,QAAQ;IACR;GACF;GACA,IAAI,SAAS,KAAK,SAAS,MAAM;IAC/B,QAAQ;IACR;GACF;GACA,OACE,IAAI,YAAY,gBAAgB,2BAA2B,KAAK,IAAI,OAAO,MAAM,IAAI,GAAG,CAC1F;EACF,CAAC;EAED,KAAK,GAAG,UAAU,QAAQ;GACxB,kBAAkB;GAClB,OAAO,oBAAoB,SAAS,OAAO;GAC3C,OAAO,GAAG;EACZ,CAAC;CACH,CAAC;AACH"}

package/dist/core/recorder/index.d.mts

@@ -1,7 +0,0 @@
-import { RecorderConfig, RecorderController } from "../../lib/config.mjs";
-
-//#region src/core/recorder/index.d.ts
-declare function createRecorder(config: RecorderConfig): RecorderController;
-//#endregion
-export { createRecorder };
-//# sourceMappingURL=index.d.mts.map

package/dist/core/recorder/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/recorder/index.ts"],"mappings":";;;iBAqBgB,cAAA,CAAe,MAAA,EAAQ,cAAA,GAAiB,kBAAA"}