react-native-audio-browser 0.2.0-next.7 → 0.2.0-next.70

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 (1223) hide show
  1. package/README.md +66 -39
  2. package/android/build.gradle +58 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +592 -438
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  9. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  10. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  11. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  12. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  13. package/android/src/main/java/com/audiobrowser/Service.kt +75 -82
  14. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  15. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  16. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  17. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +345 -537
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +37 -68
  19. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  20. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  21. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  22. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  23. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -29
  24. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  25. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  26. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +5 -15
  27. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  28. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  29. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  30. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  32. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  33. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +18 -40
  34. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  35. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  36. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  37. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  38. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  39. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  40. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  41. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  42. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  43. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  44. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +23 -34
  45. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  46. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +38 -27
  47. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  48. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  49. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +102 -117
  50. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  51. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +47 -37
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +123 -136
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  54. package/android/src/main/java/com/audiobrowser/player/Player.kt +420 -566
  55. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  56. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -21
  57. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +69 -120
  58. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +51 -122
  59. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  60. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  61. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  62. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  63. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +32 -67
  64. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  65. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  66. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  67. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  68. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +690 -0
  70. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  71. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  72. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  73. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  86. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  87. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  88. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  89. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  90. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  91. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  92. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  93. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  94. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -15
  95. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  96. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  97. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  98. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  99. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  100. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  101. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  102. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  103. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  104. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  105. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  106. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  107. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  108. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  109. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  110. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  111. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  112. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  113. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -82
  114. package/android/src/main/res/values/strings.xml +25 -5
  115. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  116. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  117. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  118. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  119. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  120. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  121. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +286 -0
  122. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -43
  123. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  124. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  125. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  126. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  127. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -23
  128. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +314 -8
  129. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  130. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  131. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -4
  132. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  133. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -55
  134. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  135. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  136. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  137. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  138. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +8 -16
  139. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  140. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  141. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +460 -0
  142. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  143. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  144. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  145. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  146. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  147. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  148. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  149. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  150. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +226 -21
  151. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +2 -26
  152. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +53 -39
  153. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  154. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  155. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  156. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  157. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +48 -0
  158. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  159. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  160. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +353 -0
  161. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +93 -0
  162. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  163. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  164. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +190 -0
  165. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +46 -0
  166. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +34 -72
  167. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -5
  168. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  169. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  170. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  171. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +2 -23
  172. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +285 -0
  173. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  174. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  175. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  176. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +926 -0
  177. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  178. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  179. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  180. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  181. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  182. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  183. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  184. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  185. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  186. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  187. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  188. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  189. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  190. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  191. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  192. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  193. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  194. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  195. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  196. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  197. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  198. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  199. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  200. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  201. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  202. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  203. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  204. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  205. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  206. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  207. package/android/src/test/resources/sonos/device_description.xml +78 -0
  208. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  209. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  210. package/ios/AVPlayerEngine.swift +354 -0
  211. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  212. package/ios/Browser/BrowseGate.swift +57 -0
  213. package/ios/Browser/BrowserConfig.swift +123 -104
  214. package/ios/Browser/BrowserError.swift +15 -0
  215. package/ios/Browser/BrowserManager.swift +153 -675
  216. package/ios/Browser/BrowserPathHelper.swift +54 -117
  217. package/ios/Browser/FavoriteSet.swift +43 -0
  218. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  219. package/ios/Browser/JsonModels.swift +244 -335
  220. package/ios/Browser/NavigationErrorState.swift +42 -0
  221. package/ios/Browser/PageResolver.swift +137 -0
  222. package/ios/Browser/RequestLayer.swift +181 -0
  223. package/ios/Browser/RequestPipeline.swift +293 -0
  224. package/ios/Browser/SearchDrillIn.swift +11 -17
  225. package/ios/Browser/SectionScope.swift +73 -26
  226. package/ios/Browser/SimpleRouter.swift +76 -154
  227. package/ios/Browser/StyleResolver.swift +41 -0
  228. package/ios/Browser/TabBarEntries.swift +8 -7
  229. package/ios/Browser/TrackIdTemplate.swift +29 -0
  230. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  231. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  232. package/ios/CarPlay/CarPlayController.swift +37 -1297
  233. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  234. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  235. package/ios/CarPlay/CarPlayNowPlayingManager.swift +129 -204
  236. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  237. package/ios/CarPlay/CarPlaySession+PageLoader.swift +92 -0
  238. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  239. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  240. package/ios/CarPlay/CarPlaySession.swift +203 -0
  241. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  242. package/ios/CarPlay/IntentHandlers.swift +94 -0
  243. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  244. package/ios/CarPlay/MediaIntentHandler.swift +63 -0
  245. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  246. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  247. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  248. package/ios/CarPlay/SectionPresentation.swift +67 -0
  249. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  250. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  251. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  252. package/ios/Extension/CxxVectorConformances.swift +4 -16
  253. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  254. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  255. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  256. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  257. package/ios/Extension/SearchParams+Query.swift +28 -0
  258. package/ios/Extension/Section+Copying.swift +26 -0
  259. package/ios/Extension/String+IcyCharset.swift +21 -0
  260. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  261. package/ios/Extension/Track+AVPlayer.swift +1 -18
  262. package/ios/Extension/Track+Copying.swift +13 -21
  263. package/ios/Extension/Track+Identity.swift +20 -0
  264. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  265. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  266. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  267. package/ios/Extension/URLError+Connectivity.swift +15 -0
  268. package/ios/Extension/Variant+Artwork.swift +8 -22
  269. package/ios/Http/HttpClient.swift +73 -167
  270. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  271. package/ios/HybridAudioBrowser+Options.swift +116 -0
  272. package/ios/HybridAudioBrowser+Player.swift +337 -0
  273. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  274. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  275. package/ios/HybridAudioBrowser.swift +148 -1688
  276. package/ios/Model/NitroTypeStubs.swift +240 -32
  277. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  278. package/ios/Model/RemoteCommand.swift +6 -60
  279. package/ios/Model/TrackPlayerError.swift +14 -23
  280. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  281. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  282. package/ios/Observer/ItemObserver.swift +92 -0
  283. package/ios/Observer/PlayerObserver.swift +59 -0
  284. package/ios/Option/SessionCategories.swift +42 -92
  285. package/ios/PlaybackEvent.swift +4 -2
  286. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  287. package/ios/Player/AudioSessionController.swift +190 -0
  288. package/ios/Player/DeferredSeek.swift +73 -0
  289. package/ios/Player/EndOfTrackJudgement.swift +6 -13
  290. package/ios/Player/ErrorStatus.swift +52 -0
  291. package/ios/Player/MediaLoader.swift +73 -98
  292. package/ios/Player/NowPlayingLines.swift +49 -0
  293. package/ios/Player/NowPlayingUpdater.swift +175 -105
  294. package/ios/Player/PersistedPlaybackState.swift +1 -2
  295. package/ios/Player/PlaybackFailure.swift +121 -0
  296. package/ios/Player/PlaybackPersistence.swift +72 -0
  297. package/ios/Player/PlaybackStateMachine.swift +11 -11
  298. package/ios/Player/PlaybackTimer.swift +11 -8
  299. package/ios/Player/Player.swift +991 -0
  300. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  301. package/ios/Player/PlayerEngine.swift +105 -0
  302. package/ios/Player/PlayerStatusTypes.swift +1 -6
  303. package/ios/Player/QueueManager.swift +80 -98
  304. package/ios/Player/RetryLoop.swift +274 -0
  305. package/ios/Player/ShuffleOrder.swift +36 -43
  306. package/ios/Player/SleepTimerManager.swift +25 -42
  307. package/ios/Player/VolumeFader.swift +20 -15
  308. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  309. package/ios/RemoteCommand/RemoteCommandController.swift +101 -336
  310. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  311. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  312. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  313. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  314. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  315. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  316. package/ios/Tests/DeferredSeekTests.swift +76 -0
  317. package/ios/Tests/EmitterTests.swift +22 -39
  318. package/ios/Tests/EndOfTrackJudgementTests.swift +1 -6
  319. package/ios/Tests/ErrorStatusTests.swift +50 -0
  320. package/ios/Tests/FavoriteSetTests.swift +61 -0
  321. package/ios/Tests/GenerationMemoTests.swift +121 -0
  322. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  323. package/ios/Tests/JsonModelsTests.swift +189 -3
  324. package/ios/Tests/LRUCacheTests.swift +106 -0
  325. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  326. package/ios/Tests/MediaLoaderTests.swift +38 -78
  327. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  328. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  329. package/ios/Tests/ObserverTests.swift +88 -0
  330. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  331. package/ios/Tests/PlaybackFailureTests.swift +181 -0
  332. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  333. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  334. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  335. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  336. package/ios/Tests/PlayerPolicyTests.swift +547 -0
  337. package/ios/Tests/PlayerTests.swift +1563 -0
  338. package/ios/Tests/PlayingStateTests.swift +41 -0
  339. package/ios/Tests/QueueManagerTests.swift +205 -174
  340. package/ios/Tests/ReadyValueTests.swift +73 -0
  341. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  342. package/ios/Tests/RequestLayerTests.swift +228 -0
  343. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  344. package/ios/Tests/RetryLoopTests.swift +282 -0
  345. package/ios/Tests/SearchDrillInTests.swift +16 -17
  346. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  347. package/ios/Tests/SectionPresentationTests.swift +85 -0
  348. package/ios/Tests/SectionScopeTests.swift +136 -54
  349. package/ios/Tests/SimpleRouterTests.swift +39 -8
  350. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  351. package/ios/Tests/StyleResolverTests.swift +123 -0
  352. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  353. package/ios/Tests/Support/TestTypes.swift +135 -100
  354. package/ios/Tests/TabBarEntriesTests.swift +19 -21
  355. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  356. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  357. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  358. package/ios/Tests/TrackIdentityTests.swift +20 -0
  359. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  360. package/ios/Tests/TrackSelectorTests.swift +157 -34
  361. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  362. package/ios/TrackSelector.swift +62 -77
  363. package/ios/Util/ArtworkFreshness.swift +42 -0
  364. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  365. package/ios/Util/ConcurrentMap.swift +19 -0
  366. package/ios/Util/Emitter.swift +45 -22
  367. package/ios/Util/GenerationMemo.swift +36 -0
  368. package/ios/Util/LRUCache.swift +23 -159
  369. package/ios/Util/NetworkMonitor.swift +31 -33
  370. package/ios/Util/OutputPicker.swift +48 -0
  371. package/ios/Util/ReadyValue.swift +57 -0
  372. package/ios/Util/SFSymbolRenderer.swift +64 -49
  373. package/ios/Util/SVGProcessor.swift +9 -16
  374. package/lib/commonjs/AudioBrowser.js +8 -8
  375. package/lib/commonjs/AudioBrowser.js.map +1 -1
  376. package/lib/commonjs/CLAUDE.md +57 -0
  377. package/lib/commonjs/features/battery.js +16 -12
  378. package/lib/commonjs/features/battery.js.map +1 -1
  379. package/lib/commonjs/features/browser-config.js +13 -9
  380. package/lib/commonjs/features/browser-config.js.map +1 -1
  381. package/lib/commonjs/features/browser.js +78 -20
  382. package/lib/commonjs/features/browser.js.map +1 -1
  383. package/lib/commonjs/features/carConnection.js +3 -4
  384. package/lib/commonjs/features/carConnection.js.map +1 -1
  385. package/lib/commonjs/features/equalizer.js +10 -6
  386. package/lib/commonjs/features/equalizer.js.map +1 -1
  387. package/lib/commonjs/features/errors.js +35 -21
  388. package/lib/commonjs/features/errors.js.map +1 -1
  389. package/lib/commonjs/features/favorites.js +29 -24
  390. package/lib/commonjs/features/favorites.js.map +1 -1
  391. package/lib/commonjs/features/gate.js +28 -7
  392. package/lib/commonjs/features/gate.js.map +1 -1
  393. package/lib/commonjs/features/metadata.js +64 -14
  394. package/lib/commonjs/features/metadata.js.map +1 -1
  395. package/lib/commonjs/features/network.js +6 -2
  396. package/lib/commonjs/features/network.js.map +1 -1
  397. package/lib/commonjs/features/nowPlaying.js +29 -15
  398. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  399. package/lib/commonjs/features/output.js +10 -5
  400. package/lib/commonjs/features/output.js.map +1 -1
  401. package/lib/commonjs/features/playback/controls.js +13 -6
  402. package/lib/commonjs/features/playback/controls.js.map +1 -1
  403. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  404. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  405. package/lib/commonjs/features/playback/playing.js +5 -3
  406. package/lib/commonjs/features/playback/playing.js.map +1 -1
  407. package/lib/commonjs/features/playback/progress.js +13 -6
  408. package/lib/commonjs/features/playback/progress.js.map +1 -1
  409. package/lib/commonjs/features/playback/rate.js +8 -1
  410. package/lib/commonjs/features/playback/rate.js.map +1 -1
  411. package/lib/commonjs/features/playback/state.js +5 -6
  412. package/lib/commonjs/features/playback/state.js.map +1 -1
  413. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -7
  414. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  415. package/lib/commonjs/features/playback/volume.js +6 -5
  416. package/lib/commonjs/features/playback/volume.js.map +1 -1
  417. package/lib/commonjs/features/player/options.js +23 -29
  418. package/lib/commonjs/features/player/options.js.map +1 -1
  419. package/lib/commonjs/features/player/setup.js +41 -41
  420. package/lib/commonjs/features/player/setup.js.map +1 -1
  421. package/lib/commonjs/features/player/validateOptions.js +23 -0
  422. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  423. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  424. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  425. package/lib/commonjs/features/queue/queue.js +58 -23
  426. package/lib/commonjs/features/queue/queue.js.map +1 -1
  427. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  428. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  429. package/lib/commonjs/features/queue/shuffle.js +1 -2
  430. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  431. package/lib/commonjs/features/remoteControls.js +70 -125
  432. package/lib/commonjs/features/remoteControls.js.map +1 -1
  433. package/lib/commonjs/features/sleepTimer.js +24 -7
  434. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  435. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  436. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  437. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -14
  438. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  439. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  440. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  441. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  442. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  443. package/lib/commonjs/utils/useDebug.js +16 -3
  444. package/lib/commonjs/utils/useDebug.js.map +1 -1
  445. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  446. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  447. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  448. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  449. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  450. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  451. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  452. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  453. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  454. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  455. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  456. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  457. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  458. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  459. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  460. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  461. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  462. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  463. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  464. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  465. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  466. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  467. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  468. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  469. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  470. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  471. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  472. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  473. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  474. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  475. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  476. package/lib/commonjs/web/browser/sections.js +89 -0
  477. package/lib/commonjs/web/browser/sections.js.map +1 -0
  478. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  479. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  480. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  481. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  482. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  483. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  484. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  485. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  486. package/lib/module/AudioBrowser.js +2 -1
  487. package/lib/module/AudioBrowser.js.map +1 -1
  488. package/lib/module/CLAUDE.md +57 -0
  489. package/lib/module/features/battery.js +16 -12
  490. package/lib/module/features/battery.js.map +1 -1
  491. package/lib/module/features/browser-config.js +13 -9
  492. package/lib/module/features/browser-config.js.map +1 -1
  493. package/lib/module/features/browser.js +78 -20
  494. package/lib/module/features/browser.js.map +1 -1
  495. package/lib/module/features/carConnection.js +3 -4
  496. package/lib/module/features/carConnection.js.map +1 -1
  497. package/lib/module/features/equalizer.js +10 -6
  498. package/lib/module/features/equalizer.js.map +1 -1
  499. package/lib/module/features/errors.js +35 -21
  500. package/lib/module/features/errors.js.map +1 -1
  501. package/lib/module/features/favorites.js +29 -24
  502. package/lib/module/features/favorites.js.map +1 -1
  503. package/lib/module/features/gate.js +28 -7
  504. package/lib/module/features/gate.js.map +1 -1
  505. package/lib/module/features/metadata.js +62 -14
  506. package/lib/module/features/metadata.js.map +1 -1
  507. package/lib/module/features/network.js +6 -2
  508. package/lib/module/features/network.js.map +1 -1
  509. package/lib/module/features/nowPlaying.js +29 -15
  510. package/lib/module/features/nowPlaying.js.map +1 -1
  511. package/lib/module/features/output.js +10 -5
  512. package/lib/module/features/output.js.map +1 -1
  513. package/lib/module/features/playback/controls.js +13 -6
  514. package/lib/module/features/playback/controls.js.map +1 -1
  515. package/lib/module/features/playback/playWhenReady.js +6 -5
  516. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  517. package/lib/module/features/playback/playing.js +5 -3
  518. package/lib/module/features/playback/playing.js.map +1 -1
  519. package/lib/module/features/playback/progress.js +13 -6
  520. package/lib/module/features/playback/progress.js.map +1 -1
  521. package/lib/module/features/playback/rate.js +8 -1
  522. package/lib/module/features/playback/rate.js.map +1 -1
  523. package/lib/module/features/playback/state.js +5 -6
  524. package/lib/module/features/playback/state.js.map +1 -1
  525. package/lib/module/features/playback/trackPlaybackTime.js +6 -6
  526. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  527. package/lib/module/features/playback/volume.js +6 -5
  528. package/lib/module/features/playback/volume.js.map +1 -1
  529. package/lib/module/features/player/options.js +22 -27
  530. package/lib/module/features/player/options.js.map +1 -1
  531. package/lib/module/features/player/setup.js +40 -40
  532. package/lib/module/features/player/setup.js.map +1 -1
  533. package/lib/module/features/player/validateOptions.js +19 -0
  534. package/lib/module/features/player/validateOptions.js.map +1 -0
  535. package/lib/module/features/queue/activeTrack.js +15 -5
  536. package/lib/module/features/queue/activeTrack.js.map +1 -1
  537. package/lib/module/features/queue/queue.js +58 -23
  538. package/lib/module/features/queue/queue.js.map +1 -1
  539. package/lib/module/features/queue/repeatMode.js +3 -2
  540. package/lib/module/features/queue/repeatMode.js.map +1 -1
  541. package/lib/module/features/queue/shuffle.js +1 -2
  542. package/lib/module/features/queue/shuffle.js.map +1 -1
  543. package/lib/module/features/remoteControls.js +70 -125
  544. package/lib/module/features/remoteControls.js.map +1 -1
  545. package/lib/module/features/sleepTimer.js +25 -8
  546. package/lib/module/features/sleepTimer.js.map +1 -1
  547. package/lib/module/test-utils/reactNativeStub.js +58 -0
  548. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  549. package/lib/module/utils/LazyNativeEmitter.js +25 -14
  550. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  551. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  552. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  553. package/lib/module/utils/getTrackIdentity.js +22 -0
  554. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  555. package/lib/module/utils/useDebug.js +16 -3
  556. package/lib/module/utils/useDebug.js.map +1 -1
  557. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  558. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  559. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  560. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  561. package/lib/module/web/NativeAudioBrowser.js +207 -84
  562. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  563. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  564. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  565. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  566. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  567. package/lib/module/web/TrackPlayer/Player.js +256 -40
  568. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  569. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  570. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  571. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  572. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  573. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  574. package/lib/module/web/browser/BrowserManager.js +175 -100
  575. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  576. package/lib/module/web/browser/FavoriteManager.js +31 -21
  577. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  578. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  579. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  580. package/lib/module/web/browser/SearchManager.js +18 -23
  581. package/lib/module/web/browser/SearchManager.js.map +1 -1
  582. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  583. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  584. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  585. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  586. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  587. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  588. package/lib/module/web/browser/sections.js +83 -0
  589. package/lib/module/web/browser/sections.js.map +1 -0
  590. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  591. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  592. package/lib/module/web/http/followMediaRedirect.js +215 -0
  593. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  594. package/lib/module/web/player/NowPlayingManager.js +4 -3
  595. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  596. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  597. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  598. package/lib/typescript/package.json +1 -0
  599. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  600. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  601. package/lib/typescript/src/features/battery.d.ts +17 -12
  602. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  603. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  604. package/lib/typescript/src/features/browser.d.ts +67 -19
  605. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  606. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  607. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  608. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  609. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  610. package/lib/typescript/src/features/errors.d.ts +37 -22
  611. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  612. package/lib/typescript/src/features/favorites.d.ts +29 -24
  613. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  614. package/lib/typescript/src/features/gate.d.ts +32 -10
  615. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  616. package/lib/typescript/src/features/metadata.d.ts +68 -17
  617. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  618. package/lib/typescript/src/features/network.d.ts +6 -2
  619. package/lib/typescript/src/features/network.d.ts.map +1 -1
  620. package/lib/typescript/src/features/nowPlaying.d.ts +29 -15
  621. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  622. package/lib/typescript/src/features/output.d.ts +10 -5
  623. package/lib/typescript/src/features/output.d.ts.map +1 -1
  624. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  625. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  626. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  627. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  628. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  629. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  630. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  631. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  632. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  633. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  634. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  635. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  636. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  637. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  638. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  639. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  640. package/lib/typescript/src/features/player/options.d.ts +74 -57
  641. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  642. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  643. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  644. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  645. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  646. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  647. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  648. package/lib/typescript/src/features/queue/queue.d.ts +52 -21
  649. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  650. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  651. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  652. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  653. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  654. package/lib/typescript/src/features/remoteControls.d.ts +81 -47
  655. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  656. package/lib/typescript/src/features/sleepTimer.d.ts +16 -8
  657. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  658. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  659. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  660. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  661. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  662. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  663. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  664. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  665. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  666. package/lib/typescript/src/types/browser.d.ts +242 -173
  667. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  668. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -16
  669. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  670. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  671. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  672. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  673. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  674. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  675. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  676. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  677. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  678. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  679. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  680. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  681. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  682. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  683. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  684. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  686. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  687. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  689. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  690. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  691. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  692. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  694. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  695. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  696. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  697. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  698. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  699. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  700. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  701. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  702. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  703. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  704. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  705. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  706. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  707. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  710. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  711. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  712. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  713. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  714. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  716. 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
  717. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  718. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  720. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  721. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  722. 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
  723. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  724. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  725. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  726. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  727. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  728. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  732. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  735. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  742. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  743. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  749. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  752. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  753. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  755. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  756. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  757. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  762. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  764. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  765. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  770. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  773. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  776. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  777. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  779. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  781. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  782. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  783. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  784. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  785. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  787. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  790. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  793. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  795. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  797. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  802. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  805. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  809. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  810. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  812. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  815. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  816. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  820. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  824. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  825. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  826. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  830. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  832. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  833. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  836. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  838. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  839. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  840. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  841. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  842. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  852. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  858. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  859. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  860. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  861. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  862. 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
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  869. 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
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  872. 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
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  875. 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
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  981. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  982. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  983. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  984. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  985. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  986. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  987. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  988. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  989. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  990. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  991. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  992. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  993. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  994. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  995. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  996. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  997. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  998. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  999. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1000. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1001. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1002. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1003. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1004. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1005. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1006. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1007. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1008. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1009. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1010. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1011. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1012. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1013. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1014. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1015. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1016. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1017. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1018. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1019. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1020. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1021. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1022. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1023. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1024. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1025. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1026. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1027. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1028. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1029. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1030. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1031. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1032. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1033. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1034. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1035. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1036. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1037. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1038. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1039. package/package.json +26 -12
  1040. package/src/AudioBrowser.ts +2 -1
  1041. package/src/CLAUDE.md +57 -0
  1042. package/src/docs-floors.test.ts +71 -0
  1043. package/src/features/battery.test.ts +79 -0
  1044. package/src/features/battery.ts +17 -13
  1045. package/src/features/browser-config.test.ts +21 -6
  1046. package/src/features/browser-config.ts +13 -9
  1047. package/src/features/browser.test.ts +1 -1
  1048. package/src/features/browser.ts +69 -20
  1049. package/src/features/carConnection.ts +3 -4
  1050. package/src/features/equalizer.ts +10 -6
  1051. package/src/features/errors.ts +37 -22
  1052. package/src/features/favorites.ts +29 -24
  1053. package/src/features/gate.ts +30 -9
  1054. package/src/features/hook-wiring.test.ts +302 -0
  1055. package/src/features/metadata.ts +83 -17
  1056. package/src/features/network.ts +6 -2
  1057. package/src/features/nowPlaying.ts +29 -15
  1058. package/src/features/output.ts +10 -5
  1059. package/src/features/playback/controls.ts +13 -6
  1060. package/src/features/playback/playWhenReady.ts +6 -5
  1061. package/src/features/playback/playing.ts +16 -3
  1062. package/src/features/playback/progress.test.ts +169 -0
  1063. package/src/features/playback/progress.ts +13 -6
  1064. package/src/features/playback/rate.ts +8 -1
  1065. package/src/features/playback/state.ts +10 -6
  1066. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  1067. package/src/features/playback/trackPlaybackTime.ts +9 -7
  1068. package/src/features/playback/volume.ts +6 -5
  1069. package/src/features/player/options.ts +83 -82
  1070. package/src/features/player/setup.test.ts +12 -3
  1071. package/src/features/player/setup.ts +123 -64
  1072. package/src/features/player/validateOptions.ts +21 -0
  1073. package/src/features/queue/activeTrack.ts +15 -5
  1074. package/src/features/queue/queue.ts +58 -23
  1075. package/src/features/queue/repeatMode.ts +2 -2
  1076. package/src/features/queue/shuffle.ts +1 -2
  1077. package/src/features/remoteControls.ts +70 -125
  1078. package/src/features/sleepTimer.test.ts +171 -0
  1079. package/src/features/sleepTimer.ts +25 -9
  1080. package/src/nitro-stub-drift.test.ts +277 -0
  1081. package/src/public-surface.test.ts +147 -0
  1082. package/src/specs/audio-browser.nitro.ts +15 -8
  1083. package/src/style-resolution.test.ts +210 -0
  1084. package/src/test-utils/reactNativeStub.ts +60 -0
  1085. package/src/types/browser-native.ts +7 -3
  1086. package/src/types/browser-nodes.ts +417 -151
  1087. package/src/types/browser.ts +248 -177
  1088. package/src/utils/LazyNativeEmitter.ts +25 -15
  1089. package/src/utils/NativeUpdatedValue.ts +30 -16
  1090. package/src/utils/getTrackIdentity.ts +22 -0
  1091. package/src/utils/useDebug.test.ts +182 -0
  1092. package/src/utils/useDebug.ts +16 -3
  1093. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1094. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1095. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1096. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1097. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1098. package/src/web/NativeAudioBrowser.ts +247 -92
  1099. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1100. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1101. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1102. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1103. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1104. package/src/web/TrackPlayer/Player.ts +286 -38
  1105. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1106. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1107. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1108. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1109. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1110. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1111. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1112. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1113. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1114. package/src/web/__tests__/retry.test.ts +169 -0
  1115. package/src/web/browser/BrowserManager.ts +209 -111
  1116. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1117. package/src/web/browser/FavoriteManager.ts +28 -23
  1118. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1119. package/src/web/browser/SearchManager.test.ts +75 -0
  1120. package/src/web/browser/SearchManager.ts +25 -28
  1121. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1122. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1123. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1124. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1125. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1126. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1127. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1128. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1129. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1130. package/src/web/browser/parseSearchResponse.ts +3 -4
  1131. package/src/web/browser/sections.test.ts +91 -0
  1132. package/src/web/browser/sections.ts +72 -0
  1133. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1134. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1135. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1136. package/src/web/http/followMediaRedirect.ts +253 -0
  1137. package/src/web/player/NowPlayingManager.ts +4 -3
  1138. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1139. package/src/web/util/BrowserPathHelper.ts +68 -13
  1140. package/website/guide/android-auto.md +126 -0
  1141. package/website/guide/android-certificates.md +488 -0
  1142. package/website/guide/artwork.md +300 -0
  1143. package/website/guide/audio-output.md +357 -0
  1144. package/website/guide/automotive.md +91 -0
  1145. package/website/guide/basic-usage.md +154 -0
  1146. package/website/guide/battery.md +142 -0
  1147. package/website/guide/browser.md +674 -0
  1148. package/website/guide/carplay.md +733 -0
  1149. package/website/guide/configuration.md +215 -0
  1150. package/website/guide/equalizer.md +235 -0
  1151. package/website/guide/errors.md +355 -0
  1152. package/website/guide/favorites.md +164 -0
  1153. package/website/guide/gate.md +157 -0
  1154. package/website/guide/getting-started.md +99 -0
  1155. package/website/guide/hooks.md +247 -0
  1156. package/website/guide/live-streams.md +156 -0
  1157. package/website/guide/metadata.md +289 -0
  1158. package/website/guide/migrating-from-track-player.md +289 -0
  1159. package/website/guide/native-callback-fetch.md +137 -0
  1160. package/website/guide/network.md +102 -0
  1161. package/website/guide/now-playing.md +203 -0
  1162. package/website/guide/playback.md +405 -0
  1163. package/website/guide/queue.md +334 -0
  1164. package/website/guide/remote-controls.md +314 -0
  1165. package/website/guide/search.md +270 -0
  1166. package/website/guide/sleep-timer.md +289 -0
  1167. package/website/guide/track.md +271 -0
  1168. package/ios/Bridge.h +0 -8
  1169. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1170. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1171. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1172. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1173. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1174. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -70
  1175. package/ios/Model/MediaURL.swift +0 -67
  1176. package/ios/Model/SourceType.swift +0 -6
  1177. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1178. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1179. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1180. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1181. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1182. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1183. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1184. package/ios/Option/PitchAlgorithms.swift +0 -17
  1185. package/ios/Option/TimeEventFrequency.swift +0 -18
  1186. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1187. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1188. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1189. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1190. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1191. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1192. package/ios/Player/PlaybackStateStore.swift +0 -27
  1193. package/ios/Player/PlayingStateManager.swift +0 -33
  1194. package/ios/Player/RetryManager.swift +0 -322
  1195. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1196. package/ios/Player/SleepTimerHandling.swift +0 -15
  1197. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1198. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1199. package/ios/Tests/MediaResolveTests.swift +0 -126
  1200. package/ios/Tests/OnceValueTests.swift +0 -79
  1201. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1202. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1203. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1204. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1205. package/ios/Tests/RetryManagerTests.swift +0 -89
  1206. package/ios/TrackPlayer.swift +0 -1014
  1207. package/ios/TrackPlayerCallbacks.swift +0 -86
  1208. package/ios/Util/MetadataAdapter.swift +0 -131
  1209. package/ios/Util/OnceValue.swift +0 -104
  1210. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1211. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1212. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1213. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1214. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1215. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1216. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1217. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1218. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1219. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1220. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1221. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1222. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1223. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -6,8 +6,9 @@ import android.os.Handler
6
6
  import android.os.Looper
7
7
  import androidx.core.net.toUri
8
8
  import androidx.media3.common.C
9
- import androidx.media3.common.HeartRating
9
+ import androidx.media3.common.MediaItem
10
10
  import androidx.media3.common.MediaMetadata
11
+ import androidx.media3.common.Player as MediaPlayer
11
12
  import androidx.media3.database.StandaloneDatabaseProvider
12
13
  import androidx.media3.datasource.cache.LeastRecentlyUsedCacheEvictor
13
14
  import androidx.media3.datasource.cache.SimpleCache
@@ -18,15 +19,28 @@ import com.audiobrowser.AudioBrowser
18
19
  import com.audiobrowser.Callbacks
19
20
  import com.audiobrowser.browser.displayArtworkSource
20
21
  import com.audiobrowser.browser.resolveArtworkUrl
22
+ import com.audiobrowser.browser.resolveMediaUrl
21
23
  import com.audiobrowser.browser.unattributedArtworkSource
24
+ import com.audiobrowser.cast.createCastRemote
22
25
  import com.audiobrowser.extension.NumberExt.Companion.toSeconds
26
+ import com.audiobrowser.extension.identity
23
27
  import com.audiobrowser.model.PlayerSetupOptions
24
28
  import com.audiobrowser.model.PlayerUpdateOptions
29
+ import com.audiobrowser.remote.RemoteOutputsController
30
+ import com.audiobrowser.remote.RemotePlayback
31
+ import com.audiobrowser.remote.RemoteUrls
32
+ import com.audiobrowser.sonos.SonosRemote
33
+ import com.audiobrowser.util.ArtworkRoutes
34
+ import com.audiobrowser.util.ArtworkUris
35
+ import com.audiobrowser.util.Automotive
25
36
  import com.audiobrowser.util.CoilBitmapLoader
26
37
  import com.audiobrowser.util.NetworkConnectivityMonitor
27
38
  import com.audiobrowser.util.PlayingStateFactory
28
39
  import com.audiobrowser.util.RepeatModeFactory
40
+ import com.audiobrowser.util.SvgArtworkRenderer
29
41
  import com.audiobrowser.util.TrackFactory
42
+ import com.audiobrowser.util.TrackFactory.setFavorite
43
+ import com.audiobrowser.util.isAutomotive
30
44
  import com.margelo.nitro.audiobrowser.AppKilledPlaybackBehavior
31
45
  import com.margelo.nitro.audiobrowser.FavoriteChangedEvent
32
46
  import com.margelo.nitro.audiobrowser.GateEvent
@@ -36,7 +50,6 @@ import com.margelo.nitro.audiobrowser.ImageSource
36
50
  import com.margelo.nitro.audiobrowser.NativeGateRequest
37
51
  import com.margelo.nitro.audiobrowser.NowPlayingMetadata
38
52
  import com.margelo.nitro.audiobrowser.Playback
39
- import com.margelo.nitro.audiobrowser.PlaybackActiveTrackChangedEvent
40
53
  import com.margelo.nitro.audiobrowser.PlaybackError
41
54
  import com.margelo.nitro.audiobrowser.PlaybackPlayWhenReadyChangedEvent
42
55
  import com.margelo.nitro.audiobrowser.PlaybackProgressUpdatedEvent
@@ -51,6 +64,7 @@ import java.io.IOException
51
64
  import java.util.concurrent.TimeUnit
52
65
  import kotlin.time.Duration.Companion.seconds
53
66
  import kotlinx.coroutines.CompletableDeferred
67
+ import kotlinx.coroutines.CoroutineScope
54
68
  import kotlinx.coroutines.Dispatchers
55
69
  import kotlinx.coroutines.MainScope
56
70
  import kotlinx.coroutines.TimeoutCancellationException
@@ -59,7 +73,14 @@ import kotlinx.coroutines.withTimeout
59
73
  import timber.log.Timber
60
74
 
61
75
  @SuppressLint("RestrictedApi")
62
- class Player(internal val context: Context) {
76
+ class Player
77
+ internal constructor(
78
+ internal val context: Context,
79
+ castRemote: (Context, String?) -> RemotePlayback?,
80
+ sonosRemote: (Context, CoroutineScope) -> RemotePlayback,
81
+ ) {
82
+ constructor(context: Context) : this(context, ::createCastRemote, ::SonosRemote)
83
+
63
84
  val appKilledPlaybackBehavior: AppKilledPlaybackBehavior
64
85
  get() = options.appKilledPlaybackBehavior
65
86
 
@@ -72,7 +93,9 @@ class Player(internal val context: Context) {
72
93
  EqualizerController(onSettingsChanged = { settings -> callbacks?.onEqualizerChanged(settings) })
73
94
  private val mediaSessionCallback = MediaSessionCallback(this)
74
95
  internal val playbackStateStore = PlaybackStateStore(this)
75
- internal val volumeFader = VolumeFader(getVolume = { volume }, setVolume = { volume = it })
96
+ // Fades the local engine only: a remote receiver keeps its own volume.
97
+ internal val volumeFader =
98
+ VolumeFader(getVolume = { exoPlayer.volume }, setVolume = { exoPlayer.volume = it })
76
99
  internal val sleepTimer =
77
100
  SleepTimerManager(
78
101
  volumeFader,
@@ -80,27 +103,49 @@ class Player(internal val context: Context) {
80
103
  onChanged = { callbacks?.onSleepTimerChanged(it) },
81
104
  )
82
105
 
83
- lateinit var exoPlayer: ExoPlayer
84
- lateinit var forwardingPlayer: androidx.media3.common.Player
85
- /** Thread-safe cache of playWhenReady for access from non-main threads (e.g., retry policy) */
106
+ /** The local engine. Rebuilt when the engine options change. */
107
+ internal lateinit var exoPlayer: ExoPlayer
108
+ private set
109
+
110
+ /**
111
+ * What plays: [exoPlayer], or while a remote output is on, the remote-switching player around it.
112
+ * Every playback read and command goes here. Local-only work that would disturb a remote (retry,
113
+ * reconnect, stuck recovery, the shuffle order) goes through [localEngine]; the equalizer,
114
+ * skip-silence, buffering and the volume fade act on [exoPlayer] alone.
115
+ */
116
+ lateinit var sessionPlayer: MediaPlayer
117
+ private set
118
+
119
+ /** [sessionPlayer] behind the remote-command seam: what the MediaSession wraps. */
120
+ lateinit var forwardingPlayer: MediaPlayer
121
+
122
+ private val remoteOutputs =
123
+ RemoteOutputsController(context, ::resolveRemoteUrls, castRemote, sonosRemote)
124
+
125
+ internal val localEngine =
126
+ LocalEngine({ exoPlayer }, isRemote = { remoteOutputs.player?.isRemote == true })
127
+
128
+ private var keepSessionAliveOnError = true
129
+
130
+ /**
131
+ * [playWhenReady] for the retry policy, which reads it off the main thread. Written eagerly by
132
+ * the setter, ahead of ExoPlayer's listener round-trip.
133
+ */
86
134
  @Volatile internal var playWhenReadyCache = false
87
135
 
88
136
  /**
89
- * Whether the current load has ever produced audio — selects between the retry policy's
90
- * first-connect and recovery budgets. Volatile: read from ExoPlayer's loader thread. Set when
91
- * playback starts, cleared on media-item transition (a new load starts unproven); retry reloads
92
- * of the same load keep it.
137
+ * Whether the current load has produced audio: picks the retry policy's first-connect or recovery
138
+ * budget. Read on ExoPlayer's loader thread. Cleared on a media-item transition; retry reloads of
139
+ * the same load keep it.
93
140
  */
94
141
  @Volatile internal var hasPlayedCache = false
95
142
 
96
- /** Last playWhenReady value emitted to JS — see [emitPlayWhenReadyChanged]. */
97
143
  private var lastEmittedPlayWhenReady: Boolean? = null
98
144
 
99
145
  /**
100
- * Emits the playWhenReady change to JS exactly once per value. Two producers exist: the
101
- * synchronous clear at ENDED in [setPlaybackState] (ordered before the state / queue-ended
102
- * callbacks, matching iOS) and the async media3 listener (authoritative for changes ExoPlayer
103
- * makes on its own, e.g. audio focus); the guard deduplicates their overlap.
146
+ * Emits a playWhenReady change to JS once per value. Both the synchronous clear at ENDED in
147
+ * [setPlaybackState] and the media3 listener (changes ExoPlayer makes itself, e.g. audio focus)
148
+ * call it; their overlap is dropped.
104
149
  */
105
150
  internal fun emitPlayWhenReadyChanged(value: Boolean) {
106
151
  if (lastEmittedPlayWhenReady == value) return
@@ -112,42 +157,45 @@ class Player(internal val context: Context) {
112
157
  private lateinit var loadControl: DynamicLoadControl
113
158
  private var automaticBufferManager: AutomaticBufferManager? = null
114
159
 
115
- /**
116
- * Tracks whether a network-related retry is pending. When true, network restoration will trigger
117
- * an immediate retry via exoPlayer.prepare().
118
- */
119
- @Volatile private var pendingNetworkRetry = false
120
-
121
- private var browserRegistered = CompletableDeferred<AudioBrowser>()
160
+ @Volatile private var browserRegistered = CompletableDeferred<AudioBrowser>()
122
161
  private var _coilBitmapLoader: CoilBitmapLoader? = null
123
162
 
163
+ /** For SVG pre-rendering of Android Auto browse items. Set by the service. */
164
+ var imageLoader: coil3.ImageLoader? = null
165
+
124
166
  /**
125
- * Coil ImageLoader for SVG pre-rendering in Android Auto browse items. Set by Service after
126
- * creation.
167
+ * Called on the main thread when a resumption meant to start playback fails. Set by the service.
127
168
  */
128
- var imageLoader: coil3.ImageLoader? = null
169
+ var onPlaybackResumptionFailed: () -> Unit = {}
129
170
 
130
- /** Registry that maps content:// tokens to artwork URLs for the browse content provider. */
171
+ /** Maps the browse content provider's content:// tokens to artwork URLs. */
131
172
  val browseArtworkRegistry = com.audiobrowser.browser.BrowseArtworkRegistry()
132
173
 
133
- /**
134
- * Set the CoilBitmapLoader for display-time bitmap loading. Called from Service after creation.
135
- */
174
+ init {
175
+ Automotive.device = context.isAutomotive
176
+ TrackFactory.favoriteEnabled = options.capabilities.favoriteEnabled
177
+ TrackFactory.artworkRoutes =
178
+ ArtworkRoutes(browseArtworkRegistry, ArtworkUris.authorityFor(context.packageName))
179
+ }
180
+
136
181
  var coilBitmapLoader: CoilBitmapLoader?
137
182
  get() = _coilBitmapLoader
138
183
  set(value) {
139
184
  _coilBitmapLoader = value
140
185
  }
141
186
 
142
- // NOTE: setting the browser does NOT complete browserRegistered.
143
- // Configuration (routes/tabs) must be set before Android Auto can browse.
144
- // Call notifyBrowserConfigurationReady() after configuration is set.
145
187
  var browser: AudioBrowser? = null
188
+ set(value) {
189
+ // A completed registration is the previous browser's; an open one keeps its waiters.
190
+ if (browserRegistered.isCompleted) {
191
+ browserRegistered = CompletableDeferred()
192
+ }
193
+ field = value
194
+ }
146
195
 
147
196
  /**
148
- * Notifies that the browser configuration is ready (routes/tabs are configured). This should be
149
- * called after setting the browser AND its configuration. Only then will Android Auto be able to
150
- * browse content.
197
+ * Marks the browser's routes and tabs configured: completes [awaitBrowser] and lets Android Auto
198
+ * browse. Call after setting [browser] and its configuration.
151
199
  */
152
200
  fun notifyBrowserConfigurationReady() {
153
201
  val audioBrowser = browser ?: return
@@ -155,15 +203,13 @@ class Player(internal val context: Context) {
155
203
  if (!browserRegistered.isCompleted) {
156
204
  Timber.d("Browser configuration ready - completing deferred")
157
205
  browserRegistered.complete(audioBrowser)
158
- // Notify any subscribed controllers that content is now available
159
- // This handles the cold-start case where AA subscribed before browser was ready
206
+ // Android Auto may have subscribed on a cold start before the browser was ready.
160
207
  mediaSessionCallback.notifyBrowserReady()
161
208
  }
162
209
 
163
- // Update MediaSession commands when browser becomes available with search configured
164
- // Only update if search is available, since default state is "no search"
165
210
  if (::mediaSession.isInitialized) {
166
211
  val searchAvailable = audioBrowser.browserManager.config.hasSearch
212
+ // The session starts without search, so only a configured search needs an update.
167
213
  if (searchAvailable) {
168
214
  mediaSessionCallback.updateMediaSession(
169
215
  mediaSession,
@@ -178,23 +224,21 @@ class Player(internal val context: Context) {
178
224
  }
179
225
 
180
226
  /**
181
- * Suspends until the browser is registered, with a timeout.
227
+ * The browser [notifyBrowserConfigurationReady] registered, waiting for it if none is.
182
228
  *
183
- * @throws TimeoutCancellationException if browser is not registered within timeout
229
+ * @throws TimeoutCancellationException if it is not registered within 10 seconds
184
230
  */
185
231
  suspend fun awaitBrowser(): AudioBrowser =
186
- browser
187
- ?: try {
188
- withTimeout(10.seconds) {
189
- Timber.d("Waiting for browser registration...")
190
- browserRegistered.await()
191
- }
192
- } catch (e: TimeoutCancellationException) {
193
- Timber.e("Timed out waiting for browser registration (10s)")
194
- throw e
195
- }
232
+ try {
233
+ withTimeout(10.seconds) { browserRegistered.await() }
234
+ } catch (e: TimeoutCancellationException) {
235
+ Timber.e("Timed out waiting for browser registration (10s)")
236
+ throw e
237
+ }
238
+
239
+ internal lateinit var playerListener: PlayerListener
240
+ private set
196
241
 
197
- private lateinit var playerListener: PlayerListener
198
242
  private var cache: SimpleCache? = null
199
243
 
200
244
  private val progressTimer: PlaybackTimer by lazy {
@@ -223,7 +267,7 @@ class Player(internal val context: Context) {
223
267
  private set
224
268
 
225
269
  val currentTrack: Track?
226
- get() = exoPlayer.currentMediaItem?.let { TrackFactory.fromMedia3(it) }
270
+ get() = sessionPlayer.currentMediaItem?.let { TrackFactory.fromMedia3(it) }
227
271
 
228
272
  internal var lastTrack: Track? = null
229
273
  internal var lastIndex: Int? = null
@@ -243,13 +287,11 @@ class Player(internal val context: Context) {
243
287
  }
244
288
 
245
289
  /**
246
- * Re-derives [playingState] from the current `playWhenReady` + [playbackState] and emits
247
- * `onPlaybackPlayingState` when it changed. The only writer of [playingState] — called from the
248
- * state machine ([setPlaybackState]) and from [PlayerListener.onPlayWhenReadyChanged], the change
249
- * points of its two inputs.
290
+ * Re-derives [playingState] from [shouldPlayWhenReady] and [playbackState], emitting when it
291
+ * changed. Its only writer: call it wherever either input changes.
250
292
  */
251
293
  internal fun refreshPlayingState() {
252
- val newPlayingState = PlayingStateFactory.derive(playWhenReady, playbackState)
294
+ val newPlayingState = PlayingStateFactory.derive(shouldPlayWhenReady, playbackState)
253
295
  if (newPlayingState == playingState) return
254
296
  Timber.d(
255
297
  "PlayingState changed: playing=${newPlayingState.playing}, buffering=${newPlayingState.buffering}"
@@ -259,106 +301,103 @@ class Player(internal val context: Context) {
259
301
  }
260
302
 
261
303
  var playWhenReady: Boolean
262
- get() = exoPlayer.playWhenReady
304
+ get() = sessionPlayer.playWhenReady
263
305
  set(value) {
264
- // Raising the intent at STATE_ENDED must replay, not silently no-op:
265
- // ExoPlayer's setPlayWhenReady(true) never restarts an ended player (the
266
- // ENDED→seekToDefaultPosition replay lives in media3's media-button
267
- // path, not the Player API). In the setter so every writer gets it —
268
- // play(), togglePlayback() and JS setPlayWhenReady alike.
269
- if (value && exoPlayer.playbackState == ExoPlayer.STATE_ENDED) {
270
- exoPlayer.seekToDefaultPosition()
306
+ // ExoPlayer's setPlayWhenReady(true) never restarts an ended player (media3 replays only on
307
+ // its media-button path). Here in the setter so every writer replays: play(),
308
+ // togglePlayback(), JS.
309
+ if (value && sessionPlayer.playbackState == MediaPlayer.STATE_ENDED) {
310
+ sessionPlayer.seekToDefaultPosition()
271
311
  }
272
312
  playWhenReadyCache = value
273
- exoPlayer.playWhenReady = value
313
+ sessionPlayer.playWhenReady = value
274
314
  }
275
315
 
276
316
  val duration: Long
277
- get() = if (exoPlayer.duration == C.TIME_UNSET) 0 else exoPlayer.duration
317
+ get() = if (sessionPlayer.duration == C.TIME_UNSET) 0 else sessionPlayer.duration
278
318
 
279
319
  internal var oldPosition = 0L
280
320
 
281
321
  val position: Long
282
322
  get() =
283
- if (exoPlayer.currentPosition == C.INDEX_UNSET.toLong()) 0 else exoPlayer.currentPosition
323
+ if (sessionPlayer.currentPosition == C.INDEX_UNSET.toLong()) 0
324
+ else sessionPlayer.currentPosition
284
325
 
285
326
  val bufferedPosition: Long
286
327
  get() =
287
- if (exoPlayer.bufferedPosition == C.INDEX_UNSET.toLong()) 0 else exoPlayer.bufferedPosition
328
+ if (sessionPlayer.bufferedPosition == C.INDEX_UNSET.toLong()) 0
329
+ else sessionPlayer.bufferedPosition
288
330
 
331
+ /** From 0 to 1: the local engine's, or while remote, the receiver's. */
289
332
  var volume: Float
290
- get() = exoPlayer.volume
333
+ get() = sessionPlayer.volume
291
334
  set(value) {
292
- exoPlayer.volume = value
335
+ sessionPlayer.volume = value
293
336
  }
294
337
 
295
338
  var playbackSpeed: Float
296
- get() = exoPlayer.playbackParameters.speed
339
+ get() = sessionPlayer.playbackParameters.speed
297
340
  set(value) {
298
- exoPlayer.setPlaybackSpeed(value)
341
+ sessionPlayer.setPlaybackSpeed(value)
299
342
  }
300
343
 
301
344
  val isPlaying
302
- get() = exoPlayer.isPlaying
345
+ get() = sessionPlayer.isPlaying
346
+
347
+ /**
348
+ * False while ExoPlayer suppresses output (a transient audio focus loss) though [playWhenReady]
349
+ * stays raised to resume on; mirrors media3's `ExoPlayerImplInternal.shouldPlayWhenReady`.
350
+ */
351
+ internal val shouldPlayWhenReady
352
+ get() =
353
+ sessionPlayer.playWhenReady &&
354
+ sessionPlayer.playbackSuppressionReason == MediaPlayer.PLAYBACK_SUPPRESSION_REASON_NONE
303
355
 
304
356
  var repeatMode: RepeatMode
305
- get() = RepeatModeFactory.fromMedia3(exoPlayer.repeatMode)
357
+ get() = RepeatModeFactory.fromMedia3(sessionPlayer.repeatMode)
306
358
  internal set(value) {
307
- exoPlayer.repeatMode = RepeatModeFactory.toMedia3(value)
359
+ sessionPlayer.repeatMode = RepeatModeFactory.toMedia3(value)
308
360
  }
309
361
 
310
362
  val currentIndex: Int?
311
363
  get() =
312
- if (exoPlayer.currentMediaItemIndex == C.INDEX_UNSET) null
313
- else exoPlayer.currentMediaItemIndex
364
+ if (sessionPlayer.currentMediaItemIndex == C.INDEX_UNSET) null
365
+ else sessionPlayer.currentMediaItemIndex
314
366
 
315
367
  var shuffleMode: Boolean
316
- get() = exoPlayer.shuffleModeEnabled
368
+ get() = sessionPlayer.shuffleModeEnabled
317
369
  set(value) {
318
- exoPlayer.shuffleModeEnabled = value
370
+ sessionPlayer.shuffleModeEnabled = value
319
371
  }
320
372
 
321
373
  val trackCount: Int
322
- get() = exoPlayer.mediaItemCount
374
+ get() = sessionPlayer.mediaItemCount
323
375
 
324
376
  val isEmpty: Boolean
325
- get() = exoPlayer.mediaItemCount == 0
377
+ get() = sessionPlayer.mediaItemCount == 0
326
378
 
327
379
  val tracks: Array<Track>
328
380
  get() =
329
- (0 until exoPlayer.mediaItemCount)
330
- .map { index -> TrackFactory.fromMedia3(exoPlayer.getMediaItemAt(index)) }
381
+ (0 until sessionPlayer.mediaItemCount)
382
+ .map { index -> TrackFactory.fromMedia3(sessionPlayer.getMediaItemAt(index)) }
331
383
  .toTypedArray()
332
384
 
333
- /**
334
- * Whether nothing follows the current item in *playback order* — shuffle- and repeat-aware via
335
- * media3's own order computation (the linear `currentMediaItemIndex == count - 1` check missed a
336
- * shuffled queue whose playback order ends on a different linear index). Matches iOS's
337
- * `isLastInPlaybackOrder`.
338
- */
385
+ /** In playback order, so shuffle and repeat count; not the last linear index. */
339
386
  val isLastInPlaybackOrder: Boolean
340
- get() = exoPlayer.nextMediaItemIndex == C.INDEX_UNSET
387
+ get() = sessionPlayer.nextMediaItemIndex == C.INDEX_UNSET
341
388
 
342
- /**
343
- * The source path from which the current queue was expanded (e.g., from a contextual URL). Used
344
- * to avoid re-expanding the queue when selecting tracks from the same source.
345
- */
389
+ /** The path the queue was expanded from, so selecting from the same source skips re-expanding. */
346
390
  var queueSourcePath: String? = null
347
391
  internal set
348
392
 
349
- /**
350
- * Get track at index with bounds checking.
351
- *
352
- * @param index The index of the track to retrieve.
353
- * @throws IllegalArgumentException if index is out of bounds.
354
- */
393
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
355
394
  fun getTrack(index: Int): Track {
356
- if (index < 0 || index >= exoPlayer.mediaItemCount) {
395
+ if (index < 0 || index >= sessionPlayer.mediaItemCount) {
357
396
  throw IllegalArgumentException(
358
- "Track index $index is out of bounds (size: ${exoPlayer.mediaItemCount})"
397
+ "Track index $index is out of bounds (size: ${sessionPlayer.mediaItemCount})"
359
398
  )
360
399
  }
361
- return TrackFactory.fromMedia3(exoPlayer.getMediaItemAt(index))
400
+ return TrackFactory.fromMedia3(sessionPlayer.getMediaItemAt(index))
362
401
  }
363
402
 
364
403
  var skipSilence: Boolean
@@ -367,20 +406,32 @@ class Player(internal val context: Context) {
367
406
  exoPlayer.skipSilenceEnabled = value
368
407
  }
369
408
 
409
+ private var engineOptions: PlayerSetupOptions? = null
410
+
370
411
  /**
371
- * Sets up or recreates the ExoPlayer with the provided setup options. This method can be called
372
- * multiple times to change setup options.
412
+ * Builds the ExoPlayer on the first call, and rebuilds it only when the engine options changed. A
413
+ * rebuild carries over the queue, the position and the play intent.
373
414
  */
374
415
  fun setup(setupOptions: PlayerSetupOptions) {
375
- Timber.Forest.d("Setting up player with new options")
376
-
377
416
  nowPlaying.enabled = setupOptions.autoUpdateNowPlayingMetadata
378
- // Wrap the Nitro Func into a plain suspend call so the updater (and its tests) never touch
379
- // bridge types; the double-await depth is unchanged (invoke -> bridge Promise -> JS promise).
417
+ // Unwrapped from the Nitro Func so the updater never touches bridge types.
380
418
  nowPlaying.formatter =
381
419
  setupOptions.nowPlayingMetadataFormatter?.let { f -> { params -> f.invoke(params).await() } }
382
420
 
383
- val isInitialSetup = !::exoPlayer.isInitialized
421
+ val newEngineOptions = setupOptions.engineOptions()
422
+ if (newEngineOptions == engineOptions) {
423
+ Timber.Forest.d("Setup options unchanged: keeping the player")
424
+ } else {
425
+ buildEngine(setupOptions)
426
+ engineOptions = newEngineOptions
427
+ }
428
+ if (remoteOutputs.apply(setupOptions.remoteOutputs, exoPlayer)) attachSessionPlayer()
429
+ }
430
+
431
+ private fun buildEngine(setupOptions: PlayerSetupOptions) {
432
+ Timber.Forest.d("Setting up player with new options")
433
+ val isInitialSetup = engineOptions == null
434
+ val carried = if (isInitialSetup) null else EnginePlayback.of(exoPlayer)
384
435
 
385
436
  if (!isInitialSetup) {
386
437
  forwardingPlayer.removeListener(playerListener)
@@ -389,15 +440,15 @@ class Player(internal val context: Context) {
389
440
  }
390
441
 
391
442
  if (setupOptions.maxCacheSize > 0) {
392
- // SimpleCache locks its folder — re-setup must release the previous
393
- // instance first or the constructor throws.
443
+ // SimpleCache locks its folder: the constructor throws until the previous one is released.
394
444
  cache?.release()
395
445
  cache =
396
446
  SimpleCache(
397
447
  File(context.cacheDir, "RNAB"),
398
448
  LeastRecentlyUsedCacheEvictor(
449
+ // MB to bytes
399
450
  setupOptions.maxCacheSize.toLong() * 1_000_000
400
- ), // MB to bytes
451
+ ),
401
452
  StandaloneDatabaseProvider(context),
402
453
  )
403
454
  } else {
@@ -405,8 +456,6 @@ class Player(internal val context: Context) {
405
456
  cache = null
406
457
  }
407
458
 
408
- // One engine generation: load control, media factory, ExoPlayer (pure construction —
409
- // see buildPlayerEngine; lifecycle and wiring stay here).
410
459
  val engine =
411
460
  buildPlayerEngine(
412
461
  context,
@@ -415,65 +464,65 @@ class Player(internal val context: Context) {
415
464
  shouldRetry = { playWhenReadyCache },
416
465
  isOnline = { networkMonitor.getOnline() },
417
466
  hasPlayed = { hasPlayedCache },
418
- onRetryPending = { exception, isNetworkError ->
419
- // Track pending network retries for acceleration when connectivity returns
420
- pendingNetworkRetry = isNetworkError
421
- if (isNetworkError) {
422
- Timber.d("Network retry pending, will accelerate on connectivity restoration")
423
- }
424
- reportRetryingError(exception)
425
- },
426
- resolveMediaConfig = { url -> browser?.getMediaRequestConfig(url) },
467
+ onRetryPending = ::reportRetryingError,
468
+ resolveMediaConfig = { url, track -> browser?.getMediaRequestConfig(url, track) },
427
469
  )
428
470
  loadControl = engine.loadControl
429
471
  mediaFactory = engine.mediaFactory
430
472
  exoPlayer = engine.exoPlayer
473
+ // Before the listener and the session are attached, so neither hears the playback replayed.
474
+ carried?.restoreTo(exoPlayer)
475
+ remoteOutputs.setLocal(exoPlayer)
476
+ keepSessionAliveOnError = setupOptions.keepSessionAliveOnError
431
477
 
432
- // A rebuilt engine starts paused and fires no change event — sync the
433
- // eager cache and tell JS, or the stale true sticks (and the emit dedupe
434
- // would swallow the next real rise).
435
- if (!isInitialSetup) {
436
- playWhenReadyCache = false
437
- emitPlayWhenReadyChanged(false)
478
+ if (isInitialSetup) playerListener = PlayerListener(this)
479
+ attachSessionPlayer()
480
+
481
+ if (isInitialSetup) {
482
+ callbacks?.onPlaybackChanged(Playback(PlaybackState.NONE, null))
483
+ equalizer.initialize(exoPlayer.audioSessionId)
484
+ } else if (localEngine.isActive) {
485
+ // No listener heard the restore, and its prepare() leaves the engine buffering. While remote,
486
+ // the receiver plays on unchanged.
487
+ setPlaybackState(
488
+ if (exoPlayer.playbackState == ExoPlayer.STATE_IDLE) PlaybackState.NONE
489
+ else PlaybackState.BUFFERING
490
+ )
491
+ // The new engine can refuse the carried intent (audio focus denied) without a change event,
492
+ // which would leave a stale true in the cache and in JS.
493
+ playWhenReadyCache = exoPlayer.playWhenReady
494
+ emitPlayWhenReadyChanged(exoPlayer.playWhenReady)
438
495
  }
439
496
 
440
- // Recreate forwarding player with new ExoPlayer
497
+ setupAutomaticBufferManager(setupOptions.automaticBuffer)
498
+ }
499
+
500
+ // Call whenever [exoPlayer] or the remote player changes.
501
+ private fun attachSessionPlayer() {
502
+ if (::forwardingPlayer.isInitialized) forwardingPlayer.removeListener(playerListener)
503
+ sessionPlayer = remoteOutputs.player ?: exoPlayer
441
504
  forwardingPlayer =
442
505
  InterceptingPlayer(
443
- exoPlayer,
506
+ sessionPlayer,
444
507
  { callbacks },
445
508
  { options },
446
- keepSessionAliveOnError = setupOptions.keepSessionAliveOnError,
509
+ keepSessionAliveOnError,
510
+ isPaused = { playbackState == PlaybackState.PAUSED },
447
511
  )
512
+ forwardingPlayer.addListener(playerListener)
513
+ if (::mediaSession.isInitialized) mediaSession.player = forwardingPlayer
514
+ }
448
515
 
449
- if (isInitialSetup) {
450
- // Initial setup - create player listener and emit initial state
451
- playerListener = PlayerListener(this)
452
- forwardingPlayer.addListener(playerListener)
453
- callbacks?.onPlaybackChanged(Playback(PlaybackState.NONE, null))
454
-
455
- // Initialize equalizer with audio session ID
456
- equalizer.initialize(exoPlayer.audioSessionId)
457
- } else {
458
- // Re-setup - re-add listener and update MediaSession
459
- forwardingPlayer.addListener(playerListener)
460
-
461
- // Update MediaSession with new forwardingPlayer reference if MediaSession exists
462
- if (::mediaSession.isInitialized) {
463
- Timber.Forest.d("Updating MediaSession with new forwardingPlayer reference")
464
- mediaSession.player = forwardingPlayer
465
- }
466
-
467
- setPlaybackState(PlaybackState.NONE)
468
- }
469
-
470
- // Set up automatic buffer management if enabled
471
- setupAutomaticBufferManager(setupOptions.automaticBuffer)
516
+ private suspend fun resolveRemoteUrls(track: Track): RemoteUrls {
517
+ val src = checkNotNull(track.src) { "The track has no src" }
518
+ val browserManager = browser?.browserManager
519
+ return RemoteUrls(
520
+ url = browserManager?.resolveMediaUrl(src, track)?.url() ?: src,
521
+ artworkUrl = browserManager?.resolveArtworkUrl(track)?.uri,
522
+ )
472
523
  }
473
524
 
474
- /** Sets up or tears down the automatic buffer manager based on the enabled flag. */
475
525
  private fun setupAutomaticBufferManager(enabled: Boolean) {
476
- // Detach existing manager if any
477
526
  automaticBufferManager?.detach()
478
527
 
479
528
  if (enabled) {
@@ -487,168 +536,87 @@ class Player(internal val context: Context) {
487
536
  }
488
537
  }
489
538
 
490
- /**
491
- * Starts observing network connectivity changes and invokes the callback when state changes. Also
492
- * handles accelerating pending network retries when connectivity is restored.
493
- *
494
- * @param scope The coroutine scope to use for observation
495
- */
496
539
  fun observeNetworkConnectivity(scope: kotlinx.coroutines.CoroutineScope) {
497
540
  networkMonitor.observeOnline(scope) { isOnline ->
498
541
  callbacks?.onOnlineChanged(isOnline)
499
542
 
500
- // Re-render now-playing so the formatter's stall classification (buffering vs offline) tracks
501
- // connectivity immediately, not only on the next playback transition.
543
+ // The formatter tells a stall from being offline, so it renders on a connectivity change too.
502
544
  nowPlaying.render()
503
-
504
- // Accelerate pending network retry when connectivity is restored
505
- if (isOnline && pendingNetworkRetry) {
506
- Timber.d("Network restored with pending retry, triggering immediate retry")
507
- pendingNetworkRetry = false
508
- // Only retry if player is still expecting to play
509
- if (playWhenReadyCache) {
510
- exoPlayer.prepare()
511
- }
512
- }
513
545
  }
514
546
  }
515
547
 
516
- /**
517
- * Loads a track into the player. If there is a current track, it will be replaced. If the queue
518
- * is empty, the track will be added.
519
- *
520
- * @param track The [Track] to load.
521
- */
548
+ /** Replaces the current track, keeping the rest of the queue; on an empty queue, adds it. */
522
549
  fun load(track: Track) {
523
- if (exoPlayer.mediaItemCount == 0) {
550
+ if (sessionPlayer.mediaItemCount == 0) {
524
551
  add(track)
525
552
  } else {
526
- val index = exoPlayer.currentMediaItemIndex
553
+ val index = sessionPlayer.currentMediaItemIndex
527
554
  replaceTrack(index, track)
528
- exoPlayer.seekTo(index, C.TIME_UNSET)
529
- exoPlayer.prepare()
555
+ sessionPlayer.seekTo(index, C.TIME_UNSET)
556
+ sessionPlayer.prepare()
530
557
  }
531
558
  }
532
559
 
533
- /**
534
- * Add a single track to the queue. If the AudioPlayer has no track loaded, it will load the
535
- * `track`.
536
- *
537
- * @param track The [Track] to add.
538
- */
539
560
  fun add(track: Track) {
540
561
  val mediaItem = TrackFactory.toMedia3(track)
541
- exoPlayer.addMediaItem(mediaItem)
542
- exoPlayer.prepare()
562
+ sessionPlayer.addMediaItem(mediaItem)
563
+ sessionPlayer.prepare()
543
564
  }
544
565
 
545
- /**
546
- * Add multiple tracks to the queue. If the AudioPlayer has no track loaded, it will load the
547
- * first track in the list.
548
- *
549
- * @param tracks The [Track]s to add.
550
- */
551
566
  fun add(tracks: Array<Track>) {
552
567
  val mediaItems = TrackFactory.toMedia3(tracks)
553
- exoPlayer.addMediaItems(mediaItems.toList())
554
- exoPlayer.prepare()
568
+ sessionPlayer.addMediaItems(mediaItems.toList())
569
+ sessionPlayer.prepare()
555
570
  }
556
571
 
557
- /**
558
- * Add multiple tracks to the queue.
559
- *
560
- * @param tracks The [Track]s to add.
561
- * @param atIndex Index to insert tracks at. Use -1 to append to the end of the queue.
562
- * @throws IllegalArgumentException if index is out of bounds.
563
- */
572
+ /** @throws IllegalArgumentException unless [atIndex] is within the queue, or -1 to append. */
564
573
  fun add(tracks: Array<Track>, atIndex: Int) {
565
574
  validateInsertIndex(atIndex)
566
- val index = if (atIndex == -1) exoPlayer.mediaItemCount else atIndex
575
+ val index = if (atIndex == -1) sessionPlayer.mediaItemCount else atIndex
567
576
  val mediaItems = tracks.map { TrackFactory.toMedia3(it) }
568
- exoPlayer.addMediaItems(index, mediaItems)
569
- exoPlayer.prepare()
570
- }
571
-
572
- /**
573
- * Remove a track from the queue.
574
- *
575
- * @param index The index of the track to remove.
576
- * @throws IllegalArgumentException if index is out of bounds.
577
- */
578
- fun remove(index: Int) {
579
- validateIndex(index)
580
- exoPlayer.removeMediaItem(index)
577
+ sessionPlayer.addMediaItems(index, mediaItems)
578
+ sessionPlayer.prepare()
581
579
  }
582
580
 
583
- /**
584
- * Remove tracks from the queue.
585
- *
586
- * @param indexes The indexes of the tracks to remove.
587
- * @throws IllegalArgumentException if any index is out of bounds or if duplicate indexes are
588
- * provided.
589
- */
581
+ /** @throws IllegalArgumentException if an index is out of bounds or repeated. */
590
582
  fun remove(indexes: List<Int>) {
591
583
  if (indexes.toSet().size != indexes.size) {
592
584
  throw IllegalArgumentException("Duplicate indexes provided")
593
585
  }
594
586
  indexes.forEach { validateIndex(it) }
595
- val sorted = indexes.sortedDescending()
596
- sorted.forEach { exoPlayer.removeMediaItem(it) }
587
+ val removesCurrent = sessionPlayer.currentMediaItemIndex in indexes
588
+ indexes.sortedDescending().forEach { sessionPlayer.removeMediaItem(it) }
589
+ // Loads the new current track on an engine an error left idle; a no-op otherwise.
590
+ if (removesCurrent && playWhenReady) prepare()
597
591
  }
598
592
 
599
- /**
600
- * Skip to the next track in the queue, which may depend on the current repeat mode. Does nothing
601
- * if there is no next track to skip to.
602
- */
603
593
  fun next() {
604
- exoPlayer.seekToNextMediaItem()
605
- exoPlayer.prepare()
594
+ sessionPlayer.seekToNextMediaItem()
595
+ sessionPlayer.prepare()
606
596
  }
607
597
 
608
- /**
609
- * Skip to the previous track in the queue, which may depend on the current repeat mode. Does
610
- * nothing if there is no previous track to skip to.
611
- */
612
598
  fun previous() {
613
- exoPlayer.seekToPreviousMediaItem()
614
- exoPlayer.prepare()
599
+ sessionPlayer.seekToPreviousMediaItem()
600
+ sessionPlayer.prepare()
615
601
  }
616
602
 
617
603
  /**
618
- * Move an track in the queue from one position to another.
604
+ * A [toIndex] past the end moves the track to the end.
619
605
  *
620
- * @param fromIndex The index of the track to move.
621
- * @param toIndex The index to move the track to. If the index is larger than the size of the
622
- * queue, the track is moved to the end of the queue instead.
623
- * @throws IllegalArgumentException if fromIndex is out of bounds.
606
+ * @throws IllegalArgumentException if [fromIndex] is out of bounds.
624
607
  */
625
608
  fun move(fromIndex: Int, toIndex: Int) {
626
609
  validateIndex(fromIndex)
627
- exoPlayer.moveMediaItem(fromIndex, toIndex)
610
+ sessionPlayer.moveMediaItem(fromIndex, toIndex)
628
611
  }
629
612
 
630
- /**
631
- * Skips to a track in the queue.
632
- *
633
- * @param index the index to skip to
634
- * @throws IllegalArgumentException if index is out of bounds.
635
- */
613
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
636
614
  fun skipTo(index: Int) {
637
615
  validateIndex(index)
638
- exoPlayer.seekTo(index, C.TIME_UNSET)
639
- exoPlayer.prepare()
616
+ sessionPlayer.seekTo(index, C.TIME_UNSET)
617
+ sessionPlayer.prepare()
640
618
  }
641
619
 
642
- /**
643
- * Sets the queue with new tracks, optionally starting at a specific index and position. This is
644
- * more efficient than calling clear() + add() + skipTo() separately.
645
- *
646
- * @param tracks The tracks to set as the new queue.
647
- * @param startIndex The index to start playback from (default: 0).
648
- * @param startPositionMs The position in milliseconds to start from (default: 0).
649
- * @param sourcePath Optional path from which this queue was expanded (for contextual URL
650
- * optimization).
651
- */
652
620
  fun setQueue(
653
621
  tracks: Array<Track>,
654
622
  startIndex: Int = 0,
@@ -656,89 +624,58 @@ class Player(internal val context: Context) {
656
624
  sourcePath: String? = null,
657
625
  ) {
658
626
  val mediaItems = TrackFactory.toMedia3(tracks).toMutableList()
659
- exoPlayer.setMediaItems(mediaItems, startIndex, startPositionMs)
627
+ sessionPlayer.setMediaItems(mediaItems, startIndex, startPositionMs)
628
+ // While remote, the queue plays in list order.
629
+ if (mediaItems.isNotEmpty()) {
630
+ localEngine.setShuffleOrder(shuffleOrderLedBy(startIndex, mediaItems.size))
631
+ }
660
632
  queueSourcePath = sourcePath
661
- exoPlayer.prepare()
633
+ sessionPlayer.prepare()
662
634
  }
663
635
 
664
- /**
665
- * Replaces track at index in queue.
666
- *
667
- * @throws IllegalArgumentException if index is out of bounds.
668
- */
636
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
669
637
  fun replaceTrack(index: Int, track: Track) {
670
638
  validateIndex(index)
671
- exoPlayer.replaceMediaItem(index, TrackFactory.toMedia3(track))
639
+ val isCurrent = index == currentIndex
640
+ if (isCurrent) nowPlaying.forgetPublished()
641
+ sessionPlayer.replaceMediaItem(index, TrackFactory.toMedia3(track))
642
+ if (isCurrent) nowPlaying.render()
672
643
  }
673
644
 
674
645
  /**
675
- * Sets the favorited state of the currently playing track. Updates the heart icon in media
676
- * controllers without interrupting playback.
646
+ * @return false only when there is no current track, so MediaSession callers can report an
647
+ * invalid state instead of a success the controller then watches revert.
677
648
  */
678
- fun setActiveTrackFavorited(favorited: Boolean) {
679
- val currentTrack = this.currentTrack ?: return
649
+ fun setActiveTrackFavorited(favorited: Boolean): Boolean {
650
+ val currentTrack = this.currentTrack ?: return false
680
651
 
681
- // Persist to the native favorites cache regardless of player state — the
682
- // user's gesture is durable even when there's no active media item to
683
- // update (queue tear-down, between-track gaps, etc.).
684
- currentTrack.src?.let { src -> browser?.browserManager?.updateFavorite(src, favorited) }
652
+ currentTrack.identity?.let { identity ->
653
+ browser?.browserManager?.updateFavorite(identity, favorited)
654
+ }
685
655
 
686
- val index = exoPlayer.currentMediaItemIndex
687
- if (index == C.INDEX_UNSET) return
656
+ val index = sessionPlayer.currentMediaItemIndex
657
+ // Still applied: the favorite is persisted above, and there is no heart to revert.
658
+ if (index == C.INDEX_UNSET) return true
688
659
 
689
- // Create updated Track with new favorited state
690
660
  val updatedTrack = currentTrack.copy(favorited = favorited)
661
+ restampMediaItem(index, updatedTrack) { setFavorite(favorited) }
691
662
 
692
- // Use buildUpon() on the existing MediaItem to update only the metadata
693
- // This preserves internal references and avoids playback interruption
694
- // Note: setTag() requires setUri() to be called, so we must re-set the URI
695
- val currentMediaItem = exoPlayer.getMediaItemAt(index)
696
- val updatedMetadata =
697
- currentMediaItem.mediaMetadata.buildUpon().setUserRating(HeartRating(favorited)).build()
698
- val updatedMediaItem =
699
- currentMediaItem
700
- .buildUpon()
701
- .setUri(currentMediaItem.localConfiguration?.uri)
702
- .setMediaMetadata(updatedMetadata)
703
- .setTag(updatedTrack)
704
- .build()
705
-
706
- exoPlayer.replaceMediaItem(index, updatedMediaItem)
707
-
708
- // Update the heart button icon in notification/Android Auto
709
663
  updateFavoriteButtonState(favorited)
710
664
 
711
- // Notify JS of the favorite state change
665
+ // The only emit: a favorite toggle mutates the active track in place, so the track and queue
666
+ // change events stay transition-only.
712
667
  callbacks?.onFavoriteChanged(FavoriteChangedEvent(updatedTrack, favorited))
713
-
714
- // Emit active track changed so useActiveTrack() hook updates
715
- val activeTrackEvent =
716
- PlaybackActiveTrackChangedEvent(
717
- lastIndex = index.toDouble(),
718
- lastTrack = currentTrack,
719
- lastPosition = exoPlayer.currentPosition.toSeconds(),
720
- index = index.toDouble(),
721
- track = updatedTrack,
722
- )
723
- callbacks?.onPlaybackActiveTrackChanged(activeTrackEvent)
724
-
725
- // Emit queue changed so useQueue() hook updates
726
- callbacks?.onPlaybackQueueChanged(tracks)
668
+ return true
727
669
  }
728
670
 
729
- /** Toggles the favorited state of the currently playing track. */
730
- fun toggleActiveTrackFavorited() {
731
- val currentTrack = this.currentTrack ?: return
732
- setActiveTrackFavorited(currentTrack.favorited != true)
671
+ fun toggleActiveTrackFavorited(): Boolean {
672
+ val currentTrack = this.currentTrack ?: return false
673
+ return setActiveTrackFavorited(currentTrack.favorited != true)
733
674
  }
734
675
 
735
676
  // MARK: - Now Playing Metadata
736
677
 
737
- /**
738
- * Now Playing rendering (flash/override/formatter precedence, dedupe, stale guards, artwork
739
- * keying) lives in [NowPlayingUpdater]; this object is its platform surface — current playback
740
- * reads plus MediaItem stamping via [replaceMediaItem], and artwork resolution via the browser.
741
- */
678
+ /** [NowPlayingUpdater] does the rendering; this is its platform surface. */
742
679
  val nowPlaying: NowPlayingUpdater =
743
680
  NowPlayingUpdater(
744
681
  object : NowPlayingSurface {
@@ -755,7 +692,7 @@ class Player(internal val context: Context) {
755
692
  get() = this@Player.playbackError
756
693
 
757
694
  override val playWhenReady
758
- get() = exoPlayer.playWhenReady
695
+ get() = shouldPlayWhenReady
759
696
 
760
697
  override val isRebuffering
761
698
  get() = loadControl.isRebuffering
@@ -777,9 +714,8 @@ class Player(internal val context: Context) {
777
714
  setTitle(title)
778
715
  .setDisplayTitle(title)
779
716
  .setArtist(secondaryLine)
780
- // Android Auto reads DISPLAY_SUBTITLE (not ARTIST) once DISPLAY_TITLE is set, so
781
- // mirror the line into `subtitle`; `artist` still drives the lock screen /
782
- // notification.
717
+ // Android Auto reads DISPLAY_SUBTITLE, not ARTIST, once DISPLAY_TITLE is set;
718
+ // `artist` still drives the lock screen and notification.
783
719
  .setSubtitle(secondaryLine)
784
720
  .setAlbumTitle(album)
785
721
  }
@@ -798,11 +734,12 @@ class Player(internal val context: Context) {
798
734
  null
799
735
  }
800
736
  val uri = resolved?.uri?.takeIf { it.isNotEmpty() } ?: return null
801
- // Remember how this URI was produced: Media3 hands it back to the bitmap loader, which
802
- // re-resolves Track-first (with the nowPlayingArtwork kind, not the global artwork
803
- // config).
804
- browserManager.artworkResolutions.register(uri, track, config)
805
- return uri
737
+ val published =
738
+ TrackFactory.sessionArtworkUri(uri, resolved.headers, SvgArtworkRenderer.isSvgUrl(uri))
739
+ // Media3 hands this URI back to the bitmap loader, which re-resolves it with the
740
+ // nowPlayingArtwork config rather than the global artwork config.
741
+ browserManager.artworkResolutions.register(published, track, config)
742
+ return published
806
743
  }
807
744
 
808
745
  override fun emitNowPlayingChanged(metadata: NowPlayingMetadata) {
@@ -812,32 +749,47 @@ class Player(internal val context: Context) {
812
749
  MainScope(),
813
750
  )
814
751
 
815
- /** Republishes the item at [index] with mutated metadata, preserving uri and Track tag. */
752
+ /**
753
+ * One replacement for the whole queue: each separate one is a timeline change and a queue event
754
+ * to JS.
755
+ */
756
+ private fun restampFavorites() {
757
+ if (!::sessionPlayer.isInitialized || sessionPlayer.mediaItemCount == 0) return
758
+ val items =
759
+ (0 until sessionPlayer.mediaItemCount).map { index ->
760
+ val item = sessionPlayer.getMediaItemAt(index)
761
+ val track = item.localConfiguration?.tag as? Track ?: return@map item
762
+ item.restamped(track) { setFavorite(track.favorited) }
763
+ }
764
+ sessionPlayer.replaceMediaItems(0, items.size, items)
765
+ }
766
+
816
767
  private fun restampMediaItem(
817
768
  index: Int,
818
769
  track: Track,
819
770
  mutate: MediaMetadata.Builder.() -> MediaMetadata.Builder,
820
771
  ) {
821
- val currentMediaItem = exoPlayer.getMediaItemAt(index)
822
- val updatedMediaItem =
823
- currentMediaItem
824
- .buildUpon()
825
- .setUri(currentMediaItem.localConfiguration?.uri)
826
- .setMediaMetadata(currentMediaItem.mediaMetadata.buildUpon().mutate().build())
827
- .setTag(track)
828
- .build()
829
- exoPlayer.replaceMediaItem(index, updatedMediaItem)
772
+ sessionPlayer.replaceMediaItem(
773
+ index,
774
+ sessionPlayer.getMediaItemAt(index).restamped(track, mutate),
775
+ )
830
776
  }
831
777
 
778
+ /** Keeps the uri so ExoPlayer updates the item in place instead of reloading it. */
779
+ private fun MediaItem.restamped(
780
+ track: Track,
781
+ mutate: MediaMetadata.Builder.() -> MediaMetadata.Builder,
782
+ ): MediaItem =
783
+ buildUpon()
784
+ .setUri(localConfiguration?.uri)
785
+ .setMediaMetadata(mediaMetadata.buildUpon().mutate().build())
786
+ .setTag(track)
787
+ .build()
788
+
832
789
  /**
833
- * Resets the retry timer when track changes. Called from PlayerListener.onMediaItemTransition.
834
- */
835
- /**
836
- * A restart from a terminal error begins a new load of the same track: fresh retry budgets and
837
- * unproven playback, so the user's tap yields a visible first-connect retry window instead of a
838
- * single silent attempt — the same behavior as re-selecting the track (ADR 0004). Hooked off the
839
- * player error clearing: every recovery path (retry(), play(), the transport controls' idle-error
840
- * recovery) goes through exoPlayer.prepare(), which clears the error.
790
+ * Fresh retry budgets and unproven playback (ADR 0004): when the track changes, and when an error
791
+ * goes terminal, since whatever restarts playback from it starts a new load and nothing loads
792
+ * until then.
841
793
  */
842
794
  internal fun resetForNewLoad() {
843
795
  resetRetryTimer()
@@ -848,14 +800,10 @@ class Player(internal val context: Context) {
848
800
  mediaFactory.resetRetryTimer()
849
801
  }
850
802
 
851
- /**
852
- * Finds the queue Track whose published artwork URI matches [uri], for display-time artwork
853
- * resolution of app-supplied queue tracks that never went through browse (so they are not in the
854
- * resolution registry). Must run on the main thread (ExoPlayer access).
855
- */
803
+ /** Main thread only (ExoPlayer access). */
856
804
  private fun findQueueTrackByArtworkUri(uri: String): Track? {
857
- for (i in 0 until exoPlayer.mediaItemCount) {
858
- val item = exoPlayer.getMediaItemAt(i)
805
+ for (i in 0 until sessionPlayer.mediaItemCount) {
806
+ val item = sessionPlayer.getMediaItemAt(i)
859
807
  if (item.mediaMetadata.artworkUri?.toString() == uri) {
860
808
  return item.localConfiguration?.tag as? Track
861
809
  }
@@ -864,10 +812,8 @@ class Player(internal val context: Context) {
864
812
  }
865
813
 
866
814
  /**
867
- * Track-first display-time artwork resolution for [CoilBitmapLoader]: registry hit
868
- * (browse/now-playing-resolved URIs) → queue-tag lookup (app-supplied tracks with raw artwork) →
869
- * header-only fallback for unattributable URIs (registry eviction / process-death restore). Null
870
- * means "fetch the URI as-is".
815
+ * For [CoilBitmapLoader]: the resolution registry, then the queue track that published [uri],
816
+ * then headers alone for a URI nothing attributes. Null means fetch the URI as-is.
871
817
  */
872
818
  suspend fun resolveDisplayArtwork(uri: String, sizeHintPixels: Int?): ImageSource? {
873
819
  val browserManager = browser?.browserManager ?: return null
@@ -876,6 +822,14 @@ class Player(internal val context: Context) {
876
822
  browserManager.displayArtworkSource(uri, imageContext)?.let {
877
823
  return it
878
824
  }
825
+ // On Android Automotive OS the queue publishes provider URIs; the resolutions are keyed by URL.
826
+ TrackFactory.artworkRoutes
827
+ ?.publicUrl(uri.toUri())
828
+ ?.takeIf { it != uri }
829
+ ?.let { browserManager.displayArtworkSource(it, imageContext) }
830
+ ?.let {
831
+ return it
832
+ }
879
833
  withContext(Dispatchers.Main) { findQueueTrackByArtworkUri(uri) }
880
834
  ?.let { track ->
881
835
  return browserManager.resolveArtworkUrl(track, null, imageContext)
@@ -883,58 +837,54 @@ class Player(internal val context: Context) {
883
837
  return browserManager.unattributedArtworkSource(uri)
884
838
  }
885
839
 
886
- /**
887
- * Updates the favorite button icon in the notification/Android Auto. Call this when track changes
888
- * or favorite state changes.
889
- */
890
840
  internal fun updateFavoriteButtonState(favorited: Boolean?) {
891
841
  if (!::mediaSession.isInitialized) return
892
842
  mediaSessionCallback.commandManager.updateFavoriteState(mediaSession, favorited)
893
843
  }
894
844
 
895
- /** Removes all the upcoming tracks, if any (the ones returned by [next]). */
845
+ internal fun updateLiveState(live: Boolean) {
846
+ if (!::mediaSession.isInitialized) return
847
+ mediaSessionCallback.commandManager.updateLiveState(mediaSession, live)
848
+ }
849
+
896
850
  fun removeUpcomingTracks() {
897
- val index = exoPlayer.currentMediaItemIndex
851
+ val index = sessionPlayer.currentMediaItemIndex
898
852
  if (index == C.INDEX_UNSET) return
899
- val lastIndex = exoPlayer.mediaItemCount
853
+ val lastIndex = sessionPlayer.mediaItemCount
900
854
  val fromIndex = index + 1
901
855
 
902
- exoPlayer.removeMediaItems(fromIndex, lastIndex)
856
+ sessionPlayer.removeMediaItems(fromIndex, lastIndex)
903
857
  }
904
858
 
905
859
  fun play() {
906
- // Through the setter so the STATE_ENDED replay handling applies
907
- // (ExoPlayer.play() is only setPlayWhenReady(true)).
860
+ // Through the setter for its replay of an ended player.
908
861
  playWhenReady = true
909
862
  if (currentTrack != null) {
910
- // No-op unless the player is STATE_IDLE (ExoPlayer.prepare early-returns
911
- // otherwise), so this only reconnects after a stop() or error and never
912
- // re-buffers a healthy stream. Reconnecting is also how live streams
913
- // rejoin the live edge on resume.
914
- exoPlayer.prepare()
863
+ // No-op unless the player is idle, so this reconnects only after stop() or an error and never
864
+ // re-buffers a healthy stream. Reconnecting is also how a live stream rejoins its live edge.
865
+ sessionPlayer.prepare()
915
866
  }
916
867
  }
917
868
 
918
- /** Jump to the live edge (default position) of a live item; no-op otherwise. */
869
+ /**
870
+ * No-op unless the track declares `live`; ExoPlayer never marks progressive ICY radio live. A
871
+ * stream with a live window seeks to its edge; anything else reconnects, which for a non-seekable
872
+ * stream is the live edge.
873
+ */
919
874
  fun seekToLiveEdge() {
920
- if (exoPlayer.isCurrentMediaItemLive) {
921
- exoPlayer.seekToDefaultPosition()
922
- }
875
+ if (currentTrack?.live != true) return
876
+ // A receiver loads a live stream again on a seek to its default position.
877
+ if (!localEngine.reconnectAtLiveEdge()) sessionPlayer.seekToDefaultPosition()
923
878
  }
924
879
 
925
880
  /**
926
- * Executes a search and plays the results. Used for voice commands with structured search
927
- * parameters.
928
- *
929
- * @param params The structured search parameters (mode, query, artist, album, etc.)
930
- * @return true if search succeeded and playback started, false otherwise
881
+ * @return whether a result started playing: false when gated (after onGate), with no results, or
882
+ * on any error, the browser's registration timeout included.
931
883
  */
932
884
  suspend fun playFromSearch(params: SearchParams): Boolean {
933
885
  return try {
934
886
  val audioBrowser = awaitBrowser()
935
- // A gate blocks external-surface "play" search too — otherwise voice search is a way around
936
- // the gate (mirrors the iOS play-media intent guard). Resolved per request; a gated decision
937
- // fires onGate(search) and refuses.
887
+ // Gated like browsing, or voice search would be a way around the gate.
938
888
  val gateOutcome =
939
889
  audioBrowser.gateDecision(
940
890
  NativeGateRequest(reason = GateReason.SEARCH, path = null, search = params)
@@ -968,54 +918,43 @@ class Player(internal val context: Context) {
968
918
 
969
919
  fun prepare() {
970
920
  if (currentTrack != null) {
971
- exoPlayer.prepare()
921
+ sessionPlayer.prepare()
972
922
  }
973
923
  }
974
924
 
975
925
  fun pause() {
976
- // Through the setter so the eager playWhenReadyCache write holds for the
977
- // drop direction too — the retry policy reads it off-main before
978
- // ExoPlayer's listener round-trip syncs it.
926
+ // Through the setter, so the retry policy sees playWhenReadyCache drop at once.
979
927
  playWhenReady = false
980
928
  }
981
929
 
982
930
  fun togglePlayback() {
983
- if (exoPlayer.playWhenReady) {
984
- pause()
985
- } else {
986
- play()
931
+ when {
932
+ // Suppressed with the intent raised: ExoPlayer resumes when focus returns. play() would
933
+ // request focus again, and during a call that refusal drops the intent.
934
+ playWhenReady && !shouldPlayWhenReady -> Unit
935
+ PlayingStateFactory.derive(shouldPlayWhenReady, playbackState).playing -> pause()
936
+ else -> play()
987
937
  }
988
938
  }
989
939
 
990
- /**
991
- * Stops playback, without clearing the active track. Calling this method will cause the playback
992
- * state to transition to State.NONE and the player will release the loaded media and resources
993
- * required for playback.
994
- */
940
+ /** Keeps the queue; the state becomes STOPPED. */
995
941
  fun stop() {
996
- // State first so the machine's STOPPED guard suppresses the PAUSED transition
997
- // from the playWhenReady drop below; through setPlaybackState so the change
998
- // is emitted (direct field assignment bypasses events — see its docstring).
942
+ // State first, so the state machine's STOPPED guard swallows the PAUSED the drop below causes.
999
943
  setPlaybackState(PlaybackState.STOPPED)
1000
944
  playWhenReady = false
1001
- exoPlayer.stop()
945
+ sessionPlayer.stop()
1002
946
  }
1003
947
 
1004
948
  fun clear() {
1005
- exoPlayer.clearMediaItems()
949
+ sessionPlayer.clearMediaItems()
1006
950
  queueSourcePath = null
1007
951
  }
1008
952
 
1009
- /**
1010
- * Stops and destroys the player. Only call this when you are finished using the player, otherwise
1011
- * use [pause].
1012
- */
1013
953
  fun destroy() {
1014
- // Cancel without a final save: the loop would tick against the released
1015
- // player and persist position 0 over the real resumption position.
1016
- playbackStateStore.cancelPeriodicSave()
1017
- // An armed timer's Runnable would outlive the release and fire pause() into the
1018
- // released player. Cleared here, while a mid-ramp fade can still restore volume.
954
+ // stop() saves only if playing; before it, so its STOPPED doesn't defeat the ENDED guard.
955
+ playbackStateStore.stopPeriodicSave()
956
+ // An armed timer would fire pause() into the released player. Cleared before the release,
957
+ // while a mid-ramp fade can still restore the volume.
1019
958
  sleepTimer.clear()
1020
959
  stop()
1021
960
  nowPlaying.destroy()
@@ -1023,6 +962,7 @@ class Player(internal val context: Context) {
1023
962
  forwardingPlayer.removeListener(playerListener)
1024
963
  automaticBufferManager?.detach()
1025
964
  automaticBufferManager = null
965
+ remoteOutputs.release()
1026
966
  exoPlayer.release()
1027
967
  cache?.release()
1028
968
  cache = null
@@ -1032,36 +972,32 @@ class Player(internal val context: Context) {
1032
972
 
1033
973
  fun seekTo(duration: Long, unit: TimeUnit) {
1034
974
  val positionMs = TimeUnit.MILLISECONDS.convert(duration, unit)
1035
- exoPlayer.seekTo(positionMs)
975
+ sessionPlayer.seekTo(positionMs)
1036
976
  }
1037
977
 
1038
978
  fun seekBy(offset: Long, unit: TimeUnit) {
1039
- val positionMs = exoPlayer.currentPosition + TimeUnit.MILLISECONDS.convert(offset, unit)
1040
- exoPlayer.seekTo(positionMs)
979
+ val positionMs = sessionPlayer.currentPosition + TimeUnit.MILLISECONDS.convert(offset, unit)
980
+ sessionPlayer.seekTo(positionMs)
1041
981
  }
1042
982
 
1043
983
  /**
1044
- * Invalidates in-flight [reportRetryingError] posts: bumped on track change so a report
1045
- * classified for the outgoing track can't land on the incoming one's spinner. Written on main,
1046
- * read on ExoPlayer's loader thread.
984
+ * Bumped on track change so a [reportRetryingError] post for the outgoing track is dropped.
985
+ * Written on main, read on ExoPlayer's loader thread.
1047
986
  */
1048
987
  @Volatile private var retryingErrorGeneration = 0
1049
988
 
1050
989
  /**
1051
- * Surfaces a load failure the retry policy is still working on: attached to the current
1052
- * (non-terminal) state via [Callbacks.onPlaybackChanged], so UIs can show the cause over the
1053
- * spinner. Not an ERROR transition, and not a [Callbacks.onPlaybackError] — that event stays
1054
- * reserved for terminal errors. Called from ExoPlayer's loader thread, hence the main hop.
990
+ * Attaches a load failure the retry policy is still working on to the current state, for UIs to
991
+ * show over the spinner. Not an ERROR and not [Callbacks.onPlaybackError], which stays terminal.
992
+ * Called on ExoPlayer's loader thread.
1055
993
  */
1056
994
  private fun reportRetryingError(exception: IOException) {
1057
995
  val error = PlaybackErrorClassifier.retryingLoadError(exception, networkMonitor.getOnline())
1058
996
  val generation = retryingErrorGeneration
1059
997
  mainHandler.post {
1060
- // The track changed while this post was in flight — the error belongs to the old one.
1061
998
  if (generation != retryingErrorGeneration) return@post
1062
- // Only attach while the failure is what the listener is looking at. During PLAYING/READY
1063
- // buffered audio is still audibly fine, and ExoPlayer's in-place retry can succeed without
1064
- // any state change — an advisory attached there would never clear.
999
+ // Only over a spinner: while PLAYING, buffered audio still plays and ExoPlayer's in-place
1000
+ // retry can succeed with no state change, so an error attached there would never clear.
1065
1001
  if (
1066
1002
  playbackState != PlaybackState.LOADING &&
1067
1003
  playbackState != PlaybackState.BUFFERING &&
@@ -1069,19 +1005,34 @@ class Player(internal val context: Context) {
1069
1005
  ) {
1070
1006
  return@post
1071
1007
  }
1072
- // Each failed attempt re-reports; identical repeats add nothing (and would
1073
- // re-render now-playing every backoff tick).
1008
+ // Each backoff tick re-reports the same error.
1074
1009
  if (playbackError == error) return@post
1075
1010
  playbackError = error
1076
1011
  callbacks?.onPlaybackChanged(Playback(playbackState, error))
1077
1012
  nowPlaying.render()
1013
+ // A pause before this first report found no retry to cancel.
1014
+ if (!playWhenReadyCache) cancelRetry()
1078
1015
  }
1079
1016
  }
1080
1017
 
1081
1018
  /**
1082
- * Drops a retrying error whose track is gone. The new track may keep the state on
1083
- * LOADING/BUFFERING — no state-change emit — so the clear is emitted here, or the old track's
1084
- * error would linger over the new one's spinner.
1019
+ * Cancels the retry a dropped play intent leaves scheduled: ExoPlayer still runs it, and its
1020
+ * failure would be terminal. The engine idles in PAUSED, where the next prepare() reloads where
1021
+ * it failed. No-op unless a retrying error shows.
1022
+ */
1023
+ internal fun cancelRetry() {
1024
+ // The ENDED path drops the intent before it clears the error.
1025
+ if (playbackError?.retrying != true || playbackState == PlaybackState.ENDED) return
1026
+ // Before the stop: the state machine holds PAUSED through the IDLE that follows.
1027
+ setPlaybackState(PlaybackState.PAUSED)
1028
+ clearRetryingError()
1029
+ exoPlayer.stop()
1030
+ resetRetryTimer()
1031
+ }
1032
+
1033
+ /**
1034
+ * Drops the retrying error of a track that is gone. The new track may stay LOADING or BUFFERING
1035
+ * with no state change to emit the clear.
1085
1036
  */
1086
1037
  internal fun clearRetryingError() {
1087
1038
  retryingErrorGeneration++
@@ -1091,56 +1042,35 @@ class Player(internal val context: Context) {
1091
1042
  nowPlaying.render()
1092
1043
  }
1093
1044
 
1094
- /**
1095
- * Updates the player state and emits a state change event if the state has changed. Only emits an
1096
- * event if the new state differs from the current state.
1097
- *
1098
- * IMPORTANT: This method also triggers the queue ended event when the player reaches State.ENDED
1099
- * and is on the last track. All state transitions should go through this method to ensure proper
1100
- * event dispatching. Direct assignments to playerState will bypass event emission.
1101
- *
1102
- * @param state The new player state to set
1103
- */
1045
+ /** Every state change goes through here: it emits the change and the events that follow it. */
1104
1046
  internal fun setPlaybackState(state: PlaybackState) {
1105
1047
  if (state != playbackState) {
1106
1048
  val oldState = playbackState
1107
1049
  playbackState = state
1108
1050
 
1109
- // Audio rendered: this load has proven itself — retries from here on get
1110
- // the retry policy's full recovery budget, not the short first-connect one.
1111
- if (state == PlaybackState.PLAYING) {
1112
- hasPlayedCache = true
1113
- }
1051
+ if (state == PlaybackState.PLAYING) hasPlayedCache = true
1052
+ if (state == PlaybackState.ERROR) resetForNewLoad()
1114
1053
 
1115
- // A natural end exhausts the play intent — nothing is left to play. Keeping
1116
- // playWhenReady true inverted the play/pause toggle, held audio focus forever
1117
- // (ExoPlayer abandons it only at IDLE or on the intent dropping), and kept the
1118
- // periodic position save running. Cleared and emitted before the state /
1119
- // queue-ended callbacks so JS observes the native order (intent → state →
1120
- // queueEnded); the media3 listener's later echo is deduplicated by
1121
- // emitPlayWhenReadyChanged. The state machine's ENDED guard keeps the drop
1122
- // from re-reporting the state as PAUSED.
1054
+ // A natural end exhausts the play intent; held, it inverts the toggle, keeps audio focus and
1055
+ // the periodic save. Emitted before the state and queue-ended callbacks, matching iOS. The
1056
+ // state machine's ENDED guard keeps the drop from reporting PAUSED.
1123
1057
  if (state == PlaybackState.ENDED && playWhenReady) {
1124
1058
  playWhenReady = false
1125
1059
  emitPlayWhenReadyChanged(false)
1126
1060
  }
1127
1061
 
1128
- // The last track fires no AUTO media-item transition, so an armed
1129
- // end-of-track sleep timer would stay set forever and pause the next
1130
- // track played instead.
1062
+ // The last track fires no AUTO transition, so the end-of-track sleep timer would stay armed.
1131
1063
  if (state == PlaybackState.ENDED) {
1132
1064
  sleepTimer.onTrackEnd()
1133
1065
  }
1134
1066
 
1135
- // Clear error when transitioning away from error state
1136
1067
  if (oldState == PlaybackState.ERROR) {
1137
1068
  playbackError = null
1138
1069
  callbacks?.onPlaybackError(null)
1139
1070
  }
1140
1071
 
1141
- // A retrying error rides along through LOADING/BUFFERING/PAUSED; a state that
1142
- // proves recovery (READY/PLAYING — data flowed) or abandons the attempt clears
1143
- // it, before the Playback below is built so the emitted event is already clean.
1072
+ // A retrying error rides through LOADING, BUFFERING and PAUSED; any other state proves
1073
+ // recovery or abandons the attempt.
1144
1074
  if (
1145
1075
  playbackError?.retrying == true &&
1146
1076
  state != PlaybackState.LOADING &&
@@ -1153,25 +1083,16 @@ class Player(internal val context: Context) {
1153
1083
  val playback = Playback(state, playbackError)
1154
1084
  callbacks?.onPlaybackChanged(playback)
1155
1085
 
1156
- // Re-render the now-playing on every state change: the metadata formatter receives
1157
- // `playbackState` (plus isRebuffering / isOnline / error), so any transition can change its
1158
- // output — the live song while paused, a "Reconnecting…" line on a rebuffer, an offline/error
1159
- // line. The publish-dedupe in applyNowPlayingFields drops redundant updates, so re-running
1160
- // through the rapid startup sequence (none→loading→buffering→ready→playing) is cheap.
1086
+ // The formatter sees the state, so any transition can change what it renders.
1161
1087
  nowPlaying.render()
1162
1088
 
1163
- // Emit queue ended event when playback ends on the last track. Repeat modes never
1164
- // conceptually end the queue (matches web's endsQueue()): an ENDED that surfaces while
1165
- // repeating (e.g. a seek to the end) must not read as "playlist over".
1166
- // This coupling ensures queue ended events are always triggered consistently with state
1167
- // changes
1089
+ // A repeat mode never ends the queue, even on an ENDED from a seek to the end.
1168
1090
  if (state == PlaybackState.ENDED && isLastInPlaybackOrder && repeatMode == RepeatMode.OFF) {
1169
1091
  currentIndex?.let { index ->
1170
1092
  val event =
1171
1093
  PlaybackQueueEndedEvent(track = index.toDouble(), position = position.toSeconds())
1172
1094
  callbacks?.onPlaybackQueueEnded(event)
1173
1095
  }
1174
- // Reset saved position to 0 so resumption starts from beginning
1175
1096
  playbackStateStore.savePositionZero()
1176
1097
  }
1177
1098
 
@@ -1181,11 +1102,7 @@ class Player(internal val context: Context) {
1181
1102
  }
1182
1103
  }
1183
1104
 
1184
- /**
1185
- * Sets the progress update interval.
1186
- *
1187
- * @param interval The interval in seconds, or null to disable progress updates
1188
- */
1105
+ /** [interval] in seconds; null stops the progress events. */
1189
1106
  fun setProgressUpdateInterval(interval: Double?) {
1190
1107
  progressTimer.setInterval(interval)
1191
1108
  }
@@ -1194,21 +1111,11 @@ class Player(internal val context: Context) {
1194
1111
  intervalTimer.setInterval(if (enabled) 1.0 else null)
1195
1112
  }
1196
1113
 
1197
- /**
1198
- * Applies update options with change detection. Only updates properties that have actually
1199
- * changed and emits events accordingly.
1200
- *
1201
- * @param options The new options to apply
1202
- * @param mediaSession The MediaSession to update when capabilities change
1203
- */
1204
1114
  fun applyOptions(options: PlayerUpdateOptions) {
1205
- // Store previous values for change detection
1206
1115
  val previousOptions = this.options
1207
1116
 
1208
- // Update current options
1209
1117
  this.options = options.copy()
1210
1118
 
1211
- // Check what changed
1212
1119
  val skipSilenceChanged = previousOptions.skipSilence != options.skipSilence
1213
1120
  val progressUpdateEventIntervalChanged =
1214
1121
  previousOptions.progressUpdateEventInterval != options.progressUpdateEventInterval
@@ -1231,23 +1138,25 @@ class Player(internal val context: Context) {
1231
1138
  remoteButtonLayoutChanged ||
1232
1139
  appKilledPlaybackBehaviorChanged
1233
1140
 
1234
- // Apply only changed properties
1235
1141
  if (skipSilenceChanged) {
1236
1142
  skipSilence = options.skipSilence
1237
1143
  }
1238
1144
 
1239
1145
  if (capabilitiesChanged) {
1240
- // The `favorite` capability is the single favoriting switch — propagate
1241
- // its match mode to the browser so it can hydrate row hearts.
1242
- browser?.browserManager?.setFavoriteMatch(options.capabilities.favoriteMatch)
1146
+ // The favorite capability is the one favoriting switch; the browser hydrates row hearts from
1147
+ // it.
1148
+ browser?.browserManager?.setFavoriteEnabled(options.capabilities.favoriteEnabled)
1149
+ TrackFactory.favoriteEnabled = options.capabilities.favoriteEnabled
1150
+ if (previousOptions.capabilities.favoriteEnabled != options.capabilities.favoriteEnabled) {
1151
+ restampFavorites()
1152
+ }
1243
1153
  }
1244
1154
 
1245
1155
  if (progressUpdateEventIntervalChanged) {
1246
1156
  setProgressUpdateInterval(options.progressUpdateEventInterval)
1247
1157
  }
1248
1158
 
1249
- // The jump intervals pick the button icons (ICON_SKIP_BACK_15 and friends), so a changed
1250
- // interval has to rebuild the layout even when capabilities and placement are untouched.
1159
+ // The jump intervals pick the button icons, so a changed interval rebuilds the layout.
1251
1160
  if (
1252
1161
  capabilitiesChanged ||
1253
1162
  remoteButtonLayoutChanged ||
@@ -1270,20 +1179,10 @@ class Player(internal val context: Context) {
1270
1179
  }
1271
1180
  }
1272
1181
 
1273
- /**
1274
- * Sets the callbacks for player events.
1275
- *
1276
- * @param callbacks The callbacks to set, or null to clear callbacks
1277
- */
1278
1182
  fun setCallbacks(callbacks: Callbacks?) {
1279
1183
  this.callbacks = callbacks
1280
1184
  }
1281
1185
 
1282
- /**
1283
- * Gets the current callbacks instance.
1284
- *
1285
- * @return The current callbacks, or null if none are set
1286
- */
1287
1186
  fun getCallbacks(): Callbacks? {
1288
1187
  return this.callbacks
1289
1188
  }
@@ -1296,58 +1195,30 @@ class Player(internal val context: Context) {
1296
1195
  return options
1297
1196
  }
1298
1197
 
1299
- /**
1300
- * Gets the current network connectivity state.
1301
- *
1302
- * @return true if device is online, false otherwise
1303
- */
1304
1198
  fun getOnline(): Boolean {
1305
1199
  return networkMonitor.getOnline()
1306
1200
  }
1307
1201
 
1308
- /**
1309
- * Validates that an index is within bounds [0, trackCount).
1310
- *
1311
- * @param index The index to validate.
1312
- * @throws IllegalArgumentException if index is out of bounds.
1313
- */
1314
1202
  private fun validateIndex(index: Int) {
1315
- if (index < 0 || index >= exoPlayer.mediaItemCount) {
1203
+ if (index < 0 || index >= sessionPlayer.mediaItemCount) {
1316
1204
  throw IllegalArgumentException(
1317
- "Track index $index is out of bounds (size: ${exoPlayer.mediaItemCount})"
1205
+ "Track index $index is out of bounds (size: ${sessionPlayer.mediaItemCount})"
1318
1206
  )
1319
1207
  }
1320
1208
  }
1321
1209
 
1322
- /**
1323
- * Validates that an insertion index is within bounds [0, trackCount] or -1 (append).
1324
- *
1325
- * @param index The index to validate.
1326
- * @throws IllegalArgumentException if index is out of bounds.
1327
- */
1328
1210
  private fun validateInsertIndex(index: Int) {
1329
- if (index < -1 || index > exoPlayer.mediaItemCount) {
1211
+ if (index < -1 || index > sessionPlayer.mediaItemCount) {
1330
1212
  throw IllegalArgumentException(
1331
- "Insert index $index is out of bounds (size: ${exoPlayer.mediaItemCount}, use -1 to append)"
1213
+ "Insert index $index is out of bounds (size: ${sessionPlayer.mediaItemCount}, use -1 to append)"
1332
1214
  )
1333
1215
  }
1334
1216
  }
1335
1217
 
1336
- /**
1337
- * Gets the MediaSessionCallback for this AudioBrowser.
1338
- *
1339
- * @return MediaLibrarySession.Callback instance
1340
- */
1341
1218
  fun getMediaSessionCallback(): MediaLibraryService.MediaLibrarySession.Callback {
1342
1219
  return mediaSessionCallback
1343
1220
  }
1344
1221
 
1345
- /**
1346
- * Notifies external controllers (Android Auto, etc.) that content at the given path has changed.
1347
- * Controllers subscribed to this path will refresh their UI.
1348
- *
1349
- * @param path The path where content has changed
1350
- */
1351
1222
  fun notifyContentChanged(path: String) {
1352
1223
  mediaSessionCallback.notifyContentChanged(path)
1353
1224
  }
@@ -1356,41 +1227,24 @@ class Player(internal val context: Context) {
1356
1227
  mediaSessionCallback.invalidateAllContent()
1357
1228
  }
1358
1229
 
1359
- /**
1360
- * Returns the recommended artwork size in pixels from the connected media browser (e.g., Android
1361
- * Auto), or null if not provided.
1362
- */
1230
+ /** From the connected media browser (e.g. Android Auto), when it gives one. */
1363
1231
  val artworkSizeHintPixels: Int?
1364
1232
  get() = mediaSessionCallback.artworkSizeHintPixels
1365
1233
 
1366
- /** Returns true if the current media item is a live stream. */
1367
1234
  val isCurrentItemLive: Boolean
1368
- get() = exoPlayer.isCurrentMediaItemLive
1235
+ get() = sessionPlayer.isCurrentMediaItemLive
1369
1236
 
1370
1237
  // MARK: - Buffer Configuration
1371
1238
 
1372
- /**
1373
- * Updates the buffer configuration at runtime.
1374
- *
1375
- * The new configuration takes effect immediately for future buffering decisions. Already-buffered
1376
- * data is not affected.
1377
- *
1378
- * @param config The new buffer configuration to apply.
1379
- */
1239
+ /** Takes effect for future buffering; what is buffered stays. */
1380
1240
  fun updateBufferConfig(config: BufferConfig) {
1381
1241
  loadControl.updateBufferConfig(config)
1382
1242
  }
1383
1243
 
1384
- /**
1385
- * Gets the current buffer configuration.
1386
- *
1387
- * @return The current buffer configuration.
1388
- */
1389
1244
  fun getBufferConfig(): BufferConfig {
1390
1245
  return loadControl.getBufferConfig()
1391
1246
  }
1392
1247
 
1393
- /** Resets the buffer configuration to defaults. */
1394
1248
  fun resetBufferConfig() {
1395
1249
  loadControl.resetToDefaults()
1396
1250
  }