npm - branch-video-player-sdk - Versions diffs - 0.1.0 - Mend

branch-video-player-sdk 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,40 @@
+# BranchVideo Player SDK
+`@ndhy/branch-video-player-sdk` embeds a static BranchVideo Runtime in an iframe.
+```ts
+import { createBranchVideoPlayer } from '@ndhy/branch-video-player-sdk'
+const player = createBranchVideoPlayer({
+  container: '#player',
+  runtimeUrl: 'https://player.example.com/player.html',
+  scriptUrl: 'https://cdn.example.com/release/script.json',
+})
+player.on('ended', (result) => saveProgress(result))
+```
+The ESM entry is `@ndhy/branch-video-player-sdk`; the UMD build exposes
+`BranchVideoPlayerSDK`. For a WeChat `web-view` or another non-DOM host, import
+the pure URL entry instead:
+```ts
+import { buildBranchVideoPlayerUrl } from '@ndhy/branch-video-player-sdk/url'
+const src = buildBranchVideoPlayerUrl({
+  runtimeUrl: 'https://player.example.com/player.html',
+  scriptUrl: 'https://cdn.example.com/release/script.json',
+})
+```
+`runtimeUrl` and `scriptUrl` must be absolute HTTP(S) URLs. The script CDN must
+allow the Runtime origin with CORS. `parentOrigin`, when provided, must be an
+HTTP(S) origin only (no path, query, or fragment).
+Default Runtime builds are Service Worker off and may be deployed below a
+versioned subpath. The explicit SW-on Runtime requires `/player.html` and
+`/sw.js` at the root of a dedicated origin; do not deploy multiple SW-on builds
+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.

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,18 @@
+import { type BranchVideoPlayerUrlOptions } from './url';
+export { buildBranchVideoPlayerUrl } from './url';
+export type { BranchVideoPlayerUrlOptions };
+export interface CreateBranchVideoPlayerOptions extends BranchVideoPlayerUrlOptions {
+    container: HTMLElement | string;
+    title?: string;
+    className?: string;
+}
+export type BranchVideoPlayerEvent = 'loaded' | 'ready' | 'statechange' | 'progress' | 'ended' | 'error' | 'bufferchange' | 'milestone' | 'exitrequested';
+export interface BranchVideoPlayer {
+    readonly iframe: HTMLIFrameElement;
+    play(): void;
+    pause(): void;
+    seek(position: number): void;
+    on(event: BranchVideoPlayerEvent, handler: (data: unknown) => void): () => void;
+    destroy(): void;
+}
+export declare function createBranchVideoPlayer(options: CreateBranchVideoPlayerOptions): BranchVideoPlayer;

package/dist/index.js ADDED Viewed

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

package/dist/index.umd.cjs ADDED Viewed

@@ -0,0 +1 @@

package/dist/url.cjs ADDED Viewed

@@ -0,0 +1 @@

+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=e=>/^\d+$/.test(e)&&Number(e)>0&&Number(e)<=65535,u=e=>{const t=e.split(".");return t.length===4&&t.every(r=>/^\d+$/.test(r)&&Number(r)<=255)},f=e=>{if(!/^[0-9a-f:]+$/i.test(e))return!1;const t=e.split("::");if(t.length>2)return!1;const r=t.flatMap(s=>s?s.split(":"):[]);return r.every(s=>/^[0-9a-f]{1,4}$/i.test(s))?t.length===2?r.length<8:r.length===8:!1},l=e=>{const t=e.endsWith(".")?e.slice(0,-1):e;return/^[\d.]+$/.test(t)?u(t):!!t&&!t.includes("..")&&t.split(".").every(r=>/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i.test(r))},p=e=>{if(!e||e.includes("@"))return!1;if(e.startsWith("[")){const s=e.indexOf("]"),n=e.slice(1,s),i=e.slice(s+1);return s<=1||!f(n)?!1:!i||i.startsWith(":")&&c(i.slice(1))}const t=e.lastIndexOf(":");if(t===-1)return l(e);const r=e.slice(0,t);return l(r)&&!r.includes(":")&&c(e.slice(t+1))},d=e=>{const t=/^(https?):\/\/([^\s/?#]+)([/\?#].*)?$/i.exec(e);return!t||!p(t[2])?null:{authority:t[2],suffix:t[3]||""}},a=e=>d(e)!==null,o=(e,t)=>{if(!a(t)||e==="runtimeUrl"&&t.includes("#"))throw new TypeError(`${e} must be an absolute HTTP(S) URL`);return t},g=e=>{const t=d(e);if(!t||t.suffix&&t.suffix!=="/")throw new TypeError("parentOrigin must be an HTTP(S) origin");return e.endsWith("/")?e.slice(0,-1):e};function m(e){const t=o("runtimeUrl",e.runtimeUrl),r=o("scriptUrl",e.scriptUrl),s=e.parentOrigin===void 0?void 0:g(e.parentOrigin),n=[`script=${encodeURIComponent(r)}`,"embedPlatform=web_player_sdk","sdkProtocol=1"];return s&&n.push(`parentOrigin=${encodeURIComponent(s)}`),e.cshost&&n.push(`cshost=${encodeURIComponent(e.cshost)}`),e.controls!==void 0&&n.push(`controls=${e.controls}`),e.debug!==void 0&&n.push(`debug=${e.debug}`),`${t}${t.includes("?")?"&":"?"}${n.join("&")}`}exports.buildBranchVideoPlayerUrl=m;

package/dist/url.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+export interface BranchVideoPlayerUrlOptions {
+    runtimeUrl: string;
+    scriptUrl: string;
+    parentOrigin?: string;
+    cshost?: string;
+    controls?: boolean;
+    debug?: boolean;
+}
+export declare function buildBranchVideoPlayerUrl(options: BranchVideoPlayerUrlOptions): string;

package/dist/url.js ADDED Viewed

@@ -0,0 +1,44 @@
+const c = (t) => /^\d+$/.test(t) && Number(t) > 0 && Number(t) <= 65535, d = (t) => {
+  const e = t.split(".");
+  return e.length === 4 && e.every((r) => /^\d+$/.test(r) && Number(r) <= 255);
+}, u = (t) => {
+  if (!/^[0-9a-f:]+$/i.test(t)) return !1;
+  const e = t.split("::");
+  if (e.length > 2) return !1;
+  const r = e.flatMap((s) => s ? s.split(":") : []);
+  return r.every((s) => /^[0-9a-f]{1,4}$/i.test(s)) ? e.length === 2 ? r.length < 8 : r.length === 8 : !1;
+}, l = (t) => {
+  const e = t.endsWith(".") ? t.slice(0, -1) : t;
+  return /^[\d.]+$/.test(e) ? d(e) : !!e && !e.includes("..") && e.split(".").every((r) => /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i.test(r));
+}, p = (t) => {
+  if (!t || t.includes("@")) return !1;
+  if (t.startsWith("[")) {
+    const s = t.indexOf("]"), n = t.slice(1, s), i = t.slice(s + 1);
+    return s <= 1 || !u(n) ? !1 : !i || i.startsWith(":") && c(i.slice(1));
+  }
+  const e = t.lastIndexOf(":");
+  if (e === -1) return l(t);
+  const r = t.slice(0, e);
+  return l(r) && !r.includes(":") && c(t.slice(e + 1));
+}, f = (t) => {
+  const e = /^(https?):\/\/([^\s/?#]+)([/\?#].*)?$/i.exec(t);
+  return !e || !p(e[2]) ? null : { authority: e[2], suffix: e[3] || "" };
+}, a = (t) => f(t) !== null, o = (t, e) => {
+  if (!a(e) || t === "runtimeUrl" && e.includes("#")) throw new TypeError(`${t} must be an absolute HTTP(S) URL`);
+  return e;
+}, m = (t) => {
+  const e = f(t);
+  if (!e || e.suffix && e.suffix !== "/") throw new TypeError("parentOrigin must be an HTTP(S) origin");
+  return t.endsWith("/") ? t.slice(0, -1) : t;
+};
+function g(t) {
+  const e = o("runtimeUrl", t.runtimeUrl), r = o("scriptUrl", t.scriptUrl), s = t.parentOrigin === void 0 ? void 0 : m(t.parentOrigin), n = [
+    `script=${encodeURIComponent(r)}`,
+    "embedPlatform=web_player_sdk",
+    "sdkProtocol=1"
+  ];
+  return s && n.push(`parentOrigin=${encodeURIComponent(s)}`), t.cshost && n.push(`cshost=${encodeURIComponent(t.cshost)}`), t.controls !== void 0 && n.push(`controls=${t.controls}`), t.debug !== void 0 && n.push(`debug=${t.debug}`), `${e}${e.includes("?") ? "&" : "?"}${n.join("&")}`;
+}
+export {
+  g as buildBranchVideoPlayerUrl
+};

package/package.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+  "name": "branch-video-player-sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.umd.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/index.umd.cjs",
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js", "require": "./dist/index.umd.cjs" },
+    "./url": { "types": "./dist/url.d.ts", "import": "./dist/url.js", "require": "./dist/url.cjs" }
+  },
+  "files": ["dist", "README.md"]
+}