@zfadhli/tokrec 0.2.1 → 0.3.1

package/README.md

@@ -0,0 +1,315 @@
+<div align="center">
+
+# tokrec
+
+**Minimal TikTok live stream recorder — Bun + TypeScript**
+
+<br>
+
+[![CI Status](https://img.shields.io/github/actions/workflow/status/zfadhli/tokrec/ci.yml?style=flat-square&label=CI)](https://github.com/zfadhli/tokrec/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@zfadhli/tokrec?style=flat-square)](https://www.npmjs.com/package/@zfadhli/tokrec)
+[![npm downloads](https://img.shields.io/npm/dw/@zfadhli/tokrec?style=flat-square)](https://www.npmjs.com/package/@zfadhli/tokrec)
+[![Bun](https://img.shields.io/badge/Bun-%3E%3D1.2-14151a?style=flat-square&logo=bun)](https://bun.sh)
+[![License](https://img.shields.io/npm/l/@zfadhli/tokrec?style=flat-square)](LICENSE)
+
+[CLI options](#cli-options) · [Features](#features) · [Installation](#installation) · [Quick start](#quick-start) · [Authentication](#authentication) · [How it works](#how-it-works) · [Library API](#library-api) · [FAQ](#faq)
+
+</div>
+
+`tokrec` polls a TikTok user's live status, detects when they go live, downloads the FLV stream, and post-processes it with FFmpeg into playable MP4 segments. It is available as both a CLI tool and a TypeScript library.
+
+> [!NOTE]
+> This is **not** an all-in-one TikTok downloader. It focuses on **live stream recording** with automatic reconnection, graceful shutdown, and clean terminal output. For downloading uploaded videos, see other tools.
+
+---
+
+## Features
+
+- **Automatic polling** — checks every N minutes (default 3) and starts recording as soon as the user goes live.
+- **Stream reconnection** — TikTok stream segments are short-lived (30–60s). When one ends, `tokrec` transparently fetches a fresh URL and continues writing to the same file.
+- **Time-aligned MP4 segments** — post-recording, FFmpeg splits the raw FLV into configurable-length MP4 segments (default 20 minutes), each independently playable.
+- **Graceful shutdown** — responds to `SIGINT`, `SIGTERM`, and `SIGHUP` (terminal close). Aborts the current download, flushes buffered data, runs FFmpeg, and exits cleanly. A second signal force-kills.
+- **Live progress display** — animated spinner with real-time byte count, elapsed time, and download speed. Built with [@zfadhli/koko-cli](https://github.com/zfadhli/koko-cli).
+- **Cookie-based auth** — seeds a `sessionid_ss` cookie into the HTTP session for authenticated requests, bypassing TikTok's Slardar WAF.
+- **Duration limit** — record for a fixed time (`--duration`) or unlimited (default).
+- **Proxy support** — route traffic through an HTTP proxy for regional access.
+- **Dual entry** — use as a CLI tool or embed `createRecorder()` in your own application.
+- **45+ passing tests** — unit-tested CLI parsing, config validation, stream URL detection, and logger.
+
+---
+
+## Installation
+
+### CLI tool (global)
+
+```bash
+npm install -g @zfadhli/tokrec
+```
+
+Then run with:
+
+```bash
+tiktok-live-recorder -u username
+```
+
+### One-off use (npx)
+
+```bash
+npx @zfadhli/tokrec -u username
+```
+
+### As a library
+
+```bash
+npm install @zfadhli/tokrec
+```
+
+```ts
+import { createRecorder } from '@zfadhli/tokrec'
+
+const recorder = createRecorder({ user: 'username' })
+recorder.on('recording:end', (info) => console.log('Done:', info.file))
+await recorder.start()
+```
+
+> [!TIP]
+> When using as a library, logs print to the console by default. To suppress console output (e.g., if you run your own UI), set `logConsole: false` in the config.
+
+---
+
+## Requirements
+
+- **FFmpeg** — must be on your `$PATH` for FLV→MP4 conversion and segmenting.
+  - Linux: `apt install ffmpeg`
+  - macOS: `brew install ffmpeg`
+  - Windows: `choco install ffmpeg`
+- **Bun** (optional, for development) — Node.js 20+ can run the built package.
+
+---
+
+## Quick start
+
+```bash
+# Record a live stream (Ctrl+C to stop)
+tiktok-live-recorder -u vierstinrovve
+
+# Record for 10 minutes, split into 5-minute segments
+tiktok-live-recorder -u vierstinrovve -d 10 -s 5
+
+# Use a proxy and custom output directory
+tiktok-live-recorder -u vierstinrovve -o ./videos -p http://127.0.0.1:8080
+
+# Specify a cookies file (see Authentication section)
+tiktok-live-recorder -u vierstinrovve -c ./my-cookies.json
+```
+
+---
+
+## CLI options
+
+| Option | Shorthand | Default | Description |
+|--------|-----------|---------|-------------|
+| `--user <name>` | `-u` | _(required)_ | TikTok username (without `@`) |
+| `--output <dir>` | `-o` | `./recordings` | Output directory for recordings |
+| `--interval <minutes>` | `-i` | `3` | Polling interval (minimum 1) |
+| `--duration <minutes>` | `-d` | unlimited | Maximum recording duration |
+| `--segment-minutes <minutes>` | `-s` | `20` | Length of each output MP4 segment |
+| `--proxy <url>` | `-p` | none | HTTP proxy URL |
+| `--cookies <path>` | `-c` | `./cookies.json` | Path to cookies JSON file |
+| `--log-level <level>` | `-l` | `info` | One of: `debug`, `info`, `warn`, `error` |
+
+> [!TIP]
+> `--duration` and `--segment-minutes` both accept values in **minutes**. The tool converts them internally.
+
+---
+
+## Authentication
+
+TikTok's Slardar WAF blocks unauthenticated requests. You must provide a valid `sessionid_ss` cookie to bypass it.
+
+### Setup
+
+1. Open TikTok in your browser and log in.
+2. Open DevTools → **Application** → **Cookies** → `www.tiktok.com`.
+3. Copy the value of `sessionid_ss` and create a `cookies.json` file:
+
+```json
+{
+  "sessionid_ss": "6c74daa215a8f34eeddf5162ca091668"
+}
+```
+
+You can also include the `tt-target-idc` cookie (optional, for regional routing):
+
+```json
+{
+  "sessionid_ss": "6c74daa215a8f34eeddf5162ca091668",
+  "tt-target-idc": "useast2a"
+}
+```
+
+4. Run the tool with `--cookies ./path/to/cookies.json`, or place `cookies.json` in the working directory (auto-detected).
+
+> [!CAUTION]
+> Without valid cookies, the tool will report every user as **offline** because the WAF challenge page won't contain live-stream JSON data.
+
+---
+
+## How it works
+
+### Pipeline
+
+```
+┌────────────┐   ┌──────────────┐   ┌──────────────┐   ┌──────────────┐
+│  Poll tick  │ → │  Detect live  │ → │  Download FLV │ → │  FFmpeg post  │
+│  (every Nm) │   │  via SIGI_    │   │  (auto-reconn.)│   │  (segment/    │
+│             │   │  STATE scrape │   │               │   │   convert)    │
+└────────────┘   └──────────────┘   └──────────────┘   └──────────────┘
+```
+
+1. **Poll tick** — every N minutes, the monitor calls the check function.
+2. **Live detection** — the TikTok profile page is fetched and the `SIGI_STATE` JSON blob is extracted. Stream URL extraction follows a three-tier fallback:
+   - Fast-path from the known `pull_data.stream_data` location (~95% of cases).
+   - Brute-force recursive search of the entire JSON (survives key name changes).
+   - Webcast API fallback (`/webcast/room/info/?aid=1988`).
+3. **Download** — the raw FLV is streamed to disk with a 512 KB buffer and 60-second read timeout. If the stream segment ends, the downloader fetches a fresh URL and continues (up to 100 reconnects per session). The `--duration` limit is checked against total elapsed time across reconnections.
+4. **FFmpeg post-processing** — the FLV is split into time-aligned MP4 segments using `ffmpeg -c copy -f segment -segment_time N -reset_timestamps 1`. If segmenting fails, it falls back to a simple FLV→MP4 conversion.
+
+### Event system
+
+The recorder emits typed events that you can subscribe to via `recorder.on()`:
+
+| Event | Payload | When |
+|-------|---------|------|
+| `checking` | `{ user }` | Before each poll tick |
+| `tick` | `{ user, isLive, roomId? }` | After checking live status |
+| `recording:start` | `{ user, file }` | When recording begins |
+| `download:progress` | `{ bytes, elapsed, speed }` | During download (~1s intervals) |
+| `download:end` | `{ file, duration, size }` | When download completes |
+| `segmenting:start` | `{ input, outputPattern }` | Before FFmpeg segmenting |
+| `segmenting:end` | `{ segments }` | After segmenting |
+| `converting:start` | `{ input }` | Before simple conversion |
+| `converted` | `{ input, output }` | After each segment/file |
+| `error` | `err: TikTokError` | On non-fatal errors |
+
+### Output structure
+
+Recordings are saved as:
+
+```
+./recordings/
+  vierstinrovve=20260609_143000.flv              # raw download (deleted after conversion)
+  vierstinrovve=20260609_143000_part1.mp4        # segment 1
+  vierstinrovve=20260609_143000_part2.mp4        # segment 2
+  ...
+```
+
+File naming: `{username}={YYYYMMDD}_{HHMMSS}[_partN].mp4`
+
+---
+
+## Library API
+
+### `createRecorder(config)`
+
+```ts
+import { createRecorder } from '@zfadhli/tokrec'
+import type { RecorderConfig, RecorderController, RecorderEvent } from '@zfadhli/tokrec'
+
+const recorder: RecorderController = createRecorder({
+  user: 'username',          // required
+  outputDir: './videos',     // default: './recordings'
+  interval: 3,               // polling interval in minutes
+  duration: 600,             // max recording duration in seconds
+  segmentMinutes: 20,        // segment length in minutes
+  proxy: 'http://127.0.0.1:8080',
+  cookies: { sessionid_ss: '...' },
+  logLevel: 'info',
+  logConsole: true,
+})
+```
+
+### `RecorderController`
+
+```ts
+interface RecorderController {
+  start(): Promise<void>
+  stop(): Promise<void>
+  getStatus(): RecorderStatus
+  on<E extends RecorderEvent>(event: E, handler: RecorderEventHandler[E]): void
+}
+```
+
+### `RecorderStatus`
+
+```ts
+interface RecorderStatus {
+  state: 'idle' | 'polling' | 'recording' | 'converting' | 'stopped'
+  user: string
+  currentFile?: string
+  sessionDuration?: number
+  lastPollTime?: string
+  lastError?: string
+}
+```
+
+### Example: watch for live status
+
+```ts
+import { createRecorder } from '@zfadhli/tokrec'
+
+const recorder = createRecorder({ user: 'username' })
+
+recorder.on('checking', ({ user }) => console.log(`Checking @${user}...`))
+recorder.on('tick', ({ isLive, roomId, user }) => {
+  console.log(isLive ? `@${user} is LIVE!` : `@${user} is offline`)
+})
+
+recorder.on('error', (err) => console.error(`[${err.kind}] ${err.message}`))
+
+await recorder.start()
+```
+
+---
+
+## FAQ
+
+### Why does the tool say "offline" for every user?
+
+You likely don't have a valid `sessionid_ss` cookie. See the [Authentication](#authentication) section.
+
+### Why does the download stop after 30 seconds?
+
+TikTok serves live streams as short FLV segments (~30–60s). The tool now reconnects automatically, but older versions stopped after one segment. Update to the latest version.
+
+### Can I record multiple users at the same time?
+
+Run multiple instances of the CLI in separate terminals, each with a different `--user` and `--output`.
+
+### Can I use this with Node.js instead of Bun?
+
+The package is built to ESM for Node.js 20+. The runtime dependency is `@zfadhli/koko-cli` and `wreq-js`, both of which work in Node. Bun is optional for development.
+
+### Where are the log files?
+
+`tiktok-recorder.log` in the working directory, with rotating backups. File logs include full timestamps and levels for debugging.
+
+---
+
+## Troubleshooting
+
+### FFmpeg not found
+
+Install FFmpeg and ensure it is on your `$PATH`:
+
+```bash
+which ffmpeg    # should print a path
+```
+
+### "WAF blocked" errors
+
+Your `sessionid_ss` cookie has expired or is invalid. Generate a fresh one from your browser's DevTools.
+
+### The spinner freezes during download
+
+The download has a 60-second read timeout. If TikTok stops sending data (e.g., network drop), the tool waits 60 seconds before attempting reconnection. If reconnection fails, the download ends with whatever data was buffered.

package/dist/api/tiktok.mjs

@@ -28,29 +28,82 @@ function createTikTokApi(http) {
 		}
 	};
 	async function fetchLiveInfo(user) {
+		let sigi = null;
 		try {
 			const res = await http.get(`${TIKTOK_BASE}/@${user}/live`);
 			if (!res.ok) return null;
-			const sigi = extractSigiState(await res.text());
+			sigi = extractSigiState(await res.text());
 			if (!sigi) return null;
 			const liveRoom = sigi.LiveRoom?.liveRoomUserInfo?.liveRoom;
 			const userInfo = sigi.LiveRoom?.liveRoomUserInfo?.user;
-			if (!liveRoom || !userInfo?.roomId) return null;
-			const roomId = String(userInfo.roomId);
-			const isLive = liveRoom.status === 2;
-			let streamUrl = null;
-			if (isLive) {
-				streamUrl = extractStreamUrlFast(liveRoom);
-				if (!streamUrl) streamUrl = findStreamUrlRecursively(sigi);
-				if (!streamUrl) streamUrl = await fetchStreamUrlFromApi(roomId);
+			if (liveRoom && userInfo?.roomId) {
+				const roomId = String(userInfo.roomId);
+				const isLive = liveRoom.status === 2;
+				let streamUrl = null;
+				if (isLive) {
+					streamUrl = extractStreamUrlFast(liveRoom);
+					if (!streamUrl) streamUrl = findStreamUrlRecursively(sigi);
+					if (!streamUrl) streamUrl = await fetchStreamUrlFromApi(roomId);
+				}
+				return {
+					roomId,
+					isLive,
+					streamUrl,
+					title: liveRoom.title ?? null
+				};
 			}
+		} catch (_err) {
+			return null;
+		}
+		return fetchLiveInfoFallback(sigi, user);
+	}
+	/**
+	* Secondary live-info extraction when SIGI_STATE's LiveRoom data is
+	* async-loaded.  Uses LiveRoom.liveRoomStatus for the live flag and
+	* UserModule.users[user].roomId for the room ID.  Stream URL is obtained
+	* from the Webcast API (room/info/) as a final fallback.
+	*/
+	async function fetchLiveInfoFallback(sigi, user) {
+		const isLive = sigi.LiveRoom?.liveRoomStatus === 2;
+		const userModule = sigi.UserModule?.users?.[user];
+		let roomId = null;
+		if (userModule?.roomId) roomId = typeof userModule.roomId === "object" ? String(userModule.roomId.id ?? "") : String(userModule.roomId);
+		if (roomId) {
+			const streamUrl = isLive ? await fetchStreamUrlFromApi(roomId) : null;
 			return {
 				roomId,
 				isLive,
 				streamUrl,
-				title: liveRoom.title ?? null
+				title: null
 			};
-		} catch (_err) {
+		}
+		if (userModule?.id && isLive) return fetchRoomInfoFromApi(userModule.id);
+		return null;
+	}
+	/**
+	* Fallback: fetch room info + stream URL from the Webcast API.
+	* This covers cases where SIGI_STATE has no room data at all
+	* (fully async-loaded page).
+	*/
+	async function fetchRoomInfoFromApi(userId) {
+		try {
+			const url = `${WEBCAST_BASE}/webcast/room/enter/?aid=1988&user_id=${userId}`;
+			const res = await http.get(url);
+			if (!res.ok) return null;
+			const text = await res.text();
+			if (text.length === 0) return null;
+			const roomData = JSON.parse(text)?.data?.room;
+			if (!roomData) return null;
+			const roomId = String(roomData.roomId ?? "");
+			if (!roomId) return null;
+			const isLive = roomData.status === 2;
+			return {
+				roomId,
+				isLive,
+				streamUrl: isLive ? findStreamUrlRecursively(roomData) : null,
+				title: roomData.title ?? null
+			};
+		} catch {
 			return null;
 		}
 	}

package/dist/api/tiktok.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tiktok.mjs","names":[],"sources":["../../src/api/tiktok.ts"],"sourcesContent":["/**\n * TikTok API — resolves room IDs, live status, and stream URLs from a single\n * SIGI_STATE HTML scrape. No webcast API calls needed.\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\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_BASE = 'https://www.tiktok.com'\nconst WEBCAST_BASE = 'https://webcast.tiktok.com'\n\nexport function createTikTokApi(http: HttpClient): TikTokApi {\n  // Per-tick cache — stores the last fetched live info so the three public\n  // methods don't each fetch the page separately.\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      const info = await fetchLiveInfo(cachedUser || roomId)\n      return info?.isLive ?? false\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 ─────────────────\n\n  async function fetchLiveInfo(user: string): Promise<LiveInfo | null> {\n    try {\n      const res = await http.get(`${TIKTOK_BASE}/@${user}/live`)\n      if (!res.ok) return null\n\n      const html = await res.text()\n      const sigi = extractSigiState(html)\n      if (!sigi) return null\n\n      const liveRoom = sigi.LiveRoom?.liveRoomUserInfo?.liveRoom\n      const userInfo = sigi.LiveRoom?.liveRoomUserInfo?.user\n\n      if (!liveRoom || !userInfo?.roomId) return null\n\n      const roomId = String(userInfo.roomId)\n      const isLive = liveRoom.status === 2 // 2 = live, 4 = offline\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) {\n          streamUrl = findStreamUrlRecursively(sigi)\n        }\n        if (!streamUrl) {\n          streamUrl = await fetchStreamUrlFromApi(roomId)\n        }\n      }\n\n      return { roomId, isLive, streamUrl, title: liveRoom.title ?? null }\n    } catch (_err) {\n      // Timeout (15s) or network error → treat as offline\n      return null\n    }\n  }\n\n  /**\n   * Fallback: fetch stream URL from the Webcast API.\n   * This covers cases where SIGI_STATE doesn't include stream data\n   * (e.g. async-loaded room info).\n   */\n  async function fetchStreamUrlFromApi(roomId: string): Promise<string | 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      if (!res.ok) return null\n\n      const text = await res.text()\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 findStreamUrlRecursively(data)\n    } catch {\n      return null\n    }\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        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}\n\n// ─── HTML parsing ──────────────────────────────────────────\n\nfunction 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// ─── 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 */\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    const qualities = ['origin', 'fhd', 'uhd', 'hd', 'sd', 'ld']\n    for (const q of qualities) {\n      const entry = data[q] as { main?: { flv?: string } } | undefined\n      const url = entry?.main?.flv\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 * Inspired by PR #430 (Michele0303/tiktok-live-recorder).\n */\nexport function findStreamUrlRecursively(obj: unknown): string | null {\n  // Base case: a string\n  if (typeof obj === 'string') {\n    // Direct URL match\n    if (\n      (obj.startsWith('http://') || obj.startsWith('https://')) &&\n      (obj.includes('.flv') || obj.includes('.m3u8'))\n    ) {\n      return obj\n    }\n    // JSON-encoded string — parse and recurse (covers stream_data, etc.)\n    if (obj.startsWith('{') || obj.startsWith('[')) {\n      try {\n        return findStreamUrlRecursively(JSON.parse(obj))\n      } catch {\n        return null\n      }\n    }\n    return null\n  }\n\n  // Dict: recurse into all values\n  if (obj && typeof obj === 'object' && !Array.isArray(obj)) {\n    for (const val of Object.values(obj as Record<string, unknown>)) {\n      const found = findStreamUrlRecursively(val)\n      if (found) return found\n    }\n    return null\n  }\n\n  // Array: recurse into all elements\n  if (Array.isArray(obj)) {\n    for (const item of obj) {\n      const found = findStreamUrlRecursively(item)\n      if (found) return found\n    }\n  }\n\n  return null\n}\n"],"mappings":"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"}
+{"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, ~95% of\n * cases).  Fallback paths handle async-loaded room info by reading\n * UserModule / LiveRoom.liveRoomStatus from SIGI_STATE and, when needed,\n * calling the Webcast API (room/info/ or room/enter/).\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\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_BASE = \"https://www.tiktok.com\";\nconst WEBCAST_BASE = \"https://webcast.tiktok.com\";\n\nexport function createTikTokApi(http: HttpClient): TikTokApi {\n  // Per-tick cache — stores the last fetched live info so the three public\n  // methods don't each fetch the page separately.\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      const info = await fetchLiveInfo(cachedUser || roomId);\n      return info?.isLive ?? false;\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 ─────────────────\n\n  async function fetchLiveInfo(user: string): Promise<LiveInfo | null> {\n    // Track whether SIGI_STATE actually existed (for retry decisions)\n    let sigi: SigiState | null = null;\n\n    try {\n      const res = await http.get(`${TIKTOK_BASE}/@${user}/live`);\n      if (!res.ok) return null;\n\n      const html = await res.text();\n      sigi = extractSigiState(html);\n      if (!sigi) return null;\n\n      // ── Primary path: room info in LiveRoom.liveRoomUserInfo ──\n      const liveRoom = sigi.LiveRoom?.liveRoomUserInfo?.liveRoom;\n      const userInfo = sigi.LiveRoom?.liveRoomUserInfo?.user;\n\n      if (liveRoom && userInfo?.roomId) {\n        const roomId = String(userInfo.roomId);\n        const isLive = liveRoom.status === 2; // 2 = live, 4 = offline\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    } catch (_err) {\n      // Timeout (15s) or network error → treat as offline\n      return null;\n    }\n\n    // ── Fallback path: async-loaded room info ──\n    // When LiveRoom.liveRoomUserInfo is absent, check LiveRoom.liveRoomStatus\n    // and UserModule.users[user].roomId, then use the Webcast API for stream URL.\n    return fetchLiveInfoFallback(sigi, user);\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(\n    sigi: SigiState,\n    user: string,\n  ): 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    // Final fallback: Webcast room/enter API using the numeric user ID\n    if (userModule?.id && isLive) {\n      return fetchRoomInfoFromApi(userModule.id);\n    }\n\n    return null; // truly offline / unknown\n  }\n\n  /**\n   * Fallback: fetch room info + stream URL from the Webcast API.\n   * This covers cases where SIGI_STATE has no room data at all\n   * (fully async-loaded page).\n   */\n  async function fetchRoomInfoFromApi(\n    userId: string,\n  ): Promise<LiveInfo | null> {\n    try {\n      const url = `${WEBCAST_BASE}/webcast/room/enter/?aid=1988&user_id=${userId}`;\n      const res = await http.get(url);\n      if (!res.ok) return null;\n\n      const text = await res.text();\n      if (text.length === 0) return null;\n\n      const data = JSON.parse(text) as Record<string, unknown>;\n      const roomData = (data as any)?.data?.room;\n      if (!roomData) return null;\n\n      const roomId = String(roomData.roomId ?? \"\");\n      if (!roomId) return null;\n\n      const roomStatus = roomData.status; // 2 = live\n      const isLive = roomStatus === 2;\n      const streamUrl = isLive ? findStreamUrlRecursively(roomData) : null;\n\n      return { roomId, isLive, streamUrl, title: roomData.title ?? null };\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Fallback: fetch stream URL from the Webcast API.\n   * This covers cases where SIGI_STATE doesn't include stream data\n   * (e.g. async-loaded room info).\n   */\n  async function fetchStreamUrlFromApi(roomId: string): Promise<string | 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      if (!res.ok) return null;\n\n      const text = await res.text();\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 findStreamUrlRecursively(data);\n    } catch {\n      return null;\n    }\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\nfunction extractSigiState(html: string): SigiState | null {\n  const match = html.match(\n    /<script\\s+id=\"SIGI_STATE\"\\s+type=\"application\\/json\">(.*?)<\\/script>/,\n  );\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// ─── 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 */\nfunction extractStreamUrlFast(\n  liveRoom: NonNullable<\n    NonNullable<SigiState[\"LiveRoom\"]>[\"liveRoomUserInfo\"]\n  >[\"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\n      | Record<string, unknown>\n      | undefined;\n    if (!data) return null;\n\n    // Try all known quality keys, preferring higher quality\n    const qualities = [\"origin\", \"fhd\", \"uhd\", \"hd\", \"sd\", \"ld\"];\n    for (const q of qualities) {\n      const entry = data[q] as { main?: { flv?: string } } | undefined;\n      const url = entry?.main?.flv;\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 * Inspired by PR #430 (Michele0303/tiktok-live-recorder).\n */\nexport function findStreamUrlRecursively(obj: unknown): string | null {\n  // Base case: a string\n  if (typeof obj === \"string\") {\n    // Direct URL match\n    if (\n      (obj.startsWith(\"http://\") || obj.startsWith(\"https://\")) &&\n      (obj.includes(\".flv\") || obj.includes(\".m3u8\"))\n    ) {\n      return obj;\n    }\n    // JSON-encoded string — parse and recurse (covers stream_data, etc.)\n    if (obj.startsWith(\"{\") || obj.startsWith(\"[\")) {\n      try {\n        return findStreamUrlRecursively(JSON.parse(obj));\n      } catch {\n        return null;\n      }\n    }\n    return null;\n  }\n\n  // Dict: recurse into all values\n  if (obj && typeof obj === \"object\" && !Array.isArray(obj)) {\n    for (const val of Object.values(obj as Record<string, unknown>)) {\n      const found = findStreamUrlRecursively(val);\n      if (found) return found;\n    }\n    return null;\n  }\n\n  // Array: recurse into all elements\n  if (Array.isArray(obj)) {\n    for (const item of obj) {\n      const found = findStreamUrlRecursively(item);\n      if (found) return found;\n    }\n  }\n\n  return null;\n}\n"],"mappings":"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"}

package/dist/cli.mjs

@@ -1,5 +1,6 @@
 import { TikTokError } from "./config.mjs";
 import { sanitizeUser } from "./utils.mjs";
+import { version } from "./package.mjs";
 import { createCLI } from "@zfadhli/koko-cli";
 //#region src/cli.ts
 /**
@@ -9,9 +10,9 @@ import { createCLI } from "@zfadhli/koko-cli";
 function parseArgs(argv = process.argv) {
 	let config;
 	let error;
-	const cli = createCLI("tiktok-live-recorder", "0.2.1").description("Minimal TikTok live stream recorder — Bun + TypeScript");
+	const cli = createCLI("tiktok-live-recorder", version).description("Minimal TikTok live stream recorder — Bun + TypeScript");
 	cli.command("", "Record a TikTok live stream", (cmd) => {
-		cmd.option("-u, --user <name>", "TikTok username (required)");
+		cmd.option("-u, --user <name>", "TikTok username (or pass as first argument)");
 		cmd.option("-o, --output <dir>", "Output directory", { default: "./recordings" });
 		cmd.option("-i, --interval <minutes>", "Polling interval in minutes", { default: "3" });
 		cmd.option("-d, --duration <minutes>", "Max recording duration in minutes");
@@ -22,7 +23,7 @@ function parseArgs(argv = process.argv) {
 		cmd.action((opts) => {
 			try {
 				const user = opts.user;
-				if (!user) throw new TikTokError("config-error", "--user is required");
+				if (!user) throw new TikTokError("config-error", "<user> is required (positional or --user)");
 				const parsed = { user: sanitizeUser(user) };
 				if (opts.output) parsed.outputDir = opts.output;
 				if (opts.interval !== void 0) {
@@ -58,11 +59,31 @@ function parseArgs(argv = process.argv) {
 			}
 		});
 	});
+	const positionalUser = extractPositional(argv);
+	if (positionalUser) argv.push("--user", positionalUser);
 	cli.parse(argv);
 	if (error) throw new TikTokError("config-error", error);
-	if (!config) throw new TikTokError("config-error", "--user is required. Use --help for usage.");
+	if (!config) throw new TikTokError("config-error", "<user> is required (positional or --user). Use --help for usage.");
 	return config;
 }
+/**
+* Scan argv for the first bare argument that is neither a flag nor a flag's value.
+* Returns the value and removes it from the array, or null if none found.
+*/
+function extractPositional(argv) {
+	for (let i = 2; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg === "--") return argv.splice(i, 1)[0];
+		if (arg.startsWith("-")) {
+			const next = argv[i + 1];
+			if (next && !next.startsWith("-") && arg !== "--help" && arg !== "--version") i++;
+			continue;
+		}
+		argv.splice(i, 1);
+		return arg;
+	}
+	return null;
+}
 //#endregion
 export { parseArgs };
 

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"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 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('tiktok-live-recorder', '0.2.1').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 (required)')\n    cmd.option('-o, --output <dir>', 'Output directory', { default: './recordings' })\n    cmd.option('-i, --interval <minutes>', 'Polling interval in minutes', { default: '3' })\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('-s, --segment-minutes <minutes>', 'Segment duration in minutes', { default: '20' })\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')\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 < 1) {\n            throw new TikTokError('config-error', '--segment-minutes must be a number >= 1')\n          }\n          parsed.segmentMinutes = n\n        }\n\n        config = parsed\n      } catch (err) {\n        error = err instanceof Error ? err.message : String(err)\n      }\n    })\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('config-error', '--user is required. Use --help for usage.')\n  }\n\n  return config\n}\n"],"mappings":";;;;;;;;AAUA,SAAgB,UAAU,OAAiB,QAAQ,MAAsB;CACvE,IAAI;CACJ,IAAI;CAEJ,MAAM,MAAM,UAAU,wBAAwB,OAAO,CAAC,CAAC,YACrD,wDACF;CAEA,IAAI,QAAQ,IAAI,gCAAgC,QAAQ;EACtD,IAAI,OAAO,qBAAqB,4BAA4B;EAC5D,IAAI,OAAO,sBAAsB,oBAAoB,EAAE,SAAS,eAAe,CAAC;EAChF,IAAI,OAAO,4BAA4B,+BAA+B,EAAE,SAAS,IAAI,CAAC;EACtF,IAAI,OAAO,4BAA4B,mCAAmC;EAC1E,IAAI,OAAO,qBAAqB,yCAAyC;EACzE,IAAI,OAAO,2BAA2B,wCAAwC;EAC9E,IAAI,OAAO,wBAAwB,sBAAsB;EACzD,IAAI,OAAO,mCAAmC,+BAA+B,EAAE,SAAS,KAAK,CAAC;EAE9F,IAAI,QAAQ,SAAkC;GAC5C,IAAI;IACF,MAAM,OAAO,KAAK;IAClB,IAAI,CAAC,MACH,MAAM,IAAI,YAAY,gBAAgB,oBAAoB;IAG5D,MAAM,SAAyB,EAC7B,MAAM,aAAa,IAAI,EACzB;IAEA,IAAI,KAAK,QAAQ,OAAO,YAAY,KAAK;IACzC,IAAI,KAAK,aAAa,KAAA,GAAW;KAC/B,MAAM,IAAI,OAAO,KAAK,QAAQ;KAC9B,IAAI,CAAC,OAAO,SAAS,CAAC,KAAK,IAAI,GAC7B,MAAM,IAAI,YAAY,gBAAgB,kCAAkC;KAE1E,OAAO,WAAW;IACpB;IACA,IAAI,KAAK,aAAa,KAAA,GAAW;KAC/B,MAAM,IAAI,OAAO,KAAK,QAAQ;KAC9B,IAAI,CAAC,OAAO,SAAS,CAAC,KAAK,IAAI,GAC7B,MAAM,IAAI,YAAY,gBAAgB,4CAA4C;KAEpF,OAAO,WAAW,IAAI;IACxB;IACA,IAAI,KAAK,OAAO,OAAO,QAAQ,KAAK;IACpC,IAAI,KAAK,UAAU;KACjB,MAAM,SAAS;MAAC;MAAS;MAAQ;MAAQ;KAAO;KAChD,IAAI,CAAC,OAAO,SAAS,KAAK,QAAkB,GAC1C,MAAM,IAAI,YACR,gBACA,+BAA+B,OAAO,KAAK,IAAI,GACjD;KAEF,OAAO,WAAW,KAAK;IACzB;IACA,IAAI,KAAK,SAAS,OAAO,cAAc,KAAK;IAC5C,IAAI,KAAK,mBAAmB,KAAA,GAAW;KACrC,MAAM,IAAI,OAAO,KAAK,cAAc;KACpC,IAAI,CAAC,OAAO,SAAS,CAAC,KAAK,IAAI,GAC7B,MAAM,IAAI,YAAY,gBAAgB,yCAAyC;KAEjF,OAAO,iBAAiB;IAC1B;IAEA,SAAS;GACX,SAAS,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GACzD;EACF,CAAC;CACH,CAAC;CAED,IAAI,MAAM,IAAI;CAEd,IAAI,OACF,MAAM,IAAI,YAAY,gBAAgB,KAAK;CAG7C,IAAI,CAAC,QACH,MAAM,IAAI,YAAY,gBAAgB,2CAA2C;CAGnF,OAAO;AACT"}
+{"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('tiktok-live-recorder', 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', { default: './recordings' })\n    cmd.option('-i, --interval <minutes>', 'Polling interval in minutes', { default: '3' })\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('-s, --segment-minutes <minutes>', 'Segment duration in minutes', { default: '20' })\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 < 1) {\n            throw new TikTokError('config-error', '--segment-minutes must be a number >= 1')\n          }\n          parsed.segmentMinutes = n\n        }\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":";;;;;;;;;AAWA,SAAgB,UAAU,OAAiB,QAAQ,MAAsB;CACvE,IAAI;CACJ,IAAI;CAEJ,MAAM,MAAM,UAAU,wBAAwBA,OAAW,CAAC,CAAC,YACzD,wDACF;CAEA,IAAI,QAAQ,IAAI,gCAAgC,QAAQ;EACtD,IAAI,OAAO,qBAAqB,6CAA6C;EAC7E,IAAI,OAAO,sBAAsB,oBAAoB,EAAE,SAAS,eAAe,CAAC;EAChF,IAAI,OAAO,4BAA4B,+BAA+B,EAAE,SAAS,IAAI,CAAC;EACtF,IAAI,OAAO,4BAA4B,mCAAmC;EAC1E,IAAI,OAAO,qBAAqB,yCAAyC;EACzE,IAAI,OAAO,2BAA2B,wCAAwC;EAC9E,IAAI,OAAO,wBAAwB,sBAAsB;EACzD,IAAI,OAAO,mCAAmC,+BAA+B,EAAE,SAAS,KAAK,CAAC;EAE9F,IAAI,QAAQ,SAAkC;GAC5C,IAAI;IACF,MAAM,OAAO,KAAK;IAClB,IAAI,CAAC,MACH,MAAM,IAAI,YAAY,gBAAgB,2CAA2C;IAGnF,MAAM,SAAyB,EAC7B,MAAM,aAAa,IAAI,EACzB;IAEA,IAAI,KAAK,QAAQ,OAAO,YAAY,KAAK;IACzC,IAAI,KAAK,aAAa,KAAA,GAAW;KAC/B,MAAM,IAAI,OAAO,KAAK,QAAQ;KAC9B,IAAI,CAAC,OAAO,SAAS,CAAC,KAAK,IAAI,GAC7B,MAAM,IAAI,YAAY,gBAAgB,kCAAkC;KAE1E,OAAO,WAAW;IACpB;IACA,IAAI,KAAK,aAAa,KAAA,GAAW;KAC/B,MAAM,IAAI,OAAO,KAAK,QAAQ;KAC9B,IAAI,CAAC,OAAO,SAAS,CAAC,KAAK,IAAI,GAC7B,MAAM,IAAI,YAAY,gBAAgB,4CAA4C;KAEpF,OAAO,WAAW,IAAI;IACxB;IACA,IAAI,KAAK,OAAO,OAAO,QAAQ,KAAK;IACpC,IAAI,KAAK,UAAU;KACjB,MAAM,SAAS;MAAC;MAAS;MAAQ;MAAQ;KAAO;KAChD,IAAI,CAAC,OAAO,SAAS,KAAK,QAAkB,GAC1C,MAAM,IAAI,YACR,gBACA,+BAA+B,OAAO,KAAK,IAAI,GACjD;KAEF,OAAO,WAAW,KAAK;IACzB;IACA,IAAI,KAAK,SAAS,OAAO,cAAc,KAAK;IAC5C,IAAI,KAAK,mBAAmB,KAAA,GAAW;KACrC,MAAM,IAAI,OAAO,KAAK,cAAc;KACpC,IAAI,CAAC,OAAO,SAAS,CAAC,KAAK,IAAI,GAC7B,MAAM,IAAI,YAAY,gBAAgB,yCAAyC;KAEjF,OAAO,iBAAiB;IAC1B;IAEA,SAAS;GACX,SAAS,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GACzD;EACF,CAAC;CACH,CAAC;CAID,MAAM,iBAAiB,kBAAkB,IAAI;CAC7C,IAAI,gBACF,KAAK,KAAK,UAAU,cAAc;CAGpC,IAAI,MAAM,IAAI;CAEd,IAAI,OACF,MAAM,IAAI,YAAY,gBAAgB,KAAK;CAG7C,IAAI,CAAC,QACH,MAAM,IAAI,YACR,gBACA,kEACF;CAGF,OAAO;AACT;;;;;AAMA,SAAS,kBAAkB,MAA+B;CACxD,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,KAAK;EAEjB,IAAI,QAAQ,MAEV,OADY,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC;EAIhC,IAAI,IAAI,WAAW,GAAG,GAAG;GAEvB,MAAM,OAAO,KAAK,IAAI;GACtB,IAAI,QAAQ,CAAC,KAAK,WAAW,GAAG,KAAK,QAAQ,YAAY,QAAQ,aAC/D;GAEF;EACF;EAEA,KAAK,OAAO,GAAG,CAAC;EAChB,OAAO;CACT;CACA,OAAO;AACT"}

package/dist/package.mjs

@@ -0,0 +1,6 @@
+//#region package.json
+var version = "0.3.1";
+//#endregion
+export { version };
+
+//# sourceMappingURL=package.mjs.map

package/dist/package.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.mjs","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zfadhli/tokrec",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Minimal TikTok live stream recorder — Bun + TypeScript",
   "type": "module",
   "main": "./dist/lib.mjs",