react-native-audio-browser 0.2.0-next.9 → 0.2.0-next.91

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 (1275) hide show
  1. package/AudioBrowser.podspec +1 -1
  2. package/README.md +68 -39
  3. package/android/build.gradle +53 -14
  4. package/android/gradle.properties +3 -3
  5. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  6. package/android/src/main/AndroidManifest.xml +14 -1
  7. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +582 -456
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  9. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  10. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  11. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  12. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  13. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +222 -0
  14. package/android/src/main/java/com/audiobrowser/Service.kt +101 -104
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +15 -17
  16. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  17. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +358 -541
  19. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +36 -66
  20. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  21. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  22. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  23. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  24. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -28
  25. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  26. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  27. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +12 -19
  28. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  29. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  30. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  31. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  32. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  33. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  34. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +28 -42
  35. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  36. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  37. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  38. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  39. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +92 -49
  40. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  41. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  42. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  43. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  44. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  45. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +113 -50
  46. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  47. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  48. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +75 -65
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +600 -345
  50. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  51. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +110 -116
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +62 -38
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +119 -132
  55. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  56. package/android/src/main/java/com/audiobrowser/player/Player.kt +686 -600
  57. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  58. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +18 -28
  59. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +171 -178
  60. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +96 -0
  61. package/android/src/main/java/com/audiobrowser/player/RetryFocus.kt +126 -0
  62. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +65 -210
  63. package/android/src/main/java/com/audiobrowser/player/RetryLocks.kt +52 -0
  64. package/android/src/main/java/com/audiobrowser/player/RetryLoop.kt +310 -0
  65. package/android/src/main/java/com/audiobrowser/player/RetryView.kt +31 -0
  66. package/android/src/main/java/com/audiobrowser/player/SessionViewListener.kt +168 -0
  67. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  68. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  69. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  70. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  71. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  72. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  73. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  74. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +104 -0
  75. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  76. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  77. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +742 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +203 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  90. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  91. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  92. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  93. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  94. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  95. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  96. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  97. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  98. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  99. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  100. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  101. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  102. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  103. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  104. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  105. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  106. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  107. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  108. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  109. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  110. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  111. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  112. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  113. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  114. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +25 -56
  115. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  116. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  117. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  118. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  119. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  120. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  121. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  122. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  123. package/android/src/main/res/values/strings.xml +25 -5
  124. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  125. package/android/src/test/java/androidx/media3/session/SessionViews.kt +38 -0
  126. package/android/src/test/java/com/audiobrowser/AudioFixtures.kt +32 -0
  127. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  128. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  129. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  130. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +90 -0
  131. package/android/src/test/java/com/audiobrowser/NetworkFixtures.kt +25 -0
  132. package/android/src/test/java/com/audiobrowser/RemoteOutputRoutesTest.kt +29 -0
  133. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +81 -0
  134. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  135. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +24 -4
  136. package/android/src/test/java/com/audiobrowser/ServiceFixtures.kt +48 -0
  137. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +290 -0
  138. package/android/src/test/java/com/audiobrowser/SessionPositionUpdatesTest.kt +114 -0
  139. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  140. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  141. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  142. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  143. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  144. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  145. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  146. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  147. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  148. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  149. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  150. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  151. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  152. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  153. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +44 -0
  154. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  155. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  156. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  157. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  158. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  159. package/android/src/test/java/com/audiobrowser/player/AutomaticBufferManagerTest.kt +208 -0
  160. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  161. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  162. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  163. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  164. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  165. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  166. package/android/src/test/java/com/audiobrowser/player/HandleTrackLoadSeekTest.kt +243 -0
  167. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  168. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +316 -0
  169. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  170. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  171. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  172. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  173. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  174. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  175. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  176. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  178. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  179. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  180. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  181. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  182. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  183. package/android/src/test/java/com/audiobrowser/player/PlayerRemoteOutputsSeekTest.kt +105 -0
  184. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +607 -0
  185. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +195 -0
  186. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  187. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  188. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  189. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +354 -0
  190. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +222 -0
  191. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  192. package/android/src/test/java/com/audiobrowser/player/RetryFocusTest.kt +97 -0
  193. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +93 -200
  194. package/android/src/test/java/com/audiobrowser/player/RetryLocksTest.kt +48 -0
  195. package/android/src/test/java/com/audiobrowser/player/RetryLoopCaseTest.kt +181 -0
  196. package/android/src/test/java/com/audiobrowser/player/RetryLoopTest.kt +221 -0
  197. package/android/src/test/java/com/audiobrowser/player/RetryMaskingTest.kt +178 -0
  198. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +212 -0
  199. package/android/src/test/java/com/audiobrowser/player/SessionViewListenerTest.kt +225 -0
  200. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  201. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +234 -0
  202. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  203. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  204. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  205. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +309 -0
  206. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  207. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  208. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  209. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1037 -0
  210. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  211. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  212. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  213. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  214. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  215. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  216. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  217. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  218. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +199 -0
  219. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  220. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  221. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  222. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  223. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  224. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  225. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  226. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  227. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  228. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  229. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  230. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  231. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  232. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  233. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  234. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  235. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  236. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +108 -0
  237. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  238. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  239. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  240. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  241. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  242. package/android/src/test/resources/sonos/device_description.xml +78 -0
  243. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  244. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  245. package/ios/AVPlayerEngine.swift +363 -0
  246. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  247. package/ios/Browser/BrowseGate.swift +70 -0
  248. package/ios/Browser/BrowserConfig.swift +123 -104
  249. package/ios/Browser/BrowserError.swift +15 -0
  250. package/ios/Browser/BrowserManager.swift +153 -675
  251. package/ios/Browser/BrowserPathHelper.swift +54 -117
  252. package/ios/Browser/FavoriteSet.swift +43 -0
  253. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  254. package/ios/Browser/JsonModels.swift +244 -335
  255. package/ios/Browser/NavigationErrorState.swift +42 -0
  256. package/ios/Browser/PageResolver.swift +132 -0
  257. package/ios/Browser/RequestLayer.swift +185 -0
  258. package/ios/Browser/RequestPipeline.swift +295 -0
  259. package/ios/Browser/SearchDrillIn.swift +10 -16
  260. package/ios/Browser/SectionScope.swift +73 -26
  261. package/ios/Browser/SimpleRouter.swift +76 -154
  262. package/ios/Browser/StyleResolver.swift +41 -0
  263. package/ios/Browser/TabBarEntries.swift +8 -7
  264. package/ios/Browser/TrackIdTemplate.swift +29 -0
  265. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  266. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  267. package/ios/CarPlay/CarPlayController.swift +37 -1297
  268. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  269. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  270. package/ios/CarPlay/CarPlayNowPlayingManager.swift +147 -218
  271. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  272. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  273. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  274. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  275. package/ios/CarPlay/CarPlaySession.swift +203 -0
  276. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  277. package/ios/CarPlay/IntentHandlers.swift +94 -0
  278. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  279. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +15 -17
  280. package/ios/CarPlay/MediaIntentPlayback.swift +86 -0
  281. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  282. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  283. package/ios/CarPlay/SectionPresentation.swift +67 -0
  284. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  285. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  286. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  287. package/ios/Extension/CxxVectorConformances.swift +4 -16
  288. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  289. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  290. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  291. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  292. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  293. package/ios/Extension/SearchParams+Query.swift +28 -0
  294. package/ios/Extension/Section+Copying.swift +26 -0
  295. package/ios/Extension/String+IcyCharset.swift +21 -0
  296. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  297. package/ios/Extension/Track+AVPlayer.swift +1 -18
  298. package/ios/Extension/Track+Copying.swift +13 -21
  299. package/ios/Extension/Track+Identity.swift +20 -0
  300. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  301. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  302. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  303. package/ios/Extension/URLError+Connectivity.swift +15 -0
  304. package/ios/Extension/Variant+Artwork.swift +8 -22
  305. package/ios/Http/HttpClient.swift +73 -167
  306. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  307. package/ios/HybridAudioBrowser+Options.swift +116 -0
  308. package/ios/HybridAudioBrowser+Player.swift +347 -0
  309. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  310. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  311. package/ios/HybridAudioBrowser.swift +147 -1718
  312. package/ios/Model/NitroTypeStubs.swift +266 -32
  313. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  314. package/ios/Model/RemoteCommand.swift +6 -78
  315. package/ios/Model/TrackPlayerError.swift +12 -21
  316. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  317. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  318. package/ios/Observer/ItemObserver.swift +92 -0
  319. package/ios/Observer/PlayerObserver.swift +59 -0
  320. package/ios/Option/SessionCategories.swift +41 -92
  321. package/ios/PlaybackEvent.swift +4 -2
  322. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  323. package/ios/Player/AudioSessionController.swift +190 -0
  324. package/ios/Player/DeferredSeek.swift +73 -0
  325. package/ios/Player/ErrorStatus.swift +56 -0
  326. package/ios/Player/MediaLoader.swift +73 -98
  327. package/ios/Player/NowPlayingLines.swift +49 -0
  328. package/ios/Player/NowPlayingUpdater.swift +180 -105
  329. package/ios/Player/PersistedPlaybackState.swift +1 -2
  330. package/ios/Player/PlaybackFailure.swift +121 -0
  331. package/ios/Player/PlaybackPersistence.swift +72 -0
  332. package/ios/Player/PlaybackStateMachine.swift +15 -14
  333. package/ios/Player/PlaybackTimer.swift +11 -8
  334. package/ios/Player/Player.swift +1030 -0
  335. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  336. package/ios/Player/PlayerEngine.swift +109 -0
  337. package/ios/Player/PlayerStatusTypes.swift +1 -6
  338. package/ios/Player/QueueManager.swift +80 -98
  339. package/ios/Player/ReconnectPacer.swift +83 -0
  340. package/ios/Player/RetryLoop.swift +374 -0
  341. package/ios/Player/ShuffleOrder.swift +36 -43
  342. package/ios/Player/SilenceBudget.swift +78 -0
  343. package/ios/Player/SleepTimerManager.swift +25 -42
  344. package/ios/Player/VolumeFader.swift +20 -15
  345. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  346. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  347. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  348. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  349. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  350. package/ios/Tests/BrowseGateTests.swift +50 -0
  351. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  352. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  353. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  354. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  355. package/ios/Tests/ConnectivityTests.swift +13 -0
  356. package/ios/Tests/DeferredSeekTests.swift +76 -0
  357. package/ios/Tests/EmitterTests.swift +22 -39
  358. package/ios/Tests/ErrorStatusTests.swift +50 -0
  359. package/ios/Tests/FavoriteSetTests.swift +61 -0
  360. package/ios/Tests/GenerationMemoTests.swift +178 -0
  361. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  362. package/ios/Tests/JsonModelsTests.swift +189 -3
  363. package/ios/Tests/LRUCacheTests.swift +106 -0
  364. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  365. package/ios/Tests/MediaIntentDeadlineTests.swift +75 -0
  366. package/ios/Tests/MediaLoaderTests.swift +38 -78
  367. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  368. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  369. package/ios/Tests/ObserverTests.swift +88 -0
  370. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  371. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  372. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  373. package/ios/Tests/PlaybackStateMachineTests.swift +7 -22
  374. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  375. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  376. package/ios/Tests/PlayerPolicyTests.swift +1386 -0
  377. package/ios/Tests/PlayerTests.swift +1677 -0
  378. package/ios/Tests/PlayingStateTests.swift +41 -0
  379. package/ios/Tests/QueueManagerTests.swift +205 -174
  380. package/ios/Tests/ReadyValueTests.swift +73 -0
  381. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  382. package/ios/Tests/RequestLayerTests.swift +228 -0
  383. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  384. package/ios/Tests/RetryCaseTests.swift +146 -0
  385. package/ios/Tests/RetryLoopTests.swift +486 -0
  386. package/ios/Tests/SearchDrillInTests.swift +16 -17
  387. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  388. package/ios/Tests/SectionPresentationTests.swift +85 -0
  389. package/ios/Tests/SectionScopeTests.swift +136 -54
  390. package/ios/Tests/SimpleRouterTests.swift +39 -8
  391. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  392. package/ios/Tests/StyleResolverTests.swift +123 -0
  393. package/ios/Tests/SupersedingTaskTests.swift +148 -0
  394. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  395. package/ios/Tests/Support/TestTypes.swift +236 -93
  396. package/ios/Tests/Support/TimeLimit.swift +43 -0
  397. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  398. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  399. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  400. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  401. package/ios/Tests/TrackIdentityTests.swift +20 -0
  402. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  403. package/ios/Tests/TrackSelectorTests.swift +157 -34
  404. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  405. package/ios/TrackSelector.swift +67 -77
  406. package/ios/Util/ArtworkFreshness.swift +42 -0
  407. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  408. package/ios/Util/AwaitCallback.swift +80 -0
  409. package/ios/Util/ConcurrentMap.swift +19 -0
  410. package/ios/Util/Connectivity.swift +12 -0
  411. package/ios/Util/Deadline.swift +38 -0
  412. package/ios/Util/Emitter.swift +45 -22
  413. package/ios/Util/GenerationMemo.swift +43 -0
  414. package/ios/Util/LRUCache.swift +23 -159
  415. package/ios/Util/NetworkMonitor.swift +31 -33
  416. package/ios/Util/OutputPicker.swift +48 -0
  417. package/ios/Util/ReadyValue.swift +57 -0
  418. package/ios/Util/SFSymbolRenderer.swift +64 -49
  419. package/ios/Util/SVGProcessor.swift +9 -16
  420. package/ios/Util/SupersedingTask.swift +45 -0
  421. package/lib/commonjs/AudioBrowser.js +11 -0
  422. package/lib/commonjs/AudioBrowser.js.map +1 -1
  423. package/lib/commonjs/CLAUDE.md +57 -0
  424. package/lib/commonjs/features/battery.js +16 -12
  425. package/lib/commonjs/features/battery.js.map +1 -1
  426. package/lib/commonjs/features/browser-config.js +13 -9
  427. package/lib/commonjs/features/browser-config.js.map +1 -1
  428. package/lib/commonjs/features/browser.js +78 -20
  429. package/lib/commonjs/features/browser.js.map +1 -1
  430. package/lib/commonjs/features/carConnection.js +3 -4
  431. package/lib/commonjs/features/carConnection.js.map +1 -1
  432. package/lib/commonjs/features/equalizer.js +9 -5
  433. package/lib/commonjs/features/equalizer.js.map +1 -1
  434. package/lib/commonjs/features/errors.js +35 -21
  435. package/lib/commonjs/features/errors.js.map +1 -1
  436. package/lib/commonjs/features/favorites.js +28 -23
  437. package/lib/commonjs/features/favorites.js.map +1 -1
  438. package/lib/commonjs/features/gate.js +27 -6
  439. package/lib/commonjs/features/gate.js.map +1 -1
  440. package/lib/commonjs/features/metadata.js +61 -11
  441. package/lib/commonjs/features/metadata.js.map +1 -1
  442. package/lib/commonjs/features/network.js +5 -1
  443. package/lib/commonjs/features/network.js.map +1 -1
  444. package/lib/commonjs/features/nowPlaying.js +28 -14
  445. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  446. package/lib/commonjs/features/output.js +9 -4
  447. package/lib/commonjs/features/output.js.map +1 -1
  448. package/lib/commonjs/features/playback/controls.js +13 -6
  449. package/lib/commonjs/features/playback/controls.js.map +1 -1
  450. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  451. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  452. package/lib/commonjs/features/playback/playing.js +5 -3
  453. package/lib/commonjs/features/playback/playing.js.map +1 -1
  454. package/lib/commonjs/features/playback/progress.js +13 -6
  455. package/lib/commonjs/features/playback/progress.js.map +1 -1
  456. package/lib/commonjs/features/playback/rate.js +8 -1
  457. package/lib/commonjs/features/playback/rate.js.map +1 -1
  458. package/lib/commonjs/features/playback/state.js +5 -6
  459. package/lib/commonjs/features/playback/state.js.map +1 -1
  460. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  461. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  462. package/lib/commonjs/features/playback/volume.js +6 -5
  463. package/lib/commonjs/features/playback/volume.js.map +1 -1
  464. package/lib/commonjs/features/player/options.js +20 -10
  465. package/lib/commonjs/features/player/options.js.map +1 -1
  466. package/lib/commonjs/features/player/setup.js +44 -43
  467. package/lib/commonjs/features/player/setup.js.map +1 -1
  468. package/lib/commonjs/features/player/validateOptions.js +3 -4
  469. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  470. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  471. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  472. package/lib/commonjs/features/queue/queue.js +56 -21
  473. package/lib/commonjs/features/queue/queue.js.map +1 -1
  474. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  475. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  476. package/lib/commonjs/features/queue/shuffle.js +0 -1
  477. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  478. package/lib/commonjs/features/remoteControls.js +59 -35
  479. package/lib/commonjs/features/remoteControls.js.map +1 -1
  480. package/lib/commonjs/features/sleepTimer.js +23 -6
  481. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  482. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  483. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  484. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  485. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  486. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  487. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  488. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  489. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  490. package/lib/commonjs/utils/useDebug.js +16 -3
  491. package/lib/commonjs/utils/useDebug.js.map +1 -1
  492. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  493. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  494. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  495. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  496. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  497. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  498. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  499. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  500. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  501. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  502. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  503. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  504. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  505. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  506. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  507. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  508. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  509. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  510. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  511. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  512. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  513. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  514. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  515. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  516. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  517. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  518. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  519. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  520. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  521. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  522. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  523. package/lib/commonjs/web/browser/sections.js +89 -0
  524. package/lib/commonjs/web/browser/sections.js.map +1 -0
  525. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  526. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  527. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  528. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  529. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  530. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  531. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  532. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  533. package/lib/module/AudioBrowser.js +2 -4
  534. package/lib/module/AudioBrowser.js.map +1 -1
  535. package/lib/module/CLAUDE.md +57 -0
  536. package/lib/module/features/battery.js +16 -12
  537. package/lib/module/features/battery.js.map +1 -1
  538. package/lib/module/features/browser-config.js +13 -9
  539. package/lib/module/features/browser-config.js.map +1 -1
  540. package/lib/module/features/browser.js +78 -20
  541. package/lib/module/features/browser.js.map +1 -1
  542. package/lib/module/features/carConnection.js +3 -4
  543. package/lib/module/features/carConnection.js.map +1 -1
  544. package/lib/module/features/equalizer.js +9 -5
  545. package/lib/module/features/equalizer.js.map +1 -1
  546. package/lib/module/features/errors.js +35 -21
  547. package/lib/module/features/errors.js.map +1 -1
  548. package/lib/module/features/favorites.js +28 -23
  549. package/lib/module/features/favorites.js.map +1 -1
  550. package/lib/module/features/gate.js +27 -6
  551. package/lib/module/features/gate.js.map +1 -1
  552. package/lib/module/features/metadata.js +59 -11
  553. package/lib/module/features/metadata.js.map +1 -1
  554. package/lib/module/features/network.js +5 -1
  555. package/lib/module/features/network.js.map +1 -1
  556. package/lib/module/features/nowPlaying.js +28 -14
  557. package/lib/module/features/nowPlaying.js.map +1 -1
  558. package/lib/module/features/output.js +9 -4
  559. package/lib/module/features/output.js.map +1 -1
  560. package/lib/module/features/playback/controls.js +13 -6
  561. package/lib/module/features/playback/controls.js.map +1 -1
  562. package/lib/module/features/playback/playWhenReady.js +6 -5
  563. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  564. package/lib/module/features/playback/playing.js +5 -3
  565. package/lib/module/features/playback/playing.js.map +1 -1
  566. package/lib/module/features/playback/progress.js +13 -6
  567. package/lib/module/features/playback/progress.js.map +1 -1
  568. package/lib/module/features/playback/rate.js +8 -1
  569. package/lib/module/features/playback/rate.js.map +1 -1
  570. package/lib/module/features/playback/state.js +5 -6
  571. package/lib/module/features/playback/state.js.map +1 -1
  572. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  573. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  574. package/lib/module/features/playback/volume.js +6 -5
  575. package/lib/module/features/playback/volume.js.map +1 -1
  576. package/lib/module/features/player/options.js +20 -10
  577. package/lib/module/features/player/options.js.map +1 -1
  578. package/lib/module/features/player/setup.js +44 -43
  579. package/lib/module/features/player/setup.js.map +1 -1
  580. package/lib/module/features/player/validateOptions.js +3 -4
  581. package/lib/module/features/player/validateOptions.js.map +1 -1
  582. package/lib/module/features/queue/activeTrack.js +14 -4
  583. package/lib/module/features/queue/activeTrack.js.map +1 -1
  584. package/lib/module/features/queue/queue.js +56 -21
  585. package/lib/module/features/queue/queue.js.map +1 -1
  586. package/lib/module/features/queue/repeatMode.js +2 -1
  587. package/lib/module/features/queue/repeatMode.js.map +1 -1
  588. package/lib/module/features/queue/shuffle.js +0 -1
  589. package/lib/module/features/queue/shuffle.js.map +1 -1
  590. package/lib/module/features/remoteControls.js +59 -35
  591. package/lib/module/features/remoteControls.js.map +1 -1
  592. package/lib/module/features/sleepTimer.js +24 -7
  593. package/lib/module/features/sleepTimer.js.map +1 -1
  594. package/lib/module/test-utils/reactNativeStub.js +58 -0
  595. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  596. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  597. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  598. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  599. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  600. package/lib/module/utils/getTrackIdentity.js +22 -0
  601. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  602. package/lib/module/utils/useDebug.js +16 -3
  603. package/lib/module/utils/useDebug.js.map +1 -1
  604. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  605. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  606. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  607. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  608. package/lib/module/web/NativeAudioBrowser.js +207 -84
  609. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  610. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  611. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  612. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  613. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  614. package/lib/module/web/TrackPlayer/Player.js +256 -40
  615. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  616. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  617. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  618. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  619. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  620. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  621. package/lib/module/web/browser/BrowserManager.js +175 -100
  622. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  623. package/lib/module/web/browser/FavoriteManager.js +31 -21
  624. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  625. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  626. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  627. package/lib/module/web/browser/SearchManager.js +18 -23
  628. package/lib/module/web/browser/SearchManager.js.map +1 -1
  629. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  630. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  631. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  632. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  633. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  634. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  635. package/lib/module/web/browser/sections.js +83 -0
  636. package/lib/module/web/browser/sections.js.map +1 -0
  637. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  638. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  639. package/lib/module/web/http/followMediaRedirect.js +215 -0
  640. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  641. package/lib/module/web/player/NowPlayingManager.js +4 -3
  642. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  643. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  644. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  645. package/lib/typescript/package.json +1 -0
  646. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  647. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  648. package/lib/typescript/src/features/battery.d.ts +17 -12
  649. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  650. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  651. package/lib/typescript/src/features/browser.d.ts +67 -19
  652. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  653. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  654. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  655. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  656. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  657. package/lib/typescript/src/features/errors.d.ts +37 -22
  658. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  659. package/lib/typescript/src/features/favorites.d.ts +28 -23
  660. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  661. package/lib/typescript/src/features/gate.d.ts +29 -8
  662. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  663. package/lib/typescript/src/features/metadata.d.ts +65 -14
  664. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  665. package/lib/typescript/src/features/network.d.ts +5 -1
  666. package/lib/typescript/src/features/network.d.ts.map +1 -1
  667. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  668. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  669. package/lib/typescript/src/features/output.d.ts +9 -4
  670. package/lib/typescript/src/features/output.d.ts.map +1 -1
  671. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  672. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  673. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  674. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  675. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  676. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  677. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  678. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  679. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  680. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  681. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  682. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  683. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  684. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  685. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  686. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  687. package/lib/typescript/src/features/player/options.d.ts +73 -56
  688. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  689. package/lib/typescript/src/features/player/setup.d.ts +129 -73
  690. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  691. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  692. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  693. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  694. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  695. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  696. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  697. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  698. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  699. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  700. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  701. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  702. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  703. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  704. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  705. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  706. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  707. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  708. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  709. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  710. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  711. package/lib/typescript/src/types/browser.d.ts +248 -173
  712. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  713. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  714. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  715. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  716. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  717. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  718. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  719. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  720. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  721. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  722. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  723. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  724. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  725. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  726. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  727. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  728. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  729. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  732. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  735. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  736. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  742. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  743. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  745. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  747. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  749. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  750. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  751. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  752. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  755. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  756. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  757. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  758. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  759. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  761. 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
  762. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  763. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  765. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  766. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  767. 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
  768. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  773. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  777. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  780. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  783. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  785. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  798. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  801. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  802. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  807. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  809. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  810. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  815. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  816. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  818. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  821. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  824. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  825. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  826. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  827. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  828. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  829. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  830. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  832. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  833. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  835. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  838. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  840. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  841. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  842. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  844. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  845. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  846. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  847. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  848. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  850. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  851. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  852. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  853. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  854. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  855. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  856. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  857. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  858. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  859. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  860. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  861. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  862. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  863. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  864. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  865. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  866. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  867. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  868. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  869. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  870. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  871. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  872. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  873. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  874. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  875. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  876. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  877. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +25 -15
  878. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  879. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  880. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  881. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  882. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  883. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  884. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  885. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  886. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  887. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  907. 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
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  914. 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
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  917. 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
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  920. 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
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  1002. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  1003. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  1004. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  1005. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  1006. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  1007. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  1008. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  1009. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  1010. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  1011. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  1012. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +25 -3
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  1018. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  1019. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  1020. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  1021. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  1022. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  1023. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  1024. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1025. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1026. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1027. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1028. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1029. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1030. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1031. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1032. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1033. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1034. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1035. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1036. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1037. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1038. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1039. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1040. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1041. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1042. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1043. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1044. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1045. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1046. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1047. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1048. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1049. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1050. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1051. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1052. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1053. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1054. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1055. package/nitrogen/generated/ios/swift/TrackLoadEvent.swift +20 -2
  1056. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1057. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1058. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1059. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1060. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1061. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1062. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1063. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1064. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1065. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1066. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1067. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1068. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1069. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1070. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1071. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1072. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1073. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1074. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1075. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1076. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1077. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1078. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1079. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1080. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1081. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1082. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1083. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1084. package/nitrogen/generated/shared/c++/TrackLoadEvent.hpp +7 -2
  1085. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1086. package/package.json +27 -13
  1087. package/src/AudioBrowser.ts +2 -4
  1088. package/src/CLAUDE.md +57 -0
  1089. package/src/docs-floors.test.ts +71 -0
  1090. package/src/features/battery.test.ts +79 -0
  1091. package/src/features/battery.ts +17 -13
  1092. package/src/features/browser-config.test.ts +21 -6
  1093. package/src/features/browser-config.ts +13 -9
  1094. package/src/features/browser.test.ts +1 -1
  1095. package/src/features/browser.ts +69 -20
  1096. package/src/features/carConnection.ts +3 -4
  1097. package/src/features/equalizer.ts +9 -5
  1098. package/src/features/errors.ts +37 -22
  1099. package/src/features/favorites.ts +28 -23
  1100. package/src/features/gate.ts +29 -8
  1101. package/src/features/hook-wiring.test.ts +302 -0
  1102. package/src/features/metadata.ts +80 -14
  1103. package/src/features/network.ts +5 -1
  1104. package/src/features/nowPlaying.ts +28 -14
  1105. package/src/features/output.ts +9 -4
  1106. package/src/features/playback/controls.ts +13 -6
  1107. package/src/features/playback/playWhenReady.ts +6 -5
  1108. package/src/features/playback/playing.ts +16 -3
  1109. package/src/features/playback/progress.test.ts +169 -0
  1110. package/src/features/playback/progress.ts +13 -6
  1111. package/src/features/playback/rate.ts +8 -1
  1112. package/src/features/playback/state.ts +10 -6
  1113. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1114. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1115. package/src/features/playback/volume.ts +6 -5
  1116. package/src/features/player/options.ts +81 -62
  1117. package/src/features/player/setup.test.ts +12 -3
  1118. package/src/features/player/setup.ts +141 -76
  1119. package/src/features/player/validateOptions.ts +3 -4
  1120. package/src/features/queue/activeTrack.ts +14 -4
  1121. package/src/features/queue/queue.ts +56 -21
  1122. package/src/features/queue/repeatMode.ts +1 -1
  1123. package/src/features/queue/shuffle.ts +0 -1
  1124. package/src/features/remoteControls.ts +59 -35
  1125. package/src/features/sleepTimer.test.ts +171 -0
  1126. package/src/features/sleepTimer.ts +24 -8
  1127. package/src/nitro-stub-drift.test.ts +277 -0
  1128. package/src/public-surface.test.ts +48 -24
  1129. package/src/specs/audio-browser.nitro.ts +15 -8
  1130. package/src/style-resolution.test.ts +210 -0
  1131. package/src/test-utils/reactNativeStub.ts +60 -0
  1132. package/src/types/browser-native.ts +7 -3
  1133. package/src/types/browser-nodes.ts +417 -151
  1134. package/src/types/browser.ts +254 -177
  1135. package/src/utils/LazyNativeEmitter.ts +17 -10
  1136. package/src/utils/NativeUpdatedValue.ts +30 -16
  1137. package/src/utils/getTrackIdentity.ts +22 -0
  1138. package/src/utils/useDebug.test.ts +182 -0
  1139. package/src/utils/useDebug.ts +16 -3
  1140. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1141. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1142. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1143. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1144. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1145. package/src/web/NativeAudioBrowser.ts +247 -92
  1146. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1147. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1148. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1149. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1150. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1151. package/src/web/TrackPlayer/Player.ts +286 -38
  1152. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1153. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1154. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1155. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1156. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1157. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1158. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1159. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1160. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1161. package/src/web/__tests__/retry.test.ts +169 -0
  1162. package/src/web/browser/BrowserManager.ts +209 -111
  1163. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1164. package/src/web/browser/FavoriteManager.ts +28 -23
  1165. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1166. package/src/web/browser/SearchManager.test.ts +75 -0
  1167. package/src/web/browser/SearchManager.ts +25 -28
  1168. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1169. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1170. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1171. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1172. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1173. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1174. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1175. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1176. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1177. package/src/web/browser/parseSearchResponse.ts +3 -4
  1178. package/src/web/browser/sections.test.ts +91 -0
  1179. package/src/web/browser/sections.ts +72 -0
  1180. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1181. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1182. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1183. package/src/web/http/followMediaRedirect.ts +253 -0
  1184. package/src/web/player/NowPlayingManager.ts +4 -3
  1185. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1186. package/src/web/util/BrowserPathHelper.ts +68 -13
  1187. package/website/guide/android-auto.md +126 -0
  1188. package/website/guide/android-certificates.md +488 -0
  1189. package/website/guide/artwork.md +300 -0
  1190. package/website/guide/audio-output.md +382 -0
  1191. package/website/guide/automotive.md +91 -0
  1192. package/website/guide/basic-usage.md +154 -0
  1193. package/website/guide/battery.md +142 -0
  1194. package/website/guide/browser.md +674 -0
  1195. package/website/guide/carplay.md +733 -0
  1196. package/website/guide/configuration.md +215 -0
  1197. package/website/guide/equalizer.md +235 -0
  1198. package/website/guide/errors.md +359 -0
  1199. package/website/guide/favorites.md +164 -0
  1200. package/website/guide/gate.md +157 -0
  1201. package/website/guide/getting-started.md +99 -0
  1202. package/website/guide/hooks.md +247 -0
  1203. package/website/guide/live-streams.md +189 -0
  1204. package/website/guide/metadata.md +289 -0
  1205. package/website/guide/migrating-from-track-player.md +289 -0
  1206. package/website/guide/native-callback-fetch.md +137 -0
  1207. package/website/guide/network.md +103 -0
  1208. package/website/guide/now-playing.md +203 -0
  1209. package/website/guide/playback.md +405 -0
  1210. package/website/guide/queue.md +334 -0
  1211. package/website/guide/remote-controls.md +314 -0
  1212. package/website/guide/search.md +270 -0
  1213. package/website/guide/sleep-timer.md +289 -0
  1214. package/website/guide/track.md +271 -0
  1215. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +0 -50
  1216. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1217. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +0 -40
  1218. package/ios/Bridge.h +0 -8
  1219. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1220. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1221. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1222. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1223. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1224. package/ios/Model/MediaURL.swift +0 -67
  1225. package/ios/Model/SourceType.swift +0 -6
  1226. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1227. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1228. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1229. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1230. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1231. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1232. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1233. package/ios/Option/PitchAlgorithms.swift +0 -17
  1234. package/ios/Option/TimeEventFrequency.swift +0 -18
  1235. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1236. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1237. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1238. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1239. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1240. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1241. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1242. package/ios/Player/PlaybackStateStore.swift +0 -27
  1243. package/ios/Player/PlayingStateManager.swift +0 -33
  1244. package/ios/Player/RetryManager.swift +0 -323
  1245. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1246. package/ios/Player/SleepTimerHandling.swift +0 -15
  1247. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1248. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1249. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1250. package/ios/Tests/MediaResolveTests.swift +0 -126
  1251. package/ios/Tests/OnceValueTests.swift +0 -79
  1252. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1253. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1254. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1255. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1256. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1257. package/ios/Tests/RetryManagerTests.swift +0 -89
  1258. package/ios/TrackPlayer.swift +0 -1014
  1259. package/ios/TrackPlayerCallbacks.swift +0 -53
  1260. package/ios/Util/MetadataAdapter.swift +0 -131
  1261. package/ios/Util/OnceValue.swift +0 -104
  1262. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1263. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1264. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1265. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1266. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1267. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1268. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1269. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1270. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1271. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1272. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1273. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1274. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1275. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -5,132 +5,89 @@ import MediaPlayer
5
5
  import NitroModules
6
6
  import os.log
7
7
 
8
- @MainActor let playerAndConfiguredBrowser = OnceValue<(HybridAudioBrowser, TrackPlayer)> {
8
+ /// The shared browser and its player, ready once the browser is configured and the player is
9
+ /// set up; CarPlay and Siri wait on it.
10
+ @MainActor let playerAndConfiguredBrowser = ReadyValue<(HybridAudioBrowser, Player)> {
9
11
  guard let browser = HybridAudioBrowser.shared,
10
12
  browser.browserManager.isConfigured,
11
- let player = browser.getPlayer() else { return nil }
13
+ let player = browser.player else { return nil }
12
14
  return (browser, player)
13
15
  }
14
16
 
15
- /// Wraps a non-Sendable value for passing through MainActor.assumeIsolated.
16
- /// Only safe when the caller blocks until the MainActor work completes (DispatchQueue.main.sync).
17
+ /// Carries a non-Sendable value out of `MainActor.assumeIsolated`. Safe only while the caller
18
+ /// blocks until the main-actor work completes.
17
19
  private struct UncheckedSendableBox<T>: @unchecked Sendable { let value: T }
18
20
 
19
- /// `@unchecked Sendable` because it must be: the spec's requirements are all
20
- /// nonisolated and Nitro calls them synchronously on the JS thread, so the class
21
- /// can't be `@MainActor`. Isolation is therefore per-property, and `@unchecked`
22
- /// means the compiler won't tell you when a new one needs it.
21
+ /// `@unchecked Sendable` because the spec's requirements are nonisolated and Nitro calls them
22
+ /// synchronously on the JS thread, so the class can't be `@MainActor`. Isolation is per-property,
23
+ /// and the compiler won't say when a new property needs it.
23
24
  public class HybridAudioBrowser: HybridAudioBrowserSpec, @unchecked Sendable {
24
- private let logger = Logger(subsystem: "com.audiobrowser", category: "AudioBrowser")
25
+ let logger = Logger(subsystem: "com.audiobrowser", category: "AudioBrowser")
25
26
 
26
27
  // MARK: - Shared Instance for CarPlay
27
28
 
28
- /// Shared instance for CarPlay access. Set when HybridAudioBrowser is created.
29
29
  private(set) nonisolated(unsafe) weak static var shared: HybridAudioBrowser?
30
30
 
31
- /// Fires when a new instance becomes `shared` (e.g. on a JS runtime reload),
32
- /// so connected external controllers (CarPlay) can re-subscribe — their
33
- /// listeners sit on the previous instance's emitters and would otherwise go
34
- /// silent.
31
+ /// Fires when a new instance becomes `shared` (a JS reload), so CarPlay re-subscribes: its
32
+ /// listeners on the previous instance's emitters would go silent.
35
33
  static let instanceChangedEmitter = Emitter<Void>()
36
34
 
37
- // MARK: - Private Properties
38
-
39
- /// Main-confined by convention, not annotation: `deinit` reads it as a
40
- /// safety net and can't hop. Reach it from `onMainActor` / `@MainActor`.
41
- private var player: TrackPlayer?
42
- private let networkMonitor = NetworkMonitor()
43
- private let playbackStateStore = PlaybackStateStore()
44
- let browserManager = BrowserManager()
45
- private let trackSelector: TrackSelector
46
- private var volumeObservation: NSKeyValueObservation?
47
- private var routeChangeObserver: NSObjectProtocol?
48
- private var interruptionObserver: NSObjectProtocol?
49
- private var mediaServicesResetObserver: NSObjectProtocol?
50
- /// Re-applies our resolved audio-session category. Captured at setup so a
51
- /// media-services reset (which clears the category) can restore it.
52
- @MainActor private var applyAudioSessionCategory: () -> Void = {}
53
- @MainActor private var nowPlayingOverride: NowPlayingUpdate?
54
- /// When false, the now-playing surface uses the raw track fields (override + formatter ignored).
55
- @MainActor private var nowPlayingMetadataEnabled = true
56
- /// Customizes the now-playing title/subtitle from the track + live timed metadata + playback state.
57
- @MainActor private var nowPlayingMetadataFormatter: ((_ params: FormatNowPlayingParams) -> Promise<NowPlayingUpdate?>)?
58
- /// Initial player state staged before the player exists — from setup options or the imperative
59
- /// setters called pre-setup. Strict last-write-wins; consumed when the player comes up.
60
- @MainActor private var pendingPlayWhenReady: Bool?
61
- @MainActor private var pendingRepeatMode: RepeatMode?
62
- /// Latest live timed (ICY/ID3) metadata, passed to the formatter. Cleared on track change.
63
- @MainActor private var latestTimedMetadata: TimedMetadata?
64
- @MainActor private let playerOptions = PlayerUpdateOptions()
65
-
66
- /// Configured playback rates for the playback-rate capability (for CarPlay rate cycling)
67
- @MainActor var playbackRates: [Double] { playerOptions.playbackRates }
68
- @MainActor var carPlayUpNextButton: Bool { playerOptions.carPlayUpNextButton }
69
- @MainActor var carPlayNowPlayingButtons: [CarPlayNowPlayingButton] {
70
- playerOptions.carPlayNowPlayingButtons
71
- }
72
-
73
- /// Written from the JS thread, the cooperative pool and MainActor, with a
74
- /// `didSet` that calls back into Nitro. MainActor-isolated so the compiler
75
- /// requires an `onMainActor` hop at every access.
76
- @MainActor private var lastNavigationError: NavigationError? {
77
- didSet {
78
- // Skip if both nil (no real change)
79
- guard oldValue != nil || lastNavigationError != nil else { return }
80
- navigationErrorEmitter.emit(NavigationErrorEvent(error: lastNavigationError))
35
+ // React Native posts this when a JS reload starts, before the old runtime is destroyed: the
36
+ // earliest sign this instance's JS callbacks go stale (the replacement's `init` drops them only
37
+ // once the new runtime is up). Observed by name, so the library needs no React-Core dependency.
38
+ @MainActor private static let reloadObserver: NSObjectProtocol = NotificationCenter.default.addObserver(
39
+ forName: Notification.Name("RCTTriggerReloadCommandNotification"),
40
+ object: nil,
41
+ queue: .main,
42
+ ) { _ in
43
+ MainActor.assumeIsolated {
44
+ HybridAudioBrowser.shared?.dropStaleJSCallbacks()
81
45
  }
82
46
  }
83
47
 
84
- /// Isolated for the same reason as ``lastNavigationError``.
85
- @MainActor private var lastFormattedNavigationError: FormattedNavigationError? {
86
- didSet {
87
- // Skip if both nil (no real change)
88
- guard oldValue != nil || lastFormattedNavigationError != nil else { return }
89
- onFormattedNavigationError(lastFormattedNavigationError)
90
- }
91
- }
48
+ // MARK: - Private Properties
92
49
 
93
- // MARK: - Multi-Listener Emitters
50
+ // Main-confined by convention, not annotation: `deinit` reads it and can't hop. Reach it from
51
+ // `onMainActor` or `@MainActor`.
52
+ var player: Player?
53
+ var engine: AVPlayerEngine?
54
+ let networkMonitor = NetworkMonitor()
55
+ let browserManager = BrowserManager()
56
+ let browseGate = BrowseGate()
57
+ let trackSelector: TrackSelector
58
+ @MainActor private(set) var initialNavigation: Task<Void, Never>?
59
+ @MainActor private(set) lazy var audioSession = AudioSessionController()
60
+ // Player state set before the player exists, by setup options or the setters; last write wins,
61
+ // consumed when the player comes up.
62
+ @MainActor var pendingPlayWhenReady: Bool?
63
+ @MainActor var pendingRepeatMode: RepeatMode?
64
+ @MainActor let playerOptions = PlayerUpdateOptions()
65
+
66
+ @MainActor lazy var navigationError = NavigationErrorState(
67
+ onErrorChanged: { [weak self] in self?.onNavigationError(NavigationErrorEvent(error: $0)) },
68
+ onFormattedChanged: { [weak self] in self?.onFormattedNavigationError($0) },
69
+ )
70
+
71
+ // MARK: - Emitters for Native Listeners
94
72
 
95
- /// Emitters allow multiple listeners for each event type, avoiding callback hijacking
96
- public let tabsChangedEmitter = Emitter<[Track]>()
97
- public let contentChangedEmitter = Emitter<ResolvedTrack?>()
98
73
  public let favoriteChangedEmitter = Emitter<FavoriteChangedEvent>()
99
74
  public let activeTrackChangedEmitter = Emitter<PlaybackActiveTrackChangedEvent>()
100
75
  public let queueChangedEmitter = Emitter<[Track]>()
101
- public let navigationErrorEmitter = Emitter<NavigationErrorEvent>()
102
76
  public let repeatModeChangedEmitter = Emitter<RepeatModeChangedEvent>()
103
77
  public let shuffleChangedEmitter = Emitter<Bool>()
104
78
  public let externalContentChangedEmitter = Emitter<String>()
105
- /// Signals that the gate's active state changed (set or cleared). Carries
106
- /// the active flag; per-request chrome is obtained at each serve site via
107
- /// `gateDecision(for:)`, so the emitter only tells surfaces to re-render.
108
- public let gateChangedEmitter = Emitter<Bool>()
109
- /// Fired when a voice media intent (`handlePlayMediaIntent`) successfully
110
- /// starts playback. CarPlay surfaces the Now Playing template in response, so
111
- /// the user lands on the playing station (with the rest of the results in Up
112
- /// Next) rather than the screen they invoked Siri from. No-op where unobserved.
79
+ /// Fires when a voice intent starts playback, so CarPlay shows the Now Playing template rather
80
+ /// than the screen Siri was invoked from.
113
81
  public let showNowPlayingRequestedEmitter = Emitter<Void>()
114
- /// Fires after `updateOptions` applies a change, so external-surface managers
115
- /// (CarPlay) can refresh UI driven by now-runtime-updatable options
116
- /// (now-playing buttons, Up Next).
82
+ /// Fires after `updateOptions` applies a change, so CarPlay refreshes its now-playing buttons and
83
+ /// Up Next.
117
84
  public let playerOptionsChangedEmitter = Emitter<Void>()
118
85
 
119
86
  // MARK: - Thread Safety
120
87
 
121
- /// Runs a closure on MainActor synchronously. Safe for non-Sendable return types
122
- /// because DispatchQueue.main.sync blocks the caller — no concurrent access window.
123
- private func onMainActor<T>(_ work: @MainActor () -> T) -> T {
124
- if Thread.isMainThread {
125
- MainActor.assumeIsolated { UncheckedSendableBox(value: work()) }.value
126
- } else {
127
- DispatchQueue.main.sync {
128
- MainActor.assumeIsolated { UncheckedSendableBox(value: work()) }.value
129
- }
130
- }
131
- }
132
-
133
- private func onMainActor<T>(_ work: @MainActor () throws -> T) throws -> T {
88
+ /// Runs `work` on the main actor and waits for it; from another thread it blocks on
89
+ /// `DispatchQueue.main.sync`, which is what makes a non-Sendable result safe to return.
90
+ func onMainActor<T>(_ work: @MainActor () throws -> T) rethrows -> T {
134
91
  if Thread.isMainThread {
135
92
  try MainActor.assumeIsolated { try UncheckedSendableBox(value: work()) }.value
136
93
  } else {
@@ -143,53 +100,42 @@ public class HybridAudioBrowser: HybridAudioBrowserSpec, @unchecked Sendable {
143
100
  // MARK: - Browser Properties
144
101
 
145
102
  public var path: String? {
146
- get { onMainActor { browserManager.getPath() } }
103
+ get { onMainActor { browserManager.path } }
147
104
  set {
148
105
  guard let newPath = newValue else { return }
149
- Task {
150
- do {
151
- try await browserManager.navigate(newPath)
152
- } catch {
153
- handleNavigationError(error, path: newPath)
154
- }
155
- }
106
+ navigate(newPath, clearError: false)
156
107
  }
157
108
  }
158
109
 
159
110
  public var tabs: [Track]? {
160
- get { onMainActor { browserManager.getTabs() } }
161
- set { /* tabs are managed internally by browserManager */ }
111
+ get { onMainActor { browserManager.tabs } }
112
+ set { /* browserManager owns the tabs; JS cannot set them */ }
162
113
  }
163
114
 
164
115
  public var configuration: NativeBrowserConfiguration = .init(
165
116
  path: nil, request: nil, requestResolver: nil, browse: nil, browseResolver: nil, media: nil, artwork: nil, nowPlayingArtwork: nil, routes: nil,
166
117
  singleTrack: nil, handleTrackLoad: nil,
167
- androidControllerOfflineError: nil, carPlayLoadingTitle: nil, resolveAlbumUrl: nil, formatNavigationError: nil,
118
+ androidControllerOfflineError: nil, viewMoreTitle: nil, carPlayLoadingTitle: nil, resolveAlbumPath: nil,
119
+ formatNavigationError: nil,
168
120
  ) {
169
121
  didSet {
170
- // Copied here, on the setter's thread: the Task below outlives this call,
171
- // and Nitro can reassign `configuration` — a C++ struct holding
172
- // std::string/std::function — from the JS thread while it runs.
122
+ // Copied on the setter's thread: the Task below outlives this call, and Nitro can reassign
123
+ // `configuration` (a C++ struct holding std::string/std::function) from the JS thread.
173
124
  let configuredPath = configuration.path
174
- onMainActor { browserManager.config = BrowserConfig(from: configuration) }
125
+ onMainActor {
126
+ browserManager.config = BrowserConfig(from: configuration)
127
+ browserManager.clearContent()
128
+ initialNavigation?.cancel()
129
+ initialNavigation = Task {
130
+ let tabs = try? await browserManager.queryTabs()
131
+ guard !Task.isCancelled else { return }
132
+ navigate(configuredPath ?? tabs?.first?.path ?? "/", clearError: true)
133
+ }
134
+ }
175
135
 
176
- // Query tabs and navigate to initial path after config is set (matches Kotlin behavior)
177
136
  Task { @MainActor in
178
- // Notify waiting listeners (e.g., CarPlay cold start)
179
137
  playerAndConfiguredBrowser.check()
180
138
  }
181
- Task {
182
- let tabs = try? await browserManager.queryTabs()
183
- // Navigate to configured path, first tab, or "/"
184
- let initialPath = configuredPath ?? tabs?.first?.url ?? "/"
185
- // Clear error before navigation (matches Kotlin clearNavigationError())
186
- clearNavigationError()
187
- do {
188
- try await browserManager.navigate(initialPath)
189
- } catch {
190
- handleNavigationError(error, path: initialPath)
191
- }
192
- }
193
139
  }
194
140
  }
195
141
 
@@ -201,23 +147,21 @@ public class HybridAudioBrowser: HybridAudioBrowserSpec, @unchecked Sendable {
201
147
  public var onNavigationError: (NavigationErrorEvent) -> Void = { _ in }
202
148
  public var onFormattedNavigationError: (FormattedNavigationError?) -> Void = { _ in }
203
149
 
204
- /// Per-request gate decision, set by JS. Native calls it at a serve site to
205
- /// learn whether a browse path / search interaction should be gated and with
206
- /// what chrome. The double `Promise` mirrors every other native→JS
207
- /// value-returning callback (e.g. `searchCallback`): the outer resolves to the
208
- /// JS-side Promise, the inner to the decision.
150
+ /// Whether a browse path or search interaction is gated, and with what gate; set by JS. The
151
+ /// outer Promise resolves to JS's Promise, the inner to the decision.
209
152
  ///
210
- /// Default fails CLOSED (`gated: true`). This default is only consulted in the
211
- /// init window where `hasResolver` was already recorded true but JS hasn't
212
- /// (re)bound the real resolver yet (JS reload / instance churn re-seeding gate
213
- /// state, e.g. CarPlay re-seeding `isGated` at scene connect). Serving content
214
- /// in that window would be a fail-open leak — same direction as the
215
- /// resolver-error path in `gateDecision`. Matches Android's default.
216
- public var resolveGate: (NativeGateRequest) -> Promise<Promise<GateDecision>> = { _ in
217
- Promise.resolved(withResult: Promise.resolved(withResult: GateDecision(gated: true, gate: nil)))
153
+ /// The default fails closed (`gated: true`). It answers only in the window where the gate is
154
+ /// resolved but JS has not (re)bound its resolver (a JS reload, CarPlay deciding its tabs at
155
+ /// scene connect); serving content there would leak, like the resolver-error path in
156
+ /// `BrowseGate.decide`. Android defaults the same way.
157
+ public var resolveGate: (NativeGateRequest) -> Promise<Promise<GateDecision>> = HybridAudioBrowser.defaultResolveGate
158
+
159
+ static var defaultResolveGate: (NativeGateRequest) -> Promise<Promise<GateDecision>> {
160
+ { _ in
161
+ Promise.resolved(withResult: Promise.resolved(withResult: GateDecision(gated: true, gate: nil)))
162
+ }
218
163
  }
219
164
 
220
- /// Fired when a request is gated (served the gate). Set by JS.
221
165
  public var onGate: (GateEvent) -> Void = { _ in }
222
166
 
223
167
  // MARK: - Player Callbacks
@@ -273,9 +217,7 @@ public class HybridAudioBrowser: HybridAudioBrowserSpec, @unchecked Sendable {
273
217
  public var onNowPlayingChanged: (NowPlayingMetadata) -> Void = { _ in }
274
218
  public var onOnlineChanged: (Bool) -> Void = { _ in } {
275
219
  didSet {
276
- // The monitor->JS bridge is wired centrally in setupPlayer (so it doesn't depend on a JS
277
- // subscription and can also drive the now-playing re-render + player reconnect). Here we only
278
- // push the current state to a newly-attached subscriber.
220
+ // A new subscriber hears the current state at once.
279
221
  onOnlineChanged(networkMonitor.isOnline)
280
222
  }
281
223
  }
@@ -283,15 +225,15 @@ public class HybridAudioBrowser: HybridAudioBrowserSpec, @unchecked Sendable {
283
225
  public var onEqualizerChanged: (EqualizerSettings) -> Void = { _ in }
284
226
  public var onBatteryWarningPendingChanged: (BatteryWarningPendingChangedEvent) -> Void = { _ in }
285
227
  public var onBatteryOptimizationStatusChanged: (BatteryOptimizationStatusChangedEvent) -> Void = { _ in }
286
- public var onSystemVolumeChanged: (Double) -> Void = { _ in } {
287
- didSet {
288
- setupVolumeObserver()
289
- }
290
- }
228
+ public var onSystemVolumeChanged: (Double) -> Void = { _ in }
291
229
 
292
- public var onOutputChanged: (Output) -> Void = { _ in } {
230
+ public var onOutputChanged: (Output) -> Void = { _ in }
231
+
232
+ public var onCarConnectedChanged: (Bool) -> Void = { _ in } {
293
233
  didSet {
294
- setupRouteChangeObserver()
234
+ // A new subscriber hears the current state at once: the scene may have connected before
235
+ // this JS runtime subscribed.
236
+ onCarConnectedChanged(HybridAudioBrowser.carPlayConnected)
295
237
  }
296
238
  }
297
239
 
@@ -301,1600 +243,87 @@ public class HybridAudioBrowser: HybridAudioBrowserSpec, @unchecked Sendable {
301
243
  trackSelector = TrackSelector(browserManager: browserManager)
302
244
  super.init()
303
245
 
304
- // Clean up the previous instance (e.g., on JS runtime reload).
305
- // The old HybridAudioBrowser may still be retained by the global
306
- // playerAndConfiguredBrowser OnceValue, so we must explicitly stop
307
- // its player to prevent two audio streams running simultaneously.
246
+ // Stops the previous instance's player (a JS reload) so two streams never play at once.
308
247
  onMainActor {
309
- HybridAudioBrowser.shared?.player?.destroy()
310
- playerAndConfiguredBrowser.reset()
248
+ // Statics are lazy: touching the observer installs it from the first instance on.
249
+ _ = HybridAudioBrowser.reloadObserver
250
+ HybridAudioBrowser.shared?.destroyPlayer()
251
+ HybridAudioBrowser.shared?.dropStaleJSCallbacks()
311
252
  HybridAudioBrowser.shared = self
312
- // Tell connected external controllers (CarPlay) to re-subscribe against
313
- // this instance. Unconditional: `shared` is weak, so on a JS reload the
314
- // old instance may already be gone — "shared was nil" does not mean no
315
- // controller is subscribed to a dead instance's emitters.
316
- HybridAudioBrowser.instanceChangedEmitter.emit(())
317
- }
318
- setupEmitterToNitroForwarding()
319
- setupBrowserCallbacks()
320
- }
321
-
322
- deinit {
323
- // Safety net: ensure the AVPlayer is stopped if this instance is deallocated.
324
- let player = self.player
325
- if Thread.isMainThread {
326
- MainActor.assumeIsolated { player?.destroy() }
327
- } else {
328
- DispatchQueue.main.async { MainActor.assumeIsolated { player?.destroy() } }
329
- }
330
- }
331
-
332
- /// Returns the TrackPlayer instance, if setup has been called.
333
- func getPlayer() -> TrackPlayer? {
334
- player
335
- }
336
-
337
- /// Sets up automatic forwarding from emitters to Nitro callbacks
338
- private func setupEmitterToNitroForwarding() {
339
- tabsChangedEmitter.addListener { [weak self] tabs in
340
- self?.onTabsChanged(tabs)
341
- }
342
-
343
- contentChangedEmitter.addListener { [weak self] content in
344
- self?.onContentChanged(content)
345
- }
346
-
347
- favoriteChangedEmitter.addListener { [weak self] event in
348
- self?.onFavoriteChanged(event)
349
- }
350
-
351
- activeTrackChangedEmitter.addListener { [weak self] event in
352
- self?.onPlaybackActiveTrackChanged(event)
353
- }
354
-
355
- queueChangedEmitter.addListener { [weak self] tracks in
356
- self?.onPlaybackQueueChanged(tracks)
357
- }
358
-
359
- navigationErrorEmitter.addListener { [weak self] event in
360
- self?.onNavigationError(event)
361
- }
362
-
363
- repeatModeChangedEmitter.addListener { [weak self] event in
364
- self?.onPlaybackRepeatModeChanged(event)
365
- }
366
- }
367
-
368
- private func setupBrowserCallbacks() {
369
- onMainActor {
370
- browserManager.onPathChanged = { [weak self] path in
371
- self?.onPathChanged(path)
372
- }
373
- browserManager.onContentChanged = { [weak self] content in
374
- self?.contentChangedEmitter.emit(content)
375
- }
376
- browserManager.onTabsChanged = { [weak self] tabs in
377
- self?.tabsChangedEmitter.emit(tabs)
378
- }
379
- }
380
- }
381
-
382
- private func handleNavigationError(_ error: Error, path: String) {
383
- let navError = NavigationError.from(error)
384
-
385
- onMainActor { lastNavigationError = navError }
386
-
387
- // Format the error (async if using JS callback, sync for defaults)
388
- let defaultFormatted = navError.defaultFormatted()
389
- if let formatter = onMainActor({ browserManager.config.formatNavigationError }) {
390
- let params = FormatNavigationErrorParams(error: navError, defaultFormatted: defaultFormatted, path: path)
391
- // Dispatch to main thread for the Nitro bridge call to avoid C++ noexcept crashes.
392
- // The result callbacks are @Sendable: a plain closure would inherit MainActor
393
- // isolation from this block, and Nitro resolves its promises synchronously on the
394
- // JS thread — Swift 6.2's dynamic isolation check then traps on closure entry.
395
- // They therefore hop back explicitly, like every other writer.
396
- DispatchQueue.main.async { [weak self] in
397
- formatter(params)
398
- .then { @Sendable [weak self] customDisplay in
399
- self?.setFormattedNavigationError(customDisplay ?? defaultFormatted)
400
- }
401
- .catch { @Sendable [weak self] _ in
402
- self?.setFormattedNavigationError(defaultFormatted)
403
- }
404
- }
405
- } else {
406
- setFormattedNavigationError(defaultFormatted)
407
- }
408
- }
409
-
410
- /// Callable from any thread — the Nitro promise callbacks below resolve on
411
- /// the JS thread.
412
- private func setFormattedNavigationError(_ formatted: FormattedNavigationError?) {
413
- onMainActor { lastFormattedNavigationError = formatted }
414
- }
415
-
416
- /// Synchronous on purpose: the `didSet`s notify JS, which has to happen
417
- /// before the navigation that may set them again.
418
- private func clearNavigationError() {
419
- onMainActor {
420
- lastNavigationError = nil
421
- lastFormattedNavigationError = nil
422
- }
423
- }
424
-
425
- // MARK: - Browser Methods
426
-
427
- public func navigatePath(path: String) throws {
428
- clearNavigationError()
429
- Task {
430
- do {
431
- try await browserManager.navigate(path)
432
- } catch {
433
- handleNavigationError(error, path: path)
434
- }
435
- }
436
- }
437
-
438
- public func navigateTrack(track: Track) throws {
439
- // @MainActor: `player` is main-confined, and `trackSelector.select` is
440
- // MainActor anyway — a bare Task read the reference off the cooperative
441
- // pool, racing the assignment in `setupPlayer`.
442
- Task { @MainActor in
443
- guard let player else { return }
444
- let result = await trackSelector.select(track: track, player: player)
445
- switch result {
446
- case let .play(intent):
447
- executePlayback(intent)
448
- case .intercepted:
449
- break
450
- case let .browse(url):
451
- navigateToBrowsableUrl(url)
452
- case .none:
453
- break
454
- }
455
- }
456
- }
457
-
458
- private func executePlayback(_ intent: TrackSelector.PlaybackIntent) {
459
- onMainActor {
460
- switch intent {
461
- case let .skipTo(index):
462
- do {
463
- try player?.skipTo(index, playWhenReady: true)
464
- } catch {
465
- logger.error("Failed to skip to track at index \(index): \(error)")
466
- }
467
- case let .setQueue(tracks, startIndex, sourcePath):
468
- player?.setQueue(tracks, initialIndex: startIndex, playWhenReady: true, sourcePath: sourcePath)
469
- case let .loadTrack(track):
470
- player?.load(track, playWhenReady: true)
471
- }
472
- }
473
- }
474
-
475
- private func navigateToBrowsableUrl(_ url: String) {
476
- clearNavigationError()
477
- Task {
478
- do {
479
- try await browserManager.navigate(url)
480
- } catch {
481
- handleNavigationError(error, path: url)
482
- }
483
- }
484
- }
485
-
486
- public func onSearch(query: String) throws -> Promise<[Track]> {
487
- Promise.async { [weak self] in
488
- guard let self else { return [] }
489
- let resolved = try await browserManager.search(query)
490
- return resolved.children ?? []
491
- }
492
- }
493
-
494
- public func getContent() throws -> ResolvedTrack? {
495
- onMainActor { browserManager.getContent() }
496
- }
497
-
498
- public func getNavigationError() throws -> NavigationError? {
499
- onMainActor { lastNavigationError }
500
- }
501
-
502
- public func getFormattedNavigationError() throws -> FormattedNavigationError? {
503
- onMainActor { lastFormattedNavigationError }
504
- }
505
-
506
- /// Internal signal sent on `externalContentChangedEmitter` to tell CarPlay to
507
- /// refresh every displayed template. Not a real path (paths are always
508
- /// `/…`), so it can't collide with one; kept internal — the public API is
509
- /// `invalidateAllContent()`.
510
- static let invalidateAllSentinel = "__rnab_invalidate_all__"
511
-
512
- public func notifyContentChanged(path: String) throws {
513
- onMainActor { browserManager.invalidateContentCache(path) }
514
-
515
- // Notify external controllers (CarPlay) that content changed
516
- externalContentChangedEmitter.emit(path)
517
-
518
- // Re-resolve the path if it's the current browser path
519
- if onMainActor({ browserManager.getPath() }) == path {
520
- Task {
521
- do {
522
- try await browserManager.navigate(path)
523
- } catch {
524
- handleNavigationError(error, path: path)
253
+ audioSession.outputChanged.addListener { [weak self] in self?.onOutputChanged($0) }
254
+ audioSession.volumeChanged.addListener { [weak self] in self?.onSystemVolumeChanged($0) }
255
+ // Registered whether or not JS subscribes: the player needs it too.
256
+ networkMonitor.changed.addListener { [weak self] isOnline in
257
+ guard let self else { return }
258
+ MainActor.assumeIsolated {
259
+ self.onOnlineChanged(isOnline)
260
+ self.player?.networkStatusDidChange(isOnline: isOnline)
525
261
  }
526
262
  }
527
- }
528
- }
529
-
530
- public func invalidateAllContent() throws {
531
- onMainActor { browserManager.clearContentCache() }
532
-
533
- // Tell external controllers (CarPlay) to refresh every displayed template.
534
- externalContentChangedEmitter.emit(Self.invalidateAllSentinel)
535
-
536
- // Re-query the tabs source too: a callback source can resolve to new
537
- // titles after an invalidation (e.g. a locale switch). BrowserManager
538
- // emits tabsChanged only when the result actually differs, and a failed
539
- // re-query keeps the current tabs. (Android needs no equivalent — its
540
- // root re-query already runs queryTabs(); the web stub re-queries tabs on
541
- // the re-navigation.)
542
- Task {
543
- _ = try? await browserManager.queryTabs()
544
- }
545
-
546
- // Re-resolve the JS-facing current path with the cache cleared.
547
- Task {
548
- do {
549
- try await browserManager.refresh()
550
- } catch {
551
- handleNavigationError(error, path: onMainActor { browserManager.getPath() })
263
+ browseGate.resolve = { [weak self] request in
264
+ guard let self else { throw CancellationError() }
265
+ return try await resolveGate(request).awaitNestedOrTimeout()
552
266
  }
267
+ // Unconditional: `shared` is weak, so after a reload the old instance may be gone while
268
+ // CarPlay is still subscribed to its emitters.
269
+ HybridAudioBrowser.instanceChangedEmitter.emit(())
553
270
  }
271
+ forwardBrowserEventsToJS()
554
272
  }
555
273
 
556
- public func setFavorites(favorites: [String]) throws {
557
- onMainActor { browserManager.setFavorites(favorites) }
558
- }
559
-
560
- // MARK: - Gate
561
-
562
- /// The gate's default chrome, if one was set. Served when the resolver
563
- /// returns a gated decision with no per-request override, and for the static
564
- /// gate (no resolver). May be nil for a resolver-only gate.
565
- private(set) var defaultChrome: Gate?
566
-
567
- /// Whether JS installed a per-request resolver. When false the gate is static
568
- /// — every request is gated with `defaultChrome` and the JS hop is skipped.
569
- private(set) var hasResolver = false
570
-
571
- /// True once `setGate` runs, until `clearGate`. While active, external
572
- /// surfaces (CarPlay) keep their tabs visible but consult `gateDecision(for:)`
573
- /// per request, rendering the gate chrome where gated and refusing
574
- /// external-surface search. Playback, the queue and Now Playing are
575
- /// unaffected — a gate blocks finding content, never hearing it.
576
- private(set) var isGateActive = false
577
-
578
- /// The minimal built-in gate served when a request is gated but neither a
579
- /// per-request override nor a stored default chrome exists (resolver-only
580
- /// gate returning `true`).
581
- static let builtInGate = Gate(title: "Unavailable", message: nil)
582
-
583
- /// The outcome of a single gate decision: whether to gate, and (if so) the
584
- /// chrome to render.
585
- struct GateOutcome {
586
- let gated: Bool
587
- let chrome: Gate?
588
- }
589
-
590
- public func setGate(gate: Gate?, hasResolver: Bool) throws {
591
- onMainActor {
592
- defaultChrome = gate
593
- self.hasResolver = hasResolver
594
- isGateActive = true
595
- gateChangedEmitter.emit(true)
596
- }
597
- }
598
-
599
- public func clearGate() throws {
600
- onMainActor {
601
- guard isGateActive else { return }
602
- defaultChrome = nil
603
- hasResolver = false
604
- isGateActive = false
605
- gateChangedEmitter.emit(false)
606
- }
607
- }
274
+ @MainActor private var didDropJSCallbacks = false
608
275
 
609
- /// The single choke point for every gate enforcement site. Asks whether
610
- /// `request` should be gated and, if so, with what chrome (override → stored
611
- /// default → built-in). When no resolver is installed the gate is static and
612
- /// resolves without a JS hop.
613
- ///
614
- /// Resolver errors **fail CLOSED by design**: a thrown/rejected resolver, or a
615
- /// rejection at either `.await()` layer (bridge tear-down on JS reload, the JS
616
- /// runtime mid-reload, a serialization error) cannot prove the request is
617
- /// allowed — and a gate exists to withhold content, so serving on error would
618
- /// be a content leak (a paywall bypass). On error we gate with the stored
619
- /// default / built-in chrome so the user still sees a coherent gate page. A
620
- /// *successful* resolver returning `gated: false` still allows the request.
276
+ /// Drops every JS callback native code can invoke on its own (browse resolvers,
277
+ /// `handleTrackLoad`, `resolveAlbumPath`, `formatNavigationError`, `resolveGate`, the now-playing
278
+ /// formatter): calling into a dead runtime aborts the process (Nitro throws across a `noexcept`
279
+ /// boundary). Native code still bound here (CarPlay mid-reload) keeps the data-only config, and
280
+ /// `resolveGate` reverts to its fail-closed default. One-shot: the reload notification and the
281
+ /// replacement's `init` both reach the dying instance, and a second strip would re-run the
282
+ /// config setter's cascade.
621
283
  @MainActor
622
- func gateDecision(for request: NativeGateRequest) async -> GateOutcome {
623
- guard isGateActive else { return GateOutcome(gated: false, chrome: nil) }
624
- if !hasResolver { return GateOutcome(gated: true, chrome: defaultChrome ?? Self.builtInGate) }
625
- guard let decision = try? await resolveGate(request).await().await() else {
626
- // Resolver error: fail CLOSED (see doc comment) — gate with the default /
627
- // built-in so the gate page still renders rather than leaking content.
628
- return GateOutcome(gated: true, chrome: defaultChrome ?? Self.builtInGate)
629
- }
630
- guard decision.gated else { return GateOutcome(gated: false, chrome: nil) } // explicit allow
631
- return GateOutcome(gated: true, chrome: decision.gate ?? defaultChrome ?? Self.builtInGate)
632
- }
633
-
634
- // MARK: - Car Connection (CarPlay)
635
-
636
- /// Static because the CarPlay scene can connect before the JS runtime
637
- /// creates the shared instance (cold start in the car).
638
- private nonisolated(unsafe) static var carPlayConnected = false
639
-
640
- /// Called by the CarPlay scene delegate (via `RNABCarPlayController`) on
641
- /// scene connect/disconnect — not from controller start/stop, which also
642
- /// cycle on a JS reload and would emit spurious connection changes.
643
- static func setCarPlayConnected(_ connected: Bool) {
644
- guard carPlayConnected != connected else { return }
645
- carPlayConnected = connected
646
- shared?.onCarConnectedChanged(connected)
647
- }
648
-
649
- public func isCarConnected() throws -> Bool {
650
- HybridAudioBrowser.carPlayConnected
651
- }
652
-
653
- public var onCarConnectedChanged: (Bool) -> Void = { _ in } {
654
- didSet {
655
- // Immediately notify current state (the scene may have connected before
656
- // this JS runtime subscribed).
657
- onCarConnectedChanged(HybridAudioBrowser.carPlayConnected)
284
+ private func dropStaleJSCallbacks() {
285
+ guard !didDropJSCallbacks else { return }
286
+ didDropJSCallbacks = true
287
+ // Assigning `config` marks the browser configured, and a never-configured browser must keep
288
+ // CarPlay and Siri waiting on `playerAndConfiguredBrowser`, not serve them an empty config.
289
+ if browserManager.isConfigured {
290
+ browserManager.config = browserManager.config.strippingJSCallbacks()
658
291
  }
292
+ resolveGate = Self.defaultResolveGate
293
+ engine?.nowPlayingUpdater.formatter = nil
659
294
  }
660
295
 
661
- // MARK: - Player Setup
662
-
663
- public func setupPlayer(options: NativeSetupPlayerOptions) throws -> Promise<Void> {
664
- Promise.async {
665
- // Configure the audio session from the iOS setup options (category, mode, route policy, and
666
- // options like `allowBluetooth` / `allowAirPlay`), but do NOT activate it here. Activating a
667
- // non-mixable `.playback` session interrupts other apps' audio — so activating at setup
668
- // pauses whatever the user is listening to (Safari, Spotify, a podcast) the instant our app
669
- // launches, before they play anything. Setting the category is silent; only activation
670
- // interrupts. The session is activated lazily when playback actually starts producing output
671
- // (see `playerDidChangePlayingState`) and re-activated on interruption-end. Best-effort: a
672
- // category-config failure must never brick setup.
673
- let session = AVAudioSession.sharedInstance()
674
- let cfg: (
675
- category: AVAudioSession.Category,
676
- mode: AVAudioSession.Mode,
677
- policy: AVAudioSession.RouteSharingPolicy,
678
- options: AVAudioSession.CategoryOptions,
679
- ) = options.ios?.resolveAudioSessionConfig()
680
- ?? (category: .playback, mode: .default, policy: .default, options: [])
681
- // Capture category application once so a media-services reset (which
682
- // clears the category) can restore the exact same config later.
683
- let applyCategory: () -> Void = {
684
- try? session.setCategory(cfg.category, mode: cfg.mode, policy: cfg.policy, options: cfg.options)
685
- }
686
- applyCategory()
687
-
688
- // Create player and configure on main actor
689
- await MainActor.run { [weak self] in
690
- guard let self else { return }
691
- self.applyAudioSessionCategory = applyCategory
692
-
693
- // Create player with self as callbacks delegate
694
- player = TrackPlayer(callbacks: self)
695
-
696
- // Apply buffer duration from options (in ms)
697
- if let buffer = options.ios?.buffer {
698
- player?.bufferDuration = buffer
699
- }
700
-
701
- // Apply retry configuration (top-level, cross-platform)
702
- if let retry = options.retry {
703
- player?.retryConfig = retry
704
- }
705
-
706
- // Wire up network monitor for accelerated retries when connectivity is restored
707
- player?.networkMonitor = networkMonitor
708
-
709
- // Central fan-out for connectivity changes (wired once here, idempotent on re-setup, and
710
- // independent of any JS subscription):
711
- // - bridge to the JS `onOnlineChanged` event (no-op default until JS subscribes);
712
- // - re-render now-playing so the formatter's offline/online label updates immediately on a
713
- // connectivity change, not only on the next playback transition (fixes the stall-entry
714
- // race where the device goes offline after the buffering line was already rendered);
715
- // - reconnect a stalled stream when connectivity returns (see TrackPlayer.handleNetworkRestored).
716
- // The monitor only mutates state on the main thread, so this fires main-isolated.
717
- networkMonitor.onChanged = { [weak self] isOnline in
718
- MainActor.assumeIsolated {
719
- guard let self else { return }
720
- self.onOnlineChanged(isOnline)
721
- self.applyNowPlayingMetadata()
722
- if isOnline { self.player?.handleNetworkRestored() }
723
- }
724
- }
725
-
726
- // Observe audio-session interruptions so another app taking over audio
727
- // (or a phone call) reflects as a real pause rather than a stuck state.
728
- setupInterruptionObserver()
729
-
730
- // Observe media-server resets so a long-running stream recovers instead
731
- // of going permanently silent.
732
- setupMediaServicesResetObserver()
733
-
734
- // Configure media URL resolver
735
- player?.mediaLoader.mediaUrlResolver = { [weak self] src, track in
736
- guard let self else {
737
- return MediaResolvedUrl(url: src, headers: nil, userAgent: nil)
738
- }
739
- return await browserManager.resolveMediaUrl(src, track: track)
740
- }
741
-
742
- // Configure artwork URL resolver for Now Playing (with size context)
743
- player?.nowPlayingUpdater.artworkUrlResolver = { [weak self] track, imageContext in
744
- guard let self else { return nil }
745
- let perRoute = (track.id?.isEmpty == false) ? browserManager.config.nowPlayingArtwork : nil
746
- return await browserManager.resolveArtworkUrl(track: track, perRouteConfig: perRoute, imageContext: imageContext)
747
- }
748
-
749
- // Emit the JS `onNowPlayingChanged` event when the rendered text lines change. The updater
750
- // owns the system now-playing write; this shapes the JS metadata (elapsed time / artwork).
751
- player?.nowPlayingUpdater.onChanged = { [weak self] track, title, artist, album in
752
- guard let self else { return }
753
- self.onNowPlayingChanged(
754
- self.makeNowPlayingMetadata(track: track, title: title, artist: artist, album: album))
755
- }
756
-
757
- // Configure sleep timer callback
758
- player?.sleepTimerManager.onChanged = { [weak self] state in
759
- self?.onSleepTimerChanged(state)
760
- }
761
-
762
- // Now-playing: whether to manage metadata, and the optional formatter that owns the
763
- // rendered lines.
764
- nowPlayingMetadataEnabled = options.autoUpdateNowPlayingMetadata ?? true
765
- nowPlayingMetadataFormatter = options.nowPlayingMetadataFormatter
766
- // `options.keepSessionAliveOnError` is deliberately ignored here: iOS needs no masking.
767
- // A terminal error resolves the playback state to *paused*
768
- // (PlaybackCoordinator.applySideEffects), the now-playing info is retained (never cleared
769
- // on error), and next/previous stay enabled (gated on queue position, not state). So the
770
- // session stays controllable through errors by default — the behavior Android achieves via
771
- // InterceptingPlayer is already the iOS norm.
772
-
773
- // The bundled runtime options and initial state are part of the atomic launch
774
- // description. Stage the state first so setup options and earlier pre-setup setter
775
- // calls resolve by strict last-write-wins, then apply everything to the live player.
776
- if let bundled = options.options {
777
- updateOptions(options: bundled)
778
- } else {
779
- // updateOptions applies remote commands itself; without bundled options, apply the
780
- // defaults (play, pause, next, previous, seekTo) here.
781
- applyRemoteCommands()
782
- }
783
- if let mode = options.repeatMode { pendingRepeatMode = mode }
784
- if let intent = options.playWhenReady { pendingPlayWhenReady = intent }
785
- applyPendingPlayerState()
786
-
787
- // Notify listeners that player is ready (e.g., CarPlay)
788
- playerAndConfiguredBrowser.check()
789
- }
790
- }
296
+ deinit {
297
+ // Safety net: the AVPlayer must not outlive this instance. `self` can't reach the main actor
298
+ // from here, so the teardown captures what it releases.
299
+ let player = self.player, engine = self.engine
300
+ let tearDown: @Sendable () -> Void = { MainActor.assumeIsolated { Self.destroy(player, engine) } }
301
+ if Thread.isMainThread { tearDown() } else { DispatchQueue.main.async(execute: tearDown) }
791
302
  }
792
303
 
793
- /// Applies initial player state staged before the player existed — from setup options or the
794
- /// imperative setters called pre-setup. Consumed on apply so a later re-setup doesn't replay
795
- /// stale state.
304
+ /// Stops the player and releases its media stack; the AVPlayer and the now-playing session
305
+ /// otherwise outlive a dropped reference.
796
306
  @MainActor
797
- private func applyPendingPlayerState() {
798
- guard let player else { return }
799
- if let mode = pendingRepeatMode {
800
- player.repeatMode = mode
801
- pendingRepeatMode = nil
802
- }
803
- if let intent = pendingPlayWhenReady {
804
- player.playWhenReady = intent
805
- pendingPlayWhenReady = nil
806
- }
807
- }
808
-
809
- public func updateOptions(options: NativeUpdateOptions) {
810
- onMainActor {
811
- let previousInterval = playerOptions.progressUpdateEventInterval
812
-
813
- // Update stored options
814
- playerOptions.update(from: options)
815
-
816
- // Propagate the favorite match mode to the browser so it can hydrate
817
- // row hearts (the `favorite` capability is the single favoriting switch).
818
- browserManager.setFavoriteMatch(playerOptions.capabilities.favoriteMatch)
819
-
820
- // Apply remote commands to player
821
- applyRemoteCommands()
822
-
823
- // Apply progress update interval if changed
824
- if playerOptions.progressUpdateEventInterval != previousInterval {
825
- player?.setProgressUpdateInterval(playerOptions.progressUpdateEventInterval)
826
- }
827
-
828
- onOptionsChanged(playerOptions.toOptions())
829
- playerOptionsChangedEmitter.emit(())
830
- }
307
+ func destroyPlayer() {
308
+ Self.destroy(player, engine)
831
309
  }
832
310
 
833
- /// Converts capabilities to remote commands and applies them to the player
834
311
  @MainActor
835
- private func applyRemoteCommands() {
836
- guard let player else { return }
837
-
838
- let remoteCommands = playerOptions.capabilities.buildRemoteCommands(
839
- forwardJumpInterval: NSNumber(value: playerOptions.forwardJumpInterval),
840
- backwardJumpInterval: NSNumber(value: playerOptions.backwardJumpInterval),
841
- playbackRates: playerOptions.playbackRates,
842
- )
843
-
844
- player.remoteCommands = remoteCommands
845
- }
846
-
847
- public func getOptions() throws -> Options {
848
- onMainActor { playerOptions.toOptions() }
849
- }
850
-
851
- public func setPlaybackIntervalEnabled(enabled: Bool) {
852
- onMainActor { player?.setPlaybackIntervalEnabled(enabled) }
853
- }
854
-
855
- // MARK: - Playback Control
856
-
857
- public func load(track: Track) throws {
858
- try onMainActor {
859
- guard let player else {
860
- throw NSError(domain: "AudioBrowser", code: 1, userInfo: [NSLocalizedDescriptionKey: "Player not initialized"])
861
- }
862
- player.load(track)
863
- }
864
- }
865
-
866
- public func reset() throws {
867
- onMainActor { player?.clear() }
868
- }
869
-
870
- public func play() throws {
871
- onMainActor { player?.play() }
872
- }
873
-
874
- public func pause() throws {
875
- onMainActor { player?.pause() }
876
- }
877
-
878
- public func togglePlayback() throws {
879
- onMainActor { player?.togglePlayback() }
880
- }
881
-
882
- public func stop() throws {
883
- onMainActor { player?.stop() }
884
- }
885
-
886
- public func setPlayWhenReady(playWhenReady: Bool) throws {
887
- onMainActor {
888
- // Pre-setup this stages the intent for the player to come up with — never a no-op.
889
- if let player { player.playWhenReady = playWhenReady }
890
- else { pendingPlayWhenReady = playWhenReady }
891
- }
892
- }
893
-
894
- public func getPlayWhenReady() throws -> Bool {
895
- onMainActor { player?.playWhenReady ?? pendingPlayWhenReady ?? false }
896
- }
897
-
898
- public func seekTo(position: Double) throws {
899
- onMainActor { player?.seekTo(position) }
900
- }
901
-
902
- public func seekBy(offset: Double) throws {
903
- onMainActor { player?.seekBy(offset) }
904
- }
905
-
906
- public func seekToLiveEdge() throws {
907
- onMainActor { player?.seekToLiveEdge() }
908
- }
909
-
910
- public func setVolume(level: Double) throws {
911
- onMainActor { player?.volume = Float(level) }
912
- }
913
-
914
- public func getVolume() throws -> Double {
915
- onMainActor { Double(player?.volume ?? 1.0) }
916
- }
917
-
918
- public func setRate(rate: Double) throws {
919
- onMainActor { player?.rate = Float(rate) }
920
- }
921
-
922
- public func getRate() throws -> Double {
923
- onMainActor { Double(player?.rate ?? 1.0) }
924
- }
925
-
926
- public func getProgress() throws -> Progress {
927
- onMainActor {
928
- Progress(
929
- position: player?.currentTime ?? 0,
930
- duration: player?.duration ?? 0,
931
- buffered: player?.bufferedPosition ?? 0,
932
- )
933
- }
934
- }
935
-
936
- public func getPlayback() throws -> Playback {
937
- onMainActor { player?.getPlayback() ?? Playback(state: .none, error: nil) }
938
- }
939
-
940
- public func getPlayingState() throws -> PlayingState {
941
- onMainActor {
942
- player?.playingStateManager.toPlayingState() ?? PlayingState(playing: false, buffering: false)
943
- }
944
- }
945
-
946
- public func getRepeatMode() throws -> RepeatMode {
947
- onMainActor { player?.repeatMode ?? pendingRepeatMode ?? .off }
948
- }
949
-
950
- public func setRepeatMode(mode: RepeatMode) throws {
951
- onMainActor {
952
- // Pre-setup this stages the mode for the player to come up with — never a no-op.
953
- if let player { player.repeatMode = mode }
954
- else { pendingRepeatMode = mode }
955
- }
956
- }
957
-
958
- public func getShuffleEnabled() throws -> Bool {
959
- onMainActor { player?.shuffleEnabled ?? false }
960
- }
961
-
962
- public func setShuffleEnabled(enabled: Bool) throws {
963
- onMainActor { player?.shuffleEnabled = enabled }
964
- }
965
-
966
- public func getPlaybackError() throws -> PlaybackError? {
967
- onMainActor { player?.coordinator.nitroPlaybackError() }
968
- }
969
-
970
- public func retry() throws {
971
- // Re-resolve rather than replay the cached URL: short-lived URLs/tokens
972
- // may have expired since the failure (matches the internal retry path).
973
- onMainActor { player?.reloadResolving(startFromCurrentTime: true) }
974
- }
975
-
976
- // MARK: - Sleep Timer
977
-
978
- public func getSleepTimer() throws -> SleepTimer {
979
- onMainActor {
980
- if let state = player?.sleepTimerManager.get() {
981
- return state
982
- }
983
- return .first(NullType.null)
984
- }
985
- }
986
-
987
- public func setSleepTimer(seconds: Double, fadeDuration: Double?) throws {
988
- onMainActor {
989
- player?.sleepTimerManager.set(seconds: seconds, fadeDuration: fadeDuration)
990
- }
991
- }
992
-
993
- public func setSleepTimerToEndOfTrack() throws {
994
- onMainActor {
995
- player?.sleepTimerManager.setToEndOfTrack()
996
- }
997
- }
998
-
999
- public func clearSleepTimer() throws -> Bool {
1000
- onMainActor {
1001
- player?.sleepTimerManager.clear() ?? false
1002
- }
1003
- }
1004
-
1005
- // MARK: - Queue Management
1006
-
1007
- public func add(tracks: [Track], insertBeforeIndex: Double?) throws {
1008
- try onMainActor {
1009
- guard let player else { return }
1010
- if let index = insertBeforeIndex {
1011
- try player.add(tracks, at: Int(index))
1012
- } else {
1013
- player.add(tracks)
1014
- }
1015
- }
1016
- }
1017
-
1018
- public func move(fromIndex: Double, toIndex: Double) throws {
1019
- try onMainActor {
1020
- try player?.move(fromIndex: Int(fromIndex), toIndex: Int(toIndex))
1021
- }
1022
- }
1023
-
1024
- public func remove(indexes: [Double]) throws {
1025
- try onMainActor {
1026
- guard let player else { return }
1027
- // Remove in reverse order to maintain index validity
1028
- for index in indexes.sorted().reversed() {
1029
- try player.remove(Int(index))
1030
- }
1031
- }
1032
- }
1033
-
1034
- public func removeUpcomingTracks() throws {
1035
- onMainActor { player?.removeUpcomingTracks() }
1036
- }
1037
-
1038
- public func skip(index: Double, initialPosition: Double?) throws {
1039
- try onMainActor {
1040
- try player?.skipTo(Int(index))
1041
- if let position = initialPosition {
1042
- player?.seekTo(position)
1043
- }
1044
- }
1045
- }
1046
-
1047
- public func skipToNext(initialPosition: Double?) throws {
1048
- onMainActor {
1049
- player?.next()
1050
- if let position = initialPosition {
1051
- player?.seekTo(position)
1052
- }
1053
- }
1054
- }
1055
-
1056
- public func skipToPrevious(initialPosition: Double?) throws {
1057
- onMainActor {
1058
- player?.previous()
1059
- if let position = initialPosition {
1060
- player?.seekTo(position)
1061
- }
1062
- }
1063
- }
1064
-
1065
- public func setActiveTrackFavorited(favorited: Bool) throws {
1066
- onMainActor {
1067
- guard let track = player?.currentTrack, let src = track.src else { return }
1068
- guard let index = player?.currentIndex, index >= 0 else { return }
1069
- // Optimistically reflect in the authoritative match set so the now-playing
1070
- // heart (hydrated from it in getActiveTrack) flips immediately; native
1071
- // reconciles to its canonical ids on the next setFavorites.
1072
- browserManager.setFavorited(src: src, favorited: favorited)
1073
- let updatedTrack = track.copying(favorited: favorited)
1074
- favoriteChangedEmitter.emit(FavoriteChangedEvent(track: updatedTrack, favorited: favorited))
1075
- // Fire active track changed so the now-playing heart + useActiveTrack() refresh.
1076
- let position = player?.currentTime ?? 0
1077
- activeTrackChangedEmitter.emit(PlaybackActiveTrackChangedEvent(
1078
- lastIndex: Double(index),
1079
- lastTrack: track,
1080
- lastPosition: position,
1081
- index: Double(index),
1082
- track: updatedTrack,
1083
- ))
1084
- }
1085
- }
1086
-
1087
- /// Whether the active (now-playing) track is favorited, per the authoritative
1088
- /// favorite set (via `getActiveTrack`'s hydration).
1089
- func isActiveTrackFavorited() -> Bool {
1090
- (try? getActiveTrack())?.favorited ?? false
1091
- }
1092
-
1093
- public func toggleActiveTrackFavorited() throws {
1094
- try? setActiveTrackFavorited(favorited: !isActiveTrackFavorited())
1095
- }
1096
-
1097
- public func setQueue(tracks: [Track], startIndex: Double?, startPosition: Double?) throws {
1098
- onMainActor {
1099
- guard let player else { return }
1100
- player.setQueue(
1101
- tracks,
1102
- initialIndex: startIndex.map { Int($0) } ?? 0,
1103
- startPositionMs: startPosition.map { $0 * 1000 },
1104
- )
1105
- }
1106
- }
1107
-
1108
- public func getQueue() throws -> [Track] {
1109
- onMainActor { player?.tracks ?? [] }
1110
- }
1111
-
1112
- public func getTrack(index: Double) throws -> Track? {
1113
- onMainActor {
1114
- guard let tracks = player?.tracks else { return nil }
1115
- let i = Int(index)
1116
- guard i >= 0, i < tracks.count else { return nil }
1117
- return tracks[i]
1118
- }
1119
- }
1120
-
1121
- public func getActiveTrackIndex() throws -> Double? {
1122
- onMainActor {
1123
- guard let index = player?.currentIndex, index >= 0 else { return nil }
1124
- return Double(index)
1125
- }
1126
- }
1127
-
1128
- public func getActiveTrack() throws -> Track? {
1129
- // Hydrate `favorited` from the authoritative favorite set — the now-playing
1130
- // track is loaded outside the browse cache, so its own flag isn't otherwise
1131
- // kept in sync as favorites change. This is the single source of truth for
1132
- // "is the active track favorited" (now-playing heart, toggle direction, JS).
1133
- onMainActor { player?.currentTrack.map(browserManager.hydrateFavorite) }
1134
- }
1135
-
1136
- // MARK: - Now Playing
1137
-
1138
- public func updateNowPlaying(update: NowPlayingUpdate?) throws {
1139
- onMainActor {
1140
- nowPlayingOverride = update
1141
- applyNowPlayingMetadata()
1142
- }
1143
- }
1144
-
1145
- /// Transient now-playing fields (e.g. feedback for a refused remote
1146
- /// command). Outranks the formatter and the override while active, so live
1147
- /// metadata can't stomp it mid-flash. Reverted by a NATIVE timer — JS
1148
- /// timers pause with a backgrounded host on Android, and the lock screen
1149
- /// is exactly the backgrounded case — and cleared early on track change.
1150
- @MainActor private var nowPlayingFlash: NowPlayingUpdate?
1151
- @MainActor private var nowPlayingFlashRevert: DispatchWorkItem?
1152
-
1153
- /// Pending debounced audio-session release (see `playerShouldReleaseSession`).
1154
- @MainActor private var sessionReleaseWork: DispatchWorkItem?
1155
-
1156
- public func flashNowPlaying(update: NowPlayingUpdate, durationMs: Double) throws {
1157
- onMainActor {
1158
- nowPlayingFlashRevert?.cancel()
1159
- nowPlayingFlash = update
1160
- let revert = DispatchWorkItem { [weak self] in
1161
- guard let self else { return }
1162
- self.nowPlayingFlash = nil
1163
- self.nowPlayingFlashRevert = nil
1164
- self.applyNowPlayingMetadata()
1165
- }
1166
- nowPlayingFlashRevert = revert
1167
- DispatchQueue.main.asyncAfter(deadline: .now() + durationMs / 1000, execute: revert)
1168
- applyNowPlayingMetadata()
1169
- }
1170
- }
1171
-
1172
- public func clearNowPlayingFlash() throws {
1173
- onMainActor {
1174
- guard nowPlayingFlash != nil else { return }
1175
- cancelNowPlayingFlash()
1176
- applyNowPlayingMetadata()
1177
- }
1178
- }
1179
-
1180
- @MainActor
1181
- private func cancelNowPlayingFlash() {
1182
- nowPlayingFlashRevert?.cancel()
1183
- nowPlayingFlashRevert = nil
1184
- nowPlayingFlash = nil
1185
- }
1186
-
1187
- public func getNowPlaying() throws -> NowPlayingMetadata? {
1188
- onMainActor {
1189
- guard let track = player?.currentTrack else { return nil }
1190
- let flash = nowPlayingFlash
1191
- let override = nowPlayingOverride
1192
- return makeNowPlayingMetadata(
1193
- track: track,
1194
- title: flash?.title ?? override?.title ?? track.title,
1195
- artist: flash?.artist ?? override?.artist ?? track.artist,
1196
- album: flash?.album ?? override?.album ?? track.album,
1197
- )
1198
- }
1199
- }
1200
-
1201
- /// Returns the artwork URI suitable for JS consumption.
1202
- /// Prefers the resolved artworkSource URI (e.g. file:// for rendered SF Symbols).
1203
- /// Falls back to the raw artwork string only if it's not an SF Symbol (which JS can't load).
1204
- private func nowPlayingArtwork(for track: Track) -> String? {
1205
- if let uri = track.artworkSource?.uri { return uri }
1206
- guard let artwork = track.artwork?.url else { return nil }
1207
- return SFSymbolRenderer.isSFSymbol(artwork) ? nil : artwork
1208
- }
1209
-
1210
- /// Builds the JS-facing now-playing metadata for the given rendered text lines.
1211
- @MainActor
1212
- private func makeNowPlayingMetadata(
1213
- track: Track, title: String, artist: String?, album: String?,
1214
- ) -> NowPlayingMetadata {
1215
- NowPlayingMetadata(
1216
- elapsedTime: player?.currentTime,
1217
- title: title,
1218
- album: album,
1219
- artist: artist,
1220
- duration: track.duration,
1221
- artwork: nowPlayingArtwork(for: track),
1222
- description: track.description,
1223
- mediaId: track.src ?? track.url,
1224
- genre: track.genre,
1225
- )
1226
- }
1227
-
1228
- /// Re-renders the now-playing surface via `NowPlayingUpdater`, handing it the current playback
1229
- /// signals, override, and formatter. Called on every track / metadata / playback-state change.
1230
- @MainActor
1231
- private func applyNowPlayingMetadata() {
1232
- guard let player, let track = player.currentTrack else { return }
1233
- // Classify a stall by connectivity so the formatter can show "No internet connection" vs
1234
- // "Reconnecting…" without a separate read. nil while not stalled.
1235
- let stalled: StallReason? =
1236
- player.isStalled ? (networkMonitor.getOnline() ? .buffering : .offline) : nil
1237
- player.nowPlayingUpdater.render(
1238
- track: track,
1239
- timedMetadata: latestTimedMetadata,
1240
- playWhenReady: player.playWhenReady,
1241
- stalled: stalled,
1242
- error: player.coordinator.nitroPlaybackError(),
1243
- flash: nowPlayingFlash,
1244
- override: nowPlayingMetadataEnabled ? nowPlayingOverride : nil,
1245
- formatter: nowPlayingMetadataEnabled ? nowPlayingMetadataFormatter : nil,
1246
- )
1247
- }
1248
-
1249
- // MARK: - Network
1250
-
1251
- public func getOnline() throws -> Bool {
1252
- networkMonitor.getOnline()
1253
- }
1254
-
1255
- // MARK: - System Volume
1256
-
1257
- /// Sets up KVO observer for system volume changes
1258
- private func setupVolumeObserver() {
1259
- // Remove existing observation if any
1260
- volumeObservation?.invalidate()
1261
-
1262
- let audioSession = AVAudioSession.sharedInstance()
1263
- volumeObservation = audioSession.observe(\.outputVolume, options: [.new]) { [weak self] _, change in
1264
- guard let newVolume = change.newValue else { return }
1265
- self?.onSystemVolumeChanged(Double(newVolume))
1266
- }
1267
- }
1268
-
1269
- public func getSystemVolume() throws -> Double {
1270
- Double(AVAudioSession.sharedInstance().outputVolume)
1271
- }
1272
-
1273
- public func setSystemVolume(volume _: Double) throws {
1274
- // iOS doesn't provide a public API to set system volume programmatically.
1275
- // Users must adjust volume via hardware buttons or Control Center.
1276
- logger.debug("setSystemVolume is not supported on iOS - volume must be adjusted via hardware buttons or Control Center")
1277
- }
1278
-
1279
- // MARK: - External Audio Output
1280
-
1281
- /// Observes audio-session interruptions (phone calls, or another app such as
1282
- /// Music/Spotify starting playback). iOS pauses our AVPlayer underneath us but
1283
- /// doesn't update our playback state, so without this the UI stays stuck on
1284
- /// "playing". On `.began` we reflect a real pause; on `.ended` we resume if we
1285
- /// were playing and the system says we should.
1286
- private func setupInterruptionObserver() {
1287
- if let observer = interruptionObserver {
1288
- NotificationCenter.default.removeObserver(observer)
1289
- }
1290
-
1291
- interruptionObserver = NotificationCenter.default.addObserver(
1292
- forName: AVAudioSession.interruptionNotification,
1293
- object: nil,
1294
- queue: .main,
1295
- ) { [weak self] notification in
1296
- self?.handleAudioSessionInterruption(notification)
1297
- }
1298
- }
1299
-
1300
- private func handleAudioSessionInterruption(_ notification: Notification) {
1301
- guard
1302
- let info = notification.userInfo,
1303
- let typeValue = info[AVAudioSessionInterruptionTypeKey] as? UInt,
1304
- let type = AVAudioSession.InterruptionType(rawValue: typeValue)
1305
- else { return }
1306
-
1307
- switch type {
1308
- case .began:
1309
- // iOS 17+ fires a `.began` (with no matching `.ended`) when an output
1310
- // route such as headphones disappears. Reflecting a pause here would
1311
- // strand resume-intent state with nothing to clear it, and the
1312
- // route-change observer already handles the output change — so ignore it.
1313
- if #available(iOS 17.0, *),
1314
- let reasonValue = info[AVAudioSessionInterruptionReasonKey] as? UInt,
1315
- AVAudioSession.InterruptionReason(rawValue: reasonValue) == .routeDisconnected
1316
- {
1317
- return
1318
- }
1319
- onMainActor { player?.handleInterruptionBegan() }
1320
- case .ended:
1321
- let shouldResume = (info[AVAudioSessionInterruptionOptionKey] as? UInt)
1322
- .map { AVAudioSession.InterruptionOptions(rawValue: $0).contains(.shouldResume) }
1323
- ?? false
1324
- onMainActor {
1325
- // Reactivate the possibly-deactivated session before resuming — but
1326
- // only when a resume will happen: activating while staying paused
1327
- // grabs a non-mixable session with nothing to release it.
1328
- if shouldResume, player?.willResumeAfterInterruption == true {
1329
- try? AVAudioSession.sharedInstance().setActive(true)
1330
- }
1331
- player?.handleInterruptionEnded(shouldResume: shouldResume)
1332
- }
1333
- @unknown default:
1334
- break
1335
- }
1336
- }
1337
-
1338
- /// Sets up observer for audio route changes
1339
- private func setupRouteChangeObserver() {
1340
- if let observer = routeChangeObserver {
1341
- NotificationCenter.default.removeObserver(observer)
1342
- }
1343
-
1344
- routeChangeObserver = NotificationCenter.default.addObserver(
1345
- forName: AVAudioSession.routeChangeNotification,
1346
- object: nil,
1347
- queue: .main,
1348
- ) { [weak self] notification in
1349
- guard let self else { return }
1350
- // The previous output disappeared (headphones unplugged, a Bluetooth
1351
- // speaker powered off). Pause rather than abruptly resume out of the
1352
- // built-in speaker — the platform convention every media app follows.
1353
- // A deliberate pause (clears play intent), not an interruption: the user
1354
- // restarts playback themselves once they want it.
1355
- if let reasonValue = notification.userInfo?[AVAudioSessionRouteChangeReasonKey] as? UInt,
1356
- AVAudioSession.RouteChangeReason(rawValue: reasonValue) == .oldDeviceUnavailable
1357
- {
1358
- // Also cancels a pending interruption auto-resume: unplugging during
1359
- // a call must not blast the built-in speaker when the call ends.
1360
- self.onMainActor { self.player?.handleRouteDisconnected() }
1361
- }
1362
- if let output = self.getCurrentOutput() {
1363
- self.onOutputChanged(output)
1364
- }
1365
- }
1366
- }
1367
-
1368
- /// Observes audio-server (`mediaserverd`) resets. When it fires, the session
1369
- /// category is cleared and every AVPlayer/session handle is invalid — a
1370
- /// long-running stream would otherwise go permanently silent until the app
1371
- /// restarts.
1372
- private func setupMediaServicesResetObserver() {
1373
- if let observer = mediaServicesResetObserver {
1374
- NotificationCenter.default.removeObserver(observer)
1375
- }
1376
- mediaServicesResetObserver = NotificationCenter.default.addObserver(
1377
- forName: AVAudioSession.mediaServicesWereResetNotification,
1378
- object: nil,
1379
- queue: .main,
1380
- ) { [weak self] _ in
1381
- guard let self else { return }
1382
- // Re-apply our category (the reset cleared it), then have the player
1383
- // recreate itself and reconnect the current stream.
1384
- self.onMainActor {
1385
- self.applyAudioSessionCategory()
1386
- self.player?.handleMediaServicesReset()
1387
- }
1388
- }
1389
- }
1390
-
1391
- /// Gets the current audio output info
1392
- private func getCurrentOutput() -> Output? {
1393
- let session = AVAudioSession.sharedInstance()
1394
- guard let output = session.currentRoute.outputs.first else { return nil }
1395
-
1396
- let (outputType, external): (OutputType, Bool) = switch output.portType {
1397
- case .builtInSpeaker:
1398
- (.speaker, false)
1399
- case .builtInReceiver:
1400
- (.receiver, false)
1401
- case .airPlay:
1402
- (.airplay, true)
1403
- case .bluetoothA2DP, .bluetoothHFP, .bluetoothLE:
1404
- (.bluetooth, true)
1405
- case .headphones:
1406
- (.headphones, true)
1407
- case .carAudio:
1408
- (.car, true)
1409
- case .HDMI:
1410
- (.hdmi, true)
1411
- case .usbAudio:
1412
- (.usb, true)
1413
- default:
1414
- (.other, true)
1415
- }
1416
-
1417
- return Output(type: outputType, name: output.portName, external: external)
1418
- }
1419
-
1420
- public func getOutput() throws -> Output? {
1421
- getCurrentOutput()
1422
- }
1423
-
1424
- public func supportsOutputSwitcher() throws -> Bool {
1425
- // iOS can always present the system route picker (AVRoutePickerView).
1426
- true
1427
- }
1428
-
1429
- public func openOutputPicker() throws {
1430
- DispatchQueue.main.async { [weak self] in
1431
- guard let self else { return }
1432
- guard let windowScene = UIApplication.shared.connectedScenes
1433
- .compactMap({ $0 as? UIWindowScene })
1434
- .first(where: { $0.activationState == .foregroundActive }),
1435
- let window = windowScene.windows.first(where: { $0.isKeyWindow }),
1436
- var topController = window.rootViewController
1437
- else {
1438
- self.logger.error("openOutputPicker: no active window scene / root view controller")
1439
- return
1440
- }
1441
-
1442
- // Walk up to the topmost presented view controller
1443
- while let presented = topController.presentedViewController {
1444
- topController = presented
1445
- }
1446
-
1447
- // AVRoutePickerView has no public API to present its picker
1448
- // programmatically, so we add it to the hierarchy and tap its internal
1449
- // button. Two requirements that are easy to get wrong:
1450
- // 1. The view must be *visible* to the system (a `isHidden` source view
1451
- // suppresses the presentation), so we keep it transparent instead.
1452
- // 2. The internal button can be nested below the top-level subviews on
1453
- // modern iOS, so we search recursively rather than only direct children.
1454
- let routePicker = AVRoutePickerView(frame: CGRect(x: 0, y: 0, width: 1, height: 1))
1455
- routePicker.alpha = 0.01
1456
- topController.view.addSubview(routePicker)
1457
-
1458
- let button = Self.firstButton(in: routePicker)
1459
- self.logger.notice(
1460
- "openOutputPicker: hierarchy=\(Self.describeHierarchy(routePicker), privacy: .public), buttonFound=\(button != nil, privacy: .public)",
1461
- )
1462
-
1463
- if let button {
1464
- button.sendActions(for: .touchUpInside)
1465
- } else {
1466
- self.logger.error("openOutputPicker: no UIButton found inside AVRoutePickerView")
1467
- }
1468
-
1469
- // Keep the source view in the hierarchy long enough for the picker to
1470
- // present (on iPad it anchors a popover to this view).
1471
- DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
1472
- routePicker.removeFromSuperview()
1473
- }
1474
- }
1475
- }
1476
-
1477
- /// Depth-first search for the first `UIButton` inside a view tree.
1478
- private static func firstButton(in view: UIView) -> UIButton? {
1479
- if let button = view as? UIButton { return button }
1480
- for subview in view.subviews {
1481
- if let button = firstButton(in: subview) { return button }
1482
- }
1483
- return nil
1484
- }
1485
-
1486
- /// Compact description of a view tree, e.g. `AVRoutePickerView[UIButton[UIImageView]]`.
1487
- private static func describeHierarchy(_ view: UIView) -> String {
1488
- let name = String(describing: type(of: view))
1489
- let children = view.subviews.map(describeHierarchy).joined(separator: ", ")
1490
- return children.isEmpty ? name : "\(name)[\(children)]"
1491
- }
1492
-
1493
- // MARK: - Equalizer (unsupported on iOS)
1494
-
1495
- public func getEqualizerSettings() throws -> EqualizerSettings? {
1496
- // No-op: equalizer unsupported on iOS
1497
- nil
1498
- }
1499
-
1500
- public func setEqualizerEnabled(enabled _: Bool) throws {
1501
- // No-op: equalizer unsupported on iOS
1502
- }
1503
-
1504
- public func setEqualizerPreset(preset _: String) throws {
1505
- // No-op: equalizer unsupported on iOS
1506
- }
1507
-
1508
- public func setEqualizerLevels(levels _: [Double]) throws {
1509
- // No-op: equalizer unsupported on iOS
1510
- }
1511
-
1512
- // MARK: - Battery (Android-only, stub implementations)
1513
-
1514
- public func getBatteryWarningPending() throws -> Bool {
1515
- false
1516
- }
1517
-
1518
- public func getBatteryOptimizationStatus() throws -> BatteryOptimizationStatus {
1519
- // iOS doesn't have battery optimization restrictions like Android
1520
- .unrestricted
1521
- }
1522
-
1523
- public func dismissBatteryWarning() throws {
1524
- // No-op on iOS
1525
- }
1526
-
1527
- public func openBatterySettings() throws {
1528
- // No-op on iOS
1529
- }
1530
- }
1531
-
1532
- // MARK: - TrackPlayerCallbacks
1533
-
1534
- extension HybridAudioBrowser: TrackPlayerCallbacks {
1535
- public func playerDidChangePlayback(_ playback: Playback) {
1536
- onPlaybackChanged(playback)
1537
- // Re-render so the formatter reflects the new state — notably the error line on a failure (the
1538
- // coordinator sets playbackError before this fires). Redundant updates are deduped on publish.
1539
- applyNowPlayingMetadata()
1540
- }
1541
-
1542
- public func playerDidChangeActiveTrack(_ event: PlaybackActiveTrackChangedEvent) {
1543
- // Clear now playing override + flash + live metadata when track changes
1544
- // (matches Kotlin behavior; a flash must not carry over to a new track)
1545
- nowPlayingOverride = nil
1546
- cancelNowPlayingFlash()
1547
- latestTimedMetadata = nil
1548
- // Hydrate the active track's `favorited` from the authoritative set so JS
1549
- // consumers (useActiveTrack) match getActiveTrack()'s hydrated value — the
1550
- // coordinator emits the raw queue track, whose flag isn't kept in sync.
1551
- let hydrated = PlaybackActiveTrackChangedEvent(
1552
- lastIndex: event.lastIndex,
1553
- lastTrack: event.lastTrack,
1554
- lastPosition: event.lastPosition,
1555
- index: event.index,
1556
- track: event.track.map(browserManager.hydrateFavorite),
1557
- )
1558
- activeTrackChangedEmitter.emit(hydrated)
1559
- // Also notify now playing changed when track changes
1560
- applyNowPlayingMetadata()
1561
- }
1562
-
1563
- public func playerDidUpdateProgress(_ event: PlaybackProgressUpdatedEvent) {
1564
- onPlaybackProgressUpdated(event)
1565
- }
1566
-
1567
- public func playerDidFirePlaybackInterval() {
1568
- onPlaybackInterval()
1569
- }
1570
-
1571
- public func playerDidChangePlayWhenReady(_ playWhenReady: Bool) {
1572
- // Intent to play again is the earliest cancel signal for a pending session release.
1573
- if playWhenReady { cancelSessionRelease() }
1574
- onPlaybackPlayWhenReadyChanged(PlaybackPlayWhenReadyChangedEvent(playWhenReady: playWhenReady))
1575
- }
1576
-
1577
- public func playerDidChangePlayingState(_ state: PlayingState) {
1578
- onPlaybackPlayingState(state)
1579
- // Lazily activate the audio session the moment playback actually produces — or is buffering to
1580
- // produce — output. This (not setup) is where we grab the session, so launching the app never
1581
- // interrupts other apps' audio; the interruption only happens when the user truly starts
1582
- // playback, which is correct. Keyed off play *state*, not `playWhenReady`, because the intent
1583
- // can be set at setup (before any track) while output only begins here. Idempotent:
1584
- // `setActive(true)` is a no-op when the session is already active.
1585
- if state.playing || state.buffering {
1586
- try? AVAudioSession.sharedInstance().setActive(true)
1587
- // The now-playing session's activation request at link time predates this
1588
- // (the audio session was still inactive, and the system may have declined);
1589
- // re-request now so the surface can appear even if playback never produces
1590
- // audio (first-ever load failing on a dead stream).
1591
- player?.nowPlayingInfoController.reactivateSessionIfNeeded()
1592
- // Output resumed — cancel any pending release armed by an earlier stop.
1593
- cancelSessionRelease()
1594
- }
1595
- // Re-render so the formatter reacts to a stall starting or recovering (`stalled`) — a buffering
1596
- // flag change that may not transition the coordinator state.
1597
- applyNowPlayingMetadata()
1598
- }
1599
-
1600
- public func playerShouldReleaseSession() {
1601
- // Release the audio session so other apps' audio (Spotify, a podcast) can resume — debounced,
1602
- // because iOS dislikes deactivating while our audio is still trailing off, and a quick
1603
- // pause→resume shouldn't thrash the session. The coordinator only requests this on a genuine
1604
- // stop (not an interruption, not mid-retry); a re-activation cancels it (see
1605
- // `playerDidChangePlayWhenReady` and the activation above). Mirrors the now-playing flash timer.
1606
- sessionReleaseWork?.cancel()
1607
- let release = DispatchWorkItem { [weak self] in
1608
- guard let self, self.player?.playWhenReady == false else { return }
1609
- self.sessionReleaseWork = nil
1610
- // `.notifyOthersOnDeactivation` signals other apps they may resume; without it the session
1611
- // is released but nobody is told, so the user's audio would not come back.
1612
- try? AVAudioSession.sharedInstance().setActive(false, options: .notifyOthersOnDeactivation)
1613
- }
1614
- sessionReleaseWork = release
1615
- DispatchQueue.main.asyncAfter(deadline: .now() + 3, execute: release)
1616
- }
1617
-
1618
- @MainActor
1619
- private func cancelSessionRelease() {
1620
- sessionReleaseWork?.cancel()
1621
- sessionReleaseWork = nil
1622
- }
1623
-
1624
- public func playerDidEndQueue(_ event: PlaybackQueueEndedEvent) {
1625
- onPlaybackQueueEnded(event)
1626
- }
1627
-
1628
- public func playerDidChangeQueue(_ tracks: [Track]) {
1629
- queueChangedEmitter.emit(tracks)
1630
- }
1631
-
1632
- public func playerDidChangeRepeatMode(_ event: RepeatModeChangedEvent) {
1633
- repeatModeChangedEmitter.emit(event)
1634
- }
1635
-
1636
- public func playerDidChangeShuffleEnabled(_ enabled: Bool) {
1637
- shuffleChangedEmitter.emit(enabled)
1638
- onPlaybackShuffleModeChanged(enabled)
1639
- }
1640
-
1641
- public func playerDidError(_ event: PlaybackErrorEvent) {
1642
- onPlaybackError(event)
1643
- }
1644
-
1645
- public func playerDidReceiveCommonMetadata(_ items: [AVMetadataItem]) {
1646
- let metadata = TrackMetadata.from(items: items)
1647
- onTrackMetadata(metadata)
1648
- }
1649
-
1650
- public func playerDidReceiveTimedMetadata(_ groups: [AVTimedMetadataGroup]) {
1651
- for group in groups {
1652
- if let metadata = TimedMetadata.from(items: group.items) {
1653
- latestTimedMetadata = metadata
1654
- onTimedMetadata(metadata)
1655
- // Re-render the now-playing so the formatter can reflect the live song.
1656
- applyNowPlayingMetadata()
1657
- }
1658
- }
1659
- }
1660
-
1661
- public func playerDidReceiveChapterMetadata(_ groups: [AVTimedMetadataGroup]) {
1662
- let chapters = ChapterMetadata.from(groups: groups)
1663
- onChapterMetadata(chapters)
1664
- }
1665
-
1666
- public func playerDidCompleteSeek(position _: Double, didFinish _: Bool) {
1667
- // Not exposed to JS currently
1668
- }
1669
-
1670
- public func playerDidUpdateDuration(_: Double) {
1671
- // Not exposed to JS currently
1672
- }
1673
-
1674
- public func remotePlay() {
1675
- if let handler = handleRemotePlay {
1676
- handler()
1677
- } else {
1678
- // Default behavior: play the player
1679
- onMainActor { player?.play() }
1680
- }
1681
- onRemotePlay()
1682
- }
1683
-
1684
- public func remotePause() {
1685
- if let handler = handleRemotePause {
1686
- handler()
1687
- } else {
1688
- // Default behavior: pause the player
1689
- onMainActor { player?.pause() }
1690
- }
1691
- onRemotePause()
1692
- }
1693
-
1694
- public func remoteStop() {
1695
- if let handler = handleRemoteStop {
1696
- handler()
1697
- } else {
1698
- // Default behavior: stop the player
1699
- onMainActor { player?.stop() }
1700
- }
1701
- onRemoteStop()
1702
- }
1703
-
1704
- public func remotePlayPause() {
1705
- // Toggle based on current state
1706
- let isPlaying = onMainActor { player?.playWhenReady == true }
1707
- if isPlaying {
1708
- remotePause()
1709
- } else {
1710
- remotePlay()
1711
- }
1712
- }
1713
-
1714
- public func remoteNext() {
1715
- if let handler = handleRemoteNext {
1716
- handler()
1717
- } else {
1718
- // Default behavior: skip to next track
1719
- onMainActor { player?.next() }
1720
- }
1721
- onRemoteNext()
1722
- }
1723
-
1724
- public func remotePrevious() {
1725
- if let handler = handleRemotePrevious {
1726
- handler()
1727
- } else {
1728
- // Default behavior: skip to previous track
1729
- onMainActor { player?.previous() }
1730
- }
1731
- onRemotePrevious()
1732
- }
1733
-
1734
- public func remoteJumpForward(interval: Double) {
1735
- let event = RemoteJumpForwardEvent(interval: interval)
1736
- if let handler = handleRemoteJumpForward {
1737
- handler(event)
1738
- } else {
1739
- // Default behavior: seek forward by interval
1740
- onMainActor { player?.seekBy(interval) }
1741
- }
1742
- onRemoteJumpForward(event)
1743
- }
1744
-
1745
- public func remoteJumpBackward(interval: Double) {
1746
- let event = RemoteJumpBackwardEvent(interval: interval)
1747
- if let handler = handleRemoteJumpBackward {
1748
- handler(event)
1749
- } else {
1750
- // Default behavior: seek backward by interval
1751
- onMainActor { player?.seekBy(-interval) }
1752
- }
1753
- onRemoteJumpBackward(event)
1754
- }
1755
-
1756
- public func remoteSeek(position: Double) {
1757
- logger.info("remoteSeek called with position: \(position)")
1758
- let event = RemoteSeekEvent(position: position)
1759
- if let handler = handleRemoteSeek {
1760
- handler(event)
1761
- } else {
1762
- // Default behavior: seek to position
1763
- logger.info("remoteSeek: calling player.seekTo(\(position))")
1764
- onMainActor { player?.seekTo(position) }
1765
- }
1766
- onRemoteSeek(event)
1767
- }
1768
-
1769
- public func remoteChangePlaybackPosition(position: Double) {
1770
- remoteSeek(position: position)
1771
- }
1772
-
1773
- public func remotePlayId(id: String, index: Int?) {
1774
- let event = RemotePlayIdEvent(id: id, index: index.map { Double($0) })
1775
- if let handler = handleRemotePlayId {
1776
- handler(event)
1777
- } else {
1778
- onRemotePlayId(event)
1779
- }
1780
- }
1781
-
1782
- public func remotePlaySearch(query: String) {
1783
- let event = RemotePlaySearchEvent(query: query)
1784
- if let handler = handleRemotePlaySearch {
1785
- handler(event)
1786
- } else {
1787
- onRemotePlaySearch(event)
1788
- }
1789
- }
1790
-
1791
- /// Static so the Siri intent handler can call it before the shared instance
1792
- /// exists: it waits on the `playerAndConfiguredBrowser` gate, which resolves
1793
- /// once RN boots. Uses the resolved `browser`, never `self`.
1794
- static func handlePlayMediaIntent(criteria: MediaIntentCriteria, completion: @escaping @Sendable (Bool) -> Void) {
1795
- Task { @MainActor in
1796
- guard let (browser, player) = await playerAndConfiguredBrowser.wait(timeout: .seconds(8)) else {
1797
- Logger(subsystem: "com.audiobrowser", category: "AudioBrowser")
1798
- .error("handlePlayMediaIntent: browser/player not ready within budget")
1799
- completion(false)
1800
- return
1801
- }
1802
- // No-criteria intent ("play «app»") → resume. The gate must NOT block
1803
- // this: the gate blocks *finding* content, never *hearing* the active or
1804
- // persisted track. The gate is checked below, for the search branch only.
1805
- if criteria.isResume {
1806
- if player.currentTrack != nil {
1807
- browser.logger.info("resume: warm — playing current track")
1808
- player.play()
1809
- browser.showNowPlayingRequestedEmitter.emit(())
1810
- completion(true)
1811
- } else if let state = browser.playbackStateStore.load() {
1812
- browser.logger.info("resume: cold — restoring persisted track")
1813
- let track = state.track.toNitro()
1814
- let startMs = (track.live == true) ? nil : state.positionMs
1815
- // Match Android resume: re-expand the full queue from the track's contextual
1816
- // URL (parent container → siblings + selected index). Fall back to the single
1817
- // track when the url isn't contextual or expansion fails.
1818
- if let url = state.track.url,
1819
- let expanded = try? await browser.browserManager.expandQueueFromContextualUrl(url)
1820
- {
1821
- player.setQueue(expanded.tracks, initialIndex: expanded.selectedIndex, startPositionMs: startMs, playWhenReady: true)
1822
- } else {
1823
- player.setQueue([track], initialIndex: 0, startPositionMs: startMs, playWhenReady: true)
1824
- }
1825
- browser.showNowPlayingRequestedEmitter.emit(())
1826
- completion(true)
1827
- } else {
1828
- browser.logger.error("resume: nothing playing and nothing persisted → no-op")
1829
- completion(false) // nothing playing and nothing persisted
1830
- }
1831
- return
1832
- }
1833
-
1834
- // Assemble the Nitro SearchParams here (MainActor) from the criteria's
1835
- // Sendable fields, so the structured mode/genre/… reach the request like
1836
- // Android. Today the API still text-searches `q`; the rest is forward-compat.
1837
- let params = SearchParams(
1838
- mode: criteria.searchMode.flatMap { SearchMode(fromString: $0) },
1839
- query: criteria.query,
1840
- genre: criteria.genre,
1841
- artist: criteria.artist,
1842
- album: criteria.album,
1843
- title: criteria.title,
1844
- playlist: criteria.playlist,
1845
- // .currentlyPlaying can't reach here — isResume routed it to resume.
1846
- reference: criteria.reference == .my ? .my : .unknown,
1847
- )
1848
-
1849
- // Search is *finding* new content — refused when the gate decides this
1850
- // request is gated (resume above is unaffected: the gate never blocks
1851
- // hearing, and the gate check stays after the resume check).
1852
- let outcome = await browser.gateDecision(
1853
- for: NativeGateRequest(reason: .search, path: nil, search: params),
1854
- )
1855
- guard !outcome.gated else {
1856
- browser.logger.info("handlePlayMediaIntent: search refused — gated")
1857
- browser.onGate(GateEvent(reason: .search))
1858
- completion(false)
1859
- return
1860
- }
1861
-
1862
- do {
1863
- guard let tracks = try await browser.browserManager.searchPlayable(params) else {
1864
- completion(false)
1865
- return
1866
- }
1867
- player.setQueue(tracks, initialIndex: 0, playWhenReady: true)
1868
- browser.showNowPlayingRequestedEmitter.emit(())
1869
- completion(true)
1870
- } catch {
1871
- browser.logger.error("handlePlayMediaIntent failed: \(error.localizedDescription)")
1872
- completion(false)
1873
- }
1874
- }
1875
- }
1876
-
1877
- public func remoteChangeRepeatMode(mode: RepeatMode) {
1878
- // Apply the repeat mode change from CarPlay/lock screen
1879
- try? setRepeatMode(mode: mode)
1880
- }
1881
-
1882
- public func remoteChangeShuffleMode(enabled: Bool) {
1883
- // Apply the shuffle mode change from CarPlay/lock screen
1884
- try? setShuffleEnabled(enabled: enabled)
1885
- }
1886
-
1887
- public func remoteChangePlaybackRate(rate: Float) {
1888
- // Apply the playback rate change from CarPlay/lock screen
1889
- onMainActor { player?.rate = rate }
312
+ private static func destroy(_ player: Player?, _ engine: AVPlayerEngine?) {
313
+ player?.clear()
314
+ engine?.destroy()
1890
315
  }
1891
316
 
1892
- func playerDidChangeOptions(_: PlayerUpdateOptions) {
1893
- // TODO: Convert to Options type
317
+ // Only the browser's events: the bridge's own events call JS where they are emitted, and their
318
+ // emitters serve native listeners (CarPlay).
319
+ private func forwardBrowserEventsToJS() {
320
+ browserManager.pathChanged.addListener { [weak self] in self?.onPathChanged($0) }
321
+ browserManager.tabsChanged.addListener { [weak self] in self?.onTabsChanged($0) }
322
+ browserManager.contentChanged.addListener { [weak self] in self?.onContentChanged($0) }
1894
323
  }
1895
324
  }
1896
325
 
1897
326
  // MARK: - Autolinking Alias
1898
327
 
1899
- /// Alias for Nitro autolinking - expects class named "AudioBrowser"
328
+ // Nitro autolinking expects a class named `AudioBrowser`.
1900
329
  public typealias AudioBrowser = HybridAudioBrowser