@oddin-gg/havik-player 1.16.0 → 1.17.0

package/dist/index.d.cts

@@ -151,12 +151,27 @@ export declare interface CreatePlayerOptions {
      * Subscribe to push-based live-state over SSE (`events.<domain>/v1/events/{urn}`)
      * to detect end-of-stream the instant the bridge flips, instead of waiting on
      * the frozen Tencent manifest (which never emits #EXT-X-ENDLIST). On `ended`/
-     * `gone` the player stops buffering and emits `ended`. Default: true — and
+     * `gone` the player stops buffering and emits `ended`; a later pushed `live`
+     * rejoins automatically (see {@link rejoinOnLive}). Default: true — and
      * fully graceful: if the endpoint is unreachable the subscription retries
      * quietly in the background while the HLS staleness watchdog remains the
      * layer-fallback, so playback is never affected. Set false to disable.
      */
     liveStateEvents?: boolean;
+    /**
+     * Rejoin automatically when a stream that ended comes back live. An ingest
+     * outage longer than the bridge's reconnect grace tears the session down
+     * and — when the encoder reconnects — recreates it under a NEW manifest
+     * URL, while the old playlist freezes at HTTP 200 forever. A player that
+     * latched `ended` can therefore only recover by re-resolving playback.
+     * With this on (the default), the live-state subscription stays open after
+     * `ended` (it closes on `gone`, the past-catchup terminal), and a pushed
+     * `live` re-arms and re-attaches automatically through the same jittered
+     * go-live path the pre-live wait uses. Set false to keep `ended` terminal
+     * (the pre-1.13 behavior). No effect when {@link liveStateEvents} is
+     * disabled — without the push channel there is nothing to rejoin on.
+     */
+    rejoinOnLive?: boolean;
     /**
      * Override the SSE endpoint base URL. Default: derived from {@link baseUrl} by
      * prefixing the host with `events.` (e.g. `feed.<domain>` →

package/dist/index.d.ts

@@ -151,12 +151,27 @@ export declare interface CreatePlayerOptions {
      * Subscribe to push-based live-state over SSE (`events.<domain>/v1/events/{urn}`)
      * to detect end-of-stream the instant the bridge flips, instead of waiting on
      * the frozen Tencent manifest (which never emits #EXT-X-ENDLIST). On `ended`/
-     * `gone` the player stops buffering and emits `ended`. Default: true — and
+     * `gone` the player stops buffering and emits `ended`; a later pushed `live`
+     * rejoins automatically (see {@link rejoinOnLive}). Default: true — and
      * fully graceful: if the endpoint is unreachable the subscription retries
      * quietly in the background while the HLS staleness watchdog remains the
      * layer-fallback, so playback is never affected. Set false to disable.
      */
     liveStateEvents?: boolean;
+    /**
+     * Rejoin automatically when a stream that ended comes back live. An ingest
+     * outage longer than the bridge's reconnect grace tears the session down
+     * and — when the encoder reconnects — recreates it under a NEW manifest
+     * URL, while the old playlist freezes at HTTP 200 forever. A player that
+     * latched `ended` can therefore only recover by re-resolving playback.
+     * With this on (the default), the live-state subscription stays open after
+     * `ended` (it closes on `gone`, the past-catchup terminal), and a pushed
+     * `live` re-arms and re-attaches automatically through the same jittered
+     * go-live path the pre-live wait uses. Set false to keep `ended` terminal
+     * (the pre-1.13 behavior). No effect when {@link liveStateEvents} is
+     * disabled — without the push channel there is nothing to rejoin on.
+     */
+    rejoinOnLive?: boolean;
     /**
      * Override the SSE endpoint base URL. Default: derived from {@link baseUrl} by
      * prefixing the host with `events.` (e.g. `feed.<domain>` →