react-native-audio-browser 0.2.0-next.6 → 0.2.0-next.61

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