@zfadhli/tokrec 0.12.2 → 0.15.0

package/dist/io/tiktok/discovery/page.mjs

@@ -0,0 +1,102 @@
+import { fromRoomInfo, miss, withStream } from "./chain.mjs";
+import { extractSigiState, extractStreamUrlFast, extractUserFromUniversalData, findStreamUrlRecursively } from "../parse.mjs";
+//#region src/io/tiktok/discovery/page.ts
+/**
+* Page source: server-rendered SIGI_STATE first, then the async-loaded legacy
+* module, then `__UNIVERSAL_DATA_FOR_REHYDRATION__`. Throws propagate to the
+* chain, which records them and moves on — never a dead end.
+*/
+function createPageSource() {
+	return {
+		id: "page",
+		async find(ctx) {
+			let sigi = null;
+			let html = "";
+			let failure = null;
+			const take = (candidate) => {
+				if (candidate.kind === "room" || candidate.kind === "denied") return candidate;
+				if (candidate.kind === "failed") failure ??= candidate;
+				return null;
+			};
+			const page = await ctx.fetchPage(ctx.user, "/live");
+			if (!page) {
+				ctx.debug("fetchLiveInfo: all domains blocked for /live page");
+				html = "";
+			} else {
+				html = page.html;
+				ctx.debug(`fetchLiveInfo: /live returned ${html.length} bytes (${page.baseUrl}), first 300: ${html.slice(0, 300).replace(/\n/g, "\\n")}`);
+				sigi = extractSigiState(html);
+				ctx.debug(`fetchLiveInfo: SIGI_STATE ${sigi ? "found" : "not found"}`);
+				if (sigi) {
+					const liveRoom = sigi.LiveRoom?.liveRoomUserInfo?.liveRoom;
+					const userInfo = sigi.LiveRoom?.liveRoomUserInfo?.user;
+					ctx.debug(`fetchLiveInfo: liveRoom=${!!liveRoom}, userInfo=${!!userInfo}, userInfo.roomId=${userInfo?.roomId ?? "null"}`);
+					if (liveRoom && userInfo?.roomId) {
+						const room = {
+							id: String(userInfo.roomId),
+							title: liveRoom.title ?? null,
+							live: liveRoom.status === 2
+						};
+						ctx.debug(`fetchLiveInfo: primary path — roomId=${room.id}, status=${liveRoom.status}, live=${room.live}`);
+						if (!room.live) return {
+							kind: "room",
+							room,
+							stream: null,
+							source: "sigi"
+						};
+						return withStream(ctx, room, "sigi", extractStreamUrlFast(liveRoom) ?? findStreamUrlRecursively(sigi));
+					}
+					if (userInfo?.roomId) {
+						const roomId = String(userInfo.roomId);
+						ctx.debug(`fetchLiveInfo: userInfo fallback — roomId=${roomId}, querying Webcast API`);
+						const found = take(await fromRoomInfo(ctx, roomId, "room-info"));
+						ctx.debug(`fetchLiveInfo: Webcast API ${found ? "returned room info" : "returned null"}`);
+						if (found) return found;
+					}
+					ctx.debug("fetchLiveInfo: trying legacy fallback (UserModule)");
+					const legacy = take(await sigiLegacy(sigi, ctx));
+					ctx.debug(`fetchLiveInfo: legacy fallback ${legacy ? "succeeded" : "returned null"}`);
+					if (legacy) return legacy;
+				}
+			}
+			ctx.debug(`fetchLiveInfo: trying universal data fallback (html length ${html.length})`);
+			const { roomId } = extractUserFromUniversalData(html);
+			ctx.debug(`fetchLiveInfo: universal data roomId=${roomId ?? "null"}`);
+			if (roomId) {
+				const found = take(await fromRoomInfo(ctx, roomId, "room-info"));
+				ctx.debug(`fetchLiveInfo: universal data Webcast API ${found ? "succeeded" : "returned null"}`);
+				if (found) return found;
+			}
+			return failure ?? miss("page: no room id");
+		}
+	};
+}
+/**
+* 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 comes from the
+* Webcast API (room/info/) as a final fallback.
+*/
+async function sigiLegacy(sigi, ctx) {
+	const isLive = sigi.LiveRoom?.liveRoomStatus === 2;
+	const userModule = sigi.UserModule?.users?.[ctx.user];
+	let roomId = null;
+	if (userModule?.roomId) roomId = typeof userModule.roomId === "object" ? String(userModule.roomId.id ?? "") : String(userModule.roomId);
+	if (!roomId) return miss("sigi-legacy: no roomId");
+	const room = {
+		id: roomId,
+		title: null,
+		live: isLive
+	};
+	if (!isLive) return {
+		kind: "room",
+		room,
+		stream: null,
+		source: "sigi"
+	};
+	return withStream(ctx, room, "sigi", null);
+}
+//#endregion
+export { createPageSource };
+
+//# sourceMappingURL=page.mjs.map

package/dist/io/tiktok/discovery/page.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.mjs","names":[],"sources":["../../../../src/io/tiktok/discovery/page.ts"],"sourcesContent":["import type { RoomRef } from \"../../../core/verdict\"\nimport type { SigiState } from \"../parse\"\nimport {\n  extractSigiState,\n  extractStreamUrlFast,\n  extractUserFromUniversalData,\n  findStreamUrlRecursively,\n} from \"../parse\"\nimport {\n  type Candidate,\n  type DiscoverySource,\n  fromRoomInfo,\n  miss,\n  type ResolveContext,\n  withStream,\n} from \"./chain\"\n\n/**\n * Page source: server-rendered SIGI_STATE first, then the async-loaded legacy\n * module, then `__UNIVERSAL_DATA_FOR_REHYDRATION__`. Throws propagate to the\n * chain, which records them and moves on — never a dead end.\n */\nexport function createPageSource(): DiscoverySource {\n  return {\n    id: \"page\",\n    async find(ctx: ResolveContext): Promise<Candidate> {\n      let sigi: SigiState | null = null\n      let html = \"\"\n      // A `failed` sub-step is not terminal: legacy + universal-data fallbacks\n      // still get their chance. It is returned only if nothing else hit.\n      let failure: Extract<Candidate, { kind: \"failed\" }> | null = null\n      const take = (candidate: Candidate): Candidate | null => {\n        if (candidate.kind === \"room\" || candidate.kind === \"denied\") return candidate\n        if (candidate.kind === \"failed\") failure ??= candidate\n        return null\n      }\n\n      const page = await ctx.fetchPage(ctx.user, \"/live\")\n      if (!page) {\n        ctx.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        ctx.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        ctx.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          ctx.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 room: RoomRef = {\n              id: String(userInfo.roomId),\n              title: liveRoom.title ?? null,\n              live: liveRoom.status === 2, // 2 = live, 4 = offline\n            }\n            ctx.debug(\n              `fetchLiveInfo: primary path — roomId=${room.id}, status=${liveRoom.status}, live=${room.live}`,\n            )\n            if (!room.live) return { kind: \"room\", room, stream: null, source: \"sigi\" }\n\n            // Extract stream URL: try SIGI_STATE first, then Webcast API fallback\n            const knownUrl = extractStreamUrlFast(liveRoom) ?? findStreamUrlRecursively(sigi)\n            return withStream(ctx, room, \"sigi\", knownUrl)\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            ctx.debug(`fetchLiveInfo: userInfo fallback — roomId=${roomId}, querying Webcast API`)\n            const found = take(await fromRoomInfo(ctx, roomId, \"room-info\"))\n            ctx.debug(\n              `fetchLiveInfo: Webcast API ${found ? \"returned room info\" : \"returned null\"}`,\n            )\n            if (found) return found\n          }\n\n          // ── Legacy fallback: async-loaded SIGI_STATE ──\n          ctx.debug(\"fetchLiveInfo: trying legacy fallback (UserModule)\")\n          const legacy = take(await sigiLegacy(sigi, ctx))\n          ctx.debug(`fetchLiveInfo: legacy fallback ${legacy ? \"succeeded\" : \"returned null\"}`)\n          if (legacy) return legacy\n        } // end if (sigi)\n      } // end else (page loaded)\n\n      // ── Universal data from the already-fetched /live html ──\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      ctx.debug(`fetchLiveInfo: trying universal data fallback (html length ${html.length})`)\n      const { roomId } = extractUserFromUniversalData(html)\n      ctx.debug(`fetchLiveInfo: universal data roomId=${roomId ?? \"null\"}`)\n      if (roomId) {\n        const found = take(await fromRoomInfo(ctx, roomId, \"room-info\"))\n        ctx.debug(\n          `fetchLiveInfo: universal data Webcast API ${found ? \"succeeded\" : \"returned null\"}`,\n        )\n        if (found) return found\n      }\n      return failure ?? miss(\"page: no room id\")\n    },\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 comes from the\n * Webcast API (room/info/) as a final fallback.\n */\nasync function sigiLegacy(sigi: SigiState, ctx: ResolveContext): Promise<Candidate> {\n  const isLive = sigi.LiveRoom?.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?.[ctx.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  // No roomId available — treat as offline (room/enter was unreliable).\n  if (!roomId) return miss(\"sigi-legacy: no roomId\")\n\n  const room: RoomRef = { id: roomId, title: null, live: isLive }\n  if (!isLive) return { kind: \"room\", room, stream: null, source: \"sigi\" }\n  return withStream(ctx, room, \"sigi\", null)\n}\n"],"mappings":"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"}

package/dist/io/tiktok/page.mjs

@@ -0,0 +1,34 @@
+//#region src/io/tiktok/page.ts
+const TIKTOK_BASES = ["https://www.tiktok.com", "https://m.tiktok.com"];
+function createPageFetcher(http, debug, signal) {
+	/**
+	* 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, signal);
+			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;
+	}
+	return tryFetchPage;
+}
+//#endregion
+export { createPageFetcher };
+
+//# sourceMappingURL=page.mjs.map

package/dist/io/tiktok/page.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.mjs","names":[],"sources":["../../../src/io/tiktok/page.ts"],"sourcesContent":["import type { HttpClient } from \"../http\"\n\nconst TIKTOK_BASES = [\"https://www.tiktok.com\", \"https://m.tiktok.com\"]\n\nexport function createPageFetcher(\n  http: HttpClient,\n  debug: (msg: string) => void,\n  signal?: AbortSignal,\n): (user: string, path: string) => Promise<{ html: string; baseUrl: string } | null> {\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, signal)\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  return tryFetchPage\n}\n"],"mappings":";AAEA,MAAM,eAAe,CAAC,0BAA0B,sBAAsB;AAEtE,SAAgB,kBACd,MACA,OACA,QACmF;;;;;;;CAOnF,eAAe,aACb,MACA,MACmD;EACnD,KAAK,MAAM,QAAQ,cAAc;GAC/B,MAAM,MAAM,GAAG,KAAK,IAAI,OAAO;GAC/B,MAAM,MAAM,MAAM,KAAK,IAAI,KAAK,MAAM;GACtC,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,OAAO;AACT"}

package/dist/io/tiktok/parse.mjs

@@ -0,0 +1,110 @@
+//#region src/io/tiktok/parse.ts
+/**
+* @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 { extractSigiState, extractStreamUrlFast, extractUserFromUniversalData, findStreamUrlRecursively };
+
+//# sourceMappingURL=parse.mjs.map

package/dist/io/tiktok/parse.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.mjs","names":[],"sources":["../../../src/io/tiktok/parse.ts"],"sourcesContent":["export interface 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 */\nexport function 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":";;;;AAoCA,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,SAAgB,qBACd,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/io/tiktok/webcast.mjs

@@ -0,0 +1,132 @@
+import { findStreamUrlRecursively } from "./parse.mjs";
+//#region src/io/tiktok/webcast.ts
+const WEBCAST_BASE = "https://webcast.tiktok.com";
+function createWebcastApi(http, debug, signal) {
+	/**
+	* 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(roomId, extract) {
+		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);
+			if (data.status_code === 4003110) return {
+				ok: false,
+				statusCode: 4003110,
+				body: text
+			};
+			return {
+				ok: true,
+				value: extract(data)
+			};
+		} catch {
+			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) {
+		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 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;
+		}
+	}
+	/**
+	* 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, title) {
+		debug(`refusedRoom: room/info refused roomId=${roomId} (status_code 4003110)`);
+		return {
+			id: roomId,
+			title,
+			live: await fetchCheckAlive(roomId)
+		};
+	}
+	/**
+	* 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) {
+		const res = await fetchFromRoomApi(roomId, (data) => data.data ?? null);
+		if (!res.ok) return res;
+		const roomData = res.value;
+		if (!roomData) return {
+			ok: true,
+			value: null
+		};
+		const title = roomData.title ?? 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) {
+		return fetchFromRoomApi(roomId, (data) => findStreamUrlRecursively(data));
+	}
+	return {
+		fetchFromRoomApi,
+		fetchCheckAlive,
+		fetchStreamUrlFromApi,
+		roomInfo,
+		refusedRoom
+	};
+}
+//#endregion
+export { createWebcastApi };
+
+//# sourceMappingURL=webcast.mjs.map

package/dist/io/tiktok/webcast.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webcast.mjs","names":[],"sources":["../../../src/io/tiktok/webcast.ts"],"sourcesContent":["import type { RoomRef, StreamRef } from \"../../core/verdict\"\nimport type { HttpClient } from \"../http\"\nimport { findStreamUrlRecursively } from \"./parse\"\n\nconst WEBCAST_BASE = \"https://webcast.tiktok.com\"\n\n/**\n * Discriminated room/info result: refusals (notably status_code 4003110)\n * and transport failures surface as `{ ok: false }` instead of null.\n * `statusCode: 0` means the request threw before a status was read.\n */\nexport type RoomApiResult<T> =\n  | { ok: true; value: T | null }\n  | { ok: false; statusCode: number; body: string }\n\n/** Authoritative room/info facts: the room plus its stream URL when present. */\nexport interface RoomFacts {\n  readonly room: RoomRef\n  readonly stream: StreamRef | null\n}\n\n/** What discovery sources consume. `createWebcastApi` is the only implementation. */\nexport interface WebcastReader {\n  fetchFromRoomApi: <T>(\n    roomId: string,\n    extract: (data: Record<string, unknown>) => T | null,\n  ) => Promise<RoomApiResult<T>>\n  fetchCheckAlive: (roomId: string) => Promise<boolean>\n  fetchStreamUrlFromApi: (roomId: string) => Promise<RoomApiResult<string>>\n  /** room/info as domain facts; 4003110 comes back as `{ ok: false }`. */\n  roomInfo: (roomId: string) => Promise<RoomApiResult<RoomFacts>>\n  /** Resolve a 4003110 refusal: alive → restricted candidate, else offline. */\n  refusedRoom: (roomId: string, title: string | null) => Promise<RoomRef>\n}\n\nexport function createWebcastApi(\n  http: HttpClient,\n  debug: (msg: string) => void,\n  signal?: AbortSignal,\n): WebcastReader {\n  /**\n   * Shared boilerplate for Webcast room/info API calls.\n   * Handles URL construction, HTTP GET, JSON parsing, and error handling.\n   * Room-gate refusals (status_code 4003110) are reported to the caller\n   * instead of being collapsed into null; callers map failures.\n   * 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<RoomApiResult<T>> {\n    try {\n      const url = `${WEBCAST_BASE}/webcast/room/info/?aid=1988&room_id=${roomId}&type=live`\n      const res = await http.get(url, signal)\n      debug(`fetchFromRoomApi: roomId=${roomId} status=${res.status}, ok=${res.ok}`)\n      if (!res.ok) return { ok: false, statusCode: res.status, body: \"\" }\n\n      const text = await res.text()\n      debug(`fetchFromRoomApi: roomId=${roomId} returned ${text.length} bytes`)\n      if (text.length === 0) return { ok: true, value: null }\n\n      const data = JSON.parse(text) as Record<string, unknown>\n\n      // status_code 4003110 = age-protected/restricted room: report it\n      if ((data as { status_code?: unknown }).status_code === 4003110) {\n        return { ok: false, statusCode: 4003110, body: text }\n      }\n\n      return { ok: true, value: extract(data) }\n    } catch {\n      // statusCode 0 = transport/parse failure before a status was available.\n      return { ok: false, statusCode: 0, body: \"\" }\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, signal)\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   * Resolve a 4003110 room-gate refusal via check_alive: the room is live\n   * (restricted) when alive, offline otherwise. Single home for this mapping.\n   */\n  async function refusedRoom(roomId: string, title: string | null): Promise<RoomRef> {\n    debug(`refusedRoom: room/info refused roomId=${roomId} (status_code 4003110)`)\n    const live = await fetchCheckAlive(roomId)\n    return { id: roomId, title, live }\n  }\n\n  /**\n   * Fetch room/info as domain facts. Requires a known roomId. A 4003110\n   * refusal stays `{ ok: false, statusCode: 4003110 }` for the caller to map\n   * via `refusedRoom`.\n   */\n  async function roomInfo(roomId: string): Promise<RoomApiResult<RoomFacts>> {\n    const res = await fetchFromRoomApi<Record<string, unknown>>(\n      roomId,\n      (data) => (data as { data?: Record<string, unknown> }).data ?? null,\n    )\n    if (!res.ok) return res\n    const roomData = res.value\n    if (!roomData) return { ok: true, value: null }\n\n    const title = (roomData.title as string | undefined) ?? null\n    const streamUrl = findStreamUrlRecursively(roomData)\n    return {\n      ok: true,\n      value: {\n        room: { id: roomId, title, live: (roomData.status ?? 4) === 2 },\n        stream: streamUrl ? { url: streamUrl } : null,\n      },\n    }\n  }\n\n  /**\n   * Fetch stream URL from the Webcast API.\n   * Covers cases where SIGI_STATE doesn't include stream data.\n   * Refusals (4003110) and transport failures are reported so callers\n   * can distinguish restricted rooms from missing URLs.\n   */\n  async function fetchStreamUrlFromApi(roomId: string): Promise<RoomApiResult<string>> {\n    return fetchFromRoomApi(roomId, (data) => findStreamUrlRecursively(data))\n  }\n\n  return {\n    fetchFromRoomApi,\n    fetchCheckAlive,\n    fetchStreamUrlFromApi,\n    roomInfo,\n    refusedRoom,\n  }\n}\n"],"mappings":";;AAIA,MAAM,eAAe;AA+BrB,SAAgB,iBACd,MACA,OACA,QACe;;;;;;;;CAQf,eAAe,iBACb,QACA,SAC2B;EAC3B,IAAI;GACF,MAAM,MAAM,GAAG,aAAa,uCAAuC,OAAO;GAC1E,MAAM,MAAM,MAAM,KAAK,IAAI,KAAK,MAAM;GACtC,MAAM,4BAA4B,OAAO,UAAU,IAAI,OAAO,OAAO,IAAI,IAAI;GAC7E,IAAI,CAAC,IAAI,IAAI,OAAO;IAAE,IAAI;IAAO,YAAY,IAAI;IAAQ,MAAM;GAAG;GAElE,MAAM,OAAO,MAAM,IAAI,KAAK;GAC5B,MAAM,4BAA4B,OAAO,YAAY,KAAK,OAAO,OAAO;GACxE,IAAI,KAAK,WAAW,GAAG,OAAO;IAAE,IAAI;IAAM,OAAO;GAAK;GAEtD,MAAM,OAAO,KAAK,MAAM,IAAI;GAG5B,IAAK,KAAmC,gBAAgB,SACtD,OAAO;IAAE,IAAI;IAAO,YAAY;IAAS,MAAM;GAAK;GAGtD,OAAO;IAAE,IAAI;IAAM,OAAO,QAAQ,IAAI;GAAE;EAC1C,QAAQ;GAEN,OAAO;IAAE,IAAI;IAAO,YAAY;IAAG,MAAM;GAAG;EAC9C;CACF;;;;;;;;;;;CAYA,eAAe,gBAAgB,QAAkC;EAC/D,IAAI;GACF,MAAM,MAAM,GAAG,aAAa,yDAAyD,OAAO;GAC5F,MAAM,MAAM,MAAM,KAAK,IAAI,KAAK,MAAM;GACtC,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;;;;;CAMA,eAAe,YAAY,QAAgB,OAAwC;EACjF,MAAM,yCAAyC,OAAO,uBAAuB;EAE7E,OAAO;GAAE,IAAI;GAAQ;GAAO,MAAA,MADT,gBAAgB,MAAM;EACR;CACnC;;;;;;CAOA,eAAe,SAAS,QAAmD;EACzE,MAAM,MAAM,MAAM,iBAChB,SACC,SAAU,KAA4C,QAAQ,IACjE;EACA,IAAI,CAAC,IAAI,IAAI,OAAO;EACpB,MAAM,WAAW,IAAI;EACrB,IAAI,CAAC,UAAU,OAAO;GAAE,IAAI;GAAM,OAAO;EAAK;EAE9C,MAAM,QAAS,SAAS,SAAgC;EACxD,MAAM,YAAY,yBAAyB,QAAQ;EACnD,OAAO;GACL,IAAI;GACJ,OAAO;IACL,MAAM;KAAE,IAAI;KAAQ;KAAO,OAAO,SAAS,UAAU,OAAO;IAAE;IAC9D,QAAQ,YAAY,EAAE,KAAK,UAAU,IAAI;GAC3C;EACF;CACF;;;;;;;CAQA,eAAe,sBAAsB,QAAgD;EACnF,OAAO,iBAAiB,SAAS,SAAS,yBAAyB,IAAI,CAAC;CAC1E;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;CACF;AACF"}

package/package.json

@@ -1,51 +1,30 @@
 {
   "name": "@zfadhli/tokrec",
-  "version": "0.12.2",
+  "version": "0.15.0",
   "description": "Minimal TikTok live stream recorder — Bun + TypeScript",
   "type": "module",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {
     ".": {
+      "bun": "./src/index.ts",
       "types": "./dist/index.d.mts",
       "default": "./dist/index.mjs"
-    },
-    "./cli": {
-      "types": "./dist/bin.d.mts",
-      "default": "./dist/bin.mjs"
     }
   },
-  "bin": {
-    "tokrec": "./dist/bin.mjs"
-  },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "scripts": {
-    "dev": "bun run src/bin.ts",
     "build": "tsdown",
-    "typecheck": "tsc --noEmit",
-    "test": "bun test",
-    "lint": "biome check src/",
-    "lint:fix": "biome check --write src/",
-    "format": "biome format --write src/"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@zfadhli/koko-cli": "^0.2.1",
     "execa": "^9.6.1",
     "peaknorm": "^0.7.0",
     "wreq-js": "^2.3.1"
   },
-  "devDependencies": {
-    "@biomejs/biome": "^2.5.0",
-    "@types/bun": "latest",
-    "lefthook": "^2.1.9",
-    "tsdown": "^0.22.3",
-    "typescript": "^6.0.3"
-  },
-  "engines": {
-    "bun": ">=1.2"
-  },
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/app/abort.ts

@@ -0,0 +1,18 @@
+/**
+ * One cancellation scope per recorder run. Everything that can block accepts
+ * `scope.signal`; `close()` aborts in-flight work immediately.
+ */
+
+export interface AbortScope {
+  readonly signal: AbortSignal
+  close(reason?: string): void
+}
+
+export function abortScope(parent?: AbortSignal): AbortScope {
+  const controller = new AbortController()
+  if (parent) {
+    if (parent.aborted) controller.abort(parent.reason)
+    else parent.addEventListener("abort", () => controller.abort(parent.reason), { once: true })
+  }
+  return { signal: controller.signal, close: (reason) => controller.abort(reason) }
+}