@guardvideo/player-sdk 3.3.0 → 3.5.0

package/dist/core/EventTracker.d.ts

@@ -21,6 +21,8 @@ export declare class EventTracker {
     private accumulator;
     private destroyed;
     private _onBeforeUnload;
+    private flushBackoff;
+    private flushing;
     constructor(config: EventTrackerConfig);
     track(type: string, positionSeconds?: number, payload?: Record<string, unknown>): void;
     startChunk(position: number): void;
@@ -30,6 +32,7 @@ export declare class EventTracker {
     flush(): Promise<void>;
     destroy(): void;
     private startAutoFlush;
+    private restartAutoFlush;
     private hookPageUnload;
     private sendBatch;
     private randomNonce;

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

@@ -1 +1 @@
-{"version":3,"file":"EventTracker.d.ts","sourceRoot":"","sources":["../../src/core/EventTracker.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAEjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAKD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAA6B;gBAExC,MAAM,EAAE,kBAAkB;IAkBtC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IActF,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKlC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKjC,QAAQ,IAAI,IAAI;IAKhB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,cAAc;YA+BR,SAAS;IAsCvB,OAAO,CAAC,WAAW;YASL,IAAI;CAenB"}
+{"version":3,"file":"EventTracker.d.ts","sourceRoot":"","sources":["../../src/core/EventTracker.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAEjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAMD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAA6B;IAEpD,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,kBAAkB;IAoBtC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAqBtF,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKlC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKjC,QAAQ,IAAI,IAAI;IAKhB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,cAAc;YA+BR,SAAS;IA4DvB,OAAO,CAAC,WAAW;YASL,IAAI;CAenB"}

package/dist/core/player.d.ts

@@ -13,6 +13,11 @@ export declare class GuardVideoPlayer implements PlayerInstance {
     private sessionId;
     private playlistNonce;
     private nonceRefreshInProgress;
+    private nonceRefreshTimer;
+    private retryBackoff;
+    private readonly MAX_BACKOFF;
+    private rateLimitCooldownUntil;
+    private nonceRefreshPromise;
     private _onRateChange;
     constructor(videoElement: HTMLVideoElement, videoId: string, config: PlayerConfig);
     private log;
@@ -27,7 +32,9 @@ export declare class GuardVideoPlayer implements PlayerInstance {
     private fetchEmbedToken;
     private solveChallenge;
     private acquireNonce;
+    private scheduleNonceRefresh;
     private refreshNonce;
+    private enterRateLimitCooldown;
     private initializePlayer;
     private initializeHls;
     private setupVideoEventListeners;

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

@@ -1 +1 @@
-{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../src/core/player.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,YAAY,EAEZ,WAAW,EACX,cAAc,EACd,YAAY,EAIb,MAAM,SAAS,CAAC;AA8BjB,qBAAa,gBAAiB,YAAW,cAAc;IAqBnD,OAAO,CAAC,OAAO;IApBjB,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;IACnD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,SAAS,CAAqB;IAEtC,OAAO,CAAC,aAAa,CAAuB;IAE5C,OAAO,CAAC,sBAAsB,CAAS;IAGvC,OAAO,CAAC,aAAa,CAAkC;gBAGrD,YAAY,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACvB,MAAM,EAAE,YAAY;IAqDtB,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,cAAc;YAWR,UAAU;YAkCV,sBAAsB;IA6CpC,OAAO,CAAC,gBAAgB;YA0CV,eAAe;YA4Cf,cAAc;YAsDd,YAAY;YAqCZ,YAAY;YAYZ,gBAAgB;IAiC9B,OAAO,CAAC,aAAa;IAoGrB,OAAO,CAAC,wBAAwB;IAuBhC,OAAO,CAAC,WAAW;IASN,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,KAAK,IAAI,IAAI;IAEb,cAAc,IAAI,MAAM;IAExB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAExB,WAAW,IAAI,MAAM;IAErB,SAAS,IAAI,MAAM;IAEnB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,gBAAgB,IAAI,YAAY,EAAE;IAWlC,iBAAiB,IAAI,YAAY,GAAG,IAAI;IAExC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOpC,QAAQ,IAAI,WAAW;IAEvB,OAAO,IAAI,IAAI;CA0BvB"}
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../src/core/player.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,YAAY,EAEZ,WAAW,EACX,cAAc,EACd,YAAY,EAIb,MAAM,SAAS,CAAC;AA8BjB,qBAAa,gBAAiB,YAAW,cAAc;IA+BnD,OAAO,CAAC,OAAO;IA9BjB,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;IACnD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,SAAS,CAAqB;IAEtC,OAAO,CAAC,aAAa,CAAuB;IAE5C,OAAO,CAAC,sBAAsB,CAAS;IAEvC,OAAO,CAAC,iBAAiB,CAA8C;IAEvE,OAAO,CAAC,YAAY,CAAQ;IAE5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,OAAO,CAAC,sBAAsB,CAAK;IAEnC,OAAO,CAAC,mBAAmB,CAA8B;IAGzD,OAAO,CAAC,aAAa,CAAkC;gBAGrD,YAAY,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACvB,MAAM,EAAE,YAAY;IAqDtB,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,cAAc;YAWR,UAAU;YAkCV,sBAAsB;IA6CpC,OAAO,CAAC,gBAAgB;YA0CV,eAAe;YAgDf,cAAc;YAmEd,YAAY;IAqD1B,OAAO,CAAC,oBAAoB;YAed,YAAY;IAmB1B,OAAO,CAAC,sBAAsB;YAKhB,gBAAgB;IAiC9B,OAAO,CAAC,aAAa;IA6IrB,OAAO,CAAC,wBAAwB;IAuBhC,OAAO,CAAC,WAAW;IASN,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,KAAK,IAAI,IAAI;IAEb,cAAc,IAAI,MAAM;IAExB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAExB,WAAW,IAAI,MAAM;IAErB,SAAS,IAAI,MAAM;IAEnB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,gBAAgB,IAAI,YAAY,EAAE;IAWlC,iBAAiB,IAAI,YAAY,GAAG,IAAI;IAExC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOpC,QAAQ,IAAI,WAAW;IAEvB,OAAO,IAAI,IAAI;CAgCvB"}

package/dist/index.esm.js

@@ -68,8 +68,19 @@ class WatchChunkAccumulator {
     }
 }
 
+const VALID_EVENT_TYPES = [
+    'watch_chunk',
+    'play',
+    'pause',
+    'seek',
+    'ended',
+    'quality_change',
+    'error',
+    'security_event',
+];
 const MAX_BATCH_SIZE = 25;
 const DEFAULT_FLUSH_INTERVAL = 5000;
+const MAX_FLUSH_BACKOFF = 60000;
 class EventTracker {
     constructor(config) {
         this.buffer = [];
@@ -77,6 +88,8 @@ class EventTracker {
         this.accumulator = new WatchChunkAccumulator();
         this.destroyed = false;
         this._onBeforeUnload = null;
+        this.flushBackoff = 0;
+        this.flushing = false;
         this.config = {
             endpoint: config.endpoint,
             tokenId: config.tokenId,
@@ -92,6 +105,12 @@ class EventTracker {
     track(type, positionSeconds, payload) {
         if (this.destroyed)
             return;
+        if (!VALID_EVENT_TYPES.includes(type)) {
+            if (this.config.debug) {
+                console.warn('[GuardVideo EventTracker] Skipping unknown event type:', type);
+            }
+            return;
+        }
         this.buffer.push({
             event_type: type,
             event_at: new Date().toISOString(),
@@ -115,7 +134,7 @@ class EventTracker {
         this.config.sessionId = sessionId;
     }
     async flush() {
-        if (this.destroyed)
+        if (this.destroyed || this.flushing)
             return;
         const chunks = this.accumulator.drain();
         for (const c of chunks) {
@@ -123,8 +142,14 @@ class EventTracker {
         }
         if (this.buffer.length === 0)
             return;
-        const batch = this.buffer.splice(0, MAX_BATCH_SIZE);
-        await this.sendBatch(batch);
+        this.flushing = true;
+        try {
+            const batch = this.buffer.splice(0, MAX_BATCH_SIZE);
+            await this.sendBatch(batch);
+        }
+        finally {
+            this.flushing = false;
+        }
     }
     destroy() {
         this.destroyed = true;
@@ -139,6 +164,11 @@ class EventTracker {
     startAutoFlush() {
         this.flushTimer = setInterval(() => this.flush(), this.config.flushIntervalMs);
     }
+    restartAutoFlush(intervalMs) {
+        if (this.flushTimer)
+            clearInterval(this.flushTimer);
+        this.flushTimer = setInterval(() => this.flush(), intervalMs);
+    }
     hookPageUnload() {
         if (typeof window === 'undefined')
             return;
@@ -184,8 +214,25 @@ class EventTracker {
                 body,
                 credentials: 'omit',
             });
-            if (!resp.ok && this.config.debug) {
-                console.warn('[GuardVideo EventTracker] Flush failed:', resp.status);
+            if (!resp.ok) {
+                if (resp.status === 429) {
+                    this.flushBackoff = Math.min((this.flushBackoff || this.config.flushIntervalMs) * 2, MAX_FLUSH_BACKOFF);
+                    if (this.config.debug) {
+                        console.warn('[GuardVideo EventTracker] 429 — backing off to', this.flushBackoff, 'ms');
+                    }
+                    this.buffer.unshift(...events);
+                    this.restartAutoFlush(this.flushBackoff);
+                    return;
+                }
+                if (this.config.debug) {
+                    console.warn('[GuardVideo EventTracker] Flush failed:', resp.status);
+                }
+            }
+            else {
+                if (this.flushBackoff > 0) {
+                    this.flushBackoff = 0;
+                    this.restartAutoFlush(this.config.flushIntervalMs);
+                }
             }
         }
         catch (err) {
@@ -401,6 +448,11 @@ class GuardVideoPlayer {
         this._onSecurityEvent = null;
         this.playlistNonce = null;
         this.nonceRefreshInProgress = false;
+        this.nonceRefreshTimer = null;
+        this.retryBackoff = 1000;
+        this.MAX_BACKOFF = 30000;
+        this.rateLimitCooldownUntil = 0;
+        this.nonceRefreshPromise = null;
         this._onRateChange = this.enforceMaxRate.bind(this);
         this.videoElement = videoElement;
         this.config = {
@@ -611,27 +663,34 @@ class GuardVideoPlayer {
     async solveChallenge(tokenId) {
         if (!this.config.apiBaseUrl)
             return undefined;
+        if (Date.now() < this.rateLimitCooldownUntil) {
+            this.log('Challenge skipped — rate limit cooldown active');
+            return undefined;
+        }
         try {
             const url = this.config.apiBaseUrl + '/videos/challenge/' + encodeURIComponent(tokenId);
             const resp = await fetch(url, { credentials: 'omit' });
+            if (resp.status === 429) {
+                this.enterRateLimitCooldown();
+                this.log('Challenge hit 429 — entering cooldown');
+                return undefined;
+            }
             if (!resp.ok) {
                 this.log('Challenge fetch failed (challenge may be disabled)', resp.status);
                 return undefined;
             }
             const challenge = await resp.json();
-            this.log('Challenge received, computing PBKDF2 response...');
+            this.log('Challenge received, computing PBKDF2 proof-of-work...');
             const encoder = new TextEncoder();
             const keyMaterial = await crypto.subtle.importKey('raw', encoder.encode(challenge.nonce), 'PBKDF2', false, ['deriveBits']);
-            const derivedBits = await crypto.subtle.deriveBits({
+            await crypto.subtle.deriveBits({
                 name: 'PBKDF2',
                 salt: encoder.encode(challenge.salt),
                 iterations: challenge.iterations,
                 hash: 'SHA-256',
             }, keyMaterial, challenge.keyLength * 8);
-            const hashArray = Array.from(new Uint8Array(derivedBits));
-            const hexResponse = hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
-            this.log('Challenge response computed');
-            return hexResponse;
+            this.log('Challenge proof-of-work completed');
+            return { nonce: challenge.nonce };
         }
         catch (err) {
             this.log('Challenge computation failed (non-fatal):', err);
@@ -641,12 +700,16 @@ class GuardVideoPlayer {
     async acquireNonce(tokenId) {
         if (!this.config.apiBaseUrl)
             return null;
+        if (Date.now() < this.rateLimitCooldownUntil) {
+            this.log('Nonce acquisition skipped — rate limit cooldown active');
+            return this.playlistNonce;
+        }
         try {
-            const challengeResponse = await this.solveChallenge(tokenId);
+            const challengeResult = await this.solveChallenge(tokenId);
             const url = this.config.apiBaseUrl + '/videos/playlist-session';
             const body = { tokenId };
-            if (challengeResponse) {
-                body.challengeResponse = challengeResponse;
+            if (challengeResult) {
+                body.challengeNonce = challengeResult.nonce;
             }
             const resp = await fetch(url, {
                 method: 'POST',
@@ -654,12 +717,19 @@ class GuardVideoPlayer {
                 body: JSON.stringify(body),
                 credentials: 'omit',
             });
+            if (resp.status === 429) {
+                this.enterRateLimitCooldown();
+                this.log('Nonce acquisition hit 429 — entering cooldown');
+                return this.playlistNonce;
+            }
             if (!resp.ok) {
                 this.log('Playlist session nonce acquisition failed', resp.status);
                 return null;
             }
             const data = await resp.json();
             this.log('Playlist nonce acquired, expires in ' + data.expiresIn + 's');
+            this.retryBackoff = 1000;
+            this.scheduleNonceRefresh(data.expiresIn);
             return data.nonce;
         }
         catch (err) {
@@ -667,19 +737,38 @@ class GuardVideoPlayer {
             return null;
         }
     }
+    scheduleNonceRefresh(expiresInSeconds) {
+        if (this.nonceRefreshTimer)
+            clearTimeout(this.nonceRefreshTimer);
+        const refreshMs = Math.max(5000, expiresInSeconds * 750);
+        this.nonceRefreshTimer = setTimeout(() => {
+            this.refreshNonce().catch(() => {
+                this.log('Proactive nonce refresh failed');
+            });
+        }, refreshMs);
+    }
     async refreshNonce() {
-        if (this.nonceRefreshInProgress)
-            return;
+        if (this.nonceRefreshInProgress && this.nonceRefreshPromise) {
+            return this.nonceRefreshPromise;
+        }
         if (!this.embedToken)
             return;
         this.nonceRefreshInProgress = true;
-        try {
-            const nonce = await this.acquireNonce(this.embedToken.tokenId);
-            this.playlistNonce = nonce;
-        }
-        finally {
-            this.nonceRefreshInProgress = false;
-        }
+        this.nonceRefreshPromise = (async () => {
+            try {
+                const nonce = await this.acquireNonce(this.embedToken.tokenId);
+                this.playlistNonce = nonce;
+            }
+            finally {
+                this.nonceRefreshInProgress = false;
+                this.nonceRefreshPromise = null;
+            }
+        })();
+        return this.nonceRefreshPromise;
+    }
+    enterRateLimitCooldown() {
+        this.rateLimitCooldownUntil = Date.now() + this.retryBackoff;
+        this.retryBackoff = Math.min(this.retryBackoff * 2, this.MAX_BACKOFF);
     }
     async initializePlayer() {
         if (!this.embedToken) {
@@ -719,8 +808,12 @@ class GuardVideoPlayer {
             enableWorker: true,
             lowLatencyMode: false,
             liveSyncDurationCount: 3,
-            manifestLoadingMaxRetry: 6,
-            levelLoadingMaxRetry: 6,
+            manifestLoadingMaxRetry: 3,
+            manifestLoadingRetryDelay: 2000,
+            levelLoadingMaxRetry: 3,
+            levelLoadingRetryDelay: 2000,
+            fragLoadingMaxRetry: 4,
+            fragLoadingRetryDelay: 1000,
             xhrSetup(xhr, url) {
                 if (url.includes('/watermark-stream/') && url.includes('.m3u8')) {
                     if (self.playlistNonce) {
@@ -728,10 +821,6 @@ class GuardVideoPlayer {
                         const nonceUrl = url + separator + 'nonce=' + encodeURIComponent(self.playlistNonce);
                         xhr.open('GET', nonceUrl, true);
                         self.log('Injected nonce into playlist request');
-                        self.playlistNonce = null;
-                        self.refreshNonce().catch(() => {
-                            self.log('Background nonce refresh failed');
-                        });
                     }
                 }
             },
@@ -743,6 +832,7 @@ class GuardVideoPlayer {
             this.log('HLS manifest parsed', { levels: data.levels.map((l) => l.height + 'p') });
             this.setState(PlayerState.READY);
             this.config.onReady();
+            this.retryBackoff = 1000;
             if (this.config.autoplay)
                 this.play();
         });
@@ -758,18 +848,52 @@ class GuardVideoPlayer {
             this.currentQuality = quality;
             this.log('Quality switched to ' + quality.name);
             this.config.onQualityChange(quality.name);
+            this.eventTracker?.track('quality_change', this.videoElement.currentTime, {
+                level: data.level,
+                height: level.height,
+                bitrate: level.bitrate,
+            });
         });
         this.hls.on(Hls.Events.ERROR, (_event, data) => {
             this.error('HLS Error', data);
+            this.eventTracker?.track('error', this.videoElement.currentTime, {
+                type: data.type,
+                details: data.details,
+                fatal: data.fatal,
+            });
+            if (Date.now() < this.rateLimitCooldownUntil) {
+                this.log('Suppressing retry — rate limit cooldown active (' +
+                    Math.ceil((this.rateLimitCooldownUntil - Date.now()) / 1000) + 's remaining)');
+                if (data.fatal) {
+                    const delay = this.rateLimitCooldownUntil - Date.now() + 500;
+                    setTimeout(() => this.hls?.startLoad(), delay);
+                }
+                return;
+            }
+            const httpStatus = data.response?.code;
+            if (httpStatus === 429) {
+                this.enterRateLimitCooldown();
+                this.log('429 detected — entering cooldown for ' + this.retryBackoff + 'ms');
+                setTimeout(() => {
+                    if (this.embedToken?.forensicWatermark) {
+                        this.refreshNonce().then(() => this.hls?.startLoad()).catch(() => this.hls?.startLoad());
+                    }
+                    else {
+                        this.hls?.startLoad();
+                    }
+                }, this.retryBackoff);
+                return;
+            }
             if (data.type === Hls.ErrorTypes.NETWORK_ERROR &&
                 data.details === Hls.ErrorDetails.LEVEL_LOAD_ERROR &&
                 this.embedToken?.forensicWatermark) {
                 this.log('Playlist load failed — refreshing nonce before retry');
                 this.refreshNonce().then(() => {
-                    setTimeout(() => this.hls?.startLoad(), 500);
+                    setTimeout(() => this.hls?.startLoad(), this.retryBackoff);
                 }).catch(() => {
-                    setTimeout(() => this.hls?.startLoad(), 1000);
+                    setTimeout(() => this.hls?.startLoad(), this.retryBackoff);
                 });
+                this.retryBackoff = Math.min(this.retryBackoff * 1.5, this.MAX_BACKOFF);
                 return;
             }
             if (data.fatal) {
@@ -779,7 +903,8 @@ class GuardVideoPlayer {
                         if (this.embedToken?.forensicWatermark) {
                             this.refreshNonce().catch(() => { });
                         }
-                        setTimeout(() => this.hls?.startLoad(), 1000);
+                        setTimeout(() => this.hls?.startLoad(), this.retryBackoff);
+                        this.retryBackoff = Math.min(this.retryBackoff * 1.5, this.MAX_BACKOFF);
                         break;
                     case Hls.ErrorTypes.MEDIA_ERROR:
                         this.error('Media error, attempting recovery...');
@@ -857,6 +982,10 @@ class GuardVideoPlayer {
     getState() { return this.state; }
     destroy() {
         this.log('Destroying player');
+        if (this.nonceRefreshTimer) {
+            clearTimeout(this.nonceRefreshTimer);
+            this.nonceRefreshTimer = null;
+        }
         if (this.eventTracker) {
             this.eventTracker.destroy();
             this.eventTracker = null;