@gcorevideo/player 2.30.0 → 2.30.1

package/dist/index.embed.js

@@ -49867,6 +49867,48 @@ Hls.defaultConfig = void 0;
 // export const CLAPPR_VERSION: string = process.env.CLAPPR_VERSION || '0.11.3';
 const CLAPPR_VERSION$1 = '0.13.0';
 
+class RangesList {
+    // TODO write an efficient implementation
+    items = [];
+    insert(start, end, value) {
+        const index = this.findIndex((start + end) / 2);
+        this.items.splice(index, 0, [start, end, value]);
+    }
+    find(position) {
+        const index = this.findIndex(position);
+        const item = this.items[index];
+        if (!item || item[0] > position || item[1] < position) {
+            return null;
+        }
+        return item[2];
+    }
+    findIndex(position) {
+        let low = 0;
+        let high = this.items.length;
+        let index = 0;
+        while (low < high) {
+            index = low + Math.floor((high - low) / 2);
+            const item = this.items[index];
+            if (item[0] > position) {
+                if (index === low) {
+                    return index;
+                }
+                high = index;
+                continue;
+            }
+            if (item[1] <= position) {
+                if (index === high - 1) {
+                    return index + 1;
+                }
+                low = index + 1;
+                continue;
+            }
+            break;
+        }
+        return index;
+    }
+}
+
 // Copyright 2014 Globo.com Player authors. All rights reserved.
 // Use of this source code is governed by a BSD-style
 // license that can be found on https://github.com/clappr/hlsjs-playback/blob/main/LICENSE
@@ -49876,7 +49918,6 @@ const DEFAULT_RECOVER_ATTEMPTS = 16;
 Events$1.register('PLAYBACK_FRAGMENT_PARSING_METADATA');
 const T$7 = 'playback.hls';
 class HlsPlayback extends BasePlayback {
-    _ccTracksUpdated = false;
     _currentFragment = null;
     _currentLevel = null;
     _durationExcludesAfterLiveSyncPoint = false;
@@ -49901,7 +49942,8 @@ class HlsPlayback extends BasePlayback {
     _timeUpdateTimer = null;
     oncueenter = null;
     oncueexit = null;
-    cues = []; // TODO check the list size and use BST if needed
+    cues = null;
+    cuesByTrack = {};
     currentCueId = null;
     /**
      * @internal
@@ -50098,7 +50140,6 @@ class HlsPlayback extends BasePlayback {
         }
         this._manifestParsed = false;
         // this._ccIsSetup = false
-        this._ccTracksUpdated = false;
         this._setInitialState();
         this._hls.destroy();
         this._hls = null;
@@ -50152,12 +50193,20 @@ class HlsPlayback extends BasePlayback {
         this._hls.on(Events.AUDIO_TRACK_SWITCHED, (evt, data) => this._onAudioTrackSwitched(evt, data));
         this._hls.on(Events.CUES_PARSED, (evt, data) => {
             data.cues?.forEach((cue) => {
-                this.cues.push({
+                if (!this.cues) {
+                    const trackId = this._hls.subtitleTrack;
+                    if (!this.cuesByTrack[trackId]) {
+                        this.cuesByTrack[trackId] = new RangesList();
+                    }
+                    this.cues = this.cuesByTrack[trackId];
+                }
+                const cueInfo = {
                     id: cue.id,
                     start: cue.startTime,
                     end: cue.endTime,
                     text: cue.text,
-                });
+                };
+                this.cues.insert(cue.startTime, cue.endTime, cueInfo);
             });
         });
         this.bindCustomListeners();
@@ -50384,7 +50433,7 @@ class HlsPlayback extends BasePlayback {
         }
     }
     reload() {
-        this.cues = [];
+        this.cues = null;
         this.currentCueId = null;
         this._hls?.startLoad(-1);
     }
@@ -50449,9 +50498,7 @@ class HlsPlayback extends BasePlayback {
     }
     triggerCues() {
         const currentTime = this.getCurrentTime();
-        // const cues = Object.values(this.cues)
-        // TODO build a search tree
-        const cue = this.cues.find((cue) => currentTime >= cue.start && currentTime <= cue.end);
+        const cue = this.cues?.find(currentTime);
         if (cue) {
             this.currentCueId = cue.id;
             this.oncueenter?.(cue);
@@ -50494,20 +50541,14 @@ class HlsPlayback extends BasePlayback {
     destroy() {
         this._stopTimeUpdateTimer();
         this._destroyHLSInstance();
+        this.cues = null;
+        this.cuesByTrack = {};
         return super.destroy();
     }
     _updatePlaybackType(evt, data) {
         const prevPlaybackType = this._playbackType;
         this._playbackType = (data.details.live ? Playback.LIVE : Playback.VOD);
         this._onLevelUpdated(evt, data);
-        // Live stream subtitle tracks detection hack (may not immediately available)
-        // if (
-        //   this._ccTracksUpdated &&
-        //   this._playbackType === Playback.LIVE &&
-        //   this.hasClosedCaptionsTracks
-        // ) {
-        //   this._onSubtitleLoaded()
-        // }
         if (prevPlaybackType !== this._playbackType) {
             this._updateSettings();
         }
@@ -50727,7 +50768,10 @@ class HlsPlayback extends BasePlayback {
             return;
         }
         this._hls.subtitleTrack = id;
-        this.cues = [];
+        if (!this.cuesByTrack[id]) {
+            this.cuesByTrack[id] = new RangesList();
+        }
+        this.cues = this.cuesByTrack[id];
     }
     /**
      * @override
@@ -50736,7 +50780,7 @@ class HlsPlayback extends BasePlayback {
         return this.getTextTracks();
     }
     getTextTracks() {
-        return this._hls?.subtitleTracks.map((t) => ({
+        return (this._hls?.subtitleTracks.map((t) => ({
             id: t.id,
             name: t.name,
             track: {
@@ -50744,7 +50788,7 @@ class HlsPlayback extends BasePlayback {
                 label: t.name,
                 language: t.lang,
             },
-        })) || [];
+        })) || []);
     }
 }
 HlsPlayback.canPlay = function (resource, mimeType) {
@@ -58849,8 +58893,6 @@ class ClosedCaptions extends UICorePlugin {
         // event.target does not exist for some reason in tests
         const id = Number((event.target ?? event.currentTarget).dataset?.item ??
             '-1');
-        // TODO review, make configurable, and emit event in addition
-        // localStorage.setItem(LOCAL_STORAGE_CC_ID, id) // TODO store language instead?
         this.userSelectedItemId = id;
         this.selectItem(this.findById(id));
         this.hideMenu();

package/dist/index.js

@@ -50092,6 +50092,48 @@ Hls.defaultConfig = void 0;
 // export const CLAPPR_VERSION: string = process.env.CLAPPR_VERSION || '0.11.3';
 const CLAPPR_VERSION$1 = '0.13.0';
 
+class RangesList {
+    // TODO write an efficient implementation
+    items = [];
+    insert(start, end, value) {
+        const index = this.findIndex((start + end) / 2);
+        this.items.splice(index, 0, [start, end, value]);
+    }
+    find(position) {
+        const index = this.findIndex(position);
+        const item = this.items[index];
+        if (!item || item[0] > position || item[1] < position) {
+            return null;
+        }
+        return item[2];
+    }
+    findIndex(position) {
+        let low = 0;
+        let high = this.items.length;
+        let index = 0;
+        while (low < high) {
+            index = low + Math.floor((high - low) / 2);
+            const item = this.items[index];
+            if (item[0] > position) {
+                if (index === low) {
+                    return index;
+                }
+                high = index;
+                continue;
+            }
+            if (item[1] <= position) {
+                if (index === high - 1) {
+                    return index + 1;
+                }
+                low = index + 1;
+                continue;
+            }
+            break;
+        }
+        return index;
+    }
+}
+
 // Copyright 2014 Globo.com Player authors. All rights reserved.
 // Use of this source code is governed by a BSD-style
 // license that can be found on https://github.com/clappr/hlsjs-playback/blob/main/LICENSE
@@ -50101,7 +50143,6 @@ const DEFAULT_RECOVER_ATTEMPTS = 16;
 Events$1.register('PLAYBACK_FRAGMENT_PARSING_METADATA');
 const T$e = 'playback.hls';
 class HlsPlayback extends BasePlayback {
-    _ccTracksUpdated = false;
     _currentFragment = null;
     _currentLevel = null;
     _durationExcludesAfterLiveSyncPoint = false;
@@ -50126,7 +50167,8 @@ class HlsPlayback extends BasePlayback {
     _timeUpdateTimer = null;
     oncueenter = null;
     oncueexit = null;
-    cues = []; // TODO check the list size and use BST if needed
+    cues = null;
+    cuesByTrack = {};
     currentCueId = null;
     /**
      * @internal
@@ -50323,7 +50365,6 @@ class HlsPlayback extends BasePlayback {
         }
         this._manifestParsed = false;
         // this._ccIsSetup = false
-        this._ccTracksUpdated = false;
         this._setInitialState();
         this._hls.destroy();
         this._hls = null;
@@ -50377,12 +50418,20 @@ class HlsPlayback extends BasePlayback {
         this._hls.on(Events.AUDIO_TRACK_SWITCHED, (evt, data) => this._onAudioTrackSwitched(evt, data));
         this._hls.on(Events.CUES_PARSED, (evt, data) => {
             data.cues?.forEach((cue) => {
-                this.cues.push({
+                if (!this.cues) {
+                    const trackId = this._hls.subtitleTrack;
+                    if (!this.cuesByTrack[trackId]) {
+                        this.cuesByTrack[trackId] = new RangesList();
+                    }
+                    this.cues = this.cuesByTrack[trackId];
+                }
+                const cueInfo = {
                     id: cue.id,
                     start: cue.startTime,
                     end: cue.endTime,
                     text: cue.text,
-                });
+                };
+                this.cues.insert(cue.startTime, cue.endTime, cueInfo);
             });
         });
         this.bindCustomListeners();
@@ -50609,7 +50658,7 @@ class HlsPlayback extends BasePlayback {
         }
     }
     reload() {
-        this.cues = [];
+        this.cues = null;
         this.currentCueId = null;
         this._hls?.startLoad(-1);
     }
@@ -50674,9 +50723,7 @@ class HlsPlayback extends BasePlayback {
     }
     triggerCues() {
         const currentTime = this.getCurrentTime();
-        // const cues = Object.values(this.cues)
-        // TODO build a search tree
-        const cue = this.cues.find((cue) => currentTime >= cue.start && currentTime <= cue.end);
+        const cue = this.cues?.find(currentTime);
         if (cue) {
             this.currentCueId = cue.id;
             this.oncueenter?.(cue);
@@ -50719,20 +50766,14 @@ class HlsPlayback extends BasePlayback {
     destroy() {
         this._stopTimeUpdateTimer();
         this._destroyHLSInstance();
+        this.cues = null;
+        this.cuesByTrack = {};
         return super.destroy();
     }
     _updatePlaybackType(evt, data) {
         const prevPlaybackType = this._playbackType;
         this._playbackType = (data.details.live ? Playback.LIVE : Playback.VOD);
         this._onLevelUpdated(evt, data);
-        // Live stream subtitle tracks detection hack (may not immediately available)
-        // if (
-        //   this._ccTracksUpdated &&
-        //   this._playbackType === Playback.LIVE &&
-        //   this.hasClosedCaptionsTracks
-        // ) {
-        //   this._onSubtitleLoaded()
-        // }
         if (prevPlaybackType !== this._playbackType) {
             this._updateSettings();
         }
@@ -50953,7 +50994,10 @@ class HlsPlayback extends BasePlayback {
             return;
         }
         this._hls.subtitleTrack = id;
-        this.cues = [];
+        if (!this.cuesByTrack[id]) {
+            this.cuesByTrack[id] = new RangesList();
+        }
+        this.cues = this.cuesByTrack[id];
     }
     /**
      * @override
@@ -50962,7 +51006,7 @@ class HlsPlayback extends BasePlayback {
         return this.getTextTracks();
     }
     getTextTracks() {
-        return this._hls?.subtitleTracks.map((t) => ({
+        return (this._hls?.subtitleTracks.map((t) => ({
             id: t.id,
             name: t.name,
             track: {
@@ -50970,7 +51014,7 @@ class HlsPlayback extends BasePlayback {
                 label: t.name,
                 language: t.lang,
             },
-        })) || [];
+        })) || []);
     }
 }
 HlsPlayback.canPlay = function (resource, mimeType) {
@@ -51584,7 +51628,7 @@ class Player {
     }
 }
 
-var version$1 = "2.30.0";
+var version$1 = "2.30.1";
 
 var packages = {
 	"node_modules/@clappr/core": {
@@ -60258,8 +60302,6 @@ class ClosedCaptions extends UICorePlugin {
         // event.target does not exist for some reason in tests
         const id = Number((event.target ?? event.currentTarget).dataset?.item ??
             '-1');
-        // TODO review, make configurable, and emit event in addition
-        // localStorage.setItem(LOCAL_STORAGE_CC_ID, id) // TODO store language instead?
         this.userSelectedItemId = id;
         this.selectItem(this.findById(id));
         this.hideMenu();

package/docs/api/player.md

@@ -361,6 +361,21 @@ A `PLUGIN` that configures [CMCD](https://cdn.cta.tech/cta/media/media/resources
 `PLUGIN` that displays the thumbnails of the video when available.
 
 
+</td></tr>
+<tr><td>
+
+[TokenRefreshPlugin](./player.tokenrefreshplugin.md)
+
+
+</td><td>
+
+`PLUGIN` — automatic token refresh for Gcore protected-content streams.
+
+Supports all three playback engines:
+
+\| Engine \| Mechanism \| Interruption \| \|\-\-\-\-\-\---\|\-\-\-\-\-\-\-\-\---\|\-\-\-\-\-\-\-\-\-\-\-\---\| \| \*\*hls.js\*\* \| Custom loader rewrites every request URL \| None \| \| \*\*dash.js\*\* \| `addRequestInterceptor` rewrites every request URL \| None \| \| \*\*Native `<video>`<!-- -->\*\* (Safari ≤ iOS 14.4) \| Source reload + seek restore \| Brief \|
+
+
 </td></tr>
 <tr><td>
 
@@ -721,6 +736,28 @@ Plugin configuration options for the thumbnails plugin.
 Current playback time and total duration of the media.
 
 
+</td></tr>
+<tr><td>
+
+[TokenRefreshOptions](./player.tokenrefreshoptions.md)
+
+
+</td><td>
+
+Configuration options for [TokenRefreshPlugin](./player.tokenrefreshplugin.md)<!-- -->.
+
+
+</td></tr>
+<tr><td>
+
+[TokenResponse](./player.tokenresponse.md)
+
+
+</td><td>
+
+Response shape expected from your token-refresh API endpoint.
+
+
 </td></tr>
 <tr><td>
 

package/docs/api/player.player.getplugin.md

@@ -0,0 +1,59 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Player](./player.player.md) &gt; [getPlugin](./player.player.getplugin.md)
+
+## Player.getPlugin() method
+
+Returns a registered core plugin instance by name, or `null` if not found.
+
+**Signature:**
+
+```typescript
+getPlugin(name: string): any;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+name
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+any
+
+## Example
+
+
+```ts
+const tokenRefresh = player.getPlugin('token_refresh') as TokenRefreshPlugin | null
+```
+

package/docs/api/player.player.md

@@ -137,6 +137,20 @@ Current playback (time since the beginning of the stream), if appropriate.
 Duration of the current media in seconds, if appropriate.
 
 
+</td></tr>
+<tr><td>
+
+[getPlugin(name)](./player.player.getplugin.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Returns a registered core plugin instance by name, or `null` if not found.
+
+
 </td></tr>
 <tr><td>
 

package/docs/api/player.tokenrefreshoptions.gettoken.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [TokenRefreshOptions](./player.tokenrefreshoptions.md) &gt; [getToken](./player.tokenrefreshoptions.gettoken.md)
+
+## TokenRefreshOptions.getToken property
+
+Async function called each time a fresh token is needed. Must return a [TokenResponse](./player.tokenresponse.md)<!-- -->.
+
+**Signature:**
+
+```typescript
+getToken: () => Promise<TokenResponse>;
+```

package/docs/api/player.tokenrefreshoptions.ipbound.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [TokenRefreshOptions](./player.tokenrefreshoptions.md) &gt; [ipBound](./player.tokenrefreshoptions.ipbound.md)
+
+## TokenRefreshOptions.ipBound property
+
+When `true`<!-- -->, the IP-bound variant (`token_ip` / `url_ip`<!-- -->) is used. Defaults to `false`<!-- -->.
+
+**Signature:**
+
+```typescript
+ipBound?: boolean;
+```

package/docs/api/player.tokenrefreshoptions.md

@@ -0,0 +1,115 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [TokenRefreshOptions](./player.tokenrefreshoptions.md)
+
+## TokenRefreshOptions interface
+
+Configuration options for [TokenRefreshPlugin](./player.tokenrefreshplugin.md)<!-- -->.
+
+**Signature:**
+
+```typescript
+export interface TokenRefreshOptions 
+```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[getToken](./player.tokenrefreshoptions.gettoken.md)
+
+
+</td><td>
+
+
+</td><td>
+
+() =&gt; Promise&lt;[TokenResponse](./player.tokenresponse.md)<!-- -->&gt;
+
+
+</td><td>
+
+Async function called each time a fresh token is needed. Must return a [TokenResponse](./player.tokenresponse.md)<!-- -->.
+
+
+</td></tr>
+<tr><td>
+
+[ipBound?](./player.tokenrefreshoptions.ipbound.md)
+
+
+</td><td>
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+_(Optional)_ When `true`<!-- -->, the IP-bound variant (`token_ip` / `url_ip`<!-- -->) is used. Defaults to `false`<!-- -->.
+
+
+</td></tr>
+<tr><td>
+
+[onTokenRefreshed?](./player.tokenrefreshoptions.ontokenrefreshed.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(data: [TokenResponse](./player.tokenresponse.md)<!-- -->) =&gt; void
+
+
+</td><td>
+
+_(Optional)_ Optional callback invoked after every successful token refresh.
+
+
+</td></tr>
+<tr><td>
+
+[refreshLeadSeconds?](./player.tokenrefreshoptions.refreshleadseconds.md)
+
+
+</td><td>
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+_(Optional)_ Seconds before the token expiry timestamp to request a fresh token. Defaults to `5`<!-- -->.
+
+
+</td></tr>
+</tbody></table>
+

package/docs/api/player.tokenrefreshoptions.ontokenrefreshed.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [TokenRefreshOptions](./player.tokenrefreshoptions.md) &gt; [onTokenRefreshed](./player.tokenrefreshoptions.ontokenrefreshed.md)
+
+## TokenRefreshOptions.onTokenRefreshed property
+
+Optional callback invoked after every successful token refresh.
+
+**Signature:**
+
+```typescript
+onTokenRefreshed?: (data: TokenResponse) => void;
+```

package/docs/api/player.tokenrefreshoptions.refreshleadseconds.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [TokenRefreshOptions](./player.tokenrefreshoptions.md) &gt; [refreshLeadSeconds](./player.tokenrefreshoptions.refreshleadseconds.md)
+
+## TokenRefreshOptions.refreshLeadSeconds property
+
+Seconds before the token expiry timestamp to request a fresh token. Defaults to `5`<!-- -->.
+
+**Signature:**
+
+```typescript
+refreshLeadSeconds?: number;
+```