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
@@ -1,6 +1,7 @@
1
1
  package com.audiobrowser.player
2
2
 
3
3
  import android.os.Bundle
4
+ import androidx.core.content.ContextCompat
4
5
  import androidx.media3.common.MediaItem
5
6
  import androidx.media3.common.MediaMetadata
6
7
  import androidx.media3.common.Rating
@@ -11,22 +12,35 @@ import androidx.media3.session.MediaSession
11
12
  import androidx.media3.session.SessionCommand
12
13
  import androidx.media3.session.SessionError
13
14
  import androidx.media3.session.SessionResult
15
+ import com.audiobrowser.browser.BrowserManager
14
16
  import com.audiobrowser.browser.handleTrackLoad
17
+ import com.audiobrowser.browser.normalizedSections
18
+ import com.audiobrowser.browser.styleResolvedSections
19
+ import com.audiobrowser.browser.untitledSection
20
+ import com.audiobrowser.extension.indexOfTappedTrack
15
21
  import com.audiobrowser.extension.toTrack
22
+ import com.audiobrowser.navigationErrorFor
23
+ import com.audiobrowser.util.Automotive
16
24
  import com.audiobrowser.util.BrowserPathHelper
17
25
  import com.audiobrowser.util.RatingFavorites
18
26
  import com.audiobrowser.util.TrackFactory
27
+ import com.audiobrowser.util.isAutomotive
19
28
  import com.google.common.collect.ImmutableList
29
+ import com.google.common.util.concurrent.FutureCallback
20
30
  import com.google.common.util.concurrent.Futures
21
31
  import com.google.common.util.concurrent.ListenableFuture
32
+ import com.margelo.nitro.audiobrowser.FormattedNavigationError
22
33
  import com.margelo.nitro.audiobrowser.Gate
23
34
  import com.margelo.nitro.audiobrowser.GateEvent
24
35
  import com.margelo.nitro.audiobrowser.GateReason
25
36
  import com.margelo.nitro.audiobrowser.MediaReference
26
37
  import com.margelo.nitro.audiobrowser.NativeGateRequest
38
+ import com.margelo.nitro.audiobrowser.NavigationError
39
+ import com.margelo.nitro.audiobrowser.NavigationErrorType
27
40
  import com.margelo.nitro.audiobrowser.PlayerCapabilities
28
41
  import com.margelo.nitro.audiobrowser.RemoteButtonLayout
29
42
  import com.margelo.nitro.audiobrowser.SearchParams
43
+ import com.margelo.nitro.audiobrowser.Section
30
44
  import com.margelo.nitro.audiobrowser.Track
31
45
  import kotlinx.coroutines.CancellationException
32
46
  import kotlinx.coroutines.CoroutineScope
@@ -40,38 +54,39 @@ import kotlinx.coroutines.withContext
40
54
  import timber.log.Timber
41
55
 
42
56
  /**
43
- * MediaLibrarySession callback that handles all media session interactions. All logic is handled
44
- * directly by the AudioBrowser.
57
+ * Everything the MediaLibrarySession serves except transport, which reaches the player through
58
+ * [InterceptingPlayer]; Assistant's play-from-search arrives as an intent in the service. Callbacks
59
+ * answering through [scope] run on IO, so anything touching ExoPlayer hops to [Dispatchers.Main];
60
+ * the rest answer on the Media3 application thread.
45
61
  */
46
62
  class MediaSessionCallback(private val player: Player) :
47
63
  MediaLibraryService.MediaLibrarySession.Callback {
48
- internal val commandManager = MediaSessionCommandManager()
64
+ internal val commandManager = MediaSessionCommandManager(player.context.isAutomotive)
49
65
  private val scope = CoroutineScope(Dispatchers.IO + SupervisorJob())
50
66
 
51
- // Track which controllers are subscribed to which media IDs.
52
- // Mutated on the Media3 application thread (onSubscribe/onUnsubscribe) but read from other
53
- // threads (network observer, JS-triggered notifies) — guard all access with synchronized(this).
67
+ // Written on the Media3 application thread, read from the network observer and JS-triggered
68
+ // notifies: every access goes through synchronized(this).
54
69
  private val parentIdSubscriptions =
55
70
  mutableMapOf<String, MutableSet<MediaSession.ControllerInfo>>()
71
+ private val failedSearch = FailedSearchSlot()
72
+ private val offlineSearches = OfflineSearchRegistry()
56
73
  private var mediaLibrarySession: MediaLibraryService.MediaLibrarySession? = null
57
74
 
58
- /**
59
- * Recommended artwork size in pixels from the connected media browser (e.g., Android Auto).
60
- * Updated when onGetLibraryRoot is called with EXTRAS_KEY_MEDIA_ART_SIZE_PIXELS hint.
61
- */
75
+ /** The art size the last browser hinted in onGetLibraryRoot, or null before any hint. */
62
76
  @Volatile
63
77
  var artworkSizeHintPixels: Int? = null
64
78
  private set
65
79
 
66
80
  init {
67
- // Observe network state changes and notify subscribers
68
- player.networkMonitor.observeOnline(scope) { _ -> notifySubscribedChildrenChanged() }
81
+ player.networkMonitor.observeOnline(scope) { online ->
82
+ notifySubscribedChildrenChanged()
83
+ // A browse level is re-queried through its subscription; a search has none, so its offline
84
+ // tile leaves the screen only when the query runs again.
85
+ if (online) scope.launch { reannounceOfflineSearches() }
86
+ }
69
87
  }
70
88
 
71
- /**
72
- * Apply pagination to a list of items. If pageSize is 0 or MAX_VALUE (Android Auto default),
73
- * returns the full list.
74
- */
89
+ /** Media3's legacy browse bridge asks for a whole list with pageSize [Int.MAX_VALUE]. */
75
90
  private fun <T> List<T>.paginate(page: Int, pageSize: Int): List<T> {
76
91
  return if (pageSize in 1 until Int.MAX_VALUE) {
77
92
  this.drop(page * pageSize).take(pageSize)
@@ -80,50 +95,7 @@ class MediaSessionCallback(private val player: Player) :
80
95
  }
81
96
  }
82
97
 
83
- /** Creates an offline error MediaItem. */
84
- private fun createOfflineMediaItem(): MediaItem =
85
- createErrorMediaItem(
86
- mediaId = BrowserPathHelper.OFFLINE_PATH,
87
- title = player.context.getString(com.audiobrowser.R.string.audio_browser_offline_error),
88
- subtitle =
89
- player.context.getString(com.audiobrowser.R.string.audio_browser_offline_error_subtitle),
90
- )
91
-
92
- /**
93
- * Builds a non-browsable, non-playable [MediaItem] used to surface an error inside an Android
94
- * Auto / AAOS browse list. Rendered as a greyed-out, non-interactive tile, which is the only
95
- * side-effect-free way to communicate a browse failure to legacy controllers (Media3 drops
96
- * [LibraryResult.ofError] on the legacy browse bridge, leaving an empty "No items" screen).
97
- */
98
- private fun createErrorMediaItem(mediaId: String, title: String, subtitle: String): MediaItem =
99
- MediaItem.Builder()
100
- .setMediaId(mediaId)
101
- .setMediaMetadata(
102
- MediaMetadata.Builder()
103
- .setTitle(title)
104
- .setSubtitle(subtitle)
105
- // Non-browsable, non-playable. Android Auto ignores these flags and still drills into a
106
- // tapped tile, but onGetChildren returns an empty list for the sentinel paths so it's a
107
- // harmless "No Items" dead-end rather than an endless stack of error pages.
108
- .setIsBrowsable(false)
109
- .setIsPlayable(false)
110
- .build()
111
- )
112
- .build()
113
-
114
- /**
115
- * Builds the gate tile from a per-request chrome: while a gate is active, tabs stay visible but a
116
- * gated browse/search level serves this single tile (see the gate checks in [onGetChildren] /
117
- * [onGetSearchResult]). Same shape as the error tiles — non-browsable, non-playable — and
118
- * deliberately NOT accompanied by a SessionError: a gate is deliberate app state, not a failure.
119
- * The message renders as the tile's subtitle (newlines collapse to spaces — list rows are
120
- * single-line).
121
- */
122
- /**
123
- * Wraps a raw external-search query string into the structured [SearchParams] the gate request
124
- * carries. The car search surfaces only give a free-text query, so the other fields stay null —
125
- * mirrors BrowserManager's query→SearchParams construction.
126
- */
98
+ // Car search surfaces give free text only. Mirrors BrowserManager's query→SearchParams.
127
99
  private fun searchParams(query: String): SearchParams =
128
100
  SearchParams(
129
101
  mode = null,
@@ -138,23 +110,8 @@ class MediaSessionCallback(private val player: Player) :
138
110
 
139
111
  private fun createGateMediaItem(gate: Gate): MediaItem =
140
112
  createErrorMediaItem(
141
- mediaId = BrowserPathHelper.GATE_PATH,
142
- title = gate.title,
143
- subtitle = gate.message?.replace('\n', ' ') ?: "",
144
- )
145
-
146
- /**
147
- * Builds a generic "something went wrong" error tile for a browse failure. The true offline case
148
- * is handled separately by the [networkMonitor] guard in [onGetChildren]; anything reaching the
149
- * catch block is an online-but-failed request (e.g. server down, bad status), so it must NOT be
150
- * labelled "no internet connection".
151
- */
152
- private fun createBrowseErrorMediaItem(): MediaItem =
153
- createErrorMediaItem(
154
- mediaId = BrowserPathHelper.ERROR_PATH,
155
- title = player.context.getString(com.audiobrowser.R.string.audio_browser_browse_error),
156
- subtitle =
157
- player.context.getString(com.audiobrowser.R.string.audio_browser_browse_error_subtitle),
113
+ BrowserPathHelper.GATE_PATH,
114
+ FormattedNavigationError(gate.title, gate.message),
158
115
  )
159
116
 
160
117
  fun updateMediaSession(
@@ -165,7 +122,6 @@ class MediaSessionCallback(private val player: Player) :
165
122
  forwardJumpInterval: Double,
166
123
  backwardJumpInterval: Double,
167
124
  ) {
168
- // Store as MediaLibrarySession for notifyChildrenChanged support
169
125
  this.mediaLibrarySession = mediaSession as? MediaLibraryService.MediaLibrarySession
170
126
  commandManager.updateMediaSession(
171
127
  mediaSession,
@@ -185,18 +141,34 @@ class MediaSessionCallback(private val player: Player) :
185
141
  return commandManager.buildConnectionResult(session)
186
142
  }
187
143
 
144
+ override fun onDisconnected(session: MediaSession, controller: MediaSession.ControllerInfo) {
145
+ Timber.Forest.d("MediaSession disconnect: ${controller.packageName}")
146
+ // Android Auto normally leaves without unsubscribing; the controller would be notified, and
147
+ // held, forever.
148
+ offlineSearches.forget(controller)
149
+ synchronized(this) {
150
+ parentIdSubscriptions.values.forEach { it.remove(controller) }
151
+ parentIdSubscriptions.entries.removeAll { (_, browsers) -> browsers.isEmpty() }
152
+ }
153
+ super.onDisconnected(session, controller)
154
+ }
155
+
188
156
  override fun onCustomCommand(
189
157
  session: MediaSession,
190
158
  controller: MediaSession.ControllerInfo,
191
159
  command: SessionCommand,
192
160
  args: Bundle,
193
161
  ): ListenableFuture<SessionResult> {
194
- // Handle favorite button tap
162
+ // A success makes the controller flip its heart optimistically, so a no-op (no current track)
163
+ // reports INVALID_STATE rather than success-then-revert.
195
164
  if (command.customAction == MediaSessionCommandManager.CUSTOM_ACTION_FAVORITE) {
196
- val currentFavorited = player.currentTrack?.favorited ?: false
197
- Timber.d("Favorite button tapped - toggling from $currentFavorited to ${!currentFavorited}")
198
- player.setActiveTrackFavorited(!currentFavorited)
199
- return Futures.immediateFuture(SessionResult(SessionResult.RESULT_SUCCESS))
165
+ val applied = player.toggleActiveTrackFavorited()
166
+ Timber.d("Favorite button tapped - toggle applied=$applied")
167
+ return Futures.immediateFuture(
168
+ SessionResult(
169
+ if (applied) SessionResult.RESULT_SUCCESS else SessionResult.RESULT_ERROR_INVALID_STATE
170
+ )
171
+ )
200
172
  }
201
173
 
202
174
  if (commandManager.handleCustomCommand(command, player)) {
@@ -210,26 +182,41 @@ class MediaSessionCallback(private val player: Player) :
210
182
  controller: MediaSession.ControllerInfo,
211
183
  rating: Rating,
212
184
  ): ListenableFuture<SessionResult> {
213
- // A heart rating from a controller (e.g. Google Assistant "I like this") toggles the
214
- // now-playing favorite. setActiveTrackFavorited fires onFavoriteChanged so the consumer
215
- // persists it — the same path as the notification / CarPlay heart button.
216
- RatingFavorites.favoritedFor(rating)?.let { player.setActiveTrackFavorited(it) }
185
+ // A heart rating sets the now-playing favorite, as the favorite button does; INVALID_STATE when
186
+ // there is no current track.
187
+ RatingFavorites.favoritedFor(rating)?.let { favorited ->
188
+ val applied = player.setActiveTrackFavorited(favorited)
189
+ return Futures.immediateFuture(
190
+ SessionResult(
191
+ if (applied) SessionResult.RESULT_SUCCESS else SessionResult.RESULT_ERROR_INVALID_STATE
192
+ )
193
+ )
194
+ }
217
195
  return super.onSetRating(session, controller, rating)
218
196
  }
219
197
 
198
+ /**
199
+ * A legacy controller's setRating names the current item; a Media3 controller's can name any
200
+ * item. Only the current one can be rated.
201
+ */
202
+ override fun onSetRating(
203
+ session: MediaSession,
204
+ controller: MediaSession.ControllerInfo,
205
+ mediaId: String,
206
+ rating: Rating,
207
+ ): ListenableFuture<SessionResult> =
208
+ if (mediaId == session.player.currentMediaItem?.mediaId) {
209
+ onSetRating(session, controller, rating)
210
+ } else {
211
+ super.onSetRating(session, controller, mediaId, rating)
212
+ }
213
+
220
214
  @androidx.annotation.OptIn(androidx.media3.common.util.UnstableApi::class)
221
215
  override fun onGetLibraryRoot(
222
216
  session: MediaLibraryService.MediaLibrarySession,
223
217
  browser: MediaSession.ControllerInfo,
224
218
  params: MediaLibraryService.LibraryParams?,
225
219
  ): ListenableFuture<LibraryResult<MediaItem>> {
226
- // Extract artwork size hint from root hints (e.g., from Android Auto)
227
- // TODO: Also consider these other root hints in the future:
228
- // - KEY_ROOT_HINT_MEDIA_HOST_VERSION
229
- // - KEY_ROOT_HINT_MEDIA_SESSION_API
230
- // - BROWSER_ROOT_HINTS_KEY_CUSTOM_BROWSER_ACTION_LIMIT
231
- // - BROWSER_ROOT_HINTS_KEY_ROOT_CHILDREN_LIMIT
232
- // - KEY_ROOT_HINT_MAX_QUEUE_ITEMS_WHILE_RESTRICTED
233
220
  params?.extras?.getInt(MediaConstants.EXTRAS_KEY_MEDIA_ART_SIZE_PIXELS, 0)?.let { size ->
234
221
  if (size > 0) {
235
222
  artworkSizeHintPixels = size
@@ -238,13 +225,8 @@ class MediaSessionCallback(private val player: Player) :
238
225
  }
239
226
 
240
227
  if (params?.isRecent == true) {
241
- // TODO: support recent queries through something like onRecent and return a MediaItem with
242
- // .setMediaId("__RECENT__") here - when onRecent is not configured we can keep returning an
243
- // error here:
244
-
245
- // The service currently does not support playback resumption. Tell System UI by returning
246
- // an error of type 'RESULT_ERROR_NOT_SUPPORTED' for a `params.isRecent` request. See
247
- // https://github.com/androidx/media/issues/355
228
+ // Media3 answers System UI's EXTRA_RECENT root itself, through onPlaybackResumption, so this
229
+ // is another browser asking; there is no browsable recents tree.
248
230
  return Futures.immediateFuture(LibraryResult.ofError(SessionError.ERROR_NOT_SUPPORTED))
249
231
  }
250
232
 
@@ -271,120 +253,131 @@ class MediaSessionCallback(private val player: Player) :
271
253
  params: MediaLibraryService.LibraryParams?,
272
254
  ): ListenableFuture<LibraryResult<ImmutableList<MediaItem>>> {
273
255
  Timber.d(
274
- "onGetChildren: {parentId: $parentId, page: $page, pageSize: $pageSize, isSearchPath: ${BrowserPathHelper.isSpecialPath(parentId)} }"
256
+ "onGetChildren: {parentId: $parentId, page: $page, pageSize: $pageSize, isSpecialPath: ${BrowserPathHelper.isSpecialPath(parentId)} }"
275
257
  )
276
258
  return scope.future {
277
- // Wait for browser to be registered if it's not available yet
278
- val audioBrowser =
279
- player.awaitBrowser().also { Timber.d("Browser ready, proceeding with onGetChildren") }
280
- val browserManager = audioBrowser.browserManager
281
-
282
- // While a gate is active, tabs stay visible (the root keeps serving them below) but each
283
- // non-root level is resolved per request: a gated path — including re-queries of the gate
284
- // tile's own sentinel path — serves the single gate tile, so drilling into it re-shows the
285
- // message instead of dead-ending in "No items"; an allowed path falls through to real
286
- // children. Checked before the offline guard: gated content isn't coming back with
287
- // connectivity, so the gate copy is the truer message.
288
- if (parentId != BrowserPathHelper.ROOT_PATH) {
289
- val outcome =
290
- audioBrowser.gateDecision(
291
- NativeGateRequest(reason = GateReason.BROWSE, path = parentId, search = null)
292
- )
293
- if (outcome.gated) {
294
- audioBrowser.onGate(GateEvent(GateReason.BROWSE))
295
- // gateDecision guarantees non-null chrome on a gated decision (override → default →
296
- // built-in).
297
- return@future LibraryResult.ofItemList(
298
- ImmutableList.of(createGateMediaItem(outcome.chrome!!)),
299
- params,
300
- )
259
+ children(session, browser, parentId, page, pageSize, params).also {
260
+ if (parentId == BrowserPathHelper.ROOT_PATH && page == 0) {
261
+ rootTile = deadEndTileOf(it.value.orEmpty())
301
262
  }
302
263
  }
264
+ }
265
+ }
303
266
 
304
- // The error / offline tiles are dead-ends. Some controllers (e.g. Android Auto when online)
305
- // treat a non-browsable tile as tappable and subscribe to its mediaId anyway; returning the
306
- // error tile again here would push an endless stack of error pages. Return nothing instead.
307
- // For the offline tile, re-send the alert when still offline so a tap surfaces the
308
- // explanation again — but only then, since these paths are also re-queried by
309
- // notifyChildrenChanged (e.g. when connectivity returns) without any user action.
310
- if (parentId == BrowserPathHelper.OFFLINE_PATH || parentId == BrowserPathHelper.ERROR_PATH) {
311
- if (parentId == BrowserPathHelper.OFFLINE_PATH && !player.networkMonitor.isOnline.value) {
312
- sendBrowseError(session, browser, offline = true)
313
- }
314
- return@future LibraryResult.ofItemList(ImmutableList.of<MediaItem>(), params)
267
+ /**
268
+ * The tile the root last served in place of its tabs, or null. Android Automotive OS shows such a
269
+ * root as one tab that drills into the tile's sentinel path (see [deadEndChildren]).
270
+ */
271
+ @Volatile private var rootTile: MediaItem? = null
272
+
273
+ private suspend fun children(
274
+ session: MediaLibraryService.MediaLibrarySession,
275
+ browser: MediaSession.ControllerInfo,
276
+ parentId: String,
277
+ page: Int,
278
+ pageSize: Int,
279
+ params: MediaLibraryService.LibraryParams?,
280
+ ): LibraryResult<ImmutableList<MediaItem>> {
281
+ val audioBrowser =
282
+ player.awaitBrowser().also { Timber.d("Browser ready, proceeding with onGetChildren") }
283
+ val browserManager = audioBrowser.browserManager
284
+
285
+ // While a gate is active the root keeps its tabs; a gated level, the gate tile's own sentinel
286
+ // included, serves the gate tile, so drilling into it re-shows the message, and an allowed one
287
+ // falls through. No SessionError: a gate is app state, not a failure. Before the offline
288
+ // guard: connectivity does not ungate content.
289
+ if (parentId != BrowserPathHelper.ROOT_PATH) {
290
+ val outcome =
291
+ audioBrowser.gateDecision(
292
+ NativeGateRequest(reason = GateReason.BROWSE, path = parentId, search = null)
293
+ )
294
+ if (outcome.gated) {
295
+ audioBrowser.onGate(GateEvent(GateReason.BROWSE))
296
+ // gateDecision always sets chrome on a gated outcome.
297
+ return LibraryResult.ofItemList(
298
+ ImmutableList.of(createGateMediaItem(outcome.chrome!!)),
299
+ params,
300
+ )
315
301
  }
302
+ }
316
303
 
317
- // Show offline error when offline:
318
- if (
319
- !player.networkMonitor.isOnline.value && browserManager.config.androidControllerOfflineError
320
- ) {
321
- Timber.w("Network offline - returning error message for: $parentId")
304
+ // A tap on the offline tile re-sends the alert, but only while still offline:
305
+ // notifyChildrenChanged re-queries these paths with no user action, e.g. when connectivity
306
+ // returns.
307
+ if (BrowserPathHelper.isDeadEndPath(parentId)) {
308
+ val offline = !player.networkMonitor.isOnline.value
309
+ if (parentId == BrowserPathHelper.OFFLINE_PATH && offline) {
322
310
  sendBrowseError(session, browser, offline = true)
323
- return@future LibraryResult.ofItemList(ImmutableList.of(createOfflineMediaItem()), params)
324
311
  }
312
+ return LibraryResult.ofItemList(
313
+ deadEndChildren(parentId, rootTile, Automotive.device, offline),
314
+ params,
315
+ )
316
+ }
325
317
 
326
- try {
327
- val children =
328
- if (parentId == BrowserPathHelper.RECENT_PATH) {
329
- // TODO: implement recent media items
330
- emptyList<MediaItem>()
331
- } else if (parentId == BrowserPathHelper.ROOT_PATH) {
332
- // Return tabs as root children (limited to 4 for automotive platform compatibility)
333
- // TODO: Check what Android Auto does with empty tabs list - may need to return error?
334
- val tabs = browserManager.queryTabs()
335
- if (tabs.size > 4) {
336
- Timber.w(
337
- "Root has ${tabs.size} tabs; dropping ${tabs.size - 4} (Android Auto root limit)"
338
- )
339
- }
340
- toMediaItems(tabs.take(4))
341
- } else {
342
- // Resolve the specific path and get its children
343
- val resolvedTrack = browserManager.resolve(parentId)
344
-
345
- // Convert children to MediaItems (url is already set to contextual URL)
346
- val trackChildren =
347
- resolvedTrack.children
348
- ?: throw IllegalStateException(
349
- "Expected browsed ResolvedTrack to have a children array"
350
- )
351
- toMediaItems(trackChildren.toList())
318
+ if (
319
+ !player.networkMonitor.isOnline.value && browserManager.config.androidControllerOfflineError
320
+ ) {
321
+ Timber.w("Network offline - returning error message for: $parentId")
322
+ sendBrowseError(session, browser, offline = true)
323
+ return LibraryResult.ofItemList(
324
+ ImmutableList.of(
325
+ createOfflineMediaItem(audioBrowser.resolveFormattedError(offlineError(), parentId))
326
+ ),
327
+ params,
328
+ )
329
+ }
330
+
331
+ return try {
332
+ val children =
333
+ if (parentId == BrowserPathHelper.ROOT_PATH) {
334
+ // Filtered before the four-tab cap so a disabled tab never costs an available one its
335
+ // slot.
336
+ val tabs = browserManager.queryTabs().filterNot { it.disabled == true }
337
+ if (tabs.size > 4) {
338
+ Timber.w(
339
+ "Root has ${tabs.size} tabs; dropping ${tabs.size - 4} (Android Auto root limit)"
340
+ )
352
341
  }
342
+ toFlatMediaItems(tabs.take(4))
343
+ } else {
344
+ val resolvedTrack = browserManager.resolve(parentId)
345
+ // Section styles arrive page-folded (ADR 0011).
346
+ val sections =
347
+ resolvedTrack.styleResolvedSections()
348
+ ?: throw IllegalStateException("Expected browsed ResolvedTrack to have sections")
349
+ browserManager.warnIfGridPageLacksPromise(parentId, sections)
350
+ // An empty page resolved fine, so no SessionError: these paths are re-queried by
351
+ // notifyChildrenChanged without user action.
352
+ browseLevelItems(toMediaItems(sections)) {
353
+ audioBrowser.resolveFormattedError(emptyContentError(), parentId)
354
+ }
355
+ }
353
356
 
354
- LibraryResult.ofItemList(ImmutableList.copyOf(children.paginate(page, pageSize)), params)
355
- } catch (e: Exception) {
356
- // A cancelled browse (controller disconnected) is not a failure — don't render it as an
357
- // error tile. awaitBrowser's TimeoutCancellationException IS a real failure, keep that.
358
- if (e is CancellationException && e !is TimeoutCancellationException) throw e
359
- Timber.e(e, "Error getting children for parentId: $parentId")
360
- // Surface an error tile instead of a bare ofError(): Media3 drops the error message on the
361
- // legacy browse bridge, which would otherwise leave an empty "No items" screen in Android
362
- // Auto. See https://github.com/androidx/media/issues/2901
363
- //
364
- // Verified on a head unit (2026-06): the AA browse list NEVER renders error text — not for
365
- // transient sendError, sticky non-fatal replication, or fatal replication
366
- // (setLibraryErrorReplicationMode). Fatal replication does show the message on the
367
- // playback screen, but presents the session as STATE_ERROR with no actions, hiding the
368
- // now-playing item and transport controls — not worth it. Tiles remain the only in-browse
369
- // signal we control.
370
- sendBrowseError(session, browser, offline = false)
371
- LibraryResult.ofItemList(ImmutableList.of(createBrowseErrorMediaItem()), params)
372
- }
357
+ LibraryResult.ofItemList(ImmutableList.copyOf(children.paginate(page, pageSize)), params)
358
+ } catch (e: Exception) {
359
+ // A cancelled browse (the controller left) is not a failure; awaitBrowser's timeout is.
360
+ if (e is CancellationException && e !is TimeoutCancellationException) throw e
361
+ Timber.e(e, "Error getting children for parentId: $parentId")
362
+ // A tile, not ofError(): see createErrorMediaItem and
363
+ // https://github.com/androidx/media/issues/2901
364
+ sendBrowseError(session, browser, offline = false)
365
+ LibraryResult.ofItemList(
366
+ ImmutableList.of(
367
+ createBrowseErrorMediaItem(
368
+ audioBrowser.resolveFormattedError(navigationErrorFor(e), parentId)
369
+ )
370
+ ),
371
+ params,
372
+ )
373
373
  }
374
374
  }
375
375
 
376
376
  /**
377
- * Sends a non-fatal [SessionError] to the controller whose browse failed, complementing the error
378
- * tile. Media3 browsers receive it via MediaController.Listener.onError; for legacy controllers
379
- * Media3 transiently attaches the error code/message to the platform session's playback state
380
- * without entering STATE_ERROR.
381
- *
382
- * NOTE: current Android Auto renders NOTHING for this (verified on a head unit — see
383
- * androidx/media#2901; the transient state is cleared microseconds after being set). It is kept
384
- * because it is the correct Media3-API error signal, costs nothing, and becomes user-visible if
385
- * Android Auto moves to consuming SessionError via the Media3 controller API.
386
- *
387
- * Dispatched to the main thread: the session and its legacy stub are application-thread bound.
377
+ * Sends [browser] a non-fatal [SessionError] alongside the error tile. Current Android Auto
378
+ * renders nothing for it (https://github.com/androidx/media/issues/2901); it is the correct
379
+ * Media3 signal and shows if Android Auto starts reading it. Dispatched to Main: the session and
380
+ * its legacy stub are application-thread bound.
388
381
  */
389
382
  @androidx.annotation.OptIn(androidx.media3.common.util.UnstableApi::class)
390
383
  private fun sendBrowseError(
@@ -402,19 +395,37 @@ class MediaSessionCallback(private val player: Player) :
402
395
  }
403
396
 
404
397
  /**
405
- * Converts tracks to MediaItems for browse delivery, routing http(s) artwork through the
406
- * content:// provider so Android Auto can load it via the ArtworkContentProvider. Image-row
407
- * tracks (a CarPlay-only rendering) are expanded into their items as regular grouped rows first —
408
- * see [TrackFactory.expandImageRows].
398
+ * Flattens sections to browse items (ADR 0010): the MediaBrowser protocol has no section node, so
399
+ * each item carries its section's title and style hints. A section with a `path` gains a "view
400
+ * more" row at every `display`: no Android Auto header is tappable, so it is the only way to the
401
+ * whole section.
409
402
  */
410
- private fun toMediaItems(tracks: List<Track>): List<MediaItem> {
403
+ private suspend fun toMediaItems(sections: List<Section>): List<MediaItem> {
411
404
  val registry = player.browseArtworkRegistry
412
405
  val authority = com.audiobrowser.util.ArtworkUris.authorityFor(player.context.packageName)
413
- return TrackFactory.expandImageRows(tracks).map {
414
- TrackFactory.toBrowseMediaItem(it, registry, authority)
406
+ return sections.flatMap { section ->
407
+ // Android Auto has no disabled affordance, so a disabled track hides.
408
+ val children = section.children.filter { it.disabled != true }
409
+ val items = children.map { TrackFactory.toBrowseMediaItem(it, registry, authority, section) }
410
+ // A lone "view more" row under a header is a dead end.
411
+ if (section.path == null || children.isEmpty()) return@flatMap items
412
+ // Free after the first row: the browser is already up, and viewMoreTitle is memoized per
413
+ // content generation.
414
+ val title = player.awaitBrowser().browserManager.viewMoreTitle()
415
+ items +
416
+ TrackFactory.toBrowseMediaItem(
417
+ TrackFactory.navigationTrack(section, title),
418
+ registry,
419
+ authority,
420
+ section,
421
+ )
415
422
  }
416
423
  }
417
424
 
425
+ // One untitled section, so a single Track→MediaItem conversion exists.
426
+ private suspend fun toFlatMediaItems(tracks: List<Track>): List<MediaItem> =
427
+ toMediaItems(listOf(untitledSection(tracks.toTypedArray())))
428
+
418
429
  override fun onGetItem(
419
430
  session: MediaLibraryService.MediaLibrarySession,
420
431
  browser: MediaSession.ControllerInfo,
@@ -422,21 +433,53 @@ class MediaSessionCallback(private val player: Player) :
422
433
  ): ListenableFuture<LibraryResult<MediaItem>> {
423
434
  Timber.Forest.d("onGetItem: ${browser.packageName}, mediaId = $mediaId")
424
435
  return scope.future {
425
- // Handle special paths first (these don't need browser)
436
+ if (mediaId == BrowserPathHelper.ROOT_PATH) {
437
+ return@future LibraryResult.ofItem(
438
+ MediaItem.Builder()
439
+ .setMediaId(mediaId)
440
+ .setMediaMetadata(
441
+ MediaMetadata.Builder().setIsBrowsable(true).setIsPlayable(false).build()
442
+ )
443
+ .build(),
444
+ null,
445
+ )
446
+ }
447
+
426
448
  if (mediaId == BrowserPathHelper.OFFLINE_PATH) {
427
- return@future LibraryResult.ofItem(createOfflineMediaItem(), null)
449
+ return@future LibraryResult.ofItem(
450
+ createOfflineMediaItem(
451
+ player
452
+ .awaitBrowser()
453
+ .resolveFormattedError(offlineError(), BrowserPathHelper.OFFLINE_PATH)
454
+ ),
455
+ null,
456
+ )
428
457
  }
429
458
 
430
- // Return the error tile as a non-browsable item so tapping it can't re-browse into a
431
- // failing path (which would push another error page onto the stack).
432
459
  if (mediaId == BrowserPathHelper.ERROR_PATH) {
433
- return@future LibraryResult.ofItem(createBrowseErrorMediaItem(), null)
460
+ return@future LibraryResult.ofItem(
461
+ createBrowseErrorMediaItem(
462
+ player
463
+ .awaitBrowser()
464
+ .resolveFormattedError(browseFailureError(), BrowserPathHelper.ERROR_PATH)
465
+ ),
466
+ null,
467
+ )
434
468
  }
435
469
 
470
+ if (mediaId == BrowserPathHelper.EMPTY_PATH) {
471
+ return@future LibraryResult.ofItem(
472
+ createEmptyMediaItem(
473
+ player
474
+ .awaitBrowser()
475
+ .resolveFormattedError(emptyContentError(), BrowserPathHelper.EMPTY_PATH)
476
+ ),
477
+ null,
478
+ )
479
+ }
480
+
481
+ // No onGate: it fires where a browse or search is served, not on an item lookup.
436
482
  if (mediaId == BrowserPathHelper.GATE_PATH) {
437
- // A direct fetch of the gate tile's own sentinel (a controller re-reading the item it was
438
- // served). Resolve the chrome for the gate path but do NOT emit onGate — that fires at the
439
- // browse/search serve sites, not on an item lookup.
440
483
  val outcome =
441
484
  player
442
485
  .awaitBrowser()
@@ -451,24 +494,10 @@ class MediaSessionCallback(private val player: Player) :
451
494
  return@future LibraryResult.ofItem(createGateMediaItem(outcome.chrome!!), null)
452
495
  }
453
496
 
454
- if (mediaId == BrowserPathHelper.ROOT_PATH || mediaId == BrowserPathHelper.RECENT_PATH) {
455
- return@future LibraryResult.ofItem(
456
- MediaItem.Builder()
457
- .setMediaId(mediaId)
458
- .setMediaMetadata(
459
- MediaMetadata.Builder().setIsBrowsable(true).setIsPlayable(false).build()
460
- )
461
- .build(),
462
- null,
463
- )
464
- }
465
-
466
- // Wait for browser to be registered if it's not available yet
467
497
  val browserManager = player.awaitBrowser().browserManager
468
498
 
469
- // Serve tracks from the track cache first (keyed by url and src). Besides avoiding an HTTP
470
- // resolve, this keeps item identity correct for contextual mediaIds: resolve() strips
471
- // __trackId and would return the *parent container's* metadata as the item.
499
+ // Cache first: resolve() strips __trackId from a contextual mediaId and would answer with the
500
+ // parent container's metadata.
472
501
  val browseAuthority =
473
502
  com.audiobrowser.util.ArtworkUris.authorityFor(player.context.packageName)
474
503
  browserManager.getCachedTrack(mediaId)?.let { track ->
@@ -480,9 +509,8 @@ class MediaSessionCallback(private val player: Player) :
480
509
 
481
510
  try {
482
511
  val resolvedTrack = browserManager.resolve(mediaId)
483
- // Through the one Track conversion, so the resolve path renders identically
484
- // to the cached-track path above (list line from subtitle, favorited heart)
485
- // and the item's tag is a Track, as fromMedia3 expects.
512
+ // The same conversion as the cached path, so the item's tag is a Track, as fromMedia3
513
+ // expects.
486
514
  LibraryResult.ofItem(
487
515
  TrackFactory.toBrowseMediaItem(
488
516
  resolvedTrack.toTrack(),
@@ -509,11 +537,9 @@ class MediaSessionCallback(private val player: Player) :
509
537
 
510
538
  synchronized(this) { parentIdSubscriptions.getOrPut(parentId) { mutableSetOf() }.add(browser) }
511
539
 
512
- // Don't call super: Media3's default onSubscribe validates the parent by calling
513
- // onGetItem(parentId), which for us is a full resolve() — an HTTP fetch whose result the
514
- // legacy stub discards for Android Auto controllers. onGetChildren already surfaces browse
515
- // failures. Keep the default's other behavior: notify Media3 (non-legacy) browsers so they
516
- // fetch the children; legacy browsers get onLoadChildren from the framework after subscribing.
540
+ // Not super: its onSubscribe validates the parent through onGetItem, a full resolve whose
541
+ // result the legacy stub discards. Kept from it: Media3 browsers are told to fetch; legacy
542
+ // browsers get onLoadChildren from the framework.
517
543
  if (browser.controllerVersion != MediaSession.ControllerInfo.LEGACY_CONTROLLER_VERSION) {
518
544
  session.notifyChildrenChanged(browser, parentId, Int.MAX_VALUE, params)
519
545
  }
@@ -537,13 +563,7 @@ class MediaSessionCallback(private val player: Player) :
537
563
  return super.onUnsubscribe(session, browser, parentId)
538
564
  }
539
565
 
540
- /**
541
- * Notifies all subscribed controllers to refresh their content. Called internally when network
542
- * state changes to refresh all subscribed paths.
543
- *
544
- * Safe to call from any thread: snapshots the subscribed paths and dispatches the session calls
545
- * to the main (Media3 application) thread.
546
- */
566
+ /** Safe from any thread. */
547
567
  private fun notifySubscribedChildrenChanged() {
548
568
  val session = mediaLibrarySession ?: return
549
569
  val parentIds = synchronized(this) { parentIdSubscriptions.keys.toList() }
@@ -552,38 +572,24 @@ class MediaSessionCallback(private val player: Player) :
552
572
  }
553
573
  }
554
574
 
555
- /**
556
- * Notifies external controllers that content at the given path has changed. Controllers
557
- * subscribed to this path will refresh their UI. Safe to call from any thread.
558
- *
559
- * @param path The path where content has changed
560
- */
575
+ /** Tells controllers subscribed to [path] to re-query it. Safe from any thread. */
561
576
  fun notifyContentChanged(path: String) {
562
577
  Timber.d("Notifying content changed for path: $path")
563
578
  val session = mediaLibrarySession ?: return
564
579
  scope.launch(Dispatchers.Main) { session.notifyChildrenChanged(path, Int.MAX_VALUE, null) }
565
580
  }
566
581
 
567
- /**
568
- * Notifies all subscribed controllers that content everywhere has changed (e.g. on a locale
569
- * switch) so they re-query their children. Pairs with AudioBrowser.invalidateAllContent(), which
570
- * clears the content cache first.
571
- */
582
+ /** Pairs with AudioBrowser.invalidateAllContent(), which clears the content cache first. */
572
583
  fun invalidateAllContent() {
573
584
  Timber.d("Invalidating all content - notifying all subscribed paths")
574
585
  notifySubscribedChildrenChanged()
575
586
  }
576
587
 
577
- /**
578
- * Called when the browser becomes available after a cold start. Notifies all subscribed
579
- * controllers to refresh their content.
580
- */
581
588
  fun notifyBrowserReady() {
582
589
  Timber.d("Browser ready - notifying all subscribed paths")
583
590
  notifySubscribedChildrenChanged()
584
591
  }
585
592
 
586
- /** Cancels in-flight browse/search work. Call when the owning player is destroyed. */
587
593
  fun destroy() {
588
594
  scope.cancel()
589
595
  }
@@ -596,8 +602,6 @@ class MediaSessionCallback(private val player: Player) :
596
602
  ): ListenableFuture<LibraryResult<Void>> {
597
603
  Timber.d("onSearch: ${browser.packageName}, query = $query")
598
604
  return scope.future {
599
- // Wait for browser registration like onGetChildren does, so a cold-start voice search
600
- // doesn't fail before JS has configured the browser.
601
605
  val audioBrowser =
602
606
  try {
603
607
  player.awaitBrowser()
@@ -607,40 +611,89 @@ class MediaSessionCallback(private val player: Player) :
607
611
  }
608
612
  val browserManager = audioBrowser.browserManager
609
613
 
610
- // External-surface search is gated with the rest of the browse tree — otherwise search is
611
- // a way around the gate. One "result": the gate tile (see onGetSearchResult).
612
614
  val searchOutcome =
613
615
  audioBrowser.gateDecision(
614
616
  NativeGateRequest(reason = GateReason.SEARCH, path = null, search = searchParams(query))
615
617
  )
618
+ // Search is gated with the browse tree, or it would route around the gate. One result: the
619
+ // gate tile (see onGetSearchResult).
616
620
  if (searchOutcome.gated) {
617
621
  audioBrowser.onGate(GateEvent(GateReason.SEARCH))
618
622
  session.notifySearchResultChanged(browser, query, 1, params)
619
623
  return@future LibraryResult.ofVoid()
620
624
  }
621
625
 
622
- // Check if search is configured
626
+ // Before announceSearch's offline branch: no search source is not-supported, online or not.
623
627
  if (!browserManager.config.hasSearch) {
624
628
  Timber.w("Search requested but no search source configured")
625
629
  return@future LibraryResult.ofError(SessionError.ERROR_NOT_SUPPORTED)
626
630
  }
627
631
 
628
- try {
629
- // Execute search (automatically caches results at /__search?q=query)
630
- val searchResults = browserManager.search(query)
631
- val resultCount = searchResults.children?.size ?: 0
632
-
633
- Timber.d("Search completed: $resultCount results for query '$query'")
632
+ announceSearch(session, browser, browserManager, query, params)
633
+ LibraryResult.ofVoid()
634
+ }
635
+ }
634
636
 
635
- // Notify Media3 of search results
636
- session.notifySearchResultChanged(browser, query, resultCount, params)
637
+ /**
638
+ * Tells [browser] how many items [onGetSearchResult] will serve for [query]: its hits, or the one
639
+ * tile standing in for them, since a controller told zero never asks. Offline keeps the query for
640
+ * [reannounceOfflineSearches]; any other outcome drops it.
641
+ */
642
+ private suspend fun announceSearch(
643
+ session: MediaLibraryService.MediaLibrarySession,
644
+ browser: MediaSession.ControllerInfo,
645
+ browserManager: BrowserManager,
646
+ query: String,
647
+ params: MediaLibraryService.LibraryParams?,
648
+ ) {
649
+ if (
650
+ !player.networkMonitor.isOnline.value && browserManager.config.androidControllerOfflineError
651
+ ) {
652
+ Timber.w("Network offline - announcing the offline tile for query: $query")
653
+ offlineSearches.record(browser, query, params)
654
+ session.notifySearchResultChanged(browser, query, 1, params)
655
+ return
656
+ }
657
+ offlineSearches.forget(browser)
658
+
659
+ try {
660
+ // Caches the results under the query, for getCachedSearchResults.
661
+ val searchResults = browserManager.search(query)
662
+ failedSearch.clear()
663
+ val resultCount = announcedSearchCount(searchResults.normalizedSections)
664
+
665
+ Timber.d("Search announced $resultCount item(s) for query '$query'")
666
+
667
+ session.notifySearchResultChanged(browser, query, resultCount, params)
668
+ } catch (e: Exception) {
669
+ if (e is CancellationException && e !is TimeoutCancellationException) throw e
670
+ Timber.e(e, "Error during search for query: $query")
671
+ // Announces the browse-error tile: an ofError renders as nothing, and without the slot the
672
+ // failure reads as "no results" by the time onGetSearchResult arrives.
673
+ failedSearch.record(query, navigationErrorFor(e))
674
+ session.notifySearchResultChanged(browser, query, 1, params)
675
+ }
676
+ }
637
677
 
638
- LibraryResult.ofVoid()
639
- } catch (e: Exception) {
640
- if (e is CancellationException && e !is TimeoutCancellationException) throw e
641
- Timber.e(e, "Error during search for query: $query")
642
- LibraryResult.ofError(SessionError.ERROR_UNKNOWN)
678
+ /**
679
+ * Re-runs each search served the offline tile, so the announced count matches what
680
+ * [onGetSearchResult] then serves from the cache this fills.
681
+ */
682
+ private suspend fun reannounceOfflineSearches() {
683
+ val pending = offlineSearches.drain()
684
+ if (pending.isEmpty()) return
685
+ val session = mediaLibrarySession ?: return
686
+ val browserManager =
687
+ try {
688
+ player.awaitBrowser().browserManager
689
+ } catch (e: TimeoutCancellationException) {
690
+ Timber.w("Timed out waiting for browser - offline searches not re-announced")
691
+ return
643
692
  }
693
+
694
+ pending.forEach { search ->
695
+ Timber.d("Network back - re-running search: ${search.query}")
696
+ announceSearch(session, search.browser, browserManager, search.query, search.params)
644
697
  }
645
698
  }
646
699
 
@@ -665,11 +718,11 @@ class MediaSessionCallback(private val player: Player) :
665
718
  }
666
719
  val browserManager = audioBrowser.browserManager
667
720
 
668
- // Gated: the single search "result" is the gate tile (paired with onSearch's count of 1).
669
721
  val searchOutcome =
670
722
  audioBrowser.gateDecision(
671
723
  NativeGateRequest(reason = GateReason.SEARCH, path = null, search = searchParams(query))
672
724
  )
725
+ // The one result onSearch announced for a gated search.
673
726
  if (searchOutcome.gated) {
674
727
  audioBrowser.onGate(GateEvent(GateReason.SEARCH))
675
728
  return@future LibraryResult.ofItemList(
@@ -678,26 +731,55 @@ class MediaSessionCallback(private val player: Player) :
678
731
  )
679
732
  }
680
733
 
681
- try {
682
- // Get cached search results from BrowserManager
683
- browserManager.getCachedSearchResults(query)?.let { tracks ->
684
- // Convert to MediaItems
685
- val searchAuthority =
686
- com.audiobrowser.util.ArtworkUris.authorityFor(player.context.packageName)
687
- val mediaItems =
688
- tracks.map { track ->
689
- Timber.d("Search result: ${track.title} (url=${track.url}, src=${track.src})")
690
- TrackFactory.toBrowseMediaItem(track, player.browseArtworkRegistry, searchAuthority)
691
- }
734
+ // Before the failure slot, as in onGetChildren: a search that never reached the network is
735
+ // fixed by connectivity, not a server failure.
736
+ if (
737
+ !player.networkMonitor.isOnline.value && browserManager.config.androidControllerOfflineError
738
+ ) {
739
+ Timber.w("Network offline - returning the offline tile for query: $query")
740
+ sendBrowseError(session, browser, offline = true)
741
+ return@future LibraryResult.ofItemList(
742
+ ImmutableList.of(
743
+ createOfflineMediaItem(
744
+ audioBrowser.resolveFormattedError(
745
+ offlineError(),
746
+ BrowserPathHelper.createSearchPath(query),
747
+ )
748
+ )
749
+ ),
750
+ params,
751
+ )
752
+ }
692
753
 
693
- val paginatedItems = mediaItems.paginate(page, pageSize)
694
- Timber.d("Returning ${paginatedItems.size} search results")
695
- LibraryResult.ofItemList(ImmutableList.copyOf(paginatedItems), params)
696
- }
697
- ?: run {
698
- Timber.w("No cached search results for query: $query")
699
- LibraryResult.ofItemList(ImmutableList.of(), params)
754
+ // The search failed: the same tile and SessionError as a failed browse, not the empty page.
755
+ failedSearch.errorFor(query)?.let { error ->
756
+ sendBrowseError(session, browser, offline = false)
757
+ return@future LibraryResult.ofItemList(
758
+ ImmutableList.of(
759
+ createBrowseErrorMediaItem(
760
+ audioBrowser.resolveFormattedError(error, BrowserPathHelper.createSearchPath(query))
761
+ )
762
+ ),
763
+ params,
764
+ )
765
+ }
766
+
767
+ try {
768
+ val tracks = browserManager.getCachedSearchResults(query)
769
+ if (tracks == null) Timber.w("No cached search results for query: $query")
770
+ // No hits, all disabled, or nothing cached: the app's empty copy (ADR 0001). Something must
771
+ // come back: onSearch announced at least one item.
772
+ val mediaItems =
773
+ browseLevelItems(toFlatMediaItems(tracks?.toList().orEmpty())) {
774
+ audioBrowser.resolveFormattedError(
775
+ emptyContentError(),
776
+ BrowserPathHelper.createSearchPath(query),
777
+ )
700
778
  }
779
+
780
+ val paginatedItems = mediaItems.paginate(page, pageSize)
781
+ Timber.d("Returning ${paginatedItems.size} search results")
782
+ LibraryResult.ofItemList(ImmutableList.copyOf(paginatedItems), params)
701
783
  } catch (e: Exception) {
702
784
  if (e is CancellationException && e !is TimeoutCancellationException) throw e
703
785
  Timber.e(e, "Error getting search results for query: $query")
@@ -726,8 +808,8 @@ class MediaSessionCallback(private val player: Player) :
726
808
  return scope.future {
727
809
  val audioBrowser = player.awaitBrowser()
728
810
 
729
- // Helper: returns the current player state unchanged so Media3 doesn't modify playback.
730
- // ExoPlayer is main-thread confined; this future runs on IO, so hop to Main for the reads.
811
+ // Returning the current state unchanged is how handleTrackLoad tells Media3 to do nothing.
812
+ // Reads hop to Main: ExoPlayer is main-thread confined and this runs on IO.
731
813
  suspend fun currentPlayerState(): MediaSession.MediaItemsWithStartPosition =
732
814
  withContext(Dispatchers.Main) {
733
815
  val currentItems = player.tracks.map { TrackFactory.toMedia3(it) }
@@ -737,26 +819,22 @@ class MediaSessionCallback(private val player: Player) :
737
819
 
738
820
  val browserManager = audioBrowser.browserManager
739
821
 
740
- // A single tapped item resolves to the contextual url of the list it was
741
- // tapped in: directly for contextual mediaIds, via the track cache for
742
- // stable-id mediaIds (see BrowserManager.contextualUrlFor). A search
743
- // selection is not a list tap — its queue comes from the search results
744
- // (resolveMediaItemsForPlayback), never from a browsed container.
745
- val singleContextualUrl =
822
+ // A single tapped item resolves to the contextual path of the list it was tapped in. A search
823
+ // pick is not a list tap: its queue comes from the search results.
824
+ val singleContextualPath =
746
825
  mediaItems
747
826
  .singleOrNull()
748
827
  ?.takeIf { it.requestMetadata.searchQuery == null }
749
- ?.let { browserManager.contextualUrlFor(it.mediaId) }
828
+ ?.let { browserManager.contextualPathFor(it.mediaId) }
750
829
 
751
- // Check if this is a single item from the current queue source
752
- if (singleContextualUrl != null) {
753
- val parentPath = BrowserPathHelper.stripTrackId(singleContextualUrl)
754
- val trackId = BrowserPathHelper.extractTrackId(singleContextualUrl)
830
+ if (singleContextualPath != null) {
831
+ val parentPath = BrowserPathHelper.stripTrackId(singleContextualPath)
832
+ val trackId = BrowserPathHelper.extractTrackId(singleContextualPath)
755
833
 
756
- // Check if queue already came from this parent path - just skip to the track
834
+ // A tap within the queue's own source list skips rather than rebuilds.
757
835
  if (trackId != null && parentPath == player.queueSourcePath) {
758
836
  val queueTracks = withContext(Dispatchers.Main) { player.tracks }
759
- val index = queueTracks.indexOfFirst { it.src == trackId }
837
+ val index = queueTracks.indexOfTappedTrack(singleContextualPath, trackId)
760
838
  if (index >= 0) {
761
839
  Timber.d("Queue already from $parentPath, skipping to index $index")
762
840
  val track = queueTracks[index]
@@ -767,7 +845,6 @@ class MediaSessionCallback(private val player: Player) :
767
845
  index.toDouble(),
768
846
  ::currentPlayerState,
769
847
  ) {
770
- // Return the existing queue items with the new start index
771
848
  val existingItems = queueTracks.map { TrackFactory.toMedia3(it) }
772
849
  MediaSession.MediaItemsWithStartPosition(existingItems, index, startPositionMs)
773
850
  }
@@ -788,9 +865,10 @@ class MediaSessionCallback(private val player: Player) :
788
865
  result.startIndex.toDouble(),
789
866
  ::currentPlayerState,
790
867
  ) {
791
- // If this was a contextual URL expansion, track the source path (only for default behavior)
792
- if (singleContextualUrl != null) {
793
- val parentPath = BrowserPathHelper.stripTrackId(singleContextualUrl)
868
+ // Only on handleTrackLoad's default branch: a consumer that handles the load owns the
869
+ // queue.
870
+ if (singleContextualPath != null) {
871
+ val parentPath = BrowserPathHelper.stripTrackId(singleContextualPath)
794
872
  withContext(Dispatchers.Main) { player.queueSourcePath = parentPath }
795
873
  }
796
874
  result
@@ -799,29 +877,41 @@ class MediaSessionCallback(private val player: Player) :
799
877
  }
800
878
 
801
879
  /**
802
- * Handles playback resumption requests from the system (Bluetooth play button, car head unit,
803
- * etc.).
880
+ * Rebuilds the persisted queue for a system request (Bluetooth play, a head unit). With
881
+ * [isForPlayback] false it is the boot-time resumption notification asking: no network, stored
882
+ * track only.
804
883
  *
805
- * Reads the persisted playback state (URL + position + settings) and expands it into a full queue
806
- * using the browse callback. This enables seamless resumption after app restart with the same
807
- * player settings (repeat mode, shuffle, playback speed).
808
- *
809
- * @param mediaSession The media session
810
- * @param controller The controller requesting resumption
811
- * @param isForPlayback True if this should start playback; false if just gathering info for the
812
- * boot-time resumption notification (no network; local metadata only).
813
884
  * @see https://developer.android.com/media/media3/session/background-playback#resumption
814
885
  */
815
886
  override fun onPlaybackResumption(
816
887
  mediaSession: MediaSession,
817
888
  controller: MediaSession.ControllerInfo,
818
889
  isForPlayback: Boolean,
890
+ ): ListenableFuture<MediaSession.MediaItemsWithStartPosition> {
891
+ val resumption = resume(controller, isForPlayback)
892
+ if (isForPlayback) {
893
+ Futures.addCallback(
894
+ resumption,
895
+ object : FutureCallback<MediaSession.MediaItemsWithStartPosition> {
896
+ override fun onSuccess(result: MediaSession.MediaItemsWithStartPosition) {}
897
+
898
+ override fun onFailure(t: Throwable) = player.onPlaybackResumptionFailed()
899
+ },
900
+ ContextCompat.getMainExecutor(player.context),
901
+ )
902
+ }
903
+ return resumption
904
+ }
905
+
906
+ private fun resume(
907
+ controller: MediaSession.ControllerInfo,
908
+ isForPlayback: Boolean,
819
909
  ): ListenableFuture<MediaSession.MediaItemsWithStartPosition> {
820
910
  Timber.d("${controller.packageName}")
821
911
 
822
912
  return scope.future {
823
- // A pure read first: restore()'s side effects (it applies repeat/shuffle/speed to the
824
- // live player, emitting option-changed events to JS) belong to actual resumption only.
913
+ // A pure read: restore() applies repeat/shuffle/speed to the live player and emits events to
914
+ // JS, so it waits for actual resumption.
825
915
  val state =
826
916
  player.playbackStateStore.get()
827
917
  ?: run {
@@ -829,9 +919,14 @@ class MediaSessionCallback(private val player: Player) :
829
919
  throw IllegalStateException("No playback state to resume")
830
920
  }
831
921
 
832
- // isForPlayback == false is the device-boot-time notification case: network may be
833
- // unavailable and we must not start playback. Return just the locally-stored track with its
834
- // already-local metadata; skip the settings restore and network queue expansion below.
922
+ // A track disabled since it was saved never plays; failing the future refuses it without
923
+ // touching the player.
924
+ if (state.track.disabled == true) {
925
+ Timber.w("Refusing resumption of disabled track: ${state.track.title}")
926
+ throw IllegalStateException("Persisted track is disabled")
927
+ }
928
+
929
+ // Before the restore and the expansion: both touch the live player or the network.
835
930
  if (!isForPlayback) {
836
931
  Timber.d("Info-gathering resumption (boot-time); returning stored track without expansion")
837
932
  return@future MediaSession.MediaItemsWithStartPosition(
@@ -841,17 +936,14 @@ class MediaSessionCallback(private val player: Player) :
841
936
  )
842
937
  }
843
938
 
844
- // restore() sets player properties which must happen on main thread
845
939
  withContext(Dispatchers.Main) { player.playbackStateStore.restore() }
846
940
 
847
- val url = state.track.url
848
- Timber.d("Resuming from url=$url, positionMs=${state.positionMs}")
941
+ val path = state.track.path
942
+ Timber.d("Resuming from path=$path, positionMs=${state.positionMs}")
849
943
 
850
- // Wait for browser to be available (JS needs to have configured it)
851
944
  val browserManager = player.awaitBrowser().browserManager
852
945
 
853
- // Try to expand the URL into a full queue
854
- val expanded = url?.let { browserManager.expandQueueFromContextualUrl(it) }
946
+ val expanded = path?.let { browserManager.expandQueueFromContextualPath(it) }
855
947
 
856
948
  if (expanded != null) {
857
949
  val (tracks, selectedIndex) = expanded
@@ -859,9 +951,8 @@ class MediaSessionCallback(private val player: Player) :
859
951
  "Restored ${tracks.size} tracks, starting at index $selectedIndex at ${state.positionMs}ms"
860
952
  )
861
953
 
862
- // Track the source path if this was a contextual URL expansion
863
- if (BrowserPathHelper.isContextual(url)) {
864
- val parentPath = BrowserPathHelper.stripTrackId(url)
954
+ if (BrowserPathHelper.isContextual(path)) {
955
+ val parentPath = BrowserPathHelper.stripTrackId(path)
865
956
  withContext(Dispatchers.Main) { player.queueSourcePath = parentPath }
866
957
  }
867
958
 
@@ -871,7 +962,6 @@ class MediaSessionCallback(private val player: Player) :
871
962
  state.positionMs,
872
963
  )
873
964
  } else {
874
- // Fallback: play just the stored track
875
965
  Timber.d("Queue expansion failed, using stored track: ${state.track.title}")
876
966
  MediaSession.MediaItemsWithStartPosition(
877
967
  ImmutableList.of(TrackFactory.toMedia3(state.track)),
@@ -882,3 +972,156 @@ class MediaSessionCallback(private val player: Player) :
882
972
  }
883
973
  }
884
974
  }
975
+
976
+ /**
977
+ * What a drill-in on a tile's sentinel path serves. Nothing, so Android Auto, which drills into a
978
+ * tile whatever its flags, dead-ends at "No items" rather than stacking error pages. Android
979
+ * Automotive OS shows a root serving only a tile as one tab that drills in here, and an empty level
980
+ * as "Media isn't available for this list", so there [rootTile] is served again, unless it is the
981
+ * offline tile and the device is back online.
982
+ */
983
+ internal fun deadEndChildren(
984
+ parentId: String,
985
+ rootTile: MediaItem?,
986
+ automotive: Boolean,
987
+ offline: Boolean,
988
+ ): List<MediaItem> =
989
+ listOfNotNull(
990
+ rootTile?.takeIf {
991
+ automotive &&
992
+ it.mediaId == parentId &&
993
+ (parentId != BrowserPathHelper.OFFLINE_PATH || offline)
994
+ }
995
+ )
996
+
997
+ /** The single tile of a level that serves one in place of its items, or null. */
998
+ internal fun deadEndTileOf(items: List<MediaItem>): MediaItem? =
999
+ items.singleOrNull()?.takeIf { BrowserPathHelper.isDeadEndPath(it.mediaId) }
1000
+
1001
+ /**
1002
+ * A non-playable item that stands in for a browse list's items: the only in-browse error signal.
1003
+ * Media3 drops [LibraryResult.ofError] on the legacy browse bridge, leaving "No items", and Android
1004
+ * Auto's browse list shows no text for a transient or replicated [SessionError]. Fatal replication
1005
+ * shows it on the playback screen only by putting the session in STATE_ERROR, which hides
1006
+ * now-playing and transport. https://github.com/androidx/media/issues/2901
1007
+ */
1008
+ internal fun createErrorMediaItem(mediaId: String, title: String, subtitle: String): MediaItem =
1009
+ MediaItem.Builder()
1010
+ .setMediaId(mediaId)
1011
+ .setMediaMetadata(
1012
+ MediaMetadata.Builder()
1013
+ .setTitle(title)
1014
+ .setSubtitle(subtitle)
1015
+ // Android Automotive OS drops an item that is neither browsable nor playable; Android Auto
1016
+ // ignores these flags and drills in anyway (see deadEndChildren).
1017
+ .setIsBrowsable(Automotive.device)
1018
+ .setIsPlayable(false)
1019
+ .build()
1020
+ )
1021
+ .build()
1022
+
1023
+ private fun createErrorMediaItem(mediaId: String, formatted: FormattedNavigationError): MediaItem =
1024
+ createErrorMediaItem(
1025
+ mediaId = mediaId,
1026
+ title = formatted.title,
1027
+ // List rows are single-line.
1028
+ subtitle = formatted.message?.replace('\n', ' ') ?: "",
1029
+ )
1030
+
1031
+ /**
1032
+ * From the app's path-aware empty copy (ADR 0001). No SessionError goes with it: an empty page
1033
+ * resolved fine.
1034
+ */
1035
+ internal fun createEmptyMediaItem(formatted: FormattedNavigationError): MediaItem =
1036
+ createErrorMediaItem(BrowserPathHelper.EMPTY_PATH, formatted)
1037
+
1038
+ /** From the app's copy, so one browse list never mixes the app's locale with the device's. */
1039
+ internal fun createOfflineMediaItem(formatted: FormattedNavigationError): MediaItem =
1040
+ createErrorMediaItem(BrowserPathHelper.OFFLINE_PATH, formatted)
1041
+
1042
+ /**
1043
+ * For a request that failed while online; offline is caught earlier by the networkMonitor guards,
1044
+ * so this must not say "no internet connection".
1045
+ */
1046
+ internal fun createBrowseErrorMediaItem(formatted: FormattedNavigationError): MediaItem =
1047
+ createErrorMediaItem(BrowserPathHelper.ERROR_PATH, formatted)
1048
+
1049
+ /**
1050
+ * A non-root level's or a search's items, or the lone empty tile. [formatted] is a JS hop, run only
1051
+ * when there are none. The root is not served through here.
1052
+ */
1053
+ internal suspend fun browseLevelItems(
1054
+ children: List<MediaItem>,
1055
+ formatted: suspend () -> FormattedNavigationError,
1056
+ ): List<MediaItem> = children.ifEmpty { listOf(createEmptyMediaItem(formatted())) }
1057
+
1058
+ /** No message of its own: the path carries the copy. */
1059
+ internal fun emptyContentError(): NavigationError =
1060
+ NavigationError(NavigationErrorType.EMPTY_CONTENT, "", null, null)
1061
+
1062
+ internal fun offlineError(): NavigationError =
1063
+ NavigationError(NavigationErrorType.NETWORK_ERROR, "", null, null)
1064
+
1065
+ /** What a re-read of the browse-error tile formats under: its exception is gone. */
1066
+ internal fun browseFailureError(): NavigationError =
1067
+ NavigationError(NavigationErrorType.UNKNOWN_ERROR, "", null, null)
1068
+
1069
+ /**
1070
+ * Disabled tracks hide, so they do not count. Never zero: a controller told zero never asks for
1071
+ * items, and the empty tile [MediaSessionCallback.onGetSearchResult] serves stands in.
1072
+ */
1073
+ internal fun announcedSearchCount(sections: List<Section>?): Int =
1074
+ (sections?.sumOf { section -> section.children.count { it.disabled != true } } ?: 0)
1075
+ .coerceAtLeast(1)
1076
+
1077
+ /**
1078
+ * The search each controller was last served the offline tile for. Media3 keeps no record of a
1079
+ * search and it has no subscription, so without this the offline tile stays until the user searches
1080
+ * again. Written from the IO scope and read from the connectivity observer.
1081
+ */
1082
+ internal class OfflineSearchRegistry {
1083
+ private val searches = mutableMapOf<MediaSession.ControllerInfo, OfflineSearch>()
1084
+
1085
+ @Synchronized
1086
+ fun record(
1087
+ browser: MediaSession.ControllerInfo,
1088
+ query: String,
1089
+ params: MediaLibraryService.LibraryParams?,
1090
+ ) {
1091
+ searches[browser] = OfflineSearch(browser, query, params)
1092
+ }
1093
+
1094
+ @Synchronized
1095
+ fun forget(browser: MediaSession.ControllerInfo) {
1096
+ searches.remove(browser)
1097
+ }
1098
+
1099
+ /** Takes every record: a re-run that finds the network gone again records its own. */
1100
+ @Synchronized
1101
+ fun drain(): List<OfflineSearch> = searches.values.toList().also { searches.clear() }
1102
+ }
1103
+
1104
+ internal data class OfflineSearch(
1105
+ val browser: MediaSession.ControllerInfo,
1106
+ val query: String,
1107
+ val params: MediaLibraryService.LibraryParams?,
1108
+ )
1109
+
1110
+ /**
1111
+ * The query whose search threw, so [MediaSessionCallback.onGetSearchResult] serves the error tile
1112
+ * rather than the empty one. One slot, like BrowserManager's single-entry result cache: a late
1113
+ * fetch of an earlier failed query serves the empty tile.
1114
+ */
1115
+ internal class FailedSearchSlot {
1116
+ @Volatile private var failed: Pair<String, NavigationError>? = null
1117
+
1118
+ fun record(query: String, error: NavigationError) {
1119
+ failed = query to error
1120
+ }
1121
+
1122
+ fun clear() {
1123
+ failed = null
1124
+ }
1125
+
1126
+ fun errorFor(query: String): NavigationError? = failed?.takeIf { it.first == query }?.second
1127
+ }