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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1223) hide show
  1. package/README.md +66 -39
  2. package/android/build.gradle +58 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +592 -438
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  9. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  10. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  11. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  12. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  13. package/android/src/main/java/com/audiobrowser/Service.kt +75 -82
  14. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  15. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  16. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  17. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +345 -537
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +37 -68
  19. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  20. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  21. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  22. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  23. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -29
  24. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  25. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  26. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +5 -15
  27. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  28. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  29. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  30. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  32. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  33. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +18 -40
  34. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  35. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  36. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  37. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  38. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  39. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  40. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  41. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  42. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  43. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  44. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +23 -34
  45. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  46. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +38 -27
  47. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  48. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  49. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +102 -117
  50. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  51. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +47 -37
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +123 -136
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  54. package/android/src/main/java/com/audiobrowser/player/Player.kt +420 -566
  55. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  56. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -21
  57. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +69 -120
  58. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +51 -122
  59. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  60. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  61. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  62. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  63. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +32 -67
  64. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  65. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  66. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  67. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  68. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +690 -0
  70. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  71. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  72. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  73. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  86. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  87. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  88. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  89. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  90. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  91. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  92. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  93. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  94. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -15
  95. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  96. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  97. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  98. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  99. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  100. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  101. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  102. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  103. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  104. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  105. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  106. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  107. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  108. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  109. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  110. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  111. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  112. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  113. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -82
  114. package/android/src/main/res/values/strings.xml +25 -5
  115. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  116. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  117. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  118. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  119. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  120. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  121. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +286 -0
  122. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -43
  123. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  124. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  125. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  126. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  127. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -23
  128. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +314 -8
  129. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  130. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  131. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -4
  132. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  133. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -55
  134. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  135. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  136. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  137. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  138. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +8 -16
  139. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  140. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  141. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +460 -0
  142. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  143. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  144. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  145. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  146. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  147. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  148. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  149. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  150. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +226 -21
  151. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +2 -26
  152. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +53 -39
  153. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  154. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  155. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  156. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  157. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +48 -0
  158. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  159. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  160. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +353 -0
  161. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +93 -0
  162. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  163. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  164. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +190 -0
  165. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +46 -0
  166. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +34 -72
  167. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -5
  168. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  169. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  170. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  171. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +2 -23
  172. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +285 -0
  173. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  174. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  175. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  176. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +926 -0
  177. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  178. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  179. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  180. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  181. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  182. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  183. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  184. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  185. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  186. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  187. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  188. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  189. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  190. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  191. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  192. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  193. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  194. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  195. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  196. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  197. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  198. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  199. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  200. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  201. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  202. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  203. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  204. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  205. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  206. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  207. package/android/src/test/resources/sonos/device_description.xml +78 -0
  208. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  209. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  210. package/ios/AVPlayerEngine.swift +354 -0
  211. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  212. package/ios/Browser/BrowseGate.swift +57 -0
  213. package/ios/Browser/BrowserConfig.swift +123 -104
  214. package/ios/Browser/BrowserError.swift +15 -0
  215. package/ios/Browser/BrowserManager.swift +153 -675
  216. package/ios/Browser/BrowserPathHelper.swift +54 -117
  217. package/ios/Browser/FavoriteSet.swift +43 -0
  218. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  219. package/ios/Browser/JsonModels.swift +244 -335
  220. package/ios/Browser/NavigationErrorState.swift +42 -0
  221. package/ios/Browser/PageResolver.swift +137 -0
  222. package/ios/Browser/RequestLayer.swift +181 -0
  223. package/ios/Browser/RequestPipeline.swift +293 -0
  224. package/ios/Browser/SearchDrillIn.swift +11 -17
  225. package/ios/Browser/SectionScope.swift +73 -26
  226. package/ios/Browser/SimpleRouter.swift +76 -154
  227. package/ios/Browser/StyleResolver.swift +41 -0
  228. package/ios/Browser/TabBarEntries.swift +8 -7
  229. package/ios/Browser/TrackIdTemplate.swift +29 -0
  230. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  231. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  232. package/ios/CarPlay/CarPlayController.swift +37 -1297
  233. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  234. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  235. package/ios/CarPlay/CarPlayNowPlayingManager.swift +129 -204
  236. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  237. package/ios/CarPlay/CarPlaySession+PageLoader.swift +92 -0
  238. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  239. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  240. package/ios/CarPlay/CarPlaySession.swift +203 -0
  241. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  242. package/ios/CarPlay/IntentHandlers.swift +94 -0
  243. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  244. package/ios/CarPlay/MediaIntentHandler.swift +63 -0
  245. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  246. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  247. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  248. package/ios/CarPlay/SectionPresentation.swift +67 -0
  249. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  250. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  251. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  252. package/ios/Extension/CxxVectorConformances.swift +4 -16
  253. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  254. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  255. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  256. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  257. package/ios/Extension/SearchParams+Query.swift +28 -0
  258. package/ios/Extension/Section+Copying.swift +26 -0
  259. package/ios/Extension/String+IcyCharset.swift +21 -0
  260. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  261. package/ios/Extension/Track+AVPlayer.swift +1 -18
  262. package/ios/Extension/Track+Copying.swift +13 -21
  263. package/ios/Extension/Track+Identity.swift +20 -0
  264. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  265. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  266. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  267. package/ios/Extension/URLError+Connectivity.swift +15 -0
  268. package/ios/Extension/Variant+Artwork.swift +8 -22
  269. package/ios/Http/HttpClient.swift +73 -167
  270. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  271. package/ios/HybridAudioBrowser+Options.swift +116 -0
  272. package/ios/HybridAudioBrowser+Player.swift +337 -0
  273. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  274. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  275. package/ios/HybridAudioBrowser.swift +148 -1688
  276. package/ios/Model/NitroTypeStubs.swift +240 -32
  277. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  278. package/ios/Model/RemoteCommand.swift +6 -60
  279. package/ios/Model/TrackPlayerError.swift +14 -23
  280. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  281. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  282. package/ios/Observer/ItemObserver.swift +92 -0
  283. package/ios/Observer/PlayerObserver.swift +59 -0
  284. package/ios/Option/SessionCategories.swift +42 -92
  285. package/ios/PlaybackEvent.swift +4 -2
  286. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  287. package/ios/Player/AudioSessionController.swift +190 -0
  288. package/ios/Player/DeferredSeek.swift +73 -0
  289. package/ios/Player/EndOfTrackJudgement.swift +6 -13
  290. package/ios/Player/ErrorStatus.swift +52 -0
  291. package/ios/Player/MediaLoader.swift +73 -98
  292. package/ios/Player/NowPlayingLines.swift +49 -0
  293. package/ios/Player/NowPlayingUpdater.swift +175 -105
  294. package/ios/Player/PersistedPlaybackState.swift +1 -2
  295. package/ios/Player/PlaybackFailure.swift +121 -0
  296. package/ios/Player/PlaybackPersistence.swift +72 -0
  297. package/ios/Player/PlaybackStateMachine.swift +11 -11
  298. package/ios/Player/PlaybackTimer.swift +11 -8
  299. package/ios/Player/Player.swift +991 -0
  300. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  301. package/ios/Player/PlayerEngine.swift +105 -0
  302. package/ios/Player/PlayerStatusTypes.swift +1 -6
  303. package/ios/Player/QueueManager.swift +80 -98
  304. package/ios/Player/RetryLoop.swift +274 -0
  305. package/ios/Player/ShuffleOrder.swift +36 -43
  306. package/ios/Player/SleepTimerManager.swift +25 -42
  307. package/ios/Player/VolumeFader.swift +20 -15
  308. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  309. package/ios/RemoteCommand/RemoteCommandController.swift +101 -336
  310. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  311. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  312. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  313. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  314. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  315. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  316. package/ios/Tests/DeferredSeekTests.swift +76 -0
  317. package/ios/Tests/EmitterTests.swift +22 -39
  318. package/ios/Tests/EndOfTrackJudgementTests.swift +1 -6
  319. package/ios/Tests/ErrorStatusTests.swift +50 -0
  320. package/ios/Tests/FavoriteSetTests.swift +61 -0
  321. package/ios/Tests/GenerationMemoTests.swift +121 -0
  322. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  323. package/ios/Tests/JsonModelsTests.swift +189 -3
  324. package/ios/Tests/LRUCacheTests.swift +106 -0
  325. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  326. package/ios/Tests/MediaLoaderTests.swift +38 -78
  327. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  328. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  329. package/ios/Tests/ObserverTests.swift +88 -0
  330. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  331. package/ios/Tests/PlaybackFailureTests.swift +181 -0
  332. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  333. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  334. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  335. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  336. package/ios/Tests/PlayerPolicyTests.swift +547 -0
  337. package/ios/Tests/PlayerTests.swift +1563 -0
  338. package/ios/Tests/PlayingStateTests.swift +41 -0
  339. package/ios/Tests/QueueManagerTests.swift +205 -174
  340. package/ios/Tests/ReadyValueTests.swift +73 -0
  341. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  342. package/ios/Tests/RequestLayerTests.swift +228 -0
  343. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  344. package/ios/Tests/RetryLoopTests.swift +282 -0
  345. package/ios/Tests/SearchDrillInTests.swift +16 -17
  346. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  347. package/ios/Tests/SectionPresentationTests.swift +85 -0
  348. package/ios/Tests/SectionScopeTests.swift +136 -54
  349. package/ios/Tests/SimpleRouterTests.swift +39 -8
  350. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  351. package/ios/Tests/StyleResolverTests.swift +123 -0
  352. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  353. package/ios/Tests/Support/TestTypes.swift +135 -100
  354. package/ios/Tests/TabBarEntriesTests.swift +19 -21
  355. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  356. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  357. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  358. package/ios/Tests/TrackIdentityTests.swift +20 -0
  359. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  360. package/ios/Tests/TrackSelectorTests.swift +157 -34
  361. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  362. package/ios/TrackSelector.swift +62 -77
  363. package/ios/Util/ArtworkFreshness.swift +42 -0
  364. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  365. package/ios/Util/ConcurrentMap.swift +19 -0
  366. package/ios/Util/Emitter.swift +45 -22
  367. package/ios/Util/GenerationMemo.swift +36 -0
  368. package/ios/Util/LRUCache.swift +23 -159
  369. package/ios/Util/NetworkMonitor.swift +31 -33
  370. package/ios/Util/OutputPicker.swift +48 -0
  371. package/ios/Util/ReadyValue.swift +57 -0
  372. package/ios/Util/SFSymbolRenderer.swift +64 -49
  373. package/ios/Util/SVGProcessor.swift +9 -16
  374. package/lib/commonjs/AudioBrowser.js +8 -8
  375. package/lib/commonjs/AudioBrowser.js.map +1 -1
  376. package/lib/commonjs/CLAUDE.md +57 -0
  377. package/lib/commonjs/features/battery.js +16 -12
  378. package/lib/commonjs/features/battery.js.map +1 -1
  379. package/lib/commonjs/features/browser-config.js +13 -9
  380. package/lib/commonjs/features/browser-config.js.map +1 -1
  381. package/lib/commonjs/features/browser.js +78 -20
  382. package/lib/commonjs/features/browser.js.map +1 -1
  383. package/lib/commonjs/features/carConnection.js +3 -4
  384. package/lib/commonjs/features/carConnection.js.map +1 -1
  385. package/lib/commonjs/features/equalizer.js +10 -6
  386. package/lib/commonjs/features/equalizer.js.map +1 -1
  387. package/lib/commonjs/features/errors.js +35 -21
  388. package/lib/commonjs/features/errors.js.map +1 -1
  389. package/lib/commonjs/features/favorites.js +29 -24
  390. package/lib/commonjs/features/favorites.js.map +1 -1
  391. package/lib/commonjs/features/gate.js +28 -7
  392. package/lib/commonjs/features/gate.js.map +1 -1
  393. package/lib/commonjs/features/metadata.js +64 -14
  394. package/lib/commonjs/features/metadata.js.map +1 -1
  395. package/lib/commonjs/features/network.js +6 -2
  396. package/lib/commonjs/features/network.js.map +1 -1
  397. package/lib/commonjs/features/nowPlaying.js +29 -15
  398. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  399. package/lib/commonjs/features/output.js +10 -5
  400. package/lib/commonjs/features/output.js.map +1 -1
  401. package/lib/commonjs/features/playback/controls.js +13 -6
  402. package/lib/commonjs/features/playback/controls.js.map +1 -1
  403. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  404. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  405. package/lib/commonjs/features/playback/playing.js +5 -3
  406. package/lib/commonjs/features/playback/playing.js.map +1 -1
  407. package/lib/commonjs/features/playback/progress.js +13 -6
  408. package/lib/commonjs/features/playback/progress.js.map +1 -1
  409. package/lib/commonjs/features/playback/rate.js +8 -1
  410. package/lib/commonjs/features/playback/rate.js.map +1 -1
  411. package/lib/commonjs/features/playback/state.js +5 -6
  412. package/lib/commonjs/features/playback/state.js.map +1 -1
  413. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -7
  414. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  415. package/lib/commonjs/features/playback/volume.js +6 -5
  416. package/lib/commonjs/features/playback/volume.js.map +1 -1
  417. package/lib/commonjs/features/player/options.js +23 -29
  418. package/lib/commonjs/features/player/options.js.map +1 -1
  419. package/lib/commonjs/features/player/setup.js +41 -41
  420. package/lib/commonjs/features/player/setup.js.map +1 -1
  421. package/lib/commonjs/features/player/validateOptions.js +23 -0
  422. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  423. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  424. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  425. package/lib/commonjs/features/queue/queue.js +58 -23
  426. package/lib/commonjs/features/queue/queue.js.map +1 -1
  427. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  428. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  429. package/lib/commonjs/features/queue/shuffle.js +1 -2
  430. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  431. package/lib/commonjs/features/remoteControls.js +70 -125
  432. package/lib/commonjs/features/remoteControls.js.map +1 -1
  433. package/lib/commonjs/features/sleepTimer.js +24 -7
  434. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  435. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  436. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  437. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -14
  438. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  439. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  440. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  441. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  442. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  443. package/lib/commonjs/utils/useDebug.js +16 -3
  444. package/lib/commonjs/utils/useDebug.js.map +1 -1
  445. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  446. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  447. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  448. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  449. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  450. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  451. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  452. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  453. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  454. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  455. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  456. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  457. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  458. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  459. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  460. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  461. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  462. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  463. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  464. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  465. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  466. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  467. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  468. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  469. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  470. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  471. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  472. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  473. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  474. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  475. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  476. package/lib/commonjs/web/browser/sections.js +89 -0
  477. package/lib/commonjs/web/browser/sections.js.map +1 -0
  478. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  479. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  480. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  481. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  482. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  483. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  484. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  485. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  486. package/lib/module/AudioBrowser.js +2 -1
  487. package/lib/module/AudioBrowser.js.map +1 -1
  488. package/lib/module/CLAUDE.md +57 -0
  489. package/lib/module/features/battery.js +16 -12
  490. package/lib/module/features/battery.js.map +1 -1
  491. package/lib/module/features/browser-config.js +13 -9
  492. package/lib/module/features/browser-config.js.map +1 -1
  493. package/lib/module/features/browser.js +78 -20
  494. package/lib/module/features/browser.js.map +1 -1
  495. package/lib/module/features/carConnection.js +3 -4
  496. package/lib/module/features/carConnection.js.map +1 -1
  497. package/lib/module/features/equalizer.js +10 -6
  498. package/lib/module/features/equalizer.js.map +1 -1
  499. package/lib/module/features/errors.js +35 -21
  500. package/lib/module/features/errors.js.map +1 -1
  501. package/lib/module/features/favorites.js +29 -24
  502. package/lib/module/features/favorites.js.map +1 -1
  503. package/lib/module/features/gate.js +28 -7
  504. package/lib/module/features/gate.js.map +1 -1
  505. package/lib/module/features/metadata.js +62 -14
  506. package/lib/module/features/metadata.js.map +1 -1
  507. package/lib/module/features/network.js +6 -2
  508. package/lib/module/features/network.js.map +1 -1
  509. package/lib/module/features/nowPlaying.js +29 -15
  510. package/lib/module/features/nowPlaying.js.map +1 -1
  511. package/lib/module/features/output.js +10 -5
  512. package/lib/module/features/output.js.map +1 -1
  513. package/lib/module/features/playback/controls.js +13 -6
  514. package/lib/module/features/playback/controls.js.map +1 -1
  515. package/lib/module/features/playback/playWhenReady.js +6 -5
  516. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  517. package/lib/module/features/playback/playing.js +5 -3
  518. package/lib/module/features/playback/playing.js.map +1 -1
  519. package/lib/module/features/playback/progress.js +13 -6
  520. package/lib/module/features/playback/progress.js.map +1 -1
  521. package/lib/module/features/playback/rate.js +8 -1
  522. package/lib/module/features/playback/rate.js.map +1 -1
  523. package/lib/module/features/playback/state.js +5 -6
  524. package/lib/module/features/playback/state.js.map +1 -1
  525. package/lib/module/features/playback/trackPlaybackTime.js +6 -6
  526. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  527. package/lib/module/features/playback/volume.js +6 -5
  528. package/lib/module/features/playback/volume.js.map +1 -1
  529. package/lib/module/features/player/options.js +22 -27
  530. package/lib/module/features/player/options.js.map +1 -1
  531. package/lib/module/features/player/setup.js +40 -40
  532. package/lib/module/features/player/setup.js.map +1 -1
  533. package/lib/module/features/player/validateOptions.js +19 -0
  534. package/lib/module/features/player/validateOptions.js.map +1 -0
  535. package/lib/module/features/queue/activeTrack.js +15 -5
  536. package/lib/module/features/queue/activeTrack.js.map +1 -1
  537. package/lib/module/features/queue/queue.js +58 -23
  538. package/lib/module/features/queue/queue.js.map +1 -1
  539. package/lib/module/features/queue/repeatMode.js +3 -2
  540. package/lib/module/features/queue/repeatMode.js.map +1 -1
  541. package/lib/module/features/queue/shuffle.js +1 -2
  542. package/lib/module/features/queue/shuffle.js.map +1 -1
  543. package/lib/module/features/remoteControls.js +70 -125
  544. package/lib/module/features/remoteControls.js.map +1 -1
  545. package/lib/module/features/sleepTimer.js +25 -8
  546. package/lib/module/features/sleepTimer.js.map +1 -1
  547. package/lib/module/test-utils/reactNativeStub.js +58 -0
  548. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  549. package/lib/module/utils/LazyNativeEmitter.js +25 -14
  550. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  551. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  552. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  553. package/lib/module/utils/getTrackIdentity.js +22 -0
  554. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  555. package/lib/module/utils/useDebug.js +16 -3
  556. package/lib/module/utils/useDebug.js.map +1 -1
  557. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  558. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  559. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  560. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  561. package/lib/module/web/NativeAudioBrowser.js +207 -84
  562. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  563. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  564. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  565. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  566. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  567. package/lib/module/web/TrackPlayer/Player.js +256 -40
  568. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  569. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  570. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  571. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  572. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  573. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  574. package/lib/module/web/browser/BrowserManager.js +175 -100
  575. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  576. package/lib/module/web/browser/FavoriteManager.js +31 -21
  577. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  578. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  579. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  580. package/lib/module/web/browser/SearchManager.js +18 -23
  581. package/lib/module/web/browser/SearchManager.js.map +1 -1
  582. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  583. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  584. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  585. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  586. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  587. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  588. package/lib/module/web/browser/sections.js +83 -0
  589. package/lib/module/web/browser/sections.js.map +1 -0
  590. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  591. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  592. package/lib/module/web/http/followMediaRedirect.js +215 -0
  593. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  594. package/lib/module/web/player/NowPlayingManager.js +4 -3
  595. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  596. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  597. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  598. package/lib/typescript/package.json +1 -0
  599. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  600. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  601. package/lib/typescript/src/features/battery.d.ts +17 -12
  602. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  603. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  604. package/lib/typescript/src/features/browser.d.ts +67 -19
  605. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  606. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  607. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  608. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  609. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  610. package/lib/typescript/src/features/errors.d.ts +37 -22
  611. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  612. package/lib/typescript/src/features/favorites.d.ts +29 -24
  613. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  614. package/lib/typescript/src/features/gate.d.ts +32 -10
  615. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  616. package/lib/typescript/src/features/metadata.d.ts +68 -17
  617. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  618. package/lib/typescript/src/features/network.d.ts +6 -2
  619. package/lib/typescript/src/features/network.d.ts.map +1 -1
  620. package/lib/typescript/src/features/nowPlaying.d.ts +29 -15
  621. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  622. package/lib/typescript/src/features/output.d.ts +10 -5
  623. package/lib/typescript/src/features/output.d.ts.map +1 -1
  624. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  625. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  626. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  627. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  628. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  629. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  630. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  631. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  632. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  633. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  634. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  635. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  636. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  637. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  638. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  639. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  640. package/lib/typescript/src/features/player/options.d.ts +74 -57
  641. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  642. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  643. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  644. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  645. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  646. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  647. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  648. package/lib/typescript/src/features/queue/queue.d.ts +52 -21
  649. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  650. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  651. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  652. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  653. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  654. package/lib/typescript/src/features/remoteControls.d.ts +81 -47
  655. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  656. package/lib/typescript/src/features/sleepTimer.d.ts +16 -8
  657. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  658. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  659. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  660. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  661. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  662. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  663. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  664. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  665. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  666. package/lib/typescript/src/types/browser.d.ts +242 -173
  667. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  668. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -16
  669. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  670. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  671. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  672. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  673. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  674. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  675. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  676. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  677. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  678. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  679. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  680. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  681. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  682. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  683. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  684. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  686. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  687. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  689. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  690. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  691. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  692. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  694. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  695. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  696. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  697. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  698. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  699. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  700. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  701. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  702. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  703. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  704. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  705. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  706. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  707. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  710. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  711. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  712. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  713. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  714. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  717. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  718. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  720. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  721. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  722. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  723. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  724. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  725. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  726. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  727. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  728. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  732. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  735. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  742. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  743. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  749. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  752. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  753. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  755. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  756. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  757. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  762. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  764. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  765. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  770. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  773. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  776. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  777. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  779. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  781. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  782. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  783. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  784. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  785. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  787. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  790. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  793. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  795. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  797. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  802. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  805. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  809. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  810. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  812. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  815. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  816. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  820. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  824. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  825. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  826. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  830. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  832. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  833. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  836. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  838. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  839. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  840. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  841. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  842. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  852. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  858. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  859. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  860. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  861. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  862. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  981. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  982. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  983. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  984. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  985. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  986. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  987. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  988. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  989. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  990. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  991. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  992. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  993. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  994. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  995. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  996. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  997. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  998. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  999. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1000. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1001. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1002. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1003. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1004. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1005. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1006. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1007. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1008. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1009. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1010. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1011. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1012. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1013. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1014. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1015. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1016. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1017. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1018. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1019. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1020. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1021. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1022. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1023. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1024. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1025. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1026. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1027. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1028. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1029. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1030. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1031. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1032. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1033. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1034. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1035. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1036. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1037. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1038. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1039. package/package.json +26 -12
  1040. package/src/AudioBrowser.ts +2 -1
  1041. package/src/CLAUDE.md +57 -0
  1042. package/src/docs-floors.test.ts +71 -0
  1043. package/src/features/battery.test.ts +79 -0
  1044. package/src/features/battery.ts +17 -13
  1045. package/src/features/browser-config.test.ts +21 -6
  1046. package/src/features/browser-config.ts +13 -9
  1047. package/src/features/browser.test.ts +1 -1
  1048. package/src/features/browser.ts +69 -20
  1049. package/src/features/carConnection.ts +3 -4
  1050. package/src/features/equalizer.ts +10 -6
  1051. package/src/features/errors.ts +37 -22
  1052. package/src/features/favorites.ts +29 -24
  1053. package/src/features/gate.ts +30 -9
  1054. package/src/features/hook-wiring.test.ts +302 -0
  1055. package/src/features/metadata.ts +83 -17
  1056. package/src/features/network.ts +6 -2
  1057. package/src/features/nowPlaying.ts +29 -15
  1058. package/src/features/output.ts +10 -5
  1059. package/src/features/playback/controls.ts +13 -6
  1060. package/src/features/playback/playWhenReady.ts +6 -5
  1061. package/src/features/playback/playing.ts +16 -3
  1062. package/src/features/playback/progress.test.ts +169 -0
  1063. package/src/features/playback/progress.ts +13 -6
  1064. package/src/features/playback/rate.ts +8 -1
  1065. package/src/features/playback/state.ts +10 -6
  1066. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  1067. package/src/features/playback/trackPlaybackTime.ts +9 -7
  1068. package/src/features/playback/volume.ts +6 -5
  1069. package/src/features/player/options.ts +83 -82
  1070. package/src/features/player/setup.test.ts +12 -3
  1071. package/src/features/player/setup.ts +123 -64
  1072. package/src/features/player/validateOptions.ts +21 -0
  1073. package/src/features/queue/activeTrack.ts +15 -5
  1074. package/src/features/queue/queue.ts +58 -23
  1075. package/src/features/queue/repeatMode.ts +2 -2
  1076. package/src/features/queue/shuffle.ts +1 -2
  1077. package/src/features/remoteControls.ts +70 -125
  1078. package/src/features/sleepTimer.test.ts +171 -0
  1079. package/src/features/sleepTimer.ts +25 -9
  1080. package/src/nitro-stub-drift.test.ts +277 -0
  1081. package/src/public-surface.test.ts +147 -0
  1082. package/src/specs/audio-browser.nitro.ts +15 -8
  1083. package/src/style-resolution.test.ts +210 -0
  1084. package/src/test-utils/reactNativeStub.ts +60 -0
  1085. package/src/types/browser-native.ts +7 -3
  1086. package/src/types/browser-nodes.ts +417 -151
  1087. package/src/types/browser.ts +248 -177
  1088. package/src/utils/LazyNativeEmitter.ts +25 -15
  1089. package/src/utils/NativeUpdatedValue.ts +30 -16
  1090. package/src/utils/getTrackIdentity.ts +22 -0
  1091. package/src/utils/useDebug.test.ts +182 -0
  1092. package/src/utils/useDebug.ts +16 -3
  1093. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1094. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1095. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1096. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1097. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1098. package/src/web/NativeAudioBrowser.ts +247 -92
  1099. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1100. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1101. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1102. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1103. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1104. package/src/web/TrackPlayer/Player.ts +286 -38
  1105. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1106. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1107. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1108. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1109. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1110. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1111. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1112. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1113. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1114. package/src/web/__tests__/retry.test.ts +169 -0
  1115. package/src/web/browser/BrowserManager.ts +209 -111
  1116. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1117. package/src/web/browser/FavoriteManager.ts +28 -23
  1118. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1119. package/src/web/browser/SearchManager.test.ts +75 -0
  1120. package/src/web/browser/SearchManager.ts +25 -28
  1121. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1122. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1123. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1124. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1125. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1126. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1127. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1128. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1129. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1130. package/src/web/browser/parseSearchResponse.ts +3 -4
  1131. package/src/web/browser/sections.test.ts +91 -0
  1132. package/src/web/browser/sections.ts +72 -0
  1133. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1134. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1135. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1136. package/src/web/http/followMediaRedirect.ts +253 -0
  1137. package/src/web/player/NowPlayingManager.ts +4 -3
  1138. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1139. package/src/web/util/BrowserPathHelper.ts +68 -13
  1140. package/website/guide/android-auto.md +126 -0
  1141. package/website/guide/android-certificates.md +488 -0
  1142. package/website/guide/artwork.md +300 -0
  1143. package/website/guide/audio-output.md +357 -0
  1144. package/website/guide/automotive.md +91 -0
  1145. package/website/guide/basic-usage.md +154 -0
  1146. package/website/guide/battery.md +142 -0
  1147. package/website/guide/browser.md +674 -0
  1148. package/website/guide/carplay.md +733 -0
  1149. package/website/guide/configuration.md +215 -0
  1150. package/website/guide/equalizer.md +235 -0
  1151. package/website/guide/errors.md +355 -0
  1152. package/website/guide/favorites.md +164 -0
  1153. package/website/guide/gate.md +157 -0
  1154. package/website/guide/getting-started.md +99 -0
  1155. package/website/guide/hooks.md +247 -0
  1156. package/website/guide/live-streams.md +156 -0
  1157. package/website/guide/metadata.md +289 -0
  1158. package/website/guide/migrating-from-track-player.md +289 -0
  1159. package/website/guide/native-callback-fetch.md +137 -0
  1160. package/website/guide/network.md +102 -0
  1161. package/website/guide/now-playing.md +203 -0
  1162. package/website/guide/playback.md +405 -0
  1163. package/website/guide/queue.md +334 -0
  1164. package/website/guide/remote-controls.md +314 -0
  1165. package/website/guide/search.md +270 -0
  1166. package/website/guide/sleep-timer.md +289 -0
  1167. package/website/guide/track.md +271 -0
  1168. package/ios/Bridge.h +0 -8
  1169. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1170. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1171. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1172. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1173. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1174. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -70
  1175. package/ios/Model/MediaURL.swift +0 -67
  1176. package/ios/Model/SourceType.swift +0 -6
  1177. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1178. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1179. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1180. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1181. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1182. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1183. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1184. package/ios/Option/PitchAlgorithms.swift +0 -17
  1185. package/ios/Option/TimeEventFrequency.swift +0 -18
  1186. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1187. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1188. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1189. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1190. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1191. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1192. package/ios/Player/PlaybackStateStore.swift +0 -27
  1193. package/ios/Player/PlayingStateManager.swift +0 -33
  1194. package/ios/Player/RetryManager.swift +0 -322
  1195. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1196. package/ios/Player/SleepTimerHandling.swift +0 -15
  1197. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1198. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1199. package/ios/Tests/MediaResolveTests.swift +0 -126
  1200. package/ios/Tests/OnceValueTests.swift +0 -79
  1201. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1202. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1203. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1204. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1205. package/ios/Tests/RetryManagerTests.swift +0 -89
  1206. package/ios/TrackPlayer.swift +0 -1014
  1207. package/ios/TrackPlayerCallbacks.swift +0 -86
  1208. package/ios/Util/MetadataAdapter.swift +0 -131
  1209. package/ios/Util/OnceValue.swift +0 -104
  1210. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1211. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1212. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1213. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1214. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1215. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1216. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1217. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1218. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1219. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1220. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1221. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1222. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1223. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -37,16 +37,15 @@ import kotlinx.coroutines.Dispatchers
37
37
  import kotlinx.coroutines.MainScope
38
38
  import kotlinx.coroutines.SupervisorJob
39
39
  import kotlinx.coroutines.cancel
40
- import kotlinx.coroutines.launch
40
+ import kotlinx.coroutines.isActive
41
41
  import timber.log.Timber
42
42
 
43
43
  /**
44
- * MediaLibraryService for background audio playback and Android Auto/external controller support.
44
+ * The MediaLibraryService behind background playback, Android Auto and other external controllers.
45
45
  *
46
- * Implements [MediaSessionService.Listener] to receive
47
- * [onForegroundServiceStartNotAllowedException] callbacks when Android 12+ blocks foreground
48
- * service starts from background (e.g., Bluetooth resume while app is killed). This allows us to
49
- * record the failure and notify the user on their next session.
46
+ * As a [MediaSessionService.Listener] it records when Android 12+ refuses a foreground service
47
+ * start from the background (a Bluetooth resume while the app is killed, under battery
48
+ * restrictions), so the user can be warned on their next session.
50
49
  */
51
50
  @MainThread
52
51
  class Service : MediaLibraryService(), MediaSessionService.Listener {
@@ -56,12 +55,16 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
56
55
  private lateinit var mediaSession: MediaLibrarySession
57
56
  private lateinit var imageLoader: ImageLoader
58
57
 
59
- // Callback for battery warning events to notify JS layer
60
58
  var onBatteryWarningPendingChanged: ((Boolean) -> Unit)? = null
61
59
 
62
60
  private var artworkProviderDeps: ArtworkProviderDeps? = null
63
61
 
64
- // Headless service binding
62
+ /**
63
+ * Whether AudioBrowser holds its [LocalBinder] binding. While it does, [stopSelf] cannot end the
64
+ * service, so a task removal keeps the player.
65
+ */
66
+ private var moduleBound = false
67
+
65
68
  private var headlessBound = false
66
69
  private val headlessConnection: ServiceConnection =
67
70
  object : ServiceConnection {
@@ -100,15 +103,13 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
100
103
  player = Player(this)
101
104
  player.setup(PlayerSetupOptions())
102
105
 
103
- // Create shared Coil ImageLoader with SVG support and disk caching
104
- // Disk cache uses Coil defaults: 2% of disk space, max ~250MB
106
+ // The disk cache keeps Coil's default size limit: 2% of the disk, at most 250 MB.
105
107
  imageLoader =
106
108
  ImageLoader.Builder(this)
107
109
  .components { add(SvgDecoder.Factory()) }
108
110
  .diskCache { DiskCache.Builder().directory(cacheDir.resolve("artwork")).build() }
109
111
  .build()
110
112
 
111
- // Create CoilBitmapLoader for artwork loading with custom headers/auth support
112
113
  val coilBitmapLoader =
113
114
  CoilBitmapLoader(
114
115
  context = this,
@@ -117,12 +118,12 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
117
118
  getArtworkSizeHint = { player.artworkSizeHintPixels },
118
119
  )
119
120
 
120
- // Store references in Player for artwork URL transformation and SVG pre-rendering
121
121
  player.coilBitmapLoader = coilBitmapLoader
122
122
  player.imageLoader = imageLoader
123
+ player.onPlaybackResumptionFailed = { releasePlaceholder() }
123
124
 
124
- // Populate the artwork content provider holder so ArtworkContentProvider can serve
125
- // browse artwork to Android Auto / AAOS over content:// URIs.
125
+ // ArtworkContentProvider reads the holder to serve browse artwork to Android Auto and AAOS over
126
+ // content:// URIs.
126
127
  val artworkScope = CoroutineScope(SupervisorJob() + Dispatchers.IO)
127
128
  artworkProviderDeps =
128
129
  ArtworkProviderDeps(
@@ -132,8 +133,8 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
132
133
  artworkSizeHint = { player.artworkSizeHintPixels },
133
134
  )
134
135
  CoilArtworkLoaderHolder.set(artworkProviderDeps!!)
135
- // Best-effort: clear stale artwork cache from previous process so the disk doesn't grow
136
- // unboundedly across restarts. Fresh files will be re-fetched on demand.
136
+ // Best-effort: the previous process's files are stale, and keeping them grows the disk across
137
+ // restarts. The provider fetches again on demand.
137
138
  runCatching {
138
139
  java.io
139
140
  .File(cacheDir, com.audiobrowser.util.ArtworkContentProvider.ARTWORK_SUBDIR)
@@ -143,13 +144,12 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
143
144
  val openAppIntent =
144
145
  packageManager.getLaunchIntentForPackage(packageName)?.apply {
145
146
  flags = Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_SINGLE_TOP
146
- // Add the Uri data so apps can identify that it was a notification click
147
+ // Lets the app tell that a notification click opened it.
147
148
  data = "audiobrowser://notification".toUri()
148
149
  action = Intent.ACTION_VIEW
149
150
  }
150
151
  mediaSession =
151
152
  MediaLibrarySession.Builder(this, player.forwardingPlayer, player.getMediaSessionCallback())
152
- // Use Coil for artwork loading (enables custom headers, SVG support)
153
153
  .setBitmapLoader(CacheBitmapLoader(coilBitmapLoader))
154
154
  // https://github.com/androidx/media/issues/1218
155
155
  .setSessionActivity(
@@ -162,11 +162,9 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
162
162
  )
163
163
  .build()
164
164
 
165
- // Register this service as a listener to catch foreground service start exceptions
166
165
  setListener(this)
167
166
  player.setMediaSession(mediaSession)
168
167
 
169
- // Bind headless service once at startup for JS task execution
170
168
  Intent(applicationContext, HeadlessTaskService::class.java).also { headlessIntent ->
171
169
  Timber.d("Binding to HeadlessTaskService for JS execution")
172
170
  headlessBound = bindService(headlessIntent, headlessConnection, BIND_AUTO_CREATE)
@@ -177,53 +175,41 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
177
175
  override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
178
176
  Timber.d("onStartCommand: action=${intent?.action}")
179
177
 
180
- // Handle MEDIA_PLAY_FROM_SEARCH intent for voice commands
181
178
  intent
182
179
  ?.takeIf { it.action == "android.media.action.MEDIA_PLAY_FROM_SEARCH" }
183
180
  ?.let { searchIntent ->
184
181
  val searchParams = parseSearchIntent(searchIntent)
185
182
  Timber.d("MEDIA_PLAY_FROM_SEARCH intent received: $searchParams")
186
- scope.launch { player.playFromSearch(searchParams) }
183
+ // A search that plays has waited for AudioBrowser, whose MediaBrowser connecting hands
184
+ // the notification to Media3.
185
+ playInForeground(scope, startId, hasMedia = { player.currentTrack != null }) {
186
+ player.playFromSearch(searchParams)
187
+ }
187
188
  }
189
+ // Released by Media3's update after the play request, or by a failed resumption.
190
+ if (intent?.isForegroundStartKey() == true) holdForeground()
188
191
 
189
192
  return super.onStartCommand(intent, flags, startId)
190
193
  }
191
194
 
192
- /**
193
- * Parses MEDIA_PLAY_FROM_SEARCH intent into structured SearchParams.
194
- *
195
- * Extracts search mode from EXTRA_MEDIA_FOCUS and relevant metadata fields:
196
- * - "vnd.android.cursor.item/\*" with empty query → ANY ("play music")
197
- * - "vnd.android.cursor.item/\*" with query → null (unstructured search)
198
- * - Audio.Genres.ENTRY_CONTENT_TYPE → GENRE
199
- * - Audio.Artists.ENTRY_CONTENT_TYPE → ARTIST
200
- * - Audio.Albums.ENTRY_CONTENT_TYPE → ALBUM
201
- * - "vnd.android.cursor.item/audio" → SONG
202
- * - Audio.Playlists.ENTRY_CONTENT_TYPE → PLAYLIST
203
- * - null or unknown → null (unstructured search)
204
- *
205
- * See: https://developer.android.com/guide/components/intents-common#PlaySearch
206
- */
195
+ /** See https://developer.android.com/guide/components/intents-common#PlaySearch */
207
196
  private fun parseSearchIntent(intent: Intent): SearchParams {
208
- // Get the search query from SearchManager.QUERY
209
197
  val query = intent.getStringExtra(SearchManager.QUERY) ?: ""
210
198
 
211
- // Get the media focus type (what kind of media to search for)
212
199
  val mediaFocus = intent.getStringExtra(MediaStore.EXTRA_MEDIA_FOCUS)
213
200
 
214
- // Determine search mode (container vertical) from the media focus. Genre/
215
- // artist/album focuses are FILTERS, not verticals — they yield no mode; the
216
- // extras below carry them. Android has no station/podcast/etc. focus, so
217
- // those verticals are iOS-only.
201
+ // The focus picks a vertical. Genre, artist and album focuses are filters, carried by the
202
+ // extras
203
+ // below, so they yield no mode. Android has no station or podcast focus: those verticals are
204
+ // iOS-only.
218
205
  val mode =
219
206
  when (mediaFocus) {
220
207
  "vnd.android.cursor.item/*" -> if (query.isEmpty()) SearchMode.ANY else null
221
208
  "vnd.android.cursor.item/audio" -> SearchMode.SONG
222
209
  MediaStore.Audio.Playlists.ENTRY_CONTENT_TYPE -> SearchMode.PLAYLIST
223
- else -> null // genre/artist/album/unknown focus → no vertical
210
+ else -> null
224
211
  }
225
212
 
226
- // Extract structured metadata fields
227
213
  val genre = intent.getStringExtra("android.intent.extra.genre")
228
214
  val artist = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ARTIST)
229
215
  val album = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ALBUM)
@@ -249,55 +235,57 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
249
235
  super.onBind(intent)
250
236
  } else {
251
237
  Timber.d("Service being bound by module - returning LocalBinder")
238
+ moduleBound = true
252
239
  binder
253
240
  }
254
241
  }
255
242
 
256
- override fun onTaskRemoved(rootIntent: Intent?) {
257
- onUnbind(rootIntent)
243
+ override fun onRebind(intent: Intent?) {
244
+ if (intent?.action == null) moduleBound = true
245
+ super.onRebind(intent)
246
+ }
258
247
 
248
+ @OptIn(UnstableApi::class)
249
+ override fun onTaskRemoved(rootIntent: Intent?) {
259
250
  val appKilledPlaybackBehavior = player.appKilledPlaybackBehavior
260
251
 
261
252
  Timber.d("player = $player, appKilledPlaybackBehavior = $appKilledPlaybackBehavior")
262
253
 
263
- // Check if there are still external controllers connected (like Android Auto)
264
- val hasExternalControllers =
265
- mediaSession.connectedControllers.any { controller ->
266
- controller.packageName != packageName && // Not our own app
267
- controller.packageName != "com.android.systemui" // Not system UI
268
- }
269
-
270
- Timber.d("hasExternalControllers = $hasExternalControllers")
271
-
272
254
  when (appKilledPlaybackBehavior) {
273
255
  AppKilledPlaybackBehavior.PAUSE_PLAYBACK -> {
274
256
  Timber.d("Pausing playback - appKilledPlaybackBehavior = $appKilledPlaybackBehavior")
275
257
  player.pause()
276
- // Service continues running for Android Auto
277
258
  }
278
259
 
279
260
  AppKilledPlaybackBehavior.STOP_PLAYBACK_AND_REMOVE_NOTIFICATION -> {
280
- if (hasExternalControllers) {
281
- Timber.d("External controllers still connected - deferring aggressive cleanup")
282
- // Just pause and remove notification, but keep service alive for external controllers
261
+ // Only a car keeps the session through a swipe: the Bluetooth stack connects as a
262
+ // controller whenever Bluetooth is on, with or without a device.
263
+ val carConnected =
264
+ mediaSession.connectedControllers.any {
265
+ mediaSession.isAutomotiveController(it) || mediaSession.isAutoCompanionController(it)
266
+ }
267
+ if (carConnected) {
268
+ Timber.d("A car is connected - pausing instead of stopping")
283
269
  player.pause()
284
270
  stopForeground(STOP_FOREGROUND_REMOVE)
271
+ } else if (moduleBound) {
272
+ Timber.d("AudioBrowser still bound - stopping playback but keeping the player")
273
+ stopPlaybackAndRemoveNotification()
274
+ // Ends the service once AudioBrowser unbinds.
275
+ stopSelf()
285
276
  } else {
286
- Timber.d("No external controllers - proceeding with service shutdown")
277
+ Timber.d("No car connected - shutting the service down")
287
278
  try {
288
279
  if (::mediaSession.isInitialized) {
289
280
  mediaSession.release()
290
281
  }
291
- player.clear()
292
- player.stop()
282
+ stopPlaybackAndRemoveNotification()
293
283
  tearDownArtworkProvider()
294
284
  player.destroy()
295
285
  scope.cancel()
296
- stopForeground(STOP_FOREGROUND_REMOVE)
297
286
  stopSelf()
298
287
  } catch (e: Exception) {
299
288
  Timber.e(e, "Error during aggressive cleanup in onTaskRemoved")
300
- // Still try to stop the service
301
289
  stopSelf()
302
290
  }
303
291
  }
@@ -305,18 +293,26 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
305
293
 
306
294
  AppKilledPlaybackBehavior.CONTINUE_PLAYBACK -> {
307
295
  Timber.d("Continuing playback - service remains available for Android Auto")
308
- // Service continues running for Android Auto with existing callbacks
309
296
  }
310
297
  }
311
298
  }
312
299
 
313
- override fun onGetSession(controllerInfo: MediaSession.ControllerInfo): MediaLibrarySession {
300
+ private fun stopPlaybackAndRemoveNotification() {
301
+ // Before stop(), while a mid-ramp fade can still restore the volume.
302
+ player.sleepTimer.clear()
303
+ player.clear()
304
+ player.stop()
305
+ stopForeground(STOP_FOREGROUND_REMOVE)
306
+ }
307
+
308
+ override fun onGetSession(controllerInfo: MediaSession.ControllerInfo): MediaLibrarySession? {
314
309
  Timber.d("onGetSession requested by: ${controllerInfo.packageName}")
315
310
 
316
- // The player is always set up by onCreate. Don't re-run setup() here for controllers that
317
- // connect before React Native does: setup() releases and recreates the ExoPlayer, which would
318
- // kill in-progress playback (e.g. playback resumption from a car/Bluetooth controller) when a
319
- // second controller connects while JS is still booting.
311
+ // Cancelled with the session's release. A client still bound keeps the service alive after
312
+ // a swipe's shutdown, and Media3 throws on adding a released session.
313
+ if (!scope.isActive) return null
314
+
315
+ // No setup() here: default options would replace the ones setupPlayer applied.
320
316
  if (player.getCallbacks() == null) {
321
317
  Timber.w("External controller connecting before React Native setup - using default options")
322
318
  }
@@ -326,14 +322,15 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
326
322
 
327
323
  override fun onUnbind(intent: Intent?): Boolean {
328
324
  Timber.d("onUnbind called - action: ${intent?.action}, package: ${intent?.`package`}")
325
+ if (intent?.action == null) {
326
+ moduleBound = false
327
+ // Android calls onBind once per distinct Intent while the service lives and caches the
328
+ // binder, so only onRebind tells of the next binding, and only when this returns true.
329
+ return true
330
+ }
329
331
  return super.onUnbind(intent)
330
332
  }
331
333
 
332
- /**
333
- * Called when Android 12+ blocks a foreground service start from background. This happens when an
334
- * external controller (Bluetooth, car head unit) tries to resume playback while the app is killed
335
- * and battery restrictions are in place.
336
- */
337
334
  @OptIn(UnstableApi::class)
338
335
  override fun onForegroundServiceStartNotAllowedException() {
339
336
  Timber.w("Foreground service start blocked by Android - recording battery warning")
@@ -342,9 +339,8 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
342
339
  }
343
340
 
344
341
  /**
345
- * Cancels the artwork-provider coroutine scope and clears the Coil loader holder. Idempotent —
346
- * safe to call more than once; the second call is a no-op because the field is null after the
347
- * first. Must be called BEFORE player.destroy() on every teardown path.
342
+ * Cancels the artwork provider's scope and clears its holder. Idempotent. Call it before
343
+ * player.destroy() on every teardown path, so no in-flight load reaches a destroyed player.
348
344
  */
349
345
  private fun tearDownArtworkProvider() {
350
346
  artworkProviderDeps?.let {
@@ -357,15 +353,12 @@ class Service : MediaLibraryService(), MediaSessionService.Listener {
357
353
  override fun onDestroy() {
358
354
  Timber.d("onDestroy called")
359
355
 
360
- // Unbind from HeadlessTaskService to avoid ServiceConnection leak.
361
356
  // Unbinding a connection that never bound throws IllegalArgumentException.
362
357
  if (headlessBound) {
363
358
  unbindService(headlessConnection)
364
359
  headlessBound = false
365
360
  }
366
361
 
367
- // Tear down artwork provider deps before player is destroyed so no in-flight
368
- // coroutine can deref a torn-down player.
369
362
  tearDownArtworkProvider()
370
363
 
371
364
  Timber.d("Releasing media session and destroying player")
@@ -0,0 +1,44 @@
1
+ package com.audiobrowser
2
+
3
+ import android.content.Context
4
+ import android.content.Intent
5
+ import android.content.ServiceConnection
6
+ import timber.log.Timber
7
+
8
+ /**
9
+ * Takes a [ServiceConnection]'s binding at most once, and releases it once and only if taken:
10
+ * [Context.unbindService] throws for a connection that was never registered.
11
+ */
12
+ internal class ServiceBinding(private val context: Context) {
13
+
14
+ @Volatile
15
+ var isBound: Boolean = false
16
+ private set
17
+
18
+ @Volatile private var bindSucceeded: Boolean = false
19
+
20
+ /**
21
+ * Binds unless already bound, and returns what [Context.bindService] returned for the binding
22
+ * held: a second call while bound repeats that answer without binding again.
23
+ */
24
+ fun bind(intent: Intent, connection: ServiceConnection): Boolean {
25
+ if (isBound) return bindSucceeded
26
+ // Bound even when bindService returns false: Android has already registered the connection,
27
+ // and "regardless of the return value, you should later call unbindService()".
28
+ isBound = true
29
+ bindSucceeded = context.bindService(intent, connection, Context.BIND_AUTO_CREATE)
30
+ return bindSucceeded
31
+ }
32
+
33
+ /**
34
+ * Releases the binding if one is held; a no-op otherwise. Still required after
35
+ * [ServiceConnection.onServiceDisconnected], which means the service died, not the binding.
36
+ */
37
+ fun unbind(connection: ServiceConnection) {
38
+ if (!isBound) return
39
+ isBound = false
40
+ // A throw means the binding is already gone, which is the outcome wanted.
41
+ runCatching { context.unbindService(connection) }
42
+ .onFailure { Timber.w(it, "unbindService failed") }
43
+ }
44
+ }
@@ -4,14 +4,15 @@ import com.margelo.nitro.audiobrowser.ArtworkRequestConfig
4
4
  import com.margelo.nitro.audiobrowser.Track
5
5
 
6
6
  /**
7
- * Remembers how an artwork URI was produced (which Track, which artwork-config kind) so the
8
- * display-time bitmap loader can re-resolve it Track-first with a real size hint — instead of
9
- * re-running the artwork Transform on an already-transformed URL, which is only safe for idempotent
10
- * transforms. Bounded LRU; thread-safe (registered from browse coroutines and the now-playing
11
- * scope, read from the bitmap loader's IO scope).
7
+ * Maps a produced artwork URI back to the Track and artwork config it came from, so the
8
+ * display-time bitmap loader, which gets only the URI from Media3, re-resolves Track-first with the
9
+ * real size instead of re-running the transform on an already-transformed URL (safe only for
10
+ * idempotent transforms). Bounded LRU; thread-safe (written from browse coroutines and the
11
+ * now-playing scope, read from the bitmap loader's IO scope).
12
12
  */
13
13
  class ArtworkResolutionRegistry(private val maxEntries: Int = 256) {
14
14
 
15
+ /** A null [perRouteConfig] resolves through the browser's current `config.artwork`. */
15
16
  data class Entry(val track: Track, val perRouteConfig: ArtworkRequestConfig?)
16
17
 
17
18
  private val entries =
@@ -28,10 +29,10 @@ class ArtworkResolutionRegistry(private val maxEntries: Int = 256) {
28
29
  @Synchronized fun lookup(uri: String): Entry? = entries[uri]
29
30
 
30
31
  /**
31
- * Drops all entries. Must run whenever the browser config is replaced or content is invalidated:
32
- * entries pin Tracks and ArtworkRequestConfigs whose transform/resolve fields are Nitro handles
33
- * to JS closures — keeping them past their config's lifetime both retains dead closures and
34
- * resolves display-time artwork through stale callbacks.
32
+ * Drops all entries. Call whenever the browser config is replaced or content is invalidated:
33
+ * entries hold Tracks and configs whose transform/resolve fields are Nitro handles to JS
34
+ * closures, and keeping them both retains dead closures and resolves artwork through stale
35
+ * callbacks.
35
36
  */
36
37
  @Synchronized fun clear() = entries.clear()
37
38
  }
@@ -1,32 +1,48 @@
1
1
  package com.audiobrowser.browser
2
2
 
3
3
  /**
4
- * Token → resolved browse artwork, the [com.audiobrowser.util.ArtworkContentProvider]'s only data
5
- * source. Stores plain resolved data (no Track / Nitro handles), so unlike
6
- * [ArtworkResolutionRegistry] it pins no JS closures and can be sized generously. Cleared when the
7
- * browser config is replaced or content is invalidated. Thread-safe: written from browse
8
- * coroutines, read from the provider's IO scope.
4
+ * Token → resolved artwork, the only data the [com.audiobrowser.util.ArtworkContentProvider]
5
+ * serves. Thread-safe: written from browse coroutines, read from the provider's IO scope.
9
6
  */
10
- class BrowseArtworkRegistry(private val maxEntries: Int = 2048) {
7
+ class BrowseArtworkRegistry(
8
+ // Entries hold plain data, no JS closures (unlike [ArtworkResolutionRegistry]), so they are cheap
9
+ // to keep many of.
10
+ private val maxEntries: Int = 2048,
11
+ private val maxPinnedEntries: Int = 2048,
12
+ ) {
11
13
 
12
- private val entries =
13
- object : LinkedHashMap<String, ResolvedArtwork>(16, 0.75f, true) {
14
- override fun removeEldestEntry(
15
- eldest: MutableMap.MutableEntry<String, ResolvedArtwork>
16
- ): Boolean = size > maxEntries
17
- }
14
+ private val entries = lruMap(maxEntries)
15
+ private val pinned = lruMap(maxPinnedEntries)
18
16
 
19
17
  @Synchronized
20
18
  fun register(token: String, artwork: ResolvedArtwork) {
21
19
  entries[token] = artwork
22
20
  }
23
21
 
24
- @Synchronized fun lookup(token: String): ResolvedArtwork? = entries[token]
22
+ /**
23
+ * Registers artwork that [clear] keeps: browse items are rebuilt after a clear, but media items
24
+ * already in the queue keep their URIs.
25
+ */
26
+ @Synchronized
27
+ fun pin(token: String, artwork: ResolvedArtwork) {
28
+ pinned[token] = artwork
29
+ }
30
+
31
+ @Synchronized fun lookup(token: String): ResolvedArtwork? = entries[token] ?: pinned[token]
25
32
 
33
+ /** Drops the [register]ed entries; [pin]ned ones stay. */
26
34
  @Synchronized fun clear() = entries.clear()
35
+
36
+ private fun lruMap(maxEntries: Int) =
37
+ // Access order, so a lookup keeps an entry from eviction.
38
+ object : LinkedHashMap<String, ResolvedArtwork>(16, 0.75f, true) {
39
+ override fun removeEldestEntry(
40
+ eldest: MutableMap.MutableEntry<String, ResolvedArtwork>
41
+ ): Boolean = size > maxEntries
42
+ }
27
43
  }
28
44
 
29
- /** Everything the provider needs to fetch one artwork, resolved at browse-build time. */
45
+ /** Everything the provider needs to fetch one artwork. */
30
46
  data class ResolvedArtwork(
31
47
  val finalUrl: String,
32
48
  val headers: Map<String, String>?,