react-native-audio-browser 0.2.0 → 1.0.0-next.2

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 (1589) hide show
  1. package/AudioBrowser.podspec +2 -2
  2. package/README.md +209 -2
  3. package/android/build.gradle +65 -10
  4. package/android/gradle.properties +3 -3
  5. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  6. package/android/src/main/AndroidManifest.xml +29 -1
  7. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +817 -404
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  9. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  10. package/android/src/main/java/com/audiobrowser/Callbacks.kt +5 -16
  11. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  12. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  13. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +222 -0
  14. package/android/src/main/java/com/audiobrowser/Service.kt +143 -97
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  16. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +38 -0
  17. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +50 -0
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +571 -490
  19. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +269 -0
  20. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  21. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +75 -0
  22. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +104 -45
  23. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  24. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +66 -0
  25. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  26. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  27. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +14 -21
  28. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  29. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  30. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +44 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  32. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  33. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  34. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +101 -103
  35. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  36. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +15 -20
  37. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +64 -27
  38. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +42 -58
  39. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +93 -47
  40. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +136 -0
  41. package/android/src/main/java/com/audiobrowser/player/ConnectionEndSource.kt +145 -0
  42. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  43. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +25 -36
  44. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  45. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +150 -0
  46. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +204 -0
  47. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  48. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  49. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +82 -55
  50. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +809 -266
  51. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +241 -442
  52. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +341 -0
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +119 -0
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +109 -0
  55. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +126 -119
  56. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +60 -0
  57. package/android/src/main/java/com/audiobrowser/player/Player.kt +1024 -965
  58. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +7 -0
  59. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +120 -0
  60. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +225 -107
  61. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +96 -0
  62. package/android/src/main/java/com/audiobrowser/player/RetryFocus.kt +126 -0
  63. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +95 -157
  64. package/android/src/main/java/com/audiobrowser/player/RetryLocks.kt +52 -0
  65. package/android/src/main/java/com/audiobrowser/player/RetryLoop.kt +310 -0
  66. package/android/src/main/java/com/audiobrowser/player/RetryView.kt +31 -0
  67. package/android/src/main/java/com/audiobrowser/player/SessionViewListener.kt +168 -0
  68. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  69. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  70. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +41 -21
  71. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +76 -0
  72. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +96 -66
  73. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +85 -0
  74. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  75. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +104 -0
  76. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  77. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  78. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +742 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +203 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  90. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  91. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  92. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  93. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  94. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  95. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +160 -0
  96. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  97. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +72 -0
  98. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +54 -0
  99. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +363 -0
  100. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +149 -0
  101. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  102. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +29 -0
  103. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +13 -0
  104. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  105. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  106. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  107. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  108. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +54 -73
  109. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +49 -0
  110. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +33 -0
  111. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +23 -316
  112. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +18 -60
  113. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +26 -25
  114. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +12 -11
  115. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +25 -56
  116. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +204 -0
  117. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +45 -0
  118. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +8 -8
  119. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +13 -0
  120. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  121. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +3 -112
  122. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +21 -10
  123. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +127 -82
  124. package/android/src/main/res/values/strings.xml +26 -2
  125. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  126. package/android/src/test/java/androidx/media3/session/SessionViews.kt +38 -0
  127. package/android/src/test/java/com/audiobrowser/AudioFixtures.kt +59 -0
  128. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  129. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  130. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  131. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +90 -0
  132. package/android/src/test/java/com/audiobrowser/NetworkFixtures.kt +25 -0
  133. package/android/src/test/java/com/audiobrowser/RemoteOutputRoutesTest.kt +29 -0
  134. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +81 -0
  135. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  136. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  137. package/android/src/test/java/com/audiobrowser/ServiceFixtures.kt +48 -0
  138. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +290 -0
  139. package/android/src/test/java/com/audiobrowser/SessionPositionUpdatesTest.kt +114 -0
  140. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +247 -0
  141. package/android/src/test/java/com/audiobrowser/browser/ArtworkResolutionRegistryTest.kt +46 -0
  142. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +39 -0
  143. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +108 -0
  144. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  145. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  146. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +203 -0
  147. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -4
  148. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +233 -0
  149. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  150. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +53 -0
  151. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  152. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +157 -0
  153. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +2 -7
  154. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  155. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +44 -0
  156. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  157. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  158. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +134 -8
  159. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  160. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  161. package/android/src/test/java/com/audiobrowser/player/AutomaticBufferManagerTest.kt +208 -0
  162. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  163. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +193 -0
  164. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  165. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +55 -0
  166. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +219 -0
  167. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  168. package/android/src/test/java/com/audiobrowser/player/HandleTrackLoadSeekTest.kt +243 -0
  169. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  170. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +493 -0
  171. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  172. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +36 -0
  173. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  174. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +672 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  176. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +167 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +250 -0
  178. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  179. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +135 -0
  180. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  181. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  182. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  183. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +33 -0
  184. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  185. package/android/src/test/java/com/audiobrowser/player/PlayerQueueVersionTest.kt +79 -0
  186. package/android/src/test/java/com/audiobrowser/player/PlayerRemoteOutputsSeekTest.kt +105 -0
  187. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +738 -0
  188. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +195 -0
  189. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  190. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  191. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  192. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +365 -0
  193. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +222 -0
  194. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  195. package/android/src/test/java/com/audiobrowser/player/RetryFocusTest.kt +97 -0
  196. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +190 -0
  197. package/android/src/test/java/com/audiobrowser/player/RetryLocksTest.kt +48 -0
  198. package/android/src/test/java/com/audiobrowser/player/RetryLoopCaseTest.kt +181 -0
  199. package/android/src/test/java/com/audiobrowser/player/RetryLoopTest.kt +221 -0
  200. package/android/src/test/java/com/audiobrowser/player/RetryMaskingTest.kt +178 -0
  201. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +212 -0
  202. package/android/src/test/java/com/audiobrowser/player/SessionViewListenerTest.kt +225 -0
  203. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  204. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +234 -0
  205. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  206. package/android/src/test/java/com/audiobrowser/player/SleepTimerTest.kt +48 -0
  207. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  208. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +231 -0
  209. package/android/src/test/java/com/audiobrowser/player/VolumeFaderTest.kt +43 -0
  210. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +309 -0
  211. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  212. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  213. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  214. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1037 -0
  215. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  216. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  217. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  218. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  219. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  220. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  221. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  222. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  223. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +199 -0
  224. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  225. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  226. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  227. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  228. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +273 -0
  229. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +380 -0
  230. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  231. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +152 -0
  232. package/android/src/test/java/com/audiobrowser/tls/CertFixtures.kt +18 -0
  233. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +154 -0
  234. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +33 -0
  235. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  236. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +63 -0
  237. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +53 -0
  238. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +53 -0
  239. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +57 -0
  240. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  241. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  242. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +108 -0
  243. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  244. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +36 -0
  245. package/android/src/test/java/com/audiobrowser/util/RatingFavoritesTest.kt +34 -0
  246. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +50 -0
  247. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +61 -0
  248. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +125 -0
  249. package/android/src/test/resources/certs/isrg-root-x1.pem +31 -0
  250. package/android/src/test/resources/certs/letsencrypt-r13.der +0 -0
  251. package/android/src/test/resources/certs/letsencrypt-r13.pem +29 -0
  252. package/android/src/test/resources/certs/stationplaylist-leaf.pem +34 -0
  253. package/android/src/test/resources/sonos/device_description.xml +78 -0
  254. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  255. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  256. package/ios/AVPlayerEngine.swift +385 -0
  257. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  258. package/ios/Browser/BrowseGate.swift +70 -0
  259. package/ios/Browser/BrowserConfig.swift +131 -82
  260. package/ios/Browser/BrowserError.swift +15 -0
  261. package/ios/Browser/BrowserManager.swift +165 -494
  262. package/ios/Browser/BrowserPathHelper.swift +62 -96
  263. package/ios/Browser/FavoriteSet.swift +43 -0
  264. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  265. package/ios/Browser/JsonModels.swift +276 -146
  266. package/ios/Browser/NavigationErrorState.swift +42 -0
  267. package/ios/Browser/PageResolver.swift +132 -0
  268. package/ios/Browser/RequestLayer.swift +185 -0
  269. package/ios/Browser/RequestPipeline.swift +295 -0
  270. package/ios/Browser/SearchDrillIn.swift +38 -0
  271. package/ios/Browser/SectionScope.swift +82 -0
  272. package/ios/Browser/SimpleRouter.swift +76 -154
  273. package/ios/Browser/StyleResolver.swift +41 -0
  274. package/ios/Browser/TabBarEntries.swift +16 -0
  275. package/ios/Browser/TrackIdTemplate.swift +29 -0
  276. package/ios/CarPlay/CPInterfaceController+Safe.swift +167 -0
  277. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  278. package/ios/CarPlay/CarPlayController.swift +47 -717
  279. package/ios/CarPlay/CarPlayImageLoader.swift +88 -126
  280. package/ios/CarPlay/CarPlayListItemFactory.swift +244 -99
  281. package/ios/CarPlay/CarPlayNowPlayingManager.swift +206 -133
  282. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  283. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  284. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  285. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  286. package/ios/CarPlay/CarPlaySession.swift +203 -0
  287. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  288. package/ios/CarPlay/IntentHandlers.swift +94 -0
  289. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  290. package/ios/CarPlay/MediaIntentHandler.swift +68 -0
  291. package/ios/CarPlay/MediaIntentPlayback.swift +86 -0
  292. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  293. package/ios/CarPlay/RNABAudioBrowser.h +15 -10
  294. package/ios/CarPlay/RNABAudioBrowser.m +8 -15
  295. package/ios/CarPlay/RNABCarPlaySceneDelegate.m +2 -0
  296. package/ios/CarPlay/SectionPresentation.swift +67 -0
  297. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  298. package/ios/Extension/Capability+RemoteCommand.swift +22 -71
  299. package/ios/Extension/ChapterMetadata+AVFoundation.swift +3 -6
  300. package/ios/Extension/CxxVectorConformances.swift +4 -16
  301. package/ios/Extension/NavigationError+Conversion.swift +22 -8
  302. package/ios/Extension/PlayerCapabilities+Favorite.swift +5 -0
  303. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  304. package/ios/Extension/RequestConfig+Copying.swift +27 -0
  305. package/ios/Extension/ResolvedTrack+Copying.swift +20 -22
  306. package/ios/Extension/SearchParams+Query.swift +28 -0
  307. package/ios/Extension/Section+Copying.swift +26 -0
  308. package/ios/Extension/String+IcyCharset.swift +21 -0
  309. package/ios/Extension/TimedMetadata+AVFoundation.swift +11 -15
  310. package/ios/Extension/Track+AVPlayer.swift +5 -22
  311. package/ios/Extension/Track+Copying.swift +18 -20
  312. package/ios/Extension/Track+Identity.swift +20 -0
  313. package/ios/Extension/TrackMetadata+AVFoundation.swift +11 -14
  314. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  315. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  316. package/ios/Extension/URLError+Connectivity.swift +15 -0
  317. package/ios/Extension/Variant+Artwork.swift +35 -0
  318. package/ios/Http/HttpClient.swift +73 -167
  319. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  320. package/ios/HybridAudioBrowser+Options.swift +116 -0
  321. package/ios/HybridAudioBrowser+Player.swift +351 -0
  322. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  323. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  324. package/ios/HybridAudioBrowser.swift +164 -1127
  325. package/ios/Model/NitroTypeStubs.swift +533 -224
  326. package/ios/Model/PlayerUpdateOptions.swift +32 -38
  327. package/ios/Model/RemoteCommand.swift +6 -60
  328. package/ios/Model/TrackPlayerError.swift +73 -18
  329. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +65 -141
  330. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +67 -0
  331. package/ios/Observer/ItemObserver.swift +99 -0
  332. package/ios/Observer/PlayerObserver.swift +59 -0
  333. package/ios/Option/SessionCategories.swift +51 -79
  334. package/ios/PlaybackEvent.swift +4 -2
  335. package/ios/Player/AirPlayStallJudgement.swift +23 -0
  336. package/ios/Player/AudioSessionController.swift +190 -0
  337. package/ios/Player/DeferredSeek.swift +73 -0
  338. package/ios/Player/ErrorStatus.swift +56 -0
  339. package/ios/Player/MediaLoader.swift +94 -93
  340. package/ios/Player/NowPlayingLines.swift +49 -0
  341. package/ios/Player/NowPlayingUpdater.swift +213 -45
  342. package/ios/Player/PersistedPlaybackState.swift +10 -0
  343. package/ios/Player/PlaybackFailure.swift +121 -0
  344. package/ios/Player/PlaybackPersistence.swift +72 -0
  345. package/ios/Player/PlaybackStateMachine.swift +25 -17
  346. package/ios/Player/PlaybackTimer.swift +64 -0
  347. package/ios/Player/Player.swift +1127 -0
  348. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +6 -5
  349. package/ios/Player/PlayerEngine.swift +118 -0
  350. package/ios/Player/PlayerStatusTypes.swift +1 -6
  351. package/ios/Player/QueueManager.swift +137 -138
  352. package/ios/Player/ReconnectPacer.swift +83 -0
  353. package/ios/Player/RetryLoop.swift +374 -0
  354. package/ios/Player/ShuffleOrder.swift +36 -43
  355. package/ios/Player/SilenceBudget.swift +78 -0
  356. package/ios/Player/SleepTimerManager.swift +101 -31
  357. package/ios/Player/VolumeFader.swift +91 -0
  358. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  359. package/ios/RemoteCommand/RemoteCommandController.swift +112 -331
  360. package/ios/Tests/AirPlayStallJudgementTests.swift +52 -0
  361. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  362. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  363. package/ios/Tests/BrowseGateTests.swift +50 -0
  364. package/ios/Tests/BrowserPathHelperTests.swift +99 -0
  365. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  366. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  367. package/ios/Tests/ChapterMetadataAVFoundationTests.swift +2 -2
  368. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  369. package/ios/Tests/ConnectivityTests.swift +13 -0
  370. package/ios/Tests/DeferredSeekTests.swift +76 -0
  371. package/ios/Tests/EmitterTests.swift +22 -39
  372. package/ios/Tests/ErrorStatusTests.swift +50 -0
  373. package/ios/Tests/FavoriteSetTests.swift +61 -0
  374. package/ios/Tests/GenerationMemoTests.swift +178 -0
  375. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  376. package/ios/Tests/JsonModelsTests.swift +244 -0
  377. package/ios/Tests/LRUCacheTests.swift +106 -0
  378. package/ios/Tests/MediaIntentCriteriaTests.swift +176 -0
  379. package/ios/Tests/MediaIntentDeadlineTests.swift +75 -0
  380. package/ios/Tests/MediaLoaderAssetOptionsTests.swift +46 -0
  381. package/ios/Tests/MediaLoaderTests.swift +67 -74
  382. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  383. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  384. package/ios/Tests/ObserverTests.swift +106 -0
  385. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  386. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  387. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  388. package/ios/Tests/PlaybackStateMachineTests.swift +37 -20
  389. package/ios/Tests/PlaybackTimerTests.swift +54 -0
  390. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  391. package/ios/Tests/PlayerPolicyTests.swift +1808 -0
  392. package/ios/Tests/PlayerTests.swift +1677 -0
  393. package/ios/Tests/PlayingStateTests.swift +41 -0
  394. package/ios/Tests/QueueManagerTests.swift +366 -164
  395. package/ios/Tests/ReadyValueTests.swift +73 -0
  396. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  397. package/ios/Tests/RequestLayerTests.swift +228 -0
  398. package/ios/Tests/ResolvedTrackCopyingTests.swift +52 -43
  399. package/ios/Tests/RetryCaseTests.swift +146 -0
  400. package/ios/Tests/RetryLoopTests.swift +486 -0
  401. package/ios/Tests/SearchDrillInTests.swift +62 -0
  402. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  403. package/ios/Tests/SectionPresentationTests.swift +85 -0
  404. package/ios/Tests/SectionScopeTests.swift +164 -0
  405. package/ios/Tests/SimpleRouterTests.swift +39 -8
  406. package/ios/Tests/SleepTimerManagerTests.swift +156 -0
  407. package/ios/Tests/StyleResolverTests.swift +123 -0
  408. package/ios/Tests/SupersedingTaskTests.swift +148 -0
  409. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +42 -0
  410. package/ios/Tests/Support/SilentAudioFile.swift +13 -0
  411. package/ios/Tests/Support/TestTypes.swift +286 -84
  412. package/ios/Tests/Support/TimeLimit.swift +43 -0
  413. package/ios/Tests/TabBarEntriesTests.swift +69 -0
  414. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  415. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  416. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  417. package/ios/Tests/TrackIdentityTests.swift +20 -0
  418. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  419. package/ios/Tests/TrackSelectorTests.swift +171 -48
  420. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  421. package/ios/TrackSelector.swift +70 -80
  422. package/ios/Util/ArtworkFreshness.swift +42 -0
  423. package/ios/Util/ArtworkImageFetcher.swift +147 -8
  424. package/ios/Util/AwaitCallback.swift +80 -0
  425. package/ios/Util/ConcurrentMap.swift +19 -0
  426. package/ios/Util/Connectivity.swift +12 -0
  427. package/ios/Util/Deadline.swift +38 -0
  428. package/ios/Util/Emitter.swift +45 -22
  429. package/ios/Util/GenerationMemo.swift +43 -0
  430. package/ios/Util/LRUCache.swift +23 -159
  431. package/ios/Util/NetworkMonitor.swift +33 -31
  432. package/ios/Util/OutputPicker.swift +48 -0
  433. package/ios/Util/ReadyValue.swift +57 -0
  434. package/ios/Util/SFSymbolRenderer.swift +64 -49
  435. package/ios/Util/SVGProcessor.swift +9 -16
  436. package/ios/Util/SupersedingTask.swift +45 -0
  437. package/lib/commonjs/AudioBrowser.js +8 -8
  438. package/lib/commonjs/AudioBrowser.js.map +1 -1
  439. package/lib/commonjs/CLAUDE.md +57 -0
  440. package/lib/commonjs/features/battery.js +16 -12
  441. package/lib/commonjs/features/battery.js.map +1 -1
  442. package/lib/commonjs/features/browser-config.js +231 -0
  443. package/lib/commonjs/features/browser-config.js.map +1 -0
  444. package/lib/commonjs/features/browser.js +128 -169
  445. package/lib/commonjs/features/browser.js.map +1 -1
  446. package/lib/commonjs/features/carConnection.js +41 -0
  447. package/lib/commonjs/features/carConnection.js.map +1 -0
  448. package/lib/commonjs/features/equalizer.js +10 -6
  449. package/lib/commonjs/features/equalizer.js.map +1 -1
  450. package/lib/commonjs/features/errors.js +59 -13
  451. package/lib/commonjs/features/errors.js.map +1 -1
  452. package/lib/commonjs/features/favorites.js +29 -24
  453. package/lib/commonjs/features/favorites.js.map +1 -1
  454. package/lib/commonjs/features/gate.js +170 -0
  455. package/lib/commonjs/features/gate.js.map +1 -0
  456. package/lib/commonjs/features/index.js +22 -0
  457. package/lib/commonjs/features/index.js.map +1 -1
  458. package/lib/commonjs/features/metadata.js +64 -14
  459. package/lib/commonjs/features/metadata.js.map +1 -1
  460. package/lib/commonjs/features/network.js +6 -2
  461. package/lib/commonjs/features/network.js.map +1 -1
  462. package/lib/commonjs/features/nowPlaying.js +55 -6
  463. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  464. package/lib/commonjs/features/output.js +42 -23
  465. package/lib/commonjs/features/output.js.map +1 -1
  466. package/lib/commonjs/features/playback/controls.js +20 -4
  467. package/lib/commonjs/features/playback/controls.js.map +1 -1
  468. package/lib/commonjs/features/playback/index.js +11 -0
  469. package/lib/commonjs/features/playback/index.js.map +1 -1
  470. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  471. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  472. package/lib/commonjs/features/playback/playing.js +5 -3
  473. package/lib/commonjs/features/playback/playing.js.map +1 -1
  474. package/lib/commonjs/features/playback/progress.js +40 -17
  475. package/lib/commonjs/features/playback/progress.js.map +1 -1
  476. package/lib/commonjs/features/playback/rate.js +8 -1
  477. package/lib/commonjs/features/playback/rate.js.map +1 -1
  478. package/lib/commonjs/features/playback/state.js +5 -6
  479. package/lib/commonjs/features/playback/state.js.map +1 -1
  480. package/lib/commonjs/features/playback/trackPlaybackTime.js +91 -0
  481. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -0
  482. package/lib/commonjs/features/playback/volume.js +6 -5
  483. package/lib/commonjs/features/playback/volume.js.map +1 -1
  484. package/lib/commonjs/features/player/options.js +99 -39
  485. package/lib/commonjs/features/player/options.js.map +1 -1
  486. package/lib/commonjs/features/player/setup.js +258 -4
  487. package/lib/commonjs/features/player/setup.js.map +1 -1
  488. package/lib/commonjs/features/player/validateOptions.js +23 -0
  489. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  490. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  491. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  492. package/lib/commonjs/features/queue/queue.js +77 -24
  493. package/lib/commonjs/features/queue/queue.js.map +1 -1
  494. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  495. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  496. package/lib/commonjs/features/queue/shuffle.js +1 -2
  497. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  498. package/lib/commonjs/features/remoteControls.js +71 -137
  499. package/lib/commonjs/features/remoteControls.js.map +1 -1
  500. package/lib/commonjs/features/sleepTimer.js +33 -11
  501. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  502. package/lib/commonjs/native.js +5 -0
  503. package/lib/commonjs/native.js.map +1 -1
  504. package/lib/commonjs/native.web.js +4 -1
  505. package/lib/commonjs/native.web.js.map +1 -1
  506. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  507. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  508. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -17
  509. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  510. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -19
  511. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  512. package/lib/commonjs/utils/artwork.js +31 -0
  513. package/lib/commonjs/utils/artwork.js.map +1 -0
  514. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  515. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  516. package/lib/commonjs/utils/useDebug.js +16 -3
  517. package/lib/commonjs/utils/useDebug.js.map +1 -1
  518. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  519. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  520. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  521. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  522. package/lib/commonjs/web/NativeAudioBrowser.js +482 -177
  523. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  524. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  525. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  526. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +87 -0
  527. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -0
  528. package/lib/commonjs/web/TrackPlayer/PlaybackTimer.js +34 -0
  529. package/lib/commonjs/web/TrackPlayer/PlaybackTimer.js.map +1 -0
  530. package/lib/commonjs/web/TrackPlayer/Player.js +321 -41
  531. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  532. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +21 -0
  533. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js.map +1 -0
  534. package/lib/commonjs/web/TrackPlayer/QueueManager.js +287 -0
  535. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -0
  536. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +178 -0
  537. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -0
  538. package/lib/commonjs/web/TrackPlayer/RepeatMode.js +1 -1
  539. package/lib/commonjs/web/TrackPlayer/RepeatMode.js.map +1 -1
  540. package/lib/commonjs/web/TrackPlayer/SleepTimer.js +34 -3
  541. package/lib/commonjs/web/TrackPlayer/SleepTimer.js.map +1 -1
  542. package/lib/commonjs/web/TrackPlayer/VolumeFader.js +75 -0
  543. package/lib/commonjs/web/TrackPlayer/VolumeFader.js.map +1 -0
  544. package/lib/commonjs/web/TrackPlayer/index.js +13 -5
  545. package/lib/commonjs/web/TrackPlayer/index.js.map +1 -1
  546. package/lib/commonjs/web/browser/BrowserManager.js +341 -140
  547. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  548. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  549. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  550. package/lib/commonjs/web/browser/NavigationErrorManager.js +6 -2
  551. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  552. package/lib/commonjs/web/browser/SearchManager.js +22 -25
  553. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  554. package/lib/commonjs/web/browser/assertBrowsePageShape.js +22 -0
  555. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -0
  556. package/lib/commonjs/web/browser/classifyTrackNavigation.js +41 -0
  557. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -0
  558. package/lib/commonjs/web/browser/parseSearchResponse.js +19 -0
  559. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -0
  560. package/lib/commonjs/web/browser/sections.js +89 -0
  561. package/lib/commonjs/web/browser/sections.js.map +1 -0
  562. package/lib/commonjs/web/http/HttpClient.js +4 -23
  563. package/lib/commonjs/web/http/HttpClient.js.map +1 -1
  564. package/lib/commonjs/web/http/RequestConfigBuilder.js +194 -62
  565. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  566. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  567. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  568. package/lib/commonjs/web/playbackErrorKind.js +57 -0
  569. package/lib/commonjs/web/playbackErrorKind.js.map +1 -0
  570. package/lib/commonjs/web/player/MediaSessionManager.js +121 -0
  571. package/lib/commonjs/web/player/MediaSessionManager.js.map +1 -0
  572. package/lib/commonjs/web/player/NowPlayingManager.js +10 -8
  573. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  574. package/lib/commonjs/web/player/OptionsManager.js +9 -17
  575. package/lib/commonjs/web/player/OptionsManager.js.map +1 -1
  576. package/lib/commonjs/web/player/RemoteCommandController.js +96 -0
  577. package/lib/commonjs/web/player/RemoteCommandController.js.map +1 -0
  578. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  579. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  580. package/lib/module/AudioBrowser.js +2 -1
  581. package/lib/module/AudioBrowser.js.map +1 -1
  582. package/lib/module/CLAUDE.md +57 -0
  583. package/lib/module/features/battery.js +16 -12
  584. package/lib/module/features/battery.js.map +1 -1
  585. package/lib/module/features/browser-config.js +225 -0
  586. package/lib/module/features/browser-config.js.map +1 -0
  587. package/lib/module/features/browser.js +123 -168
  588. package/lib/module/features/browser.js.map +1 -1
  589. package/lib/module/features/carConnection.js +36 -0
  590. package/lib/module/features/carConnection.js.map +1 -0
  591. package/lib/module/features/equalizer.js +10 -6
  592. package/lib/module/features/equalizer.js.map +1 -1
  593. package/lib/module/features/errors.js +59 -13
  594. package/lib/module/features/errors.js.map +1 -1
  595. package/lib/module/features/favorites.js +29 -24
  596. package/lib/module/features/favorites.js.map +1 -1
  597. package/lib/module/features/gate.js +165 -0
  598. package/lib/module/features/gate.js.map +1 -0
  599. package/lib/module/features/index.js +2 -0
  600. package/lib/module/features/index.js.map +1 -1
  601. package/lib/module/features/metadata.js +62 -14
  602. package/lib/module/features/metadata.js.map +1 -1
  603. package/lib/module/features/network.js +6 -2
  604. package/lib/module/features/network.js.map +1 -1
  605. package/lib/module/features/nowPlaying.js +53 -6
  606. package/lib/module/features/nowPlaying.js.map +1 -1
  607. package/lib/module/features/output.js +37 -19
  608. package/lib/module/features/output.js.map +1 -1
  609. package/lib/module/features/playback/controls.js +19 -4
  610. package/lib/module/features/playback/controls.js.map +1 -1
  611. package/lib/module/features/playback/index.js +1 -0
  612. package/lib/module/features/playback/index.js.map +1 -1
  613. package/lib/module/features/playback/playWhenReady.js +6 -5
  614. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  615. package/lib/module/features/playback/playing.js +5 -3
  616. package/lib/module/features/playback/playing.js.map +1 -1
  617. package/lib/module/features/playback/progress.js +40 -17
  618. package/lib/module/features/playback/progress.js.map +1 -1
  619. package/lib/module/features/playback/rate.js +8 -1
  620. package/lib/module/features/playback/rate.js.map +1 -1
  621. package/lib/module/features/playback/state.js +5 -6
  622. package/lib/module/features/playback/state.js.map +1 -1
  623. package/lib/module/features/playback/trackPlaybackTime.js +88 -0
  624. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -0
  625. package/lib/module/features/playback/volume.js +6 -5
  626. package/lib/module/features/playback/volume.js.map +1 -1
  627. package/lib/module/features/player/options.js +99 -39
  628. package/lib/module/features/player/options.js.map +1 -1
  629. package/lib/module/features/player/setup.js +258 -4
  630. package/lib/module/features/player/setup.js.map +1 -1
  631. package/lib/module/features/player/validateOptions.js +19 -0
  632. package/lib/module/features/player/validateOptions.js.map +1 -0
  633. package/lib/module/features/queue/activeTrack.js +15 -5
  634. package/lib/module/features/queue/activeTrack.js.map +1 -1
  635. package/lib/module/features/queue/queue.js +76 -24
  636. package/lib/module/features/queue/queue.js.map +1 -1
  637. package/lib/module/features/queue/repeatMode.js +3 -2
  638. package/lib/module/features/queue/repeatMode.js.map +1 -1
  639. package/lib/module/features/queue/shuffle.js +1 -2
  640. package/lib/module/features/queue/shuffle.js.map +1 -1
  641. package/lib/module/features/remoteControls.js +70 -136
  642. package/lib/module/features/remoteControls.js.map +1 -1
  643. package/lib/module/features/sleepTimer.js +34 -12
  644. package/lib/module/features/sleepTimer.js.map +1 -1
  645. package/lib/module/native.js +5 -0
  646. package/lib/module/native.js.map +1 -1
  647. package/lib/module/native.web.js +4 -1
  648. package/lib/module/native.web.js.map +1 -1
  649. package/lib/module/test-utils/reactNativeStub.js +58 -0
  650. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  651. package/lib/module/utils/LazyNativeEmitter.js +25 -17
  652. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  653. package/lib/module/utils/NativeUpdatedValue.js +32 -19
  654. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  655. package/lib/module/utils/artwork.js +26 -0
  656. package/lib/module/utils/artwork.js.map +1 -0
  657. package/lib/module/utils/getTrackIdentity.js +22 -0
  658. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  659. package/lib/module/utils/useDebug.js +16 -3
  660. package/lib/module/utils/useDebug.js.map +1 -1
  661. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  662. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  663. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  664. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  665. package/lib/module/web/NativeAudioBrowser.js +483 -178
  666. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  667. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  668. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  669. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +83 -0
  670. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -0
  671. package/lib/module/web/TrackPlayer/PlaybackTimer.js +29 -0
  672. package/lib/module/web/TrackPlayer/PlaybackTimer.js.map +1 -0
  673. package/lib/module/web/TrackPlayer/Player.js +321 -41
  674. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  675. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +17 -0
  676. package/lib/module/web/TrackPlayer/PlayingStateFactory.js.map +1 -0
  677. package/lib/module/web/TrackPlayer/QueueManager.js +283 -0
  678. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -0
  679. package/lib/module/web/TrackPlayer/QueuePlayer.js +174 -0
  680. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -0
  681. package/lib/module/web/TrackPlayer/RepeatMode.js +1 -1
  682. package/lib/module/web/TrackPlayer/RepeatMode.js.map +1 -1
  683. package/lib/module/web/TrackPlayer/SleepTimer.js +34 -3
  684. package/lib/module/web/TrackPlayer/SleepTimer.js.map +1 -1
  685. package/lib/module/web/TrackPlayer/VolumeFader.js +70 -0
  686. package/lib/module/web/TrackPlayer/VolumeFader.js.map +1 -0
  687. package/lib/module/web/TrackPlayer/index.js +2 -1
  688. package/lib/module/web/TrackPlayer/index.js.map +1 -1
  689. package/lib/module/web/browser/BrowserManager.js +341 -140
  690. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  691. package/lib/module/web/browser/FavoriteManager.js +31 -21
  692. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  693. package/lib/module/web/browser/NavigationErrorManager.js +6 -2
  694. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  695. package/lib/module/web/browser/SearchManager.js +22 -25
  696. package/lib/module/web/browser/SearchManager.js.map +1 -1
  697. package/lib/module/web/browser/assertBrowsePageShape.js +18 -0
  698. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -0
  699. package/lib/module/web/browser/classifyTrackNavigation.js +38 -0
  700. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -0
  701. package/lib/module/web/browser/parseSearchResponse.js +15 -0
  702. package/lib/module/web/browser/parseSearchResponse.js.map +1 -0
  703. package/lib/module/web/browser/sections.js +83 -0
  704. package/lib/module/web/browser/sections.js.map +1 -0
  705. package/lib/module/web/http/HttpClient.js +4 -23
  706. package/lib/module/web/http/HttpClient.js.map +1 -1
  707. package/lib/module/web/http/RequestConfigBuilder.js +194 -62
  708. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  709. package/lib/module/web/http/followMediaRedirect.js +215 -0
  710. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  711. package/lib/module/web/playbackErrorKind.js +52 -0
  712. package/lib/module/web/playbackErrorKind.js.map +1 -0
  713. package/lib/module/web/player/MediaSessionManager.js +116 -0
  714. package/lib/module/web/player/MediaSessionManager.js.map +1 -0
  715. package/lib/module/web/player/NowPlayingManager.js +11 -8
  716. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  717. package/lib/module/web/player/OptionsManager.js +9 -17
  718. package/lib/module/web/player/OptionsManager.js.map +1 -1
  719. package/lib/module/web/player/RemoteCommandController.js +92 -0
  720. package/lib/module/web/player/RemoteCommandController.js.map +1 -0
  721. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  722. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  723. package/lib/typescript/package.json +1 -0
  724. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  725. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  726. package/lib/typescript/src/features/battery.d.ts +17 -12
  727. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  728. package/lib/typescript/src/features/browser-config.d.ts +12 -0
  729. package/lib/typescript/src/features/browser-config.d.ts.map +1 -0
  730. package/lib/typescript/src/features/browser.d.ts +99 -12
  731. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  732. package/lib/typescript/src/features/carConnection.d.ts +19 -0
  733. package/lib/typescript/src/features/carConnection.d.ts.map +1 -0
  734. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  735. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  736. package/lib/typescript/src/features/errors.d.ts +84 -14
  737. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  738. package/lib/typescript/src/features/favorites.d.ts +29 -24
  739. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  740. package/lib/typescript/src/features/gate.d.ts +99 -0
  741. package/lib/typescript/src/features/gate.d.ts.map +1 -0
  742. package/lib/typescript/src/features/index.d.ts +2 -0
  743. package/lib/typescript/src/features/index.d.ts.map +1 -1
  744. package/lib/typescript/src/features/metadata.d.ts +74 -21
  745. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  746. package/lib/typescript/src/features/network.d.ts +6 -2
  747. package/lib/typescript/src/features/network.d.ts.map +1 -1
  748. package/lib/typescript/src/features/nowPlaying.d.ts +47 -6
  749. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  750. package/lib/typescript/src/features/output.d.ts +33 -18
  751. package/lib/typescript/src/features/output.d.ts.map +1 -1
  752. package/lib/typescript/src/features/playback/controls.d.ts +16 -4
  753. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  754. package/lib/typescript/src/features/playback/index.d.ts +1 -0
  755. package/lib/typescript/src/features/playback/index.d.ts.map +1 -1
  756. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  757. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  758. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  759. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  760. package/lib/typescript/src/features/playback/progress.d.ts +14 -5
  761. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  762. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  763. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  764. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  765. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  766. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +41 -0
  767. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -0
  768. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  769. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  770. package/lib/typescript/src/features/player/options.d.ts +211 -145
  771. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  772. package/lib/typescript/src/features/player/setup.d.ts +288 -186
  773. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  774. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  775. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  776. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  777. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  778. package/lib/typescript/src/features/queue/queue.d.ts +65 -20
  779. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  780. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  781. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  782. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  783. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  784. package/lib/typescript/src/features/remoteControls.d.ts +81 -60
  785. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  786. package/lib/typescript/src/features/sleepTimer.d.ts +34 -11
  787. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  788. package/lib/typescript/src/index.d.ts.map +1 -1
  789. package/lib/typescript/src/native.d.ts +1 -2
  790. package/lib/typescript/src/native.d.ts.map +1 -1
  791. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +16 -225
  792. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  793. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  794. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  795. package/lib/typescript/src/types/browser-native.d.ts +10 -3
  796. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  797. package/lib/typescript/src/types/browser-nodes.d.ts +474 -84
  798. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  799. package/lib/typescript/src/types/browser.d.ts +518 -179
  800. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  801. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -18
  802. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  803. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -22
  804. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  805. package/lib/typescript/src/utils/artwork.d.ts +19 -0
  806. package/lib/typescript/src/utils/artwork.d.ts.map +1 -0
  807. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  808. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  809. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  810. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  811. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  812. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  813. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  814. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  815. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  816. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  817. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +3 -2
  818. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +28 -12
  819. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +8 -8
  820. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +12 -22
  822. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  825. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +43 -6
  826. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +61 -0
  827. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  830. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JBrowseResult.hpp +24 -7
  832. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  833. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +5 -5
  834. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  835. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  837. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  838. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  839. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +16 -5
  840. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  841. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +105 -0
  842. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +5 -4
  843. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +112 -0
  844. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +121 -0
  845. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +128 -0
  846. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  847. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +138 -0
  848. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +126 -0
  849. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +139 -0
  850. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  851. 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
  852. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +16 -5
  853. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +134 -0
  854. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +26 -12
  855. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +16 -4
  856. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  857. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +143 -0
  858. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  859. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  860. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  861. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  862. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +16 -5
  863. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +79 -0
  864. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  865. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -12
  866. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +13 -11
  867. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +80 -0
  868. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +4 -2
  869. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +16 -5
  870. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +4 -2
  871. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  872. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  873. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  874. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  875. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  876. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  877. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  878. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  879. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  880. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  881. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  882. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  883. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  884. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +12 -12
  885. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  886. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  887. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +23 -5
  888. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  889. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  890. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  891. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +30 -18
  892. package/nitrogen/generated/android/c++/JGate.hpp +62 -0
  893. package/nitrogen/generated/android/c++/JGateDecision.hpp +64 -0
  894. package/nitrogen/generated/android/c++/JGateEvent.hpp +58 -0
  895. package/nitrogen/generated/android/c++/JGateReason.hpp +58 -0
  896. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  897. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  898. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +317 -255
  899. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +30 -25
  900. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  901. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  902. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  903. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  904. package/nitrogen/generated/android/c++/JIOSOptions.hpp +101 -0
  905. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  906. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  907. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  908. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  909. package/nitrogen/generated/android/c++/JMediaReference.hpp +58 -0
  910. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +43 -6
  911. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  912. package/nitrogen/generated/android/c++/{JPartialAndroidSetupPlayerOptions.hpp → JNativeAndroidSetupOptions.hpp} +10 -10
  913. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +100 -40
  914. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +74 -0
  915. package/nitrogen/generated/android/c++/{JPartialIOSSetupPlayerOptions.hpp → JNativeIOSSetupOptions.hpp} +18 -18
  916. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +36 -13
  917. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +191 -0
  918. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +20 -26
  919. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  920. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  921. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  922. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +8 -2
  923. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +12 -22
  924. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +102 -0
  925. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +5 -19
  926. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +9 -5
  927. package/nitrogen/generated/android/c++/JOptions.hpp +18 -16
  928. package/nitrogen/generated/android/c++/{JIosOutput.hpp → JOutput.hpp} +15 -15
  929. package/nitrogen/generated/android/c++/JOutputType.hpp +88 -0
  930. package/nitrogen/generated/android/c++/JPlayback.hpp +4 -2
  931. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +16 -5
  932. package/nitrogen/generated/android/c++/JPlaybackError.hpp +20 -5
  933. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +4 -2
  934. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +76 -0
  935. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  936. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  937. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  938. package/nitrogen/generated/android/c++/JPlaybackState.hpp +5 -5
  939. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +2 -2
  940. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  941. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  942. package/nitrogen/generated/android/c++/{JNotificationButton.hpp → JRemoteButton.hpp} +20 -20
  943. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +86 -0
  944. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  945. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  946. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  947. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  948. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  949. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  950. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  951. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  952. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  953. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  954. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +85 -59
  955. package/nitrogen/generated/android/c++/JRetryConfig.hpp +13 -9
  956. package/nitrogen/generated/android/c++/JSearchMode.hpp +29 -11
  957. package/nitrogen/generated/android/c++/JSearchParams.hpp +11 -5
  958. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  959. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  960. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  961. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  962. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  963. package/nitrogen/generated/android/c++/JStallReason.hpp +58 -0
  964. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  965. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  966. package/nitrogen/generated/android/c++/JTrack.hpp +45 -48
  967. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +31 -15
  968. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  969. package/nitrogen/generated/android/c++/JTrackRequest.hpp +93 -0
  970. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  971. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +16 -3
  972. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  973. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  974. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  975. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp +26 -0
  976. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +75 -0
  977. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.cpp +41 -0
  978. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +133 -0
  979. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.cpp +26 -0
  980. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +70 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioContentType.kt +4 -4
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +20 -9
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{RatingType.kt → ArtworkRendering.kt} +5 -10
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +47 -4
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +56 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayNowPlayingButton.kt +3 -3
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{NotificationButton.kt → CarPlayPlayingIndicatorLocation.kt} +5 -8
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +71 -0
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +17 -2
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +78 -0
  1002. 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 +78 -0
  1003. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +78 -0
  1004. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  1005. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +78 -0
  1006. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +78 -0
  1007. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +78 -0
  1008. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  1009. 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
  1010. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  1011. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +78 -0
  1012. 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
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.kt → Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt} +12 -14
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  1018. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  1019. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  1020. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  1021. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_void_RemoteSetRatingEvent.kt → Func_void_GateEvent.kt} +9 -11
  1022. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  1023. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  1024. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  1025. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_void_IosOutput.kt → Func_void_Output.kt} +9 -11
  1026. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  1027. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  1028. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  1029. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  1030. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  1031. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  1032. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  1033. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  1034. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  1035. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  1036. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  1037. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  1038. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  1039. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  1040. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  1041. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  1042. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +9 -11
  1043. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  1044. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  1045. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  1046. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  1047. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  1048. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  1049. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  1050. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +56 -0
  1051. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +56 -0
  1052. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +51 -0
  1053. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateReason.kt +23 -0
  1054. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  1055. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +114 -110
  1056. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +66 -0
  1057. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  1058. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  1059. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  1060. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  1061. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaReference.kt +23 -0
  1062. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +45 -4
  1063. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  1064. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{PartialAndroidSetupPlayerOptions.kt → NativeAndroidSetupOptions.kt} +36 -5
  1065. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +64 -6
  1066. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +61 -0
  1067. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +71 -0
  1068. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +31 -4
  1069. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +100 -0
  1070. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +29 -6
  1071. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  1072. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  1073. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  1074. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorType.kt +3 -1
  1075. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +20 -9
  1076. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +66 -0
  1077. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +32 -6
  1078. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +23 -3
  1079. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +26 -3
  1080. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +61 -0
  1081. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +33 -0
  1082. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  1083. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  1084. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +33 -3
  1085. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  1086. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorKind.kt +29 -0
  1087. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  1088. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  1089. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  1090. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackState.kt +6 -6
  1091. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +35 -0
  1092. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  1093. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  1094. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButton.kt +26 -0
  1095. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +61 -0
  1096. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  1097. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  1098. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  1099. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  1100. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  1101. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  1102. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  1103. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  1104. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  1105. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +74 -13
  1106. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +24 -4
  1107. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchMode.kt +12 -6
  1108. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +33 -3
  1109. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  1110. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  1111. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  1112. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  1113. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  1114. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StallReason.kt +23 -0
  1115. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  1116. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  1117. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +62 -10
  1118. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +25 -3
  1119. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  1120. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +61 -0
  1121. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  1122. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +38 -4
  1123. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  1124. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  1125. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  1126. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Variant_NullType_NotificationButtonLayout.kt → Variant_NullType_RemoteButtonLayout.kt} +24 -15
  1127. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +75 -0
  1128. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +62 -0
  1129. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1130. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +162 -42
  1131. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +1476 -684
  1132. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +91 -49
  1133. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +219 -124
  1134. package/nitrogen/generated/ios/swift/AndroidAudioContentType.swift +8 -8
  1135. package/nitrogen/generated/ios/swift/AndroidOptions.swift +12 -22
  1136. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1137. package/nitrogen/generated/ios/swift/ArtworkRequestConfig.swift +95 -1
  1138. package/nitrogen/generated/ios/swift/ArtworkVariants.swift +34 -0
  1139. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1140. package/nitrogen/generated/ios/swift/CarPlayNowPlayingButton.swift +4 -4
  1141. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1142. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1143. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1144. package/nitrogen/generated/ios/swift/FormatNowPlayingParams.swift +67 -0
  1145. package/nitrogen/generated/ios/swift/FormattedNavigationError.swift +17 -4
  1146. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.swift +54 -0
  1147. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.swift +69 -0
  1148. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___Track.swift +54 -0
  1149. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.swift +60 -0
  1150. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__optional_std__string____Track.swift +60 -0
  1151. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.swift +61 -0
  1152. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.swift +61 -0
  1153. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1154. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.swift +77 -0
  1155. package/nitrogen/generated/ios/swift/Func_void_GateDecision.swift +46 -0
  1156. package/nitrogen/generated/ios/swift/{Func_void_RemoteSetRatingEvent.swift → Func_void_GateEvent.swift} +10 -10
  1157. package/nitrogen/generated/ios/swift/{Func_void_IosOutput.swift → Func_void_Output.swift} +10 -10
  1158. package/nitrogen/generated/ios/swift/Func_void_TransformableRequestConfig.swift +46 -0
  1159. package/nitrogen/generated/ios/swift/Func_void_bool.swift +5 -5
  1160. package/nitrogen/generated/ios/swift/Func_void_std__optional_NowPlayingUpdate_.swift +46 -0
  1161. package/nitrogen/generated/ios/swift/Func_void_std__optional_std__string_.swift +53 -0
  1162. package/nitrogen/generated/ios/swift/{Func_void_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError___.swift → Func_void_std__shared_ptr_Promise_GateDecision__.swift} +17 -17
  1163. package/nitrogen/generated/ios/swift/Func_void_std__shared_ptr_Promise_TransformableRequestConfig__.swift +66 -0
  1164. package/nitrogen/generated/ios/swift/Func_void_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError____.swift +81 -0
  1165. package/nitrogen/generated/ios/swift/Gate.swift +47 -0
  1166. package/nitrogen/generated/ios/swift/GateDecision.swift +40 -0
  1167. package/nitrogen/generated/ios/swift/GateEvent.swift +29 -0
  1168. package/nitrogen/generated/ios/swift/GateReason.swift +40 -0
  1169. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1170. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +23 -15
  1171. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +262 -199
  1172. package/nitrogen/generated/ios/swift/IOSOptions.swift +56 -0
  1173. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1174. package/nitrogen/generated/ios/swift/MediaReference.swift +40 -0
  1175. package/nitrogen/generated/ios/swift/MediaRequestConfig.swift +107 -1
  1176. package/nitrogen/generated/ios/swift/{PartialAndroidSetupPlayerOptions.swift → NativeAndroidSetupOptions.swift} +5 -5
  1177. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +208 -22
  1178. package/nitrogen/generated/ios/swift/NativeGateRequest.swift +58 -0
  1179. package/nitrogen/generated/ios/swift/{PartialIOSSetupPlayerOptions.swift → NativeIOSSetupOptions.swift} +5 -5
  1180. package/nitrogen/generated/ios/swift/NativeRouteEntry.swift +19 -19
  1181. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +217 -0
  1182. package/nitrogen/generated/ios/swift/NativeUpdateOptions.swift +12 -25
  1183. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1184. package/nitrogen/generated/ios/swift/NavigationErrorType.swift +8 -0
  1185. package/nitrogen/generated/ios/swift/NitroAndroidUpdateOptions.swift +12 -41
  1186. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +101 -0
  1187. package/nitrogen/generated/ios/swift/NowPlayingMetadata.swift +1 -48
  1188. package/nitrogen/generated/ios/swift/NowPlayingUpdate.swift +19 -1
  1189. package/nitrogen/generated/ios/swift/Options.swift +10 -4
  1190. package/nitrogen/generated/ios/swift/{IosOutput.swift → Output.swift} +7 -7
  1191. package/nitrogen/generated/ios/swift/OutputType.swift +80 -0
  1192. package/nitrogen/generated/ios/swift/PlaybackError.swift +43 -2
  1193. package/nitrogen/generated/ios/swift/PlaybackErrorKind.swift +64 -0
  1194. package/nitrogen/generated/ios/swift/PlaybackState.swift +4 -4
  1195. package/nitrogen/generated/ios/swift/{NotificationButton.swift → RemoteButton.swift} +10 -10
  1196. package/nitrogen/generated/ios/swift/RemoteButtonLayout.swift +57 -0
  1197. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1198. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +125 -70
  1199. package/nitrogen/generated/ios/swift/RetryConfig.swift +35 -4
  1200. package/nitrogen/generated/ios/swift/SearchMode.swift +36 -12
  1201. package/nitrogen/generated/ios/swift/SearchParams.swift +7 -2
  1202. package/nitrogen/generated/ios/swift/{ImageRowItem.swift → Section.swift} +33 -27
  1203. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1204. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1205. package/nitrogen/generated/ios/swift/StallReason.swift +40 -0
  1206. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1207. package/nitrogen/generated/ios/swift/Track.swift +91 -60
  1208. package/nitrogen/generated/ios/swift/TrackLoadEvent.swift +20 -2
  1209. package/nitrogen/generated/ios/swift/TrackRequest.swift +106 -0
  1210. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1211. package/nitrogen/generated/ios/swift/TransformableRequestConfig.swift +60 -1
  1212. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1213. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1214. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1215. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +30 -0
  1216. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +32 -0
  1217. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +30 -0
  1218. package/nitrogen/generated/shared/c++/AndroidAudioContentType.hpp +10 -10
  1219. package/nitrogen/generated/shared/c++/AndroidOptions.hpp +8 -19
  1220. package/nitrogen/generated/shared/c++/ArtworkRendering.hpp +76 -0
  1221. package/nitrogen/generated/shared/c++/ArtworkRequestConfig.hpp +10 -2
  1222. package/nitrogen/generated/shared/c++/{HeartRating.hpp → ArtworkVariants.hpp} +20 -16
  1223. package/nitrogen/generated/shared/c++/CarPlayNowPlayingButton.hpp +6 -6
  1224. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1225. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1226. package/nitrogen/generated/shared/c++/EqualizerSettings.hpp +0 -2
  1227. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1228. package/nitrogen/generated/shared/c++/FormatNowPlayingParams.hpp +110 -0
  1229. package/nitrogen/generated/shared/c++/FormattedNavigationError.hpp +6 -5
  1230. package/nitrogen/generated/shared/c++/{StarRating.hpp → Gate.hpp} +21 -16
  1231. package/nitrogen/generated/shared/c++/{ThumbsRating.hpp → GateDecision.hpp} +23 -17
  1232. package/nitrogen/generated/shared/c++/{PercentageRating.hpp → GateEvent.hpp} +18 -17
  1233. package/nitrogen/generated/shared/c++/GateReason.hpp +76 -0
  1234. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1235. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +24 -19
  1236. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +47 -36
  1237. package/nitrogen/generated/shared/c++/IOSOptions.hpp +98 -0
  1238. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1239. package/nitrogen/generated/shared/c++/MediaReference.hpp +76 -0
  1240. package/nitrogen/generated/shared/c++/MediaRequestConfig.hpp +10 -2
  1241. package/nitrogen/generated/shared/c++/{PartialAndroidSetupPlayerOptions.hpp → NativeAndroidSetupOptions.hpp} +11 -11
  1242. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +35 -15
  1243. package/nitrogen/generated/shared/c++/NativeGateRequest.hpp +97 -0
  1244. package/nitrogen/generated/shared/c++/{PartialIOSSetupPlayerOptions.hpp → NativeIOSSetupOptions.hpp} +11 -11
  1245. package/nitrogen/generated/shared/c++/NativeRouteEntry.hpp +5 -5
  1246. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +145 -0
  1247. package/nitrogen/generated/shared/c++/NativeUpdateOptions.hpp +9 -7
  1248. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1249. package/nitrogen/generated/shared/c++/NavigationErrorType.hpp +8 -0
  1250. package/nitrogen/generated/shared/c++/NitroAndroidUpdateOptions.hpp +8 -19
  1251. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +99 -0
  1252. package/nitrogen/generated/shared/c++/NowPlayingMetadata.hpp +3 -19
  1253. package/nitrogen/generated/shared/c++/NowPlayingUpdate.hpp +6 -2
  1254. package/nitrogen/generated/shared/c++/Options.hpp +8 -8
  1255. package/nitrogen/generated/shared/c++/{IosOutput.hpp → Output.hpp} +18 -18
  1256. package/nitrogen/generated/shared/c++/OutputType.hpp +116 -0
  1257. package/nitrogen/generated/shared/c++/PlaybackError.hpp +18 -3
  1258. package/nitrogen/generated/shared/c++/PlaybackErrorKind.hpp +100 -0
  1259. package/nitrogen/generated/shared/c++/PlaybackState.hpp +9 -9
  1260. package/nitrogen/generated/shared/c++/{NotificationButton.hpp → RemoteButton.hpp} +25 -25
  1261. package/nitrogen/generated/shared/c++/RemoteButtonLayout.hpp +94 -0
  1262. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1263. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +52 -37
  1264. package/nitrogen/generated/shared/c++/RetryConfig.hpp +10 -6
  1265. package/nitrogen/generated/shared/c++/SearchMode.hpp +39 -15
  1266. package/nitrogen/generated/shared/c++/SearchParams.hpp +9 -2
  1267. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1268. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1269. package/nitrogen/generated/shared/c++/StallReason.hpp +76 -0
  1270. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1271. package/nitrogen/generated/shared/c++/Track.hpp +37 -30
  1272. package/nitrogen/generated/shared/c++/TrackLoadEvent.hpp +7 -2
  1273. package/nitrogen/generated/shared/c++/TrackRequest.hpp +93 -0
  1274. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1275. package/nitrogen/generated/shared/c++/TransformableRequestConfig.hpp +6 -2
  1276. package/package.json +50 -20
  1277. package/src/AudioBrowser.ts +2 -1
  1278. package/src/CLAUDE.md +57 -0
  1279. package/src/codegen-no-config-variant.test.ts +70 -0
  1280. package/src/docs-floors.test.ts +71 -0
  1281. package/src/features/battery.test.ts +79 -0
  1282. package/src/features/battery.ts +17 -13
  1283. package/src/features/browser-config.test.ts +125 -0
  1284. package/src/features/browser-config.ts +297 -0
  1285. package/src/features/browser.test.ts +19 -0
  1286. package/src/features/browser.ts +119 -213
  1287. package/src/features/carConnection.ts +35 -0
  1288. package/src/features/equalizer.ts +10 -6
  1289. package/src/features/errors.ts +94 -13
  1290. package/src/features/favorites.ts +29 -24
  1291. package/src/features/gate.test.ts +72 -0
  1292. package/src/features/gate.ts +176 -0
  1293. package/src/features/hook-wiring.test.ts +302 -0
  1294. package/src/features/index.ts +2 -0
  1295. package/src/features/metadata.ts +89 -29
  1296. package/src/features/network.ts +6 -2
  1297. package/src/features/nowPlaying.ts +56 -6
  1298. package/src/features/output.ts +40 -22
  1299. package/src/features/playback/controls.ts +19 -4
  1300. package/src/features/playback/index.ts +1 -0
  1301. package/src/features/playback/playWhenReady.ts +6 -5
  1302. package/src/features/playback/playing.ts +16 -3
  1303. package/src/features/playback/progress.test.ts +169 -0
  1304. package/src/features/playback/progress.ts +43 -17
  1305. package/src/features/playback/rate.ts +8 -1
  1306. package/src/features/playback/state.ts +10 -6
  1307. package/src/features/playback/trackPlaybackTime.test.ts +76 -0
  1308. package/src/features/playback/trackPlaybackTime.ts +108 -0
  1309. package/src/features/playback/volume.ts +6 -5
  1310. package/src/features/player/options.test.ts +38 -0
  1311. package/src/features/player/options.ts +254 -128
  1312. package/src/features/player/setup.test.ts +134 -0
  1313. package/src/features/player/setup.ts +481 -194
  1314. package/src/features/player/validateOptions.ts +21 -0
  1315. package/src/features/queue/activeTrack.ts +15 -5
  1316. package/src/features/queue/queue.test.ts +36 -0
  1317. package/src/features/queue/queue.ts +80 -24
  1318. package/src/features/queue/repeatMode.ts +2 -2
  1319. package/src/features/queue/shuffle.ts +1 -2
  1320. package/src/features/remoteControls.ts +70 -148
  1321. package/src/features/sleepTimer.test.ts +171 -0
  1322. package/src/features/sleepTimer.ts +48 -13
  1323. package/src/native.ts +5 -0
  1324. package/src/native.web.ts +4 -1
  1325. package/src/nitro-stub-drift.test.ts +277 -0
  1326. package/src/public-surface.test.ts +147 -0
  1327. package/src/specs/audio-browser.nitro.ts +146 -42
  1328. package/src/style-resolution.test.ts +210 -0
  1329. package/src/test-utils/reactNativeStub.ts +60 -0
  1330. package/src/types/browser-native.ts +24 -7
  1331. package/src/types/browser-nodes.ts +505 -92
  1332. package/src/types/browser.ts +548 -183
  1333. package/src/utils/LazyNativeEmitter.ts +25 -17
  1334. package/src/utils/NativeUpdatedValue.ts +30 -18
  1335. package/src/utils/artwork.ts +30 -0
  1336. package/src/utils/getTrackIdentity.ts +22 -0
  1337. package/src/utils/useDebug.test.ts +182 -0
  1338. package/src/utils/useDebug.ts +16 -3
  1339. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1340. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1341. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1342. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1343. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +564 -0
  1344. package/src/web/NativeAudioBrowser.ts +588 -219
  1345. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1346. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +186 -0
  1347. package/src/web/TrackPlayer/PlaybackStateMachine.ts +98 -0
  1348. package/src/web/TrackPlayer/PlaybackTimer.test.ts +67 -0
  1349. package/src/web/TrackPlayer/PlaybackTimer.ts +33 -0
  1350. package/src/web/TrackPlayer/Player.dispatch.test.ts +274 -0
  1351. package/src/web/TrackPlayer/Player.load.test.ts +222 -0
  1352. package/src/web/TrackPlayer/Player.ts +377 -55
  1353. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +51 -0
  1354. package/src/web/TrackPlayer/PlayingStateFactory.ts +24 -0
  1355. package/src/web/TrackPlayer/QueueManager.test.ts +318 -0
  1356. package/src/web/TrackPlayer/QueueManager.ts +316 -0
  1357. package/src/web/TrackPlayer/QueuePlayer.ts +206 -0
  1358. package/src/web/TrackPlayer/RepeatMode.ts +1 -1
  1359. package/src/web/TrackPlayer/SleepTimer.ts +38 -3
  1360. package/src/web/TrackPlayer/VolumeFader.ts +74 -0
  1361. package/src/web/TrackPlayer/index.ts +2 -1
  1362. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1363. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1364. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1365. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1366. package/src/web/__tests__/retry.test.ts +169 -0
  1367. package/src/web/browser/BrowserManager.ts +421 -154
  1368. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1369. package/src/web/browser/FavoriteManager.ts +28 -23
  1370. package/src/web/browser/NavigationErrorManager.ts +6 -2
  1371. package/src/web/browser/SearchManager.test.ts +75 -0
  1372. package/src/web/browser/SearchManager.ts +26 -33
  1373. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1374. package/src/web/browser/__tests__/layer-resolver.test.ts +104 -0
  1375. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1376. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1377. package/src/web/browser/assertBrowsePageShape.test.ts +27 -0
  1378. package/src/web/browser/assertBrowsePageShape.ts +29 -0
  1379. package/src/web/browser/classifyTrackNavigation.test.ts +43 -0
  1380. package/src/web/browser/classifyTrackNavigation.ts +35 -0
  1381. package/src/web/browser/parseSearchResponse.test.ts +31 -0
  1382. package/src/web/browser/parseSearchResponse.ts +14 -0
  1383. package/src/web/browser/sections.test.ts +91 -0
  1384. package/src/web/browser/sections.ts +72 -0
  1385. package/src/web/http/HttpClient.ts +5 -35
  1386. package/src/web/http/RequestConfigBuilder.test.ts +299 -0
  1387. package/src/web/http/RequestConfigBuilder.ts +230 -66
  1388. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1389. package/src/web/http/followMediaRedirect.ts +253 -0
  1390. package/src/web/playbackErrorKind.test.ts +55 -0
  1391. package/src/web/playbackErrorKind.ts +56 -0
  1392. package/src/web/player/MediaSessionManager.test.ts +220 -0
  1393. package/src/web/player/MediaSessionManager.ts +151 -0
  1394. package/src/web/player/NowPlayingManager.test.ts +46 -0
  1395. package/src/web/player/NowPlayingManager.ts +10 -8
  1396. package/src/web/player/OptionsManager.ts +12 -18
  1397. package/src/web/player/RemoteCommandController.test.ts +171 -0
  1398. package/src/web/player/RemoteCommandController.ts +166 -0
  1399. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1400. package/src/web/util/BrowserPathHelper.ts +68 -13
  1401. package/website/guide/android-auto.md +126 -0
  1402. package/website/guide/android-certificates.md +488 -0
  1403. package/website/guide/artwork.md +300 -0
  1404. package/website/guide/audio-output.md +382 -0
  1405. package/website/guide/automotive.md +91 -0
  1406. package/website/guide/basic-usage.md +154 -0
  1407. package/website/guide/battery.md +142 -0
  1408. package/website/guide/browser.md +674 -0
  1409. package/website/guide/carplay.md +733 -0
  1410. package/website/guide/configuration.md +215 -0
  1411. package/website/guide/equalizer.md +235 -0
  1412. package/website/guide/errors.md +359 -0
  1413. package/website/guide/favorites.md +164 -0
  1414. package/website/guide/gate.md +157 -0
  1415. package/website/guide/getting-started.md +99 -0
  1416. package/website/guide/hooks.md +247 -0
  1417. package/website/guide/live-streams.md +218 -0
  1418. package/website/guide/metadata.md +289 -0
  1419. package/website/guide/migrating-from-track-player.md +289 -0
  1420. package/website/guide/native-callback-fetch.md +137 -0
  1421. package/website/guide/network.md +103 -0
  1422. package/website/guide/now-playing.md +203 -0
  1423. package/website/guide/playback.md +405 -0
  1424. package/website/guide/queue.md +334 -0
  1425. package/website/guide/remote-controls.md +314 -0
  1426. package/website/guide/search.md +270 -0
  1427. package/website/guide/sleep-timer.md +289 -0
  1428. package/website/guide/track.md +271 -0
  1429. package/android/src/main/java/com/audiobrowser/player/PlaybackProgressUpdateManager.kt +0 -59
  1430. package/android/src/main/java/com/audiobrowser/util/RatingFactory.kt +0 -72
  1431. package/android/src/main/java/com/audiobrowser/util/ResolvedTrackFactory.kt +0 -36
  1432. package/android/src/test/java/com/audiobrowser/player/PlaybackProgressUpdateManagerTest.kt +0 -146
  1433. package/ios/Bridge.h +0 -8
  1434. package/ios/Browser/BrowserManager+URLResolution.swift +0 -260
  1435. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -60
  1436. package/ios/CarPlay/Track+CarPlay.swift +0 -63
  1437. package/ios/Model/MediaURL.swift +0 -67
  1438. package/ios/Model/SourceType.swift +0 -6
  1439. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1440. package/ios/NowPlayingInfo/NowPlayingInfoCenter.swift +0 -9
  1441. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1442. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1443. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -79
  1444. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -110
  1445. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1446. package/ios/Observer/PlayerTimeObserver.swift +0 -105
  1447. package/ios/Option/PitchAlgorithms.swift +0 -17
  1448. package/ios/Option/TimeEventFrequency.swift +0 -18
  1449. package/ios/Player/LoadSeekCoordinator.swift +0 -84
  1450. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1451. package/ios/Player/PlaybackCoordinator.swift +0 -520
  1452. package/ios/Player/PlaybackEffectHandler.swift +0 -44
  1453. package/ios/Player/PlaybackErrorHandler.swift +0 -91
  1454. package/ios/Player/PlaybackProgressUpdateManager.swift +0 -68
  1455. package/ios/Player/PlayingStateManager.swift +0 -32
  1456. package/ios/Player/RetryManager.swift +0 -246
  1457. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1458. package/ios/Player/SleepTimerHandling.swift +0 -7
  1459. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1460. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -294
  1461. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -486
  1462. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -213
  1463. package/ios/Tests/PlaybackProgressUpdateManagerTests.swift +0 -166
  1464. package/ios/TrackPlayer.swift +0 -692
  1465. package/ios/TrackPlayerCallbacks.swift +0 -92
  1466. package/ios/Util/MetadataAdapter.swift +0 -131
  1467. package/ios/Util/OnceValue.swift +0 -70
  1468. package/lib/commonjs/features/rating.js +0 -2
  1469. package/lib/commonjs/features/rating.js.map +0 -1
  1470. package/lib/commonjs/types/player.js +0 -2
  1471. package/lib/commonjs/types/player.js.map +0 -1
  1472. package/lib/commonjs/web/SimpleRouter.test.js +0 -174
  1473. package/lib/commonjs/web/SimpleRouter.test.js.map +0 -1
  1474. package/lib/commonjs/web/TrackPlayer/PlaylistPlayer.js +0 -293
  1475. package/lib/commonjs/web/TrackPlayer/PlaylistPlayer.js.map +0 -1
  1476. package/lib/module/features/rating.js +0 -2
  1477. package/lib/module/features/rating.js.map +0 -1
  1478. package/lib/module/types/player.js +0 -2
  1479. package/lib/module/types/player.js.map +0 -1
  1480. package/lib/module/web/SimpleRouter.test.js +0 -174
  1481. package/lib/module/web/SimpleRouter.test.js.map +0 -1
  1482. package/lib/module/web/TrackPlayer/PlaylistPlayer.js +0 -288
  1483. package/lib/module/web/TrackPlayer/PlaylistPlayer.js.map +0 -1
  1484. package/lib/typescript/src/features/rating.d.ts +0 -14
  1485. package/lib/typescript/src/features/rating.d.ts.map +0 -1
  1486. package/lib/typescript/src/native.web.d.ts +0 -3
  1487. package/lib/typescript/src/native.web.d.ts.map +0 -1
  1488. package/lib/typescript/src/types/player.d.ts +0 -64
  1489. package/lib/typescript/src/types/player.d.ts.map +0 -1
  1490. package/lib/typescript/src/web/NativeAudioBrowser.d.ts +0 -188
  1491. package/lib/typescript/src/web/NativeAudioBrowser.d.ts.map +0 -1
  1492. package/lib/typescript/src/web/SimpleRouter.d.ts +0 -40
  1493. package/lib/typescript/src/web/SimpleRouter.d.ts.map +0 -1
  1494. package/lib/typescript/src/web/SimpleRouter.test.d.ts +0 -2
  1495. package/lib/typescript/src/web/SimpleRouter.test.d.ts.map +0 -1
  1496. package/lib/typescript/src/web/TrackPlayer/Event.d.ts +0 -11
  1497. package/lib/typescript/src/web/TrackPlayer/Event.d.ts.map +0 -1
  1498. package/lib/typescript/src/web/TrackPlayer/Player.d.ts +0 -59
  1499. package/lib/typescript/src/web/TrackPlayer/Player.d.ts.map +0 -1
  1500. package/lib/typescript/src/web/TrackPlayer/PlaylistPlayer.d.ts +0 -39
  1501. package/lib/typescript/src/web/TrackPlayer/PlaylistPlayer.d.ts.map +0 -1
  1502. package/lib/typescript/src/web/TrackPlayer/RepeatMode.d.ts +0 -6
  1503. package/lib/typescript/src/web/TrackPlayer/RepeatMode.d.ts.map +0 -1
  1504. package/lib/typescript/src/web/TrackPlayer/SetupNotCalledError.d.ts +0 -4
  1505. package/lib/typescript/src/web/TrackPlayer/SetupNotCalledError.d.ts.map +0 -1
  1506. package/lib/typescript/src/web/TrackPlayer/SleepTimer.d.ts +0 -34
  1507. package/lib/typescript/src/web/TrackPlayer/SleepTimer.d.ts.map +0 -1
  1508. package/lib/typescript/src/web/TrackPlayer/State.d.ts +0 -13
  1509. package/lib/typescript/src/web/TrackPlayer/State.d.ts.map +0 -1
  1510. package/lib/typescript/src/web/TrackPlayer/index.d.ts +0 -5
  1511. package/lib/typescript/src/web/TrackPlayer/index.d.ts.map +0 -1
  1512. package/lib/typescript/src/web/browser/BrowserManager.d.ts +0 -154
  1513. package/lib/typescript/src/web/browser/BrowserManager.d.ts.map +0 -1
  1514. package/lib/typescript/src/web/browser/FavoriteManager.d.ts +0 -42
  1515. package/lib/typescript/src/web/browser/FavoriteManager.d.ts.map +0 -1
  1516. package/lib/typescript/src/web/browser/NavigationErrorManager.d.ts +0 -40
  1517. package/lib/typescript/src/web/browser/NavigationErrorManager.d.ts.map +0 -1
  1518. package/lib/typescript/src/web/browser/SearchManager.d.ts +0 -22
  1519. package/lib/typescript/src/web/browser/SearchManager.d.ts.map +0 -1
  1520. package/lib/typescript/src/web/http/HttpClient.d.ts +0 -25
  1521. package/lib/typescript/src/web/http/HttpClient.d.ts.map +0 -1
  1522. package/lib/typescript/src/web/http/RequestConfigBuilder.d.ts +0 -98
  1523. package/lib/typescript/src/web/http/RequestConfigBuilder.d.ts.map +0 -1
  1524. package/lib/typescript/src/web/player/NowPlayingManager.d.ts +0 -34
  1525. package/lib/typescript/src/web/player/NowPlayingManager.d.ts.map +0 -1
  1526. package/lib/typescript/src/web/player/OptionsManager.d.ts +0 -32
  1527. package/lib/typescript/src/web/player/OptionsManager.d.ts.map +0 -1
  1528. package/lib/typescript/src/web/util/BrowserPathHelper.d.ts +0 -69
  1529. package/lib/typescript/src/web/util/BrowserPathHelper.d.ts.map +0 -1
  1530. package/lib/typescript/src/web/util/shuffle.d.ts +0 -8
  1531. package/lib/typescript/src/web/util/shuffle.d.ts.map +0 -1
  1532. package/nitrogen/generated/android/c++/JAndroidUpdateOptions.hpp +0 -86
  1533. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.hpp +0 -147
  1534. package/nitrogen/generated/android/c++/JFunc_void_IosOutput.hpp +0 -80
  1535. package/nitrogen/generated/android/c++/JFunc_void_RemoteSetRatingEvent.hpp +0 -87
  1536. package/nitrogen/generated/android/c++/JHeartRating.hpp +0 -57
  1537. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -75
  1538. package/nitrogen/generated/android/c++/JIosOutputType.hpp +0 -85
  1539. package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp +0 -94
  1540. package/nitrogen/generated/android/c++/JPartialSetupPlayerOptions.hpp +0 -96
  1541. package/nitrogen/generated/android/c++/JPercentageRating.hpp +0 -57
  1542. package/nitrogen/generated/android/c++/JRatingType.hpp +0 -73
  1543. package/nitrogen/generated/android/c++/JRemoteSetRatingEvent.hpp +0 -66
  1544. package/nitrogen/generated/android/c++/JStarRating.hpp +0 -57
  1545. package/nitrogen/generated/android/c++/JThumbsRating.hpp +0 -57
  1546. package/nitrogen/generated/android/c++/JUpdateOptions.hpp +0 -105
  1547. package/nitrogen/generated/android/c++/JVariant_HeartRating_ThumbsRating_StarRating_PercentageRating.cpp +0 -34
  1548. package/nitrogen/generated/android/c++/JVariant_HeartRating_ThumbsRating_StarRating_PercentageRating.hpp +0 -105
  1549. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp +0 -26
  1550. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp +0 -75
  1551. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidUpdateOptions.kt +0 -50
  1552. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HeartRating.kt +0 -38
  1553. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -47
  1554. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IosOutput.kt +0 -44
  1555. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IosOutputType.kt +0 -32
  1556. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt +0 -50
  1557. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PartialIOSSetupPlayerOptions.kt +0 -50
  1558. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PartialSetupPlayerOptions.kt +0 -47
  1559. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PercentageRating.kt +0 -38
  1560. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSetRatingEvent.kt +0 -38
  1561. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StarRating.kt +0 -38
  1562. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ThumbsRating.kt +0 -38
  1563. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/UpdateOptions.kt +0 -53
  1564. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_HeartRating_ThumbsRating_StarRating_PercentageRating.kt +0 -77
  1565. package/nitrogen/generated/ios/swift/AndroidUpdateOptions.swift +0 -119
  1566. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.swift +0 -68
  1567. package/nitrogen/generated/ios/swift/HeartRating.swift +0 -29
  1568. package/nitrogen/generated/ios/swift/IosOutputType.swift +0 -76
  1569. package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift +0 -92
  1570. package/nitrogen/generated/ios/swift/PartialSetupPlayerOptions.swift +0 -101
  1571. package/nitrogen/generated/ios/swift/PercentageRating.swift +0 -29
  1572. package/nitrogen/generated/ios/swift/RatingType.swift +0 -60
  1573. package/nitrogen/generated/ios/swift/RemoteSetRatingEvent.swift +0 -58
  1574. package/nitrogen/generated/ios/swift/StarRating.swift +0 -29
  1575. package/nitrogen/generated/ios/swift/ThumbsRating.swift +0 -29
  1576. package/nitrogen/generated/ios/swift/UpdateOptions.swift +0 -143
  1577. package/nitrogen/generated/ios/swift/Variant_HeartRating_ThumbsRating_StarRating_PercentageRating.swift +0 -20
  1578. package/nitrogen/generated/ios/swift/Variant_NullType_NotificationButtonLayout.swift +0 -18
  1579. package/nitrogen/generated/shared/c++/AndroidUpdateOptions.hpp +0 -109
  1580. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -98
  1581. package/nitrogen/generated/shared/c++/IosOutputType.hpp +0 -112
  1582. package/nitrogen/generated/shared/c++/NotificationButtonLayout.hpp +0 -102
  1583. package/nitrogen/generated/shared/c++/PartialSetupPlayerOptions.hpp +0 -104
  1584. package/nitrogen/generated/shared/c++/RatingType.hpp +0 -96
  1585. package/nitrogen/generated/shared/c++/RemoteSetRatingEvent.hpp +0 -94
  1586. package/nitrogen/generated/shared/c++/UpdateOptions.hpp +0 -111
  1587. package/src/features/rating.ts +0 -17
  1588. package/src/types/player.ts +0 -69
  1589. package/src/web/TrackPlayer/PlaylistPlayer.ts +0 -346
@@ -8,6 +8,7 @@ import android.os.Handler
8
8
  import android.os.IBinder
9
9
  import android.os.Looper
10
10
  import androidx.annotation.Keep
11
+ import androidx.car.app.connection.CarConnection
11
12
  import androidx.lifecycle.DefaultLifecycleObserver
12
13
  import androidx.lifecycle.LifecycleOwner
13
14
  import androidx.lifecycle.ProcessLifecycleOwner
@@ -15,38 +16,47 @@ import androidx.media3.session.MediaBrowser
15
16
  import androidx.media3.session.SessionToken
16
17
  import com.audiobrowser.browser.BrowserConfig
17
18
  import com.audiobrowser.browser.BrowserManager
18
- import com.audiobrowser.browser.handleTrackLoad
19
19
  import com.audiobrowser.browser.CallbackException
20
20
  import com.audiobrowser.browser.ContentNotFoundException
21
21
  import com.audiobrowser.browser.HttpStatusException
22
22
  import com.audiobrowser.browser.NetworkException
23
+ import com.audiobrowser.browser.flattenedChildren
24
+ import com.audiobrowser.browser.handleTrackLoad
25
+ import com.audiobrowser.browser.resolveMediaUrl
23
26
  import com.audiobrowser.extension.NumberExt.Companion.toSeconds
24
- import com.audiobrowser.http.RequestConfigBuilder
25
- import com.audiobrowser.model.PlaybackMetadata
27
+ import com.audiobrowser.extension.indexOfTappedTrack
26
28
  import com.audiobrowser.model.PlayerSetupOptions
27
29
  import com.audiobrowser.model.PlayerUpdateOptions
30
+ import com.audiobrowser.player.Player
28
31
  import com.audiobrowser.util.BatteryOptimizationHelper
29
32
  import com.audiobrowser.util.BatteryWarningStore
30
33
  import com.audiobrowser.util.BrowserPathHelper
31
- import com.audiobrowser.util.CoilBitmapLoader
34
+ import com.audiobrowser.util.OutputMonitor
35
+ import com.audiobrowser.util.OutputSwitcher
32
36
  import com.audiobrowser.util.SystemVolumeMonitor
37
+ import com.audiobrowser.util.awaitNestedOrTimeout
38
+ import com.audiobrowser.util.awaitOrTimeout
33
39
  import com.facebook.proguard.annotations.DoNotStrip
34
40
  import com.google.common.util.concurrent.ListenableFuture
35
41
  import com.margelo.nitro.NitroModules
36
- import com.margelo.nitro.audiobrowser.ChapterMetadata
37
- import com.margelo.nitro.audiobrowser.TimedMetadata
38
- import com.margelo.nitro.audiobrowser.TrackMetadata
42
+ import com.margelo.nitro.audiobrowser.ArtworkRequestConfig
39
43
  import com.margelo.nitro.audiobrowser.BatteryOptimizationStatus
40
44
  import com.margelo.nitro.audiobrowser.BatteryOptimizationStatusChangedEvent
41
45
  import com.margelo.nitro.audiobrowser.BatteryWarningPendingChangedEvent
46
+ import com.margelo.nitro.audiobrowser.ChapterMetadata
42
47
  import com.margelo.nitro.audiobrowser.EqualizerSettings
43
48
  import com.margelo.nitro.audiobrowser.FavoriteChangedEvent
44
49
  import com.margelo.nitro.audiobrowser.FormatNavigationErrorParams
45
50
  import com.margelo.nitro.audiobrowser.FormattedNavigationError
51
+ import com.margelo.nitro.audiobrowser.Gate
52
+ import com.margelo.nitro.audiobrowser.GateDecision
53
+ import com.margelo.nitro.audiobrowser.GateEvent
46
54
  import com.margelo.nitro.audiobrowser.HybridAudioBrowserSpec
47
- import com.margelo.nitro.audiobrowser.IosOutput
48
55
  import com.margelo.nitro.audiobrowser.MediaRequestConfig
49
56
  import com.margelo.nitro.audiobrowser.NativeBrowserConfiguration
57
+ import com.margelo.nitro.audiobrowser.NativeGateRequest
58
+ import com.margelo.nitro.audiobrowser.NativeRouteEntry
59
+ import com.margelo.nitro.audiobrowser.NativeSetupPlayerOptions
50
60
  import com.margelo.nitro.audiobrowser.NativeUpdateOptions
51
61
  import com.margelo.nitro.audiobrowser.NavigationError
52
62
  import com.margelo.nitro.audiobrowser.NavigationErrorEvent
@@ -54,7 +64,7 @@ import com.margelo.nitro.audiobrowser.NavigationErrorType
54
64
  import com.margelo.nitro.audiobrowser.NowPlayingMetadata
55
65
  import com.margelo.nitro.audiobrowser.NowPlayingUpdate
56
66
  import com.margelo.nitro.audiobrowser.Options
57
- import com.margelo.nitro.audiobrowser.PartialSetupPlayerOptions
67
+ import com.margelo.nitro.audiobrowser.Output
58
68
  import com.margelo.nitro.audiobrowser.Playback
59
69
  import com.margelo.nitro.audiobrowser.PlaybackActiveTrackChangedEvent
60
70
  import com.margelo.nitro.audiobrowser.PlaybackError
@@ -62,6 +72,7 @@ import com.margelo.nitro.audiobrowser.PlaybackErrorEvent
62
72
  import com.margelo.nitro.audiobrowser.PlaybackPlayWhenReadyChangedEvent
63
73
  import com.margelo.nitro.audiobrowser.PlaybackProgressUpdatedEvent
64
74
  import com.margelo.nitro.audiobrowser.PlaybackQueueEndedEvent
75
+ import com.margelo.nitro.audiobrowser.PlaybackState
65
76
  import com.margelo.nitro.audiobrowser.PlayingState
66
77
  import com.margelo.nitro.audiobrowser.Progress
67
78
  import com.margelo.nitro.audiobrowser.RemoteJumpBackwardEvent
@@ -69,25 +80,30 @@ import com.margelo.nitro.audiobrowser.RemoteJumpForwardEvent
69
80
  import com.margelo.nitro.audiobrowser.RemotePlayIdEvent
70
81
  import com.margelo.nitro.audiobrowser.RemotePlaySearchEvent
71
82
  import com.margelo.nitro.audiobrowser.RemoteSeekEvent
72
- import com.margelo.nitro.audiobrowser.RemoteSetRatingEvent
73
83
  import com.margelo.nitro.audiobrowser.RemoteSkipEvent
74
84
  import com.margelo.nitro.audiobrowser.RepeatMode
75
85
  import com.margelo.nitro.audiobrowser.RepeatModeChangedEvent
76
- import com.margelo.nitro.audiobrowser.RequestConfig
77
86
  import com.margelo.nitro.audiobrowser.ResolvedTrack
78
87
  import com.margelo.nitro.audiobrowser.SleepTimer
88
+ import com.margelo.nitro.audiobrowser.TimedMetadata
79
89
  import com.margelo.nitro.audiobrowser.Track
80
- import com.margelo.nitro.audiobrowser.UpdateOptions
90
+ import com.margelo.nitro.audiobrowser.TrackMetadata
91
+ import com.margelo.nitro.audiobrowser.TransformableRequestConfig
92
+ import com.margelo.nitro.core.NullType
81
93
  import com.margelo.nitro.core.Promise
82
94
  import java.util.concurrent.TimeUnit
83
- import kotlin.coroutines.resume
84
- import kotlin.coroutines.resumeWithException
85
- import kotlin.coroutines.suspendCoroutine
95
+ import java.util.concurrent.atomic.AtomicReference
86
96
  import kotlinx.coroutines.CancellationException
97
+ import kotlinx.coroutines.CompletableDeferred
98
+ import kotlinx.coroutines.CoroutineScope
99
+ import kotlinx.coroutines.CoroutineStart
100
+ import kotlinx.coroutines.DelicateCoroutinesApi
87
101
  import kotlinx.coroutines.Job
88
102
  import kotlinx.coroutines.MainScope
103
+ import kotlinx.coroutines.cancel
89
104
  import kotlinx.coroutines.cancelChildren
90
- import kotlinx.coroutines.delay
105
+ import kotlinx.coroutines.currentCoroutineContext
106
+ import kotlinx.coroutines.ensureActive
91
107
  import kotlinx.coroutines.launch
92
108
  import kotlinx.coroutines.runBlocking
93
109
  import timber.log.Timber
@@ -95,6 +111,72 @@ import timber.log.Timber
95
111
  @Keep
96
112
  @DoNotStrip
97
113
  class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
114
+
115
+ /**
116
+ * Runs on an explicit JS `dispose()` and, through [disposeCurrent], on runtime teardown, which
117
+ * Nitro itself never reports.
118
+ *
119
+ * The Service outlives this object, so everything registered in `init` or on connect is undone
120
+ * here; left alone, the running [Player] calls into a dead JSI runtime and each reload strands a
121
+ * ServiceConnection and lifecycle observer. The teardown is posted to main, where
122
+ * [onServiceConnected] and [onServiceDisconnected] write the same state; dispose itself arrives
123
+ * on the JS thread or the teardown callback's thread.
124
+ */
125
+ override fun dispose() {
126
+ current.compareAndSet(this, null)
127
+ systemVolumeMonitor.destroy()
128
+ outputMonitor.destroy()
129
+ // Only when still ours: on a reload the replacement may already own the slot.
130
+ carConnectionTarget.compareAndSet(onCarConnectedChanged, null)
131
+
132
+ dropStaleJSCallbacks()
133
+
134
+ handler.post {
135
+ connectedService?.let { service ->
136
+ // Identity-guarded: both instances bind to the same singleton Service, so a late dispose
137
+ // must not strip the wiring a replacement has already installed.
138
+ if (service.player.getCallbacks() === callbacks) service.player.setCallbacks(null)
139
+ if (service.player.browser === this) {
140
+ service.player.browser = null
141
+ // It wraps a JS callback from this runtime: left set, every track change throws into the
142
+ // now-playing updater's fallback until the next setup().
143
+ service.player.nowPlaying.formatter = null
144
+ }
145
+ if (service.onBatteryWarningPendingChanged === onBatteryWarningPending) {
146
+ service.onBatteryWarningPendingChanged = null
147
+ }
148
+ }
149
+ connectedService = null
150
+
151
+ // Dropping the reference disconnects nothing: the controller stays in the session's
152
+ // connected list, holding a binder and a listener.
153
+ mediaBrowserFuture?.let { MediaBrowser.releaseFuture(it) }
154
+ mediaBrowserFuture = null
155
+
156
+ serviceBinding.unbind(this)
157
+
158
+ ProcessLifecycleOwner.get().lifecycle.removeObserver(lifecycleObserver)
159
+ // Inside this post: run from dispose() after the post, it would drop the teardown itself.
160
+ handler.removeCallbacksAndMessages(null)
161
+ mainScope.cancel()
162
+ }
163
+ super.dispose()
164
+ }
165
+
166
+ /**
167
+ * Strips every JS function from the config, at every depth, and reverts [resolveGate]: anything
168
+ * still holding this instance (an in-flight browse, the running player) can invoke them after the
169
+ * runtime is gone. Those paths then degrade like a config that never had callbacks (static
170
+ * layers, default error copy, fail-closed gate) instead of throwing into the error path. The
171
+ * now-playing formatter is cleared in [dispose]. Mirrors iOS `dropStaleJSCallbacks`, where the
172
+ * same invoke is fatal rather than a throw.
173
+ */
174
+ private fun dropStaleJSCallbacks() {
175
+ _configuration = _configuration.strippingJSCallbacks()
176
+ browserManager.config = buildConfig()
177
+ resolveGate = defaultResolveGate
178
+ }
179
+
98
180
  private val mainScope = MainScope()
99
181
  private var navigationJob: Job? = null
100
182
  private val handler = Handler(Looper.getMainLooper())
@@ -103,18 +185,24 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
103
185
  ?: throw IllegalStateException("NitroModules.applicationContext is null")
104
186
 
105
187
  // MARK: Browser state
188
+ private var isConfigured = false
106
189
  private var _configuration =
107
190
  NativeBrowserConfiguration(
108
191
  path = null,
109
192
  request = null,
193
+ requestResolver = null,
194
+ browse = null,
195
+ browseResolver = null,
110
196
  media = null,
111
197
  artwork = null,
198
+ nowPlayingArtwork = null,
112
199
  routes = null,
113
200
  singleTrack = null,
114
201
  handleTrackLoad = null,
115
202
  androidControllerOfflineError = null,
116
- carPlayUpNextButton = null,
117
- carPlayNowPlayingButtons = null,
203
+ viewMoreTitle = null,
204
+ carPlayLoadingTitle = null,
205
+ resolveAlbumPath = null,
118
206
  formatNavigationError = null,
119
207
  )
120
208
 
@@ -123,18 +211,36 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
123
211
  setOnPathChanged { path -> onPathChanged(path) }
124
212
  setOnContentChanged { content -> onContentChanged(content) }
125
213
  setOnTabsChanged { tabs -> onTabsChanged(tabs) }
214
+ setOnArtworkRegistriesCleared { connectedService?.player?.browseArtworkRegistry?.clear() }
126
215
  }
127
216
 
128
217
  private val systemVolumeMonitor = SystemVolumeMonitor(context)
218
+ private val outputMonitor = OutputMonitor(context)
129
219
 
130
220
  // MARK: Player state
131
221
  private var updateOptions: PlayerUpdateOptions = PlayerUpdateOptions()
132
222
  private var mediaBrowserFuture: ListenableFuture<MediaBrowser>? = null
133
223
  private var setupOptions = PlayerSetupOptions()
134
- private var connectedService: Service? = null
135
- private var setupPromise: ((Unit) -> Unit)? = null
224
+ // Written only on main (ServiceConnection callbacks, dispose); read on main and, in places,
225
+ // straight from the JS thread, where it may be stale either way: a just-detached service, or
226
+ // null while onServiceConnected is pending. Keep writes on main; no read-modify-write.
227
+ @Volatile private var connectedService: Service? = null
228
+
229
+ private val serviceBinding = ServiceBinding(context)
230
+
231
+ // Held rather than inlined so [dispose] can tell its own wiring from a replacement's.
232
+ private val onBatteryWarningPending: (Boolean) -> Unit = { pending ->
233
+ post { onBatteryWarningPendingChanged(BatteryWarningPendingChangedEvent(pending)) }
234
+ }
235
+ // Every setupPlayer waiting for the service awaits it. Replaced on disconnect, after
236
+ // cancelChildren has rejected its waiters, and on a dead binding, after failing them.
237
+ private var connectionReady = CompletableDeferred<Unit>()
238
+
239
+ // Staged by setup options or by setters called before the player exists; last write wins, and
240
+ // [applyPendingPlayerState] consumes them.
241
+ private var pendingPlayWhenReady: Boolean? = null
242
+ private var pendingRepeatMode: RepeatMode? = null
136
243
 
137
- /** Post callback to main handler for consistent async delivery to JS - avoids deadlocks */
138
244
  private fun post(block: () -> Unit) = handler.post(block)
139
245
 
140
246
  // MARK: Browser callbacks
@@ -144,13 +250,18 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
144
250
  override var onNavigationError: (NavigationErrorEvent) -> Unit = {}
145
251
  override var onFormattedNavigationError: (FormattedNavigationError?) -> Unit = {}
146
252
 
253
+ // MARK: Gate callbacks (native→JS; set from JS, native CALLS them)
254
+ // Denies by default: it is reached only while a resolver is declared but none from a live
255
+ // runtime is bound (before JS assigns one, or after [dispose] reverts it), and an active gate
256
+ // must not serve content in that window.
257
+ override var resolveGate: (request: NativeGateRequest) -> Promise<Promise<GateDecision>> =
258
+ defaultResolveGate
259
+ override var onGate: (event: GateEvent) -> Unit = {}
260
+
147
261
  // MARK: Player callbacks
148
262
  override var onPlaybackChanged: (data: Playback) -> Unit = {}
149
- override var onRemoteBookmark: () -> Unit = {}
150
- override var onRemoteDislike: () -> Unit = {}
151
263
  override var onRemoteJumpBackward: (RemoteJumpBackwardEvent) -> Unit = {}
152
264
  override var onRemoteJumpForward: (RemoteJumpForwardEvent) -> Unit = {}
153
- override var onRemoteLike: () -> Unit = {}
154
265
  override var onRemoteNext: () -> Unit = {}
155
266
  override var onRemotePause: () -> Unit = {}
156
267
  override var onChapterMetadata: (chapters: Array<ChapterMetadata>) -> Unit = {}
@@ -162,6 +273,7 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
162
273
  {}
163
274
  override var onPlaybackPlayingState: (data: PlayingState) -> Unit = {}
164
275
  override var onPlaybackProgressUpdated: (data: PlaybackProgressUpdatedEvent) -> Unit = {}
276
+ override var onPlaybackInterval: () -> Unit = {}
165
277
  override var onPlaybackQueueEnded: (data: PlaybackQueueEndedEvent) -> Unit = {}
166
278
  override var onPlaybackQueueChanged: (queue: Array<Track>) -> Unit = {}
167
279
  override var onPlaybackRepeatModeChanged: (data: RepeatModeChangedEvent) -> Unit = {}
@@ -171,7 +283,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
171
283
  override var onRemotePlaySearch: (RemotePlaySearchEvent) -> Unit = {}
172
284
  override var onRemotePrevious: () -> Unit = {}
173
285
  override var onRemoteSeek: (RemoteSeekEvent) -> Unit = {}
174
- override var onRemoteSetRating: (RemoteSetRatingEvent) -> Unit = {}
175
286
  override var onRemoteSkip: (RemoteSkipEvent) -> Unit = {}
176
287
  override var onRemoteStop: () -> Unit = {}
177
288
  override var onOptionsChanged: (Options) -> Unit = {}
@@ -184,14 +295,11 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
184
295
  override var onBatteryOptimizationStatusChanged: (BatteryOptimizationStatusChangedEvent) -> Unit =
185
296
  {}
186
297
  override var onSystemVolumeChanged: (Double) -> Unit = {}
187
- override var onIosOutputChanged: (IosOutput) -> Unit = {}
298
+ override var onOutputChanged: (Output) -> Unit = {}
188
299
 
189
300
  // MARK: Remote handlers
190
- override var handleRemoteBookmark: (() -> Unit)? = null
191
- override var handleRemoteDislike: (() -> Unit)? = null
192
301
  override var handleRemoteJumpBackward: ((RemoteJumpBackwardEvent) -> Unit)? = null
193
302
  override var handleRemoteJumpForward: ((RemoteJumpForwardEvent) -> Unit)? = null
194
- override var handleRemoteLike: (() -> Unit)? = null
195
303
  override var handleRemoteNext: (() -> Unit)? = null
196
304
  override var handleRemotePause: (() -> Unit)? = null
197
305
  override var handleRemotePlay: (() -> Unit)? = null
@@ -202,7 +310,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
202
310
  override var handleRemoteSkip: (() -> Unit)? = null
203
311
  override var handleRemoteStop: (() -> Unit)? = null
204
312
 
205
- /** Lifecycle observer to check battery status when app comes to foreground */
206
313
  private val lifecycleObserver =
207
314
  object : DefaultLifecycleObserver {
208
315
  override fun onStart(owner: LifecycleOwner) {
@@ -211,12 +318,13 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
211
318
  }
212
319
 
213
320
  init {
214
- // Auto-bind to service if it's already running
321
+ current.set(this)
322
+
215
323
  launchInScope {
216
324
  try {
217
325
  Timber.d("Attempting to auto-bind to existing AudioBrowserService from AudioBrowser")
218
326
  val intent = Intent(context, Service::class.java)
219
- val bound = context.bindService(intent, this@AudioBrowser, Context.BIND_AUTO_CREATE)
327
+ val bound = serviceBinding.bind(intent, this@AudioBrowser)
220
328
  Timber.d("Auto-bind result: $bound")
221
329
 
222
330
  if (!bound) {
@@ -227,14 +335,15 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
227
335
  }
228
336
  }
229
337
 
230
- // Observe app lifecycle to check battery status on foreground
231
- // Must run on main thread as required by LifecycleRegistry.addObserver
338
+ // LifecycleRegistry.addObserver asserts the main thread.
232
339
  handler.post { ProcessLifecycleOwner.get().lifecycle.addObserver(lifecycleObserver) }
233
340
 
234
- // Observe system volume changes
235
- systemVolumeMonitor.setOnVolumeChanged { volume ->
236
- post { onSystemVolumeChanged(volume) }
237
- }
341
+ systemVolumeMonitor.setOnVolumeChanged { volume -> post { onSystemVolumeChanged(volume) } }
342
+
343
+ outputMonitor.setOnOutputChanged { output -> post { onOutputChanged(output) } }
344
+ outputMonitor.start()
345
+
346
+ startCarConnectionObserver(context, handler)
238
347
  }
239
348
 
240
349
  // ============================================================================
@@ -244,43 +353,27 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
244
353
  internal fun buildConfig(): BrowserConfig {
245
354
  return BrowserConfig(
246
355
  request = _configuration.request,
356
+ requestResolver = _configuration.requestResolver,
357
+ browse = _configuration.browse,
358
+ browseResolver = _configuration.browseResolver,
247
359
  media = _configuration.media,
248
360
  artwork = _configuration.artwork,
361
+ nowPlayingArtwork = _configuration.nowPlayingArtwork,
249
362
  routes = _configuration.routes,
250
363
  singleTrack = _configuration.singleTrack ?: false,
251
364
  androidControllerOfflineError = _configuration.androidControllerOfflineError ?: true,
365
+ viewMoreTitle = _configuration.viewMoreTitle,
252
366
  )
253
367
  }
254
368
 
255
369
  /**
256
- * Returns the artwork configuration for use by CoilBitmapLoader. This provides access to the base
257
- * request config and artwork-specific config.
258
- */
259
- fun getArtworkConfig(): CoilBitmapLoader.ArtworkConfig? {
260
- val artworkConfig = _configuration.artwork ?: return null
261
- val baseConfig =
262
- _configuration.request?.let { RequestConfigBuilder.toRequestConfig(it) }
263
- ?: RequestConfig(null, null, null, null, null, null, null, null)
264
- return CoilBitmapLoader.ArtworkConfig(baseConfig, artworkConfig)
265
- }
266
-
267
- /**
268
- * Creates a request config for media URL transformation by merging base and media configs.
269
- * Returns null if no media configuration is set.
370
+ * The request config for [originalUrl], or null when resolution fails. Blocks: it is called from
371
+ * [com.audiobrowser.player.TransformingDataSource.open] on ExoPlayer's loading thread, never main
372
+ * or JS.
270
373
  */
271
- fun getMediaRequestConfig(originalUrl: String): MediaRequestConfig? {
272
- val mediaConfig = _configuration.media ?: return null
273
-
374
+ fun getMediaRequestConfig(originalUrl: String, track: Track): MediaRequestConfig? {
274
375
  return try {
275
- // Create base request config with the original URL as path
276
- val baseConfig =
277
- _configuration.request?.let { RequestConfigBuilder.toRequestConfig(it) }
278
- ?: RequestConfig(null, null, null, null, null, null, null, null)
279
- val urlRequestConfig = RequestConfig(null, originalUrl, null, null, null, null, null, null)
280
- val mergedBaseConfig = RequestConfigBuilder.mergeConfig(baseConfig, urlRequestConfig)
281
-
282
- // Apply media transformation
283
- runBlocking { RequestConfigBuilder.mergeConfig(mergedBaseConfig, mediaConfig) }
376
+ runBlocking { browserManager.resolveMediaUrl(originalUrl, track) }
284
377
  } catch (e: Exception) {
285
378
  Timber.e(e, "Failed to transform media URL: $originalUrl")
286
379
  null
@@ -288,21 +381,25 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
288
381
  }
289
382
 
290
383
  private fun hasValidConfiguration(): Boolean {
291
- // Need at least one browsable route (not just search)
292
384
  return _configuration.routes?.any { it.path != BrowserManager.SEARCH_ROUTE_PATH } == true
293
385
  }
294
386
 
295
- private fun getDefaultPath(): String? {
387
+ // Suspends because queryTabs() invokes JS callbacks, which run on the JS thread. Never call it
388
+ // through runBlocking from a Nitro setter: that runs on the JS thread and deadlocks waiting for
389
+ // callbacks that need it.
390
+ private suspend fun getDefaultPath(): String? {
296
391
  return try {
297
392
  browserManager.config = buildConfig()
298
- val tabs = runBlocking { browserManager.queryTabs() }
393
+ val tabs = browserManager.queryTabs()
299
394
  if (tabs.isNotEmpty()) {
300
- Timber.d("Using first tab as default path: ${tabs[0].url}")
301
- tabs[0].url
395
+ Timber.d("Using first tab as default path: ${tabs[0].path}")
396
+ tabs[0].path
302
397
  } else {
303
398
  Timber.d("Using root path as default: /")
304
399
  "/"
305
400
  }
401
+ } catch (e: CancellationException) {
402
+ throw e
306
403
  } catch (e: Exception) {
307
404
  Timber.e(e, "Failed to get default path, falling back to /")
308
405
  "/"
@@ -318,23 +415,21 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
318
415
  set(value) {
319
416
  if (hasValidConfiguration()) {
320
417
  browserManager.config = buildConfig()
321
- (value ?: getDefaultPath())?.let { path ->
322
- clearNavigationError()
323
-
324
- // Cancel previous navigation to avoid race conditions
325
- navigationJob?.cancel()
326
-
327
- navigationJob =
328
- mainScope.launch {
329
- try {
330
- browserManager.navigate(path)
331
- } catch (e: CancellationException) {
332
- throw e // Rethrow to properly cancel
333
- } catch (e: Exception) {
334
- handleBrowserException(e, path, "setting path: $path")
335
- }
418
+ clearNavigationError()
419
+
420
+ navigationJob?.cancel()
421
+
422
+ navigationJob =
423
+ mainScope.launch {
424
+ val path = value ?: getDefaultPath() ?: return@launch
425
+ try {
426
+ browserManager.navigate(path)
427
+ } catch (e: CancellationException) {
428
+ throw e
429
+ } catch (e: Exception) {
430
+ handleBrowserException(e, path, "setting path: $path")
336
431
  }
337
- }
432
+ }
338
433
  }
339
434
  }
340
435
 
@@ -347,131 +442,90 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
347
442
  set(value) {
348
443
  _configuration = value
349
444
  browserManager.config = buildConfig()
445
+ browserManager.clearContentCache()
446
+
447
+ // Reaches MediaSession, which asserts the main thread, from this JS-thread setter. Launched,
448
+ // not blocked: what it triggers can wait on JS callbacks, which cannot run while the JS
449
+ // thread waits. Queued on mainScope ahead of navigationJob, so the two stay ordered.
450
+ launchInScope {
451
+ // Here, not in the setter: onServiceConnected reads it on main, and must not see it before
452
+ // browserManager.config is set.
453
+ isConfigured = true
454
+ connectedService?.player?.notifyBrowserConfigurationReady()
455
+ }
350
456
 
351
- // Notify player that browser configuration is ready (routes/tabs available)
352
- // This allows Android Auto to start browsing content
353
- connectedService?.player?.notifyBrowserConfigurationReady()
457
+ clearNavigationError()
354
458
 
355
- // Navigate to initial path or default to first tab
356
- (value.path ?: getDefaultPath())?.let { path ->
357
- clearNavigationError()
459
+ navigationJob?.cancel()
358
460
 
359
- // Cancel previous navigation to avoid race conditions
360
- navigationJob?.cancel()
361
-
362
- navigationJob =
363
- mainScope.launch {
364
- try {
365
- browserManager.navigate(path)
366
- } catch (e: CancellationException) {
367
- throw e // Rethrow to properly cancel
368
- } catch (e: Exception) {
369
- handleBrowserException(e, path, "setting configuration path: $path")
370
- }
461
+ navigationJob =
462
+ mainScope.launch {
463
+ val path = value.path ?: getDefaultPath() ?: return@launch
464
+ try {
465
+ browserManager.navigate(path)
466
+ } catch (e: CancellationException) {
467
+ throw e
468
+ } catch (e: Exception) {
469
+ handleBrowserException(e, path, "setting configuration path: $path")
371
470
  }
372
- }
471
+ }
373
472
  }
374
473
 
375
474
  private var navigationError: NavigationError? = null
376
475
  private var formattedNavigationError: FormattedNavigationError? = null
377
476
 
378
477
  override fun getNavigationError(): NavigationError? = navigationError
379
- override fun getFormattedNavigationError(): FormattedNavigationError? = formattedNavigationError
380
478
 
381
- /** Creates a default formatted error from a NavigationError */
382
- private fun defaultFormattedError(error: NavigationError): FormattedNavigationError {
383
- val title = when (error.code) {
384
- NavigationErrorType.CONTENT_NOT_FOUND -> "Content Not Found"
385
- NavigationErrorType.NETWORK_ERROR -> "Network Error"
386
- NavigationErrorType.HTTP_ERROR -> {
387
- // Use system-localized HTTP status text (e.g., "Not Found", "Service Unavailable")
388
- error.statusCode?.let { httpStatusText(it.toInt()) } ?: "Server Error"
389
- }
390
- NavigationErrorType.CALLBACK_ERROR -> "Error"
391
- NavigationErrorType.UNKNOWN_ERROR -> "Error"
392
- }
393
- return FormattedNavigationError(title, error.message)
394
- }
479
+ override fun getFormattedNavigationError(): FormattedNavigationError? = formattedNavigationError
395
480
 
396
- /** Returns localized HTTP status text for the given status code */
397
- private fun httpStatusText(statusCode: Int): String {
398
- return when (statusCode) {
399
- 400 -> "Bad Request"
400
- 401 -> "Unauthorized"
401
- 403 -> "Forbidden"
402
- 404 -> "Not Found"
403
- 405 -> "Method Not Allowed"
404
- 408 -> "Request Timeout"
405
- 429 -> "Too Many Requests"
406
- 500 -> "Internal Server Error"
407
- 502 -> "Bad Gateway"
408
- 503 -> "Service Unavailable"
409
- 504 -> "Gateway Timeout"
410
- else -> "Server Error"
481
+ /**
482
+ * The display form of [error] at [path]: the app's `formatNavigationError` when configured, else
483
+ * the built-in default. Shared with the Android Auto empty tile so in-app and in-car copy cannot
484
+ * drift (ADR 0001).
485
+ */
486
+ internal suspend fun resolveFormattedError(
487
+ error: NavigationError,
488
+ path: String,
489
+ ): FormattedNavigationError {
490
+ val default = defaultFormattedError(error)
491
+ val formatter = _configuration.formatNavigationError ?: return default
492
+ return formattedOrDefault(default) {
493
+ formatter(
494
+ FormatNavigationErrorParams(
495
+ error,
496
+ default,
497
+ path,
498
+ BrowserPathHelper.navigationErrorKind(path),
499
+ )
500
+ )
501
+ .awaitOrTimeout()
411
502
  }
412
503
  }
413
504
 
414
- private fun setNavigationError(
415
- code: NavigationErrorType,
416
- message: String,
417
- path: String,
418
- statusCode: Double? = null,
419
- statusCodeSuccess: Boolean? = null,
420
- ) {
421
- val navError = NavigationError(code, message, statusCode, statusCodeSuccess)
505
+ private fun setNavigationError(navError: NavigationError, path: String) {
422
506
  navigationError = navError
423
507
  onNavigationError(NavigationErrorEvent(navigationError))
424
508
 
425
- // Format the error (async if using JS callback, sync for defaults)
426
- val defaultFormatted = defaultFormattedError(navError)
427
- val formatter = _configuration.formatNavigationError
428
- if (formatter != null) {
429
- mainScope.launch {
430
- try {
431
- val params = FormatNavigationErrorParams(navError, defaultFormatted, path)
432
- val customFormatted = formatter(params).await()
433
- formattedNavigationError = customFormatted ?: defaultFormatted
434
- } catch (e: Exception) {
435
- formattedNavigationError = defaultFormatted
436
- }
437
- onFormattedNavigationError(formattedNavigationError)
438
- }
439
- } else {
440
- formattedNavigationError = defaultFormatted
441
- onFormattedNavigationError(formattedNavigationError)
509
+ // Without a formatter the field and event land in this turn, so a same-turn
510
+ // getFormattedNavigationError or clearNavigationError cannot race a launch yet to run.
511
+ if (_configuration.formatNavigationError == null) {
512
+ val default = defaultFormattedError(navError)
513
+ formattedNavigationError = default
514
+ onFormattedNavigationError(default)
515
+ return
516
+ }
517
+
518
+ mainScope.launch {
519
+ val formatted = resolveFormattedError(navError, path)
520
+ formattedNavigationError = formatted
521
+ onFormattedNavigationError(formatted)
442
522
  }
443
523
  }
444
524
 
445
- /** Maps common browser exceptions to navigation errors */
446
525
  private fun handleBrowserException(e: Exception, path: String, logContext: String) {
447
- when (e) {
448
- is HttpStatusException -> {
449
- Timber.e(e, "HTTP error $logContext")
450
- setNavigationError(
451
- NavigationErrorType.HTTP_ERROR,
452
- e.message ?: "Server error",
453
- path,
454
- e.statusCode.toDouble(),
455
- e.statusCode in 200..299,
456
- )
457
- }
458
- is NetworkException -> {
459
- Timber.e(e, "Network error $logContext")
460
- setNavigationError(NavigationErrorType.NETWORK_ERROR, e.message ?: "Network request failed", path)
461
- }
462
- is ContentNotFoundException -> {
463
- Timber.e(e, "Content not found $logContext")
464
- setNavigationError(NavigationErrorType.CONTENT_NOT_FOUND, e.message ?: "Content not found", path)
465
- }
466
- is CallbackException -> {
467
- Timber.e(e, "Callback error $logContext")
468
- setNavigationError(NavigationErrorType.CALLBACK_ERROR, e.message ?: "An error occurred", path)
469
- }
470
- else -> {
471
- Timber.e(e, "Unexpected error $logContext")
472
- setNavigationError(NavigationErrorType.UNKNOWN_ERROR, e.message ?: "An unexpected error occurred", path)
473
- }
474
- }
526
+ val navError = navigationErrorFor(e)
527
+ Timber.e(e, "${navError.code} $logContext")
528
+ setNavigationError(navError, path)
475
529
  }
476
530
 
477
531
  private fun clearNavigationError() {
@@ -490,7 +544,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
490
544
  override fun navigatePath(path: String) {
491
545
  clearNavigationError()
492
546
 
493
- // Cancel previous navigation to avoid race conditions
494
547
  navigationJob?.cancel()
495
548
 
496
549
  navigationJob =
@@ -499,7 +552,7 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
499
552
  Timber.d("Navigating to path: $path")
500
553
  browserManager.navigate(path)
501
554
  } catch (e: CancellationException) {
502
- throw e // Rethrow to properly cancel
555
+ throw e
503
556
  } catch (e: Exception) {
504
557
  handleBrowserException(e, path, "navigating to path: $path")
505
558
  }
@@ -507,84 +560,127 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
507
560
  }
508
561
 
509
562
  override fun navigateTrack(track: Track) {
563
+ // A disabled track never plays, whichever surface delivered it (mirrors iOS
564
+ // TrackSelector.select). Refused before any state changes: an inert tap must not clear an
565
+ // unrelated navigation error or cancel an in-flight navigation.
566
+ if (track.disabled == true) {
567
+ Timber.d("Ignoring selection of disabled track: ${track.title}")
568
+ return
569
+ }
570
+
510
571
  clearNavigationError()
511
572
 
512
- // Cancel previous navigation to avoid race conditions
513
573
  navigationJob?.cancel()
514
574
 
515
- val url = track.url
575
+ val path = track.path
516
576
  navigationJob =
517
577
  mainScope.launch {
518
578
  try {
519
579
  when {
520
- // Check if this is a contextual URL (playable-only track with queue context)
521
- url != null && BrowserPathHelper.isContextual(url) -> {
522
- Timber.d("Navigating to contextual track URL: $url")
580
+ path != null && BrowserPathHelper.isContextual(path) -> {
581
+ Timber.d("Navigating to contextual track path: $path")
523
582
 
524
- val parentPath = BrowserPathHelper.stripTrackId(url)
525
- val trackId = BrowserPathHelper.extractTrackId(url)
583
+ val parentPath = BrowserPathHelper.stripTrackId(path)
584
+ val trackId = BrowserPathHelper.extractTrackId(path)
526
585
 
527
- // Check if queue already came from this parent path - just skip to the track
528
586
  if (trackId != null && parentPath == player.queueSourcePath) {
529
- val index = player.tracks.indexOfFirst { it.src == trackId }
587
+ val index = player.tracks.indexOfTappedTrack(path, trackId)
530
588
  if (index >= 0) {
531
589
  Timber.d("Queue already from $parentPath, skipping to index $index")
532
- handleTrackLoad(_configuration.handleTrackLoad, track, player.tracks, index.toDouble(), intercepted = {}, defaultBehavior = {
533
- player.skipTo(index)
534
- player.play()
535
- })
590
+ handleTrackLoad(
591
+ _configuration.handleTrackLoad,
592
+ track,
593
+ player.tracks,
594
+ index.toDouble(),
595
+ startPosition = null,
596
+ intercepted = {},
597
+ defaultBehavior = {
598
+ player.skipTo(index)
599
+ player.play()
600
+ },
601
+ )
536
602
  return@launch
537
603
  }
538
604
  }
539
605
 
540
- // Expand the queue from the contextual URL
541
- val expanded = browserManager.expandQueueFromContextualUrl(url)
606
+ val expanded = browserManager.expandQueueFromContextualPath(path)
542
607
 
543
608
  if (expanded != null) {
544
609
  val (tracks, startIndex) = expanded
545
610
  Timber.d(
546
611
  "Loading expanded queue: ${tracks.size} tracks, starting at index $startIndex"
547
612
  )
548
- handleTrackLoad(_configuration.handleTrackLoad, track, tracks, startIndex.toDouble(), intercepted = {}, defaultBehavior = {
549
- // Replace queue and seek to selected track
550
- // Use internal player methods directly to avoid blocking on main thread
551
- player.setQueue(tracks, startIndex, sourcePath = parentPath)
552
- player.play()
553
- })
613
+ handleTrackLoad(
614
+ _configuration.handleTrackLoad,
615
+ track,
616
+ tracks,
617
+ startIndex.toDouble(),
618
+ startPosition = null,
619
+ intercepted = {},
620
+ defaultBehavior = {
621
+ // The Player itself: this class's overrides block on main, where this runs.
622
+ player.setQueue(tracks, startIndex, sourcePath = parentPath)
623
+ player.play()
624
+ },
625
+ )
554
626
  return@launch
555
627
  } else {
556
- // Fallback: just load the single track
557
628
  Timber.w("Queue expansion failed, loading single track")
558
- handleTrackLoad(_configuration.handleTrackLoad, track, arrayOf(track), 0.0, intercepted = {}, defaultBehavior = { player.load(track) })
629
+ handleTrackLoad(
630
+ _configuration.handleTrackLoad,
631
+ track,
632
+ arrayOf(track),
633
+ 0.0,
634
+ startPosition = null,
635
+ intercepted = {},
636
+ defaultBehavior = { player.load(track) },
637
+ )
559
638
  }
560
639
  }
561
- // Navigate to browsable track to show browsing UI
562
- url != null -> {
563
- Timber.d("Navigating to browsable track: $url")
564
- browserManager.navigate(url)
640
+ path != null -> {
641
+ Timber.d("Navigating to browsable track: $path")
642
+ browserManager.navigate(path)
565
643
  }
566
- // If track is playable (has src), load it into player
567
644
  track.src != null -> {
568
645
  Timber.d("Loading playable track into player: ${track.title}")
569
- handleTrackLoad(_configuration.handleTrackLoad, track, arrayOf(track), 0.0, intercepted = {}, defaultBehavior = { player.load(track) })
646
+ handleTrackLoad(
647
+ _configuration.handleTrackLoad,
648
+ track,
649
+ arrayOf(track),
650
+ 0.0,
651
+ startPosition = null,
652
+ intercepted = {},
653
+ defaultBehavior = { player.load(track) },
654
+ )
570
655
  }
571
656
  else -> {
572
- throw IllegalArgumentException("Track must have either an 'url' or an 'src' property")
657
+ throw IllegalArgumentException("Track must have either a 'path' or an 'src' property")
573
658
  }
574
659
  }
575
660
  } catch (e: CancellationException) {
576
- throw e // Rethrow to properly cancel
661
+ throw e
577
662
  } catch (e: Exception) {
578
- handleBrowserException(e, url ?: track.src ?: "", "navigating to track: ${track.title}")
663
+ handleBrowserException(e, path ?: track.src ?: "", "navigating to track: ${track.title}")
579
664
  }
580
665
  }
581
666
  }
582
667
 
583
- override fun onSearch(query: String): Promise<Array<Track>> {
584
- return Promise.async(mainScope) {
668
+ override fun search(query: String): Promise<Array<Track>> {
669
+ return promise {
585
670
  Timber.d("Searching for: $query")
586
- val searchResults = browserManager.search(query)
587
- searchResults.children ?: emptyArray()
671
+ // Rejects with the error a browse would raise but leaves the navigation error unset: a failed
672
+ // search must not replace the displayed page's state (mirrors iOS HybridAudioBrowser.search).
673
+ val searchResults =
674
+ try {
675
+ browserManager.search(query)
676
+ } catch (e: CancellationException) {
677
+ throw e
678
+ } catch (e: Exception) {
679
+ Timber.e(e, "Search failed for query: $query")
680
+ throw NavigationErrorException(navigationErrorFor(e))
681
+ }
682
+ // Not `children`: search builds one untitled section (ADR 0010), so `children` is null.
683
+ searchResults.flattenedChildren?.toTypedArray() ?: emptyArray()
588
684
  }
589
685
  }
590
686
 
@@ -595,65 +691,132 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
595
691
  override fun notifyContentChanged(path: String) {
596
692
  Timber.d("Notifying content changed for path: $path")
597
693
 
598
- // Invalidate cached content so future navigations fetch fresh data
599
694
  browserManager.invalidateContentCache(path)
600
695
 
601
- // Notify external media controllers (Android Auto)
602
- connectedService?.player?.notifyContentChanged(path)
696
+ // MediaSession asserts the main thread; this override runs on the JS thread.
697
+ launchInScope { connectedService?.player?.notifyContentChanged(path) }
603
698
 
604
- // If we're currently viewing this path, refresh the content
605
699
  if (browserManager.getPath() == path) {
606
700
  mainScope.launch { browserManager.refresh() }
607
701
  }
608
702
  }
609
703
 
704
+ override fun invalidateAllContent() {
705
+ Timber.d("Invalidating all content")
706
+
707
+ browserManager.clearContentCache()
708
+
709
+ // MediaSession asserts the main thread; this override runs on the JS thread.
710
+ launchInScope { connectedService?.player?.invalidateAllContent() }
711
+
712
+ mainScope.launch {
713
+ runCatching { browserManager.queryTabs() }
714
+ .onFailure { Timber.e(it, "Re-querying tabs failed") }
715
+ }
716
+ mainScope.launch { browserManager.refresh() }
717
+ }
718
+
610
719
  override fun setFavorites(favorites: Array<String>) {
611
720
  browserManager.setFavorites(favorites.toList())
612
721
  }
613
722
 
723
+ // MARK: Gate
724
+
725
+ /** [chrome] is non-null whenever [gated] is true: the serve sites force-unwrap it. */
726
+ data class GateOutcome(val gated: Boolean, val chrome: Gate?)
727
+
728
+ private val builtInGate = Gate("Unavailable", null)
729
+
730
+ // One volatile reference, so [gateDecision] reads all three fields at once: separate volatiles
731
+ // could tear against [clearGate] into an active gate with no chrome. Written on the JS thread,
732
+ // read on the Media3 application thread.
733
+ private data class GateState(val active: Boolean, val chrome: Gate?, val hasResolver: Boolean)
734
+
735
+ @Volatile private var gateState = GateState(active = false, chrome = null, hasResolver = false)
736
+
737
+ override fun setGate(gate: Gate?, hasResolver: Boolean) {
738
+ gateState = GateState(active = true, chrome = gate, hasResolver = hasResolver)
739
+ // Re-queries every subscribed parent so a connected controller swaps its lists for the gate
740
+ // tile without reconnecting; the content cache stays warm for when the gate clears.
741
+ // MediaSession asserts the main thread; this override runs on the JS thread.
742
+ launchInScope { connectedService?.player?.invalidateAllContent() }
743
+ }
744
+
745
+ override fun clearGate() {
746
+ if (!gateState.active) return
747
+ gateState = GateState(active = false, chrome = null, hasResolver = false)
748
+ // MediaSession asserts the main thread; this override runs on the JS thread.
749
+ launchInScope { connectedService?.player?.invalidateAllContent() }
750
+ }
751
+
752
+ /**
753
+ * Whether [request] is gated, and with which chrome. No active gate allows; a gate without a
754
+ * resolver gates with its stored chrome and never asks JS. A resolver that throws, rejects or
755
+ * times out fails closed, gating rather than serving content; only a successful `gated: false`
756
+ * allows. Chrome falls back from the resolver's to the stored one to [builtInGate]. A caller
757
+ * cancelled while it waits gets the cancellation.
758
+ */
759
+ suspend fun gateDecision(request: NativeGateRequest): GateOutcome {
760
+ val s = gateState
761
+ if (!s.active) return GateOutcome(false, null)
762
+ if (!s.hasResolver) return GateOutcome(true, s.chrome ?: builtInGate)
763
+ val result = runCatching { resolveGate(request).awaitNestedOrTimeout() }
764
+ currentCoroutineContext().ensureActive()
765
+ val decision = result.getOrNull() ?: return GateOutcome(true, s.chrome ?: builtInGate)
766
+ if (!decision.gated) return GateOutcome(false, null)
767
+ return GateOutcome(true, decision.gate ?: s.chrome ?: builtInGate)
768
+ }
769
+
770
+ // MARK: Car connection (Android Auto / Android Automotive)
771
+
772
+ override fun isCarConnected(): Boolean = carConnected
773
+
774
+ override var onCarConnectedChanged: (Boolean) -> Unit = {}
775
+ set(value) {
776
+ field = value
777
+ carConnectionTarget.set(value)
778
+ // The car may have connected before this runtime subscribed (mirrors iOS).
779
+ value(carConnected)
780
+ }
781
+
614
782
  // ============================================================================
615
783
  // MARK: Player Setup and Options
616
784
  // ============================================================================
617
785
 
618
- override fun setupPlayer(options: PartialSetupPlayerOptions): Promise<Unit> {
619
- return Promise.async(mainScope) {
786
+ override fun setupPlayer(options: NativeSetupPlayerOptions): Promise<Unit> {
787
+ return promise {
620
788
  setupOptions.update(options)
789
+ // Staged to apply together with the engine below, or at service connect. Last write wins
790
+ // against the imperative setters.
791
+ options.options?.let { updateOptions.updateFromBridge(it) }
792
+ options.repeatMode?.let { pendingRepeatMode = it }
793
+ options.playWhenReady?.let { pendingPlayWhenReady = it }
621
794
 
622
795
  connectedService?.let {
796
+ it.player.applyOptions(updateOptions)
623
797
  it.player.setup(setupOptions)
624
- return@async
798
+ applyPendingPlayerState(it.player)
799
+ return@promise
625
800
  }
626
801
 
627
- // Service not connected yet, bind to service
628
- suspendCoroutine<Unit> { continuation ->
629
- Timber.d("Binding to AudioBrowserService")
630
- val bound =
631
- context.bindService(
632
- Intent(context, Service::class.java),
633
- this@AudioBrowser,
634
- Context.BIND_AUTO_CREATE,
635
- )
636
-
637
- if (!bound) {
638
- continuation.resumeWithException(
639
- RuntimeException("Failed to bind to AudioBrowserService")
640
- )
641
- } else {
642
- // Service will resolve the promise in onServiceConnected
643
- setupPromise = { continuation.resume(Unit) }
644
- }
802
+ if (!serviceBinding.bind(Intent(context, Service::class.java), this@AudioBrowser)) {
803
+ throw RuntimeException("Failed to bind to AudioBrowserService")
645
804
  }
805
+ connectionReady.await()
646
806
  }
647
807
  }
648
808
 
649
809
  override fun updateOptions(options: NativeUpdateOptions) {
650
810
  updateOptions.updateFromBridge(options)
651
- // Only update the options if the service is around
652
- connectedService?.let { player.applyOptions(updateOptions) }
811
+ // Blocks rather than launches: updateFromBridge mutates the holder in place on the JS thread
812
+ // and applyOptions reads it on main (Media3 asserts main), so blocking keeps the two ordered.
813
+ connectedService?.let { service ->
814
+ runBlockingOnMain { service.player.applyOptions(updateOptions) }
815
+ }
653
816
  }
654
817
 
655
- override fun getOptions(): UpdateOptions {
656
- return player.getOptions().toNitro()
818
+ override fun getOptions(): Options {
819
+ return updateOptions.toNitro()
657
820
  }
658
821
 
659
822
  // ============================================================================
@@ -661,159 +824,200 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
661
824
  // ============================================================================
662
825
 
663
826
  override fun load(track: Track) {
664
- launchInScope { player.load(track) }
827
+ // Throws without a player, as on iOS: a track asked for and silently dropped hides a mistake.
828
+ // Blocks rather than launching, so a track the player refuses fails this call.
829
+ runBlockingOnMain { player.load(track) }
665
830
  }
666
831
 
667
- override fun reset() = runBlockingOnMain {
668
- player.stop()
669
- delay(300) // Allow playback to stop
670
- player.clear()
671
- }
832
+ override fun reset() =
833
+ commandPlayer("reset") { player ->
834
+ player.stop()
835
+ player.clear()
836
+ // clear() while idle emits no engine event, so the state would otherwise stay STOPPED.
837
+ player.setPlaybackState(PlaybackState.NONE)
838
+ }
672
839
 
673
- override fun play() = runBlockingOnMain { player.play() }
840
+ override fun play() = commandPlayer("play") { it.play() }
674
841
 
675
- override fun pause() = runBlockingOnMain { player.pause() }
842
+ override fun pause() = commandPlayer("pause") { it.pause() }
676
843
 
677
- override fun togglePlayback() = runBlockingOnMain { player.togglePlayback() }
844
+ override fun togglePlayback() = commandPlayer("togglePlayback") { it.togglePlayback() }
678
845
 
679
- override fun stop() = runBlockingOnMain { player.stop() }
846
+ override fun stop() = commandPlayer("stop") { it.stop() }
680
847
 
681
848
  override fun setPlayWhenReady(playWhenReady: Boolean) = runBlockingOnMain {
682
- player.playWhenReady = playWhenReady
849
+ connectedService?.player?.let { it.playWhenReady = playWhenReady }
850
+ ?: run { pendingPlayWhenReady = playWhenReady }
683
851
  }
684
852
 
685
- override fun getPlayWhenReady(): Boolean = runBlockingOnMain { player.playWhenReady }
686
-
687
- override fun seekTo(position: Double) = runBlockingOnMain {
688
- player.seekTo((position * 1000).toLong(), TimeUnit.MILLISECONDS)
853
+ override fun getPlayWhenReady(): Boolean = runBlockingOnMain {
854
+ connectedService?.player?.playWhenReady ?: pendingPlayWhenReady ?: false
689
855
  }
690
856
 
691
- override fun seekBy(offset: Double) = runBlockingOnMain {
692
- player.seekBy((offset * 1000).toLong(), TimeUnit.MILLISECONDS)
693
- }
857
+ override fun seekTo(position: Double) =
858
+ commandPlayer("seekTo") { player ->
859
+ player.seekTo((position * 1000).toLong(), TimeUnit.MILLISECONDS)
860
+ }
694
861
 
695
- override fun setVolume(level: Double) = runBlockingOnMain { player.volume = level.toFloat() }
862
+ override fun seekBy(offset: Double) =
863
+ commandPlayer("seekBy") { player ->
864
+ player.seekBy((offset * 1000).toLong(), TimeUnit.MILLISECONDS)
865
+ }
696
866
 
697
- override fun getVolume(): Double = runBlockingOnMain { player.volume.toDouble() }
867
+ override fun seekToLiveEdge() = commandPlayer("seekToLiveEdge") { it.seekToLiveEdge() }
698
868
 
699
- override fun setRate(rate: Double) = runBlockingOnMain { player.playbackSpeed = rate.toFloat() }
869
+ override fun setVolume(level: Double) = commandPlayer("setVolume") { it.volume = level.toFloat() }
700
870
 
701
- override fun getRate(): Double = runBlockingOnMain { player.playbackSpeed.toDouble() }
871
+ override fun getVolume(): Double = readPlayer(1.0) { it.volume.toDouble() }
702
872
 
703
- override fun getProgress(): Progress = runBlockingOnMain {
704
- Progress(
705
- duration = player.duration.toSeconds(),
706
- position = player.position.toSeconds(),
707
- buffered = player.bufferedPosition.toSeconds(),
708
- )
709
- }
873
+ override fun setRate(rate: Double) =
874
+ commandPlayer("setRate") { it.playbackSpeed = rate.toFloat() }
710
875
 
711
- override fun getPlayback(): Playback = runBlockingOnMain { player.getPlayback() }
876
+ override fun getRate(): Double = readPlayer(1.0) { it.playbackSpeed.toDouble() }
712
877
 
713
- override fun getPlayingState(): PlayingState = runBlockingOnMain { player.getPlayingState() }
878
+ override fun getProgress(): Progress =
879
+ readPlayer(Progress(duration = 0.0, position = 0.0, buffered = 0.0)) { player ->
880
+ Progress(
881
+ duration = player.duration.toSeconds(),
882
+ position = player.position.toSeconds(),
883
+ buffered = player.bufferedPosition.toSeconds(),
884
+ )
885
+ }
714
886
 
715
- override fun getRepeatMode(): RepeatMode = runBlockingOnMain { player.repeatMode }
887
+ override fun getPlayback(): Playback =
888
+ readPlayer(Playback(PlaybackState.NONE, null)) { it.getPlayback() }
716
889
 
717
- override fun setRepeatMode(mode: RepeatMode) = runBlockingOnMain { player.repeatMode = mode }
890
+ override fun getPlayingState(): PlayingState =
891
+ readPlayer(PlayingState(playing = false, buffering = false)) { it.getPlayingState() }
718
892
 
719
- override fun getShuffleEnabled(): Boolean = runBlockingOnMain { player.shuffleMode }
893
+ override fun getRepeatMode(): RepeatMode = runBlockingOnMain {
894
+ connectedService?.player?.repeatMode ?: pendingRepeatMode ?: RepeatMode.OFF
895
+ }
720
896
 
721
- override fun setShuffleEnabled(enabled: Boolean) = runBlockingOnMain {
722
- player.shuffleMode = enabled
897
+ override fun setRepeatMode(mode: RepeatMode) = runBlockingOnMain {
898
+ connectedService?.player?.let { it.repeatMode = mode } ?: run { pendingRepeatMode = mode }
723
899
  }
724
900
 
725
- override fun getPlaybackError(): PlaybackError? = runBlockingOnMain { player.playbackError }
901
+ override fun getShuffleEnabled(): Boolean = readPlayer(false) { it.shuffleMode }
902
+
903
+ override fun setShuffleEnabled(enabled: Boolean) =
904
+ commandPlayer("setShuffleEnabled") { player -> player.shuffleMode = enabled }
905
+
906
+ override fun setPlaybackIntervalEnabled(enabled: Boolean) =
907
+ commandPlayer("setPlaybackIntervalEnabled") { player ->
908
+ player.setPlaybackIntervalEnabled(enabled)
909
+ }
910
+
911
+ override fun getPlaybackError(): PlaybackError? = readPlayer(null) { it.playbackError }
726
912
 
727
- override fun retry() = runBlockingOnMain { player.prepare() }
913
+ override fun retry() = commandPlayer("retry") { it.prepare() }
728
914
 
729
915
  // ============================================================================
730
916
  // MARK: Queue Management
731
917
  // ============================================================================
732
918
 
733
- override fun add(tracks: Array<Track>, insertBeforeIndex: Double?) = runBlockingOnMain {
734
- val inputIndex = insertBeforeIndex?.toInt() ?: -1
735
- player.add(tracks, inputIndex)
736
- }
919
+ override fun add(tracks: Array<Track>, insertBeforeIndex: Double?) =
920
+ commandPlayer("add") { player ->
921
+ val inputIndex = insertBeforeIndex?.toInt() ?: -1
922
+ player.add(tracks, inputIndex)
923
+ }
737
924
 
738
- override fun move(fromIndex: Double, toIndex: Double) = runBlockingOnMain {
739
- player.move(fromIndex.toInt(), toIndex.toInt())
740
- }
925
+ override fun move(fromIndex: Double, toIndex: Double) =
926
+ commandPlayer("move") { player -> player.move(fromIndex.toInt(), toIndex.toInt()) }
741
927
 
742
- override fun remove(indexes: DoubleArray) = runBlockingOnMain {
743
- val indexList = indexes.map { it.toInt() }
744
- player.remove(indexList)
745
- }
928
+ override fun remove(indexes: DoubleArray) =
929
+ commandPlayer("remove") { player ->
930
+ val indexList = indexes.map { it.toInt() }
931
+ player.remove(indexList)
932
+ }
746
933
 
747
- override fun removeUpcomingTracks() = runBlockingOnMain { player.removeUpcomingTracks() }
934
+ override fun removeUpcomingTracks() =
935
+ commandPlayer("removeUpcomingTracks") { it.removeUpcomingTracks() }
748
936
 
749
- override fun skip(index: Double, initialPosition: Double?) = runBlockingOnMain {
750
- player.skipTo(index.toInt())
937
+ override fun skip(index: Double, initialPosition: Double?) =
938
+ commandPlayer("skip") { player ->
939
+ player.skipTo(index.toInt())
751
940
 
752
- if (initialPosition != null && initialPosition >= 0) {
753
- player.seekTo((initialPosition * 1000).toLong(), TimeUnit.MILLISECONDS)
941
+ if (initialPosition != null && initialPosition >= 0) {
942
+ player.seekTo((initialPosition * 1000).toLong(), TimeUnit.MILLISECONDS)
943
+ }
754
944
  }
755
- }
756
945
 
757
- override fun skipToNext(initialPosition: Double?) = runBlockingOnMain {
758
- player.next()
946
+ override fun skipToNext(initialPosition: Double?) =
947
+ commandPlayer("skipToNext") { player ->
948
+ player.next()
759
949
 
760
- if (initialPosition != null && initialPosition >= 0) {
761
- player.seekTo((initialPosition * 1000).toLong(), TimeUnit.MILLISECONDS)
950
+ if (initialPosition != null && initialPosition >= 0) {
951
+ player.seekTo((initialPosition * 1000).toLong(), TimeUnit.MILLISECONDS)
952
+ }
762
953
  }
763
- }
764
954
 
765
- override fun skipToPrevious(initialPosition: Double?) = runBlockingOnMain {
766
- player.previous()
955
+ override fun skipToPrevious(initialPosition: Double?) =
956
+ commandPlayer("skipToPrevious") { player ->
957
+ player.previous()
767
958
 
768
- if (initialPosition != null && initialPosition >= 0) {
769
- player.seekTo((initialPosition * 1000).toLong(), TimeUnit.MILLISECONDS)
959
+ if (initialPosition != null && initialPosition >= 0) {
960
+ player.seekTo((initialPosition * 1000).toLong(), TimeUnit.MILLISECONDS)
961
+ }
770
962
  }
771
- }
772
963
 
773
- override fun setQueue(tracks: Array<Track>, startIndex: Double?, startPositionMs: Double?) =
774
- runBlockingOnMain {
775
- player.setQueue(tracks, startIndex?.toInt() ?: 0, startPositionMs?.toLong() ?: 0)
964
+ override fun setQueue(tracks: Array<Track>, startIndex: Double?, startPosition: Double?) =
965
+ commandPlayer("setQueue") { player ->
966
+ player.setQueue(tracks, startIndex?.toInt() ?: 0, ((startPosition ?: 0.0) * 1000).toLong())
776
967
  }
777
968
 
778
- override fun setActiveTrackFavorited(favorited: Boolean) = runBlockingOnMain {
779
- player.setActiveTrackFavorited(favorited)
780
- }
969
+ override fun setActiveTrackFavorited(favorited: Boolean): Unit =
970
+ commandPlayer("setActiveTrackFavorited") { player ->
971
+ // The applied result serves MediaSession; the JS API is fire-and-forget.
972
+ player.setActiveTrackFavorited(favorited)
973
+ }
781
974
 
782
- override fun toggleActiveTrackFavorited() = runBlockingOnMain {
783
- player.toggleActiveTrackFavorited()
784
- }
975
+ override fun toggleActiveTrackFavorited(): Unit =
976
+ commandPlayer("toggleActiveTrackFavorited") { it.toggleActiveTrackFavorited() }
785
977
 
786
- override fun getQueue(): Array<Track> = runBlockingOnMain { player.tracks }
978
+ override fun getQueue(): Array<Track> = readPlayer(emptyArray()) { it.tracks }
787
979
 
788
- override fun getTrack(index: Double): Track? = runBlockingOnMain {
789
- try {
790
- player.getTrack(index.toInt())
791
- } catch (e: IllegalArgumentException) {
792
- null
980
+ override fun getQueueVersion(): Double = readPlayer(-1.0) { it.queueVersion.toDouble() }
981
+
982
+ override fun getTrack(index: Double): Track? =
983
+ readPlayer(null) { player ->
984
+ try {
985
+ player.getTrack(index.toInt())
986
+ } catch (e: IllegalArgumentException) {
987
+ null
988
+ }
793
989
  }
794
- }
795
990
 
796
- override fun getActiveTrackIndex(): Double? = runBlockingOnMain {
797
- player.currentIndex?.toDouble()
798
- }
991
+ override fun getActiveTrackIndex(): Double? = readPlayer(null) { it.currentIndex?.toDouble() }
799
992
 
800
- override fun getActiveTrack(): Track? = runBlockingOnMain { player.currentTrack }
993
+ override fun getActiveTrack(): Track? = readPlayer(null) { it.currentTrack }
801
994
 
802
995
  // ============================================================================
803
996
  // MARK: Now Playing Metadata
804
997
  // ============================================================================
805
998
 
806
- override fun updateNowPlaying(update: NowPlayingUpdate?) = runBlockingOnMain {
807
- player.updateNowPlaying(update)
808
- }
999
+ override fun updateNowPlaying(update: NowPlayingUpdate?) =
1000
+ commandPlayer("updateNowPlaying") { player -> player.nowPlaying.updateNowPlaying(update) }
809
1001
 
810
- override fun getNowPlaying(): NowPlayingMetadata? = runBlockingOnMain { player.getNowPlaying() }
1002
+ override fun flashNowPlaying(update: NowPlayingUpdate, durationMs: Double) =
1003
+ commandPlayer("flashNowPlaying") { player ->
1004
+ player.nowPlaying.flashNowPlaying(update, durationMs)
1005
+ }
1006
+
1007
+ override fun clearNowPlayingFlash() =
1008
+ commandPlayer("clearNowPlayingFlash") { player -> player.nowPlaying.clearNowPlayingFlash() }
1009
+
1010
+ override fun getNowPlaying(): NowPlayingMetadata? =
1011
+ readPlayer(null) { player -> player.nowPlaying.getNowPlaying() }
1012
+
1013
+ override fun getTimedMetadata(): TimedMetadata? =
1014
+ readPlayer(null) { player -> player.nowPlaying.timedMetadata }
811
1015
 
812
1016
  // ============================================================================
813
1017
  // MARK: Network Connectivity
814
1018
  // ============================================================================
815
1019
 
816
- override fun getOnline(): Boolean = runBlockingOnMain { player.getOnline() }
1020
+ override fun getOnline(): Boolean = readPlayer(true) { it.getOnline() }
817
1021
 
818
1022
  // ============================================================================
819
1023
  // MARK: System Volume
@@ -824,61 +1028,58 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
824
1028
  override fun setSystemVolume(volume: Double) = systemVolumeMonitor.setVolume(volume)
825
1029
 
826
1030
  // ============================================================================
827
- // MARK: External Audio Output (iOS only, stub on Android)
1031
+ // MARK: External Audio Output
828
1032
  // ============================================================================
829
1033
 
830
- override fun getIosOutput(): IosOutput? = null
1034
+ override fun getOutput(): Output? = outputMonitor.current
1035
+
1036
+ override fun supportsOutputSwitcher(): Boolean = OutputSwitcher.isSupported()
831
1037
 
832
- override fun openIosOutputPicker() {
833
- // No-op on Android
1038
+ override fun openOutputPicker() {
1039
+ OutputSwitcher.open(context)
834
1040
  }
835
1041
 
836
1042
  // ============================================================================
837
1043
  // MARK: Equalizer (Android only)
838
1044
  // ============================================================================
839
1045
 
840
- override fun getEqualizerSettings(): EqualizerSettings? = runBlockingOnMain {
841
- player.getEqualizerSettings()
842
- }
1046
+ override fun getEqualizerSettings(): EqualizerSettings? =
1047
+ readPlayer(null) { player -> player.equalizer.getSettings() }
843
1048
 
844
- override fun setEqualizerEnabled(enabled: Boolean) = runBlockingOnMain {
845
- player.setEqualizerEnabled(enabled)
846
- }
1049
+ override fun setEqualizerEnabled(enabled: Boolean) =
1050
+ commandPlayer("setEqualizerEnabled") { player -> player.equalizer.setEnabled(enabled) }
847
1051
 
848
- override fun setEqualizerPreset(preset: String) = runBlockingOnMain {
849
- player.setEqualizerPreset(preset)
850
- }
1052
+ override fun setEqualizerPreset(preset: String) =
1053
+ commandPlayer("setEqualizerPreset") { player -> player.equalizer.setPreset(preset) }
851
1054
 
852
- override fun setEqualizerLevels(levels: DoubleArray) = runBlockingOnMain {
853
- player.setEqualizerLevels(levels)
854
- }
1055
+ override fun setEqualizerLevels(levels: DoubleArray) =
1056
+ commandPlayer("setEqualizerLevels") { player -> player.equalizer.setLevels(levels) }
855
1057
 
856
1058
  // ============================================================================
857
1059
  // MARK: Sleep Timer
858
1060
  // ============================================================================
859
1061
 
860
- override fun getSleepTimer(): SleepTimer = runBlockingOnMain { player.getSleepTimer() }
1062
+ override fun getSleepTimer(): SleepTimer =
1063
+ readPlayer(SleepTimer.create(NullType.NULL)) { it.sleepTimer.get() }
861
1064
 
862
- override fun setSleepTimer(seconds: Double) = runBlockingOnMain { player.setSleepTimer(seconds) }
1065
+ override fun setSleepTimer(seconds: Double, fadeDuration: Double?) =
1066
+ commandPlayer("setSleepTimer") { player -> player.sleepTimer.setAfter(seconds, fadeDuration) }
863
1067
 
864
- override fun setSleepTimerToEndOfTrack() = runBlockingOnMain {
865
- player.setSleepTimerToEndOfTrack()
866
- }
1068
+ override fun setSleepTimerToEndOfTrack() =
1069
+ commandPlayer("setSleepTimerToEndOfTrack") { it.sleepTimer.setEndOfTrack() }
867
1070
 
868
- override fun clearSleepTimer(): Boolean = runBlockingOnMain { player.clearSleepTimer() }
1071
+ override fun clearSleepTimer(): Boolean = readPlayer(false) { it.sleepTimer.clear() }
869
1072
 
870
1073
  // ============================================================================
871
1074
  // MARK: Battery Optimization (Android only)
872
1075
  // ============================================================================
873
1076
 
874
- /** Track last known status for change detection */
875
1077
  private var lastKnownBatteryStatus: BatteryOptimizationHelper.Status? = null
876
1078
 
877
1079
  override fun getBatteryWarningPending(): Boolean {
878
1080
  val rawPending = BatteryWarningStore.isWarningPending(context)
879
1081
  val status = BatteryOptimizationHelper.getStatus(context)
880
1082
 
881
- // Auto-clear if status is now unrestricted
882
1083
  return if (rawPending && status == BatteryOptimizationHelper.Status.UNRESTRICTED) {
883
1084
  BatteryWarningStore.clearWarning(context)
884
1085
  post { onBatteryWarningPendingChanged(BatteryWarningPendingChangedEvent(false)) }
@@ -901,10 +1102,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
901
1102
  BatteryOptimizationHelper.openSettings(context)
902
1103
  }
903
1104
 
904
- /**
905
- * Check if battery status changed since last check and fire events if so. Called automatically
906
- * when app comes to foreground via ProcessLifecycleOwner.
907
- */
908
1105
  private fun checkBatteryStatusChange() {
909
1106
  val currentStatus = BatteryOptimizationHelper.getStatus(context)
910
1107
  if (lastKnownBatteryStatus != null && lastKnownBatteryStatus != currentStatus) {
@@ -914,7 +1111,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
914
1111
  )
915
1112
  }
916
1113
 
917
- // Auto-clear warning if now unrestricted
918
1114
  if (
919
1115
  currentStatus == BatteryOptimizationHelper.Status.UNRESTRICTED &&
920
1116
  BatteryWarningStore.isWarningPending(context)
@@ -945,32 +1141,32 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
945
1141
  player.setCallbacks(callbacks)
946
1142
  player.applyOptions(updateOptions)
947
1143
  player.setup(setupOptions)
948
- // Start observing network connectivity changes
1144
+ applyPendingPlayerState(player)
949
1145
  player.observeNetworkConnectivity(mainScope)
950
- // Set browser reference for media URL transformation
951
1146
  player.browser = this@AudioBrowser
952
1147
 
953
- // If configuration was already set before service connected,
954
- // notify player now so Android Auto can start browsing
955
- if (_configuration.routes?.isNotEmpty() == true) {
956
- player.notifyBrowserConfigurationReady()
957
- }
1148
+ // The configuration setter's notify finds no service when it runs before connect.
1149
+ if (isConfigured) player.notifyBrowserConfigurationReady()
958
1150
  }
959
1151
 
960
- // Wire up battery warning callback from service
961
- connectedService?.onBatteryWarningPendingChanged = { pending ->
962
- post {
963
- this@AudioBrowser.onBatteryWarningPendingChanged(
964
- BatteryWarningPendingChangedEvent(pending)
965
- )
966
- }
967
- }
1152
+ connectedService?.onBatteryWarningPendingChanged = onBatteryWarningPending
968
1153
 
969
1154
  val sessionToken = SessionToken(context, ComponentName(context, Service::class.java))
970
1155
  mediaBrowserFuture = MediaBrowser.Builder(context, sessionToken).buildAsync()
971
1156
 
972
- setupPromise?.invoke(Unit)
973
- setupPromise = null
1157
+ connectionReady.complete(Unit)
1158
+ }
1159
+ }
1160
+
1161
+ // Consumes what it applies, so a later re-setup does not replay stale state.
1162
+ private fun applyPendingPlayerState(player: Player) {
1163
+ pendingRepeatMode?.let {
1164
+ player.repeatMode = it
1165
+ pendingRepeatMode = null
1166
+ }
1167
+ pendingPlayWhenReady?.let {
1168
+ player.applySetupPlayWhenReady(it)
1169
+ pendingPlayWhenReady = null
974
1170
  }
975
1171
  }
976
1172
 
@@ -978,17 +1174,36 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
978
1174
  mainScope.coroutineContext.cancelChildren()
979
1175
  mediaBrowserFuture = null
980
1176
  connectedService = null
1177
+ connectionReady = CompletableDeferred()
981
1178
  Timber.d("AudioBrowser.onServiceDisconnected()")
982
1179
  }
983
1180
 
1181
+ // Android never reconnects a dead binding: release it so the next setupPlayer binds afresh.
1182
+ override fun onBindingDied(name: ComponentName) = dropDeadBinding()
1183
+
1184
+ override fun onNullBinding(name: ComponentName) = dropDeadBinding()
1185
+
1186
+ private fun dropDeadBinding() {
1187
+ serviceBinding.unbind(this)
1188
+ connectionReady.completeExceptionally(IllegalStateException("AudioBrowserService binding died"))
1189
+ connectionReady = CompletableDeferred()
1190
+ }
1191
+
984
1192
  // ============================================================================
985
1193
  // MARK: Internal Helpers
986
1194
  // ============================================================================
987
1195
 
1196
+ private fun <T> promise(run: suspend () -> T): Promise<T> {
1197
+ val promise = Promise<T>()
1198
+ mainScope.launchSettled({ it.fold(promise::resolve, promise::reject) }, run)
1199
+ return promise
1200
+ }
1201
+
988
1202
  private fun launchInScope(block: suspend () -> Unit) {
989
1203
  mainScope.launch { block() }
990
1204
  }
991
1205
 
1206
+ // For calls arriving on the JS thread: called on main it waits on itself and deadlocks.
992
1207
  private fun <T> runBlockingOnMain(block: suspend () -> T): T {
993
1208
  return runBlocking(mainScope.coroutineContext) { block() }
994
1209
  }
@@ -996,6 +1211,25 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
996
1211
  private val service: Service
997
1212
  get() = connectedService ?: throw Exception("Player not initialized")
998
1213
 
1214
+ private val connectedPlayer: Player?
1215
+ get() = connectedService?.player
1216
+
1217
+ /** What [read] gets from the player, or without one [fallback], the answer iOS gives then. */
1218
+ private fun <T> readPlayer(fallback: T, read: suspend (Player) -> T): T = runBlockingOnMain {
1219
+ val player = connectedPlayer ?: return@runBlockingOnMain fallback
1220
+ read(player)
1221
+ }
1222
+
1223
+ /** Runs [command] on the player; without one it is dropped with a warning, as iOS drops it. */
1224
+ private fun commandPlayer(name: String, command: suspend (Player) -> Unit) = runBlockingOnMain {
1225
+ val player = connectedPlayer
1226
+ if (player == null) {
1227
+ Timber.w("$name before the player is set up, or while its service restarts: ignored")
1228
+ } else {
1229
+ command(player)
1230
+ }
1231
+ }
1232
+
999
1233
  internal val player
1000
1234
  get() = service.player
1001
1235
 
@@ -1017,6 +1251,10 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
1017
1251
  post { this@AudioBrowser.onPlaybackProgressUpdated(event) }
1018
1252
  }
1019
1253
 
1254
+ override fun onPlaybackInterval() {
1255
+ post { this@AudioBrowser.onPlaybackInterval() }
1256
+ }
1257
+
1020
1258
  override fun onPlaybackPlayWhenReadyChanged(event: PlaybackPlayWhenReadyChangedEvent) {
1021
1259
  post { this@AudioBrowser.onPlaybackPlayWhenReadyChanged(event) }
1022
1260
  }
@@ -1069,7 +1307,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
1069
1307
  true
1070
1308
  } ?: false
1071
1309
 
1072
- // Defer notification until after play operation completes
1073
1310
  post { this@AudioBrowser.onRemotePlay() }
1074
1311
 
1075
1312
  return handled
@@ -1082,7 +1319,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
1082
1319
  true
1083
1320
  } ?: false
1084
1321
 
1085
- // Defer notification until after pause operation completes
1086
1322
  post { this@AudioBrowser.onRemotePause() }
1087
1323
 
1088
1324
  return handled
@@ -1095,7 +1331,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
1095
1331
  true
1096
1332
  } ?: false
1097
1333
 
1098
- // Defer notification until after stop operation completes
1099
1334
  post { this@AudioBrowser.onRemoteStop() }
1100
1335
 
1101
1336
  return handled
@@ -1108,7 +1343,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
1108
1343
  true
1109
1344
  } ?: false
1110
1345
 
1111
- // Defer notification until after next operation completes
1112
1346
  post { this@AudioBrowser.onRemoteNext() }
1113
1347
 
1114
1348
  return handled
@@ -1121,7 +1355,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
1121
1355
  true
1122
1356
  } ?: false
1123
1357
 
1124
- // Defer notification until after previous operation completes
1125
1358
  post { this@AudioBrowser.onRemotePrevious() }
1126
1359
 
1127
1360
  return handled
@@ -1134,7 +1367,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
1134
1367
  true
1135
1368
  } ?: false
1136
1369
 
1137
- // Defer notification until after jump forward operation completes
1138
1370
  post { this@AudioBrowser.onRemoteJumpForward(event) }
1139
1371
 
1140
1372
  return handled
@@ -1147,7 +1379,6 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
1147
1379
  true
1148
1380
  } ?: false
1149
1381
 
1150
- // Defer notification until after jump backward operation completes
1151
1382
  post { this@AudioBrowser.onRemoteJumpBackward(event) }
1152
1383
 
1153
1384
  return handled
@@ -1160,18 +1391,13 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
1160
1391
  true
1161
1392
  } ?: false
1162
1393
 
1163
- // Defer notification until after seek operation completes
1164
1394
  post { this@AudioBrowser.onRemoteSeek(event) }
1165
1395
 
1166
1396
  return handled
1167
1397
  }
1168
1398
 
1169
- override fun onRemoteSetRating(event: RemoteSetRatingEvent) {
1170
- post { this@AudioBrowser.onRemoteSetRating(event) }
1171
- }
1172
-
1173
1399
  override fun onOptionsChanged(options: PlayerUpdateOptions) {
1174
- // Not currently emitted to JS
1400
+ post { this@AudioBrowser.onOptionsChanged(options.toNitro()) }
1175
1401
  }
1176
1402
 
1177
1403
  override fun onFavoriteChanged(event: FavoriteChangedEvent) {
@@ -1194,4 +1420,191 @@ class AudioBrowser : HybridAudioBrowserSpec(), ServiceConnection {
1194
1420
  post { this@AudioBrowser.onSleepTimerChanged(timer) }
1195
1421
  }
1196
1422
  }
1423
+
1424
+ companion object {
1425
+ // Process-wide, from androidx.car.app CarConnection, observed once per process: instances are
1426
+ // re-created on each JS reload, and a per-instance observeForever would leak each one. The
1427
+ // latest instance's callback is the single target (mirrors iOS).
1428
+ @Volatile private var carConnected = false
1429
+ // Compare-and-set, not @Volatile: a disposing instance clears the slot only if it still owns
1430
+ // it, and a replacement may be claiming it at the same moment.
1431
+ private val carConnectionTarget = AtomicReference<((Boolean) -> Unit)?>(null)
1432
+ private var carConnectionObserverStarted = false
1433
+
1434
+ // The instance the current JS runtime uses: Nitro keeps no registry for teardown to find it in.
1435
+ private val current = AtomicReference<AudioBrowser?>(null)
1436
+
1437
+ /** Called by [AudioBrowserLifecycleModule] when the React instance is torn down. */
1438
+ internal fun disposeCurrent() {
1439
+ current.getAndSet(null)?.dispose()
1440
+ }
1441
+
1442
+ private val defaultResolveGate: (NativeGateRequest) -> Promise<Promise<GateDecision>> = {
1443
+ Promise.resolved(Promise.resolved(GateDecision(gated = true, gate = null)))
1444
+ }
1445
+
1446
+ private fun startCarConnectionObserver(context: Context, handler: Handler) {
1447
+ // LiveData observation is main-thread only, which also keeps the start guard on one thread.
1448
+ handler.post {
1449
+ if (carConnectionObserverStarted) return@post
1450
+ carConnectionObserverStarted = true
1451
+ CarConnection(context.applicationContext).type.observeForever { type ->
1452
+ val connected = type != CarConnection.CONNECTION_TYPE_NOT_CONNECTED
1453
+ if (connected == carConnected) return@observeForever
1454
+ carConnected = connected
1455
+ carConnectionTarget.get()?.invoke(connected)
1456
+ }
1457
+ }
1458
+ }
1459
+ }
1460
+ }
1461
+
1462
+ // MARK: Deep JS-callback stripping (used by dispose)
1463
+ // A JS function field added at any level of the config must be nulled by its type's strip.
1464
+
1465
+ private fun NativeBrowserConfiguration.strippingJSCallbacks() =
1466
+ copy(
1467
+ requestResolver = null,
1468
+ browseResolver = null,
1469
+ handleTrackLoad = null,
1470
+ viewMoreTitle = null,
1471
+ resolveAlbumPath = null,
1472
+ formatNavigationError = null,
1473
+ request = request?.strippingJSCallbacks(),
1474
+ browse = browse?.strippingJSCallbacks(),
1475
+ media = media?.strippingJSCallbacks(),
1476
+ artwork = artwork?.strippingJSCallbacks(),
1477
+ nowPlayingArtwork = nowPlayingArtwork?.strippingJSCallbacks(),
1478
+ routes = routes?.map { it.strippingJSCallbacks() }?.toTypedArray(),
1479
+ )
1480
+
1481
+ private fun TransformableRequestConfig.strippingJSCallbacks() =
1482
+ copy(transform = null, transformSync = null)
1483
+
1484
+ private fun MediaRequestConfig.strippingJSCallbacks() =
1485
+ copy(resolve = null, resolveSync = null, transform = null, transformSync = null)
1486
+
1487
+ private fun ArtworkRequestConfig.strippingJSCallbacks() =
1488
+ copy(resolve = null, resolveSync = null, transform = null, transformSync = null)
1489
+
1490
+ private fun NativeRouteEntry.strippingJSCallbacks() =
1491
+ copy(
1492
+ browseCallback = null,
1493
+ browseConfig = browseConfig?.strippingJSCallbacks(),
1494
+ searchCallback = null,
1495
+ searchConfig = searchConfig?.strippingJSCallbacks(),
1496
+ media = media?.strippingJSCallbacks(),
1497
+ artwork = artwork?.strippingJSCallbacks(),
1498
+ )
1499
+
1500
+ /**
1501
+ * The navigation error [e] raises, shared by failed navigations, the rejection
1502
+ * [AudioBrowser.search] hands JS and the Android Auto browse-error tile, so one failure is named
1503
+ * one way wherever it surfaces.
1504
+ */
1505
+ internal fun navigationErrorFor(e: Exception): NavigationError =
1506
+ when (e) {
1507
+ is HttpStatusException ->
1508
+ NavigationError(
1509
+ NavigationErrorType.HTTP_ERROR,
1510
+ e.message ?: "Server error",
1511
+ e.statusCode.toDouble(),
1512
+ e.statusCode in 200..299,
1513
+ )
1514
+ is NetworkException ->
1515
+ NavigationError(
1516
+ NavigationErrorType.NETWORK_ERROR,
1517
+ e.message ?: "Network request failed",
1518
+ null,
1519
+ null,
1520
+ )
1521
+ is ContentNotFoundException ->
1522
+ NavigationError(
1523
+ NavigationErrorType.CONTENT_NOT_FOUND,
1524
+ e.message ?: "Content not found",
1525
+ null,
1526
+ null,
1527
+ )
1528
+ is CallbackException ->
1529
+ NavigationError(
1530
+ NavigationErrorType.CALLBACK_ERROR,
1531
+ e.message ?: "An error occurred",
1532
+ null,
1533
+ null,
1534
+ )
1535
+ else ->
1536
+ NavigationError(
1537
+ NavigationErrorType.UNKNOWN_ERROR,
1538
+ e.message ?: "An unexpected error occurred",
1539
+ null,
1540
+ null,
1541
+ )
1542
+ }
1543
+
1544
+ /** Carries a [NavigationError] across a rejected Promise, whose JS error keeps its message. */
1545
+ class NavigationErrorException(val error: NavigationError) : Exception(error.message)
1546
+
1547
+ /** The built-in display copy for [error], and the fallback when the app's formatter fails. */
1548
+ internal fun defaultFormattedError(error: NavigationError): FormattedNavigationError {
1549
+ val title =
1550
+ when (error.code) {
1551
+ NavigationErrorType.CONTENT_NOT_FOUND -> "Content Not Found"
1552
+ NavigationErrorType.NETWORK_ERROR -> "Network Error"
1553
+ NavigationErrorType.HTTP_ERROR -> {
1554
+ error.statusCode?.let { httpStatusText(it.toInt()) } ?: "Server Error"
1555
+ }
1556
+ NavigationErrorType.CALLBACK_ERROR -> "Error"
1557
+ NavigationErrorType.UNKNOWN_ERROR -> "Error"
1558
+ // Not a failure: a container that resolved with no children (ADR 0001).
1559
+ NavigationErrorType.EMPTY_CONTENT -> "Nothing here"
1560
+ NavigationErrorType.TIMEOUT -> "Couldn't load"
1561
+ }
1562
+ // An empty message is omitted so it renders title-only.
1563
+ return FormattedNavigationError(title, error.message.takeIf { it.isNotEmpty() })
1564
+ }
1565
+
1566
+ /** The app's formatted error from [format], or [default] when it returns null or throws. */
1567
+ internal suspend fun formattedOrDefault(
1568
+ default: FormattedNavigationError,
1569
+ format: suspend () -> FormattedNavigationError?,
1570
+ ): FormattedNavigationError =
1571
+ try {
1572
+ format()
1573
+ } catch (e: CancellationException) {
1574
+ throw e
1575
+ } catch (e: Exception) {
1576
+ null
1577
+ } ?: default
1578
+
1579
+ /**
1580
+ * Runs [run] in this scope and hands its outcome to [settle] once. Unlike Nitro's `Promise.async`,
1581
+ * a scope cancelled before [run] starts still settles, with the cancellation, and [run] never runs.
1582
+ */
1583
+ @OptIn(DelicateCoroutinesApi::class)
1584
+ internal fun <T> CoroutineScope.launchSettled(settle: (Result<T>) -> Unit, run: suspend () -> T) {
1585
+ launch(start = CoroutineStart.ATOMIC) {
1586
+ settle(
1587
+ runCatching {
1588
+ ensureActive()
1589
+ run()
1590
+ }
1591
+ )
1592
+ }
1593
+ }
1594
+
1595
+ private fun httpStatusText(statusCode: Int): String {
1596
+ return when (statusCode) {
1597
+ 400 -> "Bad Request"
1598
+ 401 -> "Unauthorized"
1599
+ 403 -> "Forbidden"
1600
+ 404 -> "Not Found"
1601
+ 405 -> "Method Not Allowed"
1602
+ 408 -> "Request Timeout"
1603
+ 429 -> "Too Many Requests"
1604
+ 500 -> "Internal Server Error"
1605
+ 502 -> "Bad Gateway"
1606
+ 503 -> "Service Unavailable"
1607
+ 504 -> "Gateway Timeout"
1608
+ else -> "Server Error"
1609
+ }
1197
1610
  }