@oddin-gg/havik-player 2.6.2 → 2.6.3

package/dist/index.d.cts

@@ -906,9 +906,11 @@ export declare interface StreamDescriptor {
  * The body is a `text/event-stream` we parse incrementally. The connection is
  * long-lived (the server caps it at ~30min and sends heartbeats); on any
  * close/error the client reconnects with exponential backoff and re-syncs from
- * the initial snapshot the server replays on connect. A subscription failure
- * is always non-fatal to playback — callers keep the HLS staleness watchdog as
- * the layer-fallback.
+ * the initial snapshot the server replays on connect. A connection that stops
+ * delivering without closing is caught by the idle watchdog
+ * (`idleTimeoutMs`) — see the note on it in `readStream`. A subscription
+ * failure is always non-fatal to playback — callers keep the HLS staleness
+ * watchdog as the layer-fallback.
  */
 export declare function subscribeLiveState(opts: SubscribeLiveStateOptions): LiveStateSubscription;
 
@@ -934,6 +936,15 @@ export declare interface SubscribeLiveStateOptions {
     /** Reconnect backoff floor / ceiling (ms). Defaults: 1000 / 15000. */
     minBackoffMs?: number;
     maxBackoffMs?: number;
+    /**
+     * How long a request may stay silent before it is treated as dead and
+     * reconnected. Applies to both phases: waiting for response headers, and
+     * waiting for the next byte on an open connection. Default 45000 — two
+     * missed 20s server heartbeats. Set `0` to disable the watchdog (a silent
+     * connection then stays open forever, which is what this subscription did
+     * before the watchdog existed).
+     */
+    idleTimeoutMs?: number;
 }
 
 /** A selectable text (caption/subtitle) track. */

package/dist/index.d.ts

@@ -906,9 +906,11 @@ export declare interface StreamDescriptor {
  * The body is a `text/event-stream` we parse incrementally. The connection is
  * long-lived (the server caps it at ~30min and sends heartbeats); on any
  * close/error the client reconnects with exponential backoff and re-syncs from
- * the initial snapshot the server replays on connect. A subscription failure
- * is always non-fatal to playback — callers keep the HLS staleness watchdog as
- * the layer-fallback.
+ * the initial snapshot the server replays on connect. A connection that stops
+ * delivering without closing is caught by the idle watchdog
+ * (`idleTimeoutMs`) — see the note on it in `readStream`. A subscription
+ * failure is always non-fatal to playback — callers keep the HLS staleness
+ * watchdog as the layer-fallback.
  */
 export declare function subscribeLiveState(opts: SubscribeLiveStateOptions): LiveStateSubscription;
 
@@ -934,6 +936,15 @@ export declare interface SubscribeLiveStateOptions {
     /** Reconnect backoff floor / ceiling (ms). Defaults: 1000 / 15000. */
     minBackoffMs?: number;
     maxBackoffMs?: number;
+    /**
+     * How long a request may stay silent before it is treated as dead and
+     * reconnected. Applies to both phases: waiting for response headers, and
+     * waiting for the next byte on an open connection. Default 45000 — two
+     * missed 20s server heartbeats. Set `0` to disable the watchdog (a silent
+     * connection then stays open forever, which is what this subscription did
+     * before the watchdog existed).
+     */
+    idleTimeoutMs?: number;
 }
 
 /** A selectable text (caption/subtitle) track. */