react-native-theoplayer 11.1.0 → 11.2.1

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.1.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [11.2.1] - 26-06-09
+
+### Fixed
+
+- Fixed an issue on iOS where setting the targetVideoQuality uids was causing a crash due to an unsafe bounds-check.
+
+## [11.2.0] - 26-06-04
+
+### Added
+
+- Added support for `CustomAdIntegrationKind`, allowing custom ad integrations on top of the player API.
+- Added support for `breakManifestUrl` for OptiView Ads streams.
+
 ## [11.1.0] - 26-05-27
 
 ### Added

package/android/build.gradle

@@ -126,8 +126,8 @@ repositories {
     mavenLocal()
 }
 
-// The minimum supported THEOplayer version is 11.0.0
-def theoVersion = safeExtGet('THEOplayer_sdk', '[11.0.0, 12.0.0)')
+// The minimum supported THEOplayer version is 11.4.0
+def theoVersion = safeExtGet('THEOplayer_sdk', '[11.4.0, 12.0.0)')
 def theoMediaSessionVersion = safeExtGet('THEOplayer_mediasession', '[11.0.0, 12.0.0)')
 def theoAdsWrapperVersion = "11.0.0"
 def coroutinesVersion = safeExtGet('coroutinesVersion', '1.10.2')

package/android/src/main/java/com/theoplayer/ads/AdsModule.kt

@@ -45,7 +45,7 @@ class AdsModule(context: ReactApplicationContext) : ReactContextBaseJavaModule(c
   fun schedule(tag: Int, ad: ReadableMap) {
     viewResolver.resolveViewByTag(tag) { view: ReactTHEOplayerView? ->
       try {
-        view?.adsApi?.schedule(sourceHelper.parseAdFromJS(ad))
+        view?.adsApi?.schedule(sourceHelper.parseAdDescriptionFromJS(ad))
       } catch (exception: THEOplayerException) {
         Log.e(NAME, exception.message ?: ERR_SCHEDULE_AD)
       }

package/android/src/main/java/com/theoplayer/source/SourceAdapter.kt

@@ -23,6 +23,7 @@ import com.theoplayer.android.api.ads.theoads.TheoAdsLayoutOverride
 import com.theoplayer.android.api.cmcd.CMCDTransmissionMode
 import com.theoplayer.android.api.error.ErrorCode
 import com.theoplayer.android.api.source.AdIntegration
+import com.theoplayer.android.api.source.addescription.CustomAdDescriptionRegistry
 import com.theoplayer.android.api.source.dash.DashPlaybackConfiguration
 import com.theoplayer.android.api.theolive.PlayoutDelay
 import com.theoplayer.android.api.theolive.TheoLiveSource
@@ -73,6 +74,7 @@ private const val PROP_RETRIEVE_POD_ID_URI = "retrievePodIdURI"
 private const val PROP_INITIALIZATION_DELAY = "initializationDelay"
 private const val PROP_SSE_ENDPOINT = "sseEndpoint"
 private const val PROP_STREAM_ACTIVITY_MONITOR_ID = "streamActivityMonitorId"
+private const val PROP_BREAK_MANIFEST_URL = "breakManifestUrl"
 private const val PROP_LATENCY_CONFIGURATION = "latencyConfiguration"
 private const val PROP_PROFILE = "profile"
 private const val PROP_WEBRTC: String = "webrtc"
@@ -82,8 +84,8 @@ private const val PROP_PLAYOUT_DELAY_MAX: String = "maximum"
 
 private const val ERROR_IMA_NOT_ENABLED = "Google IMA support not enabled."
 private const val ERROR_THEOADS_NOT_ENABLED = "THEOads support not enabled."
-private const val ERROR_UNSUPPORTED_CSAI_INTEGRATION = "Unsupported CSAI integration"
-private const val ERROR_MISSING_CSAI_INTEGRATION = "Missing CSAI integration"
+private const val ERROR_UNSUPPORTED_AD_INTEGRATION = "Unsupported Ad integration"
+private const val ERROR_MISSING_AD_INTEGRATION = "Missing Ad integration"
 
 private const val PROP_SSAI_INTEGRATION_GOOGLE_DAI = "google-dai"
 
@@ -151,7 +153,9 @@ class SourceAdapter {
           val jsonAdDescription = jsonAds[i] as JSONObject
 
           // Currently only ima-ads are supported.
-          ads.add(parseAdFromJS(jsonAdDescription))
+          parseAdDescriptionFromJS(jsonAdDescription)?.let {
+            ads.add(it)
+          }
         }
       }
 
@@ -278,16 +282,6 @@ class SourceAdapter {
     }
   }
 
-  @Throws(THEOplayerException::class)
-  fun parseAdFromJS(map: ReadableMap): AdDescription? {
-    return try {
-      parseAdFromJS(JSONObject(gson.toJson(map.toHashMap())))
-    } catch (e: JSONException) {
-      e.printStackTrace()
-      null
-    }
-  }
-
   private fun parseSourceType(jsonTypedSource: JSONObject): SourceType? {
     val type = jsonTypedSource.optString(PROP_TYPE)
     if (type.isNotEmpty()) {
@@ -308,30 +302,39 @@ class SourceAdapter {
     return null
   }
 
+  @Throws(THEOplayerException::class)
+  fun parseAdDescriptionFromJS(map: ReadableMap): AdDescription? {
+    return try {
+      parseAdDescriptionFromJS(JSONObject(gson.toJson(map.toHashMap())))
+    } catch (e: JSONException) {
+      e.printStackTrace()
+      null
+    }
+  }
+
   @Throws(JSONException::class, THEOplayerException::class)
-  fun parseAdFromJS(jsonAdDescription: JSONObject): AdDescription {
+  fun parseAdDescriptionFromJS(jsonAdDescription: JSONObject): AdDescription? {
     val integrationStr = jsonAdDescription.optString(PROP_INTEGRATION)
     return if (!TextUtils.isEmpty(integrationStr)) {
       when (integrationStr) {
-        AdIntegration.GOOGLE_IMA.adIntegration -> parseImaAdFromJS(jsonAdDescription)
-        AdIntegration.THEO_ADS.adIntegration -> parseTheoAdFromJS(jsonAdDescription)
-        else -> {
-          throw THEOplayerException(
+        AdIntegration.GOOGLE_IMA.adIntegration -> parseImaAdDescriptionFromJS(jsonAdDescription)
+        AdIntegration.THEO_ADS.adIntegration -> parseTheoAdDescriptionFromJS(jsonAdDescription)
+        else ->
+          CustomAdDescriptionRegistry.deserialize(integrationStr, jsonAdDescription.toString()) ?: throw THEOplayerException(
             ErrorCode.AD_ERROR,
-            "$ERROR_UNSUPPORTED_CSAI_INTEGRATION: $integrationStr"
+            "$ERROR_UNSUPPORTED_AD_INTEGRATION: $integrationStr"
           )
-        }
       }
     } else {
       throw THEOplayerException(
         ErrorCode.AD_ERROR,
-        "$ERROR_MISSING_CSAI_INTEGRATION: $integrationStr"
+        "$ERROR_MISSING_AD_INTEGRATION: $integrationStr"
       )
     }
   }
 
   @Throws(THEOplayerException::class)
-  private fun parseImaAdFromJS(jsonAdDescription: JSONObject): GoogleImaAdDescription {
+  private fun parseImaAdDescriptionFromJS(jsonAdDescription: JSONObject): GoogleImaAdDescription {
     if (!BuildConfig.EXTENSION_GOOGLE_IMA) {
       throw THEOplayerException(ErrorCode.AD_ERROR, ERROR_IMA_NOT_ENABLED)
     }
@@ -349,7 +352,7 @@ class SourceAdapter {
   }
 
   @Throws(JSONException::class)
-  private fun parseTheoAdFromJS(jsonAdDescription: JSONObject): TheoAdDescription {
+  private fun parseTheoAdDescriptionFromJS(jsonAdDescription: JSONObject): TheoAdDescription {
     if (!BuildConfig.EXTENSION_THEOADS) {
       throw THEOplayerException(ErrorCode.AD_ERROR, ERROR_THEOADS_NOT_ENABLED)
     }
@@ -366,6 +369,7 @@ class SourceAdapter {
       initializationDelay = jsonAdDescription.optDouble(PROP_INITIALIZATION_DELAY).takeIf { it.isFinite() },
       sseEndpoint = jsonAdDescription.optString(PROP_SSE_ENDPOINT).takeIf { it.isNotEmpty() },
       streamActivityMonitorId = jsonAdDescription.optString(PROP_STREAM_ACTIVITY_MONITOR_ID).takeIf { it.isNotEmpty() },
+      breakManifestUrl = jsonAdDescription.optString(PROP_BREAK_MANIFEST_URL).takeIf { it.isNotEmpty() },
     )
   }
 
@@ -376,9 +380,9 @@ class SourceAdapter {
 
   private fun parseOverrideLayout(override: String?): TheoAdsLayoutOverride? {
     return when (override) {
-      "single", "single-if-mobile" -> return TheoAdsLayoutOverride.SINGLE
-      "l-shape" -> return TheoAdsLayoutOverride.LSHAPE
-      "double" -> return TheoAdsLayoutOverride.DOUBLE
+      "single", "single-if-mobile" -> TheoAdsLayoutOverride.SINGLE
+      "l-shape" -> TheoAdsLayoutOverride.LSHAPE
+      "double" -> TheoAdsLayoutOverride.DOUBLE
       else -> null
     }
   }
@@ -395,11 +399,11 @@ class SourceAdapter {
 
   private fun parseTextTrackKind(kind: String?): TextTrackKind? {
     return when (kind) {
-      "subtitles" -> return TextTrackKind.SUBTITLES
-      "metadata" -> return TextTrackKind.METADATA
-      "captions" -> return TextTrackKind.CAPTIONS
-      "chapters" -> return TextTrackKind.CHAPTERS
-      "descriptions" -> return TextTrackKind.DESCRIPTIONS
+      "subtitles" -> TextTrackKind.SUBTITLES
+      "metadata" -> TextTrackKind.METADATA
+      "captions" -> TextTrackKind.CAPTIONS
+      "chapters" -> TextTrackKind.CHAPTERS
+      "descriptions" -> TextTrackKind.DESCRIPTIONS
       else -> null
     }
   }

package/ios/THEOplayerRCTPlayerAPI.swift

@@ -281,11 +281,13 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
                let player = theView.player {
                 let uidValue = uid.intValue
                 let textTracks: TextTrackList = player.textTracks
-                guard textTracks.count > 0 else {
+                let textTrackCount = textTracks.count
+                guard textTrackCount > 0 else {
                     return
                 }
                 if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] Showing textTrack \(uidValue) on TheoPlayer") }
-                for i in 0...textTracks.count-1 {
+                for i in 0..<textTrackCount {
+                    guard i < textTracks.count else { break }
                     let textTrack: TextTrack = textTracks.get(i)
                     if textTrack.uid == uidValue {
                         textTrack.mode = TextTrackMode.showing
@@ -304,11 +306,13 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
                let player = theView.player {
                 let uidValue = uid.intValue
                 let audioTracks: AudioTrackList = player.audioTracks
-                guard audioTracks.count > 0 else {
+                let audioTrackCount = audioTracks.count
+                guard audioTrackCount > 0 else {
                     return
                 }
                 if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] Enabling audioTrack \(uidValue) on TheoPlayer") }
-                for i in 0...audioTracks.count-1 {
+                for i in 0..<audioTrackCount {
+                    guard i < audioTracks.count else { break }
                     let audioTrack: MediaTrack = audioTracks.get(i)
                     audioTrack.enabled = (audioTrack.uid == uidValue)
                 }
@@ -323,11 +327,13 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
                let player = theView.player {
                 let uidValue = uid.intValue
                 let videoTracks: VideoTrackList = player.videoTracks
-                guard videoTracks.count > 0 else {
+                let videoTrackCount = videoTracks.count
+                guard videoTrackCount > 0 else {
                     return
                 }
                 if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] Enabling videoTrack \(uidValue) on TheoPlayer") }
-                for i in 0...videoTracks.count-1 {
+                for i in 0..<videoTrackCount {
+                    guard i < videoTracks.count else { break }
                     let videoTrack: MediaTrack = videoTracks.get(i)
                     videoTrack.enabled = (videoTrack.uid == uidValue)
                 }
@@ -341,23 +347,39 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
             if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView,
                let player = theView.player {
                 let videoTracks: VideoTrackList = player.videoTracks
-                guard videoTracks.count > 0 else {
+                let videoTrackCount = videoTracks.count
+                guard videoTrackCount > 0 else {
                     return
                 }
                 var activeVideoTrack: VideoTrack?
-                for i in 0...videoTracks.count-1 {
+                for i in 0..<videoTrackCount {
+                    guard i < videoTracks.count else { break }
                     let videoTrack: MediaTrack = videoTracks.get(i)
                     if videoTrack.enabled {
                         activeVideoTrack = videoTrack as? VideoTrack
                     }
                 }
                 if let foundTrack = activeVideoTrack {
-                    let matchingQualities = (0..<foundTrack.qualities.count).compactMap { index in
+                    let requestedBandwidths = Set(uids.map { $0.intValue })
+                    let currentBandwidths = Set(foundTrack.targetQualities?.map { $0.bandwidth } ?? [])
+                    guard requestedBandwidths != currentBandwidths else {
+                        if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] targetQualities: \(uids) already set on active videotrack. Skipping update.") }
+                        return
+                    }
+                    let qualityCount = foundTrack.qualities.count
+                    let matchingQualities = (0..<qualityCount).compactMap { index -> Quality? in
+                        guard index < foundTrack.qualities.count else { return nil }
                         let quality = foundTrack.qualities.get(index)
-                        return uids.contains { $0.intValue == quality.bandwidth } ? quality : nil
+                        return uids.contains(where: { $0.intValue == quality.bandwidth }) ? quality : nil
+                    }
+                    foundTrack.targetQualities = matchingQualities.isEmpty ? nil : matchingQualities
+                    if DEBUG_PLAYER_API {
+                        if matchingQualities.count > 0 {
+                            PrintUtils.printLog(logText: "[NATIVE] targetQualities: \(uids) set on active videotrack. (matching: \(matchingQualities.map(\.bandwidth)))")
+                        } else {
+                            PrintUtils.printLog(logText: "[NATIVE] targetQualities: \(uids) set on active videotrack. (no match or empty) => no quality restriction.")
+                        }
                     }
-                    foundTrack.targetQualities = matchingQualities
-                    if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] targetQualities: \(uids) set on active videotrack.") }
                 }
             }
         }

package/ios/THEOplayerRCTSourceDescriptionBuilder.swift

@@ -62,6 +62,7 @@ let SD_PROP_USE_ID3: String = "useId3"
 let SD_PROP_RETRIEVE_POD_ID_URI: String = "retrievePodIdURI"
 let SD_PROP_INITIALIZATION_DELAY: String = "initializationDelay"
 let SD_PROP_HLS_DATE_RANGE: String = "hlsDateRange"
+let SD_PROP_BREAK_MANIFEST_URL: String = "breakManifestUrl"
 let SD_PROP_CMCD: String = "cmcd"
 let SD_PROP_QUERY_PARAMETERS: String = "queryParameters"
 
@@ -90,7 +91,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
         guard let sourcesData = sourceData[SD_PROP_SOURCES] else {
             return (nil, nil)
         }
-        
+
 #if os(iOS)
         if let metadataData = sourceData[SD_PROP_METADATA] as? [String:Any],
            let cachingTaskId = metadataData[SD_PROP_METADATA_CACHINGTASK_ID] as? String {
@@ -164,7 +165,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
         if let metadataData = sourceData[SD_PROP_METADATA] as? [String:Any] {
             metadataDescription = THEOplayerRCTSourceDescriptionBuilder.buildMetaDataDescription(metadataData)
         }
-      
+
         // 6. configure CMCD
         let cmcd = sourceData[SD_PROP_CMCD] as? [String:Any]
         if cmcd != nil {
@@ -179,7 +180,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
                                  ads: adsDescriptions,
                                  poster: poster,
                                  metadata: metadataDescription)
-        
+
         return (sourceDescription, metadataAndChapterTrackDescriptions)
     }
 
@@ -193,7 +194,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
         let contentProtection = extractDrmConfiguration(from: typedSourceData)
         let integration = typedSourceData[SD_PROP_INTEGRATION] as? String
         let type = typedSourceData[SD_PROP_TYPE] as? String
-        
+
         if integration == "theolive" || type == "theolive" {
             return THEOplayerRCTSourceDescriptionBuilder.buildTHEOliveDescription(typedSourceData, contentProtection: contentProtection)
         }
@@ -247,7 +248,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
             let textTrackFormat = THEOplayerRCTSourceDescriptionBuilder.extractTextTrackFormat(textTracksData[SD_PROP_FORMAT] as? String)
             let textTrackPTS = textTracksData[SD_PROP_PTS] as? String
             let textTrackLocalTime = textTracksData[SD_PROP_LOCALTIME] as? String ?? "00:00:00.000"
-            
+
 #if canImport(THEOplayerConnectorSideloadedSubtitle)
             let ttDescription = SSTextTrackDescription(src: textTrackSrc,
                                                        srclang: textTrackSrcLang,
@@ -345,7 +346,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
      */
     static func buildContentProtection(_ contentProtectionData: [String:Any]) -> MultiplatformDRMConfiguration? {
         let customIntegrationId = contentProtectionData[SD_PROP_INTEGRATION] as? String ?? "internal"
-        
+
         // fairplay
         var fairplayKeySystem: THEOplayerSDK.KeySystemConfiguration? = nil
         if let fairplayData = contentProtectionData[SD_PROP_FAIRPLAY] as? [String:Any] {
@@ -363,7 +364,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
                     queryParameters[key] = "\(value)"
                 }
             }
-                
+
             fairplayKeySystem = KeySystemConfiguration(
                 licenseAcquisitionURL: licenseAcquisitionURL,
                 certificateURL: certificateUrl,
@@ -372,7 +373,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
                 queryParameters: queryParameters
             )
         }
-        
+
         // widevine
         var widevineKeySystem: THEOplayerSDK.KeySystemConfiguration? = nil
         if let widevineData = contentProtectionData[SD_PROP_WIDEVINE] as? [String:Any] {
@@ -390,7 +391,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
                     queryParameters[key] = "\(value)"
                 }
             }
-                
+
             widevineKeySystem = KeySystemConfiguration(
                 licenseAcquisitionURL: licenseAcquisitionURL,
                 certificateURL: certificateUrl,
@@ -399,7 +400,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
                 queryParameters: queryParameters
             )
         }
-        
+
         // global query parameters
         var queryParameters: [String: String] = [:]
         if let allQueryParams = contentProtectionData[SD_PROP_QUERY_PARAMETERS] as? [String:Any] {
@@ -408,7 +409,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
             }
         }
         let integrationParameters = contentProtectionData[SD_PROP_INTEGRATION_PARAMETERS] as? [String:Any] ?? [:]
-        
+
         return MultiplatformDRMConfiguration(
             customIntegrationId: customIntegrationId,
             integrationParameters: integrationParameters,

package/ios/THEOplayerRCTTrackMetadataAggregator.swift

@@ -56,10 +56,12 @@ class THEOplayerRCTTrackMetadataAggregator {
     // MARK: TEXTTRACKS
     class func aggregatedTextTrackListInfo(textTracks: TextTrackList, metadataTracks: [[String:Any]], player: THEOplayer) -> [[String:Any]] {
         var trackEntries:[[String:Any]] = metadataTracks
-        guard textTracks.count > 0 else {
+        let textTrackCount = textTracks.count
+        guard textTrackCount > 0 else {
             return trackEntries
         }
-        for i in 0...textTracks.count-1 {
+        for i in 0..<textTrackCount {
+            guard i < textTracks.count else { break }
             let textTrack: TextTrack = textTracks.get(i)
             trackEntries.append(THEOplayerRCTTrackMetadataAggregator.aggregatedTextTrackInfo(textTrack: textTrack, player: player))
         }
@@ -90,10 +92,12 @@ class THEOplayerRCTTrackMetadataAggregator {
     }
     
     private class func selectedTextTrack(textTracks: TextTrackList) -> Int {
-        guard textTracks.count > 0 else {
+        let textTrackCount = textTracks.count
+        guard textTrackCount > 0 else {
             return 0
         }
-        for i in 0...textTracks.count-1 {
+        for i in 0..<textTrackCount {
+            guard i < textTracks.count else { break }
             let textTrack: TextTrack = textTracks.get(i)
             if textTrack.mode == TextTrackMode.showing {
                 return textTrack.uid
@@ -160,10 +164,12 @@ class THEOplayerRCTTrackMetadataAggregator {
     // MARK: AUDIOTRACKS
     private class func aggregatedAudioTrackListInfo(audioTracks: AudioTrackList) -> [[String:Any]] {
         var audioTrackEntries:[[String:Any]] = []
-        guard audioTracks.count > 0 else {
+        let audioTrackCount = audioTracks.count
+        guard audioTrackCount > 0 else {
             return audioTrackEntries
         }
-        for i in 0...audioTracks.count-1 {
+        for i in 0..<audioTrackCount {
+            guard i < audioTracks.count else { break }
             let audioTrack: MediaTrack = audioTracks.get(i) // should be casted to AudioTrack
             audioTrackEntries.append(THEOplayerRCTTrackMetadataAggregator.aggregatedAudioTrackInfo(audioTrack: audioTrack))
         }
@@ -181,7 +187,9 @@ class THEOplayerRCTTrackMetadataAggregator {
         entry[PROP_ENABLED] = audioTrack.enabled
         
         // add known qualities
-        entry[PROP_QUALITIES] = (0..<audioTrack.qualities.count).map { index in
+        let audioQualityCount = audioTrack.qualities.count
+        entry[PROP_QUALITIES] = (0..<audioQualityCount).compactMap { index -> [String:Any]? in
+            guard index < audioTrack.qualities.count else { return nil }
             return THEOplayerRCTTrackMetadataAggregator.aggregatedQualityInfo(quality: audioTrack.qualities.get(index))
         }
         
@@ -193,10 +201,12 @@ class THEOplayerRCTTrackMetadataAggregator {
     }
     
     private class func selectedAudioTrack(audioTracks: AudioTrackList) -> Int {
-        guard audioTracks.count > 0 else {
+        let audioTrackCount = audioTracks.count
+        guard audioTrackCount > 0 else {
             return 0
         }
-        for i in 0...audioTracks.count-1 {
+        for i in 0..<audioTrackCount {
+            guard i < audioTracks.count else { break }
             let audioTrack: MediaTrack = audioTracks.get(i)
             if audioTrack.enabled {
                 return audioTrack.uid
@@ -208,10 +218,12 @@ class THEOplayerRCTTrackMetadataAggregator {
     // MARK: VIDEOTRACKS
     private class func aggregatedVideoTrackListInfo(videoTracks: VideoTrackList) -> [[String:Any]] {
         var videoTrackEntries:[[String:Any]] = []
-        guard videoTracks.count > 0 else {
+        let videoTrackCount = videoTracks.count
+        guard videoTrackCount > 0 else {
             return videoTrackEntries
         }
-        for i in 0...videoTracks.count-1 {
+        for i in 0..<videoTrackCount {
+            guard i < videoTracks.count else { break }
             if let videoTrack: VideoTrack = videoTracks.get(i) as? VideoTrack {
                 videoTrackEntries.append(THEOplayerRCTTrackMetadataAggregator.aggregatedVideoTrackInfo(videoTrack: videoTrack))
             }
@@ -230,7 +242,9 @@ class THEOplayerRCTTrackMetadataAggregator {
         entry[PROP_ENABLED] = videoTrack.enabled
         
         // add known qualities
-        entry[PROP_QUALITIES] = (0..<videoTrack.qualities.count).map { index in
+        let videoQualityCount = videoTrack.qualities.count
+        entry[PROP_QUALITIES] = (0..<videoQualityCount).compactMap { index -> [String:Any]? in
+            guard index < videoTrack.qualities.count else { return nil }
             return THEOplayerRCTTrackMetadataAggregator.aggregatedQualityInfo(quality: videoTrack.qualities.get(index))
         }
         
@@ -243,12 +257,14 @@ class THEOplayerRCTTrackMetadataAggregator {
     }
 
     private class func selectedVideoTrack(videoTracks: VideoTrackList) -> Int {
-        guard videoTracks.count > 0 else {
+        let videoTrackCount = videoTracks.count
+        guard videoTrackCount > 0 else {
             return 0
         }
-        for i in 0...videoTracks.count-1 {
+        for i in 0..<videoTrackCount {
+            guard i < videoTracks.count else { break }
             let videoTrack: MediaTrack = videoTracks.get(i)
-            if videoTracks.get(i).enabled {
+            if videoTrack.enabled {
                 return videoTrack.uid
             }
         }
@@ -274,7 +290,7 @@ class THEOplayerRCTTrackMetadataAggregator {
             "bandwidth": quality.bandwidth,
             "codecs": "",
             "id": identifier,
-            "uid": identifier,
+            "uid": quality.bandwidth,
             "name": label,
             "label": label,
             "available": true,

package/ios/ads/THEOplayerRCTSourceDescriptionBuilder+Ads.swift

@@ -6,6 +6,17 @@ import UIKit
 
 let SD_PROP_ADS: String = "ads"
 
+public class CustomAdDescription: AdDescription {
+    public let integration: THEOplayerSDK.AdIntegration? = AdIntegration.none
+    public let customIntegrationId: String
+    public let integrationData: [String: Any]
+  
+    public init(customIntegrationId: String, integrationData: [String: Any] = [:]) {
+        self.customIntegrationId = customIntegrationId
+        self.integrationData = integrationData
+    }
+}
+
 extension THEOplayerRCTSourceDescriptionBuilder {
 
     /**
@@ -24,11 +35,16 @@ extension THEOplayerRCTSourceDescriptionBuilder {
                         adsDescriptions?.append(adDescription)
                     } else {
                         if DEBUG_SOURCE_DESCRIPTION_BUILDER {
-                            PrintUtils.printLog(logText: "[NATIVE] Could not create THEOplayer GoogleImaAdDescription from adsData array")
+                            PrintUtils.printLog(logText: "[NATIVE] Could not create AdDescription from adsData")
                         }
-                        return nil
                     }
                 }
+                if adsDescriptions?.isEmpty == true {
+                    if DEBUG_SOURCE_DESCRIPTION_BUILDER {
+                        PrintUtils.printLog(logText: "[NATIVE] Could not create any AdDescription from adsData array")
+                    }
+                    return nil
+                }
             }
             // case: single ads object
             else if let adsData = ads as? [String:Any] {
@@ -36,7 +52,7 @@ extension THEOplayerRCTSourceDescriptionBuilder {
                     adsDescriptions?.append(adDescription)
                 } else {
                     if DEBUG_SOURCE_DESCRIPTION_BUILDER {
-                        PrintUtils.printLog(logText: "[NATIVE] Could not create THEOplayer GoogleImaAdDescription from adsData")
+                        PrintUtils.printLog(logText: "[NATIVE] Could not create AdDescription from adsData")
                     }
                     return nil
                 }
@@ -58,11 +74,22 @@ extension THEOplayerRCTSourceDescriptionBuilder {
             case "theoads":
                 return THEOplayerRCTSourceDescriptionBuilder.buildSingleTHEOadsDescription(adsData)
             default:
-                if DEBUG_SOURCE_DESCRIPTION_BUILDER  { PrintUtils.printLog(logText: "[NATIVE] We currently require and only support the 'google-ima' or 'sgai' integration in the 'ads' description.") }
+                return THEOplayerRCTSourceDescriptionBuilder.buildSingleCustomAdsDescription(adsData)
             }
         }
         return nil
     }
+  
+     /**
+      Creates a THEOplayer AdDescription, containing all passed properties.
+      - returns: a THEOplayer AdDescription
+     */
+    static func buildSingleCustomAdsDescription(_ adsData: [String:Any]) -> AdDescription? {
+        if let integration = adsData[SD_PROP_INTEGRATION] as? String {
+            return CustomAdDescription(customIntegrationId: integration, integrationData: adsData)
+        }
+        return nil
+    }
     
     /**
      Creates a THEOplayer GoogleImaAdDescription. This requires an ads property in the RN source description.

package/ios/theoAds/THEOplayerRCTSourceDescriptionBuilder+TheoAds.swift

@@ -50,7 +50,11 @@ extension THEOplayerRCTSourceDescriptionBuilder {
         let streamActivityMonitorId = adsData[SD_PROP_STREAM_ACTIVITY_MONITOR_ID_THEOADS] as? String
         let retrievePodIdURI = adsData[SD_PROP_RETRIEVE_POD_ID_URI] as? String
         let initializationDelay = adsData[SD_PROP_INITIALIZATION_DELAY] as? Double
-        
+        var breakManifestUrl: URL?
+        if let breakManifestUrlString = adsData[SD_PROP_BREAK_MANIFEST_URL] as? String {
+            breakManifestUrl = URL(string: breakManifestUrlString)
+        }
+
         return THEOAdDescription(networkCode: networkCode,
                                  customAssetKey: customAssetKey,
                                  backdropDoubleBox: backdropDoubleBox,
@@ -62,7 +66,8 @@ extension THEOplayerRCTSourceDescriptionBuilder {
                                  streamActivityMonitorId: streamActivityMonitorId,
                                  sseEndpoint: sseEndpoint,
                                  retrievePodIdURI: retrievePodIdURI,
-                                 initializationDelay: initializationDelay)
+                                 initializationDelay: initializationDelay,
+                                 breakManifestUrl: breakManifestUrl)
 #else
         return nil
 #endif

package/lib/commonjs/api/source/ads/Ads.js

@@ -56,4 +56,9 @@ let AdIntegrationKind = exports.AdIntegrationKind = /*#__PURE__*/function (AdInt
   AdIntegrationKind["theoads"] = "theoads";
   return AdIntegrationKind;
 }({});
+/**
+ * The identifier of a custom ad integration.
+ *
+ * @category Ads
+ */
 //# sourceMappingURL=Ads.js.map

package/lib/commonjs/api/source/ads/Ads.js.map

@@ -1 +1 @@
-{"version":3,"names":["AdIntegrationKind","exports"],"sourceRoot":"../../../../../src","sources":["api/source/ads/Ads.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;AAoDA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAfA,IAgBYA,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA","ignoreList":[]}
+{"version":3,"names":["AdIntegrationKind","exports"],"sourceRoot":"../../../../../src","sources":["api/source/ads/Ads.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;AAkDA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAfA,IAgBYA,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA;AAS7B;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/commonjs/api/source/ads/TheoAdDescription.js.map

@@ -1 +1 @@
-{"version":3,"names":["TheoAdsLayoutOverride","exports"],"sourceRoot":"../../../../../src","sources":["api/source/ads/TheoAdDescription.ts"],"mappings":";;;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAqGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AATA,IAUYA,qBAAqB,GAAAC,OAAA,CAAAD,qBAAA,0BAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAAA,OAArBA,qBAAqB;AAAA","ignoreList":[]}
+{"version":3,"names":["TheoAdsLayoutOverride","exports"],"sourceRoot":"../../../../../src","sources":["api/source/ads/TheoAdDescription.ts"],"mappings":";;;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AA6GA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AATA,IAUYA,qBAAqB,GAAAC,OAAA,CAAAD,qBAAA,0BAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAAA,OAArBA,qBAAqB;AAAA","ignoreList":[]}

package/lib/commonjs/internal/adapter/theolive/TheoLiveWebAdapter.js

@@ -13,17 +13,8 @@ class TheoLiveWebAdapter {
     return currentLatency ? Promise.resolve(currentLatency) : Promise.reject('latency not available');
   }
   get latencies() {
-    const webLatencies = this._player.hesp?.latencies;
-    if (webLatencies) {
-      return Promise.resolve({
-        engineLatency: webLatencies?.engine,
-        distributionLatency: webLatencies?.distribution,
-        playerLatency: webLatencies?.player,
-        theoliveLatency: webLatencies?.theolive
-      });
-    } else {
-      return Promise.reject('latencies not available');
-    }
+    console.warn('The THEOlive latencies metrics are not available');
+    return Promise.resolve({});
   }
   set authToken(token) {
     if (this._player.theoLive) {

package/lib/commonjs/internal/adapter/theolive/TheoLiveWebAdapter.js.map

@@ -1 +1 @@
-{"version":3,"names":["TheoLiveWebAdapter","constructor","_player","currentLatency","latency","Promise","resolve","reject","latencies","webLatencies","hesp","engineLatency","engine","distributionLatency","distribution","playerLatency","player","theoliveLatency","theolive","authToken","token","theoLive","exports"],"sourceRoot":"../../../../../src","sources":["internal/adapter/theolive/TheoLiveWebAdapter.ts"],"mappings":";;;;;;AAGO,MAAMA,kBAAkB,CAAwB;EACrDC,WAAWA,CAASC,OAAyB,EAAE;IAAA,KAA3BA,OAAyB,GAAzBA,OAAyB;EAAG;EAEhD,IAAIC,cAAcA,CAAA,EAAoB;IACpC,MAAMA,cAAc,GAAG,IAAI,CAACD,OAAO,CAACE,OAAO,CAACD,cAAc;IAC1D,OAAOA,cAAc,GAAGE,OAAO,CAACC,OAAO,CAACH,cAAc,CAAC,GAAGE,OAAO,CAACE,MAAM,CAAS,uBAAuB,CAAC;EAC3G;EAEA,IAAIC,SAASA,CAAA,EAA2B;IACtC,MAAMC,YAAY,GAAG,IAAI,CAACP,OAAO,CAACQ,IAAI,EAAEF,SAAS;IACjD,IAAIC,YAAY,EAAE;MAChB,OAAOJ,OAAO,CAACC,OAAO,CAAC;QACrBK,aAAa,EAAEF,YAAY,EAAEG,MAAM;QACnCC,mBAAmB,EAAEJ,YAAY,EAAEK,YAAY;QAC/CC,aAAa,EAAEN,YAAY,EAAEO,MAAM;QACnCC,eAAe,EAAER,YAAY,EAAES;MACjC,CAAC,CAAC;IACJ,CAAC,MAAM;MACL,OAAOb,OAAO,CAACE,MAAM,CAAgB,yBAAyB,CAAC;IACjE;EACF;EAEA,IAAIY,SAASA,CAACC,KAAa,EAAE;IAC3B,IAAI,IAAI,CAAClB,OAAO,CAACmB,QAAQ,EAAE;MACzB,IAAI,CAACnB,OAAO,CAACmB,QAAQ,CAACF,SAAS,GAAGC,KAAK;IACzC;EACF;EAEA,IAAID,SAASA,CAAA,EAAuB;IAClC,OAAO,IAAI,CAACjB,OAAO,CAACmB,QAAQ,EAAEF,SAAS;EACzC;AACF;AAACG,OAAA,CAAAtB,kBAAA,GAAAA,kBAAA","ignoreList":[]}
+{"version":3,"names":["TheoLiveWebAdapter","constructor","_player","currentLatency","latency","Promise","resolve","reject","latencies","console","warn","authToken","token","theoLive","exports"],"sourceRoot":"../../../../../src","sources":["internal/adapter/theolive/TheoLiveWebAdapter.ts"],"mappings":";;;;;;AAGO,MAAMA,kBAAkB,CAAwB;EACrDC,WAAWA,CAASC,OAAyB,EAAE;IAAA,KAA3BA,OAAyB,GAAzBA,OAAyB;EAAG;EAEhD,IAAIC,cAAcA,CAAA,EAAoB;IACpC,MAAMA,cAAc,GAAG,IAAI,CAACD,OAAO,CAACE,OAAO,CAACD,cAAc;IAC1D,OAAOA,cAAc,GAAGE,OAAO,CAACC,OAAO,CAACH,cAAc,CAAC,GAAGE,OAAO,CAACE,MAAM,CAAS,uBAAuB,CAAC;EAC3G;EAEA,IAAIC,SAASA,CAAA,EAA2B;IACtCC,OAAO,CAACC,IAAI,CAAC,kDAAkD,CAAC;IAChE,OAAOL,OAAO,CAACC,OAAO,CAAC,CAAC,CAAC,CAAC;EAC5B;EAEA,IAAIK,SAASA,CAACC,KAAa,EAAE;IAC3B,IAAI,IAAI,CAACV,OAAO,CAACW,QAAQ,EAAE;MACzB,IAAI,CAACX,OAAO,CAACW,QAAQ,CAACF,SAAS,GAAGC,KAAK;IACzC;EACF;EAEA,IAAID,SAASA,CAAA,EAAuB;IAClC,OAAO,IAAI,CAACT,OAAO,CAACW,QAAQ,EAAEF,SAAS;EACzC;AACF;AAACG,OAAA,CAAAd,kBAAA,GAAAA,kBAAA","ignoreList":[]}

package/lib/commonjs/manifest.json

@@ -1 +1 @@
-{"version":"11.1.0","buildDate":"2026-05-27T17:00:02.965Z"}
+{"version":"11.2.1","buildDate":"2026-06-09T13:34:42.726Z"}

package/lib/module/api/source/ads/Ads.js

@@ -55,4 +55,10 @@ export let AdIntegrationKind = /*#__PURE__*/function (AdIntegrationKind) {
   AdIntegrationKind["theoads"] = "theoads";
   return AdIntegrationKind;
 }({});
+
+/**
+ * The identifier of a custom ad integration.
+ *
+ * @category Ads
+ */
 //# sourceMappingURL=Ads.js.map

package/lib/module/api/source/ads/Ads.js.map

@@ -1 +1 @@
-{"version":3,"names":["AdIntegrationKind"],"sourceRoot":"../../../../../src","sources":["api/source/ads/Ads.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;;AAoDA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,WAAYA,iBAAiB,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA","ignoreList":[]}
+{"version":3,"names":["AdIntegrationKind"],"sourceRoot":"../../../../../src","sources":["api/source/ads/Ads.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;;AAkDA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,WAAYA,iBAAiB,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA;;AAS7B;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/module/api/source/ads/TheoAdDescription.js.map

@@ -1 +1 @@
-{"version":3,"names":["TheoAdsLayoutOverride"],"sourceRoot":"../../../../../src","sources":["api/source/ads/TheoAdDescription.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAqGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,WAAYA,qBAAqB,0BAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAAA,OAArBA,qBAAqB;AAAA","ignoreList":[]}
+{"version":3,"names":["TheoAdsLayoutOverride"],"sourceRoot":"../../../../../src","sources":["api/source/ads/TheoAdDescription.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA6GA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,WAAYA,qBAAqB,0BAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAAA,OAArBA,qBAAqB;AAAA","ignoreList":[]}

package/lib/module/internal/adapter/theolive/TheoLiveWebAdapter.js

@@ -9,17 +9,8 @@ export class TheoLiveWebAdapter {
     return currentLatency ? Promise.resolve(currentLatency) : Promise.reject('latency not available');
   }
   get latencies() {
-    const webLatencies = this._player.hesp?.latencies;
-    if (webLatencies) {
-      return Promise.resolve({
-        engineLatency: webLatencies?.engine,
-        distributionLatency: webLatencies?.distribution,
-        playerLatency: webLatencies?.player,
-        theoliveLatency: webLatencies?.theolive
-      });
-    } else {
-      return Promise.reject('latencies not available');
-    }
+    console.warn('The THEOlive latencies metrics are not available');
+    return Promise.resolve({});
   }
   set authToken(token) {
     if (this._player.theoLive) {

package/lib/module/internal/adapter/theolive/TheoLiveWebAdapter.js.map

@@ -1 +1 @@
-{"version":3,"names":["TheoLiveWebAdapter","constructor","_player","currentLatency","latency","Promise","resolve","reject","latencies","webLatencies","hesp","engineLatency","engine","distributionLatency","distribution","playerLatency","player","theoliveLatency","theolive","authToken","token","theoLive"],"sourceRoot":"../../../../../src","sources":["internal/adapter/theolive/TheoLiveWebAdapter.ts"],"mappings":";;AAGA,OAAO,MAAMA,kBAAkB,CAAwB;EACrDC,WAAWA,CAASC,OAAyB,EAAE;IAAA,KAA3BA,OAAyB,GAAzBA,OAAyB;EAAG;EAEhD,IAAIC,cAAcA,CAAA,EAAoB;IACpC,MAAMA,cAAc,GAAG,IAAI,CAACD,OAAO,CAACE,OAAO,CAACD,cAAc;IAC1D,OAAOA,cAAc,GAAGE,OAAO,CAACC,OAAO,CAACH,cAAc,CAAC,GAAGE,OAAO,CAACE,MAAM,CAAS,uBAAuB,CAAC;EAC3G;EAEA,IAAIC,SAASA,CAAA,EAA2B;IACtC,MAAMC,YAAY,GAAG,IAAI,CAACP,OAAO,CAACQ,IAAI,EAAEF,SAAS;IACjD,IAAIC,YAAY,EAAE;MAChB,OAAOJ,OAAO,CAACC,OAAO,CAAC;QACrBK,aAAa,EAAEF,YAAY,EAAEG,MAAM;QACnCC,mBAAmB,EAAEJ,YAAY,EAAEK,YAAY;QAC/CC,aAAa,EAAEN,YAAY,EAAEO,MAAM;QACnCC,eAAe,EAAER,YAAY,EAAES;MACjC,CAAC,CAAC;IACJ,CAAC,MAAM;MACL,OAAOb,OAAO,CAACE,MAAM,CAAgB,yBAAyB,CAAC;IACjE;EACF;EAEA,IAAIY,SAASA,CAACC,KAAa,EAAE;IAC3B,IAAI,IAAI,CAAClB,OAAO,CAACmB,QAAQ,EAAE;MACzB,IAAI,CAACnB,OAAO,CAACmB,QAAQ,CAACF,SAAS,GAAGC,KAAK;IACzC;EACF;EAEA,IAAID,SAASA,CAAA,EAAuB;IAClC,OAAO,IAAI,CAACjB,OAAO,CAACmB,QAAQ,EAAEF,SAAS;EACzC;AACF","ignoreList":[]}
+{"version":3,"names":["TheoLiveWebAdapter","constructor","_player","currentLatency","latency","Promise","resolve","reject","latencies","console","warn","authToken","token","theoLive"],"sourceRoot":"../../../../../src","sources":["internal/adapter/theolive/TheoLiveWebAdapter.ts"],"mappings":";;AAGA,OAAO,MAAMA,kBAAkB,CAAwB;EACrDC,WAAWA,CAASC,OAAyB,EAAE;IAAA,KAA3BA,OAAyB,GAAzBA,OAAyB;EAAG;EAEhD,IAAIC,cAAcA,CAAA,EAAoB;IACpC,MAAMA,cAAc,GAAG,IAAI,CAACD,OAAO,CAACE,OAAO,CAACD,cAAc;IAC1D,OAAOA,cAAc,GAAGE,OAAO,CAACC,OAAO,CAACH,cAAc,CAAC,GAAGE,OAAO,CAACE,MAAM,CAAS,uBAAuB,CAAC;EAC3G;EAEA,IAAIC,SAASA,CAAA,EAA2B;IACtCC,OAAO,CAACC,IAAI,CAAC,kDAAkD,CAAC;IAChE,OAAOL,OAAO,CAACC,OAAO,CAAC,CAAC,CAAC,CAAC;EAC5B;EAEA,IAAIK,SAASA,CAACC,KAAa,EAAE;IAC3B,IAAI,IAAI,CAACV,OAAO,CAACW,QAAQ,EAAE;MACzB,IAAI,CAACX,OAAO,CAACW,QAAQ,CAACF,SAAS,GAAGC,KAAK;IACzC;EACF;EAEA,IAAID,SAASA,CAAA,EAAuB;IAClC,OAAO,IAAI,CAACT,OAAO,CAACW,QAAQ,EAAEF,SAAS;EACzC;AACF","ignoreList":[]}

package/lib/module/manifest.json

@@ -1 +1 @@
-{"version":"11.1.0","buildDate":"2026-05-27T17:00:02.965Z"}
+{"version":"11.2.1","buildDate":"2026-06-09T13:34:42.726Z"}

package/lib/typescript/api/ads/Ad.d.ts

@@ -1,5 +1,6 @@
 import type { AdBreak } from './AdBreak';
 import type { CompanionAd } from 'theoplayer';
+import { AdIntegrationKind, CustomAdIntegrationKind } from '../source/ads/Ads';
 /**
  * Represents a VAST creative. It is either a linear or non-linear ad.
  *
@@ -15,15 +16,12 @@ export interface Ad {
      */
     adSystem: string | undefined;
     /**
-     * The integration of the ad, represented by a value from the following list:
-     * <br/> - `'theo'`
-     * <br/> - `'google-ima'`
-     * <br/> - `'google-dai'`
-     * <br/> - `'freewheel'`
+     * The integration of the ad, represented by a value from {@link AdIntegrationKind}
+     * or {@link CustomAdIntegrationKind | the identifier of a custom integration}.
      *
-     * @defaultValue `'theo'`
+     * @defaultValue `'csai'`
      */
-    integration?: string;
+    integration?: AdIntegrationKind | CustomAdIntegrationKind;
     /**
      * The type of the ad, represented by a value from the following list:
      * <br/> - `'linear'`

package/lib/typescript/api/ads/Ad.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ad.d.ts","sourceRoot":"","sources":["../../../../src/api/ads/Ad.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,EAAE;IACjB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,YAAY,CAAC;IAE1B;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;;;;OAMG;IACH,UAAU,EAAE,WAAW,EAAE,CAAC;IAE1B;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAE/B;;;;;OAKG;IACH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAE/B;;;;;OAKG;IACH,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAY,SAAQ,EAAE;IACrC;;;;;OAKG;IACH,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B;;;;;OAKG;IACH,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAS,SAAQ,EAAE;IAClC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB"}
+{"version":3,"file":"Ad.d.ts","sourceRoot":"","sources":["../../../../src/api/ads/Ad.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,WAAW,EAAE;IACjB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAE1D;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,YAAY,CAAC;IAE1B;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;;;;OAMG;IACH,UAAU,EAAE,WAAW,EAAE,CAAC;IAE1B;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAE/B;;;;;OAKG;IACH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAE/B;;;;;OAKG;IACH,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAY,SAAQ,EAAE;IACrC;;;;;OAKG;IACH,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B;;;;;OAKG;IACH,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAS,SAAQ,EAAE;IAClC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB"}

package/lib/typescript/api/ads/AdBreak.d.ts

@@ -5,6 +5,7 @@
  * @public
  */
 import type { Ad } from './Ad';
+import { AdIntegrationKind, CustomAdIntegrationKind } from '../source/ads/Ads';
 /**
  * Represents an ad break in the VMAP specification or an ad pod in the VAST specification.
  *
@@ -13,13 +14,10 @@ import type { Ad } from './Ad';
  */
 export interface AdBreak {
     /**
-     * The integration of the ad break, represented by a value from the following list:
-     * <br/> - `'theo'`
-     * <br/> - `'google-ima'`
-     * <br/> - `'google-dai'`
-     * <br/> - `'freewheel'`
+     * The integration of the ad break, represented by a value from {@link AdIntegrationKind}
+     * or {@link CustomAdIntegrationKind | the identifier of a custom integration}.
      */
-    integration: string | undefined;
+    integration: AdIntegrationKind | CustomAdIntegrationKind | undefined;
     /**
      * List of ads which will be played sequentially at the ad break's time offset.
      */

package/lib/typescript/api/ads/AdBreak.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdBreak.d.ts","sourceRoot":"","sources":["../../../../src/api/ads/AdBreak.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC;;OAEG;IACH,GAAG,EAAE,EAAE,EAAE,GAAG,SAAS,CAAC;IAEtB;;;;;;;OAOG;IACH,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC;;;;;;OAMG;IACH,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C"}
+{"version":3,"file":"AdBreak.d.ts","sourceRoot":"","sources":["../../../../src/api/ads/AdBreak.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,WAAW,EAAE,iBAAiB,GAAG,uBAAuB,GAAG,SAAS,CAAC;IAErE;;OAEG;IACH,GAAG,EAAE,EAAE,EAAE,GAAG,SAAS,CAAC;IAEtB;;;;;;;OAOG;IACH,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC;;;;;;OAMG;IACH,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C"}

package/lib/typescript/api/source/ads/Ads.d.ts

@@ -41,10 +41,8 @@ export interface AdSource {
 export interface AdDescription {
     /**
      * The integration of the ad break.
-     *
-     * @defaultValue `'csai'`
      */
-    integration?: AdIntegrationKind;
+    integration?: AdIntegrationKind | CustomAdIntegrationKind;
     /**
      * Whether the ad replaces playback of the content.
      *
@@ -109,4 +107,10 @@ export declare enum AdIntegrationKind {
     csai = "csai",
     theoads = "theoads"
 }
+/**
+ * The identifier of a custom ad integration.
+ *
+ * @category Ads
+ */
+export type CustomAdIntegrationKind = string & {};
 //# sourceMappingURL=Ads.d.ts.map

package/lib/typescript/api/source/ads/Ads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ads.d.ts","sourceRoot":"","sources":["../../../../../src/api/source/ads/Ads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAE5B;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,iBAAiB;IAC3B,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB"}
+{"version":3,"file":"Ads.d.ts","sourceRoot":"","sources":["../../../../../src/api/source/ads/Ads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAE1D;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAE5B;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,iBAAiB;IAC3B,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,EAAE,CAAC"}

package/lib/typescript/api/source/ads/TheoAdDescription.d.ts

@@ -94,6 +94,13 @@ export interface TheoAdDescription extends AdDescription {
      * The amount of seconds we wait to initialize THEOads.
      */
     initializationDelay?: number;
+    /**
+     * The URL of the break manifest.
+     *
+     * @remarks
+     * <br/> - The break manifest describes the upcoming ad breaks in the stream.
+     */
+    breakManifestUrl?: string;
 }
 /**
  * Describes how and when the layout of a THEOads ad break should be overridden:

package/lib/typescript/api/source/ads/TheoAdDescription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TheoAdDescription.d.ts","sourceRoot":"","sources":["../../../../../src/api/source/ads/TheoAdDescription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD;;OAEG;IACH,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC;IAEvC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzC;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,oBAAY,qBAAqB;IAC/B,MAAM,WAAW;IACjB,MAAM,YAAY;IAClB,MAAM,WAAW;IACjB,gBAAgB,qBAAqB;CACtC"}
+{"version":3,"file":"TheoAdDescription.d.ts","sourceRoot":"","sources":["../../../../../src/api/source/ads/TheoAdDescription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD;;OAEG;IACH,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC;IAEvC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzC;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,oBAAY,qBAAqB;IAC/B,MAAM,WAAW;IACjB,MAAM,YAAY;IAClB,MAAM,WAAW;IACjB,gBAAgB,qBAAqB;CACtC"}

package/lib/typescript/internal/adapter/theolive/TheoLiveWebAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TheoLiveWebAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/internal/adapter/theolive/TheoLiveWebAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,kBAAmB,YAAW,WAAW;IACxC,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,gBAAgB;IAE7C,IAAI,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAGpC;IAED,IAAI,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAYtC;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,EAI1B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;CACF"}
+{"version":3,"file":"TheoLiveWebAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/internal/adapter/theolive/TheoLiveWebAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,kBAAmB,YAAW,WAAW;IACxC,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,gBAAgB;IAE7C,IAAI,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAGpC;IAED,IAAI,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAGtC;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,EAI1B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-theoplayer",
-  "version": "11.1.0",
+  "version": "11.2.1",
   "description": "A THEOplayer video component for react-native.",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -70,7 +70,7 @@
     "react": "^19.2.3",
     "react-native": "^0.84.1",
     "react-native-builder-bob": "^0.39.1",
-    "theoplayer": "^11.0.0",
+    "theoplayer": "^11.4.0",
     "typedoc": "^0.25.13",
     "typedoc-plugin-external-resolver": "^1.0.3",
     "typedoc-plugin-mdn-links": "^3.3.4",
@@ -80,7 +80,7 @@
   "peerDependencies": {
     "react": "*",
     "react-native": "*",
-    "theoplayer": "^11"
+    "theoplayer": "^11.4.0"
   },
   "peerDependenciesMeta": {
     "theoplayer": {

package/react-native-theoplayer.podspec

@@ -43,37 +43,37 @@ Pod::Spec.new do |s|
 
   # THEOplayer Dependency
   puts "Adding THEOplayerSDK-core"
-  s.dependency "THEOplayerSDK-core", "~> 11.0"
+  s.dependency "THEOplayerSDK-core", "~> 11.4"
 
   # THEOlive Dependency
   puts "Adding THEOplayer-Integration-THEOlive"
-  s.dependency "THEOplayer-Integration-THEOlive", "~> 11.0"
+  s.dependency "THEOplayer-Integration-THEOlive", "~> 11.4"
 
   # Feature based integration dependencies
   if theofeatures.include?("GOOGLE_IMA")
 	puts "Adding THEOplayer-Integration-GoogleIMA"
-    s.dependency "THEOplayer-Integration-GoogleIMA", "~> 11.0"
+    s.dependency "THEOplayer-Integration-GoogleIMA", "~> 11.4"
   end
 
   if theofeatures.include?("CHROMECAST")
 	puts "Adding THEOplayer-Integration-GoogleCast"
-    s.ios.dependency "THEOplayer-Integration-GoogleCast", "~> 11.0"
+    s.ios.dependency "THEOplayer-Integration-GoogleCast", "~> 11.4"
   end
 
   if theofeatures.include?("THEO_ADS")
 	puts "Adding THEOplayer-Integration-THEOads"
-    s.dependency "THEOplayer-Integration-THEOads", "~> 11.0"
+    s.dependency "THEOplayer-Integration-THEOads", "~> 11.4"
   end
 
   if theofeatures.include?("MILLICAST")
   puts "Adding THEOplayer-Integration-Millicast"
-    s.dependency "THEOplayer-Integration-Millicast", "~> 11.0"
+    s.dependency "THEOplayer-Integration-Millicast", "~> 11.4"
   end
 
   # Feature based connector dependencies
   if theofeatures.include?("SIDELOADED_TEXTTRACKS")
 	puts "Adding THEOplayer-Connector-SideloadedSubtitle"
-    s.dependency "THEOplayer-Connector-SideloadedSubtitle", "~> 11.0"
+    s.dependency "THEOplayer-Connector-SideloadedSubtitle", "~> 11.0", "> 11.0.1"
   end
 
 end

package/src/api/ads/Ad.ts

@@ -1,5 +1,6 @@
 import type { AdBreak } from './AdBreak';
 import type { CompanionAd } from 'theoplayer';
+import { AdIntegrationKind, CustomAdIntegrationKind } from '../source/ads/Ads';
 
 /**
  * Represents a VAST creative. It is either a linear or non-linear ad.
@@ -17,15 +18,12 @@ export interface Ad {
   adSystem: string | undefined;
 
   /**
-   * The integration of the ad, represented by a value from the following list:
-   * <br/> - `'theo'`
-   * <br/> - `'google-ima'`
-   * <br/> - `'google-dai'`
-   * <br/> - `'freewheel'`
+   * The integration of the ad, represented by a value from {@link AdIntegrationKind}
+   * or {@link CustomAdIntegrationKind | the identifier of a custom integration}.
    *
-   * @defaultValue `'theo'`
+   * @defaultValue `'csai'`
    */
-  integration?: string;
+  integration?: AdIntegrationKind | CustomAdIntegrationKind;
 
   /**
    * The type of the ad, represented by a value from the following list:

package/src/api/ads/AdBreak.ts

@@ -5,6 +5,7 @@
  * @public
  */
 import type { Ad } from './Ad';
+import { AdIntegrationKind, CustomAdIntegrationKind } from '../source/ads/Ads';
 
 /**
  * Represents an ad break in the VMAP specification or an ad pod in the VAST specification.
@@ -14,13 +15,10 @@ import type { Ad } from './Ad';
  */
 export interface AdBreak {
   /**
-   * The integration of the ad break, represented by a value from the following list:
-   * <br/> - `'theo'`
-   * <br/> - `'google-ima'`
-   * <br/> - `'google-dai'`
-   * <br/> - `'freewheel'`
+   * The integration of the ad break, represented by a value from {@link AdIntegrationKind}
+   * or {@link CustomAdIntegrationKind | the identifier of a custom integration}.
    */
-  integration: string | undefined;
+  integration: AdIntegrationKind | CustomAdIntegrationKind | undefined;
 
   /**
    * List of ads which will be played sequentially at the ad break's time offset.

package/src/api/source/ads/Ads.ts

@@ -44,10 +44,8 @@ export interface AdSource {
 export interface AdDescription {
   /**
    * The integration of the ad break.
-   *
-   * @defaultValue `'csai'`
    */
-  integration?: AdIntegrationKind;
+  integration?: AdIntegrationKind | CustomAdIntegrationKind;
 
   /**
    * Whether the ad replaces playback of the content.
@@ -116,3 +114,10 @@ export enum AdIntegrationKind {
   csai = 'csai',
   theoads = 'theoads',
 }
+
+/**
+ * The identifier of a custom ad integration.
+ *
+ * @category Ads
+ */
+export type CustomAdIntegrationKind = string & {};

package/src/api/source/ads/TheoAdDescription.ts

@@ -107,6 +107,14 @@ export interface TheoAdDescription extends AdDescription {
    * The amount of seconds we wait to initialize THEOads.
    */
   initializationDelay?: number;
+
+  /**
+   * The URL of the break manifest.
+   *
+   * @remarks
+   * <br/> - The break manifest describes the upcoming ad breaks in the stream.
+   */
+  breakManifestUrl?: string;
 }
 
 /**

package/src/internal/adapter/theolive/TheoLiveWebAdapter.ts

@@ -10,17 +10,8 @@ export class TheoLiveWebAdapter implements TheoLiveAPI {
   }
 
   get latencies(): Promise<HespLatencies> {
-    const webLatencies = this._player.hesp?.latencies;
-    if (webLatencies) {
-      return Promise.resolve({
-        engineLatency: webLatencies?.engine,
-        distributionLatency: webLatencies?.distribution,
-        playerLatency: webLatencies?.player,
-        theoliveLatency: webLatencies?.theolive,
-      });
-    } else {
-      return Promise.reject<HespLatencies>('latencies not available');
-    }
+    console.warn('The THEOlive latencies metrics are not available');
+    return Promise.resolve({});
   }
 
   set authToken(token: string) {

package/src/manifest.json

@@ -1 +1 @@
-{"version":"11.1.0","buildDate":"2026-05-27T17:00:02.965Z"}
+{"version":"11.2.1","buildDate":"2026-06-09T13:34:42.726Z"}