react-native-nitro-player 0.5.2 → 0.5.4

package/ios/equalizer/EqualizerCore.swift

@@ -29,6 +29,9 @@ class EqualizerCore {
   // Current gains storage - internal so TapContext can access
   private(set) var currentGains: [Double] = [0, 0, 0, 0, 0]
 
+  // Dirty flag: set when gains change so TapContext only recalculates when needed
+  var gainsDirty: Bool = true
+
   // UserDefaults keys
   private let enabledKey = "eq_enabled"
   private let bandGainsKey = "eq_band_gains"
@@ -81,7 +84,7 @@ class EqualizerCore {
 
   private init() {
     restoreSettings()
-    print("✅ EqualizerCore: Initialized with MTAudioProcessingTap support")
+    NitroPlayerLogger.log("EqualizerCore", "✅ Initialized with MTAudioProcessingTap support")
   }
 
   // MARK: - Audio Mix Creation for AVPlayerItem
@@ -98,19 +101,18 @@ class EqualizerCore {
       let status = asset.statusOfValue(forKey: "tracks", error: &error)
 
       if status == .failed {
-        print(
-          "⚠️ EqualizerCore: Failed to load tracks key: \(error?.localizedDescription ?? "unknown")")
+          NitroPlayerLogger.log("EqualizerCore", "⚠️ Failed to load tracks key: \(error?.localizedDescription ?? "unknown")")
         return
       }
 
       // Proceed only if loaded successfully
       guard status == .loaded else {
-        print("⚠️ EqualizerCore: Tracks not loaded, status: \(status.rawValue)")
+        NitroPlayerLogger.log("EqualizerCore", "⚠️ Tracks not loaded, status: \(status.rawValue)")
         return
       }
 
       guard let audioTrack = asset.tracks(withMediaType: .audio).first else {
-        print("⚠️ EqualizerCore: No audio track found in asset")
+        NitroPlayerLogger.log("EqualizerCore", "⚠️ No audio track found in asset")
         return
       }
 
@@ -137,7 +139,7 @@ class EqualizerCore {
       )
 
       guard createStatus == noErr, let audioTap = tap else {
-        print("❌ EqualizerCore: Failed to create audio processing tap, status: \(createStatus)")
+        NitroPlayerLogger.log("EqualizerCore", "❌ Failed to create audio processing tap, status: \(createStatus)")
         return
       }
 
@@ -150,7 +152,7 @@ class EqualizerCore {
       // Apply to player item on main thread (AVPlayerItem properties should be accessed/modified on main thread or serial queue usually, but audioMix is thread safe - safely done on main to be sure)
       DispatchQueue.main.async {
         playerItem.audioMix = audioMix
-        print("✅ EqualizerCore: Applied audio mix with EQ tap to player item (async)")
+        NitroPlayerLogger.log("EqualizerCore", "✅ Applied audio mix with EQ tap to player item (async)")
       }
     }
   }
@@ -163,7 +165,7 @@ class EqualizerCore {
     notifyEnabledChange(enabled)
     saveEnabled(enabled)
 
-    print("🎚️ EqualizerCore: Equalizer \(enabled ? "enabled" : "disabled")")
+    NitroPlayerLogger.log("EqualizerCore", "🎚️ Equalizer \(enabled ? "enabled" : "disabled")")
     return true
   }
 
@@ -187,6 +189,7 @@ class EqualizerCore {
 
     let clampedGain = max(-12.0, min(12.0, gainDb))
     currentGains[bandIndex] = clampedGain
+    gainsDirty = true
 
     currentPresetName = nil
     notifyBandChange(getBands())
@@ -194,7 +197,7 @@ class EqualizerCore {
     saveBandGains(currentGains)
     saveCurrentPreset(nil)
 
-    print("🎚️ EqualizerCore: Band \(bandIndex) gain set to \(clampedGain) dB")
+    NitroPlayerLogger.log("EqualizerCore", "🎚️ Band \(bandIndex) gain set to \(clampedGain) dB")
     return true
   }
 
@@ -204,11 +207,12 @@ class EqualizerCore {
     for i in 0..<5 {
       currentGains[i] = max(-12.0, min(12.0, gains[i]))
     }
+    gainsDirty = true
 
     notifyBandChange(getBands())
     saveBandGains(currentGains)
 
-    print("🎚️ EqualizerCore: All band gains updated")
+    NitroPlayerLogger.log("EqualizerCore", "🎚️ All band gains updated")
     return true
   }
 
@@ -380,7 +384,7 @@ class EqualizerCore {
     currentPresetName = UserDefaults.standard.string(forKey: currentPresetKey)
     isEqualizerEnabled = enabled
 
-    print("✅ EqualizerCore: Restored settings - enabled: \(enabled), gains: \(currentGains)")
+    NitroPlayerLogger.log("EqualizerCore", "✅ Restored settings - enabled: \(enabled), gains: \(currentGains)")
   }
 
   // MARK: - Callback Management
@@ -505,6 +509,7 @@ private class TapContext {
         sampleRate: Double(sampleRate)
       )
     }
+    eqCore.gainsDirty = false
   }
 
   /// Calculate biquad coefficients for a peaking EQ filter
@@ -556,13 +561,13 @@ private func tapInitCallback(
   let context = TapContext(eqCore: eqCore)
   tapStorageOut.pointee = Unmanaged.passRetained(context).toOpaque()
 
-  print("🎛️ EqualizerCore: Tap initialized")
+  NitroPlayerLogger.log("EqualizerCore", "🎛️ Tap initialized")
 }
 
 private func tapFinalizeCallback(tap: MTAudioProcessingTap) {
   let storage = MTAudioProcessingTapGetStorage(tap)
   Unmanaged<TapContext>.fromOpaque(storage).release()
-  print("🎛️ EqualizerCore: Tap finalized")
+  NitroPlayerLogger.log("EqualizerCore", "🎛️ Tap finalized")
 }
 
 private func tapPrepareCallback(
@@ -578,13 +583,11 @@ private func tapPrepareCallback(
   context.updateCoefficients()
   context.resetFilterStates()
 
-  print(
-    "🎛️ EqualizerCore: Tap prepared - sampleRate: \(context.sampleRate), channels: \(context.channelCount)"
-  )
+    NitroPlayerLogger.log("EqualizerCore", "🎛️ Tap prepared - sampleRate: \(context.sampleRate), channels: \(context.channelCount)")
 }
 
 private func tapUnprepareCallback(tap: MTAudioProcessingTap) {
-  print("🎛️ EqualizerCore: Tap unprepared")
+  NitroPlayerLogger.log("EqualizerCore", "🎛️ Tap unprepared")
 }
 
 private func tapProcessCallback(
@@ -610,7 +613,7 @@ private func tapProcessCallback(
   )
 
   guard status == noErr else {
-    print("❌ EqualizerCore: Failed to get source audio: \(status)")
+    NitroPlayerLogger.log("EqualizerCore", "❌ Failed to get source audio: \(status)")
     return
   }
 
@@ -620,8 +623,10 @@ private func tapProcessCallback(
     return
   }
 
-  // Update coefficients (in case gains changed)
-  context.updateCoefficients()
+  // Update coefficients only when gains have changed
+  if context.eqCore?.gainsDirty == true {
+    context.updateCoefficients()
+  }
 
   // Process each buffer (channel)
   let bufferList = UnsafeMutableAudioBufferListPointer(bufferListInOut)

package/ios/playlist/PlaylistManager.swift

@@ -16,6 +16,7 @@ class PlaylistManager {
     [:]
   private var currentPlaylistId: String?
   private let queue = DispatchQueue(label: "com.margelo.nitro.nitroplayer.playlist")
+  private var saveDebounceWorkItem: DispatchWorkItem?
 
   static let shared = PlaylistManager()
 
@@ -34,7 +35,7 @@ class PlaylistManager {
       playlists[id] = playlist
     }
 
-    savePlaylistsToUserDefaults()
+    scheduleSave()
     notifyPlaylistsChanged(.add)
 
     return id
@@ -53,7 +54,7 @@ class PlaylistManager {
         currentPlaylistId = nil
       }
       playlistListeners.removeValue(forKey: playlistId)
-      savePlaylistsToUserDefaults()
+      scheduleSave()
       notifyPlaylistsChanged(.remove)
       return true
     }
@@ -81,7 +82,7 @@ class PlaylistManager {
       )
     }
 
-    savePlaylistsToUserDefaults()
+    scheduleSave()
     notifyPlaylistChanged(playlistId, .update)
     notifyPlaylistsChanged(.update)
 
@@ -130,7 +131,7 @@ class PlaylistManager {
       )
     }
 
-    savePlaylistsToUserDefaults()
+    scheduleSave()
     notifyPlaylistChanged(playlistId, .add)
 
     // Update TrackPlayerCore if this is the current playlist
@@ -165,7 +166,7 @@ class PlaylistManager {
       )
     }
 
-    savePlaylistsToUserDefaults()
+    scheduleSave()
     notifyPlaylistChanged(playlistId, .add)
 
     // Update TrackPlayerCore if this is the current playlist
@@ -204,7 +205,7 @@ class PlaylistManager {
     }
 
     if removed {
-      savePlaylistsToUserDefaults()
+      scheduleSave()
       notifyPlaylistChanged(playlistId, .remove)
 
       // Update TrackPlayerCore if this is the current playlist
@@ -245,7 +246,7 @@ class PlaylistManager {
       )
     }
 
-    savePlaylistsToUserDefaults()
+    scheduleSave()
     notifyPlaylistChanged(playlistId, .update)
 
     // Update TrackPlayerCore if this is the current playlist
@@ -349,6 +350,15 @@ class PlaylistManager {
     }
   }
 
+  private func scheduleSave() {
+    saveDebounceWorkItem?.cancel()
+    let work = DispatchWorkItem { [weak self] in self?.savePlaylistsToUserDefaults() }
+    saveDebounceWorkItem = work
+    // Use global background queue — savePlaylistsToUserDefaults calls queue.sync internally,
+    // which would deadlock if scheduled on queue itself.
+    DispatchQueue.global(qos: .utility).asyncAfter(deadline: .now() + 0.3, execute: work)
+  }
+
   private func savePlaylistsToUserDefaults() {
     // Save playlists to UserDefaults for persistence
     // Implementation similar to Android SharedPreferences
@@ -389,7 +399,7 @@ class PlaylistManager {
       UserDefaults.standard.set(data, forKey: "NitroPlayerPlaylists")
       UserDefaults.standard.set(currentPlaylistId, forKey: "NitroPlayerCurrentPlaylistId")
     } catch {
-      print("❌ PlaylistManager: Error saving playlists - \(error)")
+      NitroPlayerLogger.log("PlaylistManager", "❌ Error saving playlists - \(error)")
     }
   }
 
@@ -471,7 +481,7 @@ class PlaylistManager {
 
       currentPlaylistId = UserDefaults.standard.string(forKey: "NitroPlayerCurrentPlaylistId")
     } catch {
-      print("❌ PlaylistManager: Error loading playlists - \(error)")
+      NitroPlayerLogger.log("PlaylistManager", "❌ Error loading playlists - \(error)")
     }
   }
 }

package/ios/queue/QueueManager.swift

@@ -114,7 +114,7 @@ class QueueManager {
           wrapper.listener(currentTracks, operation)
         } catch {
           // Log error but don't break other listeners
-          print("Error in queue change listener: \(error)")
+          NitroPlayerLogger.log("QueueManager", "Error in queue change listener: \(error)")
         }
       }
     }

package/lib/specs/TrackPlayer.nitro.d.ts

@@ -35,6 +35,7 @@ export interface TrackPlayer extends HybridObject<{
     getActualQueue(): Promise<TrackItem[]>;
     getState(): Promise<PlayerState>;
     setRepeatMode(mode: RepeatMode): boolean;
+    getRepeatMode(): RepeatMode;
     configure(config: PlayerConfig): void;
     onChangeTrack(callback: (track: TrackItem, reason?: Reason) => void): void;
     onPlaybackStateChange(callback: (state: TrackPlayerState, reason?: Reason) => void): void;

package/lib/types/PlayerQueue.d.ts

@@ -19,7 +19,7 @@ export interface Playlist {
 }
 export type QueueOperation = 'add' | 'remove' | 'clear' | 'update';
 export type TrackPlayerState = 'playing' | 'paused' | 'stopped';
-export type Reason = 'user_action' | 'skip' | 'end' | 'error';
+export type Reason = 'user_action' | 'skip' | 'end' | 'error' | 'repeat';
 export interface PlayerState {
     currentTrack: TrackItem | null;
     currentPosition: number;

package/nitrogen/generated/android/c++/JHybridTrackPlayerSpec.cpp

@@ -215,6 +215,11 @@ namespace margelo::nitro::nitroplayer {
     auto __result = method(_javaPart, JRepeatMode::fromCpp(mode));
     return static_cast<bool>(__result);
   }
+  RepeatMode JHybridTrackPlayerSpec::getRepeatMode() {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JRepeatMode>()>("getRepeatMode");
+    auto __result = method(_javaPart);
+    return __result->toCpp();
+  }
   void JHybridTrackPlayerSpec::configure(const PlayerConfig& config) {
     static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<JPlayerConfig> /* config */)>("configure");
     method(_javaPart, JPlayerConfig::fromCpp(config));

package/nitrogen/generated/android/c++/JHybridTrackPlayerSpec.hpp

@@ -66,6 +66,7 @@ namespace margelo::nitro::nitroplayer {
     std::shared_ptr<Promise<std::vector<TrackItem>>> getActualQueue() override;
     std::shared_ptr<Promise<PlayerState>> getState() override;
     bool setRepeatMode(RepeatMode mode) override;
+    RepeatMode getRepeatMode() override;
     void configure(const PlayerConfig& config) override;
     void onChangeTrack(const std::function<void(const TrackItem& /* track */, std::optional<Reason> /* reason */)>& callback) override;
     void onPlaybackStateChange(const std::function<void(TrackPlayerState /* state */, std::optional<Reason> /* reason */)>& callback) override;

package/nitrogen/generated/android/c++/JReason.hpp

@@ -45,6 +45,7 @@ namespace margelo::nitro::nitroplayer {
       static const auto fieldSKIP = clazz->getStaticField<JReason>("SKIP");
       static const auto fieldEND = clazz->getStaticField<JReason>("END");
       static const auto fieldERROR = clazz->getStaticField<JReason>("ERROR");
+      static const auto fieldREPEAT = clazz->getStaticField<JReason>("REPEAT");
       
       switch (value) {
         case Reason::USER_ACTION:
@@ -55,6 +56,8 @@ namespace margelo::nitro::nitroplayer {
           return clazz->getStaticFieldValue(fieldEND);
         case Reason::ERROR:
           return clazz->getStaticFieldValue(fieldERROR);
+        case Reason::REPEAT:
+          return clazz->getStaticFieldValue(fieldREPEAT);
         default:
           std::string stringValue = std::to_string(static_cast<int>(value));
           throw std::invalid_argument("Invalid enum value (" + stringValue + "!");

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitroplayer/HybridTrackPlayerSpec.kt

@@ -94,6 +94,10 @@ abstract class HybridTrackPlayerSpec: HybridObject() {
   @Keep
   abstract fun setRepeatMode(mode: RepeatMode): Boolean
   
+  @DoNotStrip
+  @Keep
+  abstract fun getRepeatMode(): RepeatMode
+  
   @DoNotStrip
   @Keep
   abstract fun configure(config: PlayerConfig): Unit

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitroplayer/Reason.kt

@@ -19,5 +19,6 @@ enum class Reason(@DoNotStrip @Keep val value: Int) {
   USER_ACTION(0),
   SKIP(1),
   END(2),
-  ERROR(3);
+  ERROR(3),
+  REPEAT(4);
 }

package/nitrogen/generated/ios/NitroPlayer-Swift-Cxx-Bridge.hpp

@@ -60,6 +60,8 @@ namespace margelo::nitro::nitroplayer { enum class PresetType; }
 namespace margelo::nitro::nitroplayer { enum class QueueOperation; }
 // Forward declaration of `Reason` to properly resolve imports.
 namespace margelo::nitro::nitroplayer { enum class Reason; }
+// Forward declaration of `RepeatMode` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { enum class RepeatMode; }
 // Forward declaration of `StorageLocation` to properly resolve imports.
 namespace margelo::nitro::nitroplayer { enum class StorageLocation; }
 // Forward declaration of `TrackItem` to properly resolve imports.
@@ -106,6 +108,7 @@ namespace NitroPlayer { class HybridTrackPlayerSpec_cxx; }
 #include "PresetType.hpp"
 #include "QueueOperation.hpp"
 #include "Reason.hpp"
+#include "RepeatMode.hpp"
 #include "StorageLocation.hpp"
 #include "TrackItem.hpp"
 #include "TrackPlayerState.hpp"
@@ -1452,5 +1455,14 @@ namespace margelo::nitro::nitroplayer::bridge::swift {
   inline Result_std__shared_ptr_Promise_PlayerState___ create_Result_std__shared_ptr_Promise_PlayerState___(const std::exception_ptr& error) noexcept {
     return Result<std::shared_ptr<Promise<PlayerState>>>::withError(error);
   }
+  
+  // pragma MARK: Result<RepeatMode>
+  using Result_RepeatMode_ = Result<RepeatMode>;
+  inline Result_RepeatMode_ create_Result_RepeatMode_(RepeatMode value) noexcept {
+    return Result<RepeatMode>::withValue(std::move(value));
+  }
+  inline Result_RepeatMode_ create_Result_RepeatMode_(const std::exception_ptr& error) noexcept {
+    return Result<RepeatMode>::withError(error);
+  }
 
 } // namespace margelo::nitro::nitroplayer::bridge::swift

package/nitrogen/generated/ios/c++/HybridTrackPlayerSpecSwift.hpp

@@ -173,6 +173,14 @@ namespace margelo::nitro::nitroplayer {
       auto __value = std::move(__result.value());
       return __value;
     }
+    inline RepeatMode getRepeatMode() override {
+      auto __result = _swiftPart.getRepeatMode();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
     inline void configure(const PlayerConfig& config) override {
       auto __result = _swiftPart.configure(std::forward<decltype(config)>(config));
       if (__result.hasError()) [[unlikely]] {

package/nitrogen/generated/ios/swift/HybridTrackPlayerSpec.swift

@@ -26,6 +26,7 @@ public protocol HybridTrackPlayerSpec_protocol: HybridObject {
   func getActualQueue() throws -> Promise<[TrackItem]>
   func getState() throws -> Promise<PlayerState>
   func setRepeatMode(mode: RepeatMode) throws -> Bool
+  func getRepeatMode() throws -> RepeatMode
   func configure(config: PlayerConfig) throws -> Void
   func onChangeTrack(callback: @escaping (_ track: TrackItem, _ reason: Reason?) -> Void) throws -> Void
   func onPlaybackStateChange(callback: @escaping (_ state: TrackPlayerState, _ reason: Reason?) -> Void) throws -> Void

package/nitrogen/generated/ios/swift/HybridTrackPlayerSpec_cxx.swift

@@ -311,6 +311,18 @@ open class HybridTrackPlayerSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func getRepeatMode() -> bridge.Result_RepeatMode_ {
+    do {
+      let __result = try self.__implementation.getRepeatMode()
+      let __resultCpp = __result
+      return bridge.create_Result_RepeatMode_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_RepeatMode_(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func configure(config: PlayerConfig) -> bridge.Result_void_ {
     do {

package/nitrogen/generated/ios/swift/Reason.swift

@@ -25,6 +25,8 @@ public extension Reason {
         self = .end
       case "error":
         self = .error
+      case "repeat":
+        self = .repeat
       default:
         return nil
     }
@@ -43,6 +45,8 @@ public extension Reason {
         return "end"
       case .error:
         return "error"
+      case .repeat:
+        return "repeat"
     }
   }
 }

package/nitrogen/generated/shared/c++/HybridTrackPlayerSpec.cpp

@@ -26,6 +26,7 @@ namespace margelo::nitro::nitroplayer {
       prototype.registerHybridMethod("getActualQueue", &HybridTrackPlayerSpec::getActualQueue);
       prototype.registerHybridMethod("getState", &HybridTrackPlayerSpec::getState);
       prototype.registerHybridMethod("setRepeatMode", &HybridTrackPlayerSpec::setRepeatMode);
+      prototype.registerHybridMethod("getRepeatMode", &HybridTrackPlayerSpec::getRepeatMode);
       prototype.registerHybridMethod("configure", &HybridTrackPlayerSpec::configure);
       prototype.registerHybridMethod("onChangeTrack", &HybridTrackPlayerSpec::onChangeTrack);
       prototype.registerHybridMethod("onPlaybackStateChange", &HybridTrackPlayerSpec::onPlaybackStateChange);

package/nitrogen/generated/shared/c++/HybridTrackPlayerSpec.hpp

@@ -81,6 +81,7 @@ namespace margelo::nitro::nitroplayer {
       virtual std::shared_ptr<Promise<std::vector<TrackItem>>> getActualQueue() = 0;
       virtual std::shared_ptr<Promise<PlayerState>> getState() = 0;
       virtual bool setRepeatMode(RepeatMode mode) = 0;
+      virtual RepeatMode getRepeatMode() = 0;
       virtual void configure(const PlayerConfig& config) = 0;
       virtual void onChangeTrack(const std::function<void(const TrackItem& /* track */, std::optional<Reason> /* reason */)>& callback) = 0;
       virtual void onPlaybackStateChange(const std::function<void(TrackPlayerState /* state */, std::optional<Reason> /* reason */)>& callback) = 0;

package/nitrogen/generated/shared/c++/Reason.hpp

@@ -33,6 +33,7 @@ namespace margelo::nitro::nitroplayer {
     SKIP      SWIFT_NAME(skip) = 1,
     END      SWIFT_NAME(end) = 2,
     ERROR      SWIFT_NAME(error) = 3,
+    REPEAT      SWIFT_NAME(repeat) = 4,
   } CLOSED_ENUM;
 
 } // namespace margelo::nitro::nitroplayer
@@ -49,6 +50,7 @@ namespace margelo::nitro {
         case hashString("skip"): return margelo::nitro::nitroplayer::Reason::SKIP;
         case hashString("end"): return margelo::nitro::nitroplayer::Reason::END;
         case hashString("error"): return margelo::nitro::nitroplayer::Reason::ERROR;
+        case hashString("repeat"): return margelo::nitro::nitroplayer::Reason::REPEAT;
         default: [[unlikely]]
           throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum Reason - invalid value!");
       }
@@ -59,6 +61,7 @@ namespace margelo::nitro {
         case margelo::nitro::nitroplayer::Reason::SKIP: return JSIConverter<std::string>::toJSI(runtime, "skip");
         case margelo::nitro::nitroplayer::Reason::END: return JSIConverter<std::string>::toJSI(runtime, "end");
         case margelo::nitro::nitroplayer::Reason::ERROR: return JSIConverter<std::string>::toJSI(runtime, "error");
+        case margelo::nitro::nitroplayer::Reason::REPEAT: return JSIConverter<std::string>::toJSI(runtime, "repeat");
         default: [[unlikely]]
           throw std::invalid_argument("Cannot convert Reason to JS - invalid value: "
                                     + std::to_string(static_cast<int>(arg)) + "!");
@@ -74,6 +77,7 @@ namespace margelo::nitro {
         case hashString("skip"):
         case hashString("end"):
         case hashString("error"):
+        case hashString("repeat"):
           return true;
         default:
           return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-player",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "A powerful audio player library for React Native with playlist management, playback controls, and support for Android Auto and CarPlay",
   "main": "lib/index",
   "module": "lib/index",

package/src/specs/TrackPlayer.nitro.ts

@@ -70,6 +70,7 @@ export interface TrackPlayer
   getActualQueue(): Promise<TrackItem[]>
   getState(): Promise<PlayerState>
   setRepeatMode(mode: RepeatMode): boolean
+  getRepeatMode(): RepeatMode
   configure(config: PlayerConfig): void
   onChangeTrack(callback: (track: TrackItem, reason?: Reason) => void): void
   onPlaybackStateChange(

package/src/types/PlayerQueue.ts

@@ -28,7 +28,7 @@ export type QueueOperation = 'add' | 'remove' | 'clear' | 'update'
 
 export type TrackPlayerState = 'playing' | 'paused' | 'stopped'
 
-export type Reason = 'user_action' | 'skip' | 'end' | 'error'
+export type Reason = 'user_action' | 'skip' | 'end' | 'error' | 'repeat'
 
 export interface PlayerState {
   currentTrack: TrackItem | null