@oddin-gg/havik-player 2.6.2 → 2.6.3

package/docs/API.md

@@ -776,6 +776,18 @@ reconnects with backoff, and replays the current state on connect. Every event i
 also reported via `onAlive` (including heartbeats) so callers can treat the stream as
 healthy. A subscription problem is **non-fatal**; it retries in the background.
 
+A connection can also go silent **without closing** (a black-holed socket after
+a laptop sleep, a NAT rebind, a half-closing proxy). Nothing in the reconnect
+path above catches that on its own, so the subscription would stay permanently
+dead and silent, missing a real end-of-match push without surfacing anything to
+the caller. An idle watchdog covers it, in both phases: `idleTimeoutMs` spent
+waiting for response headers, or `idleTimeoutMs` without a byte on an open
+connection, tears that request down, reports it via `onError`, and reconnects
+through the normal backoff. Both phases matter, because the reconnect the
+watchdog triggers goes out over a network that just changed, which is exactly
+the request most likely to hit a black hole of its own. The default (45s) is two
+missed 20s server heartbeats.
+
 ```ts
 import { subscribeLiveState, deriveEventsBaseUrl } from '@oddin-gg/havik-player';
 
@@ -793,16 +805,17 @@ const sub = subscribeLiveState({
 
 #### `SubscribeLiveStateOptions`
 
-| Option          | Type                                    | Default | Description                                                       |
-| --------------- | --------------------------------------- | ------- | ----------------------------------------------------------------- |
-| `eventsBaseUrl` | `string`                                | —       | **Required.** SSE base, e.g. from `deriveEventsBaseUrl(baseUrl)`. |
-| `matchUrn`      | `string`                                | —       | **Required.**                                                     |
-| `credential`    | [`CredentialSource`](#credentialsource) | —       | **Required.**                                                     |
-| `onState`       | `(ev: LiveStateEvent) => void`          | —       | **Required.** Initial snapshot on connect + every transition.     |
-| `onError`       | `(err: unknown) => void`                | —       | Non-fatal subscription error; the client keeps retrying.          |
-| `onAlive`       | `() => void`                            | —       | Liveness tick on every received frame (incl. heartbeats).         |
-| `minBackoffMs`  | `number`                                | `1000`  | Reconnect backoff floor.                                          |
-| `maxBackoffMs`  | `number`                                | `15000` | Reconnect backoff ceiling.                                        |
+| Option          | Type                                    | Default | Description                                                        |
+| --------------- | --------------------------------------- | ------- | ------------------------------------------------------------------ |
+| `eventsBaseUrl` | `string`                                | —       | **Required.** SSE base, e.g. from `deriveEventsBaseUrl(baseUrl)`.  |
+| `matchUrn`      | `string`                                | —       | **Required.**                                                      |
+| `credential`    | [`CredentialSource`](#credentialsource) | —       | **Required.**                                                      |
+| `onState`       | `(ev: LiveStateEvent) => void`          | —       | **Required.** Initial snapshot on connect + every transition.      |
+| `onError`       | `(err: unknown) => void`                | —       | Non-fatal subscription error; the client keeps retrying.           |
+| `onAlive`       | `() => void`                            | —       | Liveness tick on every received frame (incl. heartbeats).          |
+| `minBackoffMs`  | `number`                                | `1000`  | Reconnect backoff floor.                                           |
+| `maxBackoffMs`  | `number`                                | `15000` | Reconnect backoff ceiling.                                         |
+| `idleTimeoutMs` | `number`                                | `45000` | Silence (awaiting headers, or bytes) before reconnecting; `0` off. |
 
 ### `isLowLatencyManifest`
 

package/embed/index.html

@@ -23,7 +23,7 @@
            apiKey, parentOrigin). When injected, the URL query string is IGNORED for
            security; the api-key must NOT travel in the query in production.
     -->
-    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.6.2/dist/havik-player.global.js" integrity="sha384-dja7s2fU5Ag8U3KY+z4fisxHpQGcAoYGqZhS8z26eXRHhsdKajVP1Y+cGwGav+m+" crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.6.3/dist/havik-player.global.js" integrity="sha384-Un15IQk3tZqhqlYbYgVS+qjJj7dpxl0GiwofTfwAq1xcg/6krt97+9ydvCfg9tvI" crossorigin="anonymous"></script>
     <script>
       HavikPlayer.bootEmbed();
     </script>

package/examples/vanilla.html

@@ -12,7 +12,7 @@
          shipped in each npm release is pinned to that release with Subresource
          Integrity, injected at publish time (scripts/inject-sri.mjs). In
          production, always use a pinned + SRI'd tag like the released copy. -->
-    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.6.2/dist/havik-player.global.js" integrity="sha384-dja7s2fU5Ag8U3KY+z4fisxHpQGcAoYGqZhS8z26eXRHhsdKajVP1Y+cGwGav+m+" crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.6.3/dist/havik-player.global.js" integrity="sha384-Un15IQk3tZqhqlYbYgVS+qjJj7dpxl0GiwofTfwAq1xcg/6krt97+9ydvCfg9tvI" crossorigin="anonymous"></script>
     <script>
       (async () => {
         const player = await HavikPlayer.createPlayer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddin-gg/havik-player",
-  "version": "2.6.2",
+  "version": "2.6.3",
   "description": "Havik HTML5 player SDK — LL-HLS + DRM playback for Oddin live streams (managed, bring-your-own-player, and iframe-embed modes).",
   "type": "module",
   "sideEffects": false,