@oddin-gg/havik-player 1.14.0 → 1.15.1

package/dist/index.d.cts

@@ -164,6 +164,16 @@ export declare interface CreatePlayerOptions {
      * differs from that convention.
      */
     eventsBaseUrl?: string;
+    /**
+     * Extra headers attached to every request the SDK makes to {@link baseUrl}
+     * (playback resolution, live-status polling) — and ONLY there: never to
+     * CDN manifest/segment hosts, DRM license endpoints, the SSE events host,
+     * or the beacons endpoint. For integrations whose API front door wants
+     * its own auth signal on top of the publishable key — an operator console
+     * proving a session to its reverse proxy, or a customer gateway in front
+     * of the streams API. `x-api-key` cannot be overridden through this map.
+     */
+    apiHeaders?: Record<string, string>;
     /**
      * QoE beacons + CMCD session attribution. Active only when the playback
      * response carries an analytics sid (the server-side flag) — without one
@@ -295,6 +305,11 @@ export declare interface FetchCatalogOptions {
     etag?: string;
     status?: MatchLiveStatus | MatchLiveStatus[];
     sport?: string;
+    /**
+     * Extra headers attached to every request to {@link baseUrl} — and only
+     * there: never to CDN or license hosts. `x-api-key` cannot be overridden.
+     */
+    apiHeaders?: Record<string, string>;
 }
 
 /**
@@ -315,6 +330,11 @@ export declare interface FetchTournamentOptions {
     signal?: AbortSignal;
     /** Prior ETag for a conditional GET (304 when unchanged) — only effective once havik-streams ETags `/v1/tournaments/{urn}` (parity with `/v1/matches/{urn}`). */
     etag?: string;
+    /**
+     * Extra headers attached to every request to {@link baseUrl} — and only
+     * there: never to CDN or license hosts. `x-api-key` cannot be overridden.
+     */
+    apiHeaders?: Record<string, string>;
 }
 
 /** Flatten a Catalog to a single match list (handy for grids). */
@@ -687,6 +707,14 @@ export declare interface ResolveOptions {
      */
     waitForLive?: WaitForLive;
     signal?: AbortSignal;
+    /**
+     * Extra headers attached to every request this call makes to {@link baseUrl}
+     * — and ONLY there: never to CDN manifest/segment hosts or DRM license
+     * endpoints. For integrations whose API front door wants its own auth
+     * signal on top of the publishable key (gateways, operator consoles).
+     * `x-api-key` cannot be overridden.
+     */
+    apiHeaders?: Record<string, string>;
 }
 
 /**
@@ -870,6 +898,11 @@ export declare interface WatchStatusOptions {
     onError?: (err: PlaybackError) => void;
     /** Poll interval in ms. Floored at 2000. Default: 10000 (catalog max-age). */
     intervalMs?: number;
+    /**
+     * Extra headers attached to every request to {@link baseUrl} — and only
+     * there: never to CDN or license hosts. `x-api-key` cannot be overridden.
+     */
+    apiHeaders?: Record<string, string>;
 }
 
 export declare interface WidevineInfo {

package/dist/index.d.ts

@@ -164,6 +164,16 @@ export declare interface CreatePlayerOptions {
      * differs from that convention.
      */
     eventsBaseUrl?: string;
+    /**
+     * Extra headers attached to every request the SDK makes to {@link baseUrl}
+     * (playback resolution, live-status polling) — and ONLY there: never to
+     * CDN manifest/segment hosts, DRM license endpoints, the SSE events host,
+     * or the beacons endpoint. For integrations whose API front door wants
+     * its own auth signal on top of the publishable key — an operator console
+     * proving a session to its reverse proxy, or a customer gateway in front
+     * of the streams API. `x-api-key` cannot be overridden through this map.
+     */
+    apiHeaders?: Record<string, string>;
     /**
      * QoE beacons + CMCD session attribution. Active only when the playback
      * response carries an analytics sid (the server-side flag) — without one
@@ -295,6 +305,11 @@ export declare interface FetchCatalogOptions {
     etag?: string;
     status?: MatchLiveStatus | MatchLiveStatus[];
     sport?: string;
+    /**
+     * Extra headers attached to every request to {@link baseUrl} — and only
+     * there: never to CDN or license hosts. `x-api-key` cannot be overridden.
+     */
+    apiHeaders?: Record<string, string>;
 }
 
 /**
@@ -315,6 +330,11 @@ export declare interface FetchTournamentOptions {
     signal?: AbortSignal;
     /** Prior ETag for a conditional GET (304 when unchanged) — only effective once havik-streams ETags `/v1/tournaments/{urn}` (parity with `/v1/matches/{urn}`). */
     etag?: string;
+    /**
+     * Extra headers attached to every request to {@link baseUrl} — and only
+     * there: never to CDN or license hosts. `x-api-key` cannot be overridden.
+     */
+    apiHeaders?: Record<string, string>;
 }
 
 /** Flatten a Catalog to a single match list (handy for grids). */
@@ -687,6 +707,14 @@ export declare interface ResolveOptions {
      */
     waitForLive?: WaitForLive;
     signal?: AbortSignal;
+    /**
+     * Extra headers attached to every request this call makes to {@link baseUrl}
+     * — and ONLY there: never to CDN manifest/segment hosts or DRM license
+     * endpoints. For integrations whose API front door wants its own auth
+     * signal on top of the publishable key (gateways, operator consoles).
+     * `x-api-key` cannot be overridden.
+     */
+    apiHeaders?: Record<string, string>;
 }
 
 /**
@@ -870,6 +898,11 @@ export declare interface WatchStatusOptions {
     onError?: (err: PlaybackError) => void;
     /** Poll interval in ms. Floored at 2000. Default: 10000 (catalog max-age). */
     intervalMs?: number;
+    /**
+     * Extra headers attached to every request to {@link baseUrl} — and only
+     * there: never to CDN or license hosts. `x-api-key` cannot be overridden.
+     */
+    apiHeaders?: Record<string, string>;
 }
 
 export declare interface WidevineInfo {