@guardvideo/player-sdk 1.0.1 → 1.0.2

package/dist/core/player.d.ts

@@ -2,16 +2,37 @@ import { PlayerConfig, PlayerState, PlayerInstance, QualityLevel } from './types
 export declare class GuardVideoPlayer implements PlayerInstance {
     private videoId;
     private videoElement;
+    private container;
     private hls;
     private config;
     private state;
     private embedToken;
     private currentQuality;
+    private ctxMenu;
+    private ctxStyleTag;
+    private watermarkEl;
+    private watermarkObserver;
+    private _onCtx;
+    private _onDocClick;
+    private _onKeyDown;
+    private _onRateChange;
+    private _onSelectStart;
+    private _onDragStart;
     constructor(videoElement: HTMLVideoElement, videoId: string, config: PlayerConfig);
     private log;
     private error;
     private setState;
+    private checkAllowedDomain;
+    private applySecurity;
+    private handleContextMenu;
+    private showContextMenu;
+    private hideContextMenu;
+    private injectProtectiveStyles;
+    private createWatermark;
+    private handleKeyDown;
+    private enforceMaxRate;
     private initialize;
+    private fetchAndApplyWatermark;
     private fetchEmbedToken;
     private initializePlayer;
     private initializeHls;

package/dist/core/player.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../src/core/player.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,YAAY,EAEZ,WAAW,EACX,cAAc,EACd,YAAY,EAEb,MAAM,SAAS,CAAC;AAEjB,qBAAa,gBAAiB,YAAW,cAAc;IAUnD,OAAO,CAAC,OAAO;IATjB,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,cAAc,CAA6B;gBAGjD,YAAY,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACvB,MAAM,EAAE,YAAY;IAsBtB,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,QAAQ;YAQF,UAAU;YAoBV,eAAe;YAwBf,gBAAgB;IAgC9B,OAAO,CAAC,aAAa;IAsErB,OAAO,CAAC,wBAAwB;IAiChC,OAAO,CAAC,WAAW;IAQN,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,KAAK,IAAI,IAAI;IAIb,cAAc,IAAI,MAAM;IAIxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,WAAW,IAAI,MAAM;IAIrB,SAAS,IAAI,MAAM;IAInB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,gBAAgB,IAAI,YAAY,EAAE;IAYlC,iBAAiB,IAAI,YAAY,GAAG,IAAI;IAIxC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOpC,QAAQ,IAAI,WAAW;IAIvB,OAAO,IAAI,IAAI;CAYvB"}
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../src/core/player.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,YAAY,EAEZ,WAAW,EACX,cAAc,EACd,YAAY,EAKb,MAAM,SAAS,CAAC;AA4BjB,qBAAa,gBAAiB,YAAW,cAAc;IA4BnD,OAAO,CAAC,OAAO;IA3BjB,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,cAAc,CAA6B;IAGnD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,WAAW,CAAiC;IAGpD,OAAO,CAAC,WAAW,CAA+B;IAElD,OAAO,CAAC,iBAAiB,CAAiC;IAG1D,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,YAAY,CAAoC;gBAGtD,YAAY,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACvB,MAAM,EAAE,YAAY;IAwCtB,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,aAAa;IA0DrB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,eAAe;IAqHvB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,sBAAsB;IA4G9B,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,cAAc;YAWR,UAAU;YAwBV,sBAAsB;YA8BtB,eAAe;YA2Bf,gBAAgB;IAgC9B,OAAO,CAAC,aAAa;IAsErB,OAAO,CAAC,wBAAwB;IAiChC,OAAO,CAAC,WAAW;IASN,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,KAAK,IAAI,IAAI;IAIb,cAAc,IAAI,MAAM;IAIxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,WAAW,IAAI,MAAM;IAIrB,SAAS,IAAI,MAAM;IAInB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,gBAAgB,IAAI,YAAY,EAAE;IAYlC,iBAAiB,IAAI,YAAY,GAAG,IAAI;IAIxC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOpC,QAAQ,IAAI,WAAW;IAIvB,OAAO,IAAI,IAAI;CA2BvB"}

package/dist/core/types.d.ts

@@ -6,6 +6,33 @@ export interface EmbedTokenResponse {
     maxViews: number | null;
     playerUrl: string;
     embedCode?: string;
+    watermarkText?: string | null;
+    forensicWatermark?: boolean;
+}
+export interface ContextMenuItem {
+    label: string;
+    href?: string;
+    onClick?: () => void;
+    icon?: string;
+    separator?: boolean;
+}
+export interface BrandingConfig {
+    name?: string;
+    url?: string;
+    logoUrl?: string;
+    accentColor?: string;
+}
+export interface SecurityConfig {
+    disableRightClick?: boolean;
+    disableSelection?: boolean;
+    disableDrag?: boolean;
+    enableWatermark?: boolean;
+    watermarkText?: string;
+    disablePiP?: boolean;
+    disableScreenCapture?: boolean;
+    blockDevTools?: boolean;
+    maxPlaybackRate?: number;
+    allowedDomains?: string[];
 }
 export interface PlayerConfig {
     embedTokenEndpoint: string;
@@ -16,6 +43,12 @@ export interface PlayerConfig {
     className?: string;
     style?: React.CSSProperties | Record<string, string>;
     hlsConfig?: Partial<HlsConfig>;
+    branding?: BrandingConfig;
+    contextMenuItems?: ContextMenuItem[];
+    security?: SecurityConfig;
+    viewerName?: string;
+    viewerEmail?: string;
+    forensicWatermark?: boolean;
     onReady?: () => void;
     onError?: (error: PlayerError) => void;
     onQualityChange?: (quality: string) => void;

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAK3B,kBAAkB,EAAE,MAAM,CAAC;IAM3B,UAAU,CAAC,EAAE,MAAM,CAAC;IAMpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAMhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAMnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAKnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAKrD,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAK/B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAKrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAKvC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAK5C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAI7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAKtB,KAAK,IAAI,IAAI,CAAC;IAKd,cAAc,IAAI,MAAM,CAAC;IAKzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAKzB,WAAW,IAAI,MAAM,CAAC;IAKtB,SAAS,IAAI,MAAM,CAAC;IAKpB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAKhC,gBAAgB,IAAI,YAAY,EAAE,CAAC;IAKnC,iBAAiB,IAAI,YAAY,GAAG,IAAI,CAAC;IAKzC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAKrC,QAAQ,IAAI,WAAW,CAAC;IAKxB,OAAO,IAAI,IAAI,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/index.esm.js

@@ -12,14 +12,44 @@ var PlayerState;
     PlayerState["ERROR"] = "error";
 })(PlayerState || (PlayerState = {}));
 
+const DEFAULT_BRANDING = {
+    name: 'GuardVideo',
+    url: 'https://guardvid.com',
+    logoUrl: '',
+    accentColor: '#44c09b',
+};
+const DEFAULT_SECURITY = {
+    disableRightClick: false,
+    disableSelection: true,
+    disableDrag: true,
+    enableWatermark: false,
+    watermarkText: '',
+    disablePiP: false,
+    disableScreenCapture: false,
+    blockDevTools: false,
+    maxPlaybackRate: 2,
+    allowedDomains: [],
+};
 class GuardVideoPlayer {
     constructor(videoElement, videoId, config) {
         this.videoId = videoId;
+        this.container = null;
         this.hls = null;
         this.state = PlayerState.IDLE;
         this.embedToken = null;
         this.currentQuality = null;
+        this.ctxMenu = null;
+        this.ctxStyleTag = null;
+        this.watermarkEl = null;
+        this.watermarkObserver = null;
+        this._onCtx = this.handleContextMenu.bind(this);
+        this._onDocClick = this.hideContextMenu.bind(this);
+        this._onKeyDown = this.handleKeyDown.bind(this);
+        this._onRateChange = this.enforceMaxRate.bind(this);
+        this._onSelectStart = (e) => e.preventDefault();
+        this._onDragStart = (e) => e.preventDefault();
         this.videoElement = videoElement;
+        this.container = videoElement.parentElement;
         this.config = {
             embedTokenEndpoint: config.embedTokenEndpoint,
             apiBaseUrl: config.apiBaseUrl || '',
@@ -29,12 +59,21 @@ class GuardVideoPlayer {
             className: config.className || '',
             style: config.style || {},
             hlsConfig: config.hlsConfig || {},
+            branding: { ...DEFAULT_BRANDING, ...config.branding },
+            contextMenuItems: config.contextMenuItems || [],
+            security: { ...DEFAULT_SECURITY, ...config.security },
+            viewerName: config.viewerName || '',
+            viewerEmail: config.viewerEmail || '',
+            forensicWatermark: config.forensicWatermark || false,
             onReady: config.onReady || (() => { }),
             onError: config.onError || (() => { }),
             onQualityChange: config.onQualityChange || (() => { }),
             onStateChange: config.onStateChange || (() => { }),
         };
         this.log('Initializing GuardVideo Player', { videoId, config });
+        if (!this.checkAllowedDomain())
+            return;
+        this.applySecurity();
         this.initialize();
     }
     log(message, data) {
@@ -52,12 +91,321 @@ class GuardVideoPlayer {
             this.log(`State changed to: ${newState}`);
         }
     }
+    checkAllowedDomain() {
+        const domains = this.config.security.allowedDomains;
+        if (!domains || domains.length === 0)
+            return true;
+        const currentOrigin = typeof window !== 'undefined' ? window.location.origin : '';
+        const allowed = domains.some((d) => currentOrigin === d || currentOrigin.endsWith(`.${d.replace(/^https?:\/\//, '')}`));
+        if (!allowed) {
+            this.handleError({
+                code: 'DOMAIN_NOT_ALLOWED',
+                message: `This player is not authorized to run on ${currentOrigin}`,
+                fatal: true,
+            });
+            return false;
+        }
+        return true;
+    }
+    applySecurity() {
+        const sec = this.config.security;
+        const target = this.container || this.videoElement;
+        target.addEventListener('contextmenu', this._onCtx);
+        document.addEventListener('click', this._onDocClick);
+        if (sec.disableSelection) {
+            target.addEventListener('selectstart', this._onSelectStart);
+            target.style.userSelect = 'none';
+            target.style.webkitUserSelect = 'none';
+        }
+        if (sec.disableDrag) {
+            this.videoElement.addEventListener('dragstart', this._onDragStart);
+            this.videoElement.draggable = false;
+        }
+        if (sec.disablePiP) {
+            this.videoElement.disablePictureInPicture = true;
+        }
+        if (sec.disableScreenCapture) {
+            if ('mediaKeys' in this.videoElement && typeof navigator.requestMediaKeySystemAccess === 'function') {
+                this.log('Screen-capture protection: EME hint applied');
+            }
+            target.style.setProperty('-webkit-app-region', 'no-drag');
+        }
+        if (sec.blockDevTools) {
+            document.addEventListener('keydown', this._onKeyDown);
+        }
+        if (sec.maxPlaybackRate) {
+            this.videoElement.addEventListener('ratechange', this._onRateChange);
+        }
+        if (sec.enableWatermark && sec.watermarkText && this.container) {
+            this.createWatermark(sec.watermarkText);
+        }
+        this.injectProtectiveStyles();
+    }
+    handleContextMenu(e) {
+        e.preventDefault();
+        e.stopPropagation();
+        const sec = this.config.security;
+        if (sec.disableRightClick)
+            return;
+        const me = e;
+        this.showContextMenu(me.clientX, me.clientY);
+    }
+    showContextMenu(x, y) {
+        this.hideContextMenu();
+        const branding = this.config.branding;
+        const extraItems = this.config.contextMenuItems;
+        const menu = document.createElement('div');
+        menu.className = 'gv-ctx-menu';
+        menu.setAttribute('role', 'menu');
+        const header = document.createElement('a');
+        header.className = 'gv-ctx-header';
+        header.href = branding.url;
+        header.target = '_blank';
+        header.rel = 'noopener noreferrer';
+        header.setAttribute('role', 'menuitem');
+        if (branding.logoUrl) {
+            const logo = document.createElement('img');
+            logo.src = branding.logoUrl;
+            logo.alt = branding.name;
+            logo.className = 'gv-ctx-logo';
+            logo.width = 20;
+            logo.height = 20;
+            header.appendChild(logo);
+        }
+        else {
+            const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+            svg.setAttribute('width', '18');
+            svg.setAttribute('height', '18');
+            svg.setAttribute('viewBox', '0 0 24 24');
+            svg.setAttribute('fill', 'none');
+            svg.setAttribute('stroke', branding.accentColor);
+            svg.setAttribute('stroke-width', '2');
+            svg.setAttribute('stroke-linecap', 'round');
+            svg.setAttribute('stroke-linejoin', 'round');
+            svg.innerHTML = '<path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/>';
+            header.appendChild(svg);
+        }
+        const nameSpan = document.createElement('span');
+        nameSpan.className = 'gv-ctx-brand-name';
+        nameSpan.textContent = branding.name;
+        header.appendChild(nameSpan);
+        const tagSpan = document.createElement('span');
+        tagSpan.className = 'gv-ctx-tag';
+        tagSpan.textContent = 'Secure Video Player';
+        header.appendChild(tagSpan);
+        menu.appendChild(header);
+        if (extraItems.length > 0) {
+            extraItems.forEach((item) => {
+                if (item.separator) {
+                    const sep = document.createElement('div');
+                    sep.className = 'gv-ctx-sep';
+                    menu.appendChild(sep);
+                }
+                const row = document.createElement('div');
+                row.className = 'gv-ctx-item';
+                row.setAttribute('role', 'menuitem');
+                row.tabIndex = 0;
+                if (item.icon) {
+                    const ico = document.createElement('img');
+                    ico.src = item.icon;
+                    ico.width = 14;
+                    ico.height = 14;
+                    ico.className = 'gv-ctx-item-icon';
+                    row.appendChild(ico);
+                }
+                const label = document.createElement('span');
+                label.textContent = item.label;
+                row.appendChild(label);
+                row.addEventListener('click', (ev) => {
+                    ev.stopPropagation();
+                    this.hideContextMenu();
+                    if (item.onClick) {
+                        item.onClick();
+                    }
+                    else if (item.href) {
+                        window.open(item.href, '_blank', 'noopener,noreferrer');
+                    }
+                });
+                menu.appendChild(row);
+            });
+        }
+        const sep = document.createElement('div');
+        sep.className = 'gv-ctx-sep';
+        menu.appendChild(sep);
+        const version = document.createElement('div');
+        version.className = 'gv-ctx-version';
+        version.textContent = `${branding.name} Player v1.0`;
+        menu.appendChild(version);
+        document.body.appendChild(menu);
+        const rect = menu.getBoundingClientRect();
+        const vw = window.innerWidth;
+        const vh = window.innerHeight;
+        menu.style.left = `${x + rect.width > vw ? vw - rect.width - 8 : x}px`;
+        menu.style.top = `${y + rect.height > vh ? vh - rect.height - 8 : y}px`;
+        this.ctxMenu = menu;
+    }
+    hideContextMenu() {
+        if (this.ctxMenu) {
+            this.ctxMenu.remove();
+            this.ctxMenu = null;
+        }
+    }
+    injectProtectiveStyles() {
+        if (this.ctxStyleTag)
+            return;
+        const branding = this.config.branding;
+        const accent = branding.accentColor;
+        const css = `
+/* GuardVideo branded context menu */
+.gv-ctx-menu {
+  position: fixed;
+  z-index: 2147483647;
+  min-width: 220px;
+  background: rgba(18, 18, 22, 0.96);
+  backdrop-filter: blur(12px);
+  -webkit-backdrop-filter: blur(12px);
+  border: 1px solid rgba(255,255,255,0.08);
+  border-radius: 10px;
+  padding: 6px 0;
+  box-shadow: 0 8px 32px rgba(0,0,0,0.45), 0 0 0 1px rgba(255,255,255,0.04);
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+  font-size: 13px;
+  color: #e4e4e7;
+  user-select: none;
+  animation: gv-ctx-in 0.12s ease-out;
+}
+@keyframes gv-ctx-in {
+  from { opacity: 0; transform: scale(0.96); }
+  to   { opacity: 1; transform: scale(1); }
+}
+
+.gv-ctx-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 14px 8px 12px;
+  text-decoration: none;
+  color: inherit;
+  transition: background 0.15s;
+  border-radius: 6px 6px 0 0;
+}
+.gv-ctx-header:hover { background: rgba(255,255,255,0.06); }
+
+.gv-ctx-logo { border-radius: 4px; }
+
+.gv-ctx-brand-name {
+  font-weight: 600;
+  color: ${accent};
+  white-space: nowrap;
+}
+
+.gv-ctx-tag {
+  margin-left: auto;
+  font-size: 10px;
+  color: rgba(255,255,255,0.35);
+  white-space: nowrap;
+}
+
+.gv-ctx-sep {
+  height: 1px;
+  margin: 4px 10px;
+  background: rgba(255,255,255,0.07);
+}
+
+.gv-ctx-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 7px 14px 7px 12px;
+  cursor: pointer;
+  transition: background 0.15s;
+}
+.gv-ctx-item:hover { background: rgba(255,255,255,0.06); }
+.gv-ctx-item-icon { border-radius: 2px; }
+
+.gv-ctx-version {
+  padding: 4px 14px 6px 12px;
+  font-size: 10px;
+  color: rgba(255,255,255,0.25);
+}
+
+/* Watermark overlay */
+.gv-watermark {
+  position: absolute;
+  inset: 0;
+  pointer-events: none;
+  overflow: hidden;
+  z-index: 10;
+}
+.gv-watermark-text {
+  position: absolute;
+  white-space: nowrap;
+  font-size: 14px;
+  font-family: monospace;
+  color: rgba(255,255,255,0.07);
+  transform: rotate(-30deg);
+  user-select: none;
+  pointer-events: none;
+}
+`;
+        const tag = document.createElement('style');
+        tag.setAttribute('data-guardvideo', 'player-styles');
+        tag.textContent = css;
+        document.head.appendChild(tag);
+        this.ctxStyleTag = tag;
+    }
+    createWatermark(text) {
+        if (!this.container)
+            return;
+        const overlay = document.createElement('div');
+        overlay.className = 'gv-watermark';
+        for (let row = 0; row < 5; row++) {
+            for (let col = 0; col < 4; col++) {
+                const span = document.createElement('span');
+                span.className = 'gv-watermark-text';
+                span.textContent = text;
+                span.style.left = `${col * 28 + (row % 2) * 14}%`;
+                span.style.top = `${row * 22}%`;
+                overlay.appendChild(span);
+            }
+        }
+        this.container.style.position = 'relative';
+        this.container.appendChild(overlay);
+        this.watermarkEl = overlay;
+        this.watermarkObserver = new MutationObserver(() => {
+            if (this.container && this.watermarkEl && !this.container.contains(this.watermarkEl)) {
+                this.container.appendChild(this.watermarkEl);
+            }
+        });
+        this.watermarkObserver.observe(this.container, { childList: true, subtree: false });
+    }
+    handleKeyDown(e) {
+        if (e.key === 'F12') {
+            e.preventDefault();
+            return;
+        }
+        if (e.ctrlKey && e.shiftKey && ['I', 'J', 'C'].includes(e.key.toUpperCase())) {
+            e.preventDefault();
+            return;
+        }
+        if (e.ctrlKey && e.key.toUpperCase() === 'U') {
+            e.preventDefault();
+        }
+    }
+    enforceMaxRate() {
+        const max = this.config.security.maxPlaybackRate;
+        if (this.videoElement.playbackRate > max) {
+            this.videoElement.playbackRate = max;
+            this.log(`Playback rate clamped to ${max}`);
+        }
+    }
     async initialize() {
         try {
             this.setState(PlayerState.LOADING);
             this.embedToken = await this.fetchEmbedToken();
             this.log('Embed token received', this.embedToken);
             await this.initializePlayer();
+            await this.fetchAndApplyWatermark();
         }
         catch (err) {
             this.handleError({
@@ -68,6 +416,35 @@ class GuardVideoPlayer {
             });
         }
     }
+    async fetchAndApplyWatermark() {
+        if (!this.embedToken || !this.config.apiBaseUrl)
+            return;
+        try {
+            const tokenId = this.embedToken.tokenId;
+            const url = `${this.config.apiBaseUrl}/videos/stream/${this.videoId}/viewer-config?token=${encodeURIComponent(tokenId)}`;
+            const resp = await fetch(url, { credentials: 'omit' });
+            if (!resp.ok) {
+                this.log('viewer-config fetch failed, falling back to SDK config', resp.status);
+                const sec = this.config.security;
+                if (sec.enableWatermark && sec.watermarkText && this.container) {
+                    this.createWatermark(sec.watermarkText);
+                }
+                return;
+            }
+            const cfg = await resp.json();
+            this.log('Watermark config from server:', cfg);
+            if (cfg.enableWatermark && cfg.watermarkText && this.container) {
+                this.createWatermark(cfg.watermarkText);
+            }
+        }
+        catch (err) {
+            this.log('fetchAndApplyWatermark error (non-fatal):', err);
+            const sec = this.config.security;
+            if (sec.enableWatermark && sec.watermarkText && this.container) {
+                this.createWatermark(sec.watermarkText);
+            }
+        }
+    }
     async fetchEmbedToken() {
         const url = `${this.config.embedTokenEndpoint}/${this.videoId}`;
         this.log('Fetching embed token from', url);
@@ -80,6 +457,9 @@ class GuardVideoPlayer {
                 allowedDomain: window.location.origin,
                 expiresInMinutes: 120,
                 maxViews: null,
+                ...(this.config.viewerName ? { viewerName: this.config.viewerName } : {}),
+                ...(this.config.viewerEmail ? { viewerEmail: this.config.viewerEmail } : {}),
+                ...(this.config.forensicWatermark ? { forensicWatermark: this.config.forensicWatermark } : {}),
             }),
         });
         if (!response.ok) {
@@ -256,6 +636,17 @@ class GuardVideoPlayer {
     }
     destroy() {
         this.log('Destroying player');
+        const target = this.container || this.videoElement;
+        target.removeEventListener('contextmenu', this._onCtx);
+        target.removeEventListener('selectstart', this._onSelectStart);
+        this.videoElement.removeEventListener('dragstart', this._onDragStart);
+        this.videoElement.removeEventListener('ratechange', this._onRateChange);
+        document.removeEventListener('click', this._onDocClick);
+        document.removeEventListener('keydown', this._onKeyDown);
+        this.hideContextMenu();
+        this.watermarkObserver?.disconnect();
+        this.watermarkEl?.remove();
+        this.ctxStyleTag?.remove();
         if (this.hls) {
             this.hls.destroy();
             this.hls = null;
@@ -267,7 +658,7 @@ class GuardVideoPlayer {
 }
 
 const GuardVideoPlayerComponent = forwardRef((props, ref) => {
-    const { videoId, width = '100%', height = 'auto', embedTokenEndpoint, apiBaseUrl, debug = false, autoplay = false, controls = true, className = '', style = {}, hlsConfig, onReady, onError, onQualityChange, onStateChange, onTimeUpdate, onEnded, } = props;
+    const { videoId, width = '100%', height = 'auto', embedTokenEndpoint, apiBaseUrl, debug = false, autoplay = false, controls = true, className = '', style = {}, hlsConfig, branding, contextMenuItems, security, onReady, onError, onQualityChange, onStateChange, onTimeUpdate, onEnded, } = props;
     const videoRef = useRef(null);
     const playerRef = useRef(null);
     const [error, setError] = useState(null);
@@ -284,6 +675,9 @@ const GuardVideoPlayerComponent = forwardRef((props, ref) => {
             className,
             style,
             hlsConfig,
+            branding,
+            contextMenuItems,
+            security,
             onReady: () => {
                 onReady?.();
             },