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

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 +77 -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 +425 -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 +287 -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 +60 -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 +1590 -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,25 +224,25 @@ 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
 
244
+ private var destroyed = false
245
+
200
246
  private val progressTimer: PlaybackTimer by lazy {
201
247
  PlaybackTimer(
202
248
  isActive = {
@@ -223,7 +269,7 @@ class Player(internal val context: Context) {
223
269
  private set
224
270
 
225
271
  val currentTrack: Track?
226
- get() = exoPlayer.currentMediaItem?.let { TrackFactory.fromMedia3(it) }
272
+ get() = sessionPlayer.currentMediaItem?.let { TrackFactory.fromMedia3(it) }
227
273
 
228
274
  internal var lastTrack: Track? = null
229
275
  internal var lastIndex: Int? = null
@@ -243,13 +289,11 @@ class Player(internal val context: Context) {
243
289
  }
244
290
 
245
291
  /**
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.
292
+ * Re-derives [playingState] from [shouldPlayWhenReady] and [playbackState], emitting when it
293
+ * changed. Its only writer: call it wherever either input changes.
250
294
  */
251
295
  internal fun refreshPlayingState() {
252
- val newPlayingState = PlayingStateFactory.derive(playWhenReady, playbackState)
296
+ val newPlayingState = PlayingStateFactory.derive(shouldPlayWhenReady, playbackState)
253
297
  if (newPlayingState == playingState) return
254
298
  Timber.d(
255
299
  "PlayingState changed: playing=${newPlayingState.playing}, buffering=${newPlayingState.buffering}"
@@ -259,106 +303,103 @@ class Player(internal val context: Context) {
259
303
  }
260
304
 
261
305
  var playWhenReady: Boolean
262
- get() = exoPlayer.playWhenReady
306
+ get() = sessionPlayer.playWhenReady
263
307
  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()
308
+ // ExoPlayer's setPlayWhenReady(true) never restarts an ended player (media3 replays only on
309
+ // its media-button path). Here in the setter so every writer replays: play(),
310
+ // togglePlayback(), JS.
311
+ if (value && sessionPlayer.playbackState == MediaPlayer.STATE_ENDED) {
312
+ sessionPlayer.seekToDefaultPosition()
271
313
  }
272
314
  playWhenReadyCache = value
273
- exoPlayer.playWhenReady = value
315
+ sessionPlayer.playWhenReady = value
274
316
  }
275
317
 
276
318
  val duration: Long
277
- get() = if (exoPlayer.duration == C.TIME_UNSET) 0 else exoPlayer.duration
319
+ get() = if (sessionPlayer.duration == C.TIME_UNSET) 0 else sessionPlayer.duration
278
320
 
279
321
  internal var oldPosition = 0L
280
322
 
281
323
  val position: Long
282
324
  get() =
283
- if (exoPlayer.currentPosition == C.INDEX_UNSET.toLong()) 0 else exoPlayer.currentPosition
325
+ if (sessionPlayer.currentPosition == C.INDEX_UNSET.toLong()) 0
326
+ else sessionPlayer.currentPosition
284
327
 
285
328
  val bufferedPosition: Long
286
329
  get() =
287
- if (exoPlayer.bufferedPosition == C.INDEX_UNSET.toLong()) 0 else exoPlayer.bufferedPosition
330
+ if (sessionPlayer.bufferedPosition == C.INDEX_UNSET.toLong()) 0
331
+ else sessionPlayer.bufferedPosition
288
332
 
333
+ /** From 0 to 1: the local engine's, or while remote, the receiver's. */
289
334
  var volume: Float
290
- get() = exoPlayer.volume
335
+ get() = sessionPlayer.volume
291
336
  set(value) {
292
- exoPlayer.volume = value
337
+ sessionPlayer.volume = value
293
338
  }
294
339
 
295
340
  var playbackSpeed: Float
296
- get() = exoPlayer.playbackParameters.speed
341
+ get() = sessionPlayer.playbackParameters.speed
297
342
  set(value) {
298
- exoPlayer.setPlaybackSpeed(value)
343
+ sessionPlayer.setPlaybackSpeed(value)
299
344
  }
300
345
 
301
346
  val isPlaying
302
- get() = exoPlayer.isPlaying
347
+ get() = sessionPlayer.isPlaying
348
+
349
+ /**
350
+ * False while ExoPlayer suppresses output (a transient audio focus loss) though [playWhenReady]
351
+ * stays raised to resume on; mirrors media3's `ExoPlayerImplInternal.shouldPlayWhenReady`.
352
+ */
353
+ internal val shouldPlayWhenReady
354
+ get() =
355
+ sessionPlayer.playWhenReady &&
356
+ sessionPlayer.playbackSuppressionReason == MediaPlayer.PLAYBACK_SUPPRESSION_REASON_NONE
303
357
 
304
358
  var repeatMode: RepeatMode
305
- get() = RepeatModeFactory.fromMedia3(exoPlayer.repeatMode)
359
+ get() = RepeatModeFactory.fromMedia3(sessionPlayer.repeatMode)
306
360
  internal set(value) {
307
- exoPlayer.repeatMode = RepeatModeFactory.toMedia3(value)
361
+ sessionPlayer.repeatMode = RepeatModeFactory.toMedia3(value)
308
362
  }
309
363
 
310
364
  val currentIndex: Int?
311
365
  get() =
312
- if (exoPlayer.currentMediaItemIndex == C.INDEX_UNSET) null
313
- else exoPlayer.currentMediaItemIndex
366
+ if (sessionPlayer.currentMediaItemIndex == C.INDEX_UNSET) null
367
+ else sessionPlayer.currentMediaItemIndex
314
368
 
315
369
  var shuffleMode: Boolean
316
- get() = exoPlayer.shuffleModeEnabled
370
+ get() = sessionPlayer.shuffleModeEnabled
317
371
  set(value) {
318
- exoPlayer.shuffleModeEnabled = value
372
+ sessionPlayer.shuffleModeEnabled = value
319
373
  }
320
374
 
321
375
  val trackCount: Int
322
- get() = exoPlayer.mediaItemCount
376
+ get() = sessionPlayer.mediaItemCount
323
377
 
324
378
  val isEmpty: Boolean
325
- get() = exoPlayer.mediaItemCount == 0
379
+ get() = sessionPlayer.mediaItemCount == 0
326
380
 
327
381
  val tracks: Array<Track>
328
382
  get() =
329
- (0 until exoPlayer.mediaItemCount)
330
- .map { index -> TrackFactory.fromMedia3(exoPlayer.getMediaItemAt(index)) }
383
+ (0 until sessionPlayer.mediaItemCount)
384
+ .map { index -> TrackFactory.fromMedia3(sessionPlayer.getMediaItemAt(index)) }
331
385
  .toTypedArray()
332
386
 
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
- */
387
+ /** In playback order, so shuffle and repeat count; not the last linear index. */
339
388
  val isLastInPlaybackOrder: Boolean
340
- get() = exoPlayer.nextMediaItemIndex == C.INDEX_UNSET
389
+ get() = sessionPlayer.nextMediaItemIndex == C.INDEX_UNSET
341
390
 
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
- */
391
+ /** The path the queue was expanded from, so selecting from the same source skips re-expanding. */
346
392
  var queueSourcePath: String? = null
347
393
  internal set
348
394
 
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
- */
395
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
355
396
  fun getTrack(index: Int): Track {
356
- if (index < 0 || index >= exoPlayer.mediaItemCount) {
397
+ if (index < 0 || index >= sessionPlayer.mediaItemCount) {
357
398
  throw IllegalArgumentException(
358
- "Track index $index is out of bounds (size: ${exoPlayer.mediaItemCount})"
399
+ "Track index $index is out of bounds (size: ${sessionPlayer.mediaItemCount})"
359
400
  )
360
401
  }
361
- return TrackFactory.fromMedia3(exoPlayer.getMediaItemAt(index))
402
+ return TrackFactory.fromMedia3(sessionPlayer.getMediaItemAt(index))
362
403
  }
363
404
 
364
405
  var skipSilence: Boolean
@@ -367,20 +408,32 @@ class Player(internal val context: Context) {
367
408
  exoPlayer.skipSilenceEnabled = value
368
409
  }
369
410
 
411
+ private var engineOptions: PlayerSetupOptions? = null
412
+
370
413
  /**
371
- * Sets up or recreates the ExoPlayer with the provided setup options. This method can be called
372
- * multiple times to change setup options.
414
+ * Builds the ExoPlayer on the first call, and rebuilds it only when the engine options changed. A
415
+ * rebuild carries over the queue, the position and the play intent.
373
416
  */
374
417
  fun setup(setupOptions: PlayerSetupOptions) {
375
- Timber.Forest.d("Setting up player with new options")
376
-
377
418
  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).
419
+ // Unwrapped from the Nitro Func so the updater never touches bridge types.
380
420
  nowPlaying.formatter =
381
421
  setupOptions.nowPlayingMetadataFormatter?.let { f -> { params -> f.invoke(params).await() } }
382
422
 
383
- val isInitialSetup = !::exoPlayer.isInitialized
423
+ val newEngineOptions = setupOptions.engineOptions()
424
+ if (newEngineOptions == engineOptions) {
425
+ Timber.Forest.d("Setup options unchanged: keeping the player")
426
+ } else {
427
+ buildEngine(setupOptions)
428
+ engineOptions = newEngineOptions
429
+ }
430
+ if (remoteOutputs.apply(setupOptions.remoteOutputs, exoPlayer)) attachSessionPlayer()
431
+ }
432
+
433
+ private fun buildEngine(setupOptions: PlayerSetupOptions) {
434
+ Timber.Forest.d("Setting up player with new options")
435
+ val isInitialSetup = engineOptions == null
436
+ val carried = if (isInitialSetup) null else EnginePlayback.of(exoPlayer)
384
437
 
385
438
  if (!isInitialSetup) {
386
439
  forwardingPlayer.removeListener(playerListener)
@@ -389,15 +442,15 @@ class Player(internal val context: Context) {
389
442
  }
390
443
 
391
444
  if (setupOptions.maxCacheSize > 0) {
392
- // SimpleCache locks its folder — re-setup must release the previous
393
- // instance first or the constructor throws.
445
+ // SimpleCache locks its folder: the constructor throws until the previous one is released.
394
446
  cache?.release()
395
447
  cache =
396
448
  SimpleCache(
397
449
  File(context.cacheDir, "RNAB"),
398
450
  LeastRecentlyUsedCacheEvictor(
451
+ // MB to bytes
399
452
  setupOptions.maxCacheSize.toLong() * 1_000_000
400
- ), // MB to bytes
453
+ ),
401
454
  StandaloneDatabaseProvider(context),
402
455
  )
403
456
  } else {
@@ -405,8 +458,6 @@ class Player(internal val context: Context) {
405
458
  cache = null
406
459
  }
407
460
 
408
- // One engine generation: load control, media factory, ExoPlayer (pure construction —
409
- // see buildPlayerEngine; lifecycle and wiring stay here).
410
461
  val engine =
411
462
  buildPlayerEngine(
412
463
  context,
@@ -415,65 +466,65 @@ class Player(internal val context: Context) {
415
466
  shouldRetry = { playWhenReadyCache },
416
467
  isOnline = { networkMonitor.getOnline() },
417
468
  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) },
469
+ onRetryPending = ::reportRetryingError,
470
+ resolveMediaConfig = { url, track -> browser?.getMediaRequestConfig(url, track) },
427
471
  )
428
472
  loadControl = engine.loadControl
429
473
  mediaFactory = engine.mediaFactory
430
474
  exoPlayer = engine.exoPlayer
475
+ // Before the listener and the session are attached, so neither hears the playback replayed.
476
+ carried?.restoreTo(exoPlayer)
477
+ remoteOutputs.setLocal(exoPlayer)
478
+ keepSessionAliveOnError = setupOptions.keepSessionAliveOnError
431
479
 
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)
480
+ if (isInitialSetup) playerListener = PlayerListener(this)
481
+ attachSessionPlayer()
482
+
483
+ if (isInitialSetup) {
484
+ callbacks?.onPlaybackChanged(Playback(PlaybackState.NONE, null))
485
+ equalizer.initialize(exoPlayer.audioSessionId)
486
+ } else if (localEngine.isActive) {
487
+ // No listener heard the restore, and its prepare() leaves the engine buffering. While remote,
488
+ // the receiver plays on unchanged.
489
+ setPlaybackState(
490
+ if (exoPlayer.playbackState == ExoPlayer.STATE_IDLE) PlaybackState.NONE
491
+ else PlaybackState.BUFFERING
492
+ )
493
+ // The new engine can refuse the carried intent (audio focus denied) without a change event,
494
+ // which would leave a stale true in the cache and in JS.
495
+ playWhenReadyCache = exoPlayer.playWhenReady
496
+ emitPlayWhenReadyChanged(exoPlayer.playWhenReady)
438
497
  }
439
498
 
440
- // Recreate forwarding player with new ExoPlayer
499
+ setupAutomaticBufferManager(setupOptions.automaticBuffer)
500
+ }
501
+
502
+ // Call whenever [exoPlayer] or the remote player changes.
503
+ private fun attachSessionPlayer() {
504
+ if (::forwardingPlayer.isInitialized) forwardingPlayer.removeListener(playerListener)
505
+ sessionPlayer = remoteOutputs.player ?: exoPlayer
441
506
  forwardingPlayer =
442
507
  InterceptingPlayer(
443
- exoPlayer,
508
+ sessionPlayer,
444
509
  { callbacks },
445
510
  { options },
446
- keepSessionAliveOnError = setupOptions.keepSessionAliveOnError,
511
+ keepSessionAliveOnError,
512
+ isPaused = { playbackState == PlaybackState.PAUSED },
447
513
  )
514
+ forwardingPlayer.addListener(playerListener)
515
+ if (::mediaSession.isInitialized) mediaSession.player = forwardingPlayer
516
+ }
448
517
 
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)
518
+ private suspend fun resolveRemoteUrls(track: Track): RemoteUrls {
519
+ val src = checkNotNull(track.src) { "The track has no src" }
520
+ val browserManager = browser?.browserManager
521
+ return RemoteUrls(
522
+ url = browserManager?.resolveMediaUrl(src, track)?.url() ?: src,
523
+ artworkUrl = browserManager?.resolveArtworkUrl(track)?.uri,
524
+ )
472
525
  }
473
526
 
474
- /** Sets up or tears down the automatic buffer manager based on the enabled flag. */
475
527
  private fun setupAutomaticBufferManager(enabled: Boolean) {
476
- // Detach existing manager if any
477
528
  automaticBufferManager?.detach()
478
529
 
479
530
  if (enabled) {
@@ -487,168 +538,87 @@ class Player(internal val context: Context) {
487
538
  }
488
539
  }
489
540
 
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
541
  fun observeNetworkConnectivity(scope: kotlinx.coroutines.CoroutineScope) {
497
542
  networkMonitor.observeOnline(scope) { isOnline ->
498
543
  callbacks?.onOnlineChanged(isOnline)
499
544
 
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.
545
+ // The formatter tells a stall from being offline, so it renders on a connectivity change too.
502
546
  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
547
  }
514
548
  }
515
549
 
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
- */
550
+ /** Replaces the current track, keeping the rest of the queue; on an empty queue, adds it. */
522
551
  fun load(track: Track) {
523
- if (exoPlayer.mediaItemCount == 0) {
552
+ if (sessionPlayer.mediaItemCount == 0) {
524
553
  add(track)
525
554
  } else {
526
- val index = exoPlayer.currentMediaItemIndex
555
+ val index = sessionPlayer.currentMediaItemIndex
527
556
  replaceTrack(index, track)
528
- exoPlayer.seekTo(index, C.TIME_UNSET)
529
- exoPlayer.prepare()
557
+ sessionPlayer.seekTo(index, C.TIME_UNSET)
558
+ sessionPlayer.prepare()
530
559
  }
531
560
  }
532
561
 
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
562
  fun add(track: Track) {
540
563
  val mediaItem = TrackFactory.toMedia3(track)
541
- exoPlayer.addMediaItem(mediaItem)
542
- exoPlayer.prepare()
564
+ sessionPlayer.addMediaItem(mediaItem)
565
+ sessionPlayer.prepare()
543
566
  }
544
567
 
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
568
  fun add(tracks: Array<Track>) {
552
569
  val mediaItems = TrackFactory.toMedia3(tracks)
553
- exoPlayer.addMediaItems(mediaItems.toList())
554
- exoPlayer.prepare()
570
+ sessionPlayer.addMediaItems(mediaItems.toList())
571
+ sessionPlayer.prepare()
555
572
  }
556
573
 
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
- */
574
+ /** @throws IllegalArgumentException unless [atIndex] is within the queue, or -1 to append. */
564
575
  fun add(tracks: Array<Track>, atIndex: Int) {
565
576
  validateInsertIndex(atIndex)
566
- val index = if (atIndex == -1) exoPlayer.mediaItemCount else atIndex
577
+ val index = if (atIndex == -1) sessionPlayer.mediaItemCount else atIndex
567
578
  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)
579
+ sessionPlayer.addMediaItems(index, mediaItems)
580
+ sessionPlayer.prepare()
581
581
  }
582
582
 
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
- */
583
+ /** @throws IllegalArgumentException if an index is out of bounds or repeated. */
590
584
  fun remove(indexes: List<Int>) {
591
585
  if (indexes.toSet().size != indexes.size) {
592
586
  throw IllegalArgumentException("Duplicate indexes provided")
593
587
  }
594
588
  indexes.forEach { validateIndex(it) }
595
- val sorted = indexes.sortedDescending()
596
- sorted.forEach { exoPlayer.removeMediaItem(it) }
589
+ val removesCurrent = sessionPlayer.currentMediaItemIndex in indexes
590
+ indexes.sortedDescending().forEach { sessionPlayer.removeMediaItem(it) }
591
+ // Loads the new current track on an engine an error left idle; a no-op otherwise.
592
+ if (removesCurrent && playWhenReady) prepare()
597
593
  }
598
594
 
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
595
  fun next() {
604
- exoPlayer.seekToNextMediaItem()
605
- exoPlayer.prepare()
596
+ sessionPlayer.seekToNextMediaItem()
597
+ sessionPlayer.prepare()
606
598
  }
607
599
 
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
600
  fun previous() {
613
- exoPlayer.seekToPreviousMediaItem()
614
- exoPlayer.prepare()
601
+ sessionPlayer.seekToPreviousMediaItem()
602
+ sessionPlayer.prepare()
615
603
  }
616
604
 
617
605
  /**
618
- * Move an track in the queue from one position to another.
606
+ * A [toIndex] past the end moves the track to the end.
619
607
  *
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.
608
+ * @throws IllegalArgumentException if [fromIndex] is out of bounds.
624
609
  */
625
610
  fun move(fromIndex: Int, toIndex: Int) {
626
611
  validateIndex(fromIndex)
627
- exoPlayer.moveMediaItem(fromIndex, toIndex)
612
+ sessionPlayer.moveMediaItem(fromIndex, toIndex)
628
613
  }
629
614
 
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
- */
615
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
636
616
  fun skipTo(index: Int) {
637
617
  validateIndex(index)
638
- exoPlayer.seekTo(index, C.TIME_UNSET)
639
- exoPlayer.prepare()
618
+ sessionPlayer.seekTo(index, C.TIME_UNSET)
619
+ sessionPlayer.prepare()
640
620
  }
641
621
 
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
622
  fun setQueue(
653
623
  tracks: Array<Track>,
654
624
  startIndex: Int = 0,
@@ -656,89 +626,58 @@ class Player(internal val context: Context) {
656
626
  sourcePath: String? = null,
657
627
  ) {
658
628
  val mediaItems = TrackFactory.toMedia3(tracks).toMutableList()
659
- exoPlayer.setMediaItems(mediaItems, startIndex, startPositionMs)
629
+ sessionPlayer.setMediaItems(mediaItems, startIndex, startPositionMs)
630
+ // While remote, the queue plays in list order.
631
+ if (mediaItems.isNotEmpty()) {
632
+ localEngine.setShuffleOrder(shuffleOrderLedBy(startIndex, mediaItems.size))
633
+ }
660
634
  queueSourcePath = sourcePath
661
- exoPlayer.prepare()
635
+ sessionPlayer.prepare()
662
636
  }
663
637
 
664
- /**
665
- * Replaces track at index in queue.
666
- *
667
- * @throws IllegalArgumentException if index is out of bounds.
668
- */
638
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
669
639
  fun replaceTrack(index: Int, track: Track) {
670
640
  validateIndex(index)
671
- exoPlayer.replaceMediaItem(index, TrackFactory.toMedia3(track))
641
+ val isCurrent = index == currentIndex
642
+ if (isCurrent) nowPlaying.forgetPublished()
643
+ sessionPlayer.replaceMediaItem(index, TrackFactory.toMedia3(track))
644
+ if (isCurrent) nowPlaying.render()
672
645
  }
673
646
 
674
647
  /**
675
- * Sets the favorited state of the currently playing track. Updates the heart icon in media
676
- * controllers without interrupting playback.
648
+ * @return false only when there is no current track, so MediaSession callers can report an
649
+ * invalid state instead of a success the controller then watches revert.
677
650
  */
678
- fun setActiveTrackFavorited(favorited: Boolean) {
679
- val currentTrack = this.currentTrack ?: return
651
+ fun setActiveTrackFavorited(favorited: Boolean): Boolean {
652
+ val currentTrack = this.currentTrack ?: return false
680
653
 
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) }
654
+ currentTrack.identity?.let { identity ->
655
+ browser?.browserManager?.updateFavorite(identity, favorited)
656
+ }
685
657
 
686
- val index = exoPlayer.currentMediaItemIndex
687
- if (index == C.INDEX_UNSET) return
658
+ val index = sessionPlayer.currentMediaItemIndex
659
+ // Still applied: the favorite is persisted above, and there is no heart to revert.
660
+ if (index == C.INDEX_UNSET) return true
688
661
 
689
- // Create updated Track with new favorited state
690
662
  val updatedTrack = currentTrack.copy(favorited = favorited)
663
+ restampMediaItem(index, updatedTrack) { setFavorite(favorited) }
691
664
 
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
665
  updateFavoriteButtonState(favorited)
710
666
 
711
- // Notify JS of the favorite state change
667
+ // The only emit: a favorite toggle mutates the active track in place, so the track and queue
668
+ // change events stay transition-only.
712
669
  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)
670
+ return true
727
671
  }
728
672
 
729
- /** Toggles the favorited state of the currently playing track. */
730
- fun toggleActiveTrackFavorited() {
731
- val currentTrack = this.currentTrack ?: return
732
- setActiveTrackFavorited(currentTrack.favorited != true)
673
+ fun toggleActiveTrackFavorited(): Boolean {
674
+ val currentTrack = this.currentTrack ?: return false
675
+ return setActiveTrackFavorited(currentTrack.favorited != true)
733
676
  }
734
677
 
735
678
  // MARK: - Now Playing Metadata
736
679
 
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
- */
680
+ /** [NowPlayingUpdater] does the rendering; this is its platform surface. */
742
681
  val nowPlaying: NowPlayingUpdater =
743
682
  NowPlayingUpdater(
744
683
  object : NowPlayingSurface {
@@ -755,7 +694,7 @@ class Player(internal val context: Context) {
755
694
  get() = this@Player.playbackError
756
695
 
757
696
  override val playWhenReady
758
- get() = exoPlayer.playWhenReady
697
+ get() = shouldPlayWhenReady
759
698
 
760
699
  override val isRebuffering
761
700
  get() = loadControl.isRebuffering
@@ -777,9 +716,8 @@ class Player(internal val context: Context) {
777
716
  setTitle(title)
778
717
  .setDisplayTitle(title)
779
718
  .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.
719
+ // Android Auto reads DISPLAY_SUBTITLE, not ARTIST, once DISPLAY_TITLE is set;
720
+ // `artist` still drives the lock screen and notification.
783
721
  .setSubtitle(secondaryLine)
784
722
  .setAlbumTitle(album)
785
723
  }
@@ -798,11 +736,12 @@ class Player(internal val context: Context) {
798
736
  null
799
737
  }
800
738
  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
739
+ val published =
740
+ TrackFactory.sessionArtworkUri(uri, resolved.headers, SvgArtworkRenderer.isSvgUrl(uri))
741
+ // Media3 hands this URI back to the bitmap loader, which re-resolves it with the
742
+ // nowPlayingArtwork config rather than the global artwork config.
743
+ browserManager.artworkResolutions.register(published, track, config)
744
+ return published
806
745
  }
807
746
 
808
747
  override fun emitNowPlayingChanged(metadata: NowPlayingMetadata) {
@@ -812,32 +751,47 @@ class Player(internal val context: Context) {
812
751
  MainScope(),
813
752
  )
814
753
 
815
- /** Republishes the item at [index] with mutated metadata, preserving uri and Track tag. */
754
+ /**
755
+ * One replacement for the whole queue: each separate one is a timeline change and a queue event
756
+ * to JS.
757
+ */
758
+ private fun restampFavorites() {
759
+ if (!::sessionPlayer.isInitialized || sessionPlayer.mediaItemCount == 0) return
760
+ val items =
761
+ (0 until sessionPlayer.mediaItemCount).map { index ->
762
+ val item = sessionPlayer.getMediaItemAt(index)
763
+ val track = item.localConfiguration?.tag as? Track ?: return@map item
764
+ item.restamped(track) { setFavorite(track.favorited) }
765
+ }
766
+ sessionPlayer.replaceMediaItems(0, items.size, items)
767
+ }
768
+
816
769
  private fun restampMediaItem(
817
770
  index: Int,
818
771
  track: Track,
819
772
  mutate: MediaMetadata.Builder.() -> MediaMetadata.Builder,
820
773
  ) {
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)
774
+ sessionPlayer.replaceMediaItem(
775
+ index,
776
+ sessionPlayer.getMediaItemAt(index).restamped(track, mutate),
777
+ )
830
778
  }
831
779
 
780
+ /** Keeps the uri so ExoPlayer updates the item in place instead of reloading it. */
781
+ private fun MediaItem.restamped(
782
+ track: Track,
783
+ mutate: MediaMetadata.Builder.() -> MediaMetadata.Builder,
784
+ ): MediaItem =
785
+ buildUpon()
786
+ .setUri(localConfiguration?.uri)
787
+ .setMediaMetadata(mediaMetadata.buildUpon().mutate().build())
788
+ .setTag(track)
789
+ .build()
790
+
832
791
  /**
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.
792
+ * Fresh retry budgets and unproven playback (ADR 0004): when the track changes, and when an error
793
+ * goes terminal, since whatever restarts playback from it starts a new load and nothing loads
794
+ * until then.
841
795
  */
842
796
  internal fun resetForNewLoad() {
843
797
  resetRetryTimer()
@@ -848,14 +802,10 @@ class Player(internal val context: Context) {
848
802
  mediaFactory.resetRetryTimer()
849
803
  }
850
804
 
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
- */
805
+ /** Main thread only (ExoPlayer access). */
856
806
  private fun findQueueTrackByArtworkUri(uri: String): Track? {
857
- for (i in 0 until exoPlayer.mediaItemCount) {
858
- val item = exoPlayer.getMediaItemAt(i)
807
+ for (i in 0 until sessionPlayer.mediaItemCount) {
808
+ val item = sessionPlayer.getMediaItemAt(i)
859
809
  if (item.mediaMetadata.artworkUri?.toString() == uri) {
860
810
  return item.localConfiguration?.tag as? Track
861
811
  }
@@ -864,10 +814,8 @@ class Player(internal val context: Context) {
864
814
  }
865
815
 
866
816
  /**
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".
817
+ * For [CoilBitmapLoader]: the resolution registry, then the queue track that published [uri],
818
+ * then headers alone for a URI nothing attributes. Null means fetch the URI as-is.
871
819
  */
872
820
  suspend fun resolveDisplayArtwork(uri: String, sizeHintPixels: Int?): ImageSource? {
873
821
  val browserManager = browser?.browserManager ?: return null
@@ -876,6 +824,14 @@ class Player(internal val context: Context) {
876
824
  browserManager.displayArtworkSource(uri, imageContext)?.let {
877
825
  return it
878
826
  }
827
+ // On Android Automotive OS the queue publishes provider URIs; the resolutions are keyed by URL.
828
+ TrackFactory.artworkRoutes
829
+ ?.publicUrl(uri.toUri())
830
+ ?.takeIf { it != uri }
831
+ ?.let { browserManager.displayArtworkSource(it, imageContext) }
832
+ ?.let {
833
+ return it
834
+ }
879
835
  withContext(Dispatchers.Main) { findQueueTrackByArtworkUri(uri) }
880
836
  ?.let { track ->
881
837
  return browserManager.resolveArtworkUrl(track, null, imageContext)
@@ -883,58 +839,54 @@ class Player(internal val context: Context) {
883
839
  return browserManager.unattributedArtworkSource(uri)
884
840
  }
885
841
 
886
- /**
887
- * Updates the favorite button icon in the notification/Android Auto. Call this when track changes
888
- * or favorite state changes.
889
- */
890
842
  internal fun updateFavoriteButtonState(favorited: Boolean?) {
891
843
  if (!::mediaSession.isInitialized) return
892
844
  mediaSessionCallback.commandManager.updateFavoriteState(mediaSession, favorited)
893
845
  }
894
846
 
895
- /** Removes all the upcoming tracks, if any (the ones returned by [next]). */
847
+ internal fun updateLiveState(live: Boolean) {
848
+ if (!::mediaSession.isInitialized) return
849
+ mediaSessionCallback.commandManager.updateLiveState(mediaSession, live)
850
+ }
851
+
896
852
  fun removeUpcomingTracks() {
897
- val index = exoPlayer.currentMediaItemIndex
853
+ val index = sessionPlayer.currentMediaItemIndex
898
854
  if (index == C.INDEX_UNSET) return
899
- val lastIndex = exoPlayer.mediaItemCount
855
+ val lastIndex = sessionPlayer.mediaItemCount
900
856
  val fromIndex = index + 1
901
857
 
902
- exoPlayer.removeMediaItems(fromIndex, lastIndex)
858
+ sessionPlayer.removeMediaItems(fromIndex, lastIndex)
903
859
  }
904
860
 
905
861
  fun play() {
906
- // Through the setter so the STATE_ENDED replay handling applies
907
- // (ExoPlayer.play() is only setPlayWhenReady(true)).
862
+ // Through the setter for its replay of an ended player.
908
863
  playWhenReady = true
909
864
  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()
865
+ // No-op unless the player is idle, so this reconnects only after stop() or an error and never
866
+ // re-buffers a healthy stream. Reconnecting is also how a live stream rejoins its live edge.
867
+ sessionPlayer.prepare()
915
868
  }
916
869
  }
917
870
 
918
- /** Jump to the live edge (default position) of a live item; no-op otherwise. */
871
+ /**
872
+ * No-op unless the track declares `live`; ExoPlayer never marks progressive ICY radio live. A
873
+ * stream with a live window seeks to its edge; anything else reconnects, which for a non-seekable
874
+ * stream is the live edge.
875
+ */
919
876
  fun seekToLiveEdge() {
920
- if (exoPlayer.isCurrentMediaItemLive) {
921
- exoPlayer.seekToDefaultPosition()
922
- }
877
+ if (currentTrack?.live != true) return
878
+ // A receiver loads a live stream again on a seek to its default position.
879
+ if (!localEngine.reconnectAtLiveEdge()) sessionPlayer.seekToDefaultPosition()
923
880
  }
924
881
 
925
882
  /**
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
883
+ * @return whether a result started playing: false when gated (after onGate), with no results, or
884
+ * on any error, the browser's registration timeout included.
931
885
  */
932
886
  suspend fun playFromSearch(params: SearchParams): Boolean {
933
887
  return try {
934
888
  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.
889
+ // Gated like browsing, or voice search would be a way around the gate.
938
890
  val gateOutcome =
939
891
  audioBrowser.gateDecision(
940
892
  NativeGateRequest(reason = GateReason.SEARCH, path = null, search = params)
@@ -968,54 +920,46 @@ class Player(internal val context: Context) {
968
920
 
969
921
  fun prepare() {
970
922
  if (currentTrack != null) {
971
- exoPlayer.prepare()
923
+ sessionPlayer.prepare()
972
924
  }
973
925
  }
974
926
 
975
927
  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.
928
+ // Through the setter, so the retry policy sees playWhenReadyCache drop at once.
979
929
  playWhenReady = false
980
930
  }
981
931
 
982
932
  fun togglePlayback() {
983
- if (exoPlayer.playWhenReady) {
984
- pause()
985
- } else {
986
- play()
933
+ when {
934
+ // Suppressed with the intent raised: ExoPlayer resumes when focus returns. play() would
935
+ // request focus again, and during a call that refusal drops the intent.
936
+ playWhenReady && !shouldPlayWhenReady -> Unit
937
+ PlayingStateFactory.derive(shouldPlayWhenReady, playbackState).playing -> pause()
938
+ else -> play()
987
939
  }
988
940
  }
989
941
 
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
- */
942
+ /** Keeps the queue; the state becomes STOPPED. */
995
943
  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).
944
+ // State first, so the state machine's STOPPED guard swallows the PAUSED the drop below causes.
999
945
  setPlaybackState(PlaybackState.STOPPED)
1000
946
  playWhenReady = false
1001
- exoPlayer.stop()
947
+ sessionPlayer.stop()
1002
948
  }
1003
949
 
1004
950
  fun clear() {
1005
- exoPlayer.clearMediaItems()
951
+ sessionPlayer.clearMediaItems()
1006
952
  queueSourcePath = null
1007
953
  }
1008
954
 
1009
- /**
1010
- * Stops and destroys the player. Only call this when you are finished using the player, otherwise
1011
- * use [pause].
1012
- */
955
+ /** Idempotent. */
1013
956
  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.
957
+ if (destroyed) return
958
+ destroyed = true
959
+ // stop() saves only if playing; before it, so its STOPPED doesn't defeat the ENDED guard.
960
+ playbackStateStore.stopPeriodicSave()
961
+ // An armed timer would fire pause() into the released player. Cleared before the release,
962
+ // while a mid-ramp fade can still restore the volume.
1019
963
  sleepTimer.clear()
1020
964
  stop()
1021
965
  nowPlaying.destroy()
@@ -1023,6 +967,7 @@ class Player(internal val context: Context) {
1023
967
  forwardingPlayer.removeListener(playerListener)
1024
968
  automaticBufferManager?.detach()
1025
969
  automaticBufferManager = null
970
+ remoteOutputs.release()
1026
971
  exoPlayer.release()
1027
972
  cache?.release()
1028
973
  cache = null
@@ -1032,36 +977,32 @@ class Player(internal val context: Context) {
1032
977
 
1033
978
  fun seekTo(duration: Long, unit: TimeUnit) {
1034
979
  val positionMs = TimeUnit.MILLISECONDS.convert(duration, unit)
1035
- exoPlayer.seekTo(positionMs)
980
+ sessionPlayer.seekTo(positionMs)
1036
981
  }
1037
982
 
1038
983
  fun seekBy(offset: Long, unit: TimeUnit) {
1039
- val positionMs = exoPlayer.currentPosition + TimeUnit.MILLISECONDS.convert(offset, unit)
1040
- exoPlayer.seekTo(positionMs)
984
+ val positionMs = sessionPlayer.currentPosition + TimeUnit.MILLISECONDS.convert(offset, unit)
985
+ sessionPlayer.seekTo(positionMs)
1041
986
  }
1042
987
 
1043
988
  /**
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.
989
+ * Bumped on track change so a [reportRetryingError] post for the outgoing track is dropped.
990
+ * Written on main, read on ExoPlayer's loader thread.
1047
991
  */
1048
992
  @Volatile private var retryingErrorGeneration = 0
1049
993
 
1050
994
  /**
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.
995
+ * Attaches a load failure the retry policy is still working on to the current state, for UIs to
996
+ * show over the spinner. Not an ERROR and not [Callbacks.onPlaybackError], which stays terminal.
997
+ * Called on ExoPlayer's loader thread.
1055
998
  */
1056
999
  private fun reportRetryingError(exception: IOException) {
1057
1000
  val error = PlaybackErrorClassifier.retryingLoadError(exception, networkMonitor.getOnline())
1058
1001
  val generation = retryingErrorGeneration
1059
1002
  mainHandler.post {
1060
- // The track changed while this post was in flight — the error belongs to the old one.
1061
1003
  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.
1004
+ // Only over a spinner: while PLAYING, buffered audio still plays and ExoPlayer's in-place
1005
+ // retry can succeed with no state change, so an error attached there would never clear.
1065
1006
  if (
1066
1007
  playbackState != PlaybackState.LOADING &&
1067
1008
  playbackState != PlaybackState.BUFFERING &&
@@ -1069,19 +1010,34 @@ class Player(internal val context: Context) {
1069
1010
  ) {
1070
1011
  return@post
1071
1012
  }
1072
- // Each failed attempt re-reports; identical repeats add nothing (and would
1073
- // re-render now-playing every backoff tick).
1013
+ // Each backoff tick re-reports the same error.
1074
1014
  if (playbackError == error) return@post
1075
1015
  playbackError = error
1076
1016
  callbacks?.onPlaybackChanged(Playback(playbackState, error))
1077
1017
  nowPlaying.render()
1018
+ // A pause before this first report found no retry to cancel.
1019
+ if (!playWhenReadyCache) cancelRetry()
1078
1020
  }
1079
1021
  }
1080
1022
 
1081
1023
  /**
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.
1024
+ * Cancels the retry a dropped play intent leaves scheduled: ExoPlayer still runs it, and its
1025
+ * failure would be terminal. The engine idles in PAUSED, where the next prepare() reloads where
1026
+ * it failed. No-op unless a retrying error shows.
1027
+ */
1028
+ internal fun cancelRetry() {
1029
+ // The ENDED path drops the intent before it clears the error.
1030
+ if (playbackError?.retrying != true || playbackState == PlaybackState.ENDED) return
1031
+ // Before the stop: the state machine holds PAUSED through the IDLE that follows.
1032
+ setPlaybackState(PlaybackState.PAUSED)
1033
+ clearRetryingError()
1034
+ exoPlayer.stop()
1035
+ resetRetryTimer()
1036
+ }
1037
+
1038
+ /**
1039
+ * Drops the retrying error of a track that is gone. The new track may stay LOADING or BUFFERING
1040
+ * with no state change to emit the clear.
1085
1041
  */
1086
1042
  internal fun clearRetryingError() {
1087
1043
  retryingErrorGeneration++
@@ -1091,56 +1047,35 @@ class Player(internal val context: Context) {
1091
1047
  nowPlaying.render()
1092
1048
  }
1093
1049
 
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
- */
1050
+ /** Every state change goes through here: it emits the change and the events that follow it. */
1104
1051
  internal fun setPlaybackState(state: PlaybackState) {
1105
1052
  if (state != playbackState) {
1106
1053
  val oldState = playbackState
1107
1054
  playbackState = state
1108
1055
 
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
- }
1056
+ if (state == PlaybackState.PLAYING) hasPlayedCache = true
1057
+ if (state == PlaybackState.ERROR) resetForNewLoad()
1114
1058
 
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.
1059
+ // A natural end exhausts the play intent; held, it inverts the toggle, keeps audio focus and
1060
+ // the periodic save. Emitted before the state and queue-ended callbacks, matching iOS. The
1061
+ // state machine's ENDED guard keeps the drop from reporting PAUSED.
1123
1062
  if (state == PlaybackState.ENDED && playWhenReady) {
1124
1063
  playWhenReady = false
1125
1064
  emitPlayWhenReadyChanged(false)
1126
1065
  }
1127
1066
 
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.
1067
+ // The last track fires no AUTO transition, so the end-of-track sleep timer would stay armed.
1131
1068
  if (state == PlaybackState.ENDED) {
1132
1069
  sleepTimer.onTrackEnd()
1133
1070
  }
1134
1071
 
1135
- // Clear error when transitioning away from error state
1136
1072
  if (oldState == PlaybackState.ERROR) {
1137
1073
  playbackError = null
1138
1074
  callbacks?.onPlaybackError(null)
1139
1075
  }
1140
1076
 
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.
1077
+ // A retrying error rides through LOADING, BUFFERING and PAUSED; any other state proves
1078
+ // recovery or abandons the attempt.
1144
1079
  if (
1145
1080
  playbackError?.retrying == true &&
1146
1081
  state != PlaybackState.LOADING &&
@@ -1153,25 +1088,16 @@ class Player(internal val context: Context) {
1153
1088
  val playback = Playback(state, playbackError)
1154
1089
  callbacks?.onPlaybackChanged(playback)
1155
1090
 
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.
1091
+ // The formatter sees the state, so any transition can change what it renders.
1161
1092
  nowPlaying.render()
1162
1093
 
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
1094
+ // A repeat mode never ends the queue, even on an ENDED from a seek to the end.
1168
1095
  if (state == PlaybackState.ENDED && isLastInPlaybackOrder && repeatMode == RepeatMode.OFF) {
1169
1096
  currentIndex?.let { index ->
1170
1097
  val event =
1171
1098
  PlaybackQueueEndedEvent(track = index.toDouble(), position = position.toSeconds())
1172
1099
  callbacks?.onPlaybackQueueEnded(event)
1173
1100
  }
1174
- // Reset saved position to 0 so resumption starts from beginning
1175
1101
  playbackStateStore.savePositionZero()
1176
1102
  }
1177
1103
 
@@ -1181,11 +1107,7 @@ class Player(internal val context: Context) {
1181
1107
  }
1182
1108
  }
1183
1109
 
1184
- /**
1185
- * Sets the progress update interval.
1186
- *
1187
- * @param interval The interval in seconds, or null to disable progress updates
1188
- */
1110
+ /** [interval] in seconds; null stops the progress events. */
1189
1111
  fun setProgressUpdateInterval(interval: Double?) {
1190
1112
  progressTimer.setInterval(interval)
1191
1113
  }
@@ -1194,21 +1116,11 @@ class Player(internal val context: Context) {
1194
1116
  intervalTimer.setInterval(if (enabled) 1.0 else null)
1195
1117
  }
1196
1118
 
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
1119
  fun applyOptions(options: PlayerUpdateOptions) {
1205
- // Store previous values for change detection
1206
1120
  val previousOptions = this.options
1207
1121
 
1208
- // Update current options
1209
1122
  this.options = options.copy()
1210
1123
 
1211
- // Check what changed
1212
1124
  val skipSilenceChanged = previousOptions.skipSilence != options.skipSilence
1213
1125
  val progressUpdateEventIntervalChanged =
1214
1126
  previousOptions.progressUpdateEventInterval != options.progressUpdateEventInterval
@@ -1231,23 +1143,25 @@ class Player(internal val context: Context) {
1231
1143
  remoteButtonLayoutChanged ||
1232
1144
  appKilledPlaybackBehaviorChanged
1233
1145
 
1234
- // Apply only changed properties
1235
1146
  if (skipSilenceChanged) {
1236
1147
  skipSilence = options.skipSilence
1237
1148
  }
1238
1149
 
1239
1150
  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)
1151
+ // The favorite capability is the one favoriting switch; the browser hydrates row hearts from
1152
+ // it.
1153
+ browser?.browserManager?.setFavoriteEnabled(options.capabilities.favoriteEnabled)
1154
+ TrackFactory.favoriteEnabled = options.capabilities.favoriteEnabled
1155
+ if (previousOptions.capabilities.favoriteEnabled != options.capabilities.favoriteEnabled) {
1156
+ restampFavorites()
1157
+ }
1243
1158
  }
1244
1159
 
1245
1160
  if (progressUpdateEventIntervalChanged) {
1246
1161
  setProgressUpdateInterval(options.progressUpdateEventInterval)
1247
1162
  }
1248
1163
 
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.
1164
+ // The jump intervals pick the button icons, so a changed interval rebuilds the layout.
1251
1165
  if (
1252
1166
  capabilitiesChanged ||
1253
1167
  remoteButtonLayoutChanged ||
@@ -1270,20 +1184,10 @@ class Player(internal val context: Context) {
1270
1184
  }
1271
1185
  }
1272
1186
 
1273
- /**
1274
- * Sets the callbacks for player events.
1275
- *
1276
- * @param callbacks The callbacks to set, or null to clear callbacks
1277
- */
1278
1187
  fun setCallbacks(callbacks: Callbacks?) {
1279
1188
  this.callbacks = callbacks
1280
1189
  }
1281
1190
 
1282
- /**
1283
- * Gets the current callbacks instance.
1284
- *
1285
- * @return The current callbacks, or null if none are set
1286
- */
1287
1191
  fun getCallbacks(): Callbacks? {
1288
1192
  return this.callbacks
1289
1193
  }
@@ -1296,58 +1200,30 @@ class Player(internal val context: Context) {
1296
1200
  return options
1297
1201
  }
1298
1202
 
1299
- /**
1300
- * Gets the current network connectivity state.
1301
- *
1302
- * @return true if device is online, false otherwise
1303
- */
1304
1203
  fun getOnline(): Boolean {
1305
1204
  return networkMonitor.getOnline()
1306
1205
  }
1307
1206
 
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
1207
  private fun validateIndex(index: Int) {
1315
- if (index < 0 || index >= exoPlayer.mediaItemCount) {
1208
+ if (index < 0 || index >= sessionPlayer.mediaItemCount) {
1316
1209
  throw IllegalArgumentException(
1317
- "Track index $index is out of bounds (size: ${exoPlayer.mediaItemCount})"
1210
+ "Track index $index is out of bounds (size: ${sessionPlayer.mediaItemCount})"
1318
1211
  )
1319
1212
  }
1320
1213
  }
1321
1214
 
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
1215
  private fun validateInsertIndex(index: Int) {
1329
- if (index < -1 || index > exoPlayer.mediaItemCount) {
1216
+ if (index < -1 || index > sessionPlayer.mediaItemCount) {
1330
1217
  throw IllegalArgumentException(
1331
- "Insert index $index is out of bounds (size: ${exoPlayer.mediaItemCount}, use -1 to append)"
1218
+ "Insert index $index is out of bounds (size: ${sessionPlayer.mediaItemCount}, use -1 to append)"
1332
1219
  )
1333
1220
  }
1334
1221
  }
1335
1222
 
1336
- /**
1337
- * Gets the MediaSessionCallback for this AudioBrowser.
1338
- *
1339
- * @return MediaLibrarySession.Callback instance
1340
- */
1341
1223
  fun getMediaSessionCallback(): MediaLibraryService.MediaLibrarySession.Callback {
1342
1224
  return mediaSessionCallback
1343
1225
  }
1344
1226
 
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
1227
  fun notifyContentChanged(path: String) {
1352
1228
  mediaSessionCallback.notifyContentChanged(path)
1353
1229
  }
@@ -1356,41 +1232,24 @@ class Player(internal val context: Context) {
1356
1232
  mediaSessionCallback.invalidateAllContent()
1357
1233
  }
1358
1234
 
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
- */
1235
+ /** From the connected media browser (e.g. Android Auto), when it gives one. */
1363
1236
  val artworkSizeHintPixels: Int?
1364
1237
  get() = mediaSessionCallback.artworkSizeHintPixels
1365
1238
 
1366
- /** Returns true if the current media item is a live stream. */
1367
1239
  val isCurrentItemLive: Boolean
1368
- get() = exoPlayer.isCurrentMediaItemLive
1240
+ get() = sessionPlayer.isCurrentMediaItemLive
1369
1241
 
1370
1242
  // MARK: - Buffer Configuration
1371
1243
 
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
- */
1244
+ /** Takes effect for future buffering; what is buffered stays. */
1380
1245
  fun updateBufferConfig(config: BufferConfig) {
1381
1246
  loadControl.updateBufferConfig(config)
1382
1247
  }
1383
1248
 
1384
- /**
1385
- * Gets the current buffer configuration.
1386
- *
1387
- * @return The current buffer configuration.
1388
- */
1389
1249
  fun getBufferConfig(): BufferConfig {
1390
1250
  return loadControl.getBufferConfig()
1391
1251
  }
1392
1252
 
1393
- /** Resets the buffer configuration to defaults. */
1394
1253
  fun resetBufferConfig() {
1395
1254
  loadControl.resetToDefaults()
1396
1255
  }