@zfadhli/tokrec 0.13.0 → 0.15.0

package/README.md

@@ -1,430 +0,0 @@
-<div align="center">
-
-# tokrec
-
-**Minimal TikTok live stream recorder — Bun + TypeScript**
-
-[![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)
-
-[Features](#features) · [Installation](#installation) · [Quick start](#quick-start) · [CLI options](#cli-options) · [Background recording](#background-recording-tmux) · [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 stream, and post-processes it with FFmpeg into playable MP4 segments. 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
-- **Duration-limited recording** — record for a fixed time (`-d`) and auto-exit, or record indefinitely (default)
-- **Time-aligned MP4 segments** — post-recording, optionally split the stream into configurable-length MP4 segments, each independently playable
-- **Audio normalization** — EBU R128 two-pass loudness normalization via [peaknorm](https://github.com/zfadhli/peaknorm)
-- **Graceful shutdown** — responds to `SIGINT`/`SIGTERM`/`SIGHUP`. Aborts the download, flushes buffered data, converts to MP4, and exits cleanly
-- **Firefox cookie auto-detection** — reads `sessionid_ss` from Firefox's SQLite cookie store automatically (no config file needed)
-- **Live progress display** — animated spinner with real-time byte count, elapsed time, and download speed
-- **Typed event system** — 15 events with typed payloads for lifecycle tracking
-- **Proxy support** — route traffic through an HTTP proxy for regional access
-- **FLV + HLS support** — automatically detects and handles both stream formats
-- **Background recording** — tmux integration keeps recordings alive after terminal close, with per-user session management
-- **Multi-user** — record multiple users simultaneously, each in its own tmux session
-- **71+ passing tests** — unit tests with real TikTok HTML/API fixtures
-
----
-
-## Requirements
-
-- **FFmpeg** — must be on your `$PATH` for 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
-
----
-
-## Installation
-
-### CLI tool (global)
-
-```bash
-npm install -g @zfadhli/tokrec
-```
-
-Then run:
-
-```bash
-tokrec -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.
-
----
-
-## Quick start
-
-```bash
-# Record a live stream (Ctrl+C to stop)
-tokrec -u username
-
-# Record for 10 minutes, then exit
-tokrec -u username -d 10
-
-# Record for 10 minutes, split into 5-minute segments
-tokrec -u username -d 10 -s 5
-
-# Use a proxy and custom output directory
-tokrec -u username -o ./videos -p http://127.0.0.1:8080
-
-# Enable audio normalization
-tokrec -u username --normalize
-```
-
-### Background recording (tmux)
-
-```bash
-# Start in background — survives terminal close
-tokrec start -u username
-
-# Record multiple users simultaneously
-tokrec start -u user1
-tokrec start -u user2
-
-# Check active sessions
-tokrec status
-
-# Reattach to see live output
-tmux attach -t tokrec-user1
-
-# Detach without killing (Ctrl+B, D)
-
-# Stop a specific user
-tokrec stop -u user1
-
-# Stop all sessions
-tokrec stop
-```
-
-> [!TIP]
-> Both `-d` and `-s` accept values in **minutes** (the tool converts them internally).
-
----
-
-## CLI options
-
-| Option                        | Shorthand | Default          | Description                                                                                |
-| ----------------------------- | --------- | ---------------- | ------------------------------------------------------------------------------------------ |
-| `--user <name>`               | `-u`      | _(required)_     | TikTok username (with or without `@`)                                                      |
-| `--output <dir>`              | `-o`      | `./recordings`   | Output directory                                                                           |
-| `--interval <minutes>`        | `-i`      | `3`              | Polling interval (min 1)                                                                   |
-| `--duration <minutes>`        | `-d`      | unlimited        | Max recording duration. Implies one-shot (exit after recording)                            |
-| `--segment-minutes <minutes>` | `-s`      | disabled         | Split recording into MP4 segments of this length                                           |
-| `--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`                                                   |
-| `--normalize`                 | _(none)_  | on               | Enable EBU R128 audio normalization (enabled by default, pass `--no-normalize` to disable) |
-| `--normalize-loudness <num>`  | _(none)_  | `-14`            | Target loudness in LUFS                                                                    |
-| `--normalize-codec <name>`    | _(none)_  | `libopus`        | Audio codec for normalized output (peaknorm default)                                       |
-| `--normalize-bitrate <str>`   | _(none)_  | `96k`            | Audio bitrate for normalized output (peaknorm default)                                     |
-| `--rate <n>`                  | _(none)_  | `5`              | Max API requests/sec (0 = unlimited). Prevents WAF triggering                              |
-| `--debug`                     | _(none)_  | off              | Show API debug logging on stderr                                                           |
-
-### Subcommands
-
-| Command  | Description                              | Example                                     |
-| -------- | ---------------------------------------- | ------------------------------------------- |
-| `start`  | Start recorder in a tmux session         | `tokrec start -u username`                  |
-| `stop`   | Stop tmux session(s)                     | `tokrec stop -u username` (or `tokrec stop` to stop all) |
-| `status` | Show active tmux sessions                | `tokrec status`                             |
-| `setup`  | Check cookie status or create cookies.json | `tokrec setup`                            |
-
----
-
-## Authentication
-
-TikTok's Slardar WAF blocks unauthenticated requests. You must provide a valid `sessionid_ss` cookie to bypass it.
-
-### Quick setup
-
-```bash
-tokrec setup
-```
-
-This checks for Firefox cookies (auto-detected) or `cookies.json`. If neither is found, it prompts you to enter your cookie value interactively.
-
-### Option 1: Firefox (auto-detected)
-
-If you're logged into TikTok in Firefox, `tokrec` automatically reads the cookie from Firefox's SQLite store. No config file needed.
-
-```bash
-tokrec -u username
-```
-
-You will see:
-
-```
-tokrec v0.11.0
-ℹ Firefox cookies loaded (30 cookies)
-```
-
-### Option 2: cookies.json
-
-1. Open TikTok in any 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. Place `cookies.json` in the working directory (auto-detected) or pass `--cookies ./path/to/cookies.json`.
-
-> [!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
-
-### Detection flow
-
-```
-fetchLiveInfo(user)
-  ├─ tryFetchPage (www.tiktok.com → m.tiktok.com)
-  │    └─ WAF blocks both → API fallback
-  ├─ /api-live/user/room/ (bypasses WAF)
-  │    └─ Returns roomId + status (2=live, 4=offline)
-  └─ If live → /webcast/room/info/ for stream URL
-
-isRoomAlive(roomId)  [during recording]
-  ├─ Cache hit → return cached.isLive
-  └─ Cache miss → /webcast/room/check_alive/ → boolean (~100 bytes)
-
-getNextUrl()  [during recording]
-  ├─ isRoomAlive(roomId) → if dead, stop
-  ├─ Invalidate cache
-  └─ getLiveUrl(roomId) → fresh stream URL
-```
-
-### Pipeline
-
-```
-┌────────────┐   ┌──────────────┐   ┌──────────────┐   ┌─────────────────┐
-│  Poll tick  │ → │  Detect live │ → │  Download TS  │ → │  FFmpeg post    │
-│  (every Nm) │   │  3-tier      │   │  (auto-reconn.)│   │  (convert/      │
-│             │   │  fallback    │   │               │   │   segment)       │
-└────────────┘   └──────────────┘   └──────────────┘   └─────────────────┘
-```
-
-1. **Poll tick** — every N minutes, the monitor calls the check function.
-2. **Live detection** — uses a three-tier fallback:
-   - Fast-path from `SIGI_STATE` on the `/live` page (~95% of cases)
-   - Brute-force recursive search of the entire JSON (survives key name changes)
-   - Webcast API fallback (`/webcast/room/info/`)
-3. **Download** — the stream is downloaded via FFmpeg stdout pipe to a `.ts` file. TikTok's short-lived URLs are handled transparently: when a URL expires, `getNextUrl()` fetches a fresh one. Duration limit is enforced **inside** FFmpeg via the `-t` flag for precise cutoff.
-4. **Post-processing** — the `.ts` file is remuxed to MP4 via `ffmpeg -c copy` (no re-encode, fast). If segmenting is enabled, FFmpeg's segment muxer splits into `_partN.mp4` files. Audio normalization runs last if enabled.
-
-### Output structure
-
-```
-./recordings/
-  username=20260614_143000.ts               # raw download (deleted after conversion)
-  username=20260614_143000.mp4              # remuxed MP4 (no segmenting)
-  username=20260614_143000_part1.mp4        # segment 1 (with -s)
-  username=20260614_143000_part2.mp4        # segment 2
-  ...
-```
-
-File naming: `{username}={YYYYMMDD}_{HHMMSS}[_partN].mp4`
-
-### 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           |
-| `recording:end`      | `{ file, duration, size }`  | Per segment/file after conversion |
-| `segmenting:start`   | `{ input, outputPattern }`  | Before FFmpeg segmenting          |
-| `segmenting:end`     | `{ segments }`              | After segmenting                  |
-| `converting:start`   | `{ input }`                 | Before simple conversion          |
-| `converted`          | `{ input, output }`         | After each converted file         |
-| `normalize:start`    | `{ file }`                  | Before audio normalization        |
-| `normalize:progress` | `{ file, percent, phase }`  | During normalization              |
-| `normalize:end`      | `{ input, output }`         | After normalization               |
-| `normalize:error`    | `{ input, error }`          | On normalization error            |
-| `error`              | `err: TikTokError`          | On non-fatal errors               |
-
----
-
-## 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;
-  off<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: build a notification bot
-
-```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 }) => {
-  if (isLive) {
-    console.log(`@${user} is LIVE! (room: ${roomId})`);
-    // Send a Discord/Telegram notification here
-  }
-});
-recorder.on("recording:end", ({ file, duration }) => {
-  console.log(`Recorded ${file} (${Math.round(duration)}s)`);
-});
-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). `tokrec` handles reconnection transparently — this is expected behavior and the download continues with a fresh URL.
-
-### Can I record multiple users at once?
-
-Yes. Use tmux background sessions:
-
-```bash
-tokrec start -u user1
-tokrec start -u user2
-tokrec status   # shows all active sessions
-```
-
-Each user gets an independent tmux session (`tokrec-{user}`), so they run in parallel without interfering.
-
-### Can I use this with Node.js instead of Bun?
-
-Yes. The package is built to ESM for Node.js 20+. Bun is optional for development.
-
-### Where are the log files?
-
-`tiktok-recorder.log` in the working directory, with rotating backups. Console output is also available via `--log-level`.
-
-### Does it work if the user goes live while I'm not running it?
-
-No. `tokrec` only polls while it's running. Use tmux background sessions for always-on monitoring:
-
-```bash
-tokrec start -u username   # runs in tmux, survives terminal close
-tmux attach -t tokrec-username   # reattach to view output
-```
-
----
-
-## 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 process doesn't exit after a `-d` recording
-
-Make sure you're using v0.7.1 or later. Earlier versions continued polling instead of exiting.

package/dist/bin.d.mts

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

package/dist/bin.mjs

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

package/dist/bin.mjs.map

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