branch-video-player-sdk 0.2.11 → 0.2.13

package/README.md

@@ -38,16 +38,16 @@ under paths on one origin.
 Subscribe with `player.on()` to `loaded`, `ready`, `statechange`, `progress`,
 `ended`, `error`, `bufferchange`, `milestone`, and `exitrequested`. `play`,
 `pause`, and `seek` issued before trusted `ready` are queued in order.
-
-## Web learning observations (0.2.10+)
-
-The Runtime can report privacy-minimized Web learning observations through the existing `milestone` event. These observations are included in 0.2.10 and later; 0.2.9 does not contain them. No new SDK event name is required.
-
-- `schemaVersion: 1`
-- `type: web_step_visible | web_step_message`
-- `nodeId`, `visitId`, `contentUrl` (origin + pathname only)
-- Status messages additionally contain `messageName` and `messageStatus`.
-
-Visibility is observed after the Runtime's existing Web visual handoff, not simply on node change. Status messages reuse the current origin/source fence and visit deduplication. Source-less legacy calls may still route for compatibility but are never telemetry. Initial UEStatus=0 and free-text payloads are excluded. Observer exceptions cannot stop playback or alter routing.
-
-A status observation is **not a success verdict**. The host must apply an explicit content-specific completion contract; it must not assume the same numeric UEStatus means completed, skipped or timed out for every page. No answer bodies, initData or credential query values are forwarded.
+
+## Web learning observations (0.2.10+)
+
+The Runtime can report privacy-minimized Web learning observations through the existing `milestone` event. These observations are included in 0.2.10 and later; 0.2.9 does not contain them. No new SDK event name is required.
+
+- `schemaVersion: 1`
+- `type: web_step_visible | web_step_message`
+- `nodeId`, `visitId`, `contentUrl` (origin + pathname only)
+- Status messages additionally contain `messageName` and `messageStatus`.
+
+Visibility is observed after the Runtime's existing Web visual handoff, not simply on node change. Status messages reuse the current origin/source fence and visit deduplication. Source-less legacy calls may still route for compatibility but are never telemetry. Initial UEStatus=0 and free-text payloads are excluded. Observer exceptions cannot stop playback or alter routing.
+
+A status observation is **not a success verdict**. The host must apply an explicit content-specific completion contract; it must not assume the same numeric UEStatus means completed, skipped or timed out for every page. No answer bodies, initData or credential query values are forwarded.

package/dist/index.js

@@ -1,47 +1,47 @@
-const w = "/branch-video-runtime/player.html", h = (e) => /^\d+$/.test(e) && Number(e) > 0 && Number(e) <= 65535, P = (e) => {
-  const t = e.split(".");
-  return t.length === 4 && t.every((n) => /^\d+$/.test(n) && Number(n) <= 255);
+const w = "/branch-video-runtime/player.html", E = (e) => /^\d+$/.test(e) && Number(e) > 0 && Number(e) <= 65535, P = (e) => {
+  const n = e.split(".");
+  return n.length === 4 && n.every((r) => /^\d+$/.test(r) && Number(r) <= 255);
 }, T = (e) => {
   if (!/^[0-9a-f:]+$/i.test(e)) return !1;
-  const t = e.split("::");
-  if (t.length > 2) return !1;
-  const n = t.flatMap((i) => i ? i.split(":") : []);
-  return n.every((i) => /^[0-9a-f]{1,4}$/i.test(i)) ? t.length === 2 ? n.length < 8 : n.length === 8 : !1;
-}, E = (e) => {
-  const t = e.endsWith(".") ? e.slice(0, -1) : e;
-  return /^[\d.]+$/.test(t) ? P(t) : !!t && !t.includes("..") && t.split(".").every((n) => /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i.test(n));
+  const n = e.split("::");
+  if (n.length > 2) return !1;
+  const r = n.flatMap((i) => i ? i.split(":") : []);
+  return r.every((i) => /^[0-9a-f]{1,4}$/i.test(i)) ? n.length === 2 ? r.length < 8 : r.length === 8 : !1;
+}, _ = (e) => {
+  const n = e.endsWith(".") ? e.slice(0, -1) : e;
+  return /^[\d.]+$/.test(n) ? P(n) : !!n && !n.includes("..") && n.split(".").every((r) => /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i.test(r));
 }, V = (e) => {
   if (!e || e.includes("@")) return !1;
   if (e.startsWith("[")) {
-    const i = e.indexOf("]"), o = e.slice(1, i), r = e.slice(i + 1);
-    return i <= 1 || !T(o) ? !1 : !r || r.startsWith(":") && h(r.slice(1));
+    const i = e.indexOf("]"), c = e.slice(1, i), t = e.slice(i + 1);
+    return i <= 1 || !T(c) ? !1 : !t || t.startsWith(":") && E(t.slice(1));
   }
-  const t = e.lastIndexOf(":");
-  if (t === -1) return E(e);
-  const n = e.slice(0, t);
-  return E(n) && !n.includes(":") && h(e.slice(t + 1));
+  const n = e.lastIndexOf(":");
+  if (n === -1) return _(e);
+  const r = e.slice(0, n);
+  return _(r) && !r.includes(":") && E(e.slice(n + 1));
 }, U = (e) => {
-  const t = /^(https?):\/\/([^\s/?#]+)([/\?#].*)?$/i.exec(e);
-  return !t || !V(t[2]) ? null : { authority: t[2], suffix: t[3] || "" };
-}, W = (e) => U(e) !== null, _ = (e, t) => {
-  if (!W(t) || e === "runtimeUrl" && t.includes("#")) throw new TypeError(`${e} must be an absolute HTTP(S) URL`);
-  return t;
+  const n = /^(https?):\/\/([^\s/?#]+)([/\?#].*)?$/i.exec(e);
+  return !n || !V(n[2]) ? null : { authority: n[2], suffix: n[3] || "" };
+}, W = (e) => U(e) !== null, p = (e, n) => {
+  if (!W(n) || e === "runtimeUrl" && n.includes("#")) throw new TypeError(`${e} must be an absolute HTTP(S) URL`);
+  return n;
 }, $ = (e) => {
-  const t = U(e);
-  if (!t || t.suffix && t.suffix !== "/") throw new TypeError("parentOrigin must be an HTTP(S) origin");
+  const n = U(e);
+  if (!n || n.suffix && n.suffix !== "/") throw new TypeError("parentOrigin must be an HTTP(S) origin");
   return e.endsWith("/") ? e.slice(0, -1) : e;
 };
-function b(e) {
-  const t = e.runtimeUrl ? _("runtimeUrl", e.runtimeUrl) : w, n = _("scriptUrl", e.scriptUrl), i = e.parentOrigin === void 0 ? void 0 : $(e.parentOrigin), o = [
-    `script=${encodeURIComponent(n)}`,
+function R(e) {
+  const n = e.runtimeUrl ? p("runtimeUrl", e.runtimeUrl) : w, r = p("scriptUrl", e.scriptUrl), i = e.cover === void 0 ? void 0 : p("cover", e.cover), c = e.parentOrigin === void 0 ? void 0 : $(e.parentOrigin), t = [
+    `script=${encodeURIComponent(r)}`,
     "embedPlatform=web_player_sdk",
     "sdkProtocol=1"
   ];
-  i && o.push(`parentOrigin=${encodeURIComponent(i)}`), e.cshost && o.push(`cshost=${encodeURIComponent(e.cshost)}`), e.controls !== void 0 && o.push(`controls=${e.controls}`), e.debug !== void 0 && o.push(`debug=${e.debug}`);
-  const r = t.includes("?") ? "&" : "?";
-  return `${t}${r}${o.join("&")}`;
+  i && t.push(`cover=${encodeURIComponent(i)}`), c && t.push(`parentOrigin=${encodeURIComponent(c)}`), e.cshost && t.push(`cshost=${encodeURIComponent(e.cshost)}`), e.controls !== void 0 && t.push(`controls=${e.controls}`), e.debug !== void 0 && t.push(`debug=${e.debug}`);
+  const d = n.includes("?") ? "&" : "?";
+  return `${n}${d}${t.join("&")}`;
 }
-const O = {
+const b = {
   WPS_EVT_LOADED: "loaded",
   WPS_EVT_READY: "ready",
   WPS_EVT_STATE_CHANGE: "statechange",
@@ -51,65 +51,65 @@ const O = {
   WPS_EVT_BUFFER_CHANGE: "bufferchange",
   WPS_EVT_MILESTONE: "milestone",
   WPS_EVT_EXIT_REQUESTED: "exitrequested"
-}, R = (e) => {
+}, O = (e) => {
   if (typeof e != "string") return e;
-  const t = document.querySelector(e);
-  if (!t) throw new Error(`BranchVideo player container not found: ${e}`);
-  return t;
+  const n = document.querySelector(e);
+  if (!n) throw new Error(`BranchVideo player container not found: ${e}`);
+  return n;
 };
 function y(e) {
-  const t = e.parentOrigin ?? window.location.origin, n = new URL(e.runtimeUrl || w, window.location.href).href, i = b({ ...e, parentOrigin: t, runtimeUrl: n }), o = new URL(n).origin, r = document.createElement("iframe");
-  r.src = i, r.allow = "autoplay; fullscreen", r.title = e.title || "BranchVideo player", e.className && (r.className = e.className), R(e.container).appendChild(r);
-  const f = /* @__PURE__ */ new Map(), d = [];
+  const n = e.parentOrigin ?? window.location.origin, r = new URL(e.runtimeUrl || w, window.location.href).href, i = R({ ...e, parentOrigin: n, runtimeUrl: r }), c = new URL(r).origin, t = document.createElement("iframe");
+  t.src = i, t.allow = "autoplay; fullscreen", t.title = e.title || "BranchVideo player", e.className && (t.className = e.className), O(e.container).appendChild(t);
+  const d = /* @__PURE__ */ new Map(), f = [];
   let l = "pending", u = !1;
-  const m = (s, c) => {
+  const m = (s, o) => {
     if (!u) {
       if (l === "pending") {
-        d.push({ eventName: s, data: c });
+        f.push({ eventName: s, data: o });
         return;
       }
-      l !== "failed" && r.contentWindow?.postMessage({ eventName: s, data: c, timestamp: Date.now() }, o);
+      l !== "failed" && t.contentWindow?.postMessage({ eventName: s, data: o, timestamp: Date.now() }, c);
     }
   }, S = () => {
-    for (; d.length; ) {
-      const s = d.shift();
-      r.contentWindow?.postMessage({ ...s, timestamp: Date.now() }, o);
+    for (; f.length; ) {
+      const s = f.shift();
+      t.contentWindow?.postMessage({ ...s, timestamp: Date.now() }, c);
     }
-  }, p = (s) => {
-    if (u || s.source !== r.contentWindow || s.origin !== o) return;
-    const c = s.data;
-    if (!c || typeof c.eventName != "string") return;
-    const a = O[c.eventName];
+  }, g = (s) => {
+    if (u || s.source !== t.contentWindow || s.origin !== c) return;
+    const o = s.data;
+    if (!o || typeof o.eventName != "string") return;
+    const a = b[o.eventName];
     if (a) {
       if (a === "ready") {
-        if (c.data?.protocolVersion !== 1) {
-          l === "pending" && (l = "failed", d.length = 0);
+        if (o.data?.protocolVersion !== 1) {
+          l === "pending" && (l = "failed", f.length = 0);
           return;
         }
         if (l !== "pending") return;
         l = "ready", S();
       }
-      a === "error" && l === "pending" && (l = "failed", d.length = 0), f.get(a)?.forEach((g) => g(c.data));
+      a === "error" && l === "pending" && (l = "failed", f.length = 0), d.get(a)?.forEach((h) => h(o.data));
     }
   };
-  return window.addEventListener("message", p), {
-    iframe: r,
+  return window.addEventListener("message", g), {
+    iframe: t,
     play: () => m("WPS_CMD_PLAY"),
     pause: () => m("WPS_CMD_PAUSE"),
     seek: (s) => {
       Number.isFinite(s) && m("WPS_CMD_SEEK", { position: Math.max(0, s) });
     },
-    on: (s, c) => {
-      const a = f.get(s) || /* @__PURE__ */ new Set();
-      return a.add(c), f.set(s, a), () => a.delete(c);
+    on: (s, o) => {
+      const a = d.get(s) || /* @__PURE__ */ new Set();
+      return a.add(o), d.set(s, a), () => a.delete(o);
     },
     destroy: () => {
-      u || (u = !0, d.length = 0, f.clear(), window.removeEventListener("message", p), r.remove());
+      u || (u = !0, f.length = 0, d.clear(), window.removeEventListener("message", g), t.remove());
     }
   };
 }
 export {
   w as DEFAULT_RUNTIME_PATH,
-  b as buildBranchVideoPlayerUrl,
+  R as buildBranchVideoPlayerUrl,
   y as createBranchVideoPlayer
 };

package/dist/index.umd.cjs

@@ -1 +1 @@
-(function(l,f){typeof exports=="object"&&typeof module<"u"?f(exports):typeof define=="function"&&define.amd?define(["exports"],f):(l=typeof globalThis<"u"?globalThis:l||self,f(l.BranchVideoPlayerSDK={}))})(this,(function(l){"use strict";const f="/branch-video-runtime/player.html",h=e=>/^\d+$/.test(e)&&Number(e)>0&&Number(e)<=65535,w=e=>{const n=e.split(".");return n.length===4&&n.every(t=>/^\d+$/.test(t)&&Number(t)<=255)},V=e=>{if(!/^[0-9a-f:]+$/i.test(e))return!1;const n=e.split("::");if(n.length>2)return!1;const t=n.flatMap(i=>i?i.split(":"):[]);return t.every(i=>/^[0-9a-f]{1,4}$/i.test(i))?n.length===2?t.length<8:t.length===8:!1},E=e=>{const n=e.endsWith(".")?e.slice(0,-1):e;return/^[\d.]+$/.test(n)?w(n):!!n&&!n.includes("..")&&n.split(".").every(t=>/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i.test(t))},y=e=>{if(!e||e.includes("@"))return!1;if(e.startsWith("[")){const i=e.indexOf("]"),o=e.slice(1,i),r=e.slice(i+1);return i<=1||!V(o)?!1:!r||r.startsWith(":")&&h(r.slice(1))}const n=e.lastIndexOf(":");if(n===-1)return E(e);const t=e.slice(0,n);return E(t)&&!t.includes(":")&&h(e.slice(n+1))},_=e=>{const n=/^(https?):\/\/([^\s/?#]+)([/\?#].*)?$/i.exec(e);return!n||!y(n[2])?null:{authority:n[2],suffix:n[3]||""}},b=e=>_(e)!==null,T=(e,n)=>{if(!b(n)||e==="runtimeUrl"&&n.includes("#"))throw new TypeError(`${e} must be an absolute HTTP(S) URL`);return n},W=e=>{const n=_(e);if(!n||n.suffix&&n.suffix!=="/")throw new TypeError("parentOrigin must be an HTTP(S) origin");return e.endsWith("/")?e.slice(0,-1):e};function P(e){const n=e.runtimeUrl?T("runtimeUrl",e.runtimeUrl):f,t=T("scriptUrl",e.scriptUrl),i=e.parentOrigin===void 0?void 0:W(e.parentOrigin),o=[`script=${encodeURIComponent(t)}`,"embedPlatform=web_player_sdk","sdkProtocol=1"];i&&o.push(`parentOrigin=${encodeURIComponent(i)}`),e.cshost&&o.push(`cshost=${encodeURIComponent(e.cshost)}`),e.controls!==void 0&&o.push(`controls=${e.controls}`),e.debug!==void 0&&o.push(`debug=${e.debug}`);const r=n.includes("?")?"&":"?";return`${n}${r}${o.join("&")}`}const $={WPS_EVT_LOADED:"loaded",WPS_EVT_READY:"ready",WPS_EVT_STATE_CHANGE:"statechange",WPS_EVT_PROGRESS:"progress",WPS_EVT_ENDED:"ended",WPS_EVT_ERROR:"error",WPS_EVT_BUFFER_CHANGE:"bufferchange",WPS_EVT_MILESTONE:"milestone",WPS_EVT_EXIT_REQUESTED:"exitrequested"},O=e=>{if(typeof e!="string")return e;const n=document.querySelector(e);if(!n)throw new Error(`BranchVideo player container not found: ${e}`);return n};function R(e){const n=e.parentOrigin??window.location.origin,t=new URL(e.runtimeUrl||f,window.location.href).href,i=P({...e,parentOrigin:n,runtimeUrl:t}),o=new URL(t).origin,r=document.createElement("iframe");r.src=i,r.allow="autoplay; fullscreen",r.title=e.title||"BranchVideo player",e.className&&(r.className=e.className),O(e.container).appendChild(r);const m=new Map,u=[];let a="pending",p=!1;const g=(s,c)=>{if(!p){if(a==="pending"){u.push({eventName:s,data:c});return}a!=="failed"&&r.contentWindow?.postMessage({eventName:s,data:c,timestamp:Date.now()},o)}},N=()=>{for(;u.length;){const s=u.shift();r.contentWindow?.postMessage({...s,timestamp:Date.now()},o)}},U=s=>{if(p||s.source!==r.contentWindow||s.origin!==o)return;const c=s.data;if(!c||typeof c.eventName!="string")return;const d=$[c.eventName];if(d){if(d==="ready"){if(c.data?.protocolVersion!==1){a==="pending"&&(a="failed",u.length=0);return}if(a!=="pending")return;a="ready",N()}d==="error"&&a==="pending"&&(a="failed",u.length=0),m.get(d)?.forEach(S=>S(c.data))}};return window.addEventListener("message",U),{iframe:r,play:()=>g("WPS_CMD_PLAY"),pause:()=>g("WPS_CMD_PAUSE"),seek:s=>{Number.isFinite(s)&&g("WPS_CMD_SEEK",{position:Math.max(0,s)})},on:(s,c)=>{const d=m.get(s)||new Set;return d.add(c),m.set(s,d),()=>d.delete(c)},destroy:()=>{p||(p=!0,u.length=0,m.clear(),window.removeEventListener("message",U),r.remove())}}}l.DEFAULT_RUNTIME_PATH=f,l.buildBranchVideoPlayerUrl=P,l.createBranchVideoPlayer=R,Object.defineProperty(l,Symbol.toStringTag,{value:"Module"})}));
+(function(c,f){typeof exports=="object"&&typeof module<"u"?f(exports):typeof define=="function"&&define.amd?define(["exports"],f):(c=typeof globalThis<"u"?globalThis:c||self,f(c.BranchVideoPlayerSDK={}))})(this,(function(c){"use strict";const f="/branch-video-runtime/player.html",E=e=>/^\d+$/.test(e)&&Number(e)>0&&Number(e)<=65535,w=e=>{const n=e.split(".");return n.length===4&&n.every(r=>/^\d+$/.test(r)&&Number(r)<=255)},V=e=>{if(!/^[0-9a-f:]+$/i.test(e))return!1;const n=e.split("::");if(n.length>2)return!1;const r=n.flatMap(i=>i?i.split(":"):[]);return r.every(i=>/^[0-9a-f]{1,4}$/i.test(i))?n.length===2?r.length<8:r.length===8:!1},_=e=>{const n=e.endsWith(".")?e.slice(0,-1):e;return/^[\d.]+$/.test(n)?w(n):!!n&&!n.includes("..")&&n.split(".").every(r=>/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i.test(r))},y=e=>{if(!e||e.includes("@"))return!1;if(e.startsWith("[")){const i=e.indexOf("]"),l=e.slice(1,i),t=e.slice(i+1);return i<=1||!V(l)?!1:!t||t.startsWith(":")&&E(t.slice(1))}const n=e.lastIndexOf(":");if(n===-1)return _(e);const r=e.slice(0,n);return _(r)&&!r.includes(":")&&E(e.slice(n+1))},T=e=>{const n=/^(https?):\/\/([^\s/?#]+)([/\?#].*)?$/i.exec(e);return!n||!y(n[2])?null:{authority:n[2],suffix:n[3]||""}},b=e=>T(e)!==null,h=(e,n)=>{if(!b(n)||e==="runtimeUrl"&&n.includes("#"))throw new TypeError(`${e} must be an absolute HTTP(S) URL`);return n},W=e=>{const n=T(e);if(!n||n.suffix&&n.suffix!=="/")throw new TypeError("parentOrigin must be an HTTP(S) origin");return e.endsWith("/")?e.slice(0,-1):e};function U(e){const n=e.runtimeUrl?h("runtimeUrl",e.runtimeUrl):f,r=h("scriptUrl",e.scriptUrl),i=e.cover===void 0?void 0:h("cover",e.cover),l=e.parentOrigin===void 0?void 0:W(e.parentOrigin),t=[`script=${encodeURIComponent(r)}`,"embedPlatform=web_player_sdk","sdkProtocol=1"];i&&t.push(`cover=${encodeURIComponent(i)}`),l&&t.push(`parentOrigin=${encodeURIComponent(l)}`),e.cshost&&t.push(`cshost=${encodeURIComponent(e.cshost)}`),e.controls!==void 0&&t.push(`controls=${e.controls}`),e.debug!==void 0&&t.push(`debug=${e.debug}`);const u=n.includes("?")?"&":"?";return`${n}${u}${t.join("&")}`}const $={WPS_EVT_LOADED:"loaded",WPS_EVT_READY:"ready",WPS_EVT_STATE_CHANGE:"statechange",WPS_EVT_PROGRESS:"progress",WPS_EVT_ENDED:"ended",WPS_EVT_ERROR:"error",WPS_EVT_BUFFER_CHANGE:"bufferchange",WPS_EVT_MILESTONE:"milestone",WPS_EVT_EXIT_REQUESTED:"exitrequested"},R=e=>{if(typeof e!="string")return e;const n=document.querySelector(e);if(!n)throw new Error(`BranchVideo player container not found: ${e}`);return n};function O(e){const n=e.parentOrigin??window.location.origin,r=new URL(e.runtimeUrl||f,window.location.href).href,i=U({...e,parentOrigin:n,runtimeUrl:r}),l=new URL(r).origin,t=document.createElement("iframe");t.src=i,t.allow="autoplay; fullscreen",t.title=e.title||"BranchVideo player",e.className&&(t.className=e.className),R(e.container).appendChild(t);const u=new Map,m=[];let a="pending",p=!1;const g=(s,o)=>{if(!p){if(a==="pending"){m.push({eventName:s,data:o});return}a!=="failed"&&t.contentWindow?.postMessage({eventName:s,data:o,timestamp:Date.now()},l)}},N=()=>{for(;m.length;){const s=m.shift();t.contentWindow?.postMessage({...s,timestamp:Date.now()},l)}},P=s=>{if(p||s.source!==t.contentWindow||s.origin!==l)return;const o=s.data;if(!o||typeof o.eventName!="string")return;const d=$[o.eventName];if(d){if(d==="ready"){if(o.data?.protocolVersion!==1){a==="pending"&&(a="failed",m.length=0);return}if(a!=="pending")return;a="ready",N()}d==="error"&&a==="pending"&&(a="failed",m.length=0),u.get(d)?.forEach(S=>S(o.data))}};return window.addEventListener("message",P),{iframe:t,play:()=>g("WPS_CMD_PLAY"),pause:()=>g("WPS_CMD_PAUSE"),seek:s=>{Number.isFinite(s)&&g("WPS_CMD_SEEK",{position:Math.max(0,s)})},on:(s,o)=>{const d=u.get(s)||new Set;return d.add(o),u.set(s,d),()=>d.delete(o)},destroy:()=>{p||(p=!0,m.length=0,u.clear(),window.removeEventListener("message",P),t.remove())}}}c.DEFAULT_RUNTIME_PATH=f,c.buildBranchVideoPlayerUrl=U,c.createBranchVideoPlayer=O,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})}));