@oddin-gg/havik-player 1.13.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})`);
@@ -1307,14 +1312,16 @@ var ze = class {
 			if (e && e(this.url, t)) return;
 		}
 		let n = this.opts.fetchFn ?? (typeof fetch < "u" ? fetch : void 0);
-		n && n(this.url, {
+		if (!n) return;
+		let r = { "content-type": "application/json" };
+		this.opts.apiKey && (r["x-api-key"] = this.opts.apiKey), n(this.url, {
 			method: "POST",
-			headers: { "content-type": "application/json" },
+			headers: r,
 			body: t,
 			keepalive: !0
 		}).catch(() => {});
 	}
-}, Be = "1.13.0", W = {
+}, Be = "1.15.0", W = {
 	accent: "#E1B600",
 	accentText: "#1B1C23",
 	background: "#0e0f13",
@@ -1790,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) {
@@ -1888,32 +1896,33 @@ var tt = class {
 			i(), r.destroy();
 			return;
 		}
-		this.engine = r, this.detachMedia = i, this.opts.maxBitrate != null && r.setMaxBitrate(this.opts.maxBitrate), this.startStats(), this.scheduleLicenseRefresh(), this.startLiveState(t), this.startAnalytics(e, r);
+		this.engine = r, this.detachMedia = i, this.opts.maxBitrate != null && r.setMaxBitrate(this.opts.maxBitrate), this.startStats(), this.scheduleLicenseRefresh(), this.startLiveState(t), this.startAnalytics(e, r, n.apiKey);
 	}
-	startAnalytics(e, t) {
+	startAnalytics(e, t, n) {
 		if (this.analyticsSession?.noteDestroyed(), this.analyticsSession = null, this.detachSeekListener?.(), this.opts.analytics === !1) return;
-		let n = e.analytics?.sid;
-		if (!n) return;
-		let r = (typeof this.opts.analytics == "object" ? this.opts.analytics.endpoint : void 0) ?? Re(this.opts.baseUrl);
+		let r = e.analytics?.sid;
 		if (!r) return;
-		let i = this.opts.video, a = new ze({
-			endpoint: r,
-			sid: n,
+		let i = (typeof this.opts.analytics == "object" ? this.opts.analytics.endpoint : void 0) ?? Re(this.opts.baseUrl);
+		if (!i) return;
+		let a = this.opts.video, o = new ze({
+			endpoint: i,
+			sid: r,
+			apiKey: n,
 			player: t.name === "native" ? "PLAYER_SAFARI_NATIVE" : "PLAYER_HLSJS",
 			sdkVersion: Be,
 			sample: () => {
-				let e = this.engine?.getStats() ?? F, t = i.buffered.length ? Math.max(0, i.buffered.end(i.buffered.length - 1) - i.currentTime) : 0;
+				let e = this.engine?.getStats() ?? F, t = a.buffered.length ? Math.max(0, a.buffered.end(a.buffered.length - 1) - a.currentTime) : 0;
 				return {
 					...e,
 					bufferedMs: Math.round(t * 1e3),
 					state: this._state,
-					positionMs: Math.round(i.currentTime * 1e3)
+					positionMs: Math.round(a.currentTime * 1e3)
 				};
 			}
 		});
-		this.analyticsSession = a;
-		let o = () => a.noteSeek();
-		i.addEventListener("seeking", o), this.detachSeekListener = () => i.removeEventListener("seeking", o), a.start();
+		this.analyticsSession = o;
+		let s = () => o.noteSeek();
+		a.addEventListener("seeking", s), this.detachSeekListener = () => a.removeEventListener("seeking", s), o.start();
 	}
 	createEngine(e, n) {
 		let r = { ...this.opts.hlsConfig };