react-native-queue-player 1.0.9 → 1.1.0

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

@@ -16,6 +16,8 @@
 #include "JAudioCategoryOptions.hpp"
 #include "JAudioContentType.hpp"
 #include "JEvictionPolicy.hpp"
+#include "JSkipToPreviousBehavior.hpp"
+#include "SkipToPreviousBehavior.hpp"
 #include <optional>
 #include <string>
 #include <unordered_map>
@@ -59,6 +61,8 @@ namespace margelo::nitro::queueplayer {
       jni::local_ref<jni::JBoolean> visualizationEnabled = this->getFieldValue(fieldVisualizationEnabled);
       static const auto fieldClampSeekToBuffered = clazz->getField<jni::JBoolean>("clampSeekToBuffered");
       jni::local_ref<jni::JBoolean> clampSeekToBuffered = this->getFieldValue(fieldClampSeekToBuffered);
+      static const auto fieldSkipToPreviousBehavior = clazz->getField<JSkipToPreviousBehavior>("skipToPreviousBehavior");
+      jni::local_ref<JSkipToPreviousBehavior> skipToPreviousBehavior = this->getFieldValue(fieldSkipToPreviousBehavior);
       static const auto fieldLookaheadCacheMaxSizeMb = clazz->getField<jni::JDouble>("lookaheadCacheMaxSizeMb");
       jni::local_ref<jni::JDouble> lookaheadCacheMaxSizeMb = this->getFieldValue(fieldLookaheadCacheMaxSizeMb);
       static const auto fieldLookaheadCacheEvictionPolicy = clazz->getField<JEvictionPolicy>("lookaheadCacheEvictionPolicy");
@@ -85,6 +89,7 @@ namespace margelo::nitro::queueplayer {
         audioCategoryOptions != nullptr ? std::make_optional(audioCategoryOptions->toCpp()) : std::nullopt,
         visualizationEnabled != nullptr ? std::make_optional(static_cast<bool>(visualizationEnabled->value())) : std::nullopt,
         clampSeekToBuffered != nullptr ? std::make_optional(static_cast<bool>(clampSeekToBuffered->value())) : std::nullopt,
+        skipToPreviousBehavior != nullptr ? std::make_optional(skipToPreviousBehavior->toCpp()) : std::nullopt,
         lookaheadCacheMaxSizeMb != nullptr ? std::make_optional(lookaheadCacheMaxSizeMb->value()) : std::nullopt,
         lookaheadCacheEvictionPolicy != nullptr ? std::make_optional(lookaheadCacheEvictionPolicy->toCpp()) : std::nullopt,
         progressUpdateIntervalMs != nullptr ? std::make_optional(progressUpdateIntervalMs->value()) : std::nullopt,
@@ -98,7 +103,7 @@ namespace margelo::nitro::queueplayer {
      */
     [[maybe_unused]]
     static jni::local_ref<JPlayerConfig::javaobject> fromCpp(const PlayerConfig& value) {
-      using JSignature = JPlayerConfig(jni::alias_ref<jni::JMap<jni::JString, jni::JString>>, jni::alias_ref<jni::JString>, jni::alias_ref<jni::JString>, jni::alias_ref<jni::JDouble>, jni::alias_ref<jni::JDouble>, jni::alias_ref<jni::JDouble>, jni::alias_ref<JAudioContentType>, jni::alias_ref<JAudioCategoryOptions>, jni::alias_ref<jni::JBoolean>, jni::alias_ref<jni::JBoolean>, jni::alias_ref<jni::JDouble>, jni::alias_ref<JEvictionPolicy>, jni::alias_ref<jni::JDouble>, jni::alias_ref<jni::JDouble>);
+      using JSignature = JPlayerConfig(jni::alias_ref<jni::JMap<jni::JString, jni::JString>>, jni::alias_ref<jni::JString>, jni::alias_ref<jni::JString>, jni::alias_ref<jni::JDouble>, jni::alias_ref<jni::JDouble>, jni::alias_ref<jni::JDouble>, jni::alias_ref<JAudioContentType>, jni::alias_ref<JAudioCategoryOptions>, jni::alias_ref<jni::JBoolean>, jni::alias_ref<jni::JBoolean>, jni::alias_ref<JSkipToPreviousBehavior>, jni::alias_ref<jni::JDouble>, jni::alias_ref<JEvictionPolicy>, jni::alias_ref<jni::JDouble>, jni::alias_ref<jni::JDouble>);
       static const auto clazz = javaClassStatic();
       static const auto create = clazz->getStaticMethod<JSignature>("fromCpp");
       return create(
@@ -119,6 +124,7 @@ namespace margelo::nitro::queueplayer {
         value.audioCategoryOptions.has_value() ? JAudioCategoryOptions::fromCpp(value.audioCategoryOptions.value()) : nullptr,
         value.visualizationEnabled.has_value() ? jni::JBoolean::valueOf(value.visualizationEnabled.value()) : nullptr,
         value.clampSeekToBuffered.has_value() ? jni::JBoolean::valueOf(value.clampSeekToBuffered.value()) : nullptr,
+        value.skipToPreviousBehavior.has_value() ? JSkipToPreviousBehavior::fromCpp(value.skipToPreviousBehavior.value()) : nullptr,
         value.lookaheadCacheMaxSizeMb.has_value() ? jni::JDouble::valueOf(value.lookaheadCacheMaxSizeMb.value()) : nullptr,
         value.lookaheadCacheEvictionPolicy.has_value() ? JEvictionPolicy::fromCpp(value.lookaheadCacheEvictionPolicy.value()) : nullptr,
         value.progressUpdateIntervalMs.has_value() ? jni::JDouble::valueOf(value.progressUpdateIntervalMs.value()) : nullptr,

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

@@ -0,0 +1,58 @@
+///
+/// JSkipToPreviousBehavior.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include "SkipToPreviousBehavior.hpp"
+
+namespace margelo::nitro::queueplayer {
+
+  using namespace facebook;
+
+  /**
+   * The C++ JNI bridge between the C++ enum "SkipToPreviousBehavior" and the Kotlin enum "SkipToPreviousBehavior".
+   */
+  struct JSkipToPreviousBehavior final: public jni::JavaClass<JSkipToPreviousBehavior> {
+  public:
+    static constexpr auto kJavaDescriptor = "Lcom/margelo/nitro/queueplayer/SkipToPreviousBehavior;";
+
+  public:
+    /**
+     * Convert this Java/Kotlin-based enum to the C++ enum SkipToPreviousBehavior.
+     */
+    [[maybe_unused]]
+    [[nodiscard]]
+    SkipToPreviousBehavior toCpp() const {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldOrdinal = clazz->getField<int>("value");
+      int ordinal = this->getFieldValue(fieldOrdinal);
+      return static_cast<SkipToPreviousBehavior>(ordinal);
+    }
+
+  public:
+    /**
+     * Create a Java/Kotlin-based enum with the given C++ enum's value.
+     */
+    [[maybe_unused]]
+    static jni::alias_ref<JSkipToPreviousBehavior> fromCpp(SkipToPreviousBehavior value) {
+      static const auto clazz = javaClassStatic();
+      switch (value) {
+        case SkipToPreviousBehavior::PREVIOUS:
+          static const auto fieldPREVIOUS = clazz->getStaticField<JSkipToPreviousBehavior>("PREVIOUS");
+          return clazz->getStaticFieldValue(fieldPREVIOUS);
+        case SkipToPreviousBehavior::RESTART_OR_PREVIOUS:
+          static const auto fieldRESTART_OR_PREVIOUS = clazz->getStaticField<JSkipToPreviousBehavior>("RESTART_OR_PREVIOUS");
+          return clazz->getStaticFieldValue(fieldRESTART_OR_PREVIOUS);
+        default:
+          std::string stringValue = std::to_string(static_cast<int>(value));
+          throw std::invalid_argument("Invalid enum value (" + stringValue + "!");
+      }
+    }
+  };
+
+} // namespace margelo::nitro::queueplayer

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

@@ -50,6 +50,9 @@ data class PlayerConfig(
   val clampSeekToBuffered: Boolean?,
   @DoNotStrip
   @Keep
+  val skipToPreviousBehavior: SkipToPreviousBehavior?,
+  @DoNotStrip
+  @Keep
   val lookaheadCacheMaxSizeMb: Double?,
   @DoNotStrip
   @Keep
@@ -76,6 +79,7 @@ data class PlayerConfig(
       && Objects.deepEquals(this.audioCategoryOptions, other.audioCategoryOptions)
       && Objects.deepEquals(this.visualizationEnabled, other.visualizationEnabled)
       && Objects.deepEquals(this.clampSeekToBuffered, other.clampSeekToBuffered)
+      && Objects.deepEquals(this.skipToPreviousBehavior, other.skipToPreviousBehavior)
       && Objects.deepEquals(this.lookaheadCacheMaxSizeMb, other.lookaheadCacheMaxSizeMb)
       && Objects.deepEquals(this.lookaheadCacheEvictionPolicy, other.lookaheadCacheEvictionPolicy)
       && Objects.deepEquals(this.progressUpdateIntervalMs, other.progressUpdateIntervalMs)
@@ -94,6 +98,7 @@ data class PlayerConfig(
       audioCategoryOptions,
       visualizationEnabled,
       clampSeekToBuffered,
+      skipToPreviousBehavior,
       lookaheadCacheMaxSizeMb,
       lookaheadCacheEvictionPolicy,
       progressUpdateIntervalMs,
@@ -109,8 +114,8 @@ data class PlayerConfig(
     @Keep
     @Suppress("unused")
     @JvmStatic
-    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)
+    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?, skipToPreviousBehavior: SkipToPreviousBehavior?, lookaheadCacheMaxSizeMb: Double?, lookaheadCacheEvictionPolicy: EvictionPolicy?, progressUpdateIntervalMs: Double?, backgroundProgressUpdateIntervalMs: Double?): PlayerConfig {
+      return PlayerConfig(httpHeaders, userAgent, placeholderArtworkUri, autoRetries, retryBackoffMs, networkTimeoutMs, audioContentType, audioCategoryOptions, visualizationEnabled, clampSeekToBuffered, skipToPreviousBehavior, lookaheadCacheMaxSizeMb, lookaheadCacheEvictionPolicy, progressUpdateIntervalMs, backgroundProgressUpdateIntervalMs)
     }
   }
 }

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

@@ -0,0 +1,23 @@
+///
+/// SkipToPreviousBehavior.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 "SkipToPreviousBehavior".
+ */
+@DoNotStrip
+@Keep
+enum class SkipToPreviousBehavior(@DoNotStrip @Keep val value: Int) {
+  PREVIOUS(0),
+  RESTART_OR_PREVIOUS(1);
+
+  companion object
+}

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

@@ -112,6 +112,8 @@ namespace margelo::nitro::queueplayer { enum class ServiceReadyReason; }
 namespace margelo::nitro::queueplayer { struct ShuffleResult; }
 // Forward declaration of `SkipCapability` to properly resolve imports.
 namespace margelo::nitro::queueplayer { struct SkipCapability; }
+// Forward declaration of `SkipToPreviousBehavior` to properly resolve imports.
+namespace margelo::nitro::queueplayer { enum class SkipToPreviousBehavior; }
 // Forward declaration of `SleepTimerState` to properly resolve imports.
 namespace margelo::nitro::queueplayer { struct SleepTimerState; }
 // Forward declaration of `StateChangeReason` to properly resolve imports.
@@ -189,6 +191,7 @@ namespace QueuePlayer { class HybridVisualizerSpec_cxx; }
 #include "ServiceReadyReason.hpp"
 #include "ShuffleResult.hpp"
 #include "SkipCapability.hpp"
+#include "SkipToPreviousBehavior.hpp"
 #include "SleepTimerState.hpp"
 #include "StateChangeReason.hpp"
 #include "TrackChangeReason.hpp"
@@ -785,6 +788,21 @@ namespace margelo::nitro::queueplayer::bridge::swift {
     return optional.value();
   }
   
+  // pragma MARK: std::optional<SkipToPreviousBehavior>
+  /**
+   * Specialized version of `std::optional<SkipToPreviousBehavior>`.
+   */
+  using std__optional_SkipToPreviousBehavior_ = std::optional<SkipToPreviousBehavior>;
+  inline std::optional<SkipToPreviousBehavior> create_std__optional_SkipToPreviousBehavior_(const SkipToPreviousBehavior& value) noexcept {
+    return std::optional<SkipToPreviousBehavior>(value);
+  }
+  inline bool has_value_std__optional_SkipToPreviousBehavior_(const std::optional<SkipToPreviousBehavior>& optional) noexcept {
+    return optional.has_value();
+  }
+  inline SkipToPreviousBehavior get_std__optional_SkipToPreviousBehavior_(const std::optional<SkipToPreviousBehavior>& optional) noexcept {
+    return optional.value();
+  }
+  
   // pragma MARK: std::optional<EvictionPolicy>
   /**
    * Specialized version of `std::optional<EvictionPolicy>`.

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

@@ -126,6 +126,8 @@ namespace margelo::nitro::queueplayer { enum class ServiceReadyReason; }
 namespace margelo::nitro::queueplayer { struct ShuffleResult; }
 // Forward declaration of `SkipCapability` to properly resolve imports.
 namespace margelo::nitro::queueplayer { struct SkipCapability; }
+// Forward declaration of `SkipToPreviousBehavior` to properly resolve imports.
+namespace margelo::nitro::queueplayer { enum class SkipToPreviousBehavior; }
 // Forward declaration of `SleepTimerState` to properly resolve imports.
 namespace margelo::nitro::queueplayer { struct SleepTimerState; }
 // Forward declaration of `StateChangeReason` to properly resolve imports.
@@ -205,6 +207,7 @@ namespace margelo::nitro::queueplayer { struct VoiceVocabulary; }
 #include "ServiceReadyReason.hpp"
 #include "ShuffleResult.hpp"
 #include "SkipCapability.hpp"
+#include "SkipToPreviousBehavior.hpp"
 #include "SleepTimerState.hpp"
 #include "StateChangeReason.hpp"
 #include "TrackChangeReason.hpp"

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

@@ -18,6 +18,8 @@ namespace margelo::nitro::queueplayer { struct PlayerConfig; }
 namespace margelo::nitro::queueplayer { enum class AudioContentType; }
 // Forward declaration of `AudioCategoryOptions` to properly resolve imports.
 namespace margelo::nitro::queueplayer { struct AudioCategoryOptions; }
+// Forward declaration of `SkipToPreviousBehavior` to properly resolve imports.
+namespace margelo::nitro::queueplayer { enum class SkipToPreviousBehavior; }
 // Forward declaration of `EvictionPolicy` to properly resolve imports.
 namespace margelo::nitro::queueplayer { enum class EvictionPolicy; }
 // Forward declaration of `TrackItem` to properly resolve imports.
@@ -108,6 +110,7 @@ namespace margelo::nitro::queueplayer { struct NowPlayingFormatAndroidExtras; }
 #include <optional>
 #include "AudioContentType.hpp"
 #include "AudioCategoryOptions.hpp"
+#include "SkipToPreviousBehavior.hpp"
 #include "EvictionPolicy.hpp"
 #include "TrackItem.hpp"
 #include <vector>

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?, placeholderArtworkUri: 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?, skipToPreviousBehavior: SkipToPreviousBehavior?, 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
@@ -85,6 +85,12 @@ public extension PlayerConfig {
       } else {
         return .init()
       }
+    }(), { () -> bridge.std__optional_SkipToPreviousBehavior_ in
+      if let __unwrappedValue = skipToPreviousBehavior {
+        return bridge.create_std__optional_SkipToPreviousBehavior_(__unwrappedValue)
+      } else {
+        return .init()
+      }
     }(), { () -> bridge.std__optional_double_ in
       if let __unwrappedValue = lookaheadCacheMaxSizeMb {
         return bridge.create_std__optional_double_(__unwrappedValue)
@@ -226,6 +232,11 @@ public extension PlayerConfig {
     }()
   }
   
+  @inline(__always)
+  var skipToPreviousBehavior: SkipToPreviousBehavior? {
+    return self.__skipToPreviousBehavior.value
+  }
+  
   @inline(__always)
   var lookaheadCacheMaxSizeMb: Double? {
     return { () -> Double? in

package/nitrogen/generated/ios/swift/SkipToPreviousBehavior.swift

@@ -0,0 +1,40 @@
+///
+/// SkipToPreviousBehavior.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 `SkipToPreviousBehavior`, backed by a C++ enum.
+ */
+public typealias SkipToPreviousBehavior = margelo.nitro.queueplayer.SkipToPreviousBehavior
+
+public extension SkipToPreviousBehavior {
+  /**
+   * Get a SkipToPreviousBehavior for the given String value, or
+   * return `nil` if the given value was invalid/unknown.
+   */
+  init?(fromString string: String) {
+    switch string {
+      case "previous":
+        self = .previous
+      case "restart-or-previous":
+        self = .restartOrPrevious
+      default:
+        return nil
+    }
+  }
+
+  /**
+   * Get the String value this SkipToPreviousBehavior represents.
+   */
+  var stringValue: String {
+    switch self {
+      case .previous:
+        return "previous"
+      case .restartOrPrevious:
+        return "restart-or-previous"
+    }
+  }
+}

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

@@ -32,6 +32,8 @@
 namespace margelo::nitro::queueplayer { enum class AudioContentType; }
 // Forward declaration of `AudioCategoryOptions` to properly resolve imports.
 namespace margelo::nitro::queueplayer { struct AudioCategoryOptions; }
+// Forward declaration of `SkipToPreviousBehavior` to properly resolve imports.
+namespace margelo::nitro::queueplayer { enum class SkipToPreviousBehavior; }
 // Forward declaration of `EvictionPolicy` to properly resolve imports.
 namespace margelo::nitro::queueplayer { enum class EvictionPolicy; }
 
@@ -40,6 +42,7 @@ namespace margelo::nitro::queueplayer { enum class EvictionPolicy; }
 #include <optional>
 #include "AudioContentType.hpp"
 #include "AudioCategoryOptions.hpp"
+#include "SkipToPreviousBehavior.hpp"
 #include "EvictionPolicy.hpp"
 
 namespace margelo::nitro::queueplayer {
@@ -59,6 +62,7 @@ namespace margelo::nitro::queueplayer {
     std::optional<AudioCategoryOptions> audioCategoryOptions     SWIFT_PRIVATE;
     std::optional<bool> visualizationEnabled     SWIFT_PRIVATE;
     std::optional<bool> clampSeekToBuffered     SWIFT_PRIVATE;
+    std::optional<SkipToPreviousBehavior> skipToPreviousBehavior     SWIFT_PRIVATE;
     std::optional<double> lookaheadCacheMaxSizeMb     SWIFT_PRIVATE;
     std::optional<EvictionPolicy> lookaheadCacheEvictionPolicy     SWIFT_PRIVATE;
     std::optional<double> progressUpdateIntervalMs     SWIFT_PRIVATE;
@@ -66,7 +70,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<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) {}
+    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<SkipToPreviousBehavior> skipToPreviousBehavior, 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), skipToPreviousBehavior(skipToPreviousBehavior), lookaheadCacheMaxSizeMb(lookaheadCacheMaxSizeMb), lookaheadCacheEvictionPolicy(lookaheadCacheEvictionPolicy), progressUpdateIntervalMs(progressUpdateIntervalMs), backgroundProgressUpdateIntervalMs(backgroundProgressUpdateIntervalMs) {}
 
   public:
     friend bool operator==(const PlayerConfig& lhs, const PlayerConfig& rhs) = default;
@@ -92,6 +96,7 @@ namespace margelo::nitro {
         JSIConverter<std::optional<margelo::nitro::queueplayer::AudioCategoryOptions>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "audioCategoryOptions"))),
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "visualizationEnabled"))),
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "clampSeekToBuffered"))),
+        JSIConverter<std::optional<margelo::nitro::queueplayer::SkipToPreviousBehavior>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "skipToPreviousBehavior"))),
         JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "lookaheadCacheMaxSizeMb"))),
         JSIConverter<std::optional<margelo::nitro::queueplayer::EvictionPolicy>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "lookaheadCacheEvictionPolicy"))),
         JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "progressUpdateIntervalMs"))),
@@ -110,6 +115,7 @@ namespace margelo::nitro {
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "audioCategoryOptions"), JSIConverter<std::optional<margelo::nitro::queueplayer::AudioCategoryOptions>>::toJSI(runtime, arg.audioCategoryOptions));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "visualizationEnabled"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.visualizationEnabled));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "clampSeekToBuffered"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.clampSeekToBuffered));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "skipToPreviousBehavior"), JSIConverter<std::optional<margelo::nitro::queueplayer::SkipToPreviousBehavior>>::toJSI(runtime, arg.skipToPreviousBehavior));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "lookaheadCacheMaxSizeMb"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.lookaheadCacheMaxSizeMb));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "lookaheadCacheEvictionPolicy"), JSIConverter<std::optional<margelo::nitro::queueplayer::EvictionPolicy>>::toJSI(runtime, arg.lookaheadCacheEvictionPolicy));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "progressUpdateIntervalMs"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.progressUpdateIntervalMs));
@@ -134,6 +140,7 @@ namespace margelo::nitro {
       if (!JSIConverter<std::optional<margelo::nitro::queueplayer::AudioCategoryOptions>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "audioCategoryOptions")))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "visualizationEnabled")))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "clampSeekToBuffered")))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::queueplayer::SkipToPreviousBehavior>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "skipToPreviousBehavior")))) return false;
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "lookaheadCacheMaxSizeMb")))) return false;
       if (!JSIConverter<std::optional<margelo::nitro::queueplayer::EvictionPolicy>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "lookaheadCacheEvictionPolicy")))) return false;
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "progressUpdateIntervalMs")))) return false;

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

@@ -0,0 +1,76 @@
+///
+/// SkipToPreviousBehavior.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::queueplayer {
+
+  /**
+   * An enum which can be represented as a JavaScript union (SkipToPreviousBehavior).
+   */
+  enum class SkipToPreviousBehavior {
+    PREVIOUS      SWIFT_NAME(previous) = 0,
+    RESTART_OR_PREVIOUS      SWIFT_NAME(restartOrPrevious) = 1,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::queueplayer
+
+namespace margelo::nitro {
+
+  // C++ SkipToPreviousBehavior <> JS SkipToPreviousBehavior (union)
+  template <>
+  struct JSIConverter<margelo::nitro::queueplayer::SkipToPreviousBehavior> final {
+    static inline margelo::nitro::queueplayer::SkipToPreviousBehavior fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("previous"): return margelo::nitro::queueplayer::SkipToPreviousBehavior::PREVIOUS;
+        case hashString("restart-or-previous"): return margelo::nitro::queueplayer::SkipToPreviousBehavior::RESTART_OR_PREVIOUS;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum SkipToPreviousBehavior - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::queueplayer::SkipToPreviousBehavior arg) {
+      switch (arg) {
+        case margelo::nitro::queueplayer::SkipToPreviousBehavior::PREVIOUS: return JSIConverter<std::string>::toJSI(runtime, "previous");
+        case margelo::nitro::queueplayer::SkipToPreviousBehavior::RESTART_OR_PREVIOUS: return JSIConverter<std::string>::toJSI(runtime, "restart-or-previous");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert SkipToPreviousBehavior to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("previous"):
+        case hashString("restart-or-previous"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-queue-player",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "Nitro Modules audio playback library for React Native — gapless, EQ, crossfade, automotive, voice, casting",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/index.d.ts",

package/src/TrackPlayer.nitro.ts

@@ -306,17 +306,17 @@ export interface TrackPlayer
   getCanSkipNext(): boolean;
   /**
    * Whether the user-facing Previous button should be enabled.
-   * Symmetric with `getCanSkipNext` — true when there's a previous
+   * Symmetric with `getCanSkipNext` — with the default
+   * `skipToPreviousBehavior: 'previous'`, true when there's a previous
    * track to skip to under the current repeat mode:
    * - `'off'` and `'track'` at index 0: false (no previous, no wrap)
    * - `'queue'`: true with an active track (wraps)
    *
-   * **Apps that want the Apple-Music-style "tap Previous restarts
-   * current when position > 3s" UX** should implement that
-   * themselves in their button handler — branch on the live
-   * `useProgress().position` value to either `seekTo(0)` or
-   * `skipToPrevious()`. The lib intentionally ships the primitive,
-   * not the policy.
+   * With `PlayerConfig.skipToPreviousBehavior: 'restart-or-previous'` the
+   * lib applies the standard music-player "restart when past ~3 s, else
+   * previous" model natively, and this reports `true` whenever a track is
+   * loaded (even at index 0, where past the threshold Previous restarts the
+   * current track) so the control never greys out.
    */
   getCanSkipPrevious(): boolean;
   /**

package/src/index.ts

@@ -14,6 +14,7 @@ export type {
   PlaybackMode,
   PlaybackModeKind,
   RepeatMode,
+  SkipToPreviousBehavior,
   RemoteSkipMode,
   RemoteControlOptions,
   StateChangeReason,

package/src/types.ts

@@ -172,6 +172,21 @@ export interface PlayerConfig {
    * Default: `false` (targets pass through unclamped).
    */
   clampSeekToBuffered?: boolean;
+  /**
+   * How skip-to-previous behaves. `'previous'` (default) always goes to the
+   * previous track. `'restart-or-previous'` restarts the current track
+   * (seeks to 0) when it is past ~3 s, otherwise goes to the previous track
+   * — the standard music-player model. Applies
+   * to local playback; during cast, Previous routes to the receiver. When
+   * `'restart-or-previous'`, the Previous control is always enabled
+   * (`canSkipPrevious` reports `true` whenever a track is loaded, so the
+   * control never greys out — even on the first track, where past the
+   * threshold it restarts).
+   *
+   * Pinned per `configure()` (a fixed behavior, not a live toggle);
+   * changing it re-runs `configure()`. Default: `'previous'`.
+   */
+  skipToPreviousBehavior?: SkipToPreviousBehavior;
   /**
    * Disk budget for the lookahead cache, in megabytes. Fixed at `configure()`
    * time and cannot change at runtime — Android's Media3 `SimpleCache` fixes
@@ -339,6 +354,16 @@ export const crossfadeDurationBounds = {
  */
 export type RepeatMode = 'off' | 'queue' | 'track';
 
+/**
+ * How `skipToPrevious` (and the OS Previous control) behaves.
+ * - `'previous'` — always go to the previous track (the default; current
+ *   behavior).
+ * - `'restart-or-previous'` — restart the current track (seek to 0) when it
+ *   is past ~3 s, otherwise go to the previous track. The standard
+ *   music-player model. See `PlayerConfig.skipToPreviousBehavior`.
+ */
+export type SkipToPreviousBehavior = 'previous' | 'restart-or-previous';
+
 /**
  * How the lock-screen / notification skip controls behave: skip between queue
  * tracks (`'track'`) or jump forward/back within the current track by a fixed