react-native-nitro-player 0.5.3 → 0.5.4

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.3",
+  "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