@bluebillywig/react-native-bb-player 8.44.0 → 8.45.4

package/ios/BBPlayerModule.swift

@@ -1,5 +1,6 @@
 import Foundation
 import React
+import BBNativePlayerKit
 
 /**
  * Global registry for BBPlayerView instances.
@@ -39,21 +40,45 @@ class BBPlayerViewRegistry: NSObject {
 
 /**
  * Native Module for BBPlayer commands.
+ * Extends RCTEventEmitter to support module-level events (modal player).
  * This module looks up BBPlayerView instances by their React tag and dispatches commands to them.
  */
 @objc(BBPlayerModule)
-class BBPlayerModule: NSObject {
+class BBPlayerModule: RCTEventEmitter {
 
-    @objc var bridge: RCTBridge?
+    private var modalPlayerView: BBNativePlayerView?
+    private var modalDelegate: ModalPlayerDelegate?
+    private var pendingModalLoad: (() -> Void)?
+    private var hasListeners = false
 
-    @objc static func requiresMainQueueSetup() -> Bool {
+    @objc override static func requiresMainQueueSetup() -> Bool {
         return true
     }
 
-    @objc static func moduleName() -> String {
+    @objc override static func moduleName() -> String! {
         return "BBPlayerModule"
     }
 
+    override func supportedEvents() -> [String]! {
+        return [
+            "modalPlayerDismissed",
+            "modalPlayerPlay",
+            "modalPlayerPause",
+            "modalPlayerEnded",
+            "modalPlayerError",
+            "modalPlayerApiReady",
+            "modalPlayerCanPlay",
+        ]
+    }
+
+    override func startObserving() {
+        hasListeners = true
+    }
+
+    override func stopObserving() {
+        hasListeners = false
+    }
+
     // MARK: - Helper to get view by tag
 
     private func getView(_ reactTag: NSNumber) -> BBPlayerView? {
@@ -159,50 +184,50 @@ class BBPlayerModule: NSObject {
         }
     }
 
-    @objc func loadWithClipId(_ viewTag: NSNumber, clipId: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?) {
+    @objc func loadWithClipId(_ viewTag: NSNumber, clipId: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?, contextJson: String?) {
         DispatchQueue.main.async {
-            self.getView(viewTag)?.loadWithClipId(clipId ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue)
+            self.getView(viewTag)?.loadWithClipId(clipId ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue, contextJson: contextJson)
         }
     }
 
-    @objc func loadWithClipListId(_ viewTag: NSNumber, clipListId: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?) {
+    @objc func loadWithClipListId(_ viewTag: NSNumber, clipListId: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?, contextJson: String?) {
         DispatchQueue.main.async {
-            self.getView(viewTag)?.loadWithClipListId(clipListId ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue)
+            self.getView(viewTag)?.loadWithClipListId(clipListId ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue, contextJson: contextJson)
         }
     }
 
-    @objc func loadWithProjectId(_ viewTag: NSNumber, projectId: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?) {
+    @objc func loadWithProjectId(_ viewTag: NSNumber, projectId: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?, contextJson: String?) {
         DispatchQueue.main.async {
-            self.getView(viewTag)?.loadWithProjectId(projectId ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue)
+            self.getView(viewTag)?.loadWithProjectId(projectId ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue, contextJson: contextJson)
         }
     }
 
-    @objc func loadWithClipJson(_ viewTag: NSNumber, clipJson: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?) {
+    @objc func loadWithClipJson(_ viewTag: NSNumber, clipJson: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?, contextJson: String?) {
         DispatchQueue.main.async {
-            self.getView(viewTag)?.loadWithClipJson(clipJson ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue)
+            self.getView(viewTag)?.loadWithClipJson(clipJson ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue, contextJson: contextJson)
         }
     }
 
-    @objc func loadWithClipListJson(_ viewTag: NSNumber, clipListJson: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?) {
+    @objc func loadWithClipListJson(_ viewTag: NSNumber, clipListJson: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?, contextJson: String?) {
         DispatchQueue.main.async {
-            self.getView(viewTag)?.loadWithClipListJson(clipListJson ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue)
+            self.getView(viewTag)?.loadWithClipListJson(clipListJson ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue, contextJson: contextJson)
         }
     }
 
-    @objc func loadWithProjectJson(_ viewTag: NSNumber, projectJson: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?) {
+    @objc func loadWithProjectJson(_ viewTag: NSNumber, projectJson: String?, initiator: String?, autoPlay: Bool, seekTo: NSNumber?, contextJson: String?) {
         DispatchQueue.main.async {
-            self.getView(viewTag)?.loadWithProjectJson(projectJson ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue)
+            self.getView(viewTag)?.loadWithProjectJson(projectJson ?? "", initiator: initiator, autoPlay: autoPlay, seekTo: seekTo?.doubleValue, contextJson: contextJson)
         }
     }
 
-    @objc func loadWithJsonUrl(_ viewTag: NSNumber, jsonUrl: String?, autoPlay: Bool) {
-        NSLog("BBPlayerModule.loadWithJsonUrl called - viewTag: %@, jsonUrl: %@, autoPlay: %d", viewTag, jsonUrl ?? "nil", autoPlay)
+    @objc func loadWithJsonUrl(_ viewTag: NSNumber, jsonUrl: String?, autoPlay: Bool, contextJson: String?) {
+        NSLog("BBPlayerModule.loadWithJsonUrl called - viewTag: %@, jsonUrl: %@, autoPlay: %d, context: %@", viewTag, jsonUrl ?? "nil", autoPlay, contextJson ?? "nil")
         DispatchQueue.main.async {
             let view = self.getView(viewTag)
             NSLog("BBPlayerModule.loadWithJsonUrl - view found: %@", view != nil ? "YES" : "NO")
             if let view = view, let url = jsonUrl {
                 NSLog("BBPlayerModule.loadWithJsonUrl - calling view.loadWithJsonUrl with url: %@", url)
-                view.loadWithJsonUrl(url, autoPlay: autoPlay)
+                view.loadWithJsonUrl(url, autoPlay: autoPlay, contextJson: contextJson)
             } else {
                 NSLog("BBPlayerModule.loadWithJsonUrl - FAILED: view=%@, url=%@", view != nil ? "found" : "nil", jsonUrl ?? "nil")
             }
@@ -218,13 +243,6 @@ class BBPlayerModule: NSObject {
         }
     }
 
-    @objc func getCurrentTime(_ viewTag: NSNumber, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
-        DispatchQueue.main.async {
-            let currentTime = self.getView(viewTag)?.currentTime()
-            resolver(currentTime)
-        }
-    }
-
     @objc func getMuted(_ viewTag: NSNumber, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
         DispatchQueue.main.async {
             let muted = self.getView(viewTag)?.muted()
@@ -280,4 +298,152 @@ class BBPlayerModule: NSObject {
             resolver(playoutData)
         }
     }
+
+    // MARK: - Modal Player API
+
+    @objc func presentModalPlayer(_ jsonUrl: String, optionsJson: String?, contextJson: String?) {
+        DispatchQueue.main.async {
+            guard let rootVC = RCTPresentedViewController() else {
+                NSLog("BBPlayerModule: No root view controller found")
+                return
+            }
+
+            // Parse options from JSON string
+            var options: [String: Any]? = nil
+            if let json = optionsJson, let data = json.data(using: .utf8) {
+                options = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
+            }
+
+            // Parse context for playlist auto-advance
+            var context: [String: Any]? = nil
+            if let ctxJson = contextJson, let data = ctxJson.data(using: .utf8) {
+                context = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
+            }
+
+            // Create modal player view
+            let playerView = BBNativePlayerView(frame: rootVC.view.frame)
+            playerView.showBackArrow = options?["showBackArrow"] as? Bool ?? false
+
+            var loadOptions: [String: Any] = options ?? [:]
+            if loadOptions["autoPlay"] == nil {
+                loadOptions["autoPlay"] = true
+            }
+
+            // When context has a cliplist (contextCollectionId), load clip by ID
+            // with cliplist context. ProgramController will swap to loading the
+            // cliplist and find the clip by ID (matching web standardplayer pattern).
+            // Deferred until apiReady to avoid racing with initial jsonUrl load.
+            let collectionId = context?["contextCollectionId"] as? String
+            let clipId = context?["contextEntityId"] as? String
+
+            // Set up player with options (playout config, JWT, etc.)
+            playerView.setupWithJsonUrl(jsonUrl: jsonUrl, options: loadOptions)
+            playerView.presentModal(uiViewContoller: rootVC, animated: true)
+
+            if let collectionId = collectionId, let clipId = clipId {
+                let clipContext: [String: Any] = [
+                    "contextCollectionType": context?["contextCollectionType"] as? String ?? "MediaClipList",
+                    "contextCollectionId": collectionId,
+                ]
+                self.pendingModalLoad = {
+                    playerView.player.loadWithClipId(clipId: clipId, initiator: "external", autoPlay: true, seekTo: nil, context: clipContext)
+                }
+            }
+
+            // Set up delegate for event forwarding
+            let delegate = ModalPlayerDelegate(module: self)
+            playerView.delegate = delegate
+
+            self.modalPlayerView = playerView
+            self.modalDelegate = delegate
+
+            NSLog("BBPlayerModule: Modal player presented with URL: %@, context: %@", jsonUrl, contextJson ?? "nil")
+        }
+    }
+
+    private func extractIdFromUrl(_ url: String, pattern: String) -> String? {
+        do {
+            let regex = try NSRegularExpression(pattern: pattern, options: [])
+            let range = NSRange(url.startIndex..., in: url)
+            if let match = regex.firstMatch(in: url, options: [], range: range) {
+                for i in 1..<match.numberOfRanges {
+                    if let groupRange = Range(match.range(at: i), in: url) {
+                        let extracted = String(url[groupRange])
+                        if !extracted.isEmpty {
+                            return extracted
+                        }
+                    }
+                }
+            }
+        } catch {
+            NSLog("BBPlayerModule: Regex error: %@", error.localizedDescription)
+        }
+        return nil
+    }
+
+    @objc func dismissModalPlayer() {
+        DispatchQueue.main.async {
+            self.modalPlayerView?.player.closeModalPlayer()
+            self.modalPlayerView = nil
+            self.modalDelegate = nil
+            self.pendingModalLoad = nil
+        }
+    }
+
+    @objc override func addListener(_ eventName: String) {
+        // Required for RCTEventEmitter
+    }
+
+    @objc override func removeListeners(_ count: Double) {
+        // Required for RCTEventEmitter
+    }
+
+    private func emitEvent(_ name: String, body: Any? = nil) {
+        if hasListeners {
+            sendEvent(withName: name, body: body)
+        }
+    }
+
+    // MARK: - Modal Player Delegate
+
+    private class ModalPlayerDelegate: NSObject, BBNativePlayerViewDelegate {
+        weak var module: BBPlayerModule?
+
+        init(module: BBPlayerModule) {
+            self.module = module
+        }
+
+        func bbNativePlayerView(didTriggerPlay playerView: BBNativePlayerView) {
+            module?.emitEvent("modalPlayerPlay")
+        }
+
+        func bbNativePlayerView(didTriggerPause playerView: BBNativePlayerView) {
+            module?.emitEvent("modalPlayerPause")
+        }
+
+        func bbNativePlayerView(didTriggerEnded playerView: BBNativePlayerView) {
+            module?.emitEvent("modalPlayerEnded")
+        }
+
+        func bbNativePlayerView(playerView: BBNativePlayerView, didFailWithError error: String?) {
+            module?.emitEvent("modalPlayerError", body: ["error": error ?? "Unknown error"])
+        }
+
+        func bbNativePlayerView(didTriggerApiReady playerView: BBNativePlayerView) {
+            module?.pendingModalLoad?()
+            module?.pendingModalLoad = nil
+            module?.emitEvent("modalPlayerApiReady")
+        }
+
+        func bbNativePlayerView(didTriggerCanPlay playerView: BBNativePlayerView) {
+            module?.emitEvent("modalPlayerCanPlay")
+        }
+
+        func bbNativePlayerView(didCloseModalPlayer playerView: BBNativePlayerView) {
+            module?.emitEvent("modalPlayerDismissed")
+            module?.modalPlayerView = nil
+            module?.modalDelegate = nil
+            module?.pendingModalLoad = nil
+        }
+    }
 }

package/ios/BBPlayerView.swift

@@ -42,16 +42,9 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
   private var playerView: BBNativePlayerView?
   private var hasSetup: Bool = false
 
-  // Timer for periodic time updates (opt-in for performance)
-  private var timeUpdateTimer: Timer?
   private var isPlaying: Bool = false
   private var currentDuration: Double = 0.0
-  private var lastKnownTime: Double = 0.0
-  private var playbackStartTimestamp: CFTimeInterval = 0
-  private var lastEmittedTime: Double = 0.0
   private var isInFullscreen: Bool = false
-  private var backgroundObserver: NSObjectProtocol?
-  private var foregroundObserver: NSObjectProtocol?
   // Independent Google Cast button for showing the cast picker
   private var independentCastButton: GCKUICastButton?
   // Store parent view controller reference for SDK
@@ -71,18 +64,6 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
     }
   }
 
-  @objc var enableTimeUpdates: Bool = false {
-    didSet {
-      log("Time updates \(enableTimeUpdates ? "enabled" : "disabled")")
-
-      if !enableTimeUpdates && timeUpdateTimer != nil {
-        stopTimeUpdates()
-      } else if enableTimeUpdates && isPlaying && timeUpdateTimer == nil {
-        startTimeUpdates()
-      }
-    }
-  }
-
   // MARK: - Event handlers (RCTDirectEventBlock)
 
   @objc var onDidFailWithError: RCTDirectEventBlock?
@@ -123,7 +104,6 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
   @objc var onDidTriggerViewFinished: RCTDirectEventBlock?
   @objc var onDidTriggerViewStarted: RCTDirectEventBlock?
   @objc var onDidTriggerVolumeChange: RCTDirectEventBlock?
-  @objc var onDidTriggerTimeUpdate: RCTDirectEventBlock?
   @objc var onDidTriggerApiReady: RCTDirectEventBlock?
 
   override var intrinsicContentSize: CGSize {
@@ -153,8 +133,6 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
         BBPlayerViewRegistry.shared.register(self, tag: tag.intValue)
       }
 
-      setupAppLifecycleObservers()
-
       // Find the parent view controller from the responder chain
       var responder = self.next
       while responder != nil {
@@ -180,91 +158,19 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
         BBPlayerViewRegistry.shared.unregister(tag: tag.intValue)
       }
 
-      if !isInFullscreen {
-        stopTimeUpdates()
-      }
+      // No cleanup needed when not in fullscreen
     }
   }
 
-  // Start periodic time updates (1x per second, only if enabled)
-  private func startTimeUpdates() {
-    guard enableTimeUpdates, timeUpdateTimer == nil else { return }
-
-    timeUpdateTimer = Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { [weak self] _ in
-      guard let self = self, self.isPlaying else { return }
-
-      let elapsedSeconds = CACurrentMediaTime() - self.playbackStartTimestamp
-      let estimatedTime = self.lastKnownTime + elapsedSeconds
-      let currentTime = min(estimatedTime, self.currentDuration)
-
-      if self.currentDuration > 0 && abs(currentTime - self.lastEmittedTime) >= 0.5 {
-        self.lastEmittedTime = currentTime
-        self.onDidTriggerTimeUpdate?([
-          "currentTime": currentTime,
-          "duration": self.currentDuration
-        ])
-      }
-    }
-  }
-
-  private func stopTimeUpdates() {
-    timeUpdateTimer?.invalidate()
-    timeUpdateTimer = nil
-  }
-
   deinit {
     // Unregister from view registry
     if let tag = self.reactTag {
       BBPlayerViewRegistry.shared.unregister(tag: tag.intValue)
     }
-    stopTimeUpdates()
-    removeAppLifecycleObservers()
     independentCastButton?.removeFromSuperview()
     independentCastButton = nil
   }
 
-  // MARK: - App Lifecycle Management
-
-  private func setupAppLifecycleObservers() {
-    guard backgroundObserver == nil else { return }
-
-    backgroundObserver = NotificationCenter.default.addObserver(
-      forName: UIApplication.didEnterBackgroundNotification,
-      object: nil,
-      queue: .main
-    ) { [weak self] _ in
-      guard let self = self else { return }
-      if self.isPlaying {
-        self.lastKnownTime = self.calculateCurrentTime()
-      }
-      self.stopTimeUpdates()
-      log("Timer paused - app entered background", level: .debug)
-    }
-
-    foregroundObserver = NotificationCenter.default.addObserver(
-      forName: UIApplication.willEnterForegroundNotification,
-      object: nil,
-      queue: .main
-    ) { [weak self] _ in
-      guard let self = self else { return }
-      if self.isPlaying && self.enableTimeUpdates {
-        self.playbackStartTimestamp = CACurrentMediaTime()
-        self.startTimeUpdates()
-        log("Timer resumed - app entered foreground", level: .debug)
-      }
-    }
-  }
-
-  private func removeAppLifecycleObservers() {
-    if let observer = backgroundObserver {
-      NotificationCenter.default.removeObserver(observer)
-      backgroundObserver = nil
-    }
-    if let observer = foregroundObserver {
-      NotificationCenter.default.removeObserver(observer)
-      foregroundObserver = nil
-    }
-  }
 
   // MARK: - Player Setup (Simplified - no intermediate view controller)
 
@@ -409,7 +315,6 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
 
   func bbNativePlayerView(didTriggerEnded playerView: BBNativePlayerView) {
     isPlaying = false
-    stopTimeUpdates()
     onDidTriggerEnded?([:])
   }
 
@@ -451,7 +356,6 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
 
   func bbNativePlayerView(didTriggerPause playerView: BBNativePlayerView) {
     isPlaying = false
-    stopTimeUpdates()
     onDidTriggerPause?([:])
   }
 
@@ -465,10 +369,6 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
 
   func bbNativePlayerView(didTriggerPlaying playerView: BBNativePlayerView) {
     isPlaying = true
-    playbackStartTimestamp = CACurrentMediaTime()
-    lastEmittedTime = 0.0
-    lastKnownTime = calculateCurrentTime()
-    startTimeUpdates()
     onDidTriggerPlaying?([:])
   }
 
@@ -500,9 +400,6 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
   }
 
   func bbNativePlayerView(playerView: BBNativePlayerView, didTriggerSeeked seekOffset: Double) {
-    lastKnownTime = seekOffset
-    playbackStartTimestamp = CACurrentMediaTime()
-    lastEmittedTime = 0.0
     onDidTriggerSeeked?(["payload": seekOffset as Any])
   }
 
@@ -557,18 +454,6 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
     addSubview(castButton)
   }
 
-  // MARK: - Private Helper Methods
-
-  private func calculateCurrentTime() -> Double {
-    if isPlaying && playbackStartTimestamp > 0 {
-      let elapsedSeconds = CACurrentMediaTime() - playbackStartTimestamp
-      let estimatedTime = lastKnownTime + elapsedSeconds
-      return min(estimatedTime, currentDuration)
-    } else {
-      return lastKnownTime
-    }
-  }
-
   // MARK: - Public API Methods
 
   func adMediaHeight() -> Int? {
@@ -587,10 +472,6 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
     return nil
   }
 
-  func currentTime() -> Double? {
-    return calculateCurrentTime()
-  }
-
   func duration() -> Double? {
     return playerView?.player.duration
   }
@@ -639,6 +520,20 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
     playerView?.player.expand()
   }
 
+  func presentModal() {
+    guard let parentVC = parentViewController else {
+      log("Cannot present modal - no parent view controller", level: .warning)
+      return
+    }
+    isInFullscreen = true
+    playerView?.presentModal(uiViewContoller: parentVC, animated: true)
+  }
+
+  func closeModal() {
+    playerView?.player.closeModalPlayer()
+    isInFullscreen = false
+  }
+
   func enterFullscreen() {
     enterFullscreenWithLandscapeForce(forceLandscape: false)
   }
@@ -691,9 +586,7 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
   }
 
   func seekRelative(_ offsetInSeconds: Double) {
-    let currentTime = calculateCurrentTime()
-    let newPosition = max(0, min(currentDuration, currentTime + offsetInSeconds))
-    playerView?.player.seek(offsetInSeconds: newPosition as NSNumber)
+    playerView?.player.seekRelative(offsetInSeconds: offsetInSeconds as NSNumber)
   }
 
   func setMuted(_ muted: Bool) {
@@ -704,28 +597,48 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
     playerView?.setApiProperty(property: .volume, value: Float(volume))
   }
 
-  func loadWithClipId(_ clipId: String, initiator: String?, autoPlay: Bool?, seekTo: Double?) {
-    playerView?.player.loadWithClipId(clipId: clipId, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?)
+  // Helper to parse context JSON into a dictionary for the native SDK
+  private func parseContext(_ contextJson: String?) -> [String: Any]? {
+    guard let jsonString = contextJson, !jsonString.isEmpty else { return nil }
+    guard let data = jsonString.data(using: .utf8) else { return nil }
+    do {
+      if let dict = try JSONSerialization.jsonObject(with: data, options: []) as? [String: Any] {
+        return dict
+      }
+    } catch {
+      log("Failed to parse context JSON: \(error)", level: .warning)
+    }
+    return nil
   }
 
-  func loadWithClipListId(_ clipListId: String, initiator: String?, autoPlay: Bool?, seekTo: Double?) {
-    playerView?.player.loadWithClipListId(clipListId: clipListId, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?)
+  func loadWithClipId(_ clipId: String, initiator: String?, autoPlay: Bool?, seekTo: Double?, contextJson: String? = nil) {
+    let context = parseContext(contextJson)
+    playerView?.player.loadWithClipId(clipId: clipId, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?, context: context)
   }
 
-  func loadWithProjectId(_ projectId: String, initiator: String?, autoPlay: Bool?, seekTo: Double?) {
-    playerView?.player.loadWithProjectId(projectId: projectId, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?)
+  func loadWithClipListId(_ clipListId: String, initiator: String?, autoPlay: Bool?, seekTo: Double?, contextJson: String? = nil) {
+    let context = parseContext(contextJson)
+    playerView?.player.loadWithClipListId(clipListId: clipListId, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?, context: context)
   }
 
-  func loadWithClipJson(_ clipJson: String, initiator: String?, autoPlay: Bool?, seekTo: Double?) {
-    playerView?.player.loadWithClipJson(clipJson: clipJson, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?)
+  func loadWithProjectId(_ projectId: String, initiator: String?, autoPlay: Bool?, seekTo: Double?, contextJson: String? = nil) {
+    let context = parseContext(contextJson)
+    playerView?.player.loadWithProjectId(projectId: projectId, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?, context: context)
   }
 
-  func loadWithClipListJson(_ clipListJson: String, initiator: String?, autoPlay: Bool?, seekTo: Double?) {
-    playerView?.player.loadWithClipListJson(clipListJson: clipListJson, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?)
+  func loadWithClipJson(_ clipJson: String, initiator: String?, autoPlay: Bool?, seekTo: Double?, contextJson: String? = nil) {
+    let context = parseContext(contextJson)
+    playerView?.player.loadWithClipJson(clipJson: clipJson, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?, context: context)
   }
 
-  func loadWithProjectJson(_ projectJson: String, initiator: String?, autoPlay: Bool?, seekTo: Double?) {
-    playerView?.player.loadWithProjectJson(projectJson: projectJson, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?)
+  func loadWithClipListJson(_ clipListJson: String, initiator: String?, autoPlay: Bool?, seekTo: Double?, contextJson: String? = nil) {
+    let context = parseContext(contextJson)
+    playerView?.player.loadWithClipListJson(clipListJson: clipListJson, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?, context: context)
+  }
+
+  func loadWithProjectJson(_ projectJson: String, initiator: String?, autoPlay: Bool?, seekTo: Double?, contextJson: String? = nil) {
+    let context = parseContext(contextJson)
+    playerView?.player.loadWithProjectJson(projectJson: projectJson, initiator: initiator, autoPlay: autoPlay, seekTo: seekTo as NSNumber?, context: context)
   }
 
   /**
@@ -735,8 +648,8 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
    *
    * Note: Shorts URLs (/sh/{id}.json) are NOT supported here - use BBShortsView instead.
    */
-  func loadWithJsonUrl(_ url: String, autoPlay: Bool) {
-    NSLog("BBPlayerView.loadWithJsonUrl called - url: %@, autoPlay: %d", url, autoPlay)
+  func loadWithJsonUrl(_ url: String, autoPlay: Bool, contextJson: String? = nil) {
+    NSLog("BBPlayerView.loadWithJsonUrl called - url: %@, autoPlay: %d, context: %@", url, autoPlay, contextJson ?? "nil")
     guard playerView != nil else {
       NSLog("BBPlayerView.loadWithJsonUrl ERROR - playerView not initialized")
       return
@@ -754,6 +667,8 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
     let projectIdPattern = "/pj/([0-9]+)\\.json|/project/([0-9]+)"
     let shortsIdPattern = "/sh/([0-9]+)\\.json"
 
+    let context = parseContext(contextJson)
+
     if let shortsMatch = url.range(of: shortsIdPattern, options: .regularExpression) {
       // Shorts require a separate BBShortsView component
       log("ERROR - Shorts URLs are not supported in BBPlayerView. Use BBShortsView instead.", level: .error)
@@ -765,7 +680,7 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
       // Extract the cliplist ID
       if let clipListId = extractIdFromUrl(url, pattern: clipListIdPattern) {
         NSLog("BBPlayerView.loadWithJsonUrl - Loading ClipList by ID: %@", clipListId)
-        playerView?.player.loadWithClipListId(clipListId: clipListId, initiator: "external", autoPlay: autoPlay, seekTo: nil)
+        playerView?.player.loadWithClipListId(clipListId: clipListId, initiator: "external", autoPlay: autoPlay, seekTo: nil, context: context)
       } else {
         NSLog("BBPlayerView.loadWithJsonUrl ERROR - Failed to extract cliplist ID from URL: %@", url)
       }
@@ -776,7 +691,7 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
       // Extract the project ID
       if let projectId = extractIdFromUrl(url, pattern: projectIdPattern) {
         NSLog("BBPlayerView.loadWithJsonUrl - Loading Project by ID: %@", projectId)
-        playerView?.player.loadWithProjectId(projectId: projectId, initiator: "external", autoPlay: autoPlay, seekTo: nil)
+        playerView?.player.loadWithProjectId(projectId: projectId, initiator: "external", autoPlay: autoPlay, seekTo: nil, context: context)
       } else {
         NSLog("BBPlayerView.loadWithJsonUrl ERROR - Failed to extract project ID from URL: %@", url)
       }
@@ -787,7 +702,7 @@ class BBPlayerView: UIView, BBNativePlayerViewDelegate {
       // Extract the clip ID
       if let clipId = extractIdFromUrl(url, pattern: clipIdPattern) {
         NSLog("BBPlayerView.loadWithJsonUrl - Loading Clip by ID: %@", clipId)
-        playerView?.player.loadWithClipId(clipId: clipId, initiator: "external", autoPlay: autoPlay, seekTo: nil)
+        playerView?.player.loadWithClipId(clipId: clipId, initiator: "external", autoPlay: autoPlay, seekTo: nil, context: context)
       } else {
         NSLog("BBPlayerView.loadWithJsonUrl ERROR - Failed to extract clip ID from URL: %@", url)
       }

package/ios/BBPlayerViewManager.m

@@ -7,7 +7,6 @@
 // Props
 RCT_EXPORT_VIEW_PROPERTY(jsonUrl, NSString)
 RCT_EXPORT_VIEW_PROPERTY(options, NSDictionary)
-RCT_EXPORT_VIEW_PROPERTY(enableTimeUpdates, BOOL)
 
 // Event handlers
 RCT_EXPORT_VIEW_PROPERTY(onDidFailWithError, RCTDirectEventBlock)
@@ -48,7 +47,6 @@ RCT_EXPORT_VIEW_PROPERTY(onDidTriggerStateChange, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onDidTriggerViewFinished, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onDidTriggerViewStarted, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onDidTriggerVolumeChange, RCTDirectEventBlock)
-RCT_EXPORT_VIEW_PROPERTY(onDidTriggerTimeUpdate, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onDidTriggerApiReady, RCTDirectEventBlock)
 
 // Commands (methods callable from JS)
@@ -58,6 +56,8 @@ RCT_EXTERN_METHOD(seek:(nonnull NSNumber *)reactTag offsetInSeconds:(nonnull NSN
 RCT_EXTERN_METHOD(seekRelative:(nonnull NSNumber *)reactTag offsetInSeconds:(nonnull NSNumber *)offsetInSeconds)
 RCT_EXTERN_METHOD(setMuted:(nonnull NSNumber *)reactTag muted:(BOOL)muted)
 RCT_EXTERN_METHOD(setVolume:(nonnull NSNumber *)reactTag volume:(nonnull NSNumber *)volume)
+RCT_EXTERN_METHOD(presentModal:(nonnull NSNumber *)reactTag)
+RCT_EXTERN_METHOD(closeModal:(nonnull NSNumber *)reactTag)
 RCT_EXTERN_METHOD(enterFullscreen:(nonnull NSNumber *)reactTag)
 RCT_EXTERN_METHOD(enterFullscreenLandscape:(nonnull NSNumber *)reactTag)
 RCT_EXTERN_METHOD(exitFullscreen:(nonnull NSNumber *)reactTag)

package/ios/BBPlayerViewManager.swift

@@ -62,6 +62,18 @@ class BBPlayerViewManager: RCTViewManager {
         }
     }
 
+    @objc func presentModal(_ reactTag: NSNumber) {
+        DispatchQueue.main.async {
+            self.getView(reactTag)?.presentModal()
+        }
+    }
+
+    @objc func closeModal(_ reactTag: NSNumber) {
+        DispatchQueue.main.async {
+            self.getView(reactTag)?.closeModal()
+        }
+    }
+
     @objc func enterFullscreen(_ reactTag: NSNumber) {
         DispatchQueue.main.async {
             self.getView(reactTag)?.enterFullscreen()