@rntp/player 5.0.0-beta.5 → 5.0.0

package/ios/TrackPlayer.swift

@@ -153,6 +153,7 @@ class TrackPlayer: RCTEventEmitter {
 
   @objc(clearCache)
   func clearCache() {
+    player.cancelAllDownloads()
     audioCache?.removeAll()
   }
 

package/ios/player/AVPlayerEngine.swift

@@ -248,9 +248,7 @@ class AVPlayerEngine: PlayerEngine {
     }
 
     if reason == .oldDeviceUnavailable {
-      if isPlaying {
-        pause()
-      }
+      pause()
     }
   }
   #endif

package/ios/player/AudioPlayer.swift

@@ -22,6 +22,7 @@ class AudioPlayer {
 
   private let engine: PlayerEngine
   private let queue = QueueManager()
+  private let cache: AudioCache?
   private(set) var preloader: Preloader?
   #if canImport(UIKit)
   private let artworkCache = NSCache<NSString, UIImage>()
@@ -81,6 +82,7 @@ class AudioPlayer {
 
   init(engine: PlayerEngine, cache: AudioCache? = nil, coordinator: DownloadCoordinator? = nil) {
     self.engine = engine
+    self.cache = cache
     if let cache = cache, let coordinator = coordinator {
       self.preloader = Preloader(cache: cache, coordinator: coordinator)
     }
@@ -89,7 +91,7 @@ class AudioPlayer {
       if let engine = self.engine as? AVPlayerEngine,
          engine.currentCacheKey == key {
         DispatchQueue.main.async {
-          self.onCurrentTrackCached()
+          self.triggerAutoPreloadIfNeeded()
         }
       }
     }
@@ -175,6 +177,8 @@ class AudioPlayer {
   }
 
   // MARK: - Queue: Load / Set
+  // Note: Any method that changes the queue or current item must call
+  // triggerAutoPreloadIfNeeded() so the preload window stays in sync.
 
   func load(item: AudioItem) {
     queue.replaceCurrentItem(with: item)
@@ -188,6 +192,7 @@ class AudioPlayer {
       try? queue.jump(to: 0)
       loadCurrentItem()
     }
+    triggerAutoPreloadIfNeeded()
   }
 
   func add(items newItems: [AudioItem], at index: Int) throws {
@@ -197,6 +202,7 @@ class AudioPlayer {
       try queue.jump(to: 0)
       loadCurrentItem()
     }
+    triggerAutoPreloadIfNeeded()
   }
 
   // MARK: - Queue: Navigate
@@ -243,6 +249,7 @@ class AudioPlayer {
       }
     } else {
       try? queue.replaceItem(at: index, with: newItem)
+      triggerAutoPreloadIfNeeded()
     }
   }
 
@@ -269,6 +276,8 @@ class AudioPlayer {
         state = .idle
         clearNowPlayingInfo()
       }
+    } else {
+      triggerAutoPreloadIfNeeded()
     }
   }
 
@@ -280,6 +289,14 @@ class AudioPlayer {
     deactivateAudioSession()
   }
 
+  /// Cancel all active downloads (preloads and in-progress streaming).
+  func cancelAllDownloads() {
+    preloader?.cancelAll()
+    if let engine = engine as? AVPlayerEngine {
+      engine.downloadCoordinator?.cancelAll()
+    }
+  }
+
   // MARK: - Destroy
 
   func destroy() {
@@ -328,11 +345,27 @@ class AudioPlayer {
     state = .loading
     updateNowPlayingMetadata(for: item)
     onCurrentItemChanged?(item, queue.currentIndex)
+    triggerAutoPreloadIfNeeded()
   }
 
-  /// Called when the current track's download completes (fully cached).
-  private func onCurrentTrackCached() {
+  /// Check if auto preloading should trigger and start it if so.
+  /// Preloads run when the current item is live, a local file, fully cached
+  /// on disk, or when the queue changes while one of those is already true.
+  private func triggerAutoPreloadIfNeeded() {
     guard preloadWindow > 0, let preloader = preloader else { return }
+
+    let shouldPreload: Bool
+    if let current = queue.current, (current.isLive || current.sourceType == .file) {
+      shouldPreload = true
+    } else if let engine = engine as? AVPlayerEngine,
+              let key = engine.currentCacheKey,
+              let cache = cache, cache.isFullyCached(key: key) {
+      shouldPreload = true
+    } else {
+      shouldPreload = false
+    }
+    guard shouldPreload else { return }
+
     preloader.cancelAll()
 
     let startIndex = queue.currentIndex + 1

package/lib/commonjs/interfaces/PlayerConfig.js.map

@@ -1 +1 @@
-{"version":3,"names":["DEFAULT_CACHE_CONFIG","exports","maxSizeBytes","DEFAULT_CAST_RECEIVER_APP_ID","DEFAULT_ANDROID_PLAYER_CONFIG","wakeMode","skipSilenceEnabled","DEFAULT_PLAYER_CONFIG","contentType","handleAudioBecomingNoisy","android"],"sourceRoot":"../../../src","sources":["interfaces/PlayerConfig.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;;AAoCO,MAAMA,oBAA+D,GAAAC,OAAA,CAAAD,oBAAA,GAAG;EAC7EE,YAAY,EAAE,GAAG,GAAG,IAAI,GAAG;AAC7B,CAAC;;AAED;AACA;AACA;AACA;AACO,MAAMC,4BAA4B,GAAAF,OAAA,CAAAE,4BAAA,GAAG,UAAU;;AAEtD;AACO,MAAMC,6BAAkD,GAAAH,OAAA,CAAAG,6BAAA,GAAG;EAChEC,QAAQ,EAAE,MAAM;EAChBC,kBAAkB,EAAE;AACtB,CAAC;AAwBD;AACO,MAAMC,qBAIZ,GAAAN,OAAA,CAAAM,qBAAA,GAAG;EACFC,WAAW,EAAE,OAAO;EACpBC,wBAAwB,EAAE,IAAI;EAC9BC,OAAO,EAAEN;AACX,CAAC","ignoreList":[]}
+{"version":3,"names":["DEFAULT_CACHE_CONFIG","exports","maxSizeBytes","DEFAULT_CAST_RECEIVER_APP_ID","DEFAULT_ANDROID_PLAYER_CONFIG","wakeMode","skipSilenceEnabled","DEFAULT_PLAYER_CONFIG","contentType","handleAudioBecomingNoisy","android"],"sourceRoot":"../../../src","sources":["interfaces/PlayerConfig.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;;AAsCO,MAAMA,oBAA+D,GAAAC,OAAA,CAAAD,oBAAA,GAAG;EAC7EE,YAAY,EAAE,GAAG,GAAG,IAAI,GAAG;AAC7B,CAAC;;AAED;AACA;AACA;AACA;AACO,MAAMC,4BAA4B,GAAAF,OAAA,CAAAE,4BAAA,GAAG,UAAU;;AAEtD;AACO,MAAMC,6BAAkD,GAAAH,OAAA,CAAAG,6BAAA,GAAG;EAChEC,QAAQ,EAAE,MAAM;EAChBC,kBAAkB,EAAE;AACtB,CAAC;AAwBD;AACO,MAAMC,qBAIZ,GAAAN,OAAA,CAAAM,qBAAA,GAAG;EACFC,WAAW,EAAE,OAAO;EACpBC,wBAAwB,EAAE,IAAI;EAC9BC,OAAO,EAAEN;AACX,CAAC","ignoreList":[]}

package/lib/module/interfaces/PlayerConfig.js.map

@@ -1 +1 @@
-{"version":3,"names":["DEFAULT_CACHE_CONFIG","maxSizeBytes","DEFAULT_CAST_RECEIVER_APP_ID","DEFAULT_ANDROID_PLAYER_CONFIG","wakeMode","skipSilenceEnabled","DEFAULT_PLAYER_CONFIG","contentType","handleAudioBecomingNoisy","android"],"sourceRoot":"../../../src","sources":["interfaces/PlayerConfig.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAoCA,OAAO,MAAMA,oBAA+D,GAAG;EAC7EC,YAAY,EAAE,GAAG,GAAG,IAAI,GAAG;AAC7B,CAAC;;AAED;AACA;AACA;AACA;AACA,OAAO,MAAMC,4BAA4B,GAAG,UAAU;;AAEtD;AACA,OAAO,MAAMC,6BAAkD,GAAG;EAChEC,QAAQ,EAAE,MAAM;EAChBC,kBAAkB,EAAE;AACtB,CAAC;AAwBD;AACA,OAAO,MAAMC,qBAIZ,GAAG;EACFC,WAAW,EAAE,OAAO;EACpBC,wBAAwB,EAAE,IAAI;EAC9BC,OAAO,EAAEN;AACX,CAAC","ignoreList":[]}
+{"version":3,"names":["DEFAULT_CACHE_CONFIG","maxSizeBytes","DEFAULT_CAST_RECEIVER_APP_ID","DEFAULT_ANDROID_PLAYER_CONFIG","wakeMode","skipSilenceEnabled","DEFAULT_PLAYER_CONFIG","contentType","handleAudioBecomingNoisy","android"],"sourceRoot":"../../../src","sources":["interfaces/PlayerConfig.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAsCA,OAAO,MAAMA,oBAA+D,GAAG;EAC7EC,YAAY,EAAE,GAAG,GAAG,IAAI,GAAG;AAC7B,CAAC;;AAED;AACA;AACA;AACA;AACA,OAAO,MAAMC,4BAA4B,GAAG,UAAU;;AAEtD;AACA,OAAO,MAAMC,6BAAkD,GAAG;EAChEC,QAAQ,EAAE,MAAM;EAChBC,kBAAkB,EAAE;AACtB,CAAC;AAwBD;AACA,OAAO,MAAMC,qBAIZ,GAAG;EACFC,WAAW,EAAE,OAAO;EACpBC,wBAAwB,EAAE,IAAI;EAC9BC,OAAO,EAAEN;AACX,CAAC","ignoreList":[]}

package/lib/typescript/src/interfaces/PlayerConfig.d.ts

@@ -5,7 +5,9 @@
 import type { PlayerCommand, RemoteControlHandling, PerCommandHandling } from './PlayerCommand';
 export interface PreloadConfig {
     /**
-     * Auto-preload next N tracks in queue after current track is fully cached.
+     * Auto-preload next N tracks in queue. Preloading starts when the current
+     * item is live, a local file, or fully cached on disk. It also re-evaluates
+     * when the queue changes (items added, removed, replaced, or reordered).
      * @default 0 (disabled)
      */
     window?: number;

package/lib/typescript/src/interfaces/PlayerConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlayerConfig.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/PlayerConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAE1E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAEvD,4CAA4C;AAC5C,eAAO,MAAM,6BAA6B,EAAE,mBAG3C,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,qBAAqB;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC,CACzD,GAAG;IACF,OAAO,EAAE,mBAAmB,CAAC;CAK9B,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACjC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACxC"}
+{"version":3,"file":"PlayerConfig.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/PlayerConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAE1E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAEvD,4CAA4C;AAC5C,eAAO,MAAM,6BAA6B,EAAE,mBAG3C,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,qBAAqB;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC,CACzD,GAAG;IACF,OAAO,EAAE,mBAAmB,CAAC;CAK9B,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACjC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACxC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rntp/player",
-  "version": "5.0.0-beta.5",
+  "version": "5.0.0",
   "description": "The premium audio player for React Native",
   "source": "./src/index.tsx",
   "react-native": "./src/index.tsx",

package/src/interfaces/PlayerConfig.ts

@@ -11,7 +11,9 @@ import type {
 
 export interface PreloadConfig {
   /**
-   * Auto-preload next N tracks in queue after current track is fully cached.
+   * Auto-preload next N tracks in queue. Preloading starts when the current
+   * item is live, a local file, or fully cached on disk. It also re-evaluates
+   * when the queue changes (items added, removed, replaced, or reordered).
    * @default 0 (disabled)
    */
   window?: number;