tokwatchr 0.4.3 → 0.4.4

package/dist/index.d.mts

@@ -237,6 +237,12 @@ declare class TikTokLiveDownloader {
   private resolveRoomIdOnce;
   private resolveRoomIdWithRetry;
   private fetchStreamInfo;
+  /**
+   * Poll for stream info until the stream becomes active.
+   * Used in waitForLive mode when the room exists but the stream
+   * has not yet started broadcasting.
+   */
+  private pollStreamInfo;
   /**
    * Download a single segment. Always downloads to .ts (crash-safe).
    * Does NOT remux — that is handled by remuxSegment() running in the background.

package/dist/index.mjs

@@ -620,7 +620,7 @@ const DEFAULT_OPTIONS = {
 	bitrate: null,
 	maxDuration: Infinity,
 	maxSegmentDuration: Infinity,
-	checkInterval: 3e4,
+	checkInterval: 18e4,
 	proxyUrl: null,
 	cookieJar: null,
 	browser: "chrome",
@@ -773,7 +773,7 @@ var TikTokLiveDownloader = class {
 			if (!roomId && waitForLive) roomId = await this.resolveRoomIdWithRetry();
 			if (!roomId) throw new UserOfflineError(this.username);
 			this.setState("waiting");
-			const firstInfo = await this.fetchStreamInfo(roomId);
+			const firstInfo = waitForLive ? await this.pollStreamInfo(roomId) : await this.fetchStreamInfo(roomId);
 			if (!(this.options.maxSegmentDuration > 0 && this.options.maxSegmentDuration < Infinity)) {
 				const tsResult = await this.downloadSegment(firstInfo, 1);
 				const finalResult = await this.remuxSegment(tsResult);
@@ -834,7 +834,7 @@ var TikTokLiveDownloader = class {
 	}
 	async resolveRoomIdWithRetry() {
 		const interval = this.options.checkInterval;
-		const maxInterval = Math.max(interval, 3e4);
+		const maxInterval = Math.max(interval, 18e4);
 		while (true) {
 			this.abortController.signal?.throwIfAborted();
 			const roomId = await this.resolveRoomIdOnce();
@@ -852,6 +852,27 @@ var TikTokLiveDownloader = class {
 		return info;
 	}
 	/**
+	* Poll for stream info until the stream becomes active.
+	* Used in waitForLive mode when the room exists but the stream
+	* has not yet started broadcasting.
+	*/
+	async pollStreamInfo(roomId) {
+		const interval = this.options.checkInterval;
+		const maxInterval = Math.max(interval, 18e4);
+		while (true) {
+			this.abortController.signal?.throwIfAborted();
+			try {
+				return await this.fetchStreamInfo(roomId);
+			} catch (err) {
+				if (err instanceof StreamFetchError) {
+					await sleep(maxInterval);
+					continue;
+				}
+				throw err;
+			}
+		}
+	}
+	/**
 	* Download a single segment. Always downloads to .ts (crash-safe).
 	* Does NOT remux — that is handled by remuxSegment() running in the background.
 	*/

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "tokwatchr",
-	"version": "0.4.3",
+	"version": "0.4.4",
 	"description": "Download TikTok livestreams. Given a username, download the livestream.",
 	"type": "module",
 	"main": "./dist/index.mjs",

package/src/TikTokLiveDownloader.ts

@@ -9,7 +9,11 @@ import { resolveRoomId } from "./api/room.js";
 import { fetchStreamInfo } from "./api/stream.js";
 import { downloadWithFfmpeg } from "./download/ffmpeg.js";
 import { downloadRawHttp } from "./download/raw-http.js";
-import { UserNotFoundError, UserOfflineError } from "./errors.js";
+import {
+	StreamFetchError,
+	UserNotFoundError,
+	UserOfflineError,
+} from "./errors.js";
 import type {
 	DownloaderState,
 	DownloadResult,
@@ -32,7 +36,7 @@ const DEFAULT_OPTIONS: ResolvedOptions = {
 	bitrate: null,
 	maxDuration: Infinity,
 	maxSegmentDuration: Infinity,
-	checkInterval: 30_000,
+	checkInterval: 180_000,
 	proxyUrl: null,
 	cookieJar: null,
 	browser: "chrome",
@@ -259,7 +263,9 @@ export class TikTokLiveDownloader {
 
 			// Phase 2: Get stream info (refreshed per segment to avoid stale URLs)
 			this.setState("waiting");
-			const firstInfo = await this.fetchStreamInfo(roomId);
+			const firstInfo = waitForLive
+				? await this.pollStreamInfo(roomId)
+				: await this.fetchStreamInfo(roomId);
 
 			const segmentEnabled =
 				this.options.maxSegmentDuration > 0 &&
@@ -361,7 +367,7 @@ export class TikTokLiveDownloader {
 
 	private async resolveRoomIdWithRetry(): Promise<string> {
 		const interval = this.options.checkInterval;
-		const maxInterval = Math.max(interval, 30_000);
+		const maxInterval = Math.max(interval, 180_000);
 
 		while (true) {
 			this.abortController.signal?.throwIfAborted();
@@ -387,6 +393,30 @@ export class TikTokLiveDownloader {
 		return info;
 	}
 
+	/**
+	 * Poll for stream info until the stream becomes active.
+	 * Used in waitForLive mode when the room exists but the stream
+	 * has not yet started broadcasting.
+	 */
+	private async pollStreamInfo(roomId: string): Promise<StreamInfo> {
+		const interval = this.options.checkInterval;
+		const maxInterval = Math.max(interval, 180_000);
+
+		while (true) {
+			this.abortController.signal?.throwIfAborted();
+
+			try {
+				return await this.fetchStreamInfo(roomId);
+			} catch (err) {
+				if (err instanceof StreamFetchError) {
+					await sleep(maxInterval);
+					continue;
+				}
+				throw err;
+			}
+		}
+	}
+
 	/**
 	 * Download a single segment. Always downloads to .ts (crash-safe).
 	 * Does NOT remux — that is handled by remuxSegment() running in the background.