@gcorevideo/player 2.29.0 → 2.30.0

package/lib/Player.d.ts

@@ -132,6 +132,15 @@ export declare class Player {
      * @beta
      */
     load(mediaSources: PlayerMediaSource[]): void;
+    /**
+     * 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: string): any;
     /**
      * Mutes the sound of the video.
      */

package/lib/Player.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Player.d.ts","sourceRoot":"","sources":["../src/Player.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Player.d.ts","sourceRoot":"","sources":["../src/Player.ts"],"names":[],"mappings":"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"}

package/lib/Player.js

@@ -199,6 +199,17 @@ export 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.
      */

package/lib/index.plugins.d.ts

@@ -32,5 +32,6 @@ export * from './plugins/subtitles/ClosedCaptions.js';
 export { ClosedCaptions as Subtitles } from './plugins/subtitles/ClosedCaptions.js';
 export * from './plugins/telemetry/Telemetry.js';
 export * from './plugins/thumbnails/Thumbnails.js';
+export * from './plugins/token-refresh/index.js';
 export * from './plugins/volume-fade/VolumeFade.js';
 //# sourceMappingURL=index.plugins.d.ts.map

package/lib/index.plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.plugins.d.ts","sourceRoot":"","sources":["../src/index.plugins.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAA;AAElC,cAAc,yCAAyC,CAAA;AACvD,OAAO,EAAE,WAAW,IAAI,aAAa,EAAE,MAAM,yCAAyC,CAAA;AACtF,cAAc,4CAA4C,CAAA;AAC1D,cAAc,qCAAqC,CAAA;AACnD,cAAc,uCAAuC,CAAA;AACrD,cAAc,qCAAqC,CAAA;AACnD,cAAc,0CAA0C,CAAA;AACxD,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,0CAA0C,CAAA;AACvF,cAAc,0CAA0C,CAAA;AACxD,cAAc,0BAA0B,CAAA;AACxC,cAAc,uCAAuC,CAAA;AACrD,cAAc,uCAAuC,CAAA;AACrD,cAAc,uCAAuC,CAAA;AACrD,cAAc,8BAA8B,CAAA;AAE5C,cAAc,+CAA+C,CAAA;AAC7D,cAAc,wBAAwB,CAAA;AACtC,cAAc,yCAAyC,CAAA;AACvD,cAAc,uCAAuC,CAAA;AACrD,cAAc,kDAAkD,CAAA;AAChE,cAAc,yCAAyC,CAAA;AACvD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2CAA2C,CAAA;AACzD,OAAO,EAAE,aAAa,IAAI,aAAa,EAAE,MAAM,2CAA2C,CAAA;AAC1F,cAAc,iCAAiC,CAAA;AAC/C,cAAc,0BAA0B,CAAA;AACxC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sDAAsD,CAAA;AACpE,OAAO,EAAE,kBAAkB,IAAI,OAAO,EAAE,MAAM,sDAAsD,CAAA;AACpG,cAAc,iDAAiD,CAAA;AAC/D,cAAc,uCAAuC,CAAA;AACrD,OAAO,EAAE,cAAc,IAAI,SAAS,EAAE,MAAM,uCAAuC,CAAA;AACnF,cAAc,kCAAkC,CAAA;AAChD,cAAc,oCAAoC,CAAA;AAGlD,cAAc,qCAAqC,CAAA"}
+{"version":3,"file":"index.plugins.d.ts","sourceRoot":"","sources":["../src/index.plugins.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAA;AAElC,cAAc,yCAAyC,CAAA;AACvD,OAAO,EAAE,WAAW,IAAI,aAAa,EAAE,MAAM,yCAAyC,CAAA;AACtF,cAAc,4CAA4C,CAAA;AAC1D,cAAc,qCAAqC,CAAA;AACnD,cAAc,uCAAuC,CAAA;AACrD,cAAc,qCAAqC,CAAA;AACnD,cAAc,0CAA0C,CAAA;AACxD,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,0CAA0C,CAAA;AACvF,cAAc,0CAA0C,CAAA;AACxD,cAAc,0BAA0B,CAAA;AACxC,cAAc,uCAAuC,CAAA;AACrD,cAAc,uCAAuC,CAAA;AACrD,cAAc,uCAAuC,CAAA;AACrD,cAAc,8BAA8B,CAAA;AAE5C,cAAc,+CAA+C,CAAA;AAC7D,cAAc,wBAAwB,CAAA;AACtC,cAAc,yCAAyC,CAAA;AACvD,cAAc,uCAAuC,CAAA;AACrD,cAAc,kDAAkD,CAAA;AAChE,cAAc,yCAAyC,CAAA;AACvD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2CAA2C,CAAA;AACzD,OAAO,EAAE,aAAa,IAAI,aAAa,EAAE,MAAM,2CAA2C,CAAA;AAC1F,cAAc,iCAAiC,CAAA;AAC/C,cAAc,0BAA0B,CAAA;AACxC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sDAAsD,CAAA;AACpE,OAAO,EAAE,kBAAkB,IAAI,OAAO,EAAE,MAAM,sDAAsD,CAAA;AACpG,cAAc,iDAAiD,CAAA;AAC/D,cAAc,uCAAuC,CAAA;AACrD,OAAO,EAAE,cAAc,IAAI,SAAS,EAAE,MAAM,uCAAuC,CAAA;AACnF,cAAc,kCAAkC,CAAA;AAChD,cAAc,oCAAoC,CAAA;AAGlD,cAAc,kCAAkC,CAAA;AAChD,cAAc,qCAAqC,CAAA"}

package/lib/index.plugins.js

@@ -35,4 +35,5 @@ export * from './plugins/telemetry/Telemetry.js';
 export * from './plugins/thumbnails/Thumbnails.js';
 // _ vast-ads
 // _ video360
+export * from './plugins/token-refresh/index.js';
 export * from './plugins/volume-fade/VolumeFade.js';

package/lib/playback/dash-playback/DashPlayback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DashPlayback.d.ts","sourceRoot":"","sources":["../../../src/playback/dash-playback/DashPlayback.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DashPlayback.d.ts","sourceRoot":"","sources":["../../../src/playback/dash-playback/DashPlayback.ts"],"names":[],"mappings":"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"}

package/lib/playback/dash-playback/DashPlayback.js

@@ -145,6 +145,7 @@ export default 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: {
@@ -156,8 +157,11 @@ export default 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);

package/lib/plugins/token-refresh/TokenRefreshPlugin.d.ts

@@ -0,0 +1,119 @@
+import { CorePlugin } from '@clappr/core';
+/**
+ * Response shape expected from your token-refresh API endpoint.
+ * @public
+ */
+export interface TokenResponse {
+    /** Plain (non-IP-bound) secure token */
+    token: string;
+    /** IP-bound secure token */
+    token_ip: string;
+    /** Client IP address (informational) */
+    client_ip: string;
+    /** Unix timestamp (seconds) when both tokens expire */
+    expires: number;
+    /** Ready-to-use HLS master playlist URL with plain token embedded */
+    url: string;
+    /** Ready-to-use HLS master playlist URL with IP-bound token embedded */
+    url_ip: string;
+}
+/**
+ * Configuration options for {@link TokenRefreshPlugin}.
+ * @public
+ */
+export interface TokenRefreshOptions {
+    /**
+     * Async function called each time a fresh token is needed.
+     * Must return a {@link TokenResponse}.
+     */
+    getToken: () => Promise<TokenResponse>;
+    /**
+     * When `true`, the IP-bound variant (`token_ip` / `url_ip`) is used.
+     * Defaults to `false`.
+     */
+    ipBound?: boolean;
+    /**
+     * Seconds before the token expiry timestamp to request a fresh token.
+     * Defaults to `5`.
+     */
+    refreshLeadSeconds?: number;
+    /**
+     * Optional callback invoked after every successful token refresh.
+     */
+    onTokenRefreshed?: (data: TokenResponse) => void;
+}
+/**
+ * `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.
+ * ```
+ */
+export declare class TokenRefreshPlugin extends CorePlugin {
+    /** @internal */
+    static get type(): 'core';
+    /** @internal */
+    get name(): string;
+    /** @internal */
+    get supportedVersion(): {
+        min: string;
+    };
+    /** Token state extracted from the currently-managed source URL */
+    private originalState;
+    /** Latest token state (updated after each refresh) */
+    private currentState;
+    /** Scheduled refresh timer handle */
+    private refreshTimer;
+    /** Playback time (seconds) to restore after a native-video source reload */
+    private savedPosition;
+    /** True when using native HTML5 Video playback (no request interception) */
+    private isNativePlayback;
+    /** Set in destroy(); short-circuits late timer callbacks and getToken() resolutions */
+    private destroyed;
+    /** @internal */
+    bindEvents(): void;
+    /** @internal */
+    destroy(): void;
+    private onContainersCreated;
+    private injectHlsLoader;
+    private injectDashInterceptor;
+    private reloadNativeSource;
+    private onActiveContainerChangedForNative;
+    private scheduleRefresh;
+    private performRefresh;
+    private get opts();
+    private clearTimer;
+}
+//# sourceMappingURL=TokenRefreshPlugin.d.ts.map

package/lib/plugins/token-refresh/TokenRefreshPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenRefreshPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/token-refresh/TokenRefreshPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,UAAU,EAAU,MAAM,cAAc,CAAA;AAQrE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAA;IACX,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;CACjD;AAgED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,gBAAgB;IAChB,MAAM,KAAK,IAAI,IAAI,MAAM,CAExB;IAED,gBAAgB;IAChB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,gBAAgB;IAChB,IAAI,gBAAgB;;MAEnB;IAED,kEAAkE;IAClE,OAAO,CAAC,aAAa,CAA0B;IAC/C,sDAAsD;IACtD,OAAO,CAAC,YAAY,CAA0B;IAC9C,qCAAqC;IACrC,OAAO,CAAC,YAAY,CAA6C;IACjE,4EAA4E;IAC5E,OAAO,CAAC,aAAa,CAAsB;IAC3C,4EAA4E;IAC5E,OAAO,CAAC,gBAAgB,CAAQ;IAChC,uFAAuF;IACvF,OAAO,CAAC,SAAS,CAAQ;IAEzB,gBAAgB;IACP,UAAU,IAAI,IAAI;IAQ3B,gBAAgB;IACP,OAAO,IAAI,IAAI;IAMxB,OAAO,CAAC,mBAAmB;IA8D3B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,qBAAqB;YAmBf,kBAAkB;IA+ChC,OAAO,CAAC,iCAAiC;IAiBzC,OAAO,CAAC,eAAe;YAmBT,cAAc;IAmC5B,OAAO,KAAK,IAAI,GAEf;IAED,OAAO,CAAC,UAAU;CAMnB"}

package/lib/plugins/token-refresh/TokenRefreshPlugin.js

@@ -0,0 +1,318 @@
+import { $, CorePlugin, Events } from '@clappr/core';
+import HLSJS from 'hls.js';
+import { trace } from '@gcorevideo/utils';
+import { CLAPPR_VERSION } from '../../build.js';
+const T = '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 = HLSJS.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.
+ * ```
+ */
+export class TokenRefreshPlugin extends CorePlugin {
+    /** @internal */
+    static get type() {
+        return 'core';
+    }
+    /** @internal */
+    get name() {
+        return 'token_refresh';
+    }
+    /** @internal */
+    get supportedVersion() {
+        return { min: CLAPPR_VERSION };
+    }
+    /** 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.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} 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} 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} 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.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} 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} 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} skipping native reload — active playback is ${playback.name}`);
+            return;
+        }
+        if (!this.isNativePlayback) {
+            trace(`${T} 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} 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} 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.CONTAINER_READY, () => {
+            trace(`${T} 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} 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} 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} token refreshed`, {
+                token: newToken.slice(0, 8) + '…',
+                expires: new Date(data.expires * 1000).toISOString(),
+            });
+        }
+        catch (err) {
+            trace(`${T} 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;
+        }
+    }
+}

package/lib/plugins/token-refresh/index.d.ts

@@ -0,0 +1,2 @@
+export { TokenRefreshPlugin, type TokenRefreshOptions, type TokenResponse, } from './TokenRefreshPlugin.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/plugins/token-refresh/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/token-refresh/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAA"}

package/lib/plugins/token-refresh/index.js

@@ -0,0 +1 @@
+export { TokenRefreshPlugin, } from './TokenRefreshPlugin.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gcorevideo/player",
-  "version": "2.29.0",
+  "version": "2.30.0",
   "description": "Gcore JavaScript video player",
   "main": "dist/index.js",
   "type": "module",

package/src/Player.ts

@@ -278,6 +278,18 @@ export 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: string) {
+    return this.player?.core.getPlugin(name) ?? null
+  }
+
   /**
    * Mutes the sound of the video.
    */

package/src/index.plugins.ts

@@ -36,4 +36,5 @@ export * from './plugins/telemetry/Telemetry.js'
 export * from './plugins/thumbnails/Thumbnails.js'
 // _ vast-ads
 // _ video360
+export * from './plugins/token-refresh/index.js'
 export * from './plugins/volume-fade/VolumeFade.js'

package/src/playback/dash-playback/DashPlayback.ts

@@ -243,6 +243,7 @@ export default class DashPlayback extends BasePlayback {
     this._dash.initialize()
 
     if (this.options.dash) {
+      const { requestInterceptor, ...dashSettings } = this.options.dash as Record<string, unknown>
       const settings = $.extend(
         true,
         {
@@ -257,9 +258,13 @@ export default class DashPlayback extends BasePlayback {
             },
           },
         },
-        this.options.dash,
+        dashSettings,
       )
       this._dash.updateSettings(settings)
+
+      if (typeof requestInterceptor === 'function') {
+        this._dash.addRequestInterceptor(requestInterceptor as Parameters<typeof this._dash.addRequestInterceptor>[0])
+      }
     }
 
     this._dash.attachView(this.el as HTMLMediaElement)