@zfadhli/tokrec 0.11.3 → 0.11.5

package/dist/api/tiktok.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tiktok.mjs","names":[],"sources":["../../src/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 \"../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 any).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 any).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 ?? 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 any).__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]!\n  if (m3u8Urls.length > 0) return m3u8Urls[0]!\n  return null\n}\n"],"mappings":"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"}

package/dist/browser-cookies.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser-cookies.mjs","names":[],"sources":["../src/browser-cookies.ts"],"sourcesContent":["/**\n * Browser cookie extraction — reads TikTok session cookies from Firefox's\n * cookie store using bun:sqlite (no external dependencies).\n *\n * Falls back to cookies.json if Firefox isn't available or if no TikTok\n * login session is found.\n */\n\nimport { Database } from \"bun:sqlite\"\nimport { existsSync, readdirSync, readFileSync } from \"node:fs\"\nimport { homedir } from \"node:os\"\nimport { join } from \"node:path\"\n\n/**\n * Extract TikTok session cookies from Firefox's cookie store.\n *\n * Queries ALL cookies for TikTok domains from Firefox, including the\n * Slardar WAF challenge cookie which is needed to bypass bot detection.\n *\n * Returns null if Firefox isn't found, cookies can't be read, or no\n * sessionid_ss cookie exists (without which the session is useless).\n */\nexport function extractTikTokCookiesFromFirefox(): Record<string, string> | null {\n  const dbPath = findFirefoxCookieDb()\n  if (!dbPath) return null\n\n  try {\n    const db = new Database(dbPath, { readonly: true })\n    try {\n      const rows = db\n        .query(\n          `SELECT name, value FROM moz_cookies\n           WHERE host LIKE '%.tiktok.com' OR host LIKE '%.tiktokv.com'`,\n        )\n        .all() as Array<{ name: string; value: string }>\n\n      // Require sessionid_ss — without it the session is useless\n      const hasSession = rows.some((r) => r.name === \"sessionid_ss\")\n      if (!hasSession) return null\n\n      const cookies: Record<string, string> = {}\n      for (const row of rows) {\n        cookies[row.name] = row.value\n      }\n      return cookies\n    } finally {\n      db.close()\n    }\n  } catch {\n    return null\n  }\n}\n\n/**\n * Locate the Firefox cookies.sqlite by scanning profile directories.\n *\n * Strategy:\n *   1. Check ~/.mozilla/firefox/ for profiles.ini and parse the default profile.\n *   2. Fall back to scanning directory entries that look like Firefox profiles\n *      (contain a cookies.sqlite file).\n */\n/** @public Exported for testing */\nexport function findFirefoxCookieDb(): string | null {\n  const firefoxDir = join(homedir(), \".mozilla\", \"firefox\")\n  if (!existsSync(firefoxDir)) return null\n\n  // Try profiles.ini first for a reliable default-profile path\n  const iniPath = join(firefoxDir, \"profiles.ini\")\n  if (existsSync(iniPath)) {\n    try {\n      const profilePath = parseFirefoxProfilesIni(iniPath, firefoxDir)\n      if (profilePath) {\n        const dbPath = join(profilePath, \"cookies.sqlite\")\n        if (existsSync(dbPath)) return dbPath\n      }\n    } catch {\n      // fall through to directory scan\n    }\n  }\n\n  // Fallback: scan for any directory containing cookies.sqlite\n  const entries = readdirSync(firefoxDir, { withFileTypes: true })\n  for (const entry of entries) {\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue\n    const dbPath = join(firefoxDir, entry.name, \"cookies.sqlite\")\n    if (existsSync(dbPath)) return dbPath\n  }\n\n  return null\n}\n\n/**\n * Parse Firefox's profiles.ini to find the default profile path.\n *\n * The INI format looks like:\n *   [Profile0]\n *   Name=default\n *   IsRelative=1\n *   Path=1pese0rl.default-release\n *   Default=1\n */\n/** @public Exported for testing */\nexport function parseFirefoxProfilesIni(iniPath: string, firefoxDir: string): string | null {\n  const text = readFileSync(iniPath, \"utf-8\")\n\n  let defaultPath: string | null = null\n  let isRelative = true\n  let inProfile = false\n\n  for (const line of text.split(\"\\n\")) {\n    const trimmed = line.trim()\n\n    // Section header\n    if (trimmed.startsWith(\"[\") && trimmed.endsWith(\"]\")) {\n      if (inProfile && defaultPath) break // found it\n      inProfile = trimmed.toLowerCase().startsWith(\"[profile\")\n      if (inProfile) {\n        defaultPath = null\n        isRelative = true\n      }\n      continue\n    }\n\n    if (!inProfile) continue\n\n    const lower = trimmed.toLowerCase()\n    if (lower.startsWith(\"path=\")) {\n      defaultPath = trimmed.slice(5)\n    } else if (lower.startsWith(\"isrelative=\")) {\n      isRelative = trimmed.slice(11).trim() !== \"0\"\n    } else if (lower.startsWith(\"default=\")) {\n      if (trimmed.slice(8).trim() !== \"1\") {\n        // Not the default profile — skip\n        inProfile = false\n        defaultPath = null\n      }\n    }\n  }\n\n  if (!defaultPath) return null\n  return isRelative ? join(firefoxDir, defaultPath) : defaultPath\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,kCAAiE;CAC/E,MAAM,SAAS,oBAAoB;CACnC,IAAI,CAAC,QAAQ,OAAO;CAEpB,IAAI;EACF,MAAM,KAAK,IAAI,SAAS,QAAQ,EAAE,UAAU,KAAK,CAAC;EAClD,IAAI;GACF,MAAM,OAAO,GACV,MACC;uEAEF,CAAC,CACA,IAAI;GAIP,IAAI,CADe,KAAK,MAAM,MAAM,EAAE,SAAS,cACjC,GAAG,OAAO;GAExB,MAAM,UAAkC,CAAC;GACzC,KAAK,MAAM,OAAO,MAChB,QAAQ,IAAI,QAAQ,IAAI;GAE1B,OAAO;EACT,UAAU;GACR,GAAG,MAAM;EACX;CACF,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;;;AAWA,SAAgB,sBAAqC;CACnD,MAAM,aAAa,KAAK,QAAQ,GAAG,YAAY,SAAS;CACxD,IAAI,CAAC,WAAW,UAAU,GAAG,OAAO;CAGpC,MAAM,UAAU,KAAK,YAAY,cAAc;CAC/C,IAAI,WAAW,OAAO,GACpB,IAAI;EACF,MAAM,cAAc,wBAAwB,SAAS,UAAU;EAC/D,IAAI,aAAa;GACf,MAAM,SAAS,KAAK,aAAa,gBAAgB;GACjD,IAAI,WAAW,MAAM,GAAG,OAAO;EACjC;CACF,QAAQ,CAER;CAIF,MAAM,UAAU,YAAY,YAAY,EAAE,eAAe,KAAK,CAAC;CAC/D,KAAK,MAAM,SAAS,SAAS;EAC3B,IAAI,CAAC,MAAM,YAAY,KAAK,CAAC,MAAM,eAAe,GAAG;EACrD,MAAM,SAAS,KAAK,YAAY,MAAM,MAAM,gBAAgB;EAC5D,IAAI,WAAW,MAAM,GAAG,OAAO;CACjC;CAEA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,wBAAwB,SAAiB,YAAmC;CAC1F,MAAM,OAAO,aAAa,SAAS,OAAO;CAE1C,IAAI,cAA6B;CACjC,IAAI,aAAa;CACjB,IAAI,YAAY;CAEhB,KAAK,MAAM,QAAQ,KAAK,MAAM,IAAI,GAAG;EACnC,MAAM,UAAU,KAAK,KAAK;EAG1B,IAAI,QAAQ,WAAW,GAAG,KAAK,QAAQ,SAAS,GAAG,GAAG;GACpD,IAAI,aAAa,aAAa;GAC9B,YAAY,QAAQ,YAAY,CAAC,CAAC,WAAW,UAAU;GACvD,IAAI,WAAW;IACb,cAAc;IACd,aAAa;GACf;GACA;EACF;EAEA,IAAI,CAAC,WAAW;EAEhB,MAAM,QAAQ,QAAQ,YAAY;EAClC,IAAI,MAAM,WAAW,OAAO,GAC1B,cAAc,QAAQ,MAAM,CAAC;OACxB,IAAI,MAAM,WAAW,aAAa,GACvC,aAAa,QAAQ,MAAM,EAAE,CAAC,CAAC,KAAK,MAAM;OACrC,IAAI,MAAM,WAAW,UAAU;OAChC,QAAQ,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,KAAK;IAEnC,YAAY;IACZ,cAAc;GAChB;;CAEJ;CAEA,IAAI,CAAC,aAAa,OAAO;CACzB,OAAO,aAAa,KAAK,YAAY,WAAW,IAAI;AACtD"}

package/dist/cli.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.mjs","names":["pkg.version"],"sources":["../src/cli.ts"],"sourcesContent":["/**\n * CLI argument parser — uses koko-cli's createCLI (wraps cac).\n * Exports a single parseArgs() function.\n */\n\nimport { createCLI } from \"@zfadhli/koko-cli\"\nimport pkg from \"../package.json\"\nimport type { LogLevel, RecorderConfig } from \"./config\"\nimport { TikTokError } from \"./config\"\nimport { sanitizeUser } from \"./utils\"\n\nexport function parseArgs(argv: string[] = process.argv): RecorderConfig {\n  let config: RecorderConfig | undefined\n  let error: string | undefined\n\n  const cli = createCLI(\"tokrec\", pkg.version).description(\n    \"Minimal TikTok live stream recorder — Bun + TypeScript\",\n  )\n\n  cli.command(\"\", \"Record a TikTok live stream\", (cmd) => {\n    cmd.option(\"-u, --user <name>\", \"TikTok username (or pass as first argument)\")\n    cmd.option(\"-o, --output <dir>\", \"Output directory\", {\n      default: \"./recordings\",\n    })\n    cmd.option(\"-i, --interval <minutes>\", \"Polling interval in minutes\", {\n      default: \"3\",\n    })\n    cmd.option(\"-d, --duration <minutes>\", \"Max recording duration in minutes\")\n    cmd.option(\"-p, --proxy <url>\", \"HTTP proxy (e.g. http://127.0.0.1:8080)\")\n    cmd.option(\"-l, --log-level <level>\", \"Log level: debug | info | warn | error\")\n    cmd.option(\"-c, --cookies <path>\", \"Path to cookies.json\")\n    cmd.option(\n      \"-s, --segment-minutes <minutes>\",\n      \"Segment duration in minutes (default: disabled). Split recording into segments of this length.\",\n    )\n    cmd.option(\"--normalize\", \"Normalize audio loudness (EBU R128)\")\n    cmd.option(\"--normalize-loudness <num>\", \"Target loudness in LUFS (default: -14)\")\n    cmd.option(\"--normalize-codec <name>\", \"Audio codec for normalized output (default: libopus)\")\n    cmd.option(\"--normalize-bitrate <str>\", \"Audio bitrate for normalized output (default: 96k)\")\n    cmd.option(\"--rate <n>\", \"Max API requests per second (default: 5). Set 0 for unlimited.\")\n    cmd.option(\"--debug\", \"Show API debug logging on stderr for troubleshooting\")\n\n    cmd.action((opts: Record<string, unknown>) => {\n      try {\n        const user = opts.user as string | undefined\n        if (!user) {\n          throw new TikTokError(\"config-error\", \"<user> is required (positional or --user)\")\n        }\n\n        const parsed: RecorderConfig = {\n          user: sanitizeUser(user),\n        }\n\n        if (opts.output) parsed.outputDir = opts.output as string\n        if (opts.interval !== undefined) {\n          const n = Number(opts.interval)\n          if (!Number.isFinite(n) || n < 1) {\n            throw new TikTokError(\"config-error\", \"--interval must be a number >= 1\")\n          }\n          parsed.interval = n\n        }\n        if (opts.duration !== undefined) {\n          const n = Number(opts.duration)\n          if (!Number.isFinite(n) || n < 0) {\n            throw new TikTokError(\"config-error\", \"--duration must be a number >= 0 (minutes)\")\n          }\n          parsed.duration = n * 60\n        }\n        if (opts.proxy) parsed.proxy = opts.proxy as string\n        if (opts.logLevel) {\n          const levels = [\"debug\", \"info\", \"warn\", \"error\"]\n          if (!levels.includes(opts.logLevel as string)) {\n            throw new TikTokError(\n              \"config-error\",\n              `--log-level must be one of: ${levels.join(\", \")}`,\n            )\n          }\n          parsed.logLevel = opts.logLevel as LogLevel\n        }\n        if (opts.cookies) parsed.cookiesPath = opts.cookies as string\n        if (opts.segmentMinutes !== undefined) {\n          const n = Number(opts.segmentMinutes)\n          if (!Number.isFinite(n) || n < 0) {\n            throw new TikTokError(\"config-error\", \"--segment-minutes must be a number >= 0\")\n          }\n          parsed.segmentMinutes = n\n        }\n\n        if (opts.normalize !== undefined) parsed.normalizeAudio = opts.normalize as boolean\n        if (opts.normalizeLoudness !== undefined) {\n          const n = Number(opts.normalizeLoudness)\n          if (!Number.isFinite(n)) {\n            throw new TikTokError(\"config-error\", \"--normalize-loudness must be a number\")\n          }\n          parsed.normalizeLoudness = n\n        }\n        if (opts.normalizeCodec) parsed.normalizeCodec = opts.normalizeCodec as string\n        if (opts.normalizeBitrate) parsed.normalizeBitrate = opts.normalizeBitrate as string\n        if (opts.rate !== undefined) {\n          const n = Number(opts.rate)\n          if (!Number.isFinite(n) || n < 0) {\n            throw new TikTokError(\"config-error\", \"--rate must be a number >= 0\")\n          }\n          parsed.ratePerSecond = n\n        }\n        if (opts.debug) parsed.debug = true\n\n        config = parsed\n      } catch (err) {\n        error = err instanceof Error ? err.message : String(err)\n      }\n    })\n  })\n\n  // If the first bare argument (not a flag or flag value) looks like a username,\n  // convert it to --user for cac (which only handles options on the default command).\n  const positionalUser = extractPositional(argv)\n  if (positionalUser) {\n    argv.push(\"--user\", positionalUser)\n  }\n\n  cli.parse(argv)\n\n  if (error) {\n    throw new TikTokError(\"config-error\", error)\n  }\n\n  if (!config) {\n    throw new TikTokError(\n      \"config-error\",\n      \"<user> is required (positional or --user). Use --help for usage.\",\n    )\n  }\n\n  return config\n}\n\n/**\n * Scan argv for the first bare argument that is neither a flag nor a flag's value.\n * Returns the value and removes it from the array, or null if none found.\n */\nfunction extractPositional(argv: string[]): string | null {\n  for (let i = 2; i < argv.length; i++) {\n    const arg = argv[i]!\n    // -- signals end of options; anything after is a positional\n    if (arg === \"--\") {\n      const pos = argv.splice(i, 1)[0]!\n      return pos\n    }\n    // If this arg is a flag (-*) the next arg is its value\n    if (arg.startsWith(\"-\")) {\n      // Skip the value if this flag takes one (not a boolean flag like --help/--version)\n      const next = argv[i + 1]\n      if (next && !next.startsWith(\"-\") && arg !== \"--help\" && arg !== \"--version\") {\n        i++ // skip the value\n      }\n      continue\n    }\n    // Found a bare positional — remove it and return\n    argv.splice(i, 1)\n    return arg\n  }\n  return null\n}\n"],"mappings":"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"}

package/dist/config.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config.ts"],"mappings":";;AAUA;;;;AAAyB;AAEzB;;;KAFY,UAAA,GAAa,MAAA;AAAA,KAEb,QAAA;AAAA,UAEK,cAAA;EAAA;EAEf,IAAA;EAcW;EAZX,SAAA;;EAEA,QAAA;;EAEA,QAAA;;EAEA,KAAA;;EAEA,WAAA;;EAEA,OAAA,GAAU,UAAA;;EAEV,QAAA,GAAW,QAAA;;EAEX,UAAA;;EAEA,cAAA;;EAEA,cAAA;EAcA;EAZA,iBAAA;EAee;EAbf,cAAA;;EAEA,gBAAA;;;;;;EAMA,aAAA;;EAEA,KAAA;AAAA;AAAA,UAGe,kBAAA;EAUmE;EARlF,KAAA,IAAS,OAAA;;EAET,IAAA,IAAQ,OAAA;;EAER,SAAA,IAAa,cAAA;;EAEb,EAAA,iBAAmB,oBAAA,EAAsB,KAAA,EAAO,CAAA,EAAG,OAAA,EAAS,oBAAA,CAAqB,CAAA;;EAEjF,GAAA,iBAAoB,oBAAA,EAAsB,KAAA,EAAO,CAAA,EAAG,OAAA,EAAS,oBAAA,CAAqB,CAAA;AAAA;AAAA,UAGnE,cAAA;EACf,KAAA;EACA,IAAA;EACA,WAAA;EACA,eAAA;EACA,YAAA;EACA,SAAA;AAAA;AAAA,KAGU,aAAA,SAAsB,oBAAA;AAAA,UAEjB,oBAAA;EACf,QAAA,GAAW,IAAA;IAAQ,IAAA;EAAA;EACnB,IAAA,GAAO,IAAA;IAAQ,IAAA;IAAc,MAAA;IAAiB,MAAA;EAAA;EAC9C,iBAAA,GAAoB,IAAA;IAAQ,IAAA;IAAc,IAAA;EAAA;EAC1C,mBAAA,GAAsB,IAAA;IAAQ,KAAA;IAAe,OAAA;IAAiB,KAAA;EAAA;EAC9D,cAAA,GAAiB,IAAA;IAAQ,IAAA;IAAc,QAAA;IAAkB,IAAA;EAAA;EACzD,eAAA,GAAkB,IAAA;IAAQ,IAAA;IAAc,QAAA;IAAkB,IAAA;EAAA;EAC1D,kBAAA,GAAqB,IAAA;IAAQ,KAAA;IAAe,aAAA;EAAA;EAC5C,gBAAA,GAAmB,IAAA;IAAQ,QAAA;EAAA;EAC3B,kBAAA,GAAqB,IAAA;IAAQ,KAAA;EAAA;EAC7B,SAAA,GAAY,IAAA;IAAQ,KAAA;IAAe,MAAA;EAAA;EACnC,iBAAA,GAAoB,IAAA;IAAQ,IAAA;EAAA;EAC5B,oBAAA,GAAuB,IAAA;IACrB,IAAA;IACA,OAAA;IACA,KAAA;EAAA;EAEF,eAAA,GAAkB,IAAA;IAAQ,KAAA;IAAe,MAAA;EAAA;EACzC,iBAAA,GAAoB,IAAA;IAAQ,KAAA;IAAe,KAAA;EAAA;EAC3C,KAAA,GAAQ,GAAA,EAAK,WAAA;AAAA;AAAA,KAGH,YAAA;AAAA,cAaC,WAAA,SAAoB,KAAA;EAAA,SAE7B,IAAA,EAAsB,YAAA;EAAA,kBAEtB,KAAA;EAHF,WAAA,CACE,IAAA,EAAsB,YAAA,EACtB,OAAA,UACA,KAAA;AAAA"}

package/dist/config.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["/**\n * Config — types, defaults, and normalization for the recorder.\n * The single source of truth for every user-facing option.\n */\n\n/**\n * TikTok cookie key-value pairs extracted from Firefox or cookies.json.\n * Includes session cookies (sessionid_ss, tt-target-idc) and any WAF\n * bypass cookies needed to avoid Slardar challenges on www.tiktok.com.\n */\nexport type CookieAuth = Record<string, string>\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\"\n\nexport interface RecorderConfig {\n  /** TikTok username (required) */\n  user: string\n  /** Output directory for recordings (default: ./recordings) */\n  outputDir?: string\n  /** Polling interval in minutes (default: 3) */\n  interval?: number\n  /** Max recording duration in seconds (default: 0 — unlimited). CLI accepts minutes, converted internally. */\n  duration?: number\n  /** HTTP proxy URL (e.g. http://127.0.0.1:8080) */\n  proxy?: string\n  /** Path to cookies.json (default: ./cookies.json) */\n  cookiesPath?: string\n  /** Cookie auth loaded from cookies.json */\n  cookies?: CookieAuth\n  /** Log level (default: info) */\n  logLevel?: LogLevel\n  /** Whether to print logs to console (default: true). Set false when using Display-based UI. */\n  logConsole?: boolean\n  /** Segment duration in minutes (default: 0 — disabled). When >= 1, the recording is split into segments of this length. */\n  segmentMinutes?: number\n  /** Normalize audio loudness via EBU R128 (default: false). */\n  normalizeAudio?: boolean\n  /** Target loudness in LUFS (default: -14). */\n  normalizeLoudness?: number\n  /** Audio codec for normalized output (default: peaknorm's default, \"libopus\"). */\n  normalizeCodec?: string\n  /** Audio bitrate for normalized output (default: peaknorm's default, \"96k\"). */\n  normalizeBitrate?: string\n  /**\n   * Max API requests per second (default: 5).\n   * Prevents TikTok WAF triggering on rapid polling or URL refresh loops.\n   * Set to 0 for unlimited (not recommended).\n   */\n  ratePerSecond?: number\n  /** Show API debug logging on stderr (default: false). */\n  debug?: boolean\n}\n\nexport interface RecorderController {\n  /** Start the polling loop */\n  start(): Promise<void>\n  /** Gracefully stop (joins active recording, then exits) */\n  stop(): Promise<void>\n  /** Snapshot of current state */\n  getStatus(): RecorderStatus\n  /** Subscribe to events */\n  on<E extends keyof RecorderEventHandler>(event: E, handler: RecorderEventHandler[E]): void\n  /** Unsubscribe a previously registered event handler */\n  off<E extends keyof RecorderEventHandler>(event: E, handler: RecorderEventHandler[E]): void\n}\n\nexport interface RecorderStatus {\n  state: \"idle\" | \"polling\" | \"recording\" | \"converting\" | \"stopped\"\n  user: string\n  currentFile?: string\n  sessionDuration?: number\n  lastPollTime?: string\n  lastError?: string\n}\n\nexport type RecorderEvent = keyof RecorderEventHandler\n\nexport interface RecorderEventHandler {\n  checking: (info: { user: string }) => void\n  tick: (info: { user: string; isLive: boolean; roomId?: string }) => void\n  \"recording:start\": (info: { user: string; file: string }) => void\n  \"download:progress\": (info: { bytes: number; elapsed: number; speed: number }) => void\n  \"download:end\": (info: { file: string; duration: number; size: number }) => void\n  \"recording:end\": (info: { file: string; duration: number; size: number }) => void\n  \"segmenting:start\": (info: { input: string; outputPattern: string }) => void\n  \"segmenting:end\": (info: { segments: number }) => void\n  \"converting:start\": (info: { input: string }) => void\n  converted: (info: { input: string; output: string }) => void\n  \"normalize:start\": (info: { file: string }) => void\n  \"normalize:progress\": (info: {\n    file: string\n    percent: number\n    phase: \"analyzing\" | \"normalizing\"\n  }) => void\n  \"normalize:end\": (info: { input: string; output: string }) => void\n  \"normalize:error\": (info: { input: string; error: string }) => void\n  error: (err: TikTokError) => void\n}\n\nexport type AppErrorKind =\n  | \"user-not-live\"\n  | \"room-not-found\"\n  | \"stream-url-not-found\"\n  | \"waf-blocked\"\n  | \"country-blocked\"\n  | \"network-error\"\n  | \"ffmpeg-not-found\"\n  | \"ffmpeg-error\"\n  | \"aborted\"\n  | \"config-error\"\n  | \"unknown\"\n\nexport class TikTokError extends Error {\n  constructor(\n    public readonly kind: AppErrorKind,\n    message: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(message)\n    this.name = \"TikTokError\"\n  }\n}\n\nconst DEFAULTS = {\n  outputDir: \"./recordings\",\n  interval: 3,\n  duration: 0,\n  logLevel: \"info\" as LogLevel,\n  logConsole: true,\n  segmentMinutes: 0,\n  normalizeAudio: true,\n  normalizeLoudness: -14,\n  ratePerSecond: 5,\n  debug: false,\n}\n\nexport function normalizeConfig(\n  config: RecorderConfig,\n): Required<\n  Omit<RecorderConfig, \"cookies\" | \"cookiesPath\" | \"proxy\" | \"normalizeCodec\" | \"normalizeBitrate\">\n> &\n  Pick<\n    RecorderConfig,\n    \"cookies\" | \"cookiesPath\" | \"proxy\" | \"normalizeCodec\" | \"normalizeBitrate\"\n  > {\n  return {\n    user: config.user,\n    outputDir: config.outputDir ?? DEFAULTS.outputDir,\n    interval: config.interval ?? DEFAULTS.interval,\n    duration: config.duration ?? DEFAULTS.duration,\n    logLevel: config.logLevel ?? DEFAULTS.logLevel,\n    logConsole: config.logConsole ?? DEFAULTS.logConsole,\n    proxy: config.proxy,\n    cookies: config.cookies,\n    cookiesPath: config.cookiesPath,\n    segmentMinutes: config.segmentMinutes ?? DEFAULTS.segmentMinutes,\n    normalizeAudio: config.normalizeAudio ?? DEFAULTS.normalizeAudio,\n    normalizeLoudness: config.normalizeLoudness ?? DEFAULTS.normalizeLoudness,\n    normalizeCodec: config.normalizeCodec,\n    normalizeBitrate: config.normalizeBitrate,\n    ratePerSecond: config.ratePerSecond ?? DEFAULTS.ratePerSecond,\n    debug: config.debug ?? DEFAULTS.debug,\n  }\n}\n\nexport function validateConfig(config: RecorderConfig): void {\n  if (!config.user || config.user.trim().length === 0) {\n    throw new TikTokError(\"config-error\", \"--user is required\")\n  }\n  if (config.interval !== undefined && config.interval < 1) {\n    throw new TikTokError(\"config-error\", \"--interval must be >= 1 minute\")\n  }\n  if (config.duration !== undefined && config.duration < 0) {\n    throw new TikTokError(\"config-error\", \"--duration must be >= 0 seconds\")\n  }\n}\n"],"mappings":";AAgHA,IAAa,cAAb,cAAiC,MAAM;CAEnB;CAES;CAH3B,YACE,MACA,SACA,OACA;EACA,MAAM,OAAO;EAJG,KAAA,OAAA;EAES,KAAA,QAAA;EAGzB,KAAK,OAAO;CACd;AACF;AAEA,MAAM,WAAW;CACf,WAAW;CACX,UAAU;CACV,UAAU;CACV,UAAU;CACV,YAAY;CACZ,gBAAgB;CAChB,gBAAgB;CAChB,mBAAmB;CACnB,eAAe;CACf,OAAO;AACT;AAEA,SAAgB,gBACd,QAOE;CACF,OAAO;EACL,MAAM,OAAO;EACb,WAAW,OAAO,aAAa,SAAS;EACxC,UAAU,OAAO,YAAY,SAAS;EACtC,UAAU,OAAO,YAAY,SAAS;EACtC,UAAU,OAAO,YAAY,SAAS;EACtC,YAAY,OAAO,cAAc,SAAS;EAC1C,OAAO,OAAO;EACd,SAAS,OAAO;EAChB,aAAa,OAAO;EACpB,gBAAgB,OAAO,kBAAkB,SAAS;EAClD,gBAAgB,OAAO,kBAAkB,SAAS;EAClD,mBAAmB,OAAO,qBAAqB,SAAS;EACxD,gBAAgB,OAAO;EACvB,kBAAkB,OAAO;EACzB,eAAe,OAAO,iBAAiB,SAAS;EAChD,OAAO,OAAO,SAAS,SAAS;CAClC;AACF;AAEA,SAAgB,eAAe,QAA8B;CAC3D,IAAI,CAAC,OAAO,QAAQ,OAAO,KAAK,KAAK,CAAC,CAAC,WAAW,GAChD,MAAM,IAAI,YAAY,gBAAgB,oBAAoB;CAE5D,IAAI,OAAO,aAAa,KAAA,KAAa,OAAO,WAAW,GACrD,MAAM,IAAI,YAAY,gBAAgB,gCAAgC;CAExE,IAAI,OAAO,aAAa,KAAA,KAAa,OAAO,WAAW,GACrD,MAAM,IAAI,YAAY,gBAAgB,iCAAiC;AAE3E"}

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":["pkg.version"],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env bun\n/**\n * Entry point — parses CLI args, creates the recorder, and handles signals.\n * Uses the terminal Display manager for beautiful console output.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\"\nimport { join } from \"node:path\"\nimport { color } from \"@zfadhli/koko-cli\"\nimport pkg from \"../package.json\"\nimport { extractTikTokCookiesFromFirefox } from \"./browser-cookies\"\nimport { parseArgs } from \"./cli\"\nimport type { RecorderConfig } from \"./config\"\nimport { TikTokError, validateConfig } from \"./config\"\nimport { createRecorder } from \"./lib\"\nimport { createDisplay } from \"./ui\"\nimport { bytesToHuman, relativeTime } from \"./utils\"\n\nasync function loadCookies(cookiesPath?: string): Promise<Record<string, string> | undefined> {\n  const path = cookiesPath ?? join(process.cwd(), \"cookies.json\")\n  if (!existsSync(path)) {\n    return undefined\n  }\n  try {\n    const content = readFileSync(path, \"utf-8\")\n    const data = JSON.parse(content) as Record<string, string | undefined>\n    if (data.sessionid_ss && data.sessionid_ss.length > 0) {\n      return data as Record<string, string>\n    }\n    return undefined\n  } catch {\n    return undefined\n  }\n}\n\nasync function main(): Promise<void> {\n  let config: RecorderConfig\n\n  try {\n    config = parseArgs()\n    validateConfig(config)\n  } catch (err) {\n    if (err instanceof TikTokError && err.kind === \"config-error\") {\n      console.error(`${color.red(\"Error:\")} ${err.message}`)\n      process.exit(1)\n    }\n    throw err\n  }\n\n  // Load cookies: try Firefox browser first, then fall back to cookies.json\n  const firefoxCookies = extractTikTokCookiesFromFirefox()\n  config.cookies = firefoxCookies ?? (await loadCookies(config.cookiesPath))\n\n  // Suppress internal logger's console output — the Display owns the terminal\n  config.logConsole = false\n\n  // Beautiful terminal display\n  const display = createDisplay()\n\n  display.showVersion(\"tokrec\", pkg.version)\n\n  if (config.cookies) {\n    const source = firefoxCookies ? \"Firefox\" : \"cookies.json\"\n    const names = Object.keys(config.cookies)\n    const detail = names.length > 1 ? ` (${names.length} cookies)` : \"\"\n    display.showInfo(`${source} cookies loaded${detail}`)\n  } else {\n    display.showWarning(\n      \"No TikTok cookies found — log in at tiktok.com in Firefox or create cookies.json\",\n    )\n  }\n\n  const recorder = createRecorder(config)\n\n  let lastWasLive: boolean | null = null\n  let firstOfflineTime = 0\n\n  // Subscribe to events for beautiful console output\n  recorder.on(\"checking\", (info) => {\n    display.checkingUser(info.user)\n  })\n\n  recorder.on(\"tick\", (info) => {\n    if (info.isLive) {\n      display.userLive(info.user, info.roomId ?? \"?\")\n    } else if (lastWasLive === null || lastWasLive === true) {\n      display.userOffline(info.user)\n      firstOfflineTime = Date.now()\n    } else {\n      const elapsed = Date.now() - firstOfflineTime\n      display.userOfflineRepeat(info.user, relativeTime(elapsed))\n    }\n    lastWasLive = info.isLive\n  })\n\n  recorder.on(\"recording:start\", () => {\n    display.startRecording()\n  })\n\n  recorder.on(\"download:end\", (info) => {\n    const parsed = info.file.split(\"/\").pop() ?? info.file\n    const sizeStr = bytesToHuman(info.size)\n    display.finishRecording(parsed, info.duration, sizeStr)\n  })\n\n  recorder.on(\"segmenting:start\", () => {\n    display.startSegmenting()\n  })\n\n  recorder.on(\"segmenting:end\", (info) => {\n    display.segmentsCreated(info.segments)\n  })\n\n  recorder.on(\"converting:start\", () => {\n    display.startConverting()\n  })\n\n  recorder.on(\"converted\", (info) => {\n    const parsed = info.output.split(\"/\").pop() ?? info.output\n    display.conversionDone(parsed)\n  })\n\n  recorder.on(\"recording:end\", () => {\n    // For simple conversion (no segmenting), recording:end fires once.\n    // For segmenting path, segmenting:end already acknowledges the result.\n    // This is a no-op since we handle the terminal output through download:end\n    // and segmenting:end / converted events.\n  })\n\n  recorder.on(\"error\", (err) => {\n    display.showError(`[${err.kind}] ${err.message}`)\n  })\n\n  recorder.on(\"normalize:start\", () => {\n    display.normalizeStart()\n  })\n\n  recorder.on(\"normalize:progress\", (info) => {\n    display.normalizeProgress(info.percent, info.phase)\n  })\n\n  recorder.on(\"normalize:end\", () => {\n    display.normalizeComplete()\n  })\n\n  recorder.on(\"normalize:error\", (info) => {\n    display.normalizeError(info.error)\n  })\n\n  // Signal handling\n  let stopping = false\n  const handleSignal = async () => {\n    if (stopping) return // ignore duplicate signals (e.g. SIGINT + SIGTERM from one Ctrl-C)\n    stopping = true\n    // Remove signal handlers so they don't accumulate if main() is called again\n    process.off(\"SIGINT\", handleSignal)\n    process.off(\"SIGTERM\", handleSignal)\n    process.off(\"SIGHUP\", handleSignal)\n    display.showInfo(\"Shutting down gracefully...\")\n    await recorder.stop()\n    display.stop()\n    process.exit(0)\n  }\n\n  process.on(\"SIGINT\", handleSignal)\n  process.on(\"SIGTERM\", handleSignal)\n  process.on(\"SIGHUP\", handleSignal)\n\n  // Show initial status and start the recorder\n  display.pollingStarted(config.interval ?? 3)\n  try {\n    await recorder.start()\n  } catch (err) {\n    if (err instanceof TikTokError) {\n      display.showError(`[${err.kind}] ${err.message}`)\n    } else {\n      display.showError(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`)\n    }\n    process.off(\"SIGINT\", handleSignal)\n    process.off(\"SIGTERM\", handleSignal)\n    process.off(\"SIGHUP\", handleSignal)\n    await recorder.stop()\n    display.stop()\n    process.exit(1)\n  }\n}\n\nmain().catch((err) => {\n  console.error(\"Fatal:\", err instanceof Error ? err.message : String(err))\n  process.exit(1)\n})\n"],"mappings":"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"}

package/dist/lib.d.mts

@@ -1,3 +0,0 @@
-import { AppErrorKind, RecorderConfig, RecorderController, RecorderEvent, RecorderEventHandler, RecorderStatus, TikTokError } from "./config.mjs";
-import { createRecorder } from "./recorder/index.mjs";
-export { type AppErrorKind, type RecorderConfig, type RecorderController, type RecorderEvent, type RecorderEventHandler, type RecorderStatus, type TikTokError, createRecorder };

package/dist/lib.mjs

@@ -1,2 +0,0 @@
-import { createRecorder } from "./recorder/index.mjs";
-export { createRecorder };

package/dist/logger.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.mjs","names":[],"sources":["../src/logger.ts"],"sourcesContent":["/**\n * Logger — rotating file + console with levels.\n * Zero-dependency minimal implementation (~60 lines).\n */\n\nimport { appendFileSync, existsSync, mkdirSync, renameSync, statSync, writeFileSync } from \"node:fs\"\nimport { dirname } from \"node:path\"\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\"\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n}\n\nconst LEVEL_COLORS: Record<LogLevel, string> = {\n  debug: \"\\x1b[90m\", // gray\n  info: \"\\x1b[36m\", // cyan\n  warn: \"\\x1b[33m\", // yellow\n  error: \"\\x1b[31m\", // red\n}\n\nconst RESET = \"\\x1b[0m\"\n\nexport interface Logger {\n  debug: (msg: string, ...args: unknown[]) => void\n  info: (msg: string, ...args: unknown[]) => void\n  warn: (msg: string, ...args: unknown[]) => void\n  error: (msg: string, ...args: unknown[]) => void\n}\n\nexport function createLogger(opts: {\n  level?: LogLevel\n  logFile?: string\n  maxSize?: number\n  backups?: number\n  /** When true (default), writes to stdout/stderr. Set false for file-only logging. */\n  console?: boolean\n}): Logger {\n  const level = opts.level ?? \"info\"\n  const logFile = opts.logFile ?? \"tiktok-recorder.log\"\n  const maxSize = opts.maxSize ?? 5 * 1024 * 1024 // 5 MB\n  const backups = opts.backups ?? 3\n  const showConsole = opts.console !== false // default true\n\n  // Ensure parent directory exists\n  const logDir = dirname(logFile)\n  if (logDir !== \".\") {\n    mkdirSync(logDir, { recursive: true })\n  }\n\n  function rotateIfNeeded(): void {\n    try {\n      if (existsSync(logFile)) {\n        const size = statSync(logFile).size\n        if (size >= maxSize) {\n          // Remove the oldest backup\n          const lastBackup = `${logFile}.${backups}`\n          if (existsSync(lastBackup)) {\n            try {\n              renameSync(lastBackup, `${lastBackup}.old`)\n            } catch {\n              // Best-effort cleanup\n            }\n          }\n          // Shift backups\n          for (let i = backups - 1; i >= 1; i--) {\n            const src = `${logFile}.${i}`\n            const dst = `${logFile}.${i + 1}`\n            if (existsSync(src)) {\n              try {\n                renameSync(src, dst)\n              } catch {\n                // Best-effort\n              }\n            }\n          }\n          // Rename current → .1\n          try {\n            renameSync(logFile, `${logFile}.1`)\n          } catch {\n            // Best-effort\n          }\n        }\n      }\n    } catch {\n      // Silent — never throw in logger\n    }\n  }\n\n  // Touch the file\n  try {\n    if (!existsSync(logFile)) {\n      writeFileSync(logFile, \"\", \"utf-8\")\n    }\n  } catch {\n    // Best-effort\n  }\n\n  function write(level: LogLevel, msg: string, args: unknown[]): void {\n    const ts = new Date().toISOString()\n    const suffix = args.length > 0 ? ` ${args.map((a) => String(a)).join(\" \")}` : \"\"\n    const line = `[${ts}] [${level.toUpperCase()}] ${msg}${suffix}`\n    const formatted = `[${ts}] [${level.toUpperCase()}] ${msg}${suffix}`\n\n    // Console (optional — can be suppressed for file-only logging)\n    if (showConsole) {\n      if (level === \"error\") {\n        process.stderr.write(`${LEVEL_COLORS[level]}${formatted}${RESET}\\n`)\n      } else {\n        process.stdout.write(`${LEVEL_COLORS[level]}${formatted}${RESET}\\n`)\n      }\n    }\n\n    // File\n    try {\n      rotateIfNeeded()\n      appendFileSync(logFile, `${line}\\n`, \"utf-8\")\n    } catch {\n      // Best-effort\n    }\n  }\n\n  return {\n    debug: (msg, ...args) => {\n      if (LEVEL_ORDER.debug >= LEVEL_ORDER[level]) write(\"debug\", msg, args)\n    },\n    info: (msg, ...args) => {\n      if (LEVEL_ORDER.info >= LEVEL_ORDER[level]) write(\"info\", msg, args)\n    },\n    warn: (msg, ...args) => {\n      if (LEVEL_ORDER.warn >= LEVEL_ORDER[level]) write(\"warn\", msg, args)\n    },\n    error: (msg, ...args) => {\n      if (LEVEL_ORDER.error >= LEVEL_ORDER[level]) write(\"error\", msg, args)\n    },\n  }\n}\n"],"mappings":";;;;;;;AAUA,MAAM,cAAwC;CAC5C,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;AACT;AAEA,MAAM,eAAyC;CAC7C,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;AACT;AAEA,MAAM,QAAQ;AASd,SAAgB,aAAa,MAOlB;CACT,MAAM,QAAQ,KAAK,SAAS;CAC5B,MAAM,UAAU,KAAK,WAAW;CAChC,MAAM,UAAU,KAAK,WAAW,IAAI,OAAO;CAC3C,MAAM,UAAU,KAAK,WAAW;CAChC,MAAM,cAAc,KAAK,YAAY;CAGrC,MAAM,SAAS,QAAQ,OAAO;CAC9B,IAAI,WAAW,KACb,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CAGvC,SAAS,iBAAuB;EAC9B,IAAI;GACF,IAAI,WAAW,OAAO;QACP,SAAS,OAAO,CAAC,CAAC,QACnB,SAAS;KAEnB,MAAM,aAAa,GAAG,QAAQ,GAAG;KACjC,IAAI,WAAW,UAAU,GACvB,IAAI;MACF,WAAW,YAAY,GAAG,WAAW,KAAK;KAC5C,QAAQ,CAER;KAGF,KAAK,IAAI,IAAI,UAAU,GAAG,KAAK,GAAG,KAAK;MACrC,MAAM,MAAM,GAAG,QAAQ,GAAG;MAC1B,MAAM,MAAM,GAAG,QAAQ,GAAG,IAAI;MAC9B,IAAI,WAAW,GAAG,GAChB,IAAI;OACF,WAAW,KAAK,GAAG;MACrB,QAAQ,CAER;KAEJ;KAEA,IAAI;MACF,WAAW,SAAS,GAAG,QAAQ,GAAG;KACpC,QAAQ,CAER;IACF;;EAEJ,QAAQ,CAER;CACF;CAGA,IAAI;EACF,IAAI,CAAC,WAAW,OAAO,GACrB,cAAc,SAAS,IAAI,OAAO;CAEtC,QAAQ,CAER;CAEA,SAAS,MAAM,OAAiB,KAAa,MAAuB;EAClE,MAAM,sBAAK,IAAI,KAAK,EAAA,CAAE,YAAY;EAClC,MAAM,SAAS,KAAK,SAAS,IAAI,IAAI,KAAK,KAAK,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM;EAC9E,MAAM,OAAO,IAAI,GAAG,KAAK,MAAM,YAAY,EAAE,IAAI,MAAM;EACvD,MAAM,YAAY,IAAI,GAAG,KAAK,MAAM,YAAY,EAAE,IAAI,MAAM;EAG5D,IAAI,aACF,IAAI,UAAU,SACZ,QAAQ,OAAO,MAAM,GAAG,aAAa,SAAS,YAAY,MAAM,GAAG;OAEnE,QAAQ,OAAO,MAAM,GAAG,aAAa,SAAS,YAAY,MAAM,GAAG;EAKvE,IAAI;GACF,eAAe;GACf,eAAe,SAAS,GAAG,KAAK,KAAK,OAAO;EAC9C,QAAQ,CAER;CACF;CAEA,OAAO;EACL,QAAQ,KAAK,GAAG,SAAS;GACvB,IAAI,YAAY,SAAS,YAAY,QAAQ,MAAM,SAAS,KAAK,IAAI;EACvE;EACA,OAAO,KAAK,GAAG,SAAS;GACtB,IAAI,YAAY,QAAQ,YAAY,QAAQ,MAAM,QAAQ,KAAK,IAAI;EACrE;EACA,OAAO,KAAK,GAAG,SAAS;GACtB,IAAI,YAAY,QAAQ,YAAY,QAAQ,MAAM,QAAQ,KAAK,IAAI;EACrE;EACA,QAAQ,KAAK,GAAG,SAAS;GACvB,IAAI,YAAY,SAAS,YAAY,QAAQ,MAAM,SAAS,KAAK,IAAI;EACvE;CACF;AACF"}

package/dist/monitor.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"monitor.mjs","names":[],"sources":["../src/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 \"./logger\"\nimport { sleep } from \"./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/recorder/convert.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"convert.mjs","names":[],"sources":["../../src/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 { spawn } from \"node:child_process\"\nimport { unlinkSync } from \"node:fs\"\nimport { TikTokError } from \"../config\"\nimport type { Logger } from \"../logger\"\nimport { findFfmpegPath } from \"../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\nfunction runFfmpeg(\n  ffmpegPath: string,\n  input: string,\n  output: string,\n  signal?: AbortSignal,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const args = [\n      \"-i\",\n      input,\n      \"-c\",\n      \"copy\", // stream copy — no re-encode, fast\n      \"-y\", // overwrite output\n      output,\n    ]\n\n    const proc = spawn(ffmpegPath, args, {\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      signal,\n    })\n\n    let stderr = \"\"\n\n    proc.stderr?.on(\"data\", (chunk: Buffer) => {\n      stderr += chunk.toString()\n      if (stderr.length > 10000) stderr = stderr.slice(-5000)\n    })\n\n    proc.on(\"close\", (code) => {\n      if (signal?.aborted) {\n        reject(new TikTokError(\"aborted\", \"Aborted by user\"))\n        return\n      }\n      if (code === 0) {\n        resolve()\n      } else {\n        reject(\n          new TikTokError(\"ffmpeg-error\", `FFmpeg exited with code ${code}\\n${stderr.slice(-500)}`),\n        )\n      }\n    })\n\n    proc.on(\"error\", (err) => {\n      if (err instanceof Error && err.name === \"AbortError\") return\n      reject(new TikTokError(\"ffmpeg-error\", `Failed to spawn FFmpeg: ${err.message}`))\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,SAAS,UACP,YACA,OACA,QACA,QACe;CACf,OAAO,IAAI,SAAS,SAAS,WAAW;EAUtC,MAAM,OAAO,MAAM,YAAY;GAR7B;GACA;GACA;GACA;GACA;GACA;EAGgC,GAAG;GACnC,OAAO;IAAC;IAAU;IAAQ;GAAM;GAChC;EACF,CAAC;EAED,IAAI,SAAS;EAEb,KAAK,QAAQ,GAAG,SAAS,UAAkB;GACzC,UAAU,MAAM,SAAS;GACzB,IAAI,OAAO,SAAS,KAAO,SAAS,OAAO,MAAM,IAAK;EACxD,CAAC;EAED,KAAK,GAAG,UAAU,SAAS;GACzB,IAAI,QAAQ,SAAS;IACnB,OAAO,IAAI,YAAY,WAAW,iBAAiB,CAAC;IACpD;GACF;GACA,IAAI,SAAS,GACX,QAAQ;QAER,OACE,IAAI,YAAY,gBAAgB,2BAA2B,KAAK,IAAI,OAAO,MAAM,IAAI,GAAG,CAC1F;EAEJ,CAAC;EAED,KAAK,GAAG,UAAU,QAAQ;GACxB,IAAI,eAAe,SAAS,IAAI,SAAS,cAAc;GACvD,OAAO,IAAI,YAAY,gBAAgB,2BAA2B,IAAI,SAAS,CAAC;EAClF,CAAC;CACH,CAAC;AACH"}

package/dist/recorder/download.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"download.mjs","names":[],"sources":["../../src/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 \"../config\"\nimport type { Logger } from \"../logger\"\nimport { bytesToHuman, findFfmpegPath, formatDuration, formatFilename } from \"../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): 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)\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,OACyB;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,SAAS;GAGtE,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/recorder/ffmpeg-utils.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ffmpeg-utils.mjs","names":[],"sources":["../../src/recorder/ffmpeg-utils.ts"],"sourcesContent":["/**\n * Shared FFmpeg utilities — stream-download pipe primitive and constants.\n */\n\nimport { spawn } from \"node:child_process\"\nimport type { WriteStream } from \"node:fs\"\nimport { TikTokError } from \"../config\"\n\n/** Kill FFmpeg if no output is received within this window after spawn. */\nexport const FFMPEG_STARTUP_TIMEOUT = 30_000\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 * Features:\n * - Transparent HTTP reconnection via FFmpeg `-reconnect` flags\n * - `FFMPEG_STARTUP_TIMEOUT` (30s) startup guard with SIGTERM → SIGKILL\n *   escalation to prevent orphaned processes\n * - Bounded stderr capture (10k chars) for error diagnostics\n * - Automatic cleanup when `signal` fires (uses spawn `signal` option)\n * - AbortError is swallowed — the promise resolves instead of rejecting,\n *   allowing the caller to check `signal.aborted` and react accordingly\n *\n * The caller is responsible for tracking file size via `statSync` — this\n * function deliberately avoids maintaining its own byte counter to prevent\n * divergence between the in-memory count and actual disk writes.\n */\nexport async function pipeFfmpegSegment(\n  ffmpegPath: string,\n  url: string,\n  writer: WriteStream,\n  signal: AbortSignal,\n  maxDuration?: number,\n): Promise<void> {\n  const durationArgs = maxDuration ? [\"-t\", String(maxDuration)] : []\n  const proc = spawn(ffmpegPath, [\"-i\", url, ...durationArgs, ...FFMPEG_BASE_ARGS], {\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    signal,\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  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      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      if (err instanceof Error && err.name === \"AbortError\") return\n      reject(err)\n    })\n  })\n}\n"],"mappings":";;;;;;;AASA,MAAa,yBAAyB;;AAGtC,MAAM,mBAAmB;CACvB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;;;;;;;;;;;AAmBA,eAAsB,kBACpB,YACA,KACA,QACA,QACA,aACe;CAEf,MAAM,OAAO,MAAM,YAAY;EAAC;EAAM;EAAK,GADtB,cAAc,CAAC,MAAM,OAAO,WAAW,CAAC,IAAI,CAAC;EACN,GAAG;CAAgB,GAAG;EAChF,OAAO;GAAC;GAAU;GAAQ;EAAM;EAChC;CACF,CAAC;CAED,IAAI,SAAS;CACb,IAAI,iBAAuD;CAE3D,MAAM,0BAA0B;EAC9B,IAAI,gBAAgB;GAClB,aAAa,cAAc;GAC3B,iBAAiB;EACnB;CACF;CAEA,KAAK,QAAQ,GAAG,SAAS,UAAkB;EACzC,kBAAkB;EAClB,UAAU,MAAM,SAAS;EACzB,IAAI,OAAO,SAAS,KAAO,SAAS,OAAO,MAAM,IAAK;CACxD,CAAC;CAED,KAAK,OAAO,GAAG,SAAS,UAAkB;EACxC,kBAAkB;EAElB,IAAI,CADgB,OAAO,MAAM,KAClB,GAAG;GAChB,KAAK,OAAO,MAAM;GAClB,OAAO,KAAK,eAAe,KAAK,OAAO,OAAO,CAAC;EACjD;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,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,IAAI,eAAe,SAAS,IAAI,SAAS,cAAc;GACvD,OAAO,GAAG;EACZ,CAAC;CACH,CAAC;AACH"}

package/dist/recorder/index.d.mts

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

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

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

package/dist/recorder/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/recorder/index.ts"],"sourcesContent":["/**\n * Recorder orchestrator — wires together the API, monitor, stream downloader,\n * and converter into a single RecorderController.\n */\n\nimport { spawn } from \"node:child_process\"\nimport { createHttpClient } from \"../api/client\"\nimport { createTikTokApi, type TikTokApi } from \"../api/tiktok\"\nimport type { RecorderConfig, RecorderController } from \"../config\"\nimport { normalizeConfig, TikTokError } from \"../config\"\nimport { createLogger } from \"../logger\"\nimport { createPollingMonitor, type PollingMonitor } from \"../monitor\"\nimport { findFfmpegPath, sleep } from \"../utils\"\nimport { type Converter, createConverter } from \"./convert\"\nimport { type AudioNormalizer, createAudioNormalizer } from \"./normalize\"\nimport { processRecording } from \"./post-processing\"\nimport { createEventEmitter } from \"./recorder-events\"\nimport { createRecorderState } from \"./recorder-state\"\nimport type { DownloadResult } from \"./stream\"\nimport { createStreamDownloader, type StreamDownloader } from \"./stream\"\n\nexport function createRecorder(config: RecorderConfig): RecorderController {\n  const cfg = normalizeConfig(config)\n  const logger = createLogger({\n    level: cfg.logLevel,\n    logFile: \"tiktok-recorder.log\",\n    console: cfg.logConsole,\n  })\n\n  const emitter = createEventEmitter()\n  const stateManager = createRecorderState({ state: \"idle\" as const, user: cfg.user }, logger)\n\n  // State variables\n  let httpClient: Awaited<ReturnType<typeof createHttpClient>> | null = null\n  let api: TikTokApi | null = null\n  let monitor: PollingMonitor | null = null\n  let downloader: StreamDownloader | null = null\n  let converter: Converter | null = null\n  let audioNormalizer: AudioNormalizer | null = null\n  let stopRequested = false\n  let stopAbortController = new AbortController()\n  let pendingRemuxes: Promise<unknown>[] = []\n\n  function runFfmpeg(args: string[], signal?: AbortSignal): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const ffmpegPath = findFfmpegPath()\n      if (!ffmpegPath) {\n        reject(\n          new TikTokError(\n            \"ffmpeg-not-found\",\n            \"FFmpeg not found. Install it:\\n  Linux: apt install ffmpeg\\n  macOS: brew install ffmpeg\",\n          ),\n        )\n        return\n      }\n      const proc = spawn(ffmpegPath, args, {\n        stdio: [\"ignore\", \"pipe\", \"pipe\"],\n        signal,\n      })\n\n      let stderr = \"\"\n      proc.stderr?.on(\"data\", (chunk: Buffer) => {\n        stderr += chunk.toString()\n        if (stderr.length > 10000) stderr = stderr.slice(-5000)\n      })\n\n      proc.on(\"close\", (code) => {\n        if (signal?.aborted) {\n          reject(new TikTokError(\"unknown\", \"Aborted by user\"))\n          return\n        }\n        if (code === 0) {\n          resolve()\n        } else {\n          reject(\n            new TikTokError(\"unknown\", `FFmpeg exited with code ${code}\\n${stderr.slice(-500)}`),\n          )\n        }\n      })\n\n      proc.on(\"error\", (err) => {\n        if (err instanceof Error && err.name === \"AbortError\") return\n        reject(new TikTokError(\"unknown\", `Failed to spawn FFmpeg: ${err.message}`))\n      })\n    })\n  }\n\n  async function start(): Promise<void> {\n    if (stateManager.getStatus().state !== \"idle\") {\n      logger.warn(`start() ignored: already in state ${stateManager.getStatus().state}`)\n      return\n    }\n    stopRequested = false\n    pendingRemuxes = []\n    stopAbortController = new AbortController()\n\n    logger.info(`Starting recorder for @${cfg.user}`)\n    httpClient = await createHttpClient(cfg)\n    api = createTikTokApi(httpClient, logger, cfg.debug)\n    downloader = createStreamDownloader(logger)\n    converter = createConverter(logger, stopAbortController.signal)\n    audioNormalizer = cfg.normalizeAudio\n      ? createAudioNormalizer(\n          {\n            loudness: cfg.normalizeLoudness,\n            audioCodec: cfg.normalizeCodec,\n            audioBitrate: cfg.normalizeBitrate,\n            onStart: (file) => emitter.emit(\"normalize:start\", { file }),\n            onProgress: (file, percent, phase) =>\n              emitter.emit(\"normalize:progress\", {\n                file,\n                percent,\n                phase: phase as \"analyzing\" | \"normalizing\",\n              }),\n            onComplete: (result) =>\n              emitter.emit(\"normalize:end\", { input: result.input, output: result.output }),\n            onError: (file, err) =>\n              emitter.emit(\"normalize:error\", { input: file, error: err.message }),\n          },\n          logger,\n        )\n      : null\n\n    monitor = createPollingMonitor({\n      intervalMinutes: cfg.interval,\n      logger,\n      onTick: async () => {\n        if (stopRequested) return\n\n        const user = cfg.user\n        api!.invalidateCache()\n\n        emitter.emit(\"checking\", { user })\n        logger.info(`Checking @${user}...`)\n\n        const roomId = await api!.getRoomId(user)\n        if (!roomId) {\n          logger.info(`@${user} is offline`)\n          emitter.emit(\"tick\", { user, isLive: false })\n          return\n        }\n\n        const liveUrl = await api!.getLiveUrl(roomId)\n        if (!liveUrl) {\n          logger.warn(`@${user} is live but no stream URL found`)\n          emitter.emit(\"tick\", { user, isLive: false, roomId })\n          return\n        }\n\n        logger.info(`@${user} is LIVE! (room: ${roomId})`)\n        emitter.emit(\"tick\", { user, isLive: true, roomId })\n\n        stateManager.setState({ state: \"recording\" })\n        emitter.emit(\"recording:start\", { user, file: \"\" })\n\n        const getNextUrl = async (): Promise<string | null> => {\n          // Use the lightweight check_alive endpoint first — avoids a full\n          // page re-scan + room/info call when the stream is still active.\n          const alive = await api!.isRoomAlive(roomId)\n          if (!alive) {\n            logger.info(`@${user} is no longer live — stopping`)\n            return null\n          }\n          // Still alive — invalidate cache and get a fresh stream URL.\n          api!.invalidateCache()\n          return api!.getLiveUrl(roomId)\n        }\n\n        const result = await downloader!.download(\n          liveUrl,\n          user,\n          cfg.outputDir,\n          cfg.duration,\n          (info) => emitter.emit(\"download:progress\", info),\n          getNextUrl,\n        )\n\n        emitter.emit(\"download:end\", {\n          file: result.file,\n          duration: result.duration,\n          size: result.size,\n        })\n\n        await processRecording(result as DownloadResult, cfg, {\n          runFfmpeg,\n          converter: converter!,\n          audioNormalizer,\n          stopAbortController,\n          pendingRemuxes,\n          emit: (event: string, ...args: any[]) => (emitter as any).emit(event, ...args),\n          setState: stateManager.setState,\n          stopRequested: () => stopRequested,\n          logger,\n        })\n\n        // One-shot mode: if a duration was set, stop after this recording\n        if (cfg.duration > 0) {\n          logger.info(\"Duration limit reached — exiting\")\n          monitor!.stopAfterCurrentTick()\n        } else if (!stopRequested && roomId) {\n          // Recording ended because the stream went offline (not user-initiated stop).\n          // Immediately re-check via lightweight check_alive endpoint instead of\n          // waiting for the next poll interval.\n          const alive = await api!.isRoomAlive(roomId)\n          if (!alive) {\n            logger.info(`@${user} is offline`)\n            emitter.emit(\"tick\", { user, isLive: false })\n          }\n        }\n      },\n    })\n\n    stateManager.setState({ state: \"polling\" })\n    await monitor.start()\n  }\n\n  async function stop(): Promise<void> {\n    if (stateManager.getStatus().state === \"stopped\") {\n      logger.warn(`stop() ignored: already stopped`)\n      return\n    }\n    stopRequested = true\n    logger.info(\"Stopping recorder...\")\n\n    if (pendingRemuxes.length > 0) {\n      logger.info(`Waiting for ${pendingRemuxes.length} pending conversion(s) (max 60s)...`)\n      const abortTimeout = new AbortController()\n      await Promise.race([\n        Promise.allSettled(pendingRemuxes).finally(() => abortTimeout.abort()),\n        sleep(60_000, abortTimeout.signal),\n      ])\n      pendingRemuxes = []\n    }\n\n    if (downloader) downloader.abort()\n    if (monitor) await monitor.stop()\n    stopAbortController.abort()\n    if (httpClient) await httpClient.close()\n    emitter.clear()\n    stateManager.setState({ state: \"stopped\" })\n    logger.info(\"Recorder stopped\")\n  }\n\n  return {\n    start,\n    stop,\n    getStatus: stateManager.getStatus,\n    on: emitter.on,\n    off: emitter.off,\n  }\n}\n"],"mappings":"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"}

package/dist/recorder/normalize.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalize.mjs","names":[],"sources":["../../src/recorder/normalize.ts"],"sourcesContent":["/**\n * Audio normalizer — wraps peaknorm's EBU R128 loudness normalization.\n * Runs after conversion/segmenting to normalize the final MP4 audio.\n */\n\nimport type { NormalizeOptions, NormalizeResult } from \"peaknorm\"\nimport { normalizeFile } from \"peaknorm\"\nimport type { Logger } from \"../logger\"\n\nexport interface AudioNormalizer {\n  /** Normalize a single audio/video file. Returns the normalize result. */\n  normalize(file: string): Promise<NormalizeResult>\n}\n\nexport interface AudioNormalizerOptions {\n  /** Target loudness in LUFS (default: -14). */\n  loudness: number\n  /** Audio codec for output (default: peaknorm's default, \"libopus\"). */\n  audioCodec?: string\n  /** Audio bitrate for output (default: peaknorm's default, \"96k\"). */\n  audioBitrate?: string\n  /** Called when a file starts normalization. */\n  onStart?: (file: string) => void\n  /** Called with progress updates (percent 0-100, phase \"analyzing\"|\"normalizing\"). */\n  onProgress?: (file: string, percent: number, phase: string) => void\n  /** Called when a file completes normalization successfully. */\n  onComplete?: (result: NormalizeResult) => void\n  /** Called when a file errors during normalization. */\n  onError?: (file: string, error: Error) => void\n}\n\nexport function createAudioNormalizer(\n  opts: AudioNormalizerOptions,\n  logger?: Logger,\n): AudioNormalizer {\n  return {\n    async normalize(file: string): Promise<NormalizeResult> {\n      logger?.info(`Normalizing audio: ${file}`)\n      opts.onStart?.(file)\n\n      try {\n        const normalizeOpts: NormalizeOptions = {\n          loudness: opts.loudness,\n          backup: false,\n          onFileProgress: (f, percent, phase) => {\n            opts.onProgress?.(f, percent, phase)\n          },\n        }\n        if (opts.audioCodec !== undefined) normalizeOpts.audioCodec = opts.audioCodec\n        if (opts.audioBitrate !== undefined) normalizeOpts.audioBitrate = opts.audioBitrate\n        const result = await normalizeFile(file, normalizeOpts)\n\n        logger?.info(`Audio normalized: ${result.output}`)\n        opts.onComplete?.(result)\n        return result\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err))\n        logger?.error(`Audio normalization failed: ${error.message}`)\n        opts.onError?.(file, error)\n        throw error\n      }\n    },\n  }\n}\n"],"mappings":";;AA+BA,SAAgB,sBACd,MACA,QACiB;CACjB,OAAO,EACL,MAAM,UAAU,MAAwC;EACtD,QAAQ,KAAK,sBAAsB,MAAM;EACzC,KAAK,UAAU,IAAI;EAEnB,IAAI;GACF,MAAM,gBAAkC;IACtC,UAAU,KAAK;IACf,QAAQ;IACR,iBAAiB,GAAG,SAAS,UAAU;KACrC,KAAK,aAAa,GAAG,SAAS,KAAK;IACrC;GACF;GACA,IAAI,KAAK,eAAe,KAAA,GAAW,cAAc,aAAa,KAAK;GACnE,IAAI,KAAK,iBAAiB,KAAA,GAAW,cAAc,eAAe,KAAK;GACvE,MAAM,SAAS,MAAM,cAAc,MAAM,aAAa;GAEtD,QAAQ,KAAK,qBAAqB,OAAO,QAAQ;GACjD,KAAK,aAAa,MAAM;GACxB,OAAO;EACT,SAAS,KAAK;GACZ,MAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;GAChE,QAAQ,MAAM,+BAA+B,MAAM,SAAS;GAC5D,KAAK,UAAU,MAAM,KAAK;GAC1B,MAAM;EACR;CACF,EACF;AACF"}

package/dist/recorder/post-processing.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"post-processing.mjs","names":[],"sources":["../../src/recorder/post-processing.ts"],"sourcesContent":["/**\n * Post-recording processing — segmenting, conversion, and audio normalization.\n *\n * After a stream download completes, this module handles:\n * - Splitting the downloaded file into timed MP4 segments\n * - Converting TS to MP4 (fallback or direct)\n * - Audio normalization via EBU R128\n * - File management (deleting originals, setting timestamps)\n * - Event emissions for each step\n */\n\nimport { readdirSync, statSync, unlinkSync, utimesSync } from \"node:fs\"\nimport { join, parse } from \"node:path\"\nimport type { RecorderConfig } from \"../config\"\nimport { TikTokError } from \"../config\"\nimport type { Logger } from \"../logger\"\nimport type { Converter } from \"./convert\"\nimport type { AudioNormalizer } from \"./normalize\"\nimport type { DownloadResult } from \"./stream\"\n\nexport interface ProcessingDeps {\n  runFfmpeg: (args: string[], signal?: AbortSignal) => Promise<void>\n  converter: Converter\n  audioNormalizer: AudioNormalizer | null\n  stopAbortController: AbortController\n  pendingRemuxes: Promise<unknown>[]\n  emit: (event: string, ...args: any[]) => void\n  setState: (partial: Record<string, unknown>) => void\n  stopRequested: () => boolean\n  logger: Logger\n}\n\nexport async function processRecording(\n  result: DownloadResult,\n  cfg: RecorderConfig,\n  deps: ProcessingDeps,\n): Promise<void> {\n  try {\n    if (statSync(result.file).size === 0) return\n  } catch {\n    return // file doesn't exist or can't be accessed\n  }\n\n  deps.setState({ state: \"converting\" })\n\n  if (cfg.segmentMinutes && cfg.segmentMinutes >= 1) {\n    await processSegmenting(result, cfg, deps)\n  } else {\n    await processConversion(result, cfg, deps)\n  }\n\n  deps.setState({ state: \"polling\" })\n}\n\n// ─── Segmenting path ──────────────────────────────────────────────\n\nasync function processSegmenting(\n  result: DownloadResult,\n  cfg: RecorderConfig,\n  deps: ProcessingDeps,\n): Promise<void> {\n  const parsed = parse(result.file)\n  const segmentTime = Math.max(1, (cfg.segmentMinutes ?? 20) * 60)\n  const outputPattern = join(parsed.dir, `${parsed.name}_part%d.mp4`)\n\n  deps.logger.info(\n    `Segmenting: ${parsed.base} → ${parsed.name}_partN.mp4 (${cfg.segmentMinutes ?? 20} min each)`,\n  )\n  deps.emit(\"segmenting:start\", { input: result.file, outputPattern })\n\n  try {\n    const segmentPromise = deps.runFfmpeg(\n      [\n        \"-i\",\n        result.file,\n        \"-c\",\n        \"copy\",\n        \"-f\",\n        \"segment\",\n        \"-segment_time\",\n        String(segmentTime),\n        \"-reset_timestamps\",\n        \"1\",\n        \"-segment_start_number\",\n        \"1\",\n        outputPattern,\n      ],\n      deps.stopAbortController.signal,\n    )\n    deps.pendingRemuxes.push(segmentPromise)\n    await segmentPromise\n\n    // Capture file timestamp before deletion\n    const fileMtimeMs = statSync(result.file).mtimeMs\n    const recStartMs = fileMtimeMs - (result.duration ?? 0) * 1000\n\n    // Delete the original TS\n    try {\n      unlinkSync(result.file)\n      deps.logger.info(`Deleted original: ${parsed.base}`)\n    } catch {\n      deps.logger.warn(`Could not delete original: ${parsed.base}`)\n    }\n\n    // Find generated segment files\n    const allFiles = readdirSync(parsed.dir)\n    const prefix = `${parsed.name}_part`\n    const segmentFiles = allFiles\n      .filter((f) => f.startsWith(prefix) && f.endsWith(\".mp4\"))\n      .sort((a, b) => {\n        const na = Number.parseInt(a.match(/_part(\\d+)\\.mp4$/)?.[1] ?? \"0\", 10)\n        const nb = Number.parseInt(b.match(/_part(\\d+)\\.mp4$/)?.[1] ?? \"0\", 10)\n        return na - nb\n      })\n\n    const segmentDurationSec = segmentTime\n    const totalDuration = result.duration\n\n    // Emit events for each segment\n    for (let i = 0; i < segmentFiles.length; i++) {\n      const filePath = join(parsed.dir, segmentFiles[i]!)\n      const stats = statSync(filePath)\n      const isLast = i === segmentFiles.length - 1\n      const estDuration = isLast\n        ? Math.max(0, totalDuration - segmentDurationSec * (segmentFiles.length - 1))\n        : segmentDurationSec\n\n      deps.emit(\"recording:end\", { file: filePath, duration: estDuration, size: stats.size })\n      deps.emit(\"converted\", { input: result.file, output: filePath })\n    }\n\n    // Set file modification times so segments sort chronologically\n    for (let i = 0; i < segmentFiles.length; i++) {\n      const fp = join(parsed.dir, segmentFiles[i]!)\n      const segStart = recStartMs + i * segmentDurationSec * 1000\n      utimesSync(fp, new Date(segStart), new Date(segStart))\n    }\n\n    deps.emit(\"segmenting:end\", { segments: segmentFiles.length })\n\n    // Normalize audio for each segment if enabled\n    if (deps.audioNormalizer) {\n      const normalizer = deps.audioNormalizer\n      const normalizePromises = segmentFiles.map(async (segFile) => {\n        const segPath = join(parsed.dir, segFile)\n        try {\n          await normalizer.normalize(segPath)\n        } catch {\n          // Error already emitted via onError callback\n        }\n      })\n      deps.pendingRemuxes.push(...normalizePromises)\n      await Promise.allSettled(normalizePromises)\n    }\n\n    deps.setState({\n      currentFile: segmentFiles.length > 0 ? join(parsed.dir, segmentFiles.at(-1)!) : result.file,\n      sessionDuration: result.duration,\n    })\n  } catch (err) {\n    if (deps.stopRequested()) return\n    const msg = err instanceof Error ? err.message : String(err)\n    deps.logger.error(`Segmenting failed: ${msg}`)\n    deps.setState({ lastError: `Segmenting failed: ${msg}` })\n    // Fallback: try simple conversion of the whole TS\n    await runFallbackConversion(result, deps)\n  }\n}\n\n// ─── Shared converter helper ────────────────────────────────────\n\n/**\n * Convert a downloaded file to MP4 and optionally normalize audio.\n * Shared by the direct conversion and fallback paths.\n *\n * @param emitRecordingEnd  When true, also emit a `recording:end` event\n *   (used by the direct conversion path; the segmenting path emits its\n *   own `recording:end` events per segment).\n */\nasync function convertFile(\n  result: DownloadResult,\n  deps: ProcessingDeps,\n  emitRecordingEnd?: boolean,\n): Promise<void> {\n  deps.emit(\"converting:start\", { input: result.file })\n  try {\n    const convertPromise = deps.converter.convert(result.file)\n    deps.pendingRemuxes.push(convertPromise)\n    const mp4File = await convertPromise\n\n    if (deps.audioNormalizer) {\n      const normalizePromise = deps.audioNormalizer.normalize(mp4File).catch(() => {})\n      deps.pendingRemuxes.push(normalizePromise)\n      await normalizePromise\n    }\n\n    if (emitRecordingEnd) {\n      deps.emit(\"recording:end\", { file: mp4File, duration: result.duration, size: result.size })\n    }\n    deps.emit(\"converted\", { input: result.file, output: mp4File })\n  } catch (convErr) {\n    const tkErr =\n      convErr instanceof TikTokError ? convErr : new TikTokError(\"unknown\", String(convErr))\n    deps.logger.error(`Conversion failed: ${tkErr.message}`)\n    deps.setState({ lastError: `Conversion failed: ${tkErr.message}` })\n    deps.emit(\"error\", tkErr)\n  }\n}\n\n// ─── Conversion path (no segmenting) ─────────────────────────────\n\nasync function processConversion(\n  result: DownloadResult,\n  _cfg: RecorderConfig,\n  deps: ProcessingDeps,\n): Promise<void> {\n  return convertFile(result, deps, true)\n}\n\n// ─── Fallback conversion (when segmenting fails) ─────────────────\n\nasync function runFallbackConversion(result: DownloadResult, deps: ProcessingDeps): Promise<void> {\n  return convertFile(result, deps)\n}\n"],"mappings":"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"}

package/dist/recorder/recorder-events.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"recorder-events.mjs","names":[],"sources":["../../src/recorder/recorder-events.ts"],"sourcesContent":["/**\n * Typed event emitter for recorder lifecycle events.\n */\n\nimport type { RecorderEvent, RecorderEventHandler } from \"../config\"\n\nexport interface RecorderEventEmitter {\n  on<E extends RecorderEvent>(event: E, handler: RecorderEventHandler[E]): void\n  off<E extends RecorderEvent>(event: E, handler: RecorderEventHandler[E]): void\n  emit<E extends RecorderEvent>(event: E, ...args: Parameters<RecorderEventHandler[E]>): void\n  clear(): void\n}\n\nexport function createEventEmitter(): RecorderEventEmitter {\n  const handlers = new Map<string, Array<(...args: any[]) => void>>()\n\n  function on<E extends RecorderEvent>(event: E, handler: RecorderEventHandler[E]): void {\n    const list = handlers.get(event) ?? []\n    list.push(handler as (...args: any[]) => void)\n    handlers.set(event, list)\n  }\n\n  function off<E extends RecorderEvent>(event: E, handler: RecorderEventHandler[E]): void {\n    const list = handlers.get(event)\n    if (!list) return\n    const idx = list.indexOf(handler as (...args: any[]) => void)\n    if (idx !== -1) list.splice(idx, 1)\n  }\n\n  function emit<E extends RecorderEvent>(\n    event: E,\n    ...args: Parameters<RecorderEventHandler[E]>\n  ): void {\n    const list = handlers.get(event)\n    if (list) {\n      for (const h of list) {\n        try {\n          h(...args)\n        } catch {\n          // Never let an event handler crash the recorder\n        }\n      }\n    }\n  }\n\n  function clear(): void {\n    handlers.clear()\n  }\n\n  return { on, off, emit, clear }\n}\n"],"mappings":";AAaA,SAAgB,qBAA2C;CACzD,MAAM,2BAAW,IAAI,IAA6C;CAElE,SAAS,GAA4B,OAAU,SAAwC;EACrF,MAAM,OAAO,SAAS,IAAI,KAAK,KAAK,CAAC;EACrC,KAAK,KAAK,OAAmC;EAC7C,SAAS,IAAI,OAAO,IAAI;CAC1B;CAEA,SAAS,IAA6B,OAAU,SAAwC;EACtF,MAAM,OAAO,SAAS,IAAI,KAAK;EAC/B,IAAI,CAAC,MAAM;EACX,MAAM,MAAM,KAAK,QAAQ,OAAmC;EAC5D,IAAI,QAAQ,IAAI,KAAK,OAAO,KAAK,CAAC;CACpC;CAEA,SAAS,KACP,OACA,GAAG,MACG;EACN,MAAM,OAAO,SAAS,IAAI,KAAK;EAC/B,IAAI,MACF,KAAK,MAAM,KAAK,MACd,IAAI;GACF,EAAE,GAAG,IAAI;EACX,QAAQ,CAER;CAGN;CAEA,SAAS,QAAc;EACrB,SAAS,MAAM;CACjB;CAEA,OAAO;EAAE;EAAI;EAAK;EAAM;CAAM;AAChC"}

package/dist/recorder/recorder-state.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"recorder-state.mjs","names":[],"sources":["../../src/recorder/recorder-state.ts"],"sourcesContent":["/**\n * State machine for the recorder lifecycle.\n */\n\nimport type { RecorderStatus } from \"../config\"\nimport type { Logger } from \"../logger\"\n\n// Valid state transitions: [from] → [to, to, ...]\nconst TRANSITIONS: Record<string, string[]> = {\n  idle: [\"polling\"],\n  polling: [\"recording\", \"stopped\"],\n  recording: [\"converting\", \"stopped\"],\n  converting: [\"polling\", \"stopped\"],\n  stopped: [],\n}\n\nexport interface RecorderStateManager {\n  setState(partial: Partial<RecorderStatus>): void\n  getStatus(): RecorderStatus\n}\n\nexport function createRecorderState(initial: RecorderStatus, logger: Logger): RecorderStateManager {\n  let state: RecorderStatus = { ...initial }\n\n  function setState(partial: Partial<RecorderStatus>): void {\n    const prevState = state.state\n    const newState = partial.state\n\n    // Validate state transitions\n    if (newState && newState !== prevState) {\n      const allowed = TRANSITIONS[prevState]\n      if (!allowed?.includes(newState)) {\n        logger.error(`Invalid state transition: ${prevState} → ${newState} (ignored)`)\n        return\n      }\n      logger.info(`State: ${prevState} → ${newState}`)\n    }\n\n    state = { ...state, ...partial }\n\n    // Auto-track timestamps on state entry\n    if (newState === \"polling\" && newState !== prevState) {\n      state.lastPollTime = new Date().toISOString()\n    }\n  }\n\n  function getStatus(): RecorderStatus {\n    return { ...state }\n  }\n\n  return { setState, getStatus }\n}\n"],"mappings":";AAQA,MAAM,cAAwC;CAC5C,MAAM,CAAC,SAAS;CAChB,SAAS,CAAC,aAAa,SAAS;CAChC,WAAW,CAAC,cAAc,SAAS;CACnC,YAAY,CAAC,WAAW,SAAS;CACjC,SAAS,CAAC;AACZ;AAOA,SAAgB,oBAAoB,SAAyB,QAAsC;CACjG,IAAI,QAAwB,EAAE,GAAG,QAAQ;CAEzC,SAAS,SAAS,SAAwC;EACxD,MAAM,YAAY,MAAM;EACxB,MAAM,WAAW,QAAQ;EAGzB,IAAI,YAAY,aAAa,WAAW;GAEtC,IAAI,CADY,YAAY,UAChB,EAAE,SAAS,QAAQ,GAAG;IAChC,OAAO,MAAM,6BAA6B,UAAU,KAAK,SAAS,WAAW;IAC7E;GACF;GACA,OAAO,KAAK,UAAU,UAAU,KAAK,UAAU;EACjD;EAEA,QAAQ;GAAE,GAAG;GAAO,GAAG;EAAQ;EAG/B,IAAI,aAAa,aAAa,aAAa,WACzC,MAAM,gCAAe,IAAI,KAAK,EAAA,CAAE,YAAY;CAEhD;CAEA,SAAS,YAA4B;EACnC,OAAO,EAAE,GAAG,MAAM;CACpB;CAEA,OAAO;EAAE;EAAU;CAAU;AAC/B"}

package/dist/recorder/stream.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.mjs","names":[],"sources":["../../src/recorder/stream.ts"],"sourcesContent":["/**\n * Stream downloader — downloads a live stream to disk using FFmpeg.\n *\n * Both FLV and HLS streams are downloaded via FFmpeg subprocess with\n * transparent reconnection for transient network drops. Routes to the\n * appropriate downloader based on URL format.\n */\n\nimport type { Logger } from \"../logger\"\nimport { ensureDir } from \"../utils\"\nimport { downloadStream } from \"./download\"\n\nexport interface ProgressInfo {\n  bytes: number\n  elapsed: number\n  speed: number\n}\n\nexport interface DownloadResult {\n  file: string\n  duration: number\n  size: number\n}\n\nexport interface StreamDownloader {\n  /** Download a live stream. Resolves when the stream ends or is aborted. */\n  download: (\n    liveUrl: string,\n    user: string,\n    outputDir: string,\n    maxDuration?: number,\n    onProgress?: (info: ProgressInfo) => void,\n    /** Called when a stream segment ends and we attempt to fetch a fresh URL. */\n    getNextUrl?: () => Promise<string | null>,\n  ) => Promise<DownloadResult>\n  /** Abort an active download */\n  abort: () => void\n}\n\nexport function createStreamDownloader(logger?: Logger): StreamDownloader {\n  let abortController = new AbortController()\n\n  function abort(): void {\n    abortController.abort()\n  }\n\n  function isHlsUrl(url: string): boolean {\n    return url.includes(\".m3u8\")\n  }\n\n  async function download(\n    liveUrl: string,\n    user: string,\n    outputDir: string,\n    maxDuration = 0,\n    onProgress?: (info: ProgressInfo) => void,\n    getNextUrl?: () => Promise<string | null>,\n  ): Promise<DownloadResult> {\n    abortController = new AbortController()\n    ensureDir(outputDir)\n\n    return downloadStream(\n      liveUrl,\n      user,\n      outputDir,\n      maxDuration,\n      onProgress,\n      getNextUrl,\n      abortController.signal,\n      logger,\n      isHlsUrl(liveUrl) ? \"HLS\" : undefined,\n    )\n  }\n\n  return { download, abort }\n}\n"],"mappings":";;;AAuCA,SAAgB,uBAAuB,QAAmC;CACxE,IAAI,kBAAkB,IAAI,gBAAgB;CAE1C,SAAS,QAAc;EACrB,gBAAgB,MAAM;CACxB;CAEA,SAAS,SAAS,KAAsB;EACtC,OAAO,IAAI,SAAS,OAAO;CAC7B;CAEA,eAAe,SACb,SACA,MACA,WACA,cAAc,GACd,YACA,YACyB;EACzB,kBAAkB,IAAI,gBAAgB;EACtC,UAAU,SAAS;EAEnB,OAAO,eACL,SACA,MACA,WACA,aACA,YACA,YACA,gBAAgB,QAChB,QACA,SAAS,OAAO,IAAI,QAAQ,KAAA,CAC9B;CACF;CAEA,OAAO;EAAE;EAAU;CAAM;AAC3B"}

package/dist/ui.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ui.mjs","names":[],"sources":["../src/ui.ts"],"sourcesContent":["/**\n * Terminal Display Manager — beautiful console output using koko-cli's\n * spinner, icons, and color utilities.\n *\n * This module owns the terminal and should be the only thing writing to\n * stdout/stderr (the file logger handles persistent logs).\n */\n\nimport type { SpinnerInstance } from \"@zfadhli/koko-cli\"\nimport {\n  color,\n  createSpinner,\n  ICON_ERROR,\n  ICON_INFO,\n  ICON_SUCCESS,\n  ICON_WARN,\n} from \"@zfadhli/koko-cli\"\nimport { formatDuration } from \"./utils\"\n\nexport interface Display {\n  /** Called once when polling begins. */\n  pollingStarted(intervalMinutes: number): void\n  /** Spinner while checking if a user is live. */\n  checkingUser(user: string): void\n  /** User is offline (no active display). */\n  userOffline(user: string): void\n  /** User is still offline — updates the previous offline line with a timestamp. */\n  userOfflineRepeat(user: string, lastCheck: string): void\n  /** User is live! Clears the checking spinner. */\n  userLive(user: string, roomId: string): void\n\n  /** Recording starts: spinner without filename (known only post-download). */\n  startRecording(): void\n  /** Recording finished successfully. Shows filename from the result. */\n  finishRecording(filename: string, duration: number, size: string): void\n  /** Recording encountered a non-fatal error. */\n  recordingError(message: string): void\n\n  /** FFmpeg segmenting starts. */\n  startSegmenting(): void\n  /** FFmpeg segmenting done. */\n  segmentsCreated(count: number): void\n\n  /** FFmpeg simple conversion starts (fallback path). */\n  startConverting(): void\n  /** Simple conversion done. */\n  conversionDone(output: string): void\n\n  /** Audio normalization starts (EBU R128 via peaknorm). */\n  normalizeStart(): void\n  /** Audio normalization progress update. */\n  normalizeProgress(percent: number, phase: string): void\n  /** Audio normalization completed successfully. */\n  normalizeComplete(): void\n  /** Audio normalization failed. */\n  normalizeError(message: string): void\n\n  /** Show version banner at startup. */\n  showVersion(name: string, version: string): void\n\n  /** General-purpose status helpers. */\n  showError(message: string): void\n  showInfo(message: string): void\n  showWarning(message: string): void\n\n  /** Stop all active spinners and clean up the terminal. */\n  stop(): void\n}\n\nexport function createDisplay(): Display {\n  let activeSpinner: SpinnerInstance | null = null\n  let offlineLineShown = false\n\n  // Recording timer state\n  let recordingStartTime: number | null = null\n  let recordingTimer: ReturnType<typeof setInterval> | null = null\n\n  /** Stop the currently active spinner (if any) without printing anything. */\n  function clearSpinner(): void {\n    if (recordingTimer) {\n      clearInterval(recordingTimer)\n      recordingTimer = null\n    }\n    if (activeSpinner?.isSpinning) {\n      activeSpinner.stop()\n    }\n    activeSpinner = null\n  }\n\n  /** Stop the current spinner and print a one-liner with the given icon. */\n  function finalize(icon: string, text: string): void {\n    clearSpinner()\n    process.stdout.write(`${icon}${text}\\n`)\n  }\n\n  return {\n    pollingStarted(intervalMinutes: number): void {\n      finalize(ICON_SUCCESS, color.dim(`Polling started (every ${intervalMinutes} min)`))\n    },\n\n    checkingUser(user: string): void {\n      clearSpinner()\n      activeSpinner = createSpinner(color.cyan(`Checking @${user}...`))\n      activeSpinner.start()\n    },\n\n    userOffline(user: string): void {\n      finalize(ICON_INFO, color.dim(`@${user} is offline`))\n      offlineLineShown = true\n    },\n\n    userOfflineRepeat(user: string, lastCheck: string): void {\n      clearSpinner()\n      if (offlineLineShown) {\n        // Move cursor up one line and overwrite the previous offline message\n        process.stdout.write(\n          `\\x1b[1A\\r${ICON_INFO}${color.dim(`@${user} is offline`)} ${color.dim(`[last online: ${lastCheck}]`)}\\x1b[K\\n`,\n        )\n      } else {\n        // Fallback if state is out of sync\n        process.stdout.write(\n          `${ICON_INFO}${color.dim(`@${user} is offline`)} ${color.dim(`[last online: ${lastCheck}]`)}\\n`,\n        )\n        offlineLineShown = true\n      }\n    },\n\n    userLive(user: string, roomId: string): void {\n      clearSpinner()\n      offlineLineShown = false\n      process.stdout.write(\n        `${ICON_SUCCESS}${color.green(`@${user} is LIVE!`)} ${color.dim(`(room: ${roomId})`)}\\n`,\n      )\n    },\n\n    startRecording(): void {\n      clearSpinner()\n      recordingStartTime = Date.now()\n      activeSpinner = createSpinner(`${color.cyan(\"Recording...\")} ${color.dim(\"[0s]\")}`)\n      activeSpinner.start()\n\n      recordingTimer = setInterval(() => {\n        if (!activeSpinner?.isSpinning || !recordingStartTime) return\n        const elapsed = (Date.now() - recordingStartTime) / 1000\n        activeSpinner.text = `${color.cyan(\"Recording...\")} ${color.dim(`[${formatDuration(elapsed)}]`)}`\n      }, 1000)\n    },\n\n    finishRecording(filename: string, duration: number, size: string): void {\n      finalize(\n        ICON_SUCCESS,\n        `${color.green(\"Recording finished\")} ${color.dim(`${filename} — ${size} in ${formatDuration(duration)}`)}`,\n      )\n    },\n\n    recordingError(message: string): void {\n      finalize(ICON_ERROR, color.red(`Recording failed: ${message}`))\n    },\n\n    startSegmenting(): void {\n      clearSpinner()\n      activeSpinner = createSpinner(color.cyan(\"Segmenting...\"))\n      activeSpinner.start()\n    },\n\n    segmentsCreated(count: number): void {\n      finalize(ICON_SUCCESS, color.green(`Created ${count} MP4 segment${count !== 1 ? \"s\" : \"\"}`))\n    },\n\n    startConverting(): void {\n      clearSpinner()\n      activeSpinner = createSpinner(color.cyan(\"Converting to MP4...\"))\n      activeSpinner.start()\n    },\n\n    conversionDone(output: string): void {\n      finalize(ICON_SUCCESS, color.green(`Converted: ${output}`))\n    },\n\n    normalizeStart(): void {\n      clearSpinner()\n      activeSpinner = createSpinner(color.cyan(\"Normalizing audio...\"))\n      activeSpinner.start()\n    },\n\n    normalizeProgress(percent: number, phase: string): void {\n      if (!activeSpinner?.isSpinning) return\n      const label = phase === \"analyzing\" ? \"Analyzing\" : \"Normalizing\"\n      activeSpinner.text = ` ${label}... ${percent}%`\n    },\n\n    normalizeComplete(): void {\n      finalize(ICON_SUCCESS, color.green(\"Audio normalized\"))\n    },\n\n    normalizeError(message: string): void {\n      finalize(ICON_ERROR, color.red(`Normalization failed: ${message}`))\n    },\n\n    showVersion(name: string, version: string): void {\n      clearSpinner()\n      offlineLineShown = false\n      process.stdout.write(`${color.dim(`${name} ${version}`)}\\n`)\n    },\n\n    showError(message: string): void {\n      clearSpinner()\n      offlineLineShown = false\n      process.stdout.write(`${ICON_ERROR}${color.red(message)}\\n`)\n    },\n\n    showInfo(message: string): void {\n      clearSpinner()\n      offlineLineShown = false\n      process.stdout.write(`${ICON_INFO}${color.dim(message)}\\n`)\n    },\n\n    showWarning(message: string): void {\n      clearSpinner()\n      offlineLineShown = false\n      process.stdout.write(`${ICON_WARN}${color.yellow(message)}\\n`)\n    },\n\n    stop(): void {\n      clearSpinner()\n      offlineLineShown = false\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/utils.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.mjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["/**\n * Utility helpers — pure functions, no side effects.\n */\n\nimport { mkdirSync, statSync } from \"node:fs\"\n\n/** Format a filename like username=2025.06.09_14-30-00_1.flv */\nexport function formatFilename(user: string, ext = \"flv\", part?: number): string {\n  const now = new Date()\n  const pad = (n: number) => String(n).padStart(2, \"0\")\n  const date = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}`\n  const time = `${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`\n  const partSuffix = part !== undefined ? `_part${part}` : \"\"\n  return `${user}=${date}_${time}${partSuffix}.${ext}`\n}\n\n/** Ensure a directory exists (recursive) */\nexport function ensureDir(dir: string): void {\n  mkdirSync(dir, { recursive: true })\n}\n\n/**\n * Sleep for `ms` milliseconds.\n *\n * When an `AbortSignal` is provided and fires before the timer elapses,\n * the promise resolves immediately and the underlying timeout is cleared.\n * This prevents orphaned timers in Promise.race patterns.\n */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve) => {\n    if (signal?.aborted) {\n      resolve()\n      return\n    }\n    const timer = setTimeout(resolve, ms)\n    if (signal) {\n      signal.addEventListener(\n        \"abort\",\n        () => {\n          clearTimeout(timer)\n          resolve()\n        },\n        { once: true },\n      )\n    }\n  })\n}\n\n/** Format bytes to human-readable size */\nexport function bytesToHuman(bytes: number): string {\n  if (bytes === 0) return \"0 B\"\n  const units = [\"B\", \"KB\", \"MB\", \"GB\"]\n  const i = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), units.length - 1)\n  return `${(bytes / 1024 ** i).toFixed(1)} ${units[i]}`\n}\n\n/** Strip leading @ from a username */\nexport function sanitizeUser(user: string): string {\n  return user.replace(/^@+/, \"\").trim()\n}\n\n/** Format a millisecond elapsed time as a relative human-readable string. */\nexport function relativeTime(ms: number): string {\n  const sec = Math.floor(ms / 1000)\n  if (sec < 5) return \"just now\"\n  if (sec < 60) return `${sec}s ago`\n  const min = Math.floor(sec / 60)\n  if (min < 60) return `${min}m ago`\n  const hours = Math.floor(min / 60)\n  const mins = min % 60\n  if (hours < 24) return mins > 0 ? `${hours}h ${mins}m ago` : `${hours}h ago`\n  const days = Math.floor(hours / 24)\n  return `${days}d ago`\n}\n\n/** Format seconds into a compact human-readable duration (e.g. \"1m 5s\", \"30s\"). */\nexport function formatDuration(seconds: number): string {\n  const m = Math.floor(seconds / 60)\n  const s = Math.floor(seconds % 60)\n  if (m > 0) return `${m}m ${s}s`\n  return `${s}s`\n}\n\n/** Find FFmpeg binary via Bun.which() or PATH search. */\nexport function findFfmpegPath(): string | null {\n  const bunWhich = (Bun as any)?.which\n  if (typeof bunWhich === \"function\") {\n    return (bunWhich(\"ffmpeg\") as string) ?? null\n  }\n  const paths = process.env.PATH?.split(\":\") ?? []\n  for (const dir of paths) {\n    try {\n      const full = `${dir}/ffmpeg`\n      statSync(full)\n      return full\n    } catch {\n      // not found in this directory\n    }\n  }\n  return null\n}\n"],"mappings":";;;;;;AAOA,SAAgB,eAAe,MAAc,MAAM,OAAO,MAAuB;CAC/E,MAAM,sBAAM,IAAI,KAAK;CACrB,MAAM,OAAO,MAAc,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;CAIpD,OAAO,GAAG,KAAK,GAAG,GAHF,IAAI,YAAY,IAAI,IAAI,IAAI,SAAS,IAAI,CAAC,IAAI,IAAI,IAAI,QAAQ,CAAC,IAGxD,GAAG,GAFV,IAAI,IAAI,SAAS,CAAC,IAAI,IAAI,IAAI,WAAW,CAAC,IAAI,IAAI,IAAI,WAAW,CAAC,MAC/D,SAAS,KAAA,IAAY,QAAQ,SAAS,GACb,GAAG;AACjD;;AAGA,SAAgB,UAAU,KAAmB;CAC3C,UAAU,KAAK,EAAE,WAAW,KAAK,CAAC;AACpC;;;;;;;;AASA,SAAgB,MAAM,IAAY,QAAqC;CACrE,OAAO,IAAI,SAAS,YAAY;EAC9B,IAAI,QAAQ,SAAS;GACnB,QAAQ;GACR;EACF;EACA,MAAM,QAAQ,WAAW,SAAS,EAAE;EACpC,IAAI,QACF,OAAO,iBACL,eACM;GACJ,aAAa,KAAK;GAClB,QAAQ;EACV,GACA,EAAE,MAAM,KAAK,CACf;CAEJ,CAAC;AACH;;AAGA,SAAgB,aAAa,OAAuB;CAClD,IAAI,UAAU,GAAG,OAAO;CACxB,MAAM,QAAQ;EAAC;EAAK;EAAM;EAAM;CAAI;CACpC,MAAM,IAAI,KAAK,IAAI,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,MAAM,SAAS,CAAC;CACjF,OAAO,IAAI,QAAQ,QAAQ,EAAA,CAAG,QAAQ,CAAC,EAAE,GAAG,MAAM;AACpD;;AAGA,SAAgB,aAAa,MAAsB;CACjD,OAAO,KAAK,QAAQ,OAAO,EAAE,CAAC,CAAC,KAAK;AACtC;;AAGA,SAAgB,aAAa,IAAoB;CAC/C,MAAM,MAAM,KAAK,MAAM,KAAK,GAAI;CAChC,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,MAAM,IAAI,OAAO,GAAG,IAAI;CAC5B,MAAM,MAAM,KAAK,MAAM,MAAM,EAAE;CAC/B,IAAI,MAAM,IAAI,OAAO,GAAG,IAAI;CAC5B,MAAM,QAAQ,KAAK,MAAM,MAAM,EAAE;CACjC,MAAM,OAAO,MAAM;CACnB,IAAI,QAAQ,IAAI,OAAO,OAAO,IAAI,GAAG,MAAM,IAAI,KAAK,SAAS,GAAG,MAAM;CAEtE,OAAO,GADM,KAAK,MAAM,QAAQ,EACnB,EAAE;AACjB;;AAGA,SAAgB,eAAe,SAAyB;CACtD,MAAM,IAAI,KAAK,MAAM,UAAU,EAAE;CACjC,MAAM,IAAI,KAAK,MAAM,UAAU,EAAE;CACjC,IAAI,IAAI,GAAG,OAAO,GAAG,EAAE,IAAI,EAAE;CAC7B,OAAO,GAAG,EAAE;AACd;;AAGA,SAAgB,iBAAgC;CAC9C,MAAM,WAAY,KAAa;CAC/B,IAAI,OAAO,aAAa,YACtB,OAAQ,SAAS,QAAQ,KAAgB;CAE3C,MAAM,QAAQ,QAAQ,IAAI,MAAM,MAAM,GAAG,KAAK,CAAC;CAC/C,KAAK,MAAM,OAAO,OAChB,IAAI;EACF,MAAM,OAAO,GAAG,IAAI;EACpB,SAAS,IAAI;EACb,OAAO;CACT,QAAQ,CAER;CAEF,OAAO;AACT"}