@oddin-gg/havik-player 2.8.0 → 2.9.0

package/dist/index.d.cts

@@ -373,6 +373,23 @@ export declare interface EmbedConfig {
     autoplay?: boolean;
     muted?: boolean;
     waitForLive?: WaitForLive;
+    /**
+     * QoE beacons, forwarded verbatim to {@link createPlayer}. Same meaning as
+     * there: `false` opts out, `{ endpoint }` names a beacons host.
+     *
+     * Mode C needs this for the same reason Mode A does, and until now had no
+     * way to say it. An embed whose `baseUrl` is not a `feed[-dev].<domain>`
+     * host — a CDN or gateway fronting the streams API — derives no beacons
+     * endpoint, so analytics is off and stays off. Without this option the
+     * only remedy was to move `baseUrl` back onto a feed host, which is not a
+     * choice an integrator who fronts the API deliberately can make.
+     *
+     * INJECTED CONFIG ONLY: unlike every other field here, this is not read
+     * from the query string. See {@link readConfig}.
+     */
+    analytics?: boolean | {
+        endpoint?: string;
+    };
 }
 
 export declare interface EmbedHandle {
@@ -673,6 +690,18 @@ export declare interface MountEmbedOptions {
     container: HTMLElement;
     /** URL of the hosted embed page, e.g. `https://player-dev.oddin-video.gg/embed/`. */
     src: string;
+    /**
+     * API base URL, forwarded to the embed page as a query parameter.
+     *
+     * ⚠️ QoE beacons: the beacons endpoint is derived from this host by
+     * convention (`feed[-dev].<domain>` → `beacons[-dev].<domain>`). If your
+     * base is NOT a feed host, nothing derives and analytics is off — and
+     * `mountEmbed` CANNOT fix it, because the only way to name an endpoint is
+     * {@link EmbedConfig.analytics}, which the embed page reads from injected
+     * config and deliberately never from the query string (a link must not be
+     * able to redirect a session's telemetry). Host the embed page yourself
+     * and inject `window.HAVIK_EMBED_CONFIG` with `analytics: { endpoint }`.
+     */
     baseUrl: string;
     matchUrn: string;
     /**

package/dist/index.d.ts

@@ -373,6 +373,23 @@ export declare interface EmbedConfig {
     autoplay?: boolean;
     muted?: boolean;
     waitForLive?: WaitForLive;
+    /**
+     * QoE beacons, forwarded verbatim to {@link createPlayer}. Same meaning as
+     * there: `false` opts out, `{ endpoint }` names a beacons host.
+     *
+     * Mode C needs this for the same reason Mode A does, and until now had no
+     * way to say it. An embed whose `baseUrl` is not a `feed[-dev].<domain>`
+     * host — a CDN or gateway fronting the streams API — derives no beacons
+     * endpoint, so analytics is off and stays off. Without this option the
+     * only remedy was to move `baseUrl` back onto a feed host, which is not a
+     * choice an integrator who fronts the API deliberately can make.
+     *
+     * INJECTED CONFIG ONLY: unlike every other field here, this is not read
+     * from the query string. See {@link readConfig}.
+     */
+    analytics?: boolean | {
+        endpoint?: string;
+    };
 }
 
 export declare interface EmbedHandle {
@@ -673,6 +690,18 @@ export declare interface MountEmbedOptions {
     container: HTMLElement;
     /** URL of the hosted embed page, e.g. `https://player-dev.oddin-video.gg/embed/`. */
     src: string;
+    /**
+     * API base URL, forwarded to the embed page as a query parameter.
+     *
+     * ⚠️ QoE beacons: the beacons endpoint is derived from this host by
+     * convention (`feed[-dev].<domain>` → `beacons[-dev].<domain>`). If your
+     * base is NOT a feed host, nothing derives and analytics is off — and
+     * `mountEmbed` CANNOT fix it, because the only way to name an endpoint is
+     * {@link EmbedConfig.analytics}, which the embed page reads from injected
+     * config and deliberately never from the query string (a link must not be
+     * able to redirect a session's telemetry). Host the embed page yourself
+     * and inject `window.HAVIK_EMBED_CONFIG` with `analytics: { endpoint }`.
+     */
     baseUrl: string;
     matchUrn: string;
     /**

package/dist/index.js

@@ -1856,7 +1856,7 @@ async function vt() {
 }
 //#endregion
 //#region src/core/version.ts
-var yt = "2.8.0", bt = {
+var yt = "2.9.0", bt = {
 	accent: "#E1B600",
 	accentText: "#1B1C23",
 	background: "#0e0f13",
@@ -2869,7 +2869,14 @@ function Ht(e) {
 //#endregion
 //#region src/embed/page.ts
 var Ut = /^[A-Za-z0-9:_.-]{1,128}$/;
-function Wt() {
+function Wt(e) {
+	if (typeof e == "boolean") return e;
+	if (typeof e == "object" && e) {
+		let t = e.endpoint;
+		return typeof t == "string" ? { endpoint: t } : {};
+	}
+}
+function Gt() {
 	let e = window.HAVIK_EMBED_CONFIG;
 	if (e) return {
 		baseUrl: e.baseUrl ?? "",
@@ -2878,7 +2885,8 @@ function Wt() {
 		parentOrigin: e.parentOrigin,
 		autoplay: e.autoplay ?? !0,
 		muted: e.muted ?? !0,
-		waitForLive: e.waitForLive ?? !0
+		waitForLive: e.waitForLive ?? !0,
+		analytics: Wt(e.analytics)
 	};
 	let t = new URLSearchParams(location.search);
 	return {
@@ -2891,9 +2899,9 @@ function Wt() {
 		waitForLive: !0
 	};
 }
-async function Gt() {
-	let e = Wt();
-	qt();
+async function Kt() {
+	let e = Gt();
+	Jt();
 	let t = document.createElement("video");
 	t.setAttribute("playsinline", ""), t.muted = e.muted ?? !0, t.style.cssText = "width:100%;height:100%;object-fit:contain;background:#000;aspect-ratio:auto", document.body.appendChild(t);
 	let r = e.parentOrigin && e.parentOrigin !== "null" ? e.parentOrigin : null;
@@ -2948,7 +2956,7 @@ async function Gt() {
 			code: e.code,
 			message: e.message
 		})), e.on("autoplayblocked", () => {
-			i({ type: "oddin:autoplayblocked" }), Kt(t, e);
+			i({ type: "oddin:autoplayblocked" }), qt(t, e);
 		});
 	}, s = async (r) => {
 		a?.destroy(), a = null;
@@ -2960,7 +2968,8 @@ async function Gt() {
 				credential: { apiKey: e.apiKey },
 				autoplay: e.autoplay,
 				muted: e.muted,
-				waitForLive: e.waitForLive
+				waitForLive: e.waitForLive,
+				analytics: e.analytics
 			});
 			a = n;
 			let i = t.parentElement;
@@ -3026,18 +3035,18 @@ async function Gt() {
 		protocol: 1
 	});
 }
-function Kt(e, t) {
+function qt(e, t) {
 	if (document.getElementById("havik-tap")) return;
 	let n = document.createElement("button");
 	n.id = "havik-tap", n.textContent = "▶  Tap to play", n.style.cssText = "position:fixed;inset:0;width:100%;height:100%;border:0;background:rgba(0,0,0,.55);color:#fff;font:600 18px system-ui,sans-serif;cursor:pointer;z-index:9", n.addEventListener("click", () => {
 		n.remove(), t.play();
 	}), document.body.appendChild(n);
 }
-function qt() {
+function Jt() {
 	let e = document.createElement("style");
 	e.textContent = "html,body{margin:0;height:100%;background:#000;overflow:hidden}body{display:flex}", document.head.appendChild(e);
 }
 //#endregion
-export { bt as ODDIN_THEME, n as PlaybackError, St as applyTheme, z as baseUrlForEnv, Gt as bootEmbed, _e as clearDeviceId, Q as createPlayer, D as deriveEventsBaseUrl, Ee as detectDrmSupport, w as enterVideoFullscreen, T as exitVideoFullscreen, ue as fetchCatalog, fe as fetchTournament, me as flattenMatches, A as getDeviceId, Oe as isLowLatencyManifest, $ as isOddinMessage, ye as licenseRequestHeaders, Ht as mountEmbed, v as pollToLive, b as resolveStream, E as subscribeLiveState, C as videoFullscreenActive, he as watchStatus };
+export { bt as ODDIN_THEME, n as PlaybackError, St as applyTheme, z as baseUrlForEnv, Kt as bootEmbed, _e as clearDeviceId, Q as createPlayer, D as deriveEventsBaseUrl, Ee as detectDrmSupport, w as enterVideoFullscreen, T as exitVideoFullscreen, ue as fetchCatalog, fe as fetchTournament, me as flattenMatches, A as getDeviceId, Oe as isLowLatencyManifest, $ as isOddinMessage, ye as licenseRequestHeaders, Ht as mountEmbed, v as pollToLive, b as resolveStream, E as subscribeLiveState, C as videoFullscreenActive, he as watchStatus };
 
 //# sourceMappingURL=index.js.map