@oddin-gg/havik-player 1.14.0 → 1.15.0

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 {

package/dist/index.js

@@ -64,6 +64,7 @@ function c(e) {
 }
 async function l(e, n) {
 	let r = await o(n.credential), i = n.headers ?? new Headers();
+	if (n.apiHeaders) for (let [e, t] of Object.entries(n.apiHeaders)) i.has(e) || i.set(e, t);
 	i.set("x-api-key", r.apiKey);
 	try {
 		return await fetch(e, {
@@ -171,7 +172,8 @@ async function y(e) {
 	if (!e.matchUrn || typeof e.matchUrn != "string") throw new t("INVALID_URN", 0, "resolveStream: a non-empty matchUrn is required");
 	let n = await l(s(e.baseUrl, `/v1/playback/${encodeURIComponent(e.matchUrn)}`), {
 		credential: e.credential,
-		signal: e.signal
+		signal: e.signal,
+		apiHeaders: e.apiHeaders
 	});
 	if (!n.ok) throw await ae(n);
 	return S(await n.json(), e.matchUrn);
@@ -247,7 +249,8 @@ async function C(e) {
 	let c = await l(a, {
 		credential: e.credential,
 		signal: e.signal,
-		headers: o
+		headers: o,
+		apiHeaders: e.apiHeaders
 	});
 	if (c.status === 304) return {
 		tournaments: [],
@@ -287,7 +290,8 @@ async function ce(e) {
 	let a = await l(r, {
 		credential: e.credential,
 		signal: e.signal,
-		headers: i
+		headers: i,
+		apiHeaders: e.apiHeaders
 	});
 	if (a.status === 304) return {
 		etag: e.etag,
@@ -339,7 +343,8 @@ function de(e) {
 			let u = await l(r, {
 				credential: e.credential,
 				signal: i.signal,
-				headers: a
+				headers: a,
+				apiHeaders: e.apiHeaders
 			});
 			if (u.status !== 304) {
 				if (!u.ok) throw new t(n(u.status), u.status, `match status request failed (HTTP ${u.status})`);
@@ -1316,7 +1321,7 @@ var ze = class {
 			keepalive: !0
 		}).catch(() => {});
 	}
-}, Be = "1.14.0", W = {
+}, Be = "1.15.0", W = {
 	accent: "#E1B600",
 	accentText: "#1B1C23",
 	background: "#0e0f13",
@@ -1792,7 +1797,8 @@ var tt = class {
 			baseUrl: this.opts.baseUrl,
 			matchUrn: this.opts.matchUrn,
 			credential: this.opts.credential,
-			signal: this.abort.signal
+			signal: this.abort.signal,
+			apiHeaders: this.opts.apiHeaders
 		};
 	}
 	beginArming(e, t) {