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

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

@@ -0,0 +1,107 @@
+///
+/// DownloadedTrack.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 `TrackItem` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct TrackItem; }
+// Forward declaration of `StorageLocation` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { enum class StorageLocation; }
+
+#include <string>
+#include "TrackItem.hpp"
+#include <NitroModules/Null.hpp>
+#include <variant>
+#include <optional>
+#include "StorageLocation.hpp"
+
+namespace margelo::nitro::nitroplayer {
+
+  /**
+   * A struct which can be represented as a JavaScript object (DownloadedTrack).
+   */
+  struct DownloadedTrack {
+  public:
+    std::string trackId     SWIFT_PRIVATE;
+    TrackItem originalTrack     SWIFT_PRIVATE;
+    std::string localPath     SWIFT_PRIVATE;
+    std::optional<std::variant<nitro::NullType, std::string>> localArtworkPath     SWIFT_PRIVATE;
+    double downloadedAt     SWIFT_PRIVATE;
+    double fileSize     SWIFT_PRIVATE;
+    StorageLocation storageLocation     SWIFT_PRIVATE;
+
+  public:
+    DownloadedTrack() = default;
+    explicit DownloadedTrack(std::string trackId, TrackItem originalTrack, std::string localPath, std::optional<std::variant<nitro::NullType, std::string>> localArtworkPath, double downloadedAt, double fileSize, StorageLocation storageLocation): trackId(trackId), originalTrack(originalTrack), localPath(localPath), localArtworkPath(localArtworkPath), downloadedAt(downloadedAt), fileSize(fileSize), storageLocation(storageLocation) {}
+  };
+
+} // namespace margelo::nitro::nitroplayer
+
+namespace margelo::nitro {
+
+  // C++ DownloadedTrack <> JS DownloadedTrack (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroplayer::DownloadedTrack> final {
+    static inline margelo::nitro::nitroplayer::DownloadedTrack fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroplayer::DownloadedTrack(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "trackId")),
+        JSIConverter<margelo::nitro::nitroplayer::TrackItem>::fromJSI(runtime, obj.getProperty(runtime, "originalTrack")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "localPath")),
+        JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::fromJSI(runtime, obj.getProperty(runtime, "localArtworkPath")),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "downloadedAt")),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "fileSize")),
+        JSIConverter<margelo::nitro::nitroplayer::StorageLocation>::fromJSI(runtime, obj.getProperty(runtime, "storageLocation"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroplayer::DownloadedTrack& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "trackId", JSIConverter<std::string>::toJSI(runtime, arg.trackId));
+      obj.setProperty(runtime, "originalTrack", JSIConverter<margelo::nitro::nitroplayer::TrackItem>::toJSI(runtime, arg.originalTrack));
+      obj.setProperty(runtime, "localPath", JSIConverter<std::string>::toJSI(runtime, arg.localPath));
+      obj.setProperty(runtime, "localArtworkPath", JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::toJSI(runtime, arg.localArtworkPath));
+      obj.setProperty(runtime, "downloadedAt", JSIConverter<double>::toJSI(runtime, arg.downloadedAt));
+      obj.setProperty(runtime, "fileSize", JSIConverter<double>::toJSI(runtime, arg.fileSize));
+      obj.setProperty(runtime, "storageLocation", JSIConverter<margelo::nitro::nitroplayer::StorageLocation>::toJSI(runtime, arg.storageLocation));
+      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, "trackId"))) return false;
+      if (!JSIConverter<margelo::nitro::nitroplayer::TrackItem>::canConvert(runtime, obj.getProperty(runtime, "originalTrack"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "localPath"))) return false;
+      if (!JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::canConvert(runtime, obj.getProperty(runtime, "localArtworkPath"))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "downloadedAt"))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "fileSize"))) return false;
+      if (!JSIConverter<margelo::nitro::nitroplayer::StorageLocation>::canConvert(runtime, obj.getProperty(runtime, "storageLocation"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,87 @@
+///
+/// EqualizerBand.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
+
+
+
+#include <string>
+
+namespace margelo::nitro::nitroplayer {
+
+  /**
+   * A struct which can be represented as a JavaScript object (EqualizerBand).
+   */
+  struct EqualizerBand {
+  public:
+    double index     SWIFT_PRIVATE;
+    double centerFrequency     SWIFT_PRIVATE;
+    double gainDb     SWIFT_PRIVATE;
+    std::string frequencyLabel     SWIFT_PRIVATE;
+
+  public:
+    EqualizerBand() = default;
+    explicit EqualizerBand(double index, double centerFrequency, double gainDb, std::string frequencyLabel): index(index), centerFrequency(centerFrequency), gainDb(gainDb), frequencyLabel(frequencyLabel) {}
+  };
+
+} // namespace margelo::nitro::nitroplayer
+
+namespace margelo::nitro {
+
+  // C++ EqualizerBand <> JS EqualizerBand (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroplayer::EqualizerBand> final {
+    static inline margelo::nitro::nitroplayer::EqualizerBand fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroplayer::EqualizerBand(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "index")),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "centerFrequency")),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "gainDb")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "frequencyLabel"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroplayer::EqualizerBand& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "index", JSIConverter<double>::toJSI(runtime, arg.index));
+      obj.setProperty(runtime, "centerFrequency", JSIConverter<double>::toJSI(runtime, arg.centerFrequency));
+      obj.setProperty(runtime, "gainDb", JSIConverter<double>::toJSI(runtime, arg.gainDb));
+      obj.setProperty(runtime, "frequencyLabel", JSIConverter<std::string>::toJSI(runtime, arg.frequencyLabel));
+      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<double>::canConvert(runtime, obj.getProperty(runtime, "index"))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "centerFrequency"))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "gainDb"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "frequencyLabel"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,86 @@
+///
+/// EqualizerPreset.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 `PresetType` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { enum class PresetType; }
+
+#include <string>
+#include <vector>
+#include "PresetType.hpp"
+
+namespace margelo::nitro::nitroplayer {
+
+  /**
+   * A struct which can be represented as a JavaScript object (EqualizerPreset).
+   */
+  struct EqualizerPreset {
+  public:
+    std::string name     SWIFT_PRIVATE;
+    std::vector<double> gains     SWIFT_PRIVATE;
+    PresetType type     SWIFT_PRIVATE;
+
+  public:
+    EqualizerPreset() = default;
+    explicit EqualizerPreset(std::string name, std::vector<double> gains, PresetType type): name(name), gains(gains), type(type) {}
+  };
+
+} // namespace margelo::nitro::nitroplayer
+
+namespace margelo::nitro {
+
+  // C++ EqualizerPreset <> JS EqualizerPreset (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroplayer::EqualizerPreset> final {
+    static inline margelo::nitro::nitroplayer::EqualizerPreset fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroplayer::EqualizerPreset(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "name")),
+        JSIConverter<std::vector<double>>::fromJSI(runtime, obj.getProperty(runtime, "gains")),
+        JSIConverter<margelo::nitro::nitroplayer::PresetType>::fromJSI(runtime, obj.getProperty(runtime, "type"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroplayer::EqualizerPreset& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "name", JSIConverter<std::string>::toJSI(runtime, arg.name));
+      obj.setProperty(runtime, "gains", JSIConverter<std::vector<double>>::toJSI(runtime, arg.gains));
+      obj.setProperty(runtime, "type", JSIConverter<margelo::nitro::nitroplayer::PresetType>::toJSI(runtime, arg.type));
+      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, "name"))) return false;
+      if (!JSIConverter<std::vector<double>>::canConvert(runtime, obj.getProperty(runtime, "gains"))) return false;
+      if (!JSIConverter<margelo::nitro::nitroplayer::PresetType>::canConvert(runtime, obj.getProperty(runtime, "type"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,89 @@
+///
+/// EqualizerState.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 `EqualizerBand` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct EqualizerBand; }
+
+#include "EqualizerBand.hpp"
+#include <vector>
+#include <NitroModules/Null.hpp>
+#include <string>
+#include <variant>
+#include <optional>
+
+namespace margelo::nitro::nitroplayer {
+
+  /**
+   * A struct which can be represented as a JavaScript object (EqualizerState).
+   */
+  struct EqualizerState {
+  public:
+    bool enabled     SWIFT_PRIVATE;
+    std::vector<EqualizerBand> bands     SWIFT_PRIVATE;
+    std::optional<std::variant<nitro::NullType, std::string>> currentPreset     SWIFT_PRIVATE;
+
+  public:
+    EqualizerState() = default;
+    explicit EqualizerState(bool enabled, std::vector<EqualizerBand> bands, std::optional<std::variant<nitro::NullType, std::string>> currentPreset): enabled(enabled), bands(bands), currentPreset(currentPreset) {}
+  };
+
+} // namespace margelo::nitro::nitroplayer
+
+namespace margelo::nitro {
+
+  // C++ EqualizerState <> JS EqualizerState (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroplayer::EqualizerState> final {
+    static inline margelo::nitro::nitroplayer::EqualizerState fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroplayer::EqualizerState(
+        JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, "enabled")),
+        JSIConverter<std::vector<margelo::nitro::nitroplayer::EqualizerBand>>::fromJSI(runtime, obj.getProperty(runtime, "bands")),
+        JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::fromJSI(runtime, obj.getProperty(runtime, "currentPreset"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroplayer::EqualizerState& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "enabled", JSIConverter<bool>::toJSI(runtime, arg.enabled));
+      obj.setProperty(runtime, "bands", JSIConverter<std::vector<margelo::nitro::nitroplayer::EqualizerBand>>::toJSI(runtime, arg.bands));
+      obj.setProperty(runtime, "currentPreset", JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::toJSI(runtime, arg.currentPreset));
+      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<bool>::canConvert(runtime, obj.getProperty(runtime, "enabled"))) return false;
+      if (!JSIConverter<std::vector<margelo::nitro::nitroplayer::EqualizerBand>>::canConvert(runtime, obj.getProperty(runtime, "bands"))) return false;
+      if (!JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::canConvert(runtime, obj.getProperty(runtime, "currentPreset"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,79 @@
+///
+/// GainRange.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
+
+
+
+
+
+namespace margelo::nitro::nitroplayer {
+
+  /**
+   * A struct which can be represented as a JavaScript object (GainRange).
+   */
+  struct GainRange {
+  public:
+    double min     SWIFT_PRIVATE;
+    double max     SWIFT_PRIVATE;
+
+  public:
+    GainRange() = default;
+    explicit GainRange(double min, double max): min(min), max(max) {}
+  };
+
+} // namespace margelo::nitro::nitroplayer
+
+namespace margelo::nitro {
+
+  // C++ GainRange <> JS GainRange (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroplayer::GainRange> final {
+    static inline margelo::nitro::nitroplayer::GainRange fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroplayer::GainRange(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "min")),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "max"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroplayer::GainRange& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "min", JSIConverter<double>::toJSI(runtime, arg.min));
+      obj.setProperty(runtime, "max", JSIConverter<double>::toJSI(runtime, arg.max));
+      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<double>::canConvert(runtime, obj.getProperty(runtime, "min"))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "max"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,55 @@
+///
+/// HybridDownloadManagerSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#include "HybridDownloadManagerSpec.hpp"
+
+namespace margelo::nitro::nitroplayer {
+
+  void HybridDownloadManagerSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("configure", &HybridDownloadManagerSpec::configure);
+      prototype.registerHybridMethod("getConfig", &HybridDownloadManagerSpec::getConfig);
+      prototype.registerHybridMethod("downloadTrack", &HybridDownloadManagerSpec::downloadTrack);
+      prototype.registerHybridMethod("downloadPlaylist", &HybridDownloadManagerSpec::downloadPlaylist);
+      prototype.registerHybridMethod("pauseDownload", &HybridDownloadManagerSpec::pauseDownload);
+      prototype.registerHybridMethod("resumeDownload", &HybridDownloadManagerSpec::resumeDownload);
+      prototype.registerHybridMethod("cancelDownload", &HybridDownloadManagerSpec::cancelDownload);
+      prototype.registerHybridMethod("retryDownload", &HybridDownloadManagerSpec::retryDownload);
+      prototype.registerHybridMethod("pauseAllDownloads", &HybridDownloadManagerSpec::pauseAllDownloads);
+      prototype.registerHybridMethod("resumeAllDownloads", &HybridDownloadManagerSpec::resumeAllDownloads);
+      prototype.registerHybridMethod("cancelAllDownloads", &HybridDownloadManagerSpec::cancelAllDownloads);
+      prototype.registerHybridMethod("getDownloadTask", &HybridDownloadManagerSpec::getDownloadTask);
+      prototype.registerHybridMethod("getActiveDownloads", &HybridDownloadManagerSpec::getActiveDownloads);
+      prototype.registerHybridMethod("getQueueStatus", &HybridDownloadManagerSpec::getQueueStatus);
+      prototype.registerHybridMethod("isDownloading", &HybridDownloadManagerSpec::isDownloading);
+      prototype.registerHybridMethod("getDownloadState", &HybridDownloadManagerSpec::getDownloadState);
+      prototype.registerHybridMethod("isTrackDownloaded", &HybridDownloadManagerSpec::isTrackDownloaded);
+      prototype.registerHybridMethod("isPlaylistDownloaded", &HybridDownloadManagerSpec::isPlaylistDownloaded);
+      prototype.registerHybridMethod("isPlaylistPartiallyDownloaded", &HybridDownloadManagerSpec::isPlaylistPartiallyDownloaded);
+      prototype.registerHybridMethod("getDownloadedTrack", &HybridDownloadManagerSpec::getDownloadedTrack);
+      prototype.registerHybridMethod("getAllDownloadedTracks", &HybridDownloadManagerSpec::getAllDownloadedTracks);
+      prototype.registerHybridMethod("getDownloadedPlaylist", &HybridDownloadManagerSpec::getDownloadedPlaylist);
+      prototype.registerHybridMethod("getAllDownloadedPlaylists", &HybridDownloadManagerSpec::getAllDownloadedPlaylists);
+      prototype.registerHybridMethod("getLocalPath", &HybridDownloadManagerSpec::getLocalPath);
+      prototype.registerHybridMethod("deleteDownloadedTrack", &HybridDownloadManagerSpec::deleteDownloadedTrack);
+      prototype.registerHybridMethod("deleteDownloadedPlaylist", &HybridDownloadManagerSpec::deleteDownloadedPlaylist);
+      prototype.registerHybridMethod("deleteAllDownloads", &HybridDownloadManagerSpec::deleteAllDownloads);
+      prototype.registerHybridMethod("getStorageInfo", &HybridDownloadManagerSpec::getStorageInfo);
+      prototype.registerHybridMethod("syncDownloads", &HybridDownloadManagerSpec::syncDownloads);
+      prototype.registerHybridMethod("setPlaybackSourcePreference", &HybridDownloadManagerSpec::setPlaybackSourcePreference);
+      prototype.registerHybridMethod("getPlaybackSourcePreference", &HybridDownloadManagerSpec::getPlaybackSourcePreference);
+      prototype.registerHybridMethod("getEffectiveUrl", &HybridDownloadManagerSpec::getEffectiveUrl);
+      prototype.registerHybridMethod("onDownloadProgress", &HybridDownloadManagerSpec::onDownloadProgress);
+      prototype.registerHybridMethod("onDownloadStateChange", &HybridDownloadManagerSpec::onDownloadStateChange);
+      prototype.registerHybridMethod("onDownloadComplete", &HybridDownloadManagerSpec::onDownloadComplete);
+    });
+  }
+
+} // namespace margelo::nitro::nitroplayer

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

@@ -0,0 +1,134 @@
+///
+/// HybridDownloadManagerSpec.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/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `DownloadConfig` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct DownloadConfig; }
+// Forward declaration of `TrackItem` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct TrackItem; }
+// Forward declaration of `DownloadTask` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct DownloadTask; }
+// Forward declaration of `DownloadQueueStatus` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct DownloadQueueStatus; }
+// Forward declaration of `DownloadState` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { enum class DownloadState; }
+// Forward declaration of `DownloadedTrack` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct DownloadedTrack; }
+// Forward declaration of `DownloadedPlaylist` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct DownloadedPlaylist; }
+// Forward declaration of `DownloadStorageInfo` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct DownloadStorageInfo; }
+// Forward declaration of `PlaybackSource` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { enum class PlaybackSource; }
+// Forward declaration of `DownloadProgress` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct DownloadProgress; }
+// Forward declaration of `DownloadError` to properly resolve imports.
+namespace margelo::nitro::nitroplayer { struct DownloadError; }
+
+#include "DownloadConfig.hpp"
+#include <string>
+#include <NitroModules/Promise.hpp>
+#include "TrackItem.hpp"
+#include <optional>
+#include <vector>
+#include <NitroModules/Null.hpp>
+#include "DownloadTask.hpp"
+#include <variant>
+#include "DownloadQueueStatus.hpp"
+#include "DownloadState.hpp"
+#include "DownloadedTrack.hpp"
+#include "DownloadedPlaylist.hpp"
+#include "DownloadStorageInfo.hpp"
+#include "PlaybackSource.hpp"
+#include "DownloadProgress.hpp"
+#include <functional>
+#include "DownloadError.hpp"
+
+namespace margelo::nitro::nitroplayer {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `DownloadManager`
+   * Inherit this class to create instances of `HybridDownloadManagerSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridDownloadManager: public HybridDownloadManagerSpec {
+   * public:
+   *   HybridDownloadManager(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridDownloadManagerSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridDownloadManagerSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridDownloadManagerSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual void configure(const DownloadConfig& config) = 0;
+      virtual DownloadConfig getConfig() = 0;
+      virtual std::shared_ptr<Promise<std::string>> downloadTrack(const TrackItem& track, const std::optional<std::string>& playlistId) = 0;
+      virtual std::shared_ptr<Promise<std::vector<std::string>>> downloadPlaylist(const std::string& playlistId, const std::vector<TrackItem>& tracks) = 0;
+      virtual std::shared_ptr<Promise<void>> pauseDownload(const std::string& downloadId) = 0;
+      virtual std::shared_ptr<Promise<void>> resumeDownload(const std::string& downloadId) = 0;
+      virtual std::shared_ptr<Promise<void>> cancelDownload(const std::string& downloadId) = 0;
+      virtual std::shared_ptr<Promise<void>> retryDownload(const std::string& downloadId) = 0;
+      virtual std::shared_ptr<Promise<void>> pauseAllDownloads() = 0;
+      virtual std::shared_ptr<Promise<void>> resumeAllDownloads() = 0;
+      virtual std::shared_ptr<Promise<void>> cancelAllDownloads() = 0;
+      virtual std::variant<nitro::NullType, DownloadTask> getDownloadTask(const std::string& downloadId) = 0;
+      virtual std::vector<DownloadTask> getActiveDownloads() = 0;
+      virtual DownloadQueueStatus getQueueStatus() = 0;
+      virtual bool isDownloading(const std::string& trackId) = 0;
+      virtual DownloadState getDownloadState(const std::string& trackId) = 0;
+      virtual bool isTrackDownloaded(const std::string& trackId) = 0;
+      virtual bool isPlaylistDownloaded(const std::string& playlistId) = 0;
+      virtual bool isPlaylistPartiallyDownloaded(const std::string& playlistId) = 0;
+      virtual std::variant<nitro::NullType, DownloadedTrack> getDownloadedTrack(const std::string& trackId) = 0;
+      virtual std::vector<DownloadedTrack> getAllDownloadedTracks() = 0;
+      virtual std::variant<nitro::NullType, DownloadedPlaylist> getDownloadedPlaylist(const std::string& playlistId) = 0;
+      virtual std::vector<DownloadedPlaylist> getAllDownloadedPlaylists() = 0;
+      virtual std::variant<nitro::NullType, std::string> getLocalPath(const std::string& trackId) = 0;
+      virtual std::shared_ptr<Promise<void>> deleteDownloadedTrack(const std::string& trackId) = 0;
+      virtual std::shared_ptr<Promise<void>> deleteDownloadedPlaylist(const std::string& playlistId) = 0;
+      virtual std::shared_ptr<Promise<void>> deleteAllDownloads() = 0;
+      virtual std::shared_ptr<Promise<DownloadStorageInfo>> getStorageInfo() = 0;
+      virtual double syncDownloads() = 0;
+      virtual void setPlaybackSourcePreference(PlaybackSource preference) = 0;
+      virtual PlaybackSource getPlaybackSourcePreference() = 0;
+      virtual std::string getEffectiveUrl(const TrackItem& track) = 0;
+      virtual void onDownloadProgress(const std::function<void(const DownloadProgress& /* progress */)>& callback) = 0;
+      virtual void onDownloadStateChange(const std::function<void(const std::string& /* downloadId */, const std::string& /* trackId */, DownloadState /* state */, const std::optional<DownloadError>& /* error */)>& callback) = 0;
+      virtual void onDownloadComplete(const std::function<void(const DownloadedTrack& /* downloadedTrack */)>& callback) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "DownloadManager";
+  };
+
+} // namespace margelo::nitro::nitroplayer