@oddin-gg/havik-player 2.9.3 → 2.10.0

package/dist/index.d.cts

@@ -660,11 +660,19 @@ export declare function licenseRequestHeaders(descriptor: StreamDescriptor, cred
  * the `/v1/playback` outcome ladder so a pushed event and a follow-up
  * `/v1/playback` call always agree:
  *   live     ↔ 200 OK         (a serveable session exists — play now)
- *   upcoming ↔ 425 Too Early  (scheduled, not serving yet)
+ *   upcoming ↔ 425 Too Early  (scheduled, not serving yet; `liveStartsAt` says when)
+ *   pending  ↔ 425 Too Early  (kickoff has passed, the stream is being packaged —
+ *                              no `liveStartsAt`; `live` follows within seconds
+ *                              to minutes)
  *   ended    ↔ 503            (was live; media stopped, still in catchup)
  *   gone     ↔ 410 Gone       (ended past the catchup window)
+ *
+ * `pending` and `upcoming` ask the same thing of a player — wait — and the
+ * managed player treats them alike ("Starting soon…"). A host that renders
+ * its own waiting UI can tell them apart: `upcoming` has a kickoff to count
+ * down to, `pending` means the match is on and media is seconds away.
  */
-export declare type LiveState = 'live' | 'upcoming' | 'ended' | 'gone';
+export declare type LiveState = 'live' | 'upcoming' | 'pending' | 'ended' | 'gone';
 
 export declare interface LiveStateEvent {
     matchUrn: string;
@@ -680,7 +688,13 @@ export declare interface LiveStateSubscription {
     close(): void;
 }
 
-export declare type MatchLiveStatus = 'upcoming' | 'live' | 'ended';
+/**
+ * `pending` is the catalog's "kickoff has passed, the stream is being
+ * packaged" — not playable yet, `live` expected within seconds to minutes. It
+ * is NOT `upcoming` (which has a kickoff ahead) and not `live` (nothing serves
+ * yet); `/v1/playback` answers `425` for it without a `liveStartsAt`.
+ */
+export declare type MatchLiveStatus = 'upcoming' | 'pending' | 'live' | 'ended';
 
 export declare interface MatchStatus {
     matchUrn: string;

package/dist/index.d.ts

@@ -660,11 +660,19 @@ export declare function licenseRequestHeaders(descriptor: StreamDescriptor, cred
  * the `/v1/playback` outcome ladder so a pushed event and a follow-up
  * `/v1/playback` call always agree:
  *   live     ↔ 200 OK         (a serveable session exists — play now)
- *   upcoming ↔ 425 Too Early  (scheduled, not serving yet)
+ *   upcoming ↔ 425 Too Early  (scheduled, not serving yet; `liveStartsAt` says when)
+ *   pending  ↔ 425 Too Early  (kickoff has passed, the stream is being packaged —
+ *                              no `liveStartsAt`; `live` follows within seconds
+ *                              to minutes)
  *   ended    ↔ 503            (was live; media stopped, still in catchup)
  *   gone     ↔ 410 Gone       (ended past the catchup window)
+ *
+ * `pending` and `upcoming` ask the same thing of a player — wait — and the
+ * managed player treats them alike ("Starting soon…"). A host that renders
+ * its own waiting UI can tell them apart: `upcoming` has a kickoff to count
+ * down to, `pending` means the match is on and media is seconds away.
  */
-export declare type LiveState = 'live' | 'upcoming' | 'ended' | 'gone';
+export declare type LiveState = 'live' | 'upcoming' | 'pending' | 'ended' | 'gone';
 
 export declare interface LiveStateEvent {
     matchUrn: string;
@@ -680,7 +688,13 @@ export declare interface LiveStateSubscription {
     close(): void;
 }
 
-export declare type MatchLiveStatus = 'upcoming' | 'live' | 'ended';
+/**
+ * `pending` is the catalog's "kickoff has passed, the stream is being
+ * packaged" — not playable yet, `live` expected within seconds to minutes. It
+ * is NOT `upcoming` (which has a kickoff ahead) and not `live` (nothing serves
+ * yet); `/v1/playback` answers `425` for it without a `liveStartsAt`.
+ */
+export declare type MatchLiveStatus = 'upcoming' | 'pending' | 'live' | 'ended';
 
 export declare interface MatchStatus {
     matchUrn: string;

package/dist/index.js

@@ -44,7 +44,7 @@ async function s(e) {
 	return t;
 }
 function c(e) {
-	return e === "live" || e === "ended" || e === "upcoming" ? e : "upcoming";
+	return e === "live" || e === "ended" || e === "upcoming" || e === "pending" ? e : "upcoming";
 }
 //#endregion
 //#region src/core/http.ts
@@ -1879,7 +1879,7 @@ async function xt() {
 }
 //#endregion
 //#region src/core/version.ts
-var St = "2.9.3", Ct = {
+var St = "2.10.0", Ct = {
 	accent: "#E1B600",
 	accentText: "#1B1C23",
 	background: "#0e0f13",