react-native-nitro-player 0.3.0-alpha.9 → 0.4.0

package/nitrogen/generated/ios/swift/PlayerState.swift

@@ -19,7 +19,7 @@ public extension PlayerState {
   /**
    * Create a new instance of `PlayerState`.
    */
-  init(currentTrack: Variant_NullType_TrackItem?, currentPosition: Double, totalDuration: Double, currentState: TrackPlayerState, currentPlaylistId: Variant_NullType_String?, currentIndex: Double) {
+  init(currentTrack: Variant_NullType_TrackItem?, currentPosition: Double, totalDuration: Double, currentState: TrackPlayerState, currentPlaylistId: Variant_NullType_String?, currentIndex: Double, currentPlayingType: CurrentPlayingType) {
     self.init({ () -> bridge.std__optional_std__variant_nitro__NullType__TrackItem__ in
       if let __unwrappedValue = currentTrack {
         return bridge.create_std__optional_std__variant_nitro__NullType__TrackItem__({ () -> bridge.std__variant_nitro__NullType__TrackItem_ in
@@ -46,7 +46,7 @@ public extension PlayerState {
       } else {
         return .init()
       }
-    }(), currentIndex)
+    }(), currentIndex, currentPlayingType)
   }
 
   var currentTrack: Variant_NullType_TrackItem? {
@@ -178,4 +178,15 @@ public extension PlayerState {
       self.__currentIndex = newValue
     }
   }
+  
+  var currentPlayingType: CurrentPlayingType {
+    @inline(__always)
+    get {
+      return self.__currentPlayingType
+    }
+    @inline(__always)
+    set {
+      self.__currentPlayingType = newValue
+    }
+  }
 }

package/nitrogen/generated/ios/swift/PresetType.swift

@@ -0,0 +1,40 @@
+///
+/// PresetType.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+/**
+ * Represents the JS union `PresetType`, backed by a C++ enum.
+ */
+public typealias PresetType = margelo.nitro.nitroplayer.PresetType
+
+public extension PresetType {
+  /**
+   * Get a PresetType for the given String value, or
+   * return `nil` if the given value was invalid/unknown.
+   */
+  init?(fromString string: String) {
+    switch string {
+      case "built-in":
+        self = .builtIn
+      case "custom":
+        self = .custom
+      default:
+        return nil
+    }
+  }
+
+  /**
+   * Get the String value this PresetType represents.
+   */
+  var stringValue: String {
+    switch self {
+      case .builtIn:
+        return "built-in"
+      case .custom:
+        return "custom"
+    }
+  }
+}

package/nitrogen/generated/ios/swift/StorageLocation.swift

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

package/nitrogen/generated/ios/swift/TrackItem.swift

@@ -19,7 +19,7 @@ public extension TrackItem {
   /**
    * Create a new instance of `TrackItem`.
    */
-  init(id: String, title: String, artist: String, album: String, duration: Double, url: String, artwork: Variant_NullType_String?) {
+  init(id: String, title: String, artist: String, album: String, duration: Double, url: String, artwork: Variant_NullType_String?, extraPayload: AnyMap?) {
     self.init(std.string(id), std.string(title), std.string(artist), std.string(album), duration, std.string(url), { () -> bridge.std__optional_std__variant_nitro__NullType__std__string__ in
       if let __unwrappedValue = artwork {
         return bridge.create_std__optional_std__variant_nitro__NullType__std__string__({ () -> bridge.std__variant_nitro__NullType__std__string_ in
@@ -33,6 +33,12 @@ public extension TrackItem {
       } else {
         return .init()
       }
+    }(), { () -> bridge.std__optional_std__shared_ptr_AnyMap__ in
+      if let __unwrappedValue = extraPayload {
+        return bridge.create_std__optional_std__shared_ptr_AnyMap__(__unwrappedValue.cppPart)
+      } else {
+        return .init()
+      }
     }())
   }
 
@@ -144,4 +150,28 @@ public extension TrackItem {
       }()
     }
   }
+  
+  var extraPayload: AnyMap? {
+    @inline(__always)
+    get {
+      return { () -> AnyMap? in
+        if bridge.has_value_std__optional_std__shared_ptr_AnyMap__(self.__extraPayload) {
+          let __unwrapped = bridge.get_std__optional_std__shared_ptr_AnyMap__(self.__extraPayload)
+          return AnyMap(withCppPart: __unwrapped)
+        } else {
+          return nil
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__extraPayload = { () -> bridge.std__optional_std__shared_ptr_AnyMap__ in
+        if let __unwrappedValue = newValue {
+          return bridge.create_std__optional_std__shared_ptr_AnyMap__(__unwrappedValue.cppPart)
+        } else {
+          return .init()
+        }
+      }()
+    }
+  }
 }

package/nitrogen/generated/ios/swift/TrackPlayerState.swift

@@ -17,10 +17,10 @@ public extension TrackPlayerState {
    */
   init?(fromString string: String) {
     switch string {
-      case "playing":
-        self = .playing
       case "paused":
         self = .paused
+      case "playing":
+        self = .playing
       case "stopped":
         self = .stopped
       default:
@@ -33,10 +33,10 @@ public extension TrackPlayerState {
    */
   var stringValue: String {
     switch self {
-      case .playing:
-        return "playing"
       case .paused:
         return "paused"
+      case .playing:
+        return "playing"
       case .stopped:
         return "stopped"
     }

package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift

@@ -0,0 +1,18 @@
+///
+/// Variant_NullType_Double.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * An Swift enum with associated values representing a Variant/Union type.
+ * JS type: `null | number`
+ */
+@frozen
+public enum Variant_NullType_Double {
+  case first(NullType)
+  case second(Double)
+}

package/nitrogen/generated/ios/swift/Variant_NullType_DownloadError.swift

@@ -0,0 +1,18 @@
+///
+/// Variant_NullType_DownloadError.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * An Swift enum with associated values representing a Variant/Union type.
+ * JS type: `null | struct`
+ */
+@frozen
+public indirect enum Variant_NullType_DownloadError {
+  case first(NullType)
+  case second(DownloadError)
+}

package/nitrogen/generated/ios/swift/Variant_NullType_DownloadTask.swift

@@ -0,0 +1,18 @@
+///
+/// Variant_NullType_DownloadTask.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * An Swift enum with associated values representing a Variant/Union type.
+ * JS type: `null | struct`
+ */
+@frozen
+public indirect enum Variant_NullType_DownloadTask {
+  case first(NullType)
+  case second(DownloadTask)
+}

package/nitrogen/generated/ios/swift/Variant_NullType_DownloadedPlaylist.swift

@@ -0,0 +1,18 @@
+///
+/// Variant_NullType_DownloadedPlaylist.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * An Swift enum with associated values representing a Variant/Union type.
+ * JS type: `null | struct`
+ */
+@frozen
+public indirect enum Variant_NullType_DownloadedPlaylist {
+  case first(NullType)
+  case second(DownloadedPlaylist)
+}

package/nitrogen/generated/ios/swift/Variant_NullType_DownloadedTrack.swift

@@ -0,0 +1,18 @@
+///
+/// Variant_NullType_DownloadedTrack.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * An Swift enum with associated values representing a Variant/Union type.
+ * JS type: `null | struct`
+ */
+@frozen
+public indirect enum Variant_NullType_DownloadedTrack {
+  case first(NullType)
+  case second(DownloadedTrack)
+}

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

@@ -0,0 +1,84 @@
+///
+/// CurrentPlayingType.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 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::nitroplayer {
+
+  /**
+   * An enum which can be represented as a JavaScript union (CurrentPlayingType).
+   */
+  enum class CurrentPlayingType {
+    PLAYLIST      SWIFT_NAME(playlist) = 0,
+    UP_NEXT      SWIFT_NAME(upNext) = 1,
+    PLAY_NEXT      SWIFT_NAME(playNext) = 2,
+    NOT_PLAYING      SWIFT_NAME(notPlaying) = 3,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::nitroplayer
+
+namespace margelo::nitro {
+
+  // C++ CurrentPlayingType <> JS CurrentPlayingType (union)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroplayer::CurrentPlayingType> final {
+    static inline margelo::nitro::nitroplayer::CurrentPlayingType 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("playlist"): return margelo::nitro::nitroplayer::CurrentPlayingType::PLAYLIST;
+        case hashString("up-next"): return margelo::nitro::nitroplayer::CurrentPlayingType::UP_NEXT;
+        case hashString("play-next"): return margelo::nitro::nitroplayer::CurrentPlayingType::PLAY_NEXT;
+        case hashString("not-playing"): return margelo::nitro::nitroplayer::CurrentPlayingType::NOT_PLAYING;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum CurrentPlayingType - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::nitroplayer::CurrentPlayingType arg) {
+      switch (arg) {
+        case margelo::nitro::nitroplayer::CurrentPlayingType::PLAYLIST: return JSIConverter<std::string>::toJSI(runtime, "playlist");
+        case margelo::nitro::nitroplayer::CurrentPlayingType::UP_NEXT: return JSIConverter<std::string>::toJSI(runtime, "up-next");
+        case margelo::nitro::nitroplayer::CurrentPlayingType::PLAY_NEXT: return JSIConverter<std::string>::toJSI(runtime, "play-next");
+        case margelo::nitro::nitroplayer::CurrentPlayingType::NOT_PLAYING: return JSIConverter<std::string>::toJSI(runtime, "not-playing");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert CurrentPlayingType 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("playlist"):
+        case hashString("up-next"):
+        case hashString("play-next"):
+        case hashString("not-playing"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,108 @@
+///
+/// DownloadConfig.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#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
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `StorageLocation` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { enum class StorageLocation; }
+
+#include "StorageLocation.hpp"
+#include <optional>
+#include <NitroModules/Null.hpp>
+#include <string>
+#include <variant>
+
+namespace margelo::nitro::nitroplayer {
+
+  /**
+   * A struct which can be represented as a JavaScript object (DownloadConfig).
+   */
+  struct DownloadConfig {
+  public:
+    std::optional<StorageLocation> storageLocation     SWIFT_PRIVATE;
+    std::optional<double> maxConcurrentDownloads     SWIFT_PRIVATE;
+    std::optional<bool> autoRetry     SWIFT_PRIVATE;
+    std::optional<double> maxRetryAttempts     SWIFT_PRIVATE;
+    std::optional<bool> backgroundDownloadsEnabled     SWIFT_PRIVATE;
+    std::optional<bool> downloadArtwork     SWIFT_PRIVATE;
+    std::optional<std::variant<nitro::NullType, std::string>> customDownloadPath     SWIFT_PRIVATE;
+    std::optional<bool> wifiOnlyDownloads     SWIFT_PRIVATE;
+
+  public:
+    DownloadConfig() = default;
+    explicit DownloadConfig(std::optional<StorageLocation> storageLocation, std::optional<double> maxConcurrentDownloads, std::optional<bool> autoRetry, std::optional<double> maxRetryAttempts, std::optional<bool> backgroundDownloadsEnabled, std::optional<bool> downloadArtwork, std::optional<std::variant<nitro::NullType, std::string>> customDownloadPath, std::optional<bool> wifiOnlyDownloads): storageLocation(storageLocation), maxConcurrentDownloads(maxConcurrentDownloads), autoRetry(autoRetry), maxRetryAttempts(maxRetryAttempts), backgroundDownloadsEnabled(backgroundDownloadsEnabled), downloadArtwork(downloadArtwork), customDownloadPath(customDownloadPath), wifiOnlyDownloads(wifiOnlyDownloads) {}
+  };
+
+} // namespace margelo::nitro::nitroplayer
+
+namespace margelo::nitro {
+
+  // C++ DownloadConfig <> JS DownloadConfig (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroplayer::DownloadConfig> final {
+    static inline margelo::nitro::nitroplayer::DownloadConfig fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroplayer::DownloadConfig(
+        JSIConverter<std::optional<margelo::nitro::nitroplayer::StorageLocation>>::fromJSI(runtime, obj.getProperty(runtime, "storageLocation")),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, "maxConcurrentDownloads")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "autoRetry")),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, "maxRetryAttempts")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "backgroundDownloadsEnabled")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "downloadArtwork")),
+        JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::fromJSI(runtime, obj.getProperty(runtime, "customDownloadPath")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "wifiOnlyDownloads"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroplayer::DownloadConfig& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "storageLocation", JSIConverter<std::optional<margelo::nitro::nitroplayer::StorageLocation>>::toJSI(runtime, arg.storageLocation));
+      obj.setProperty(runtime, "maxConcurrentDownloads", JSIConverter<std::optional<double>>::toJSI(runtime, arg.maxConcurrentDownloads));
+      obj.setProperty(runtime, "autoRetry", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.autoRetry));
+      obj.setProperty(runtime, "maxRetryAttempts", JSIConverter<std::optional<double>>::toJSI(runtime, arg.maxRetryAttempts));
+      obj.setProperty(runtime, "backgroundDownloadsEnabled", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.backgroundDownloadsEnabled));
+      obj.setProperty(runtime, "downloadArtwork", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.downloadArtwork));
+      obj.setProperty(runtime, "customDownloadPath", JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::toJSI(runtime, arg.customDownloadPath));
+      obj.setProperty(runtime, "wifiOnlyDownloads", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.wifiOnlyDownloads));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::optional<margelo::nitro::nitroplayer::StorageLocation>>::canConvert(runtime, obj.getProperty(runtime, "storageLocation"))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "maxConcurrentDownloads"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "autoRetry"))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "maxRetryAttempts"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "backgroundDownloadsEnabled"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "downloadArtwork"))) return false;
+      if (!JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::canConvert(runtime, obj.getProperty(runtime, "customDownloadPath"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "wifiOnlyDownloads"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,89 @@
+///
+/// DownloadError.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#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
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `DownloadErrorReason` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { enum class DownloadErrorReason; }
+
+#include <string>
+#include "DownloadErrorReason.hpp"
+
+namespace margelo::nitro::nitroplayer {
+
+  /**
+   * A struct which can be represented as a JavaScript object (DownloadError).
+   */
+  struct DownloadError {
+  public:
+    std::string code     SWIFT_PRIVATE;
+    std::string message     SWIFT_PRIVATE;
+    DownloadErrorReason reason     SWIFT_PRIVATE;
+    bool isRetryable     SWIFT_PRIVATE;
+
+  public:
+    DownloadError() = default;
+    explicit DownloadError(std::string code, std::string message, DownloadErrorReason reason, bool isRetryable): code(code), message(message), reason(reason), isRetryable(isRetryable) {}
+  };
+
+} // namespace margelo::nitro::nitroplayer
+
+namespace margelo::nitro {
+
+  // C++ DownloadError <> JS DownloadError (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroplayer::DownloadError> final {
+    static inline margelo::nitro::nitroplayer::DownloadError fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroplayer::DownloadError(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "code")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "message")),
+        JSIConverter<margelo::nitro::nitroplayer::DownloadErrorReason>::fromJSI(runtime, obj.getProperty(runtime, "reason")),
+        JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, "isRetryable"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroplayer::DownloadError& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "code", JSIConverter<std::string>::toJSI(runtime, arg.code));
+      obj.setProperty(runtime, "message", JSIConverter<std::string>::toJSI(runtime, arg.message));
+      obj.setProperty(runtime, "reason", JSIConverter<margelo::nitro::nitroplayer::DownloadErrorReason>::toJSI(runtime, arg.reason));
+      obj.setProperty(runtime, "isRetryable", JSIConverter<bool>::toJSI(runtime, arg.isRetryable));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "code"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "message"))) return false;
+      if (!JSIConverter<margelo::nitro::nitroplayer::DownloadErrorReason>::canConvert(runtime, obj.getProperty(runtime, "reason"))) return false;
+      if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, "isRetryable"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,96 @@
+///
+/// DownloadErrorReason.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 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::nitroplayer {
+
+  /**
+   * An enum which can be represented as a JavaScript union (DownloadErrorReason).
+   */
+  enum class DownloadErrorReason {
+    NETWORK_ERROR      SWIFT_NAME(networkError) = 0,
+    STORAGE_FULL      SWIFT_NAME(storageFull) = 1,
+    FILE_NOT_FOUND      SWIFT_NAME(fileNotFound) = 2,
+    PERMISSION_DENIED      SWIFT_NAME(permissionDenied) = 3,
+    INVALID_URL      SWIFT_NAME(invalidUrl) = 4,
+    TIMEOUT      SWIFT_NAME(timeout) = 5,
+    UNKNOWN      SWIFT_NAME(unknown) = 6,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::nitroplayer
+
+namespace margelo::nitro {
+
+  // C++ DownloadErrorReason <> JS DownloadErrorReason (union)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroplayer::DownloadErrorReason> final {
+    static inline margelo::nitro::nitroplayer::DownloadErrorReason 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("network_error"): return margelo::nitro::nitroplayer::DownloadErrorReason::NETWORK_ERROR;
+        case hashString("storage_full"): return margelo::nitro::nitroplayer::DownloadErrorReason::STORAGE_FULL;
+        case hashString("file_not_found"): return margelo::nitro::nitroplayer::DownloadErrorReason::FILE_NOT_FOUND;
+        case hashString("permission_denied"): return margelo::nitro::nitroplayer::DownloadErrorReason::PERMISSION_DENIED;
+        case hashString("invalid_url"): return margelo::nitro::nitroplayer::DownloadErrorReason::INVALID_URL;
+        case hashString("timeout"): return margelo::nitro::nitroplayer::DownloadErrorReason::TIMEOUT;
+        case hashString("unknown"): return margelo::nitro::nitroplayer::DownloadErrorReason::UNKNOWN;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum DownloadErrorReason - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::nitroplayer::DownloadErrorReason arg) {
+      switch (arg) {
+        case margelo::nitro::nitroplayer::DownloadErrorReason::NETWORK_ERROR: return JSIConverter<std::string>::toJSI(runtime, "network_error");
+        case margelo::nitro::nitroplayer::DownloadErrorReason::STORAGE_FULL: return JSIConverter<std::string>::toJSI(runtime, "storage_full");
+        case margelo::nitro::nitroplayer::DownloadErrorReason::FILE_NOT_FOUND: return JSIConverter<std::string>::toJSI(runtime, "file_not_found");
+        case margelo::nitro::nitroplayer::DownloadErrorReason::PERMISSION_DENIED: return JSIConverter<std::string>::toJSI(runtime, "permission_denied");
+        case margelo::nitro::nitroplayer::DownloadErrorReason::INVALID_URL: return JSIConverter<std::string>::toJSI(runtime, "invalid_url");
+        case margelo::nitro::nitroplayer::DownloadErrorReason::TIMEOUT: return JSIConverter<std::string>::toJSI(runtime, "timeout");
+        case margelo::nitro::nitroplayer::DownloadErrorReason::UNKNOWN: return JSIConverter<std::string>::toJSI(runtime, "unknown");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert DownloadErrorReason 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("network_error"):
+        case hashString("storage_full"):
+        case hashString("file_not_found"):
+        case hashString("permission_denied"):
+        case hashString("invalid_url"):
+        case hashString("timeout"):
+        case hashString("unknown"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro