@oddin-gg/havik-player 2.9.2 → 2.10.0

package/docs/API.md

@@ -783,12 +783,13 @@ the instant a match starts, without polling `/v1/playback`, and to detect
 end-of-stream instantly; BYO players can use it directly. `state` mirrors the
 `/v1/playback` outcome ladder:
 
-| `state`    | meaning                       | maps to `/v1/playback` |
-| ---------- | ----------------------------- | ---------------------- |
-| `live`     | serveable now, so play        | `200 OK`               |
-| `upcoming` | scheduled, not serving yet    | `425 Too Early`        |
-| `ended`    | was live; media stopped       | `503`                  |
-| `gone`     | ended past the catchup window | `410 Gone`             |
+| `state`    | meaning                                                                          | maps to `/v1/playback`                |
+| ---------- | -------------------------------------------------------------------------------- | ------------------------------------- |
+| `live`     | serveable now, so play                                                           | `200 OK`                              |
+| `upcoming` | scheduled, not serving yet                                                       | `425 Too Early` (with `liveStartsAt`) |
+| `pending`  | kickoff passed, stream being packaged — `live` follows within seconds to minutes | `425 Too Early` (no `liveStartsAt`)   |
+| `ended`    | was live; media stopped                                                          | `503`                                 |
+| `gone`     | ended past the catchup window                                                    | `410 Gone`                            |
 
 An `ended` event also carries a `reason`: `'interrupted'` (the match is still
 running; only its stream dropped, so a BYO player should show "reconnecting"
@@ -1145,8 +1146,12 @@ interface CatalogMatch {
 
 #### `MatchStatus`, `MatchLiveStatus`
 
+`pending` is "kickoff has passed, the stream is being packaged": not playable
+yet, `live` expected within seconds to minutes. Unknown values still collapse to
+`upcoming` with the verbatim value in `statusRaw`.
+
 ```ts
-type MatchLiveStatus = 'upcoming' | 'live' | 'ended';
+type MatchLiveStatus = 'upcoming' | 'pending' | 'live' | 'ended';
 interface MatchStatus {
   matchUrn: string;
   matchName?: string;

package/embed/index.html

@@ -28,7 +28,7 @@
            beacons endpoint can be derived and QoE analytics is silently off.
            `analytics` is honoured from the injected config only, never the query.
     -->
-    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.9.2/dist/havik-player.global.js" integrity="sha384-zzERUxDevYM1StQDU+Jr0hqqRROD5KiBAzm+ctOvtlPVa33Tr2VJeAJdStSDRNIy" crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.10.0/dist/havik-player.global.js" integrity="sha384-8JeA3Kgt3Hq/rl4dUJlndmtAcw1oQPn17zgjHRxbvfe57Q1/0x1/lwp27RimmlIy" 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.9.2/dist/havik-player.global.js" integrity="sha384-zzERUxDevYM1StQDU+Jr0hqqRROD5KiBAzm+ctOvtlPVa33Tr2VJeAJdStSDRNIy" crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.10.0/dist/havik-player.global.js" integrity="sha384-8JeA3Kgt3Hq/rl4dUJlndmtAcw1oQPn17zgjHRxbvfe57Q1/0x1/lwp27RimmlIy" crossorigin="anonymous"></script>
     <script>
       (async () => {
         const player = await HavikPlayer.createPlayer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddin-gg/havik-player",
-  "version": "2.9.2",
+  "version": "2.10.0",
   "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,