react-native-audio-browser 0.2.0-next.8 → 0.2.0-next.80

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