@srgssr/pillarbox-web 1.17.0 → 1.19.0

package/dist/pillarbox.cjs.js

@@ -109,11 +109,16 @@ function _objectWithoutProperties(source, excluded) {
   return target;
 }
 
-const version = "1.16.0";
+const version = "1.18.0";
+
+/** @import VJSPlayer from 'video.js/dist/types/player' */
+/** @import AudioTrack from 'video.js/dist/types/tracks/audio-track' */
+/** @import TextTrack from 'video.js/dist/types/tracks/text-track' */
+/** @import {TrackSelector} from './typedef' */
 
 /**
  * @ignore
- * @type {typeof import('video.js/dist/types/player').default}
+ * @type {typeof VJSPlayer}
  */
 const vjsPlayer = videojs.getComponent('player');
 
@@ -148,7 +153,7 @@ class Player extends vjsPlayer {
    * @see https://developer.mozilla.org/en-US/docs/Web/API/AudioTrack/kind
    * @see https://developer.mozilla.org/en-US/docs/Web/API/AudioTrack/language
    *
-   * @param {import('./typedef').TrackSelector} [trackSelector]
+   * @param {TrackSelector} [trackSelector]
    *
    * @example
    * // Get the current audio track
@@ -162,7 +167,7 @@ class Player extends vjsPlayer {
    * // Activate first audio track found corresponding to language
    * player.audioTrack({language:'fr'});
    *
-   * @return {import('video.js/dist/types/tracks/audio-track').default | undefined} The
+   * @return {AudioTrack | undefined} The
    *         currently enabled audio track. See {@link https://docs.videojs.com/audiotrack}.
    */
   audioTrack(trackSelector) {
@@ -272,7 +277,7 @@ class Player extends vjsPlayer {
    * @see https://developer.mozilla.org/en-US/docs/Web/API/TextTrack/kind
    * @see https://developer.mozilla.org/en-US/docs/Web/API/textTrack/language
    *
-   * @param {import('./typedef').TrackSelector} [trackSelector]
+   * @param {TrackSelector} [trackSelector]
    *
    * @example
    * // Get the current text track
@@ -291,7 +296,7 @@ class Player extends vjsPlayer {
    * // Activate first text track found corresponding to language
    * player.textTrack({language:'fr'});
    *
-   * @return {import('video.js/dist/types/tracks/text-track').default | undefined} The
+   * @return {TextTrack | undefined} The
    *         currently enabled text track. See {@link https://docs.videojs.com/texttrack}.
    */
   textTrack(trackSelector) {
@@ -410,10 +415,11 @@ pillarbox.options.responsive = true;
  */
 pillarbox.options.trackers = {};
 
+/** @import MediaComposition from '../model/MediaComposition.js' */
+
 /**
  * Represents a data provider for constructing URLs and handling requests.
  * @class
- * @ignore
  */
 class DataProvider {
   /**
@@ -441,7 +447,7 @@ class DataProvider {
    *
    * @param {Function} urlHandler A function that constructs the URL
    *
-   * @returns {Promise<import('../model/MediaComposition.js').default>} A promise with the fetched data
+   * @returns {Promise<MediaComposition>} A promise with the fetched data
    */
   handleRequest(urlHandler) {
     var _this = this;
@@ -453,7 +459,7 @@ class DataProvider {
           throw response;
         }
 
-        /** @type {import('../model/MediaComposition.js').default} */
+        /** @type {MediaComposition} */
         const data = yield response.json();
         return data;
       });
@@ -842,67 +848,65 @@ const TIME_UPDATE = 'timeupdate';
  */
 const WAITING = 'waiting';
 
+/** @import Player from 'video.js/dist/types/player' */
+
 /* eslint max-lines-per-function: ["error", 200] */
 /* eslint max-statements: ["error", 20]*/
 /* eslint complexity: ["error", 10]*/
+
 /**
- * SRG analytics
- * @class SRGAnalytics
- * @ignore
+ * The SRG analytics class tracks media playback according to the standard defined by SRG SSR.
  *
- * ### Script URL
- * JS script : https://colibri-js.akamaized.net/penguin/tc_SRGGD_11.js
+ * @class SRGAnalytics
  *
  * ### Official documentation
- * Variables list
- * @see https://confluence.srg.beecollaboration.com/display/INTFORSCHUNG/Datalayer+for+media+players
  *
- * Standard event sequences
- * @see https://confluence.srg.beecollaboration.com/display/INTFORSCHUNG/standard+streaming+events%3A+sequence+of+events+for+media+player+actions
+ * - [New variable list]{@link https://srgssr-ch.atlassian.net/wiki/spaces/INTFORSCHUNG/pages/1009353309/Labels+check+for+migration+of+integration+layer+in+SAM}
+ * - [Variables list]{@link https://srgssr-ch.atlassian.net/wiki/spaces/INTFORSCHUNG/pages/795904478/Datalayer+for+media+players}
+ * - [Standard event sequences]{@link https://srgssr-ch.atlassian.net/wiki/spaces/INTFORSCHUNG/pages/795904171/standard+streaming+events+sequence+of+events+for+media+player+actions}
+ * - [Review of Standard Media Actions]{@link https://srgssr-ch.atlassian.net/wiki/spaces/INTFORSCHUNG/pages/795902249/Implementation+Concept+-+draft}
+ * - [ComScore Implementation Guide]{@link https://www.dropbox.com/sh/cdwuikq0abxi21m/AABmSyXYKUTWSAwRZgQA9Ujna/JavaScript%20Latest%20Version?dl=0&preview=Comscore_Library-JavaScript-Streaming_Tag-Implementation_Guide-International.pdf&subfolder_nav_tracking=1}
  *
- * Review of Standard Media Actions
- * @see https://confluence.srg.beecollaboration.com/display/INTFORSCHUNG/Implementation+Concept+-+draft
+ * ### Script URL
  *
- * ComScore Implementation Guide
- * @see https://www.dropbox.com/sh/cdwuikq0abxi21m/AABmSyXYKUTWSAwRZgQA9Ujna/JavaScript%20Latest%20Version?dl=0&preview=Comscore_Library-JavaScript-Streaming_Tag-Implementation_Guide-International.pdf&subfolder_nav_tracking=1
+ * JS script : https://colibri-js.akamaized.net/penguin/tc_SRGGD_11.js
  *
  * ### Variables list
- * - 'event_id', // init | play | stop | pos | pause | seek | uptime | eof
- * - 'event_timestamp', // Seems to be generated automatically from the documentation, but the TP overrides it
- * - 'event_name', // NA TP seems to not sending this variable
- * - 'event_source', // NA TP seems to not sending this variable
- * - 'event_name', // NA TP seems to not sending this variable
- * - 'event_value', // NA TP seems to not sending this variable
- * - 'navigation_environment', // prod | preprod
- * - 'media_subtitles_on', // string true | false
- * - 'media_timeshift', // need better description
- * - 'media_quality', // SD | HD ?
- * - 'media_bandwidth', // NA for the web, 64000
- * - 'media_volume', // from 0 to 100
- * - 'media_embedding_url', //
- * - 'media_player_name', // videojs | letterbox-web ?
- * - 'media_chromecast_selected', // boolean true | false
- * - 'media_player_version', // player's version
- * - 'media_player_display', // is the player mode, on the TP : inline, embed etc..
- * - 'media_audio_track', // NA
- * - 'media_position_real', // NA
- * - 'media_time_spent', // NA
- * - 'device_id', // NA
- * - 'user_id_log_in', // NA only RTS has log in today
- * - 'media_thumbnail', // Not required by the spec but sended by the TP
- * - 'media_bu_distributer', // Not required by the spec but sended by the TP
  *
+ * - event_id: init | play | stop | pos | pause | seek | uptime | eof
+ * - event_timestamp: Seems to be generated automatically from the documentation, but the TP overrides it
+ * - event_name: NA TP seems to not sending this variable
+ * - event_source: NA TP seems to not sending this variable
+ * - event_name: NA TP seems to not sending this variable
+ * - event_value: NA TP seems to not sending this variable
+ * - navigation_environment: prod | preprod
+ * - media_subtitles_on: string true | false
+ * - media_timeshift: need better description
+ * - media_quality: SD | HD ?
+ * - media_bandwidth: NA for the web, 64000
+ * - media_volume: from 0 to 100
+ * - media_embedding_url:
+ * - media_player_name: videojs | letterbox-web ?
+ * - media_chromecast_selected: boolean true | false
+ * - media_player_version: player's version
+ * - media_player_display: is the player mode, on the TP : inline, embed etc..
+ * - media_audio_track: NA
+ * - media_position_real: NA
+ * - media_time_spent: NA
+ * - device_id: NA
+ * - user_id_log_in: NA only RTS has log in today
+ * - media_thumbnail: Not required by the spec but sended by the TP
+ * - media_bu_distributer: Not required by the spec but sended by the TP
  *
  * ### Sequence stories
  *
- * __Story 1 (AoD/VOD-basics)__: A VoD is played. The user does not interact with the player. The VoD plays to its end.
+ * #### Story 1 (AoD/VOD-basics): A VoD is played. The user does not interact with the player. The VoD plays to its end.
  *
  * Hints:
  * - Media sessions always start with PLAY. They end with STOP or EOF (or with PAUSE or last POS)
  * - POS is sent ever 30s
  *
- *
- * __Story 2 (livestream-basics A)__: A Livestream is played. The user does not interact with the player. After 61 seconds, playback is paused.
+ * #### Story 2 (livestream-basics A): A Livestream is played. The user does not interact with the player. After 61 seconds, playback is paused.
  *
  * Hints:
  * - Media sessions always start with PLAY. They end with STOP (or, worse for data quailty, with PAUSE or last POS/UPTIME)
@@ -910,14 +914,12 @@ const WAITING = 'waiting';
  * - POS is sent ever 30s, UPTIME every 60s with inital UPTIME after 30s.
  * - This is the interval: 30s: POS + UPTIME; 60s: POS; 90s: POS + UPTIME; ...
  *
- *
- * __Story 3 (Seeking a VoD/AoD)__: A VoD is played. User seeks in the VoD/AoD.
+ * #### Story 3 (Seeking a VoD/AoD): A VoD is played. User seeks in the VoD/AoD.
  *
  * Hints:
  * - Once the Media Player slider is released (seek is over), another action to finish up the seeking is initiated. Typically this is PLAY. For that second PLAY, the media position has altered.
  *
- *
- * __Story 4 (Seeking a livestream)__: A Livestream is played. User goes back in the livestream.
+ * #### Story 4 (Seeking a livestream): A Livestream is played. User goes back in the livestream.
  *
  * Hints:
  * - Once the Media Player slider is released (seek is over), another action to finish up the seeking is initiated. Typically this is PLAY.  For that second PLAY, the a new variable, media_timeshift is passed.
@@ -926,6 +928,17 @@ const WAITING = 'waiting';
  *  2. The value of media_position is '1'.
  */
 class SRGAnalytics {
+  /**
+   * Creates an instance of SRGAnalytics.
+   *
+   * @constructor
+   * @param {Player} player The player instance
+   * @param {SRGAnalyticsOptions} [options={}] Configuration options
+   * @param {boolean} [options.debug=false] Enables debug mode if set to true
+   * @param {string} [options.environment='prod'] The environment in which the data is sent
+   * @param {string} [options.playerVersion='none'] The version of the player
+   * @param {string} [options.tagCommanderScriptURL='//colibri-js.akamaized.net/penguin/tc_SRGGD_11.js'] The URL for the Tag Commander script
+   */
   constructor(player, {
     debug = false,
     environment = 'prod',
@@ -1653,6 +1666,8 @@ class SRGAnalytics {
   }
 }
 
+/** @import Player from 'video.js/dist/types/player' */
+
 /* eslint max-statements: ["error", 25]*/
 
 /**
@@ -1671,6 +1686,19 @@ class SRGAnalytics {
  * @see https://github.com/SRGSSR/pillarbox-documentation/blob/main/Specifications/monitoring.md
  */
 class PillarboxMonitoring {
+  /**
+   * Creates an instance of PillarboxMonitoring.
+   *
+   * @constructor
+   * @param {Player} player The player instance to be monitored
+   * @param {PillarboxMonitoringOptions} [options={}] Configuration options for the monitoring
+   * @param {string} [options.playerName='none'] The name of the player
+   * @param {string} [options.playerVersion='none'] The version of the player
+   * @param {string} [options.platform='Web'] The platform on which the player is running
+   * @param {number} [options.schemaVersion=1] The version of the schema used for monitoring
+   * @param {number} [options.heartbeatInterval=30000] The interval in milliseconds for sending heartbeat signals
+   * @param {string} [options.beaconUrl='https://monitoring.pillarbox.ch/api/events'] The URL for the monitoring beacon
+   */
   constructor(player, {
     playerName = 'none',
     playerVersion = 'none',
@@ -2493,6 +2521,19 @@ class PillarboxMonitoring {
   }
 }
 
+/**
+ * @typedef {import('./typedef').Channel} Channel
+ * @typedef {import('./typedef').Chapter} Chapter
+ * @typedef {import('./typedef').Episode} Episode
+ * @typedef {import('./typedef').Resource} Resource
+ * @typedef {import('./typedef').Segment} Segment
+ * @typedef {import('./typedef').Show} Show
+ * @typedef {import('./typedef').Subtitle} Subtitle
+ * @typedef {import('./typedef').TimeInterval} TimeInterval
+ * @typedef {import('./typedef').Topic} Topic
+ * @typedef {import('./typedef').MainResource} MainResource
+ */
+
 /**
  * Represents the composition of media content.
  *
@@ -2691,6 +2732,7 @@ class MediaComposition {
       imageCopyright: this.getMainChapter().imageCopyright,
       intervals: this.getMainTimeIntervals(),
       live: resource.live,
+      mediaContainer: resource.mediaContainer,
       mediaType: this.getMainChapter().mediaType,
       mimeType: resource.mimeType,
       presentation: resource.presentation,
@@ -2781,19 +2823,6 @@ class MediaComposition {
   }
 }
 
-/**
- * @typedef {import('./typedef').Channel} Channel
- * @typedef {import('./typedef').Chapter} Chapter
- * @typedef {import('./typedef').Episode} Episode
- * @typedef {import('./typedef').Resource} Resource
- * @typedef {import('./typedef').Segment} Segment
- * @typedef {import('./typedef').Show} Show
- * @typedef {import('./typedef').Subtitle} Subtitle
- * @typedef {import('./typedef').TimeInterval} TimeInterval
- * @typedef {import('./typedef').Topic} Topic
- * @typedef {import('./typedef').MainResource} MainResource
- */
-
 const Play$4 = "Wiedergabe";
 const Pause$4 = "Pause";
 const Replay$4 = "Erneut abspielen";
@@ -3562,6 +3591,10 @@ pillarbox.addLanguage('rm', _objectSpread2({}, pillarboxLang));
 const _excluded = ["url", "mimeType", "keySystems"],
   _excluded2 = ["src"];
 
+/** @import Player from 'video.js/dist/types/player' */
+/** @import {Chapter, MainResource, Segment, Subtitle, TimeInterval} from '../dataProvider/model/typedef' */
+/** @import {ComposedSrcMediaData, MainResourceWithKeySystems} from './typedef' */
+
 /**
  * @class SrgSsr
  */
@@ -3569,8 +3602,8 @@ class SrgSsr {
   /**
    * Adds blocked segments to the player.
    *
-   * @param {import('video.js/dist/types/player').default} player
-   * @param {Array<import('../dataProvider/model/typedef').Segment>} [segments=[]]
+   * @param {Player} player
+   * @param {Array<Segment>} [segments=[]]
    */
   static addBlockedSegments(player, segments = []) {
     const trackId = 'srgssr-blocked-segments';
@@ -3592,8 +3625,8 @@ class SrgSsr {
   /**
    * Adds remote text tracks from an array of subtitles.
    *
-   * @param {import('video.js/dist/types/player').default} player
-   * @param {Array<import('../dataProvider/model/typedef').Subtitle>} [subtitles=[]]
+   * @param {Player} player
+   * @param {Array<Subtitle>} [subtitles=[]]
    */
   static addRemoteTextTracks(player, subtitles = []) {
     if (!Array.isArray(subtitles)) return;
@@ -3617,9 +3650,9 @@ class SrgSsr {
    *
    * @param {TextTrack} textTrack
    * @param {
-   *   import('../dataProvider/model/typedef').Segment |
-   *   import('../dataProvider/model/typedef').Chapter |
-   *   import('../dataProvider/model/typedef').TimeInterval
+   *   Segment |
+   *   Chapter |
+   *   TimeInterval
    * } data SRG SSR's cue-like representation
    */
   static addTextTrackCue(textTrack, data) {
@@ -3631,8 +3664,8 @@ class SrgSsr {
   /**
    * Add multiple text tracks to the player.
    *
-   * @param {import('video.js/dist/types/player').default} player
-   * @param {import('./typedef').ComposedSrcMediaData} srcMediaObj
+   * @param {Player} player
+   * @param {ComposedSrcMediaData} srcMediaObj
    */
   static addTextTracks(player, {
     mediaData
@@ -3646,9 +3679,9 @@ class SrgSsr {
   /**
    * Adds chapters to the player.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    * @param {string} chapterUrn The URN of the main chapter.
-   * @param {Array.<import('../dataProvider/model/typedef').Chapter>} [chapters=[]]
+   * @param {Array.<Chapter>} [chapters=[]]
    */
   static addChapters(player, chapterUrn, chapters = []) {
     const trackId = 'srgssr-chapters';
@@ -3669,8 +3702,8 @@ class SrgSsr {
   /**
    * Adds intervals to the player.
    *
-   * @param {import('video.js/dist/types/player').default} player
-   * @param {Array.<import('../dataProvider/model/typedef').TimeInterval>} [intervals=[]]
+   * @param {Player} player
+   * @param {Array.<TimeInterval>} [intervals=[]]
    */
   static addIntervals(player, intervals = []) {
     const trackId = 'srgssr-intervals';
@@ -3691,8 +3724,8 @@ class SrgSsr {
    * Set a blocking reason according to the block reason returned
    * by mediaData.
    *
-   * @param {import('video.js/dist/types/player').default} player
-   * @param {import('./typedef').ComposedSrcMediaData} srcMediaObj
+   * @param {Player} player
+   * @param {ComposedSrcMediaData} srcMediaObj
    *
    * @returns {undefined|Boolean}
    */
@@ -3715,9 +3748,9 @@ class SrgSsr {
    * if at least one of them has tokenType
    * set to Akamai.
    *
-   * @param {Array.<import('./typedef').MainResourceWithKeySystems>} resources
+   * @param {Array.<MainResourceWithKeySystems>} resources
    *
-   * @returns {Promise<Array.<import('./typedef').MainResourceWithKeySystems>>}
+   * @returns {Promise<Array.<MainResourceWithKeySystems>>}
    */
   static composeAkamaiResources(resources = []) {
     return _asyncToGenerator(function* () {
@@ -3734,9 +3767,9 @@ class SrgSsr {
    * Add the keySystems property to all resources
    * if at least one of them has DRM.
    *
-   * @param {Array.<import('../dataProvider/model/typedef').MainResource>} resources
+   * @param {Array.<MainResource>} resources
    *
-   * @returns {Array.<import('./typedef').MainResourceWithKeySystems>}
+   * @returns {Array.<MainResourceWithKeySystems>}
    */
   static composeKeySystemsResources(resources = []) {
     if (!Drm.hasDrm(resources)) return resources;
@@ -3750,7 +3783,7 @@ class SrgSsr {
    *
    * @param {MediaComposition} mediaComposition
    *
-   * @returns {Promise<Array.<import('./typedef').MainResourceWithKeySystems>>}
+   * @returns {Promise<Array.<MainResourceWithKeySystems>>}
    */
   static composeMainResources(mediaComposition) {
     return SrgSsr.composeAkamaiResources(SrgSsr.composeKeySystemsResources(SrgSsr.filterIncompatibleResources(mediaComposition.getMainResources())));
@@ -3763,9 +3796,9 @@ class SrgSsr {
    * @param {any} srcObj
    * @param {any} srcObj.mediaData overrides or adds metadata to the composed mediaData.
    * @param {boolean} srcObj.disableTrackers
-   * @param {import('./typedef').MainResourceWithKeySystems} resource
+   * @param {MainResourceWithKeySystems} resource
    *
-   * @returns {import('./typedef').ComposedSrcMediaData}
+   * @returns {ComposedSrcMediaData}
    */
   static composeSrcMediaData({
     mediaData: srcMediaData,
@@ -3790,7 +3823,7 @@ class SrgSsr {
   /**
    * Create a new metadata text track.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    * @param {String} trackId Text track unique ID
    *
    * @returns {Promise<TextTrack>}
@@ -3812,7 +3845,7 @@ class SrgSsr {
   /**
    * Proxy SRG SSR chapters and intervals cuechange events at player level.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    */
   static cuechangeEventProxy(player) {
     player.textTracks().on('addtrack', ({
@@ -3833,7 +3866,7 @@ class SrgSsr {
   /**
    * SRG SSR data provider singleton.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    *
    * @returns {DataProvider}
    */
@@ -3857,7 +3890,7 @@ class SrgSsr {
   /**
    * Set an error if something goes wrong with the data provider.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    * @param {Object} error
    *
    * @returns {undefined|true}
@@ -3882,7 +3915,7 @@ class SrgSsr {
   /**
    * Set player error.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    * @param {Object} error
    */
   static error(player, {
@@ -3901,9 +3934,9 @@ class SrgSsr {
   /**
    * Filter out incompatible resources such as `RTMP` and `HDS`.
    *
-   * @param {Array.<import('../dataProvider/model/typedef').MainResource>} resources Resources to filter
+   * @param {Array.<MainResource>} resources Resources to filter
    *
-   * @returns {Array.<import('../dataProvider/model/typedef').MainResource>} The filtered resources
+   * @returns {Array.<MainResource>} The filtered resources
    */
   static filterIncompatibleResources(resources = []) {
     return resources.filter(resource => !['RTMP', 'HDS'].includes(resource.streaming));
@@ -3912,7 +3945,7 @@ class SrgSsr {
   /**
    * Get the current blocked segment from the player.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    *
    * @returns {VTTCue|undefined} The blocked segment cue object, or undefined
    */
@@ -3929,7 +3962,7 @@ class SrgSsr {
   /**
    * Get the VTT cue of a blocked segment.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    * @param {Number} currentTime
    *
    * @returns {VTTCue|undefined} The VTT cue of a blocked segment, or undefined
@@ -3959,9 +3992,9 @@ class SrgSsr {
   /**
    * Get the mediaData most likely to be compatible depending on the browser.
    *
-   * @param {Array.<import('./typedef').MainResourceWithKeySystems>} resources
+   * @param {Array.<MainResourceWithKeySystems>} resources
    *
-   * @returns {import('./typedef').MainResourceWithKeySystems} By default, the first entry is used if none is compatible.
+   * @returns {MainResourceWithKeySystems} By default, the first entry is used if none is compatible.
    */
   static getMediaData(resources = []) {
     if (AkamaiTokenService.hasToken(resources)) return resources[0];
@@ -3975,10 +4008,10 @@ class SrgSsr {
   /**
    * Get the source media object.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    * @param {any} srcObj
    *
-   * @returns {Promise<import('./typedef').ComposedSrcMediaData>} - The composed source media data.
+   * @returns {Promise<ComposedSrcMediaData>} - The composed source media data.
    */
   static getSrcMediaObj(player, srcObj) {
     return _asyncToGenerator(function* () {
@@ -4010,7 +4043,7 @@ class SrgSsr {
    * _Note_: This function should disappear as soon as this behavior is
    *         supported on the packaging side.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    * @param {number} currentTime
    *
    * @returns {number}
@@ -4042,7 +4075,7 @@ class SrgSsr {
    * _Note_: This function should disappear as soon as this behavior is
    *         supported on the packaging side.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    * @param {number} currentTime
    *
    * @returns {number}
@@ -4064,7 +4097,7 @@ class SrgSsr {
    * - handle blocking reasons
    * - add remote subtitles
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    * @param {any} srcObj
    * @param {function} next
    *
@@ -4090,7 +4123,7 @@ class SrgSsr {
   /**
    * SRG SSR analytics singleton.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    */
   static srgAnalytics(player) {
     if (player.options().trackers.srgAnalytics === false) return;
@@ -4111,7 +4144,7 @@ class SrgSsr {
   /**
    * PillarboxMonitoring monitoring singleton.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    *
    * @returns {PillarboxMonitoring} instance of PillarboxMonitoring
    */
@@ -4135,8 +4168,8 @@ class SrgSsr {
   /**
    * Update player's poster.
    *
-   * @param {import('video.js/dist/types/player').default} player
-   * @param {import('./typedef').ComposedSrcMediaData} srcMediaObj
+   * @param {Player} player
+   * @param {ComposedSrcMediaData} srcMediaObj
    * @param {Image} imageService
    */
   static updatePoster(player, srcMediaObj, imageService = Image) {
@@ -4148,8 +4181,8 @@ class SrgSsr {
   /**
    * Update player titleBar with title and description.
    *
-   * @param {import('video.js/dist/types/player').default} player
-   * @param {import('./typedef').ComposedSrcMediaData} srcMediaObj
+   * @param {Player} player
+   * @param {ComposedSrcMediaData} srcMediaObj
    */
   static updateTitleBar(player, srcMediaObj) {
     if (!player.titleBar) return;
@@ -4162,7 +4195,7 @@ class SrgSsr {
   /**
    * Middleware to resolve SRG SSR URNs into playable media.
    *
-   * @param {import('video.js/dist/types/player').default} player
+   * @param {Player} player
    *
    * @returns {Object}
    */