react-native-audio-browser 0.2.0-next.4 → 0.2.0-next.40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1025) hide show
  1. package/README.md +36 -22
  2. package/android/build.gradle +42 -15
  3. package/android/gradle.properties +2 -2
  4. package/android/src/main/AndroidManifest.xml +3 -1
  5. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +543 -280
  6. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +38 -0
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +18 -2
  8. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +131 -0
  9. package/android/src/main/java/com/audiobrowser/Service.kt +9 -6
  10. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  11. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  12. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  13. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  14. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  15. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  16. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  17. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  18. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  19. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  20. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  21. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  22. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  23. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  24. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +7 -0
  25. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +12 -12
  26. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +111 -58
  27. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  28. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  29. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  30. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +530 -230
  31. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +218 -252
  32. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +23 -26
  33. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  34. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  35. package/android/src/main/java/com/audiobrowser/player/Player.kt +130 -63
  36. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  37. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  38. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +12 -4
  39. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  40. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  41. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  42. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  43. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  44. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  45. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  46. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  47. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +62 -40
  48. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  49. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  50. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  51. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +56 -52
  52. package/android/src/main/res/values/strings.xml +25 -5
  53. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  54. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  55. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  56. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  57. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  58. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  59. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  60. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  61. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  62. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  63. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  64. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  65. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  66. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  67. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  68. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +385 -0
  69. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +101 -58
  70. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  71. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  72. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +45 -0
  73. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +42 -2
  74. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  75. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  76. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  77. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  78. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +185 -0
  79. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  80. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  81. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  82. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  83. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  84. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  85. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  86. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  87. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  88. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  89. package/ios/AVPlayerEngine.swift +362 -0
  90. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  91. package/ios/Browser/BrowseGate.swift +58 -0
  92. package/ios/Browser/BrowserConfig.swift +115 -81
  93. package/ios/Browser/BrowserError.swift +16 -0
  94. package/ios/Browser/BrowserManager.swift +155 -654
  95. package/ios/Browser/BrowserPathHelper.swift +68 -51
  96. package/ios/Browser/FavoriteSet.swift +46 -0
  97. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  98. package/ios/Browser/JsonModels.swift +270 -321
  99. package/ios/Browser/NavigationErrorState.swift +41 -0
  100. package/ios/Browser/PageResolver.swift +147 -0
  101. package/ios/Browser/RequestLayer.swift +185 -0
  102. package/ios/Browser/RequestPipeline.swift +303 -0
  103. package/ios/Browser/SearchDrillIn.swift +7 -7
  104. package/ios/Browser/SectionScope.swift +82 -23
  105. package/ios/Browser/SimpleRouter.swift +73 -144
  106. package/ios/Browser/StyleResolver.swift +58 -0
  107. package/ios/Browser/TabBarEntries.swift +9 -3
  108. package/ios/Browser/TrackIdTemplate.swift +37 -0
  109. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  110. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  111. package/ios/CarPlay/CarPlayController.swift +37 -1297
  112. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  113. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  114. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  115. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  116. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  117. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  118. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  119. package/ios/CarPlay/CarPlaySession.swift +207 -0
  120. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  121. package/ios/CarPlay/IntentHandlers.swift +96 -0
  122. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  123. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  124. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  125. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  126. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  127. package/ios/CarPlay/SectionPresentation.swift +77 -0
  128. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  129. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  130. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  131. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  132. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  133. package/ios/Extension/SearchParams+Query.swift +28 -0
  134. package/ios/Extension/Section+Copying.swift +29 -0
  135. package/ios/Extension/String+IcyCharset.swift +21 -0
  136. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  137. package/ios/Extension/Track+AVPlayer.swift +0 -16
  138. package/ios/Extension/Track+Copying.swift +11 -13
  139. package/ios/Extension/Track+Identity.swift +25 -0
  140. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  141. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  142. package/ios/Extension/URLError+Connectivity.swift +15 -0
  143. package/ios/Http/HttpClient.swift +71 -165
  144. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  145. package/ios/HybridAudioBrowser+Options.swift +105 -0
  146. package/ios/HybridAudioBrowser+Player.swift +341 -0
  147. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  148. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  149. package/ios/HybridAudioBrowser.swift +132 -1652
  150. package/ios/Model/NitroTypeStubs.swift +239 -24
  151. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  152. package/ios/Model/RemoteCommand.swift +6 -60
  153. package/ios/Model/TrackPlayerError.swift +2 -2
  154. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  155. package/ios/Observer/ItemObserver.swift +90 -0
  156. package/ios/Observer/PlayerObserver.swift +59 -0
  157. package/ios/Option/SessionCategories.swift +42 -92
  158. package/ios/Player/AudioSessionController.swift +191 -0
  159. package/ios/Player/DeferredSeek.swift +70 -0
  160. package/ios/Player/ErrorStatus.swift +50 -0
  161. package/ios/Player/MediaLoader.swift +66 -87
  162. package/ios/Player/NowPlayingLines.swift +36 -0
  163. package/ios/Player/NowPlayingUpdater.swift +180 -85
  164. package/ios/Player/PlaybackFailure.swift +125 -0
  165. package/ios/Player/PlaybackPersistence.swift +73 -0
  166. package/ios/Player/PlaybackTimer.swift +8 -2
  167. package/ios/Player/Player.swift +960 -0
  168. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  169. package/ios/Player/PlayerEngine.swift +104 -0
  170. package/ios/Player/PlayerStatusTypes.swift +2 -6
  171. package/ios/Player/QueueManager.swift +93 -67
  172. package/ios/Player/RetryLoop.swift +291 -0
  173. package/ios/Player/ShuffleOrder.swift +33 -0
  174. package/ios/Player/SleepTimerManager.swift +14 -16
  175. package/ios/Player/VolumeFader.swift +5 -0
  176. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  177. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  178. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  179. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  180. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  181. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  182. package/ios/Tests/DeferredSeekTests.swift +70 -0
  183. package/ios/Tests/EmitterTests.swift +22 -38
  184. package/ios/Tests/ErrorStatusTests.swift +50 -0
  185. package/ios/Tests/FavoriteSetTests.swift +60 -0
  186. package/ios/Tests/GenerationMemoTests.swift +121 -0
  187. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  188. package/ios/Tests/JsonModelsTests.swift +194 -1
  189. package/ios/Tests/LRUCacheTests.swift +110 -0
  190. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  191. package/ios/Tests/MediaLoaderTests.swift +36 -67
  192. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  193. package/ios/Tests/NowPlayingLinesTests.swift +43 -0
  194. package/ios/Tests/ObserverTests.swift +88 -0
  195. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  196. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  197. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  198. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  199. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +489 -311
  200. package/ios/Tests/PlayingStateTests.swift +42 -0
  201. package/ios/Tests/QueueManagerTests.swift +196 -115
  202. package/ios/Tests/ReadyValueTests.swift +73 -0
  203. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  204. package/ios/Tests/RequestLayerTests.swift +228 -0
  205. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  206. package/ios/Tests/RetryLoopTests.swift +305 -0
  207. package/ios/Tests/SearchDrillInTests.swift +16 -16
  208. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  209. package/ios/Tests/SectionPresentationTests.swift +98 -0
  210. package/ios/Tests/SectionScopeTests.swift +139 -54
  211. package/ios/Tests/SimpleRouterTests.swift +38 -3
  212. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  213. package/ios/Tests/StyleResolverTests.swift +132 -0
  214. package/ios/Tests/Support/TestTypes.swift +146 -101
  215. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  216. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  217. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  218. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  219. package/ios/Tests/TrackIdentityTests.swift +20 -0
  220. package/ios/Tests/TrackSelectorTests.swift +168 -33
  221. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  222. package/ios/TrackSelector.swift +62 -65
  223. package/ios/Util/ArtworkImageFetcher.swift +58 -1
  224. package/ios/Util/ConcurrentMap.swift +19 -0
  225. package/ios/Util/Emitter.swift +40 -12
  226. package/ios/Util/GenerationMemo.swift +36 -0
  227. package/ios/Util/LRUCache.swift +23 -159
  228. package/ios/Util/NetworkMonitor.swift +32 -32
  229. package/ios/Util/OutputPicker.swift +48 -0
  230. package/ios/Util/ReadyValue.swift +56 -0
  231. package/ios/Util/SFSymbolRenderer.swift +59 -31
  232. package/ios/Util/SVGProcessor.swift +9 -12
  233. package/lib/commonjs/AudioBrowser.js +8 -8
  234. package/lib/commonjs/AudioBrowser.js.map +1 -1
  235. package/lib/commonjs/CLAUDE.md +52 -0
  236. package/lib/commonjs/features/browser-config.js +12 -8
  237. package/lib/commonjs/features/browser-config.js.map +1 -1
  238. package/lib/commonjs/features/browser.js +11 -3
  239. package/lib/commonjs/features/browser.js.map +1 -1
  240. package/lib/commonjs/features/carConnection.js +1 -1
  241. package/lib/commonjs/features/equalizer.js +1 -1
  242. package/lib/commonjs/features/errors.js +3 -3
  243. package/lib/commonjs/features/favorites.js +14 -11
  244. package/lib/commonjs/features/favorites.js.map +1 -1
  245. package/lib/commonjs/features/gate.js +16 -1
  246. package/lib/commonjs/features/gate.js.map +1 -1
  247. package/lib/commonjs/features/metadata.js +20 -3
  248. package/lib/commonjs/features/metadata.js.map +1 -1
  249. package/lib/commonjs/features/network.js +1 -1
  250. package/lib/commonjs/features/nowPlaying.js +1 -1
  251. package/lib/commonjs/features/output.js +1 -1
  252. package/lib/commonjs/features/playback/controls.js +4 -2
  253. package/lib/commonjs/features/playback/controls.js.map +1 -1
  254. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  255. package/lib/commonjs/features/playback/playing.js +1 -1
  256. package/lib/commonjs/features/playback/progress.js +3 -2
  257. package/lib/commonjs/features/playback/progress.js.map +1 -1
  258. package/lib/commonjs/features/playback/rate.js +8 -1
  259. package/lib/commonjs/features/playback/rate.js.map +1 -1
  260. package/lib/commonjs/features/playback/state.js +3 -4
  261. package/lib/commonjs/features/playback/state.js.map +1 -1
  262. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  263. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  264. package/lib/commonjs/features/playback/volume.js +1 -1
  265. package/lib/commonjs/features/player/options.js +48 -34
  266. package/lib/commonjs/features/player/options.js.map +1 -1
  267. package/lib/commonjs/features/player/setup.js +18 -9
  268. package/lib/commonjs/features/player/setup.js.map +1 -1
  269. package/lib/commonjs/features/player/validateOptions.js +23 -0
  270. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  271. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  272. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  273. package/lib/commonjs/features/queue/queue.js +13 -6
  274. package/lib/commonjs/features/queue/queue.js.map +1 -1
  275. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  276. package/lib/commonjs/features/queue/shuffle.js +1 -1
  277. package/lib/commonjs/features/remoteControls.js +13 -92
  278. package/lib/commonjs/features/remoteControls.js.map +1 -1
  279. package/lib/commonjs/features/sleepTimer.js +13 -1
  280. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  281. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  282. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  283. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  284. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  285. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  286. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  287. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  288. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  289. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  290. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  291. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  292. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  293. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  294. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  295. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  296. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  297. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  298. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  299. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  300. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  301. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  302. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  303. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  304. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  305. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  306. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  307. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  308. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  309. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  310. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  311. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  312. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  313. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  314. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  315. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  316. package/lib/commonjs/web/browser/sections.js +89 -0
  317. package/lib/commonjs/web/browser/sections.js.map +1 -0
  318. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  319. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  320. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  321. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  322. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  323. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  324. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  325. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  326. package/lib/module/AudioBrowser.js +2 -1
  327. package/lib/module/AudioBrowser.js.map +1 -1
  328. package/lib/module/CLAUDE.md +52 -0
  329. package/lib/module/features/browser-config.js +12 -8
  330. package/lib/module/features/browser-config.js.map +1 -1
  331. package/lib/module/features/browser.js +11 -3
  332. package/lib/module/features/browser.js.map +1 -1
  333. package/lib/module/features/carConnection.js +1 -1
  334. package/lib/module/features/equalizer.js +1 -1
  335. package/lib/module/features/errors.js +3 -3
  336. package/lib/module/features/favorites.js +14 -11
  337. package/lib/module/features/favorites.js.map +1 -1
  338. package/lib/module/features/gate.js +16 -1
  339. package/lib/module/features/gate.js.map +1 -1
  340. package/lib/module/features/metadata.js +20 -3
  341. package/lib/module/features/metadata.js.map +1 -1
  342. package/lib/module/features/network.js +1 -1
  343. package/lib/module/features/nowPlaying.js +1 -1
  344. package/lib/module/features/output.js +1 -1
  345. package/lib/module/features/playback/controls.js +4 -2
  346. package/lib/module/features/playback/controls.js.map +1 -1
  347. package/lib/module/features/playback/playWhenReady.js +1 -1
  348. package/lib/module/features/playback/playing.js +1 -1
  349. package/lib/module/features/playback/progress.js +3 -2
  350. package/lib/module/features/playback/progress.js.map +1 -1
  351. package/lib/module/features/playback/rate.js +8 -1
  352. package/lib/module/features/playback/rate.js.map +1 -1
  353. package/lib/module/features/playback/state.js +3 -4
  354. package/lib/module/features/playback/state.js.map +1 -1
  355. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  356. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  357. package/lib/module/features/playback/volume.js +1 -1
  358. package/lib/module/features/player/options.js +47 -32
  359. package/lib/module/features/player/options.js.map +1 -1
  360. package/lib/module/features/player/setup.js +17 -8
  361. package/lib/module/features/player/setup.js.map +1 -1
  362. package/lib/module/features/player/validateOptions.js +19 -0
  363. package/lib/module/features/player/validateOptions.js.map +1 -0
  364. package/lib/module/features/queue/activeTrack.js +15 -4
  365. package/lib/module/features/queue/activeTrack.js.map +1 -1
  366. package/lib/module/features/queue/queue.js +13 -6
  367. package/lib/module/features/queue/queue.js.map +1 -1
  368. package/lib/module/features/queue/repeatMode.js +1 -1
  369. package/lib/module/features/queue/shuffle.js +1 -1
  370. package/lib/module/features/remoteControls.js +13 -92
  371. package/lib/module/features/remoteControls.js.map +1 -1
  372. package/lib/module/features/sleepTimer.js +13 -1
  373. package/lib/module/features/sleepTimer.js.map +1 -1
  374. package/lib/module/test-utils/reactNativeStub.js +58 -0
  375. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  376. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  377. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  378. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  379. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  380. package/lib/module/utils/getTrackIdentity.js +20 -0
  381. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  382. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  383. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  384. package/lib/module/web/NativeAudioBrowser.js +202 -77
  385. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  386. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  387. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  388. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  389. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  390. package/lib/module/web/TrackPlayer/Player.js +254 -39
  391. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  392. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  393. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  394. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  395. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  396. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  397. package/lib/module/web/browser/BrowserManager.js +175 -100
  398. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  399. package/lib/module/web/browser/FavoriteManager.js +31 -21
  400. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  401. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  402. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  403. package/lib/module/web/browser/SearchManager.js +18 -23
  404. package/lib/module/web/browser/SearchManager.js.map +1 -1
  405. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  406. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  407. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  408. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  409. package/lib/module/web/browser/sections.js +83 -0
  410. package/lib/module/web/browser/sections.js.map +1 -0
  411. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  412. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  413. package/lib/module/web/http/followMediaRedirect.js +215 -0
  414. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  415. package/lib/module/web/player/NowPlayingManager.js +4 -3
  416. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  417. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  418. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  419. package/lib/typescript/package.json +1 -0
  420. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  421. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  422. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  423. package/lib/typescript/src/features/browser.d.ts +10 -2
  424. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  425. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  426. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  427. package/lib/typescript/src/features/errors.d.ts +3 -3
  428. package/lib/typescript/src/features/favorites.d.ts +14 -11
  429. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  430. package/lib/typescript/src/features/gate.d.ts +18 -2
  431. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  432. package/lib/typescript/src/features/metadata.d.ts +20 -3
  433. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  434. package/lib/typescript/src/features/network.d.ts +1 -1
  435. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  436. package/lib/typescript/src/features/output.d.ts +1 -1
  437. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  438. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  439. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  440. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  441. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  442. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  443. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  444. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  445. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  446. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  447. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  448. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  449. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  450. package/lib/typescript/src/features/player/options.d.ts +108 -56
  451. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  452. package/lib/typescript/src/features/player/setup.d.ts +14 -4
  453. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  454. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  455. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  456. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  457. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  458. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  459. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  460. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  461. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  462. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  463. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  464. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  465. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  466. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  467. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  468. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  469. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  470. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  471. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  472. package/lib/typescript/src/types/browser.d.ts +93 -61
  473. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  474. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  475. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  476. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  477. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  478. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  479. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  480. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  481. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  482. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  483. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  484. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +1 -2
  485. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  486. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  487. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  488. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +12 -12
  489. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  490. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  491. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  492. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  493. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  494. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  495. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  496. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  497. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  498. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  499. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  500. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  501. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  502. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  503. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  504. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  505. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  506. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  507. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  508. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  509. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  510. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  511. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  512. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  513. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  514. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  515. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  516. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  517. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  518. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  519. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  520. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  521. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  522. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  523. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  524. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  525. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  526. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  527. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  528. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  529. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  530. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  531. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  532. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  533. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +9 -12
  534. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  535. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  536. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  537. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  538. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  539. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  540. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  541. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  542. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  543. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  544. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  545. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  546. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  547. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  548. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  549. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  550. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  551. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  552. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  553. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  554. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  555. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  556. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  557. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  558. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  559. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  560. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  561. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  564. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  565. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -53
  566. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  567. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  568. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  572. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  573. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  574. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  575. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  576. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  577. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  578. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  579. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  581. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  582. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  583. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  584. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +17 -14
  585. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +9 -12
  586. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  587. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  588. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  589. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  590. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +12 -12
  591. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  592. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  593. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  594. package/nitrogen/generated/android/c++/JOptions.hpp +9 -12
  595. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  596. package/nitrogen/generated/android/c++/JOutputType.hpp +2 -2
  597. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  598. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  599. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  600. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  602. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  605. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  607. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  608. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  609. package/nitrogen/generated/android/c++/{JNotificationButton.hpp → JRemoteButton.hpp} +19 -19
  610. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +86 -0
  611. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  612. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  613. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  616. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  619. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  621. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  622. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  623. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  625. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  626. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  627. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  628. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  630. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  631. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  632. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  633. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  634. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  635. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  637. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  638. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  639. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  640. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  641. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp +26 -0
  642. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +75 -0
  643. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  644. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  645. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  646. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +20 -3
  647. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  648. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  649. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  650. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  651. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  652. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  653. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  654. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  655. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  656. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  657. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  658. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  659. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  660. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  661. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  662. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  663. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  664. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  665. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  666. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  667. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  668. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  669. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  670. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  671. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  672. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  673. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  674. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  675. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  676. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  677. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  678. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  679. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  680. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  681. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  682. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  683. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  684. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  685. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  686. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  687. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  688. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  689. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  690. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  691. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  692. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  693. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  694. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  695. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  696. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  697. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  698. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  699. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  700. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  701. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  702. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  703. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  704. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  705. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  706. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  707. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  708. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  709. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  710. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  711. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  712. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  713. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  714. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  715. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  716. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  717. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  718. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  719. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +29 -0
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +20 -3
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  739. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  746. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  749. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{NotificationButton.kt → RemoteButton.kt} +3 -3
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +61 -0
  752. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Variant_NullType_NotificationButtonLayout.kt → Variant_NullType_RemoteButtonLayout.kt} +24 -15
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  782. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  783. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  784. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +779 -665
  785. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +34 -16
  786. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +36 -18
  787. package/nitrogen/generated/ios/swift/AndroidOptions.swift +12 -12
  788. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  789. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  790. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  791. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  792. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  793. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  794. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  795. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  796. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  797. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  798. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  799. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  800. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  801. package/nitrogen/generated/ios/swift/NitroAndroidUpdateOptions.swift +12 -12
  802. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  803. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  804. package/nitrogen/generated/ios/swift/{NotificationButton.swift → RemoteButton.swift} +6 -6
  805. package/nitrogen/generated/ios/swift/RemoteButtonLayout.swift +57 -0
  806. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  807. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  808. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  809. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  810. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  811. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  812. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  813. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  814. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  815. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  816. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +30 -0
  817. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  818. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  819. package/nitrogen/generated/shared/c++/AndroidOptions.hpp +8 -8
  820. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  821. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  822. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  823. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  824. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  825. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  826. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  827. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  828. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  829. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  830. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  831. package/nitrogen/generated/shared/c++/NitroAndroidUpdateOptions.hpp +8 -8
  832. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  833. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  834. package/nitrogen/generated/shared/c++/{NotificationButton.hpp → RemoteButton.hpp} +19 -19
  835. package/nitrogen/generated/shared/c++/RemoteButtonLayout.hpp +94 -0
  836. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  837. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  838. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  839. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  840. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  841. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  842. package/package.json +24 -11
  843. package/src/AudioBrowser.ts +2 -1
  844. package/src/CLAUDE.md +52 -0
  845. package/src/features/battery.test.ts +79 -0
  846. package/src/features/browser-config.test.ts +21 -6
  847. package/src/features/browser-config.ts +12 -8
  848. package/src/features/browser.test.ts +1 -1
  849. package/src/features/browser.ts +11 -3
  850. package/src/features/carConnection.ts +1 -1
  851. package/src/features/equalizer.ts +1 -1
  852. package/src/features/errors.ts +3 -3
  853. package/src/features/favorites.ts +14 -11
  854. package/src/features/gate.ts +16 -1
  855. package/src/features/hook-wiring.test.ts +302 -0
  856. package/src/features/metadata.ts +20 -3
  857. package/src/features/network.ts +1 -1
  858. package/src/features/nowPlaying.ts +1 -1
  859. package/src/features/output.ts +1 -1
  860. package/src/features/playback/controls.ts +4 -2
  861. package/src/features/playback/playWhenReady.ts +1 -1
  862. package/src/features/playback/playing.ts +1 -1
  863. package/src/features/playback/progress.test.ts +169 -0
  864. package/src/features/playback/progress.ts +3 -2
  865. package/src/features/playback/rate.ts +8 -1
  866. package/src/features/playback/state.ts +3 -4
  867. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  868. package/src/features/playback/trackPlaybackTime.ts +1 -6
  869. package/src/features/playback/volume.ts +1 -1
  870. package/src/features/player/options.ts +126 -76
  871. package/src/features/player/setup.test.ts +24 -7
  872. package/src/features/player/setup.ts +22 -10
  873. package/src/features/player/validateOptions.ts +21 -0
  874. package/src/features/queue/activeTrack.ts +15 -4
  875. package/src/features/queue/queue.ts +13 -6
  876. package/src/features/queue/repeatMode.ts +1 -1
  877. package/src/features/queue/shuffle.ts +1 -1
  878. package/src/features/remoteControls.ts +13 -92
  879. package/src/features/sleepTimer.test.ts +172 -0
  880. package/src/features/sleepTimer.ts +9 -1
  881. package/src/nitro-stub-drift.test.ts +277 -0
  882. package/src/public-surface.test.ts +147 -0
  883. package/src/specs/audio-browser.nitro.ts +5 -4
  884. package/src/style-resolution.test.ts +210 -0
  885. package/src/test-utils/reactNativeStub.ts +60 -0
  886. package/src/types/browser-native.ts +7 -3
  887. package/src/types/browser-nodes.ts +403 -134
  888. package/src/types/browser.ts +97 -63
  889. package/src/utils/LazyNativeEmitter.ts +28 -15
  890. package/src/utils/NativeUpdatedValue.ts +29 -13
  891. package/src/utils/getTrackIdentity.ts +20 -0
  892. package/src/utils/useDebug.test.ts +182 -0
  893. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  894. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  895. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  896. package/src/web/NativeAudioBrowser.ts +241 -84
  897. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  898. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  899. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  900. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  901. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  902. package/src/web/TrackPlayer/Player.ts +284 -37
  903. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  904. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  905. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  906. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  907. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  908. package/src/web/__tests__/lifecycle.test.ts +345 -0
  909. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  910. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  911. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  912. package/src/web/__tests__/retry.test.ts +169 -0
  913. package/src/web/browser/BrowserManager.ts +209 -111
  914. package/src/web/browser/FavoriteManager.test.ts +84 -0
  915. package/src/web/browser/FavoriteManager.ts +28 -23
  916. package/src/web/browser/NavigationErrorManager.ts +3 -1
  917. package/src/web/browser/SearchManager.test.ts +75 -0
  918. package/src/web/browser/SearchManager.ts +25 -28
  919. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  920. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  921. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  922. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  923. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  924. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  925. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  926. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  927. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  928. package/src/web/browser/sections.test.ts +91 -0
  929. package/src/web/browser/sections.ts +72 -0
  930. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  931. package/src/web/http/RequestConfigBuilder.ts +140 -33
  932. package/src/web/http/followMediaRedirect.test.ts +289 -0
  933. package/src/web/http/followMediaRedirect.ts +253 -0
  934. package/src/web/player/NowPlayingManager.ts +4 -3
  935. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  936. package/src/web/util/BrowserPathHelper.ts +70 -13
  937. package/website/guide/android-auto.md +114 -0
  938. package/website/guide/android-certificates.md +409 -0
  939. package/website/guide/artwork.md +255 -0
  940. package/website/guide/audio-output.md +135 -0
  941. package/website/guide/automotive.md +86 -0
  942. package/website/guide/basic-usage.md +151 -0
  943. package/website/guide/battery.md +115 -0
  944. package/website/guide/browser.md +587 -0
  945. package/website/guide/carplay.md +650 -0
  946. package/website/guide/configuration.md +173 -0
  947. package/website/guide/equalizer.md +231 -0
  948. package/website/guide/errors.md +310 -0
  949. package/website/guide/favorites.md +154 -0
  950. package/website/guide/gate.md +143 -0
  951. package/website/guide/getting-started.md +46 -0
  952. package/website/guide/hooks.md +238 -0
  953. package/website/guide/live-streams.md +125 -0
  954. package/website/guide/metadata.md +239 -0
  955. package/website/guide/migrating-from-track-player.md +244 -0
  956. package/website/guide/native-callback-fetch.md +127 -0
  957. package/website/guide/network.md +86 -0
  958. package/website/guide/now-playing.md +175 -0
  959. package/website/guide/playback.md +328 -0
  960. package/website/guide/queue.md +300 -0
  961. package/website/guide/remote-controls.md +256 -0
  962. package/website/guide/search.md +255 -0
  963. package/website/guide/sleep-timer.md +268 -0
  964. package/website/guide/track.md +247 -0
  965. package/ios/Bridge.h +0 -8
  966. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  967. package/ios/Browser/MediaResolveComposer.swift +0 -114
  968. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  969. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  970. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  971. package/ios/Model/MediaURL.swift +0 -67
  972. package/ios/Model/SourceType.swift +0 -6
  973. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  974. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  975. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  976. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  977. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  978. package/ios/Observer/PlayerStateObserver.swift +0 -50
  979. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  980. package/ios/Option/PitchAlgorithms.swift +0 -17
  981. package/ios/Option/TimeEventFrequency.swift +0 -18
  982. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  983. package/ios/Player/MediaIntentCriteria.swift +0 -139
  984. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  985. package/ios/Player/PlaybackCoordinator.swift +0 -754
  986. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  987. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  988. package/ios/Player/PlaybackStateStore.swift +0 -27
  989. package/ios/Player/PlayingStateManager.swift +0 -33
  990. package/ios/Player/RetryManager.swift +0 -322
  991. package/ios/Player/SeekCompletionHandler.swift +0 -3
  992. package/ios/Player/SleepTimerHandling.swift +0 -15
  993. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  994. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  995. package/ios/Tests/MediaResolveTests.swift +0 -126
  996. package/ios/Tests/OnceValueTests.swift +0 -79
  997. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  998. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  999. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1000. package/ios/Tests/RetryManagerTests.swift +0 -89
  1001. package/ios/TrackPlayer.swift +0 -1014
  1002. package/ios/TrackPlayerCallbacks.swift +0 -86
  1003. package/ios/Util/MetadataAdapter.swift +0 -131
  1004. package/ios/Util/OnceValue.swift +0 -104
  1005. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1006. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1007. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1008. package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp +0 -94
  1009. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1010. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1011. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp +0 -26
  1012. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp +0 -75
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt +0 -50
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1017. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1018. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1019. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1020. package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift +0 -92
  1021. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1022. package/nitrogen/generated/ios/swift/Variant_NullType_NotificationButtonLayout.swift +0 -18
  1023. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1024. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
  1025. package/nitrogen/generated/shared/c++/NotificationButtonLayout.hpp +0 -102
@@ -1,19 +1,22 @@
1
1
  package com.audiobrowser.player
2
2
 
3
- import com.margelo.nitro.audiobrowser.NotificationButton
4
- import com.margelo.nitro.audiobrowser.NotificationButtonLayout
5
3
  import com.margelo.nitro.audiobrowser.PlayerCapabilities
4
+ import com.margelo.nitro.audiobrowser.RemoteButton
5
+ import com.margelo.nitro.audiobrowser.RemoteButtonLayout
6
6
 
7
7
  /**
8
- * The pure decision core for Capability-gated controls: one rule for whether a control is available
9
- * ([isEnabled]) and one derivation of the notification button layout ([deriveNotificationSlots]).
10
- * MediaSessionCommandManager's three Media3 assemblies (external player commands, session button
11
- * layout, notification commands/layout) all consume these decisions — previously each
8
+ * The pure decision core for Capabilities: one rule for whether a Capability is enabled
9
+ * ([isEnabled]) and one derivation of the button layout ([deriveButtonSlots]).
10
+ * MediaSessionCommandManager's Media3 assemblies all consume these decisions — previously each
12
11
  * re-implemented them, and the copies had drifted.
13
12
  */
14
13
 
15
- /** A user-facing control gated by a Capability. */
16
- enum class Control {
14
+ /**
15
+ * A control that a Capability gates. Mirrors the [PlayerCapabilities] flags Android acts on —
16
+ * `shuffleMode`, `repeatMode` and `playbackRate` exist on the struct but only drive CarPlay, so
17
+ * they have no entry here.
18
+ */
19
+ enum class Capability {
17
20
  PLAY_PAUSE,
18
21
  STOP,
19
22
  SEEK_TO,
@@ -25,95 +28,145 @@ enum class Control {
25
28
  }
26
29
 
27
30
  /**
28
- * Whether a Capability-gated control is available. Everything is enabled by default and only an
29
- * explicit `false` disables — except FAVORITE, which is opt-in, and PLAY_PAUSE, which is one
30
- * control on every surface and only goes away when both halves are disabled.
31
+ * Whether a Capability is enabled. Everything is enabled by default and only an explicit `false`
32
+ * disables — except FAVORITE, which is opt-in, and PLAY_PAUSE, which is one control on every
33
+ * surface and only goes away when both halves are disabled.
31
34
  */
32
- fun PlayerCapabilities.isEnabled(control: Control): Boolean =
33
- when (control) {
34
- Control.PLAY_PAUSE -> !(play == false && pause == false)
35
- Control.STOP -> stop != false
36
- Control.SEEK_TO -> seekTo != false
37
- Control.SKIP_TO_NEXT -> skipToNext != false
38
- Control.SKIP_TO_PREVIOUS -> skipToPrevious != false
39
- Control.JUMP_FORWARD -> jumpForward != false
40
- Control.JUMP_BACKWARD -> jumpBackward != false
41
- Control.FAVORITE -> favoriteEnabled
35
+ fun PlayerCapabilities.isEnabled(capability: Capability): Boolean =
36
+ when (capability) {
37
+ Capability.PLAY_PAUSE -> !(play == false && pause == false)
38
+ Capability.STOP -> stop != false
39
+ Capability.SEEK_TO -> seekTo != false
40
+ Capability.SKIP_TO_NEXT -> skipToNext != false
41
+ Capability.SKIP_TO_PREVIOUS -> skipToPrevious != false
42
+ Capability.JUMP_FORWARD -> jumpForward != false
43
+ Capability.JUMP_BACKWARD -> jumpBackward != false
44
+ Capability.FAVORITE -> favoriteEnabled
42
45
  }
43
46
 
44
- /** Notification slot, mapped to `CommandButton.SLOT_*` at Media3 assembly time. */
45
- enum class NotificationSlot {
47
+ /**
48
+ * The three positions Android actually offers, mapped to `CommandButton.SLOT_*` at Media3 assembly
49
+ * time. There is no secondary pair: every system surface flattens the layout to back, forward and
50
+ * overflow, so a fourth or fifth position would have nowhere to render.
51
+ *
52
+ * Media3 does define SLOT_BACK_SECONDARY and SLOT_FORWARD_SECONDARY, but `DisplayConstraints`
53
+ * defaults both to **0 buttons** — only a controller that opts in with `setMaxButtonsForSlot` shows
54
+ * them, which no system surface does.
55
+ */
56
+ enum class ButtonSlot {
46
57
  BACK,
47
58
  FORWARD,
48
- BACK_SECONDARY,
49
- FORWARD_SECONDARY,
50
59
  OVERFLOW,
51
60
  }
52
61
 
53
- data class SlottedButton(val button: NotificationButton, val slot: NotificationSlot)
62
+ data class SlottedButton(val button: RemoteButton, val slot: ButtonSlot)
54
63
 
55
- private val NotificationButton.control: Control
64
+ /** The Capability gating a button. */
65
+ private val RemoteButton.capability: Capability
56
66
  get() =
57
67
  when (this) {
58
- NotificationButton.SKIP_TO_PREVIOUS -> Control.SKIP_TO_PREVIOUS
59
- NotificationButton.SKIP_TO_NEXT -> Control.SKIP_TO_NEXT
60
- NotificationButton.JUMP_BACKWARD -> Control.JUMP_BACKWARD
61
- NotificationButton.JUMP_FORWARD -> Control.JUMP_FORWARD
62
- NotificationButton.FAVORITE -> Control.FAVORITE
68
+ RemoteButton.SKIP_TO_PREVIOUS -> Capability.SKIP_TO_PREVIOUS
69
+ RemoteButton.SKIP_TO_NEXT -> Capability.SKIP_TO_NEXT
70
+ RemoteButton.JUMP_BACKWARD -> Capability.JUMP_BACKWARD
71
+ RemoteButton.JUMP_FORWARD -> Capability.JUMP_FORWARD
72
+ RemoteButton.FAVORITE -> Capability.FAVORITE
63
73
  }
64
74
 
65
75
  /** Whether [button]'s gating Capability allows it. */
66
- fun PlayerCapabilities.allows(button: NotificationButton): Boolean = isEnabled(button.control)
76
+ fun PlayerCapabilities.allows(button: RemoteButton): Boolean = isEnabled(button.capability)
77
+
78
+ /**
79
+ * Whether two layouts describe the same arrangement.
80
+ *
81
+ * [RemoteButtonLayout] is a generated data class whose `overflow` is an `Array`, and Kotlin
82
+ * data-class equality compares arrays by *reference*. Plain `==` therefore reports "changed" for
83
+ * two identical layouts whenever overflow is set, because every options update carries a fresh
84
+ * array across the bridge — which would republish the layout to Android Auto on every unrelated
85
+ * `updateOptions` call.
86
+ */
87
+ internal fun RemoteButtonLayout?.sameAs(other: RemoteButtonLayout?): Boolean =
88
+ if (this == null || other == null) {
89
+ this == null && other == null
90
+ } else {
91
+ back == other.back && forward == other.forward && overflow.contentEquals(other.overflow)
92
+ }
67
93
 
68
94
  /**
69
- * The single derivation of the notification button layout: an explicit [layout]'s slots filtered to
70
- * allowed buttons, or — with no layout — the capability defaults: skip on the primary slots (jump
71
- * falling back to a primary slot when its skip is disabled), jump on the secondary slots otherwise,
72
- * favorite in overflow.
95
+ * The single derivation of the button layout.
96
+ *
97
+ * The two parameters answer different questions, and only one of them is authoritative:
98
+ * - [capabilities] — *may* this button exist? Admission.
99
+ * - [layout] — *where* does it go? Arrangement.
100
+ *
101
+ * **A layout can rearrange buttons but never add one.** Every entry is filtered through [allows]
102
+ * regardless of its position, so naming a button whose Capability is disabled does nothing —
103
+ * listing `FAVORITE` while `capabilities.favorite` is off leaves it off. This is the usual
104
+ * surprise, because JUMP_FORWARD and JUMP_BACKWARD default to disabled: a layout full of jump
105
+ * buttons silently produces none until those capabilities are turned on.
106
+ *
107
+ * With no [layout], [capabilities] does both jobs — it decides membership *and* infers positions:
108
+ * skip takes the primary positions, jump falls back into a primary position when its skip is
109
+ * disabled and otherwise sits in overflow, favorite in overflow.
110
+ *
111
+ * With a [layout], each field maps to its position — `back` to BACK, `forward` to FORWARD, every
112
+ * `overflow` entry to OVERFLOW in order — and disabled entries drop out. A dropped entry leaves its
113
+ * position empty rather than promoting anything into it: turning off one capability must not
114
+ * silently rearrange the row.
115
+ *
116
+ * A [layout] is all-or-nothing: every field is required, so it fully describes the arrangement and
117
+ * nothing is merged with the capability defaults. The bridge could not support a per-field merge
118
+ * anyway — Nitro maps both an omitted and a null enum field to Kotlin `null`, so native cannot tell
119
+ * "leave this empty" from "derive this one".
120
+ *
121
+ * [capabilities] has a second job outside this function: it also drives the player and session
122
+ * commands, which govern what a Bluetooth remote or headset can trigger. That is why placement is
123
+ * purely cosmetic here — a button left out of the layout disappears from every screen while still
124
+ * responding to a headset.
125
+ *
126
+ * @param capabilities What the player is allowed to do. Gates every button, in both modes.
127
+ * @param layout Explicit placement, or null to infer placement from [capabilities].
73
128
  */
74
- fun deriveNotificationSlots(
129
+ fun deriveButtonSlots(
75
130
  capabilities: PlayerCapabilities,
76
- layout: NotificationButtonLayout?,
131
+ layout: RemoteButtonLayout?,
77
132
  ): List<SlottedButton> {
78
133
  if (layout != null) {
79
134
  return buildList {
80
- layout.back?.let { add(SlottedButton(it, NotificationSlot.BACK)) }
81
- layout.forward?.let { add(SlottedButton(it, NotificationSlot.FORWARD)) }
82
- layout.backSecondary?.let { add(SlottedButton(it, NotificationSlot.BACK_SECONDARY)) }
83
- layout.forwardSecondary?.let { add(SlottedButton(it, NotificationSlot.FORWARD_SECONDARY)) }
84
- layout.overflow?.forEach { add(SlottedButton(it, NotificationSlot.OVERFLOW)) }
135
+ layout.back?.let { add(SlottedButton(it, ButtonSlot.BACK)) }
136
+ layout.forward?.let { add(SlottedButton(it, ButtonSlot.FORWARD)) }
137
+ layout.overflow.forEach { add(SlottedButton(it, ButtonSlot.OVERFLOW)) }
85
138
  }
86
139
  .filter { capabilities.allows(it.button) }
87
140
  }
88
141
 
89
142
  return buildList {
90
- val skipPrevious = capabilities.isEnabled(Control.SKIP_TO_PREVIOUS)
91
- val skipNext = capabilities.isEnabled(Control.SKIP_TO_NEXT)
92
- val jumpBackward = capabilities.isEnabled(Control.JUMP_BACKWARD)
93
- val jumpForward = capabilities.isEnabled(Control.JUMP_FORWARD)
143
+ val skipPrevious = capabilities.isEnabled(Capability.SKIP_TO_PREVIOUS)
144
+ val skipNext = capabilities.isEnabled(Capability.SKIP_TO_NEXT)
145
+ val jumpBackward = capabilities.isEnabled(Capability.JUMP_BACKWARD)
146
+ val jumpForward = capabilities.isEnabled(Capability.JUMP_FORWARD)
94
147
 
95
- // Primary slots: skip, with jump falling back when its skip is disabled.
148
+ // Primary positions: skip, with jump falling back when its skip is disabled.
96
149
  if (skipPrevious) {
97
- add(SlottedButton(NotificationButton.SKIP_TO_PREVIOUS, NotificationSlot.BACK))
150
+ add(SlottedButton(RemoteButton.SKIP_TO_PREVIOUS, ButtonSlot.BACK))
98
151
  } else if (jumpBackward) {
99
- add(SlottedButton(NotificationButton.JUMP_BACKWARD, NotificationSlot.BACK))
152
+ add(SlottedButton(RemoteButton.JUMP_BACKWARD, ButtonSlot.BACK))
100
153
  }
101
154
  if (skipNext) {
102
- add(SlottedButton(NotificationButton.SKIP_TO_NEXT, NotificationSlot.FORWARD))
155
+ add(SlottedButton(RemoteButton.SKIP_TO_NEXT, ButtonSlot.FORWARD))
103
156
  } else if (jumpForward) {
104
- add(SlottedButton(NotificationButton.JUMP_FORWARD, NotificationSlot.FORWARD))
157
+ add(SlottedButton(RemoteButton.JUMP_FORWARD, ButtonSlot.FORWARD))
105
158
  }
106
159
 
107
- // Jump moves to the secondary slots when skip holds the primary.
160
+ // Jump moves to overflow when skip holds the primary position.
108
161
  if (skipPrevious && jumpBackward) {
109
- add(SlottedButton(NotificationButton.JUMP_BACKWARD, NotificationSlot.BACK_SECONDARY))
162
+ add(SlottedButton(RemoteButton.JUMP_BACKWARD, ButtonSlot.OVERFLOW))
110
163
  }
111
164
  if (skipNext && jumpForward) {
112
- add(SlottedButton(NotificationButton.JUMP_FORWARD, NotificationSlot.FORWARD_SECONDARY))
165
+ add(SlottedButton(RemoteButton.JUMP_FORWARD, ButtonSlot.OVERFLOW))
113
166
  }
114
167
 
115
- if (capabilities.isEnabled(Control.FAVORITE)) {
116
- add(SlottedButton(NotificationButton.FAVORITE, NotificationSlot.OVERFLOW))
168
+ if (capabilities.isEnabled(Capability.FAVORITE)) {
169
+ add(SlottedButton(RemoteButton.FAVORITE, ButtonSlot.OVERFLOW))
117
170
  }
118
171
  }
119
172
  }
@@ -0,0 +1,77 @@
1
+ package com.audiobrowser.player
2
+
3
+ import okhttp3.HttpUrl
4
+ import okhttp3.Interceptor
5
+ import okhttp3.Request
6
+ import okhttp3.Response
7
+
8
+ /**
9
+ * Drops the caller's headers once a redirect leaves the origin.
10
+ *
11
+ * OkHttp does this for `Authorization` alone — RetryAndFollowUpInterceptor.buildRedirectRequest is
12
+ * a single `removeHeader("Authorization")` — so every other configured header, an `X-Api-Key` say,
13
+ * still reaches whatever host the first one named. iOS forwards none across a hop and web clears
14
+ * them too; this brings Android in line.
15
+ *
16
+ * Installed as a **network** interceptor, which runs once per hop. `chain.call().request()` is the
17
+ * call's original request, so the comparison is always against the URL the credential was addressed
18
+ * to rather than the hop before.
19
+ *
20
+ * Scoped to the redirect hop, and only that. An HLS segment or key fetch is its own Call, already
21
+ * addressed to the absolute CDN URL, and [TransformingDataSource] deliberately re-applies the
22
+ * config's headers to it — authenticated segments are a supported shape, and web does the same
23
+ * through Shaka's request filter. So this closes the leak of handing a credential to a host the
24
+ * caller never named; it is not a rule that the credential stays on one origin.
25
+ */
26
+ internal object CrossOriginHeaderStripper : Interceptor {
27
+
28
+ /**
29
+ * Headers that describe the transport rather than the caller. OkHttp and media3 set these per hop
30
+ * — `Range` carries the seek, `Host` and `Connection` are the connection's own — so the request
31
+ * breaks without them. Everything else on a media request came from the media config, and is the
32
+ * caller's to send only to the host it addressed.
33
+ *
34
+ * `Icy-MetaData` is media3's, not the caller's: `ProgressiveMediaPeriod` asks for Shoutcast
35
+ * metadata through `ICY_METADATA_HEADERS` on the DataSpec — the same channel
36
+ * [TransformingDataSource] puts the config's headers on, so nothing downstream can tell them
37
+ * apart. Dropping it on a hop costs the station's `icy-metaint`, so `IcyDataSource` is never
38
+ * installed and `onMetadata` stops firing: live "now playing" disappears on exactly the
39
+ * redirecting streams this interceptor exists for, and the interleaved metadata bytes stay in the
40
+ * audio as audible chirping. It is a request for a response format, never a credential.
41
+ */
42
+ private val TRANSPORT_HEADERS =
43
+ setOf(
44
+ "accept",
45
+ "accept-encoding",
46
+ "connection",
47
+ "content-length",
48
+ "host",
49
+ "icy-metadata",
50
+ "range",
51
+ "transfer-encoding",
52
+ "user-agent",
53
+ )
54
+
55
+ override fun intercept(chain: Interceptor.Chain): Response {
56
+ val request = chain.request()
57
+ val addressed = chain.call().request().url
58
+ return chain.proceed(
59
+ if (sameOrigin(addressed, request.url)) request else stripCallerHeaders(request)
60
+ )
61
+ }
62
+
63
+ /** Scheme, host and port — the same origin test `followMediaRedirect` applies on web. */
64
+ internal fun sameOrigin(a: HttpUrl, b: HttpUrl): Boolean =
65
+ a.scheme == b.scheme && a.host == b.host && a.port == b.port
66
+
67
+ /** The request with every caller-supplied header removed. */
68
+ internal fun stripCallerHeaders(request: Request): Request =
69
+ request
70
+ .newBuilder()
71
+ .apply {
72
+ request.headers.names().forEach { name ->
73
+ if (name.lowercase() !in TRANSPORT_HEADERS) removeHeader(name)
74
+ }
75
+ }
76
+ .build()
77
+ }
@@ -0,0 +1,63 @@
1
+ package com.audiobrowser.player
2
+
3
+ import androidx.media3.common.C
4
+ import androidx.media3.common.MediaItem
5
+ import androidx.media3.common.PlaybackParameters
6
+ import androidx.media3.common.Player as MediaPlayer
7
+ import androidx.media3.exoplayer.ExoPlayer
8
+ import androidx.media3.exoplayer.source.ShuffleOrder
9
+
10
+ /**
11
+ * What an engine is playing, and how: what [Player.setup] carries from the engine it releases to
12
+ * the one it builds, so new setup options don't stop playback.
13
+ */
14
+ internal data class EnginePlayback(
15
+ val mediaItems: List<MediaItem>,
16
+ val index: Int,
17
+ /**
18
+ * [C.TIME_UNSET] for a live item, which resumes at the live edge, and for 0, which is also how a
19
+ * live item reads before it has loaded.
20
+ */
21
+ val positionMs: Long,
22
+ val prepared: Boolean,
23
+ val playWhenReady: Boolean,
24
+ val repeatMode: Int,
25
+ val shuffleModeEnabled: Boolean,
26
+ val shuffleOrder: ShuffleOrder,
27
+ val playbackParameters: PlaybackParameters,
28
+ val volume: Float,
29
+ val skipSilenceEnabled: Boolean,
30
+ ) {
31
+ fun restoreTo(exoPlayer: ExoPlayer) {
32
+ exoPlayer.repeatMode = repeatMode
33
+ exoPlayer.shuffleModeEnabled = shuffleModeEnabled
34
+ exoPlayer.playbackParameters = playbackParameters
35
+ exoPlayer.volume = volume
36
+ exoPlayer.skipSilenceEnabled = skipSilenceEnabled
37
+ if (mediaItems.isNotEmpty()) {
38
+ exoPlayer.setMediaItems(mediaItems, index, positionMs)
39
+ exoPlayer.setShuffleOrder(shuffleOrder)
40
+ if (prepared) exoPlayer.prepare()
41
+ }
42
+ exoPlayer.playWhenReady = playWhenReady
43
+ }
44
+
45
+ companion object {
46
+ fun of(exoPlayer: ExoPlayer) =
47
+ EnginePlayback(
48
+ mediaItems = (0 until exoPlayer.mediaItemCount).map { exoPlayer.getMediaItemAt(it) },
49
+ index = exoPlayer.currentMediaItemIndex,
50
+ positionMs =
51
+ exoPlayer.currentPosition.takeUnless { exoPlayer.isCurrentMediaItemLive || it == 0L }
52
+ ?: C.TIME_UNSET,
53
+ prepared = exoPlayer.playbackState != MediaPlayer.STATE_IDLE,
54
+ playWhenReady = exoPlayer.playWhenReady,
55
+ repeatMode = exoPlayer.repeatMode,
56
+ shuffleModeEnabled = exoPlayer.shuffleModeEnabled,
57
+ shuffleOrder = exoPlayer.shuffleOrder,
58
+ playbackParameters = exoPlayer.playbackParameters,
59
+ volume = exoPlayer.volume,
60
+ skipSilenceEnabled = exoPlayer.skipSilenceEnabled,
61
+ )
62
+ }
63
+ }
@@ -4,18 +4,22 @@ import android.content.Context
4
4
  import androidx.media3.common.MediaItem
5
5
  import androidx.media3.datasource.DataSource
6
6
  import androidx.media3.datasource.DefaultDataSource
7
- import androidx.media3.datasource.DefaultHttpDataSource
8
7
  import androidx.media3.datasource.TransferListener
9
8
  import androidx.media3.datasource.cache.CacheDataSource
10
9
  import androidx.media3.datasource.cache.SimpleCache
10
+ import androidx.media3.datasource.okhttp.OkHttpDataSource
11
11
  import androidx.media3.exoplayer.drm.DrmSessionManagerProvider
12
12
  import androidx.media3.exoplayer.source.DefaultMediaSourceFactory
13
13
  import androidx.media3.exoplayer.source.MediaSource
14
14
  import androidx.media3.exoplayer.upstream.LoadErrorHandlingPolicy
15
15
  import androidx.media3.extractor.DefaultExtractorsFactory
16
16
  import com.audiobrowser.model.RetryPolicy
17
+ import com.audiobrowser.util.TrackFactory
17
18
  import com.margelo.nitro.audiobrowser.MediaRequestConfig
19
+ import com.margelo.nitro.audiobrowser.Track
18
20
  import java.io.IOException
21
+ import java.util.concurrent.TimeUnit
22
+ import okhttp3.OkHttpClient
19
23
 
20
24
  class MediaFactory(
21
25
  private val context: Context,
@@ -26,11 +30,25 @@ class MediaFactory(
26
30
  private val hasPlayed: () -> Boolean = { false },
27
31
  private val onRetryPending: ((exception: IOException, isNetworkError: Boolean) -> Unit)? = null,
28
32
  private val transferListener: TransferListener? = null,
29
- private val getRequestConfig: (originalUrl: String) -> MediaRequestConfig?,
33
+ private val getRequestConfig: (originalUrl: String, track: Track) -> MediaRequestConfig?,
30
34
  ) : MediaSource.Factory {
31
35
 
32
36
  companion object {
33
37
  private const val DEFAULT_USER_AGENT = "react-native-audio-browser"
38
+
39
+ /**
40
+ * The client media requests go out on. One per process so connections are reused; not
41
+ * `HttpClient`'s browse client, whose read timeout is sized for JSON and would cut a long media
42
+ * read short. The timeouts are media3's own defaults, so stall detection and
43
+ * [RetryLoadErrorHandlingPolicy] behave as they did before.
44
+ */
45
+ private val mediaHttpClient: OkHttpClient by lazy {
46
+ OkHttpClient.Builder()
47
+ .connectTimeout(8, TimeUnit.SECONDS)
48
+ .readTimeout(8, TimeUnit.SECONDS)
49
+ .addNetworkInterceptor(CrossOriginHeaderStripper)
50
+ .build()
51
+ }
34
52
  }
35
53
 
36
54
  private val extractorsFactory =
@@ -95,24 +113,28 @@ class MediaFactory(
95
113
  // ExoPlayer's IO thread. This prevents deadlocks when the JS thread is blocked by
96
114
  // synchronous Nitro calls (e.g., seekTo) while a media transform callback needs the
97
115
  // JS thread to resolve.
116
+
117
+ // OkHttp rather than DefaultHttpDataSource, for how each treats a redirect.
118
+ // DefaultHttpDataSource re-applies the request headers on every hop, handing
119
+ // an Authorization header to whatever host the first one named. OkHttp drops
120
+ // that one header itself, and [CrossOriginHeaderStripper] drops the rest.
98
121
  val httpFactory =
99
- DefaultHttpDataSource.Factory().apply {
100
- // Deliberately NOT setUserAgent(): DefaultHttpDataSource applies the factory
101
- // user-agent as a FINAL setRequestProperty("User-Agent", …) that runs after —
102
- // and overrides — the per-request DataSpec headers. That would clobber the
103
- // User-Agent TransformingDataSource sets per request (the whole point of the
104
- // per-request userAgent override). Supplying the same value as a default
105
- // request property keeps the default for un-overridden requests while letting
106
- // the per-request DataSpec header win.
122
+ OkHttpDataSource.Factory(mediaHttpClient).apply {
123
+ // Deliberately NOT setUserAgent(): it is applied last via addHeader(),
124
+ // which appends, so a request already carrying one would send two. As a
125
+ // default request property it is merged under dataSpec.httpRequestHeaders
126
+ // and applied with header(), letting TransformingDataSource's per-request
127
+ // override win.
107
128
  setDefaultRequestProperties(mapOf("User-Agent" to DEFAULT_USER_AGENT))
108
- setAllowCrossProtocolRedirects(true)
109
129
  // Connect transfer listener for bandwidth measurement
110
130
  transferListener?.let { setTransferListener(it) }
111
131
  }
112
132
  val baseFactory: DataSource.Factory = DefaultDataSource.Factory(context, httpFactory)
113
133
 
114
134
  // Wrap with TransformingDataSource to resolve URLs on the IO thread
115
- val transformingFactory = TransformingDataSource.Factory(baseFactory, getRequestConfig)
135
+ val track = TrackFactory.fromMedia3(mediaItem)
136
+ val transformingFactory =
137
+ TransformingDataSource.Factory(baseFactory) { url -> getRequestConfig(url, track) }
116
138
 
117
139
  // Configure data source factory with optional caching
118
140
  val dataSourceFactory =