@gcorevideo/player 2.29.0 → 2.30.1

package/dist/index.js

@@ -12922,7 +12922,7 @@ var PlaybackEvents;
 // https://github.com/clappr/clappr/blob/8752995ea439321ac7ca3cd35e8c64de7a3c3d17/LICENSE
 const AUTO$1 = -1;
 const { now: now$2 } = Utils;
-const T$e = 'playback.dash';
+const T$f = 'playback.dash';
 class DashPlayback extends BasePlayback {
     _levels = [];
     _currentLevel = AUTO$1;
@@ -13055,6 +13055,7 @@ class DashPlayback extends BasePlayback {
         this._dash = dash;
         this._dash.initialize();
         if (this.options.dash) {
+            const { requestInterceptor, ...dashSettings } = this.options.dash;
             const settings = $.extend(true, {
                 streaming: {
                     text: {
@@ -13066,8 +13067,11 @@ class DashPlayback extends BasePlayback {
                         // dispatchForManualRendering: true, // TODO only when useNativeSubtitles is not true?
                     },
                 },
-            }, this.options.dash);
+            }, dashSettings);
             this._dash.updateSettings(settings);
+            if (typeof requestInterceptor === 'function') {
+                this._dash.addRequestInterceptor(requestInterceptor);
+            }
         }
         this._dash.attachView(this.el);
         this._dash.setAutoPlay(false);
@@ -13195,7 +13199,7 @@ class DashPlayback extends BasePlayback {
         this.trigger(Events$1.PLAYBACK_SETTINGSUPDATE);
     }
     _onPlaybackError = (event) => {
-        trace(`${T$e} _onPlaybackError`, { type: event.type, code: event.error.code, message: event.error.message });
+        trace(`${T$f} _onPlaybackError`, { type: event.type, code: event.error.code, message: event.error.message });
     };
     _onDASHJSSError = (event) => {
         this._stopTimeUpdateTimer();
@@ -50088,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
@@ -50095,9 +50141,8 @@ const { now } = Utils;
 const AUTO = -1;
 const DEFAULT_RECOVER_ATTEMPTS = 16;
 Events$1.register('PLAYBACK_FRAGMENT_PARSING_METADATA');
-const T$d = 'playback.hls';
+const T$e = 'playback.hls';
 class HlsPlayback extends BasePlayback {
-    _ccTracksUpdated = false;
     _currentFragment = null;
     _currentLevel = null;
     _durationExcludesAfterLiveSyncPoint = false;
@@ -50122,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
@@ -50319,7 +50365,6 @@ class HlsPlayback extends BasePlayback {
         }
         this._manifestParsed = false;
         // this._ccIsSetup = false
-        this._ccTracksUpdated = false;
         this._setInitialState();
         this._hls.destroy();
         this._hls = null;
@@ -50373,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();
@@ -50420,7 +50473,7 @@ class HlsPlayback extends BasePlayback {
         }
         else {
             Log.error('hlsjs: failed to recover', { evt, data });
-            trace(`${T$d} _recover failed to recover`, {
+            trace(`${T$e} _recover failed to recover`, {
                 type: data.type,
                 details: data.details,
             });
@@ -50507,7 +50560,7 @@ class HlsPlayback extends BasePlayback {
         this.trigger(Events$1.PLAYBACK_SETTINGSUPDATE);
     }
     _onHLSJSError(evt, data) {
-        trace(`${T$d} _onHLSJSError`, {
+        trace(`${T$e} _onHLSJSError`, {
             fatal: data.fatal,
             type: data.type,
             details: data.details,
@@ -50555,7 +50608,7 @@ class HlsPlayback extends BasePlayback {
                                     evt,
                                     data,
                                 });
-                                trace(`${T$d} _onHLSJSError trying to recover from network error`, {
+                                trace(`${T$e} _onHLSJSError trying to recover from network error`, {
                                     details: data.details,
                                 });
                                 error.level = PlayerError.Levels.WARN;
@@ -50568,7 +50621,7 @@ class HlsPlayback extends BasePlayback {
                             evt,
                             data,
                         });
-                        trace(`${T$d} _onHLSJSError trying to recover from media error`, {
+                        trace(`${T$e} _onHLSJSError trying to recover from media error`, {
                             details: data.details,
                         });
                         error.level = PlayerError.Levels.WARN;
@@ -50598,14 +50651,14 @@ class HlsPlayback extends BasePlayback {
                 return;
             }
             Log.warn('hlsjs: non-fatal error occurred', { evt, data });
-            trace(`${T$d} _onHLSJSError non-fatal error occurred`, {
+            trace(`${T$e} _onHLSJSError non-fatal error occurred`, {
                 type: data.type,
                 details: data.details,
             });
         }
     }
     reload() {
-        this.cues = [];
+        this.cues = null;
         this.currentCueId = null;
         this._hls?.startLoad(-1);
     }
@@ -50670,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);
@@ -50715,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();
         }
@@ -50939,7 +50984,7 @@ class HlsPlayback extends BasePlayback {
         this.trigger(Events$1.PLAYBACK_AUDIO_AVAILABLE, data.audioTracks.map(toClapprTrack));
     }
     _onAudioTrackSwitched(_, data) {
-        trace(`${T$d} onAudioTrackSwitched`);
+        trace(`${T$e} onAudioTrackSwitched`);
         // @ts-ignore
         const track = this._hls.audioTracks[data.id];
         this.trigger(Events$1.PLAYBACK_AUDIO_CHANGED, toClapprTrack(track));
@@ -50949,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
@@ -50958,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: {
@@ -50966,7 +51014,7 @@ class HlsPlayback extends BasePlayback {
                 label: t.name,
                 language: t.lang,
             },
-        })) || [];
+        })) || []);
     }
 }
 HlsPlayback.canPlay = function (resource, mimeType) {
@@ -50984,7 +51032,7 @@ function toClapprTrack(t) {
     };
 }
 
-const T$c = 'playback.html5_video';
+const T$d = 'playback.html5_video';
 const STALL_TIMEOUT = 15000;
 class HTML5Video extends BasePlayback {
     stallTimerId = null;
@@ -51085,7 +51133,7 @@ class HTML5Video extends BasePlayback {
     switchAudioTrack(id) {
         const tracks = this.el.audioTracks;
         const supported = !!tracks;
-        trace(`${T$c} switchAudioTrack`, {
+        trace(`${T$d} switchAudioTrack`, {
             supported,
         });
         if (supported) {
@@ -51104,7 +51152,7 @@ function registerPlaybacks() {
     Loader.registerPlayback(DashPlayback);
 }
 
-const T$b = 'gplayer';
+const T$c = 'gplayer';
 const DEFAULT_OPTIONS = {
     autoPlay: false,
     debug: 'none',
@@ -51298,6 +51346,17 @@ class Player {
         }
         this.player?.load(ms, ms[0].mimeType ?? '');
     }
+    /**
+     * Returns a registered core plugin instance by name, or `null` if not found.
+     *
+     * @example
+     * ```ts
+     * const tokenRefresh = player.getPlugin('token_refresh') as TokenRefreshPlugin | null
+     * ```
+     */
+    getPlugin(name) {
+        return this.player?.core.getPlugin(name) ?? null;
+    }
     /**
      * Mutes the sound of the video.
      */
@@ -51440,7 +51499,7 @@ class Player {
         }
     }
     triggerAutoPlay() {
-        trace(`${T$b} triggerAutoPlay`);
+        trace(`${T$c} triggerAutoPlay`);
         setTimeout(() => {
             this.player?.play({
                 autoPlay: true,
@@ -51458,7 +51517,7 @@ class Player {
     // TODO test
     events = {
         onReady: () => {
-            trace(`${T$b} onReady`, {
+            trace(`${T$c} onReady`, {
                 ready: this.ready,
             });
             if (this.ready) {
@@ -51492,7 +51551,7 @@ class Player {
     buildCoreOptions(rootNode) {
         const sources = this.buildMediaSourcesList();
         const source = sources[0];
-        trace(`${T$b} buildCoreOptions`, {
+        trace(`${T$c} buildCoreOptions`, {
             source,
             sources,
         });
@@ -51569,7 +51628,7 @@ class Player {
     }
 }
 
-var version$1 = "2.29.0";
+var version$1 = "2.30.1";
 
 var packages = {
 	"node_modules/@clappr/core": {
@@ -52002,7 +52061,7 @@ const INITIAL_SETTINGS = {
     default: [],
     seekEnabled: false,
 };
-const T$a = 'plugins.media_control';
+const T$b = 'plugins.media_control';
 /**
  * Extended events for the {@link MediaControl} plugin
  * @public
@@ -52295,7 +52354,7 @@ class MediaControl extends UICorePlugin {
      * Reenables the plugin disabled earlier with the {@link MediaControl.disable} method
      */
     enable() {
-        trace(`${T$a} enable`, {
+        trace(`${T$b} enable`, {
             chromeless: this.options.chromeless,
             userDisabled: this.userDisabled,
         });
@@ -52452,7 +52511,7 @@ class MediaControl extends UICorePlugin {
         this.$el.removeClass('w370');
         this.$el.removeClass('w270');
         this.verticalVolume = false;
-        trace(`${T$a} playerResize`, {
+        trace(`${T$b} playerResize`, {
             size,
             width: this.container.$el.width(),
             height: this.container.$el.height(),
@@ -53454,7 +53513,7 @@ class AudioTracks extends UICorePlugin {
 
 const templateHtml$2 = "<div class=\"big-mute-icon-wrapper\" data-big-mute id=\"gplayer-big-mute-button\">\n    <div class=\"big-mute-icon gcore-skin-border-color\" data-big-mute-icon id=\"gplayer-big-mute-icon\"></div>\n</div>\n";
 
-const T$9 = 'plugins.big_mute_button';
+const T$a = 'plugins.big_mute_button';
 // TODO rewrite as a container plugin
 /**
  * `PLUGIN` that displays a big mute button over the video when it's being played muted.
@@ -53517,7 +53576,7 @@ class BigMuteButton extends UICorePlugin {
         if (autoPlay) {
             this.autoPlay = true;
         }
-        trace(`${T$9} onPlay`, {
+        trace(`${T$a} onPlay`, {
             autoPlay: this.autoPlay,
             wasMuted,
             volume,
@@ -53531,7 +53590,7 @@ class BigMuteButton extends UICorePlugin {
     }
     onStop(_, metadata) {
         const ui = metadata?.ui;
-        trace(`${T$9} onStop`, { ui });
+        trace(`${T$a} onStop`, { ui });
         if (ui) {
             this.destroy();
         }
@@ -56495,7 +56554,7 @@ const PLAYBACK_NAMES = {
     hls: 'HLS.js',
     html5_video: 'Native',
 };
-const T$8 = 'plugins.nerd_stats';
+const T$9 = 'plugins.nerd_stats';
 /**
  * `PLUGIN` that displays useful statistics regarding the playback as well as the network quality estimation.
  * @public
@@ -56632,7 +56691,7 @@ class NerdStats extends UICorePlugin {
         return super.destroy();
     }
     toggle = () => {
-        trace(`${T$8} toggle`, {
+        trace(`${T$9} toggle`, {
             open: this.open,
         });
         if (this.open) {
@@ -56652,14 +56711,14 @@ class NerdStats extends UICorePlugin {
         })
             .catch((e) => {
             reportError(e);
-            trace(`${T$8} speedtest error`, {
+            trace(`${T$9} speedtest error`, {
                 error: e,
             });
             this.disable();
         });
     }
     hide() {
-        trace(`${T$8} hide`);
+        trace(`${T$9} hide`);
         this.$el.hide();
         this.open = false;
         stopSpeedtest();
@@ -57392,7 +57451,7 @@ const reloadIcon = "<svg fill=\"#FFFFFF\" height=\"24\" viewBox=\"0 0 24 24\" wi
 
 const templateHtml = "<div class=\"player-error-screen__content\" data-error-screen>\n    <% if (icon) { %>\n        <div class=\"player-error-screen__icon\" data-error-screen><%= icon %></div>\n    <% } %>\n    <div class=\"player-error-screen__title\" data-error-screen><%= title %></div>\n    <% if (message) { %>\n        <div class=\"player-error-screen__message\" data-error-screen><%= message %></div>\n    <% } %>\n    <% if (code) { %>\n        <div class=\"player-error-screen__code\" data-error-screen><%= i18n.t('error_code') %>: <%= code %></div>\n    <% } %>\n    <% if (reloadIcon) { %>\n        <div class=\"player-error-screen__reload\" data-error-screen><%= reloadIcon %></div>\n    <% } %>\n</div>\n";
 
-const T$7 = 'plugins.error_screen';
+const T$8 = 'plugins.error_screen';
 /**
  * `PLUGIN` that displays fatal errors nicely in the overlay on top of the player.
  * @public
@@ -57444,11 +57503,11 @@ class ErrorScreen extends UICorePlugin {
         this.listenTo(this.core, Events$1.CORE_ACTIVE_CONTAINER_CHANGED, this.onActiveContainerChanged);
     }
     onPlay() {
-        trace(`${T$7} onPlay`);
+        trace(`${T$8} onPlay`);
         this.unmount();
     }
     unmount() {
-        trace(`${T$7} unmount`);
+        trace(`${T$8} unmount`);
         this.err = null;
         this.$el.remove();
     }
@@ -57461,7 +57520,7 @@ class ErrorScreen extends UICorePlugin {
         };
     }
     reload() {
-        trace(`${T$7} reload`);
+        trace(`${T$8} reload`);
         setTimeout(() => {
             this.core.configure({
                 reloading: true,
@@ -57484,7 +57543,7 @@ class ErrorScreen extends UICorePlugin {
         }
     }
     onError(err) {
-        trace(`${T$7} onError`, { err });
+        trace(`${T$8} onError`, { err });
         if (err.UI) {
             if (this.err) {
                 this.unmount();
@@ -57965,7 +58024,7 @@ const pluginHtml$3 = "<button data-multicamera-button class='gcore-skin-button-c
 const streamsIcon = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"24\" height=\"20\" viewBox=\"0 0 24 20\">\n    <path fill=\"#FFF\" fill-rule=\"nonzero\" d=\"M24 1.5v13a1.5 1.5 0 0 1-1.5 1.5h-1a.5.5 0 0 1-.5-.5v-10A2.5 2.5 0 0 0 18.5 3h-14a.5.5 0 0 1-.5-.5v-1A1.5 1.5 0 0 1 5.5 0h17A1.5 1.5 0 0 1 24 1.5M12.724 12.447l-5 2.5a.505.505 0 0 1-.487-.021A.503.503 0 0 1 7 14.5v-5c0-.173.09-.334.237-.426a.505.505 0 0 1 .487-.021l5 2.5a.5.5 0 0 1 0 .894M18.5 4h-17C.673 4 0 4.673 0 5.5v13c0 .827.673 1.5 1.5 1.5h17c.827 0 1.5-.673 1.5-1.5v-13c0-.827-.673-1.5-1.5-1.5\"/>\n</svg>\n";
 
 const VERSION$4 = '0.0.1';
-const T$6 = 'plugins.multicamera';
+const T$7 = 'plugins.multicamera';
 /**
  * `PLUGIN` that adds support for loading multiple streams and switching between them using the media control UI.
  * @beta
@@ -58092,7 +58151,7 @@ class MultiCamera extends UICorePlugin {
     onCameraSelect(event) {
         const value = event.currentTarget.dataset
             .multicameraSelectorSelect;
-        trace(`${T$6} onCameraSelect`, { value });
+        trace(`${T$7} onCameraSelect`, { value });
         if (value !== undefined) {
             this.changeById(parseInt(value, 10));
         }
@@ -58190,7 +58249,7 @@ class MultiCamera extends UICorePlugin {
         }
     }
     changeById(id) {
-        trace(`${T$6} changeById`, { id });
+        trace(`${T$7} changeById`, { id });
         queueMicrotask(() => {
             const playbackOptions = this.core.options.playback || {};
             // TODO figure out if it's needed
@@ -58212,7 +58271,7 @@ class MultiCamera extends UICorePlugin {
             // TODO remove?
             // for html5 playback:
             this.options.dvrEnabled = this.currentCamera.dvr;
-            trace(`${T$6} changeById`, { currentCamera: this.currentCamera });
+            trace(`${T$7} changeById`, { currentCamera: this.currentCamera });
             // TODO
             this.core.configure({
                 playback: playbackOptions,
@@ -58275,7 +58334,7 @@ const pipIcon = "<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"no
 const buttonHtml$2 = "<button class=\"gplayer-lite-btn gcore-skin-button-color\">\n    <%= pipIcon %>\n</button>\n";
 
 const VERSION$3 = '0.0.1';
-const T$5 = `plugins.pip`;
+const T$6 = `plugins.pip`;
 /**
  * `PLUGIN` that enables picture-in-picture mode.
  * @public
@@ -58333,7 +58392,7 @@ class PictureInPicture extends UICorePlugin {
         });
     }
     isPiPSupported() {
-        trace(`${T$5} isPiPSupported`, {
+        trace(`${T$6} isPiPSupported`, {
             pictureInPictureEnabled: !!document.pictureInPictureEnabled,
             requestPictureInPicture: !!HTMLVideoElement.prototype.requestPictureInPicture,
         });
@@ -58355,7 +58414,7 @@ class PictureInPicture extends UICorePlugin {
         return this;
     }
     togglePictureInPicture() {
-        trace(`${T$5} togglePictureInPicture`);
+        trace(`${T$6} togglePictureInPicture`);
         if (this.videoElement !== document.pictureInPictureElement) {
             this.requestPictureInPicture();
         }
@@ -58364,13 +58423,13 @@ class PictureInPicture extends UICorePlugin {
         }
     }
     requestPictureInPicture() {
-        trace(`${T$5} requestPictureInPicture`, {
+        trace(`${T$6} requestPictureInPicture`, {
             videoElement: !!this.videoElement,
         });
         this.videoElement.requestPictureInPicture();
     }
     exitPictureInPicture() {
-        trace(`${T$5} exitPictureInPicture`);
+        trace(`${T$6} exitPictureInPicture`);
         document.exitPictureInPicture();
     }
 }
@@ -58397,7 +58456,7 @@ const DEFAULT_PLAYBACK_RATES = [
     { value: 2.0, label: '2x' },
 ];
 const DEFAULT_PLAYBACK_RATE = 1;
-const T$4 = 'plugins.playback_rate';
+const T$5 = 'plugins.playback_rate';
 /**
  * `PLUGIN` that allows changing the playback speed of the video.
  * @public
@@ -58483,7 +58542,7 @@ class PlaybackRate extends UICorePlugin {
         this.listenTo(this.core, Events$1.CORE_ACTIVE_CONTAINER_CHANGED, this.onActiveContainerChange);
     }
     onCoreReady() {
-        trace(`${T$4} onCoreReady`);
+        trace(`${T$5} onCoreReady`);
         const mediaControl = this.core.getPlugin('media_control');
         assert(mediaControl, 'media_control plugin is required');
         const gear = this.core.getPlugin('bottom_gear');
@@ -58492,7 +58551,7 @@ class PlaybackRate extends UICorePlugin {
         this.listenTo(gear, GearEvents.RENDERED, this.onGearRendered);
     }
     onActiveContainerChange() {
-        trace(`${T$4} onActiveContainerChange`);
+        trace(`${T$5} onActiveContainerChange`);
         this.metadataLoaded = false;
         this.listenTo(this.core.activePlayback, Events$1.PLAYBACK_STOP, this.onStop);
         this.listenTo(this.core.activePlayback, Events$1.PLAYBACK_PLAY, this.onPlay);
@@ -58500,15 +58559,15 @@ class PlaybackRate extends UICorePlugin {
         this.listenTo(this.core.activeContainer, Events$1.CONTAINER_LOADEDMETADATA, this.onMetaDataLoaded);
     }
     onMediaControlRendered() {
-        trace(`${T$4} onMediaControlRendered`);
+        trace(`${T$5} onMediaControlRendered`);
         this.render();
     }
     onGearRendered() {
-        trace(`${T$4} onGearRendered`);
+        trace(`${T$5} onGearRendered`);
         this.mount();
     }
     mount() {
-        trace(`${T$4} mount`, {
+        trace(`${T$5} mount`, {
             shouldMount: this.shouldMount(),
         });
         if (!this.shouldMount()) {
@@ -58525,7 +58584,7 @@ class PlaybackRate extends UICorePlugin {
         })));
     }
     onMetaDataLoaded() {
-        trace(`${T$4} onMetaDataLoaded`, {
+        trace(`${T$5} onMetaDataLoaded`, {
             playbackType: this.core.activePlayback.getPlaybackType(),
             dvrEnabled: this.core.activePlayback.dvrEnabled,
         });
@@ -58547,7 +58606,7 @@ class PlaybackRate extends UICorePlugin {
             this.core.activePlayback?.setPlaybackRate(this.selectedRate);
         }
         else {
-            trace(`${T$4} onPlaybackRateChange not steering to the selected rate, it is seemingly a catchup algorithm working`, {
+            trace(`${T$5} onPlaybackRateChange not steering to the selected rate, it is seemingly a catchup algorithm working`, {
                 playbackRate,
                 selectedRate: this.selectedRate,
             });
@@ -58610,13 +58669,13 @@ class PlaybackRate extends UICorePlugin {
         }
     }
     syncRate() {
-        trace(`${T$4} syncRate`, {
+        trace(`${T$5} syncRate`, {
             selectedRate: this.selectedRate,
         });
         this.core.activePlayback?.setPlaybackRate(this.selectedRate);
     }
     resetPlaybackRate() {
-        trace(`${T$4} resetPlaybackRate`, {
+        trace(`${T$5} resetPlaybackRate`, {
             selectedRate: this.selectedRate,
         });
         this.core.activePlayback?.setPlaybackRate(DEFAULT_PLAYBACK_RATE);
@@ -58651,7 +58710,7 @@ class PlaybackRate extends UICorePlugin {
             ?.label || `x${rate}`);
     }
     highlightCurrentRate() {
-        trace(`${T$4} highlightCurrentRate`, {
+        trace(`${T$5} highlightCurrentRate`, {
             selectedRate: this.selectedRate,
         });
         this.allRateElements().removeClass('current');
@@ -59687,7 +59746,7 @@ class SpinnerThreeBounce extends UIContainerPlugin {
     }
 }
 
-const T$3 = 'plugins.source_controller';
+const T$4 = 'plugins.source_controller';
 const INITIAL_RETRY_DELAY = 1000;
 const MAX_RETRY_DELAY = 5000;
 const RETRY_DELAY_BLUR = 500;
@@ -59824,7 +59883,7 @@ class SourceController extends CorePlugin {
     }
     bindContainerEventListeners() {
         this.core.activePlayback.on(Events$1.PLAYBACK_ERROR, (error) => {
-            trace(`${T$3} on PLAYBACK_ERROR`, {
+            trace(`${T$4} on PLAYBACK_ERROR`, {
                 error: {
                     code: error?.code,
                     description: error?.description,
@@ -59848,7 +59907,7 @@ class SourceController extends CorePlugin {
             }
         });
         this.listenTo(this.core.activeContainer, Events$1.CONTAINER_PLAY, (_, { autoPlay }) => {
-            trace(`${T$3} onContainerPlay`, {
+            trace(`${T$4} onContainerPlay`, {
                 autoPlay,
                 currentSource: this.sourcesList[this.currentSourceIndex],
                 retrying: this.active,
@@ -59866,7 +59925,7 @@ class SourceController extends CorePlugin {
         this.sourcesDelay = {};
     }
     retryPlayback() {
-        trace(`${T$3} retryPlayback enter`, {
+        trace(`${T$4} retryPlayback enter`, {
             currentSourceIndex: this.currentSourceIndex,
             currentSource: this.sourcesList[this.currentSourceIndex],
         });
@@ -59874,18 +59933,18 @@ class SourceController extends CorePlugin {
         this.switching = true;
         this.core.activeContainer?.getPlugin('spinner')?.show(0);
         this.getNextMediaSource().then((nextSource) => {
-            trace(`${T$3} retryPlayback syncing...`, {
+            trace(`${T$4} retryPlayback syncing...`, {
                 nextSource,
             });
             const rnd = Math.round(RETRY_DELAY_BLUR * Math.random());
             this.sync(() => {
                 this.switching = false;
                 this.core.load(nextSource.source, nextSource.mimeType);
-                trace(`${T$3} retryPlayback loaded`, {
+                trace(`${T$4} retryPlayback loaded`, {
                     nextSource,
                 });
                 setTimeout(() => {
-                    trace(`${T$3} retryPlayback playing`, {
+                    trace(`${T$4} retryPlayback playing`, {
                         autoPlay: this.autoPlay,
                         nextSource,
                     });
@@ -60243,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();
@@ -60397,7 +60454,7 @@ class ClosedCaptions extends UICorePlugin {
 // An example implementation of client side performancestatistics
 const WATCH_CUTOFF = 5;
 const STALL_MEASURE_PERIOD = 10;
-const T$2 = 'plugins.telemetry';
+const T$3 = 'plugins.telemetry';
 /**
  * Telemetry event type
  * @beta
@@ -60507,7 +60564,7 @@ class Telemetry extends ContainerPlugin {
     }
     onReady() {
         this.sendInit();
-        trace(`${T$2} onReady`, {
+        trace(`${T$3} onReady`, {
             autoPlay: this.options.autoPlay,
         });
         if (this.options.autoPlay) {
@@ -63208,7 +63265,7 @@ function loadImageDimensions(url) {
     });
 }
 
-const T$1 = 'plugins.thumbnails';
+const T$2 = 'plugins.thumbnails';
 /**
  * `PLUGIN` that displays the thumbnails of the video when available.
  * @public
@@ -63326,14 +63383,14 @@ class Thumbnails extends UICorePlugin {
         if (!this.options.thumbnails ||
             !this.options.thumbnails.sprite ||
             !this.options.thumbnails.vtt) {
-            trace(`${T$1} misconfigured: options.thumbnails.sprite and options.thumbnails.vtt are required`);
+            trace(`${T$2} misconfigured: options.thumbnails.sprite and options.thumbnails.vtt are required`);
             this.destroy();
             return;
         }
         const { sprite: spriteSheet, vtt } = this.options.thumbnails;
         this.thumbs = this.buildSpriteConfig(parseVTT(vtt), spriteSheet);
         if (!this.thumbs.length) {
-            trace(`${T$1} failed to parse the sprite sheet`);
+            trace(`${T$2} failed to parse the sprite sheet`);
             this.destroy();
             return;
         }
@@ -63582,6 +63639,321 @@ function parseVTT(vtt) {
     return cues;
 }
 
+const T$1 = 'plugins.token_refresh';
+/**
+ * Matches the `/{token}/{expires}/` segment in a Gcore protected-content URL.
+ * Token is base64url (letters, digits, `-`, `_`); expires is a ≥10-digit Unix timestamp.
+ */
+const TOKEN_SEGMENT_RE = /\/([A-Za-z0-9_-]{6,})\/(1\d{9,})\//;
+function extractTokenState(url) {
+    const m = url.match(TOKEN_SEGMENT_RE);
+    if (!m)
+        return null;
+    return { token: m[1], expires: parseInt(m[2], 10) };
+}
+/** Replaces the exact `/{oldToken}/{oldExpires}/` segment in a URL. */
+function rewriteUrl(url, from, to) {
+    const oldPart = `/${from.token}/${from.expires}/`;
+    const newPart = `/${to.token}/${to.expires}/`;
+    return url.includes(oldPart) ? url.replace(oldPart, newPart) : url;
+}
+/**
+ * Normalises a URL by removing the `/{token}/{expires}/` segment so two URLs
+ * for the same stream with different token pairs compare equal.
+ * Returns `null` for unparseable input.
+ */
+function streamKey(url) {
+    try {
+        const u = new URL(url);
+        return u.origin + u.pathname.replace(TOKEN_SEGMENT_RE, '/');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Returns a custom hls.js loader class that transparently rewrites the
+ * token/expires path segments in every request URL.
+ *
+ * The returned class extends the default hls.js XhrLoader so all native
+ * hls.js behaviour (retry, timeout, range requests …) is preserved.
+ */
+function createTokenRewritingLoader(getOriginal, getCurrent) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const DefaultLoader = Hls.DefaultConfig.loader;
+    return class TokenRewritingLoader extends DefaultLoader {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        load(context, config, callbacks) {
+            const original = getOriginal();
+            const current = getCurrent();
+            if (original && current && context.url) {
+                context.url = rewriteUrl(context.url, original, current);
+            }
+            super.load(context, config, callbacks);
+        }
+    };
+}
+/**
+ * `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 |
+ *
+ * @public
+ * @remarks
+ * Register the plugin once before creating any player instance:
+ * ```ts
+ * import { Player, TokenRefreshPlugin } from '@gcorevideo/player'
+ * Player.registerPlugin(TokenRefreshPlugin)
+ * ```
+ *
+ * Then pass `tokenRefresh` in `PlayerConfig`:
+ * ```ts
+ * const player = new Player({
+ *   sources: [{ source: initialUrl, mimeType: 'application/x-mpegURL' }],
+ *   tokenRefresh: {
+ *     getToken: () => fetch('https://…/token').then(r => r.json()),
+ *     ipBound: false,
+ *     refreshLeadSeconds: 5,
+ *     onTokenRefreshed: (data) => console.log('new token expires', data.expires),
+ *   },
+ * })
+ * ```
+ *
+ * @example
+ * Safari native — opt-in Service Worker for fully seamless refresh:
+ * ```js
+ * // Register token-refresh-sw.js (see example/ directory)
+ * // and omit tokenRefresh config — the SW handles rewriting.
+ * ```
+ */
+class TokenRefreshPlugin extends CorePlugin {
+    /** @internal */
+    static get type() {
+        return 'core';
+    }
+    /** @internal */
+    get name() {
+        return 'token_refresh';
+    }
+    /** @internal */
+    get supportedVersion() {
+        return { min: CLAPPR_VERSION$1 };
+    }
+    /** Token state extracted from the currently-managed source URL */
+    originalState = null;
+    /** Latest token state (updated after each refresh) */
+    currentState = null;
+    /** Scheduled refresh timer handle */
+    refreshTimer = null;
+    /** Playback time (seconds) to restore after a native-video source reload */
+    savedPosition = null;
+    /** True when using native HTML5 Video playback (no request interception) */
+    isNativePlayback = false;
+    /** Set in destroy(); short-circuits late timer callbacks and getToken() resolutions */
+    destroyed = false;
+    /** @internal */
+    bindEvents() {
+        this.listenTo(this.core, Events$1.CORE_CONTAINERS_CREATED, this.onContainersCreated);
+    }
+    /** @internal */
+    destroy() {
+        this.destroyed = true;
+        this.clearTimer();
+        super.destroy();
+    }
+    onContainersCreated() {
+        const container = this.core.containers[0];
+        if (!container)
+            return;
+        const playbackName = container.playback.name;
+        const src = container.playback.options?.src ?? '';
+        trace(`${T$1} onContainersCreated`, { playbackName, src: src.slice(0, 80) });
+        this.isNativePlayback = playbackName !== 'hls' && playbackName !== 'dash';
+        const state = extractTokenState(src);
+        if (!state) {
+            // Active source has no token pattern — drop any refresh state we were
+            // holding for a previous stream (e.g. SourceController rotated away).
+            if (this.originalState) {
+                trace(`${T$1} active source has no token pattern — clearing refresh state`);
+                this.clearTimer();
+                this.originalState = null;
+                this.currentState = null;
+            }
+            return;
+        }
+        // Adopt the new token state if this is the first source we see, or if
+        // the stream has changed (SourceController rotated, consumer called
+        // player.load() with a different stream, or the plugin itself reloaded
+        // with a refreshed URL in the native path).
+        const isNewStream = !this.originalState ||
+            state.token !== this.originalState.token ||
+            state.expires !== this.originalState.expires;
+        if (isNewStream) {
+            trace(`${T$1} adopting source token state`, {
+                token: state.token.slice(0, 8) + '…',
+                expires: new Date(state.expires * 1000).toISOString(),
+            });
+            this.originalState = { ...state };
+            this.currentState = { ...state };
+            this.scheduleRefresh();
+        }
+        // Inject the appropriate interception mechanism for this playback engine.
+        switch (playbackName) {
+            case 'hls':
+                this.injectHlsLoader(container);
+                break;
+            case 'dash':
+                this.injectDashInterceptor(container);
+                break;
+            default:
+                // Native HTML5 Video — no request hooks available.
+                // Seek restore after a token-triggered reload.
+                this.listenToOnce(this.core, Events$1.CORE_ACTIVE_CONTAINER_CHANGED, this.onActiveContainerChangedForNative);
+                break;
+        }
+    }
+    injectHlsLoader(container) {
+        const getOriginal = () => this.originalState;
+        const getCurrent = () => this.currentState;
+        const TokenLoader = createTokenRewritingLoader(getOriginal, getCurrent);
+        $.extend(true, container.playback.options, {
+            playback: {
+                hlsjsConfig: {
+                    loader: TokenLoader,
+                },
+            },
+        });
+        trace(`${T$1} HLS custom loader injected`);
+    }
+    injectDashInterceptor(container) {
+        $.extend(true, container.playback.options, {
+            dash: {
+                requestInterceptor: (request) => {
+                    if (this.originalState && this.currentState) {
+                        request.url = rewriteUrl(request.url, this.originalState, this.currentState);
+                    }
+                    return Promise.resolve(request);
+                },
+            },
+        });
+        trace(`${T$1} DASH request interceptor injected`);
+    }
+    async reloadNativeSource(data) {
+        const container = this.core.activeContainer;
+        const playback = container?.playback;
+        if (!playback)
+            return;
+        // SourceController (or any other actor) may have switched the active
+        // playback to hls/dash while getToken() was in flight. Those engines
+        // have their own request-interception path; a native reload would
+        // undo the switch.
+        if (playback.name === 'hls' || playback.name === 'dash') {
+            trace(`${T$1} skipping native reload — active playback is ${playback.name}`);
+            return;
+        }
+        if (!this.isNativePlayback) {
+            trace(`${T$1} skipping native reload — no longer in native playback mode`);
+            return;
+        }
+        // Verify the URL we're about to load belongs to the same stream that's
+        // currently active. If SourceController rotated to a different stream
+        // during the getToken() await, the refreshed URL would silently swap
+        // us back, undoing SourceController's decision.
+        const currentSrc = playback.options?.src ?? '';
+        const newUrl = this.opts.ipBound ? data.url_ip : data.url;
+        const activeKey = streamKey(currentSrc);
+        const nextKey = streamKey(newUrl);
+        if (!activeKey || !nextKey || activeKey !== nextKey) {
+            trace(`${T$1} skipping native reload — active source differs from refresh URL`, {
+                activeKey,
+                nextKey,
+            });
+            return;
+        }
+        // Capture current playback position before tearing down the container.
+        const mediaEl = playback.el;
+        const currentTime = mediaEl?.currentTime ?? 0;
+        this.savedPosition = currentTime > 0 ? currentTime : null;
+        trace(`${T$1} native reload`, { newUrl: newUrl.slice(0, 80), savedPosition: this.savedPosition });
+        // core.load() destroys and recreates all containers.
+        this.core.load([{ source: newUrl, mimeType: this.core.options.mimeType ?? 'application/x-mpegURL' }]);
+    }
+    onActiveContainerChangedForNative() {
+        if (this.savedPosition === null)
+            return;
+        const pos = this.savedPosition;
+        this.savedPosition = null;
+        // Wait for the new container to be fully ready before seeking.
+        const container = this.core.activeContainer;
+        if (!container)
+            return;
+        this.listenToOnce(container, Events$1.CONTAINER_READY, () => {
+            trace(`${T$1} native: restoring position`, { pos });
+            container.seek(pos);
+            container.play();
+        });
+    }
+    scheduleRefresh() {
+        this.clearTimer();
+        if (this.destroyed || !this.currentState)
+            return;
+        const leadMs = (this.opts.refreshLeadSeconds ?? 5) * 1000;
+        const msUntilRefresh = this.currentState.expires * 1000 - Date.now() - leadMs;
+        trace(`${T$1} next refresh in`, {
+            seconds: Math.round(msUntilRefresh / 1000),
+            expires: new Date(this.currentState.expires * 1000).toISOString(),
+        });
+        this.refreshTimer = setTimeout(() => this.performRefresh(), Math.max(msUntilRefresh, 1000));
+    }
+    async performRefresh() {
+        trace(`${T$1} fetching new token`);
+        try {
+            const data = await this.opts.getToken();
+            // Plugin may have been destroyed while getToken() was in flight; drop the result.
+            if (this.destroyed)
+                return;
+            const newToken = this.opts.ipBound ? data.token_ip : data.token;
+            const newState = { token: newToken, expires: data.expires };
+            if (this.isNativePlayback) {
+                // Must reload source because the <video> element has no request hook.
+                await this.reloadNativeSource(data);
+            }
+            // originalState is never changed after init — it holds the token that was
+            // baked into every URL in the initial manifest. hls.js/dash.js always
+            // produces request URLs based on that manifest, so every segment URL
+            // still contains the original token regardless of how many refreshes
+            // have already happened. The loader replaces original→current on each
+            // request, so updating only currentState is sufficient.
+            this.currentState = newState;
+            this.opts.onTokenRefreshed?.(data);
+            trace(`${T$1} token refreshed`, {
+                token: newToken.slice(0, 8) + '…',
+                expires: new Date(data.expires * 1000).toISOString(),
+            });
+        }
+        catch (err) {
+            trace(`${T$1} token refresh failed`, { err });
+        }
+        // Always reschedule, even after an error (will retry near next expiry).
+        this.scheduleRefresh();
+    }
+    get opts() {
+        return this.options.tokenRefresh;
+    }
+    clearTimer() {
+        if (this.refreshTimer !== null) {
+            clearTimeout(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+    }
+}
+
 /**
  * Events emitted by the VolumeFade plugin.
  * @public
@@ -63690,4 +64062,4 @@ class VolumeFade extends UICorePlugin {
     }
 }
 
-export { AudioTracks as AudioSelector, AudioTracks, BigMuteButton, BottomGear, ChainedTracer, NerdStats as ClapprNerdStats, ClapprStats, ClapprStatsChronograph, ClapprStatsCounter, ClapprStatsEvents, ClickToPause, Clips, ClosedCaptions, CmcdConfig, ContextMenu, DvrControls, ErrorScreen, ExtendedEvents, Favicon, GearEvents, GoogleAnalytics, QualityLevels as LevelSelector, LogTracer, Logger$1 as Logger, Logo, MediaControl, MultiCamera, NerdStats, PictureInPicture, PlaybackErrorCode, PlaybackRate, Player, PlayerEvent, Poster, QualityLevels, RemoteTracer, SeekTime, SentryTracer, Share, SkipTime, SourceController, SpinnerThreeBounce as Spinner, SpinnerEvents, SpinnerThreeBounce, ClosedCaptions as Subtitles, Telemetry, TelemetryEvent, Thumbnails, VolumeFade, VolumeFadeEvents, reportError, setTracer, trace, version };
+export { AudioTracks as AudioSelector, AudioTracks, BigMuteButton, BottomGear, ChainedTracer, NerdStats as ClapprNerdStats, ClapprStats, ClapprStatsChronograph, ClapprStatsCounter, ClapprStatsEvents, ClickToPause, Clips, ClosedCaptions, CmcdConfig, ContextMenu, DvrControls, ErrorScreen, ExtendedEvents, Favicon, GearEvents, GoogleAnalytics, QualityLevels as LevelSelector, LogTracer, Logger$1 as Logger, Logo, MediaControl, MultiCamera, NerdStats, PictureInPicture, PlaybackErrorCode, PlaybackRate, Player, PlayerEvent, Poster, QualityLevels, RemoteTracer, SeekTime, SentryTracer, Share, SkipTime, SourceController, SpinnerThreeBounce as Spinner, SpinnerEvents, SpinnerThreeBounce, ClosedCaptions as Subtitles, Telemetry, TelemetryEvent, Thumbnails, TokenRefreshPlugin, VolumeFade, VolumeFadeEvents, reportError, setTracer, trace, version };