react-native-queue-player 1.0.7 → 1.0.9

package/nitrogen/generated/android/kotlin/com/margelo/nitro/queueplayer/Func_void_std__vector_TrackItem__double_QueueChangeReason.kt

@@ -0,0 +1,80 @@
+///
+/// Func_void_std__vector_TrackItem__double_QueueChangeReason.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.queueplayer
+
+import androidx.annotation.Keep
+import com.facebook.jni.HybridData
+import com.facebook.proguard.annotations.DoNotStrip
+import dalvik.annotation.optimization.FastNative
+
+
+/**
+ * Represents the JavaScript callback `(queue: array, currentIndex: number, reason: enum) => void`.
+ * This can be either implemented in C++ (in which case it might be a callback coming from JS),
+ * or in Kotlin/Java (in which case it is a native callback).
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType")
+fun interface Func_void_std__vector_TrackItem__double_QueueChangeReason: (Array<TrackItem>, Double, QueueChangeReason) -> Unit {
+  /**
+   * Call the given JS callback.
+   * @throws Throwable if the JS function itself throws an error, or if the JS function/runtime has already been deleted.
+   */
+  @DoNotStrip
+  @Keep
+  override fun invoke(queue: Array<TrackItem>, currentIndex: Double, reason: QueueChangeReason): Unit
+}
+
+/**
+ * Represents the JavaScript callback `(queue: array, currentIndex: number, reason: enum) => void`.
+ * This is implemented in C++, via a `std::function<...>`.
+ * The callback might be coming from JS.
+ */
+@DoNotStrip
+@Keep
+@Suppress(
+  "KotlinJniMissingFunction", "unused",
+  "RedundantSuppression", "RedundantUnitReturnType", "FunctionName",
+  "ConvertSecondaryConstructorToPrimary", "ClassName", "LocalVariableName",
+)
+class Func_void_std__vector_TrackItem__double_QueueChangeReason_cxx: Func_void_std__vector_TrackItem__double_QueueChangeReason {
+  @DoNotStrip
+  @Keep
+  private val mHybridData: HybridData
+
+  @DoNotStrip
+  @Keep
+  private constructor(hybridData: HybridData) {
+    mHybridData = hybridData
+  }
+
+  @DoNotStrip
+  @Keep
+  override fun invoke(queue: Array<TrackItem>, currentIndex: Double, reason: QueueChangeReason): Unit
+    = invoke_cxx(queue,currentIndex,reason)
+
+  @FastNative
+  private external fun invoke_cxx(queue: Array<TrackItem>, currentIndex: Double, reason: QueueChangeReason): Unit
+}
+
+/**
+ * Represents the JavaScript callback `(queue: array, currentIndex: number, reason: enum) => void`.
+ * This is implemented in Java/Kotlin, via a `(Array<TrackItem>, Double, QueueChangeReason) -> Unit`.
+ * The callback is always coming from native.
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType", "unused")
+class Func_void_std__vector_TrackItem__double_QueueChangeReason_java(private val function: (Array<TrackItem>, Double, QueueChangeReason) -> Unit): Func_void_std__vector_TrackItem__double_QueueChangeReason {
+  @DoNotStrip
+  @Keep
+  override fun invoke(queue: Array<TrackItem>, currentIndex: Double, reason: QueueChangeReason): Unit {
+    return this.function(queue, currentIndex, reason)
+  }
+}

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

@@ -212,6 +212,15 @@ abstract class HybridTrackPlayerSpec: HybridObject() {
     return Func_void_java(__result)
   }
   
+  abstract fun onQueueChange(callback: (queue: Array<TrackItem>, currentIndex: Double, reason: QueueChangeReason) -> Unit): () -> Unit
+  
+  @DoNotStrip
+  @Keep
+  private fun onQueueChange_cxx(callback: Func_void_std__vector_TrackItem__double_QueueChangeReason): Func_void {
+    val __result = onQueueChange(callback)
+    return Func_void_java(__result)
+  }
+  
   abstract fun onProgress(callback: (progress: PlayerProgress) -> Unit): () -> Unit
   
   @DoNotStrip

package/nitrogen/generated/android/kotlin/com/margelo/nitro/queueplayer/PlayerConfig.kt

@@ -26,6 +26,9 @@ data class PlayerConfig(
   val userAgent: String?,
   @DoNotStrip
   @Keep
+  val placeholderArtworkUri: String?,
+  @DoNotStrip
+  @Keep
   val autoRetries: Double?,
   @DoNotStrip
   @Keep
@@ -65,6 +68,7 @@ data class PlayerConfig(
     if (other !is PlayerConfig) return false
     return Objects.deepEquals(this.httpHeaders, other.httpHeaders)
       && Objects.deepEquals(this.userAgent, other.userAgent)
+      && Objects.deepEquals(this.placeholderArtworkUri, other.placeholderArtworkUri)
       && Objects.deepEquals(this.autoRetries, other.autoRetries)
       && Objects.deepEquals(this.retryBackoffMs, other.retryBackoffMs)
       && Objects.deepEquals(this.networkTimeoutMs, other.networkTimeoutMs)
@@ -82,6 +86,7 @@ data class PlayerConfig(
     return arrayOf<Any?>(
       httpHeaders,
       userAgent,
+      placeholderArtworkUri,
       autoRetries,
       retryBackoffMs,
       networkTimeoutMs,
@@ -104,8 +109,8 @@ data class PlayerConfig(
     @Keep
     @Suppress("unused")
     @JvmStatic
-    private fun fromCpp(httpHeaders: Map<String, String>?, userAgent: String?, autoRetries: Double?, retryBackoffMs: Double?, networkTimeoutMs: Double?, audioContentType: AudioContentType?, audioCategoryOptions: AudioCategoryOptions?, visualizationEnabled: Boolean?, clampSeekToBuffered: Boolean?, lookaheadCacheMaxSizeMb: Double?, lookaheadCacheEvictionPolicy: EvictionPolicy?, progressUpdateIntervalMs: Double?, backgroundProgressUpdateIntervalMs: Double?): PlayerConfig {
-      return PlayerConfig(httpHeaders, userAgent, autoRetries, retryBackoffMs, networkTimeoutMs, audioContentType, audioCategoryOptions, visualizationEnabled, clampSeekToBuffered, lookaheadCacheMaxSizeMb, lookaheadCacheEvictionPolicy, progressUpdateIntervalMs, backgroundProgressUpdateIntervalMs)
+    private fun fromCpp(httpHeaders: Map<String, String>?, userAgent: String?, placeholderArtworkUri: String?, autoRetries: Double?, retryBackoffMs: Double?, networkTimeoutMs: Double?, audioContentType: AudioContentType?, audioCategoryOptions: AudioCategoryOptions?, visualizationEnabled: Boolean?, clampSeekToBuffered: Boolean?, lookaheadCacheMaxSizeMb: Double?, lookaheadCacheEvictionPolicy: EvictionPolicy?, progressUpdateIntervalMs: Double?, backgroundProgressUpdateIntervalMs: Double?): PlayerConfig {
+      return PlayerConfig(httpHeaders, userAgent, placeholderArtworkUri, autoRetries, retryBackoffMs, networkTimeoutMs, audioContentType, audioCategoryOptions, visualizationEnabled, clampSeekToBuffered, lookaheadCacheMaxSizeMb, lookaheadCacheEvictionPolicy, progressUpdateIntervalMs, backgroundProgressUpdateIntervalMs)
     }
   }
 }

package/nitrogen/generated/android/kotlin/com/margelo/nitro/queueplayer/QueueChangeReason.kt

@@ -0,0 +1,27 @@
+///
+/// QueueChangeReason.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.queueplayer
+
+import androidx.annotation.Keep
+import com.facebook.proguard.annotations.DoNotStrip
+
+/**
+ * Represents the JavaScript enum/union "QueueChangeReason".
+ */
+@DoNotStrip
+@Keep
+enum class QueueChangeReason(@DoNotStrip @Keep val value: Int) {
+  SET_QUEUE(0),
+  ADD(1),
+  REMOVE(2),
+  MOVE(3),
+  CLEAR(4),
+  SHUFFLE(5);
+
+  companion object
+}

package/nitrogen/generated/android/queueplayerOnLoad.cpp

@@ -29,6 +29,7 @@
 #include "JHybridTrackPlayerSpec.hpp"
 #include "JFunc_void_PlayerState_StateChangeReason.hpp"
 #include "JFunc_void_std__optional_TrackItem__double_TrackChangeReason_std__optional_double_.hpp"
+#include "JFunc_void_std__vector_TrackItem__double_QueueChangeReason.hpp"
 #include "JFunc_void_PlayerProgress.hpp"
 #include "JFunc_void_double_double.hpp"
 #include "JFunc_void_PlaybackError.hpp"
@@ -106,6 +107,7 @@ void registerAllNatives() {
   margelo::nitro::queueplayer::JHybridTrackPlayerSpec::CxxPart::registerNatives();
   margelo::nitro::queueplayer::JFunc_void_PlayerState_StateChangeReason_cxx::registerNatives();
   margelo::nitro::queueplayer::JFunc_void_std__optional_TrackItem__double_TrackChangeReason_std__optional_double__cxx::registerNatives();
+  margelo::nitro::queueplayer::JFunc_void_std__vector_TrackItem__double_QueueChangeReason_cxx::registerNatives();
   margelo::nitro::queueplayer::JFunc_void_PlayerProgress_cxx::registerNatives();
   margelo::nitro::queueplayer::JFunc_void_double_double_cxx::registerNatives();
   margelo::nitro::queueplayer::JFunc_void_PlaybackError_cxx::registerNatives();

package/nitrogen/generated/ios/QueuePlayer-Swift-Cxx-Bridge.cpp

@@ -161,6 +161,14 @@ namespace margelo::nitro::queueplayer::bridge::swift {
     };
   }
   
+  // pragma MARK: std::function<void(const std::vector<TrackItem>& /* queue */, double /* currentIndex */, QueueChangeReason /* reason */)>
+  Func_void_std__vector_TrackItem__double_QueueChangeReason create_Func_void_std__vector_TrackItem__double_QueueChangeReason(void* NON_NULL swiftClosureWrapper) noexcept {
+    auto swiftClosure = QueuePlayer::Func_void_std__vector_TrackItem__double_QueueChangeReason::fromUnsafe(swiftClosureWrapper);
+    return [swiftClosure = std::move(swiftClosure)](const std::vector<TrackItem>& queue, double currentIndex, QueueChangeReason reason) mutable -> void {
+      swiftClosure.call(queue, currentIndex, static_cast<int>(reason));
+    };
+  }
+  
   // pragma MARK: std::function<void(const PlayerProgress& /* progress */)>
   Func_void_PlayerProgress create_Func_void_PlayerProgress(void* NON_NULL swiftClosureWrapper) noexcept {
     auto swiftClosure = QueuePlayer::Func_void_PlayerProgress::fromUnsafe(swiftClosureWrapper);

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

@@ -98,6 +98,8 @@ namespace margelo::nitro::queueplayer { struct PlaybackMode; }
 namespace margelo::nitro::queueplayer { struct PlayerProgress; }
 // Forward declaration of `PlayerState` to properly resolve imports.
 namespace margelo::nitro::queueplayer { enum class PlayerState; }
+// Forward declaration of `QueueChangeReason` to properly resolve imports.
+namespace margelo::nitro::queueplayer { enum class QueueChangeReason; }
 // Forward declaration of `RemoteControlOptions` to properly resolve imports.
 namespace margelo::nitro::queueplayer { struct RemoteControlOptions; }
 // Forward declaration of `ReplayGainMode` to properly resolve imports.
@@ -180,6 +182,7 @@ namespace QueuePlayer { class HybridVisualizerSpec_cxx; }
 #include "PlaybackMode.hpp"
 #include "PlayerProgress.hpp"
 #include "PlayerState.hpp"
+#include "QueueChangeReason.hpp"
 #include "RemoteControlOptions.hpp"
 #include "ReplayGainMode.hpp"
 #include "SectionIcon.hpp"
@@ -916,6 +919,28 @@ namespace margelo::nitro::queueplayer::bridge::swift {
     return Func_void_std__optional_TrackItem__double_TrackChangeReason_std__optional_double__Wrapper(std::move(value));
   }
   
+  // pragma MARK: std::function<void(const std::vector<TrackItem>& /* queue */, double /* currentIndex */, QueueChangeReason /* reason */)>
+  /**
+   * Specialized version of `std::function<void(const std::vector<TrackItem>&, double, QueueChangeReason)>`.
+   */
+  using Func_void_std__vector_TrackItem__double_QueueChangeReason = std::function<void(const std::vector<TrackItem>& /* queue */, double /* currentIndex */, QueueChangeReason /* reason */)>;
+  /**
+   * Wrapper class for a `std::function<void(const std::vector<TrackItem>& / * queue * /, double / * currentIndex * /, QueueChangeReason / * reason * /)>`, this can be used from Swift.
+   */
+  class Func_void_std__vector_TrackItem__double_QueueChangeReason_Wrapper final {
+  public:
+    explicit Func_void_std__vector_TrackItem__double_QueueChangeReason_Wrapper(std::function<void(const std::vector<TrackItem>& /* queue */, double /* currentIndex */, QueueChangeReason /* reason */)>&& func): _function(std::make_unique<std::function<void(const std::vector<TrackItem>& /* queue */, double /* currentIndex */, QueueChangeReason /* reason */)>>(std::move(func))) {}
+    inline void call(std::vector<TrackItem> queue, double currentIndex, int reason) const noexcept {
+      _function->operator()(queue, currentIndex, static_cast<QueueChangeReason>(reason));
+    }
+  private:
+    std::unique_ptr<std::function<void(const std::vector<TrackItem>& /* queue */, double /* currentIndex */, QueueChangeReason /* reason */)>> _function;
+  } SWIFT_NONCOPYABLE;
+  Func_void_std__vector_TrackItem__double_QueueChangeReason create_Func_void_std__vector_TrackItem__double_QueueChangeReason(void* NON_NULL swiftClosureWrapper) noexcept;
+  inline Func_void_std__vector_TrackItem__double_QueueChangeReason_Wrapper wrap_Func_void_std__vector_TrackItem__double_QueueChangeReason(Func_void_std__vector_TrackItem__double_QueueChangeReason value) noexcept {
+    return Func_void_std__vector_TrackItem__double_QueueChangeReason_Wrapper(std::move(value));
+  }
+  
   // pragma MARK: std::function<void(const PlayerProgress& /* progress */)>
   /**
    * Specialized version of `std::function<void(const PlayerProgress&)>`.

package/nitrogen/generated/ios/QueuePlayer-Swift-Cxx-Umbrella.hpp

@@ -108,6 +108,8 @@ namespace margelo::nitro::queueplayer { struct PlayerConfig; }
 namespace margelo::nitro::queueplayer { struct PlayerProgress; }
 // Forward declaration of `PlayerState` to properly resolve imports.
 namespace margelo::nitro::queueplayer { enum class PlayerState; }
+// Forward declaration of `QueueChangeReason` to properly resolve imports.
+namespace margelo::nitro::queueplayer { enum class QueueChangeReason; }
 // Forward declaration of `RemoteControlOptions` to properly resolve imports.
 namespace margelo::nitro::queueplayer { struct RemoteControlOptions; }
 // Forward declaration of `RemoteSkipMode` to properly resolve imports.
@@ -194,6 +196,7 @@ namespace margelo::nitro::queueplayer { struct VoiceVocabulary; }
 #include "PlayerConfig.hpp"
 #include "PlayerProgress.hpp"
 #include "PlayerState.hpp"
+#include "QueueChangeReason.hpp"
 #include "RemoteControlOptions.hpp"
 #include "RemoteSkipMode.hpp"
 #include "RepeatMode.hpp"

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

@@ -50,6 +50,8 @@ namespace margelo::nitro::queueplayer { struct SleepTimerState; }
 namespace margelo::nitro::queueplayer { enum class StateChangeReason; }
 // Forward declaration of `TrackChangeReason` to properly resolve imports.
 namespace margelo::nitro::queueplayer { enum class TrackChangeReason; }
+// Forward declaration of `QueueChangeReason` to properly resolve imports.
+namespace margelo::nitro::queueplayer { enum class QueueChangeReason; }
 // Forward declaration of `PlayerProgress` to properly resolve imports.
 namespace margelo::nitro::queueplayer { struct PlayerProgress; }
 // Forward declaration of `PlaybackError` to properly resolve imports.
@@ -124,6 +126,7 @@ namespace margelo::nitro::queueplayer { struct NowPlayingFormatAndroidExtras; }
 #include <functional>
 #include "StateChangeReason.hpp"
 #include "TrackChangeReason.hpp"
+#include "QueueChangeReason.hpp"
 #include "PlayerProgress.hpp"
 #include "PlaybackError.hpp"
 #include "PlaybackErrorCode.hpp"
@@ -545,6 +548,14 @@ namespace margelo::nitro::queueplayer {
       auto __value = std::move(__result.value());
       return __value;
     }
+    inline std::function<void()> onQueueChange(const std::function<void(const std::vector<TrackItem>& /* queue */, double /* currentIndex */, QueueChangeReason /* reason */)>& callback) override {
+      auto __result = _swiftPart.onQueueChange(callback);
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
     inline std::function<void()> onProgress(const std::function<void(const PlayerProgress& /* progress */)>& callback) override {
       auto __result = _swiftPart.onProgress(callback);
       if (__result.hasError()) [[unlikely]] {

package/nitrogen/generated/ios/swift/Func_void_std__vector_TrackItem__double_QueueChangeReason.swift

@@ -0,0 +1,46 @@
+///
+/// Func_void_std__vector_TrackItem__double_QueueChangeReason.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Wraps a Swift `(_ queue: [TrackItem], _ currentIndex: Double, _ reason: QueueChangeReason) -> Void` as a class.
+ * This class can be used from C++, e.g. to wrap the Swift closure as a `std::function`.
+ */
+public final class Func_void_std__vector_TrackItem__double_QueueChangeReason {
+  public typealias bridge = margelo.nitro.queueplayer.bridge.swift
+
+  private let closure: (_ queue: [TrackItem], _ currentIndex: Double, _ reason: QueueChangeReason) -> Void
+
+  public init(_ closure: @escaping (_ queue: [TrackItem], _ currentIndex: Double, _ reason: QueueChangeReason) -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call(queue: bridge.std__vector_TrackItem_, currentIndex: Double, reason: Int32) -> Void {
+    self.closure(queue.map({ __item in __item }), currentIndex, margelo.nitro.queueplayer.QueueChangeReason(rawValue: reason)!)
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  @inline(__always)
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `Func_void_std__vector_TrackItem__double_QueueChangeReason`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void_std__vector_TrackItem__double_QueueChangeReason>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void_std__vector_TrackItem__double_QueueChangeReason {
+    return Unmanaged<Func_void_std__vector_TrackItem__double_QueueChangeReason>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

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

@@ -56,6 +56,7 @@ public protocol HybridTrackPlayerSpec_protocol: HybridObject {
   func getSleepTimer() throws -> SleepTimerState
   func onStateChange(callback: @escaping (_ state: PlayerState, _ reason: StateChangeReason) -> Void) throws -> () -> Void
   func onTrackChange(callback: @escaping (_ track: TrackItem?, _ index: Double, _ reason: TrackChangeReason, _ transitionGapMs: Double?) -> Void) throws -> () -> Void
+  func onQueueChange(callback: @escaping (_ queue: [TrackItem], _ currentIndex: Double, _ reason: QueueChangeReason) -> Void) throws -> () -> Void
   func onProgress(callback: @escaping (_ progress: PlayerProgress) -> Void) throws -> () -> Void
   func onPlaybackMilestone(callback: @escaping (_ milestone: Double, _ trackIndex: Double) -> Void) throws -> () -> Void
   func onError(callback: @escaping (_ error: PlaybackError) -> Void) throws -> () -> Void

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

@@ -869,6 +869,32 @@ open class HybridTrackPlayerSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func onQueueChange(callback: bridge.Func_void_std__vector_TrackItem__double_QueueChangeReason) -> bridge.Result_std__function_void____ {
+    do {
+      let __result = try self.__implementation.onQueueChange(callback: { () -> ([TrackItem], Double, QueueChangeReason) -> Void in
+        let __wrappedFunction = bridge.wrap_Func_void_std__vector_TrackItem__double_QueueChangeReason(callback)
+        return { (__queue: [TrackItem], __currentIndex: Double, __reason: QueueChangeReason) -> Void in
+          __wrappedFunction.call({ () -> bridge.std__vector_TrackItem_ in
+            var __vector = bridge.create_std__vector_TrackItem_(__queue.count)
+            for __item in __queue {
+              __vector.push_back(__item)
+            }
+            return __vector
+          }(), __currentIndex, __reason.rawValue)
+        }
+      }())
+      let __resultCpp = { () -> bridge.Func_void in
+        let __closureWrapper = Func_void(__result)
+        return bridge.create_Func_void(__closureWrapper.toUnsafe())
+      }()
+      return bridge.create_Result_std__function_void____(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__function_void____(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func onProgress(callback: bridge.Func_void_PlayerProgress) -> bridge.Result_std__function_void____ {
     do {

package/nitrogen/generated/ios/swift/PlayerConfig.swift

@@ -18,7 +18,7 @@ public extension PlayerConfig {
   /**
    * Create a new instance of `PlayerConfig`.
    */
-  init(httpHeaders: Dictionary<String, String>?, userAgent: String?, autoRetries: Double?, retryBackoffMs: Double?, networkTimeoutMs: Double?, audioContentType: AudioContentType?, audioCategoryOptions: AudioCategoryOptions?, visualizationEnabled: Bool?, clampSeekToBuffered: Bool?, lookaheadCacheMaxSizeMb: Double?, lookaheadCacheEvictionPolicy: EvictionPolicy?, progressUpdateIntervalMs: Double?, backgroundProgressUpdateIntervalMs: Double?) {
+  init(httpHeaders: Dictionary<String, String>?, userAgent: String?, placeholderArtworkUri: String?, autoRetries: Double?, retryBackoffMs: Double?, networkTimeoutMs: Double?, audioContentType: AudioContentType?, audioCategoryOptions: AudioCategoryOptions?, visualizationEnabled: Bool?, clampSeekToBuffered: Bool?, lookaheadCacheMaxSizeMb: Double?, lookaheadCacheEvictionPolicy: EvictionPolicy?, progressUpdateIntervalMs: Double?, backgroundProgressUpdateIntervalMs: Double?) {
     self.init({ () -> bridge.std__optional_std__unordered_map_std__string__std__string__ in
       if let __unwrappedValue = httpHeaders {
         return bridge.create_std__optional_std__unordered_map_std__string__std__string__({ () -> bridge.std__unordered_map_std__string__std__string_ in
@@ -37,6 +37,12 @@ public extension PlayerConfig {
       } else {
         return .init()
       }
+    }(), { () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = placeholderArtworkUri {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
     }(), { () -> bridge.std__optional_double_ in
       if let __unwrappedValue = autoRetries {
         return bridge.create_std__optional_double_(__unwrappedValue)
@@ -138,6 +144,18 @@ public extension PlayerConfig {
     }()
   }
   
+  @inline(__always)
+  var placeholderArtworkUri: String? {
+    return { () -> String? in
+      if bridge.has_value_std__optional_std__string_(self.__placeholderArtworkUri) {
+        let __unwrapped = bridge.get_std__optional_std__string_(self.__placeholderArtworkUri)
+        return String(__unwrapped)
+      } else {
+        return nil
+      }
+    }()
+  }
+  
   @inline(__always)
   var autoRetries: Double? {
     return { () -> Double? in

package/nitrogen/generated/ios/swift/QueueChangeReason.swift

@@ -0,0 +1,56 @@
+///
+/// QueueChangeReason.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+/**
+ * Represents the JS union `QueueChangeReason`, backed by a C++ enum.
+ */
+public typealias QueueChangeReason = margelo.nitro.queueplayer.QueueChangeReason
+
+public extension QueueChangeReason {
+  /**
+   * Get a QueueChangeReason for the given String value, or
+   * return `nil` if the given value was invalid/unknown.
+   */
+  init?(fromString string: String) {
+    switch string {
+      case "set-queue":
+        self = .setQueue
+      case "add":
+        self = .add
+      case "remove":
+        self = .remove
+      case "move":
+        self = .move
+      case "clear":
+        self = .clear
+      case "shuffle":
+        self = .shuffle
+      default:
+        return nil
+    }
+  }
+
+  /**
+   * Get the String value this QueueChangeReason represents.
+   */
+  var stringValue: String {
+    switch self {
+      case .setQueue:
+        return "set-queue"
+      case .add:
+        return "add"
+      case .remove:
+        return "remove"
+      case .move:
+        return "move"
+      case .clear:
+        return "clear"
+      case .shuffle:
+        return "shuffle"
+    }
+  }
+}

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

@@ -57,6 +57,7 @@ namespace margelo::nitro::queueplayer {
       prototype.registerHybridMethod("getSleepTimer", &HybridTrackPlayerSpec::getSleepTimer);
       prototype.registerHybridMethod("onStateChange", &HybridTrackPlayerSpec::onStateChange);
       prototype.registerHybridMethod("onTrackChange", &HybridTrackPlayerSpec::onTrackChange);
+      prototype.registerHybridMethod("onQueueChange", &HybridTrackPlayerSpec::onQueueChange);
       prototype.registerHybridMethod("onProgress", &HybridTrackPlayerSpec::onProgress);
       prototype.registerHybridMethod("onPlaybackMilestone", &HybridTrackPlayerSpec::onPlaybackMilestone);
       prototype.registerHybridMethod("onError", &HybridTrackPlayerSpec::onError);

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

@@ -41,6 +41,8 @@ namespace margelo::nitro::queueplayer { struct SleepTimerState; }
 namespace margelo::nitro::queueplayer { enum class StateChangeReason; }
 // Forward declaration of `TrackChangeReason` to properly resolve imports.
 namespace margelo::nitro::queueplayer { enum class TrackChangeReason; }
+// Forward declaration of `QueueChangeReason` to properly resolve imports.
+namespace margelo::nitro::queueplayer { enum class QueueChangeReason; }
 // Forward declaration of `PlayerProgress` to properly resolve imports.
 namespace margelo::nitro::queueplayer { struct PlayerProgress; }
 // Forward declaration of `PlaybackError` to properly resolve imports.
@@ -82,6 +84,7 @@ namespace margelo::nitro::queueplayer { struct NowPlayingFormat; }
 #include <functional>
 #include "StateChangeReason.hpp"
 #include "TrackChangeReason.hpp"
+#include "QueueChangeReason.hpp"
 #include "PlayerProgress.hpp"
 #include "PlaybackError.hpp"
 #include "BrowseSnapshot.hpp"
@@ -171,6 +174,7 @@ namespace margelo::nitro::queueplayer {
       virtual SleepTimerState getSleepTimer() = 0;
       virtual std::function<void()> onStateChange(const std::function<void(PlayerState /* state */, StateChangeReason /* reason */)>& callback) = 0;
       virtual std::function<void()> onTrackChange(const std::function<void(const std::optional<TrackItem>& /* track */, double /* index */, TrackChangeReason /* reason */, std::optional<double> /* transitionGapMs */)>& callback) = 0;
+      virtual std::function<void()> onQueueChange(const std::function<void(const std::vector<TrackItem>& /* queue */, double /* currentIndex */, QueueChangeReason /* reason */)>& callback) = 0;
       virtual std::function<void()> onProgress(const std::function<void(const PlayerProgress& /* progress */)>& callback) = 0;
       virtual std::function<void()> onPlaybackMilestone(const std::function<void(double /* milestone */, double /* trackIndex */)>& callback) = 0;
       virtual std::function<void()> onError(const std::function<void(const PlaybackError& /* error */)>& callback) = 0;

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

@@ -51,6 +51,7 @@ namespace margelo::nitro::queueplayer {
   public:
     std::optional<std::unordered_map<std::string, std::string>> httpHeaders     SWIFT_PRIVATE;
     std::optional<std::string> userAgent     SWIFT_PRIVATE;
+    std::optional<std::string> placeholderArtworkUri     SWIFT_PRIVATE;
     std::optional<double> autoRetries     SWIFT_PRIVATE;
     std::optional<double> retryBackoffMs     SWIFT_PRIVATE;
     std::optional<double> networkTimeoutMs     SWIFT_PRIVATE;
@@ -65,7 +66,7 @@ namespace margelo::nitro::queueplayer {
 
   public:
     PlayerConfig() = default;
-    explicit PlayerConfig(std::optional<std::unordered_map<std::string, std::string>> httpHeaders, std::optional<std::string> userAgent, std::optional<double> autoRetries, std::optional<double> retryBackoffMs, std::optional<double> networkTimeoutMs, std::optional<AudioContentType> audioContentType, std::optional<AudioCategoryOptions> audioCategoryOptions, std::optional<bool> visualizationEnabled, std::optional<bool> clampSeekToBuffered, std::optional<double> lookaheadCacheMaxSizeMb, std::optional<EvictionPolicy> lookaheadCacheEvictionPolicy, std::optional<double> progressUpdateIntervalMs, std::optional<double> backgroundProgressUpdateIntervalMs): httpHeaders(httpHeaders), userAgent(userAgent), autoRetries(autoRetries), retryBackoffMs(retryBackoffMs), networkTimeoutMs(networkTimeoutMs), audioContentType(audioContentType), audioCategoryOptions(audioCategoryOptions), visualizationEnabled(visualizationEnabled), clampSeekToBuffered(clampSeekToBuffered), lookaheadCacheMaxSizeMb(lookaheadCacheMaxSizeMb), lookaheadCacheEvictionPolicy(lookaheadCacheEvictionPolicy), progressUpdateIntervalMs(progressUpdateIntervalMs), backgroundProgressUpdateIntervalMs(backgroundProgressUpdateIntervalMs) {}
+    explicit PlayerConfig(std::optional<std::unordered_map<std::string, std::string>> httpHeaders, std::optional<std::string> userAgent, std::optional<std::string> placeholderArtworkUri, std::optional<double> autoRetries, std::optional<double> retryBackoffMs, std::optional<double> networkTimeoutMs, std::optional<AudioContentType> audioContentType, std::optional<AudioCategoryOptions> audioCategoryOptions, std::optional<bool> visualizationEnabled, std::optional<bool> clampSeekToBuffered, std::optional<double> lookaheadCacheMaxSizeMb, std::optional<EvictionPolicy> lookaheadCacheEvictionPolicy, std::optional<double> progressUpdateIntervalMs, std::optional<double> backgroundProgressUpdateIntervalMs): httpHeaders(httpHeaders), userAgent(userAgent), placeholderArtworkUri(placeholderArtworkUri), autoRetries(autoRetries), retryBackoffMs(retryBackoffMs), networkTimeoutMs(networkTimeoutMs), audioContentType(audioContentType), audioCategoryOptions(audioCategoryOptions), visualizationEnabled(visualizationEnabled), clampSeekToBuffered(clampSeekToBuffered), lookaheadCacheMaxSizeMb(lookaheadCacheMaxSizeMb), lookaheadCacheEvictionPolicy(lookaheadCacheEvictionPolicy), progressUpdateIntervalMs(progressUpdateIntervalMs), backgroundProgressUpdateIntervalMs(backgroundProgressUpdateIntervalMs) {}
 
   public:
     friend bool operator==(const PlayerConfig& lhs, const PlayerConfig& rhs) = default;
@@ -83,6 +84,7 @@ namespace margelo::nitro {
       return margelo::nitro::queueplayer::PlayerConfig(
         JSIConverter<std::optional<std::unordered_map<std::string, std::string>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "httpHeaders"))),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "userAgent"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "placeholderArtworkUri"))),
         JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "autoRetries"))),
         JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "retryBackoffMs"))),
         JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "networkTimeoutMs"))),
@@ -100,6 +102,7 @@ namespace margelo::nitro {
       jsi::Object obj(runtime);
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "httpHeaders"), JSIConverter<std::optional<std::unordered_map<std::string, std::string>>>::toJSI(runtime, arg.httpHeaders));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "userAgent"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.userAgent));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "placeholderArtworkUri"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.placeholderArtworkUri));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "autoRetries"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.autoRetries));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "retryBackoffMs"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.retryBackoffMs));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "networkTimeoutMs"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.networkTimeoutMs));
@@ -123,6 +126,7 @@ namespace margelo::nitro {
       }
       if (!JSIConverter<std::optional<std::unordered_map<std::string, std::string>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "httpHeaders")))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "userAgent")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "placeholderArtworkUri")))) return false;
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "autoRetries")))) return false;
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "retryBackoffMs")))) return false;
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "networkTimeoutMs")))) return false;