@5stones/react-native-audio-browser 0.1.0

package/lib/typescript/src/web/util/BrowserPathHelper.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Utility for handling browser paths and contextual URLs in the media browser system.
+ * Mirrors Android's BrowserPathHelper.kt
+ *
+ * Handles two types of special paths:
+ * 1. System paths (prefixed with `/__`): Root, recent, and search paths
+ * 2. Contextual URLs: Embed parent context in track identifiers for Media3 integration
+ *
+ * Contextual URL format: `{parentPath}?__trackId={trackSrc}`
+ * Example: "/library/radio?__trackId=song.mp3"
+ *
+ * This allows:
+ * - Media3 to reference playable-only tracks (tracks with `src` but no `url`)
+ * - Cache lookup to work consistently
+ * - Parent context to be preserved for queue restoration
+ */
+export declare const BrowserPathHelper: {
+    /** Search path prefix (full path is /__search?q=query) */
+    readonly SEARCH_PATH_PREFIX: "/__search";
+    /** Query parameter name for contextual track identifiers */
+    readonly CONTEXTUAL_TRACK_PARAM: "__trackId";
+    /**
+     * Create a search path for a given query
+     */
+    readonly createSearchPath: (query: string) => string;
+    /**
+     * Checks if a path contains a contextual track identifier.
+     *
+     * @param path The URL path to check
+     * @returns true if the path contains the contextual track parameter
+     */
+    readonly isContextual: (path: string) => boolean;
+    /**
+     * Strips the __trackId parameter from a contextual URL to get the parent path.
+     * If the URL is not contextual, returns it unchanged.
+     *
+     * @param url The URL to process
+     * @returns The URL without the __trackId parameter
+     *
+     * Example: "/library/radio?__trackId=song.mp3" → "/library/radio"
+     * Example: "/search?q=jazz&__trackId=song.mp3" → "/search?q=jazz"
+     */
+    readonly stripTrackId: (url: string) => string;
+    /**
+     * Extracts the track ID from a contextual URL.
+     * Returns undefined if the URL is not contextual or doesn't contain the track ID parameter.
+     *
+     * @param path The contextual URL to parse
+     * @returns The extracted track ID, or undefined if not found
+     *
+     * Example: "/library/radio?__trackId=song.mp3" → "song.mp3"
+     */
+    readonly extractTrackId: (path: string) => string | undefined;
+    /**
+     * Combines a base URL with a path, ensuring proper slash handling.
+     *
+     * @param baseUrl The base URL (can be undefined)
+     * @param path The path to append
+     * @returns The combined URL with proper slash handling
+     *
+     * Examples:
+     * - buildUrl("http://example.com", "api/test") → "http://example.com/api/test"
+     * - buildUrl("http://example.com/", "/api/test") → "http://example.com/api/test"
+     * - buildUrl(undefined, "/api/test") → "/api/test"
+     * - buildUrl(undefined, "http://full.url") → "http://full.url"
+     */
+    readonly buildUrl: (baseUrl: string | undefined, path: string) => string;
+};
+//# sourceMappingURL=BrowserPathHelper.d.ts.map

package/lib/typescript/src/web/util/BrowserPathHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserPathHelper.d.ts","sourceRoot":"","sources":["../../../../../src/web/util/BrowserPathHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB;IAC5B,0DAA0D;;IAG1D,4DAA4D;;IAG5D;;OAEG;uCACqB,MAAM,KAAG,MAAM;IAKvC;;;;;OAKG;kCACgB,MAAM,KAAG,OAAO;IAOnC;;;;;;;;;OASG;iCACe,MAAM,KAAG,MAAM;IAmCjC;;;;;;;;OAQG;oCACkB,MAAM,KAAG,MAAM,GAAG,SAAS;IAmBhD;;;;;;;;;;;;OAYG;iCACe,MAAM,GAAG,SAAS,QAAQ,MAAM,KAAG,MAAM;CAgBnD,CAAA"}

package/lib/typescript/src/web/util/shuffle.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shuffles an array in place using the Fisher-Yates algorithm.
+ * https://en.wikipedia.org/wiki/Fisher%E2%80%93Yates_shuffle
+ *
+ * @param array The array to shuffle (mutated in place)
+ */
+export declare function fisherYatesShuffle<T>(array: T[]): void;
+//# sourceMappingURL=shuffle.d.ts.map

package/lib/typescript/src/web/util/shuffle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../../../../../src/web/util/shuffle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAOtD"}

package/nitro.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://nitro.margelo.com/nitro.schema.json",
+  "cxxNamespace": [
+    "audiobrowser"
+  ],
+  "ios": {
+    "iosModuleName": "AudioBrowser"
+  },
+  "android": {
+    "androidNamespace": [
+      "audiobrowser"
+    ],
+    "androidCxxLibName": "AudioBrowser"
+  },
+  "autolinking": {
+    "AudioBrowser": {
+      "swift": "AudioBrowser",
+      "kotlin": "AudioBrowser"
+    }
+  },
+  "ignorePaths": [
+    "**/node_modules"
+  ]
+}

package/nitrogen/generated/.gitattributes

@@ -0,0 +1 @@
+** linguist-generated=true

package/nitrogen/generated/android/AudioBrowser+autolinking.cmake

@@ -0,0 +1,88 @@
+#
+# AudioBrowser+autolinking.cmake
+# This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+# https://github.com/mrousavy/nitro
+# Copyright © 2026 Marc Rousavy @ Margelo
+#
+
+# This is a CMake file that adds all files generated by Nitrogen
+# to the current CMake project.
+#
+# To use it, add this to your CMakeLists.txt:
+# ```cmake
+# include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/AudioBrowser+autolinking.cmake)
+# ```
+
+# Define a flag to check if we are building properly
+add_definitions(-DBUILDING_AUDIOBROWSER_WITH_GENERATED_CMAKE_PROJECT)
+
+# Enable Raw Props parsing in react-native (for Nitro Views)
+add_definitions(-DRN_SERIALIZABLE_STATE)
+
+# Add all headers that were generated by Nitrogen
+include_directories(
+  "../nitrogen/generated/shared/c++"
+  "../nitrogen/generated/android/c++"
+  "../nitrogen/generated/android/"
+)
+
+# Add all .cpp sources that were generated by Nitrogen
+target_sources(
+  # CMake project name (Android C++ library name)
+  AudioBrowser PRIVATE
+  # Autolinking Setup
+  ../nitrogen/generated/android/AudioBrowserOnLoad.cpp
+  # Shared Nitrogen C++ sources
+  ../nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp
+  # Android-specific Nitrogen C++ sources
+  ../nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp
+  ../nitrogen/generated/android/c++/JBrowseResult.cpp
+  ../nitrogen/generated/android/c++/JSleepTimer.cpp
+  ../nitrogen/generated/android/c++/JVariant_HeartRating_ThumbsRating_StarRating_PercentageRating.cpp
+  ../nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp
+  ../nitrogen/generated/android/c++/JVariant_NullType_Double.cpp
+  ../nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.cpp
+  ../nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.cpp
+)
+
+# From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake
+# Used in node_modules/react-native/ReactAndroid/cmake-utils/ReactNative-application.cmake
+target_compile_definitions(
+  AudioBrowser PRIVATE
+  -DFOLLY_NO_CONFIG=1
+  -DFOLLY_HAVE_CLOCK_GETTIME=1
+  -DFOLLY_USE_LIBCPP=1
+  -DFOLLY_CFG_NO_COROUTINES=1
+  -DFOLLY_MOBILE=1
+  -DFOLLY_HAVE_RECVMMSG=1
+  -DFOLLY_HAVE_PTHREAD=1
+  # Once we target android-23 above, we can comment
+  # the following line. NDK uses GNU style stderror_r() after API 23.
+  -DFOLLY_HAVE_XSI_STRERROR_R=1
+)
+
+# Add all libraries required by the generated specs
+find_package(fbjni REQUIRED) # <-- Used for communication between Java <-> C++
+find_package(ReactAndroid REQUIRED) # <-- Used to set up React Native bindings (e.g. CallInvoker/TurboModule)
+find_package(react-native-nitro-modules REQUIRED) # <-- Used to create all HybridObjects and use the Nitro core library
+
+# Link all libraries together
+target_link_libraries(
+        AudioBrowser
+        fbjni::fbjni                              # <-- Facebook C++ JNI helpers
+        ReactAndroid::jsi                         # <-- RN: JSI
+        react-native-nitro-modules::NitroModules  # <-- NitroModules Core :)
+)
+
+# Link react-native (different prefab between RN 0.75 and RN 0.76)
+if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
+    target_link_libraries(
+        AudioBrowser
+        ReactAndroid::reactnative                 # <-- RN: Native Modules umbrella prefab
+    )
+else()
+    target_link_libraries(
+        AudioBrowser
+        ReactAndroid::react_nativemodule_core     # <-- RN: TurboModules Core
+    )
+endif()

package/nitrogen/generated/android/AudioBrowser+autolinking.gradle

@@ -0,0 +1,27 @@
+///
+/// AudioBrowser+autolinking.gradle
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+/// This is a Gradle file that adds all files generated by Nitrogen
+/// to the current Gradle project.
+///
+/// To use it, add this to your build.gradle:
+/// ```gradle
+/// apply from: '../nitrogen/generated/android/AudioBrowser+autolinking.gradle'
+/// ```
+
+logger.warn("[NitroModules] 🔥 AudioBrowser is boosted by nitro!")
+
+android {
+  sourceSets {
+    main {
+      java.srcDirs += [
+        // Nitrogen files
+        "${project.projectDir}/../nitrogen/generated/android/kotlin"
+      ]
+    }
+  }
+}

package/nitrogen/generated/android/AudioBrowserOnLoad.cpp

@@ -0,0 +1,124 @@
+///
+/// AudioBrowserOnLoad.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#ifndef BUILDING_AUDIOBROWSER_WITH_GENERATED_CMAKE_PROJECT
+#error AudioBrowserOnLoad.cpp is not being built with the autogenerated CMakeLists.txt project. Is a different CMakeLists.txt building this?
+#endif
+
+#include "AudioBrowserOnLoad.hpp"
+
+#include <jni.h>
+#include <fbjni/fbjni.h>
+#include <NitroModules/HybridObjectRegistry.hpp>
+
+#include "JHybridAudioBrowserSpec.hpp"
+#include "JFunc_void_std__string.hpp"
+#include "JFunc_void_std__optional_ResolvedTrack_.hpp"
+#include "JFunc_void_std__vector_Track_.hpp"
+#include "JFunc_void_NavigationErrorEvent.hpp"
+#include "JFunc_void_std__optional_FormattedNavigationError_.hpp"
+#include "JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp"
+#include "JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp"
+#include "JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp"
+#include "JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.hpp"
+#include "JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp"
+#include "JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp"
+#include "JFunc_void_std__vector_ChapterMetadata_.hpp"
+#include "JFunc_void_TrackMetadata.hpp"
+#include "JFunc_void_TimedMetadata.hpp"
+#include "JFunc_void_PlaybackActiveTrackChangedEvent.hpp"
+#include "JFunc_void_PlaybackErrorEvent.hpp"
+#include "JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp"
+#include "JFunc_void_PlayingState.hpp"
+#include "JFunc_void_PlaybackProgressUpdatedEvent.hpp"
+#include "JFunc_void_PlaybackQueueEndedEvent.hpp"
+#include "JFunc_void_RepeatModeChangedEvent.hpp"
+#include "JFunc_void_bool.hpp"
+#include "JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp"
+#include "JFunc_void_Playback.hpp"
+#include "JFunc_void.hpp"
+#include "JFunc_void_RemoteJumpBackwardEvent.hpp"
+#include "JFunc_void_RemoteJumpForwardEvent.hpp"
+#include "JFunc_void_RemotePlayIdEvent.hpp"
+#include "JFunc_void_RemotePlaySearchEvent.hpp"
+#include "JFunc_void_RemoteSeekEvent.hpp"
+#include "JFunc_void_RemoteSetRatingEvent.hpp"
+#include "JFunc_void_RemoteSkipEvent.hpp"
+#include "JFunc_void_Options.hpp"
+#include "JFunc_void_FavoriteChangedEvent.hpp"
+#include "JFunc_void_NowPlayingMetadata.hpp"
+#include "JFunc_void_double.hpp"
+#include "JFunc_void_IosOutput.hpp"
+#include "JFunc_void_EqualizerSettings.hpp"
+#include "JFunc_void_BatteryWarningPendingChangedEvent.hpp"
+#include "JFunc_void_BatteryOptimizationStatusChangedEvent.hpp"
+#include <NitroModules/DefaultConstructableObject.hpp>
+
+namespace margelo::nitro::audiobrowser {
+
+int initialize(JavaVM* vm) {
+  using namespace margelo::nitro;
+  using namespace margelo::nitro::audiobrowser;
+  using namespace facebook;
+
+  return facebook::jni::initialize(vm, [] {
+    // Register native JNI methods
+    margelo::nitro::audiobrowser::JHybridAudioBrowserSpec::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_std__string_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_std__optional_ResolvedTrack__cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_std__vector_Track__cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_NavigationErrorEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_std__optional_FormattedNavigationError__cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string___cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_std__vector_ChapterMetadata__cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_TrackMetadata_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_TimedMetadata_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_PlaybackActiveTrackChangedEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_PlaybackErrorEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_PlaybackPlayWhenReadyChangedEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_PlayingState_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_PlaybackProgressUpdatedEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_PlaybackQueueEndedEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_RepeatModeChangedEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_bool_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack___cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_Playback_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_RemoteJumpBackwardEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_RemoteJumpForwardEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_RemotePlayIdEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_RemotePlaySearchEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_RemoteSeekEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_RemoteSetRatingEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_RemoteSkipEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_Options_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_FavoriteChangedEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_NowPlayingMetadata_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_double_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_IosOutput_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_EqualizerSettings_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_BatteryWarningPendingChangedEvent_cxx::registerNatives();
+    margelo::nitro::audiobrowser::JFunc_void_BatteryOptimizationStatusChangedEvent_cxx::registerNatives();
+
+    // Register Nitro Hybrid Objects
+    HybridObjectRegistry::registerHybridObjectConstructor(
+      "AudioBrowser",
+      []() -> std::shared_ptr<HybridObject> {
+        static DefaultConstructableObject<JHybridAudioBrowserSpec::javaobject> object("com/audiobrowser/AudioBrowser");
+        auto instance = object.create();
+        return instance->cthis()->shared();
+      }
+    );
+  });
+}
+
+} // namespace margelo::nitro::audiobrowser

package/nitrogen/generated/android/AudioBrowserOnLoad.hpp

@@ -0,0 +1,25 @@
+///
+/// AudioBrowserOnLoad.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#include <jni.h>
+#include <NitroModules/NitroDefines.hpp>
+
+namespace margelo::nitro::audiobrowser {
+
+  /**
+   * Initializes the native (C++) part of AudioBrowser, and autolinks all Hybrid Objects.
+   * Call this in your `JNI_OnLoad` function (probably inside `cpp-adapter.cpp`).
+   * Example:
+   * ```cpp (cpp-adapter.cpp)
+   * JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+   *   return margelo::nitro::audiobrowser::initialize(vm);
+   * }
+   * ```
+   */
+  int initialize(JavaVM* vm);
+
+} // namespace margelo::nitro::audiobrowser

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

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

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

@@ -0,0 +1,61 @@
+///
+/// JAndroidAudioOffloadSettings.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include "AndroidAudioOffloadSettings.hpp"
+
+#include <optional>
+
+namespace margelo::nitro::audiobrowser {
+
+  using namespace facebook;
+
+  /**
+   * The C++ JNI bridge between the C++ struct "AndroidAudioOffloadSettings" and the the Kotlin data class "AndroidAudioOffloadSettings".
+   */
+  struct JAndroidAudioOffloadSettings final: public jni::JavaClass<JAndroidAudioOffloadSettings> {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings;";
+
+  public:
+    /**
+     * Convert this Java/Kotlin-based struct to the C++ struct AndroidAudioOffloadSettings by copying all values to C++.
+     */
+    [[maybe_unused]]
+    [[nodiscard]]
+    AndroidAudioOffloadSettings toCpp() const {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldGaplessSupportRequired = clazz->getField<jni::JBoolean>("gaplessSupportRequired");
+      jni::local_ref<jni::JBoolean> gaplessSupportRequired = this->getFieldValue(fieldGaplessSupportRequired);
+      static const auto fieldRateChangeSupportRequired = clazz->getField<jni::JBoolean>("rateChangeSupportRequired");
+      jni::local_ref<jni::JBoolean> rateChangeSupportRequired = this->getFieldValue(fieldRateChangeSupportRequired);
+      return AndroidAudioOffloadSettings(
+        gaplessSupportRequired != nullptr ? std::make_optional(static_cast<bool>(gaplessSupportRequired->value())) : std::nullopt,
+        rateChangeSupportRequired != nullptr ? std::make_optional(static_cast<bool>(rateChangeSupportRequired->value())) : std::nullopt
+      );
+    }
+
+  public:
+    /**
+     * Create a Java/Kotlin-based struct by copying all values from the given C++ struct to Java.
+     */
+    [[maybe_unused]]
+    static jni::local_ref<JAndroidAudioOffloadSettings::javaobject> fromCpp(const AndroidAudioOffloadSettings& value) {
+      using JSignature = JAndroidAudioOffloadSettings(jni::alias_ref<jni::JBoolean>, jni::alias_ref<jni::JBoolean>);
+      static const auto clazz = javaClassStatic();
+      static const auto create = clazz->getStaticMethod<JSignature>("fromCpp");
+      return create(
+        clazz,
+        value.gaplessSupportRequired.has_value() ? jni::JBoolean::valueOf(value.gaplessSupportRequired.value()) : nullptr,
+        value.rateChangeSupportRequired.has_value() ? jni::JBoolean::valueOf(value.rateChangeSupportRequired.value()) : nullptr
+      );
+    }
+  };
+
+} // namespace margelo::nitro::audiobrowser

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

@@ -0,0 +1,86 @@
+///
+/// JAndroidOptions.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include "AndroidOptions.hpp"
+
+#include "AppKilledPlaybackBehavior.hpp"
+#include "JAppKilledPlaybackBehavior.hpp"
+#include "JNotificationButton.hpp"
+#include "JNotificationButtonLayout.hpp"
+#include "JRatingType.hpp"
+#include "JVariant_NullType_NotificationButtonLayout.hpp"
+#include "NotificationButton.hpp"
+#include "NotificationButtonLayout.hpp"
+#include "RatingType.hpp"
+#include <NitroModules/JNull.hpp>
+#include <NitroModules/Null.hpp>
+#include <optional>
+#include <variant>
+#include <vector>
+
+namespace margelo::nitro::audiobrowser {
+
+  using namespace facebook;
+
+  /**
+   * The C++ JNI bridge between the C++ struct "AndroidOptions" and the the Kotlin data class "AndroidOptions".
+   */
+  struct JAndroidOptions final: public jni::JavaClass<JAndroidOptions> {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/audiobrowser/AndroidOptions;";
+
+  public:
+    /**
+     * Convert this Java/Kotlin-based struct to the C++ struct AndroidOptions by copying all values to C++.
+     */
+    [[maybe_unused]]
+    [[nodiscard]]
+    AndroidOptions toCpp() const {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldAppKilledPlaybackBehavior = clazz->getField<JAppKilledPlaybackBehavior>("appKilledPlaybackBehavior");
+      jni::local_ref<JAppKilledPlaybackBehavior> appKilledPlaybackBehavior = this->getFieldValue(fieldAppKilledPlaybackBehavior);
+      static const auto fieldSkipSilence = clazz->getField<jboolean>("skipSilence");
+      jboolean skipSilence = this->getFieldValue(fieldSkipSilence);
+      static const auto fieldShuffle = clazz->getField<jboolean>("shuffle");
+      jboolean shuffle = this->getFieldValue(fieldShuffle);
+      static const auto fieldRatingType = clazz->getField<JRatingType>("ratingType");
+      jni::local_ref<JRatingType> ratingType = this->getFieldValue(fieldRatingType);
+      static const auto fieldNotificationButtons = clazz->getField<JVariant_NullType_NotificationButtonLayout>("notificationButtons");
+      jni::local_ref<JVariant_NullType_NotificationButtonLayout> notificationButtons = this->getFieldValue(fieldNotificationButtons);
+      return AndroidOptions(
+        appKilledPlaybackBehavior->toCpp(),
+        static_cast<bool>(skipSilence),
+        static_cast<bool>(shuffle),
+        ratingType->toCpp(),
+        notificationButtons != nullptr ? std::make_optional(notificationButtons->toCpp()) : std::nullopt
+      );
+    }
+
+  public:
+    /**
+     * Create a Java/Kotlin-based struct by copying all values from the given C++ struct to Java.
+     */
+    [[maybe_unused]]
+    static jni::local_ref<JAndroidOptions::javaobject> fromCpp(const AndroidOptions& value) {
+      using JSignature = JAndroidOptions(jni::alias_ref<JAppKilledPlaybackBehavior>, jboolean, jboolean, jni::alias_ref<JRatingType>, jni::alias_ref<JVariant_NullType_NotificationButtonLayout>);
+      static const auto clazz = javaClassStatic();
+      static const auto create = clazz->getStaticMethod<JSignature>("fromCpp");
+      return create(
+        clazz,
+        JAppKilledPlaybackBehavior::fromCpp(value.appKilledPlaybackBehavior),
+        value.skipSilence,
+        value.shuffle,
+        JRatingType::fromCpp(value.ratingType),
+        value.notificationButtons.has_value() ? JVariant_NullType_NotificationButtonLayout::fromCpp(value.notificationButtons.value()) : nullptr
+      );
+    }
+  };
+
+} // namespace margelo::nitro::audiobrowser

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

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