ogplayer 1.1.1 → 1.2.0

package/dist/ui/og-player.d.ts

@@ -192,6 +192,8 @@ export declare class OGPlayerElement extends HTMLElement {
      * renders its own skip/clickthrough on top of its layer). */
     private syncAdUi;
     private syncWatermark;
+    /** Same markup as the template's `.watermark` — used when the node was removed from the open shadow root. */
+    private createWatermarkNode;
     private applyCueSize;
     /** iPhone Safari has no element fullscreen API — only the <video> element
      * can go fullscreen, through Apple's native player. Detect and fall back. */

package/dist/ui/watermark.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Unlicensed-watermark node upkeep, kept player-free so it can be unit-tested
+ * without a DOM.
+ *
+ * The <og-player> shadow root is OPEN, so a host page can reach in and remove
+ * the `.watermark` node — a developer poking at the DOM, a cleanup script.
+ * Two consequences this guards against: (1) the next control sync must not
+ * throw on the missing node and take every other overlay down with it, and
+ * (2) while the player is unlicensed the mark is re-created on the next sync,
+ * so a removal lasts only until the next player event — the same standing as
+ * Android/iOS, where the mark is a composable / SwiftUI view with no
+ * addressable instance to remove. Tampering with the mark is a terms-of-use
+ * matter either way (terms §3); this keeps the SDK's own behaviour consistent.
+ */
+export interface WatermarkHost {
+    querySelector(selectors: string): Element | null;
+    insertBefore<T extends Node>(node: T, child: Node | null): T;
+    appendChild<T extends Node>(node: T): T;
+}
+/**
+ * Makes `.watermark` reflect `licensed`: hidden when licensed, shown (and
+ * re-created via `create` if missing) when not. Returns the node, or null when
+ * licensed and absent — nothing to show, nothing to build.
+ */
+export declare function syncWatermarkNode(root: WatermarkHost, licensed: boolean, create: () => HTMLElement): HTMLElement | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ogplayer",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "OGPlayer web SDK — one video player API across Android, iOS, web and React Native.",
   "type": "module",
   "main": "./dist/ogplayer.js",