react-native-audio-browser 0.2.0-next.9 → 0.2.0-next.90

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 (1271) hide show
  1. package/AudioBrowser.podspec +1 -1
  2. package/README.md +68 -39
  3. package/android/build.gradle +53 -14
  4. package/android/gradle.properties +3 -3
  5. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  6. package/android/src/main/AndroidManifest.xml +14 -1
  7. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +578 -456
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  9. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  10. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  11. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  12. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  13. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  14. package/android/src/main/java/com/audiobrowser/Service.kt +101 -104
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +15 -17
  16. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  17. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +358 -541
  19. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +36 -66
  20. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  21. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  22. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  23. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  24. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -28
  25. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  26. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  27. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +10 -18
  28. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  29. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  30. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  31. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  32. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  33. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  34. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +28 -42
  35. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  36. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  37. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  38. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  39. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  40. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  41. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  42. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  43. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  44. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  45. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +113 -50
  46. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  47. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  48. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +75 -65
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +590 -343
  50. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  51. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +110 -116
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +62 -38
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +119 -132
  55. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  56. package/android/src/main/java/com/audiobrowser/player/Player.kt +686 -600
  57. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  58. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +18 -28
  59. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +171 -178
  60. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +96 -0
  61. package/android/src/main/java/com/audiobrowser/player/RetryFocus.kt +126 -0
  62. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +65 -210
  63. package/android/src/main/java/com/audiobrowser/player/RetryLocks.kt +52 -0
  64. package/android/src/main/java/com/audiobrowser/player/RetryLoop.kt +310 -0
  65. package/android/src/main/java/com/audiobrowser/player/RetryView.kt +31 -0
  66. package/android/src/main/java/com/audiobrowser/player/SessionViewListener.kt +168 -0
  67. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  68. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  69. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  70. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  71. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  72. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  73. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  74. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +104 -0
  75. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  76. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  77. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +742 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  90. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  91. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  92. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  93. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  94. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  95. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  96. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  97. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  98. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  99. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  100. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  101. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  102. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  103. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  104. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  105. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  106. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  107. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  108. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  109. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  110. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  111. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  112. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  113. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  114. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +25 -56
  115. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  116. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  117. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  118. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  119. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  120. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  121. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  122. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  123. package/android/src/main/res/values/strings.xml +25 -5
  124. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  125. package/android/src/test/java/androidx/media3/session/SessionViews.kt +38 -0
  126. package/android/src/test/java/com/audiobrowser/AudioFixtures.kt +32 -0
  127. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  128. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  129. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  130. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +90 -0
  131. package/android/src/test/java/com/audiobrowser/NetworkFixtures.kt +25 -0
  132. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  133. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  134. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +24 -4
  135. package/android/src/test/java/com/audiobrowser/ServiceFixtures.kt +48 -0
  136. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +290 -0
  137. package/android/src/test/java/com/audiobrowser/SessionPositionUpdatesTest.kt +114 -0
  138. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  139. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  140. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  141. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  142. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  143. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  144. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  145. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  146. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  147. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  148. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  149. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  150. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  151. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  152. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +43 -0
  153. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  154. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  155. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  156. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  157. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  158. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  159. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  160. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  161. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  162. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  163. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  164. package/android/src/test/java/com/audiobrowser/player/HandleTrackLoadSeekTest.kt +182 -0
  165. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  166. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +316 -0
  167. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  168. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  169. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  170. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  171. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  172. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  173. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  174. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  176. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  178. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  179. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  180. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  181. package/android/src/test/java/com/audiobrowser/player/PlayerRemoteOutputsSeekTest.kt +105 -0
  182. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +607 -0
  183. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +195 -0
  184. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  185. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  186. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  187. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +354 -0
  188. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +222 -0
  189. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  190. package/android/src/test/java/com/audiobrowser/player/RetryFocusTest.kt +97 -0
  191. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +93 -200
  192. package/android/src/test/java/com/audiobrowser/player/RetryLocksTest.kt +48 -0
  193. package/android/src/test/java/com/audiobrowser/player/RetryLoopCaseTest.kt +181 -0
  194. package/android/src/test/java/com/audiobrowser/player/RetryLoopTest.kt +221 -0
  195. package/android/src/test/java/com/audiobrowser/player/RetryMaskingTest.kt +176 -0
  196. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +212 -0
  197. package/android/src/test/java/com/audiobrowser/player/SessionViewListenerTest.kt +225 -0
  198. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  199. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +234 -0
  200. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  201. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  202. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  203. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +309 -0
  204. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  205. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  206. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  207. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1037 -0
  208. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  209. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  210. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  211. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  212. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  213. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  214. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  215. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  216. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  217. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  218. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  219. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  220. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  221. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  222. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  223. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  224. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  225. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  226. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  227. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  228. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  229. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  230. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  231. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  232. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  233. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  234. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +108 -0
  235. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  236. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  237. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  238. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  239. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  240. package/android/src/test/resources/sonos/device_description.xml +78 -0
  241. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  242. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  243. package/ios/AVPlayerEngine.swift +363 -0
  244. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  245. package/ios/Browser/BrowseGate.swift +70 -0
  246. package/ios/Browser/BrowserConfig.swift +123 -104
  247. package/ios/Browser/BrowserError.swift +15 -0
  248. package/ios/Browser/BrowserManager.swift +153 -675
  249. package/ios/Browser/BrowserPathHelper.swift +54 -117
  250. package/ios/Browser/FavoriteSet.swift +43 -0
  251. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  252. package/ios/Browser/JsonModels.swift +244 -335
  253. package/ios/Browser/NavigationErrorState.swift +42 -0
  254. package/ios/Browser/PageResolver.swift +132 -0
  255. package/ios/Browser/RequestLayer.swift +185 -0
  256. package/ios/Browser/RequestPipeline.swift +295 -0
  257. package/ios/Browser/SearchDrillIn.swift +10 -16
  258. package/ios/Browser/SectionScope.swift +73 -26
  259. package/ios/Browser/SimpleRouter.swift +76 -154
  260. package/ios/Browser/StyleResolver.swift +41 -0
  261. package/ios/Browser/TabBarEntries.swift +8 -7
  262. package/ios/Browser/TrackIdTemplate.swift +29 -0
  263. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  264. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  265. package/ios/CarPlay/CarPlayController.swift +37 -1297
  266. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  267. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  268. package/ios/CarPlay/CarPlayNowPlayingManager.swift +147 -218
  269. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  270. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  271. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  272. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  273. package/ios/CarPlay/CarPlaySession.swift +203 -0
  274. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  275. package/ios/CarPlay/IntentHandlers.swift +94 -0
  276. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  277. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +15 -17
  278. package/ios/CarPlay/MediaIntentPlayback.swift +86 -0
  279. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  280. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  281. package/ios/CarPlay/SectionPresentation.swift +67 -0
  282. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  283. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  284. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  285. package/ios/Extension/CxxVectorConformances.swift +4 -16
  286. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  287. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  288. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  289. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  290. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  291. package/ios/Extension/SearchParams+Query.swift +28 -0
  292. package/ios/Extension/Section+Copying.swift +26 -0
  293. package/ios/Extension/String+IcyCharset.swift +21 -0
  294. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  295. package/ios/Extension/Track+AVPlayer.swift +1 -18
  296. package/ios/Extension/Track+Copying.swift +13 -21
  297. package/ios/Extension/Track+Identity.swift +20 -0
  298. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  299. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  300. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  301. package/ios/Extension/URLError+Connectivity.swift +15 -0
  302. package/ios/Extension/Variant+Artwork.swift +8 -22
  303. package/ios/Http/HttpClient.swift +73 -167
  304. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  305. package/ios/HybridAudioBrowser+Options.swift +116 -0
  306. package/ios/HybridAudioBrowser+Player.swift +347 -0
  307. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  308. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  309. package/ios/HybridAudioBrowser.swift +147 -1718
  310. package/ios/Model/NitroTypeStubs.swift +265 -32
  311. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  312. package/ios/Model/RemoteCommand.swift +6 -78
  313. package/ios/Model/TrackPlayerError.swift +12 -21
  314. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  315. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  316. package/ios/Observer/ItemObserver.swift +92 -0
  317. package/ios/Observer/PlayerObserver.swift +59 -0
  318. package/ios/Option/SessionCategories.swift +41 -92
  319. package/ios/PlaybackEvent.swift +4 -2
  320. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  321. package/ios/Player/AudioSessionController.swift +190 -0
  322. package/ios/Player/DeferredSeek.swift +73 -0
  323. package/ios/Player/ErrorStatus.swift +56 -0
  324. package/ios/Player/MediaLoader.swift +73 -98
  325. package/ios/Player/NowPlayingLines.swift +49 -0
  326. package/ios/Player/NowPlayingUpdater.swift +180 -105
  327. package/ios/Player/PersistedPlaybackState.swift +1 -2
  328. package/ios/Player/PlaybackFailure.swift +121 -0
  329. package/ios/Player/PlaybackPersistence.swift +72 -0
  330. package/ios/Player/PlaybackStateMachine.swift +15 -14
  331. package/ios/Player/PlaybackTimer.swift +11 -8
  332. package/ios/Player/Player.swift +1030 -0
  333. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  334. package/ios/Player/PlayerEngine.swift +109 -0
  335. package/ios/Player/PlayerStatusTypes.swift +1 -6
  336. package/ios/Player/QueueManager.swift +80 -98
  337. package/ios/Player/ReconnectPacer.swift +83 -0
  338. package/ios/Player/RetryLoop.swift +374 -0
  339. package/ios/Player/ShuffleOrder.swift +36 -43
  340. package/ios/Player/SilenceBudget.swift +78 -0
  341. package/ios/Player/SleepTimerManager.swift +25 -42
  342. package/ios/Player/VolumeFader.swift +20 -15
  343. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  344. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  345. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  346. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  347. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  348. package/ios/Tests/BrowseGateTests.swift +50 -0
  349. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  350. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  351. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  352. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  353. package/ios/Tests/ConnectivityTests.swift +13 -0
  354. package/ios/Tests/DeferredSeekTests.swift +76 -0
  355. package/ios/Tests/EmitterTests.swift +22 -39
  356. package/ios/Tests/ErrorStatusTests.swift +50 -0
  357. package/ios/Tests/FavoriteSetTests.swift +61 -0
  358. package/ios/Tests/GenerationMemoTests.swift +178 -0
  359. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  360. package/ios/Tests/JsonModelsTests.swift +189 -3
  361. package/ios/Tests/LRUCacheTests.swift +106 -0
  362. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  363. package/ios/Tests/MediaIntentDeadlineTests.swift +75 -0
  364. package/ios/Tests/MediaLoaderTests.swift +38 -78
  365. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  366. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  367. package/ios/Tests/ObserverTests.swift +88 -0
  368. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  369. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  370. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  371. package/ios/Tests/PlaybackStateMachineTests.swift +7 -22
  372. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  373. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  374. package/ios/Tests/PlayerPolicyTests.swift +1386 -0
  375. package/ios/Tests/PlayerTests.swift +1677 -0
  376. package/ios/Tests/PlayingStateTests.swift +41 -0
  377. package/ios/Tests/QueueManagerTests.swift +205 -174
  378. package/ios/Tests/ReadyValueTests.swift +73 -0
  379. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  380. package/ios/Tests/RequestLayerTests.swift +228 -0
  381. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  382. package/ios/Tests/RetryCaseTests.swift +146 -0
  383. package/ios/Tests/RetryLoopTests.swift +486 -0
  384. package/ios/Tests/SearchDrillInTests.swift +16 -17
  385. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  386. package/ios/Tests/SectionPresentationTests.swift +85 -0
  387. package/ios/Tests/SectionScopeTests.swift +136 -54
  388. package/ios/Tests/SimpleRouterTests.swift +39 -8
  389. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  390. package/ios/Tests/StyleResolverTests.swift +123 -0
  391. package/ios/Tests/SupersedingTaskTests.swift +148 -0
  392. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  393. package/ios/Tests/Support/TestTypes.swift +236 -93
  394. package/ios/Tests/Support/TimeLimit.swift +43 -0
  395. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  396. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  397. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  398. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  399. package/ios/Tests/TrackIdentityTests.swift +20 -0
  400. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  401. package/ios/Tests/TrackSelectorTests.swift +157 -34
  402. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  403. package/ios/TrackSelector.swift +62 -77
  404. package/ios/Util/ArtworkFreshness.swift +42 -0
  405. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  406. package/ios/Util/AwaitCallback.swift +80 -0
  407. package/ios/Util/ConcurrentMap.swift +19 -0
  408. package/ios/Util/Connectivity.swift +12 -0
  409. package/ios/Util/Deadline.swift +38 -0
  410. package/ios/Util/Emitter.swift +45 -22
  411. package/ios/Util/GenerationMemo.swift +43 -0
  412. package/ios/Util/LRUCache.swift +23 -159
  413. package/ios/Util/NetworkMonitor.swift +31 -33
  414. package/ios/Util/OutputPicker.swift +48 -0
  415. package/ios/Util/ReadyValue.swift +57 -0
  416. package/ios/Util/SFSymbolRenderer.swift +64 -49
  417. package/ios/Util/SVGProcessor.swift +9 -16
  418. package/ios/Util/SupersedingTask.swift +45 -0
  419. package/lib/commonjs/AudioBrowser.js +11 -0
  420. package/lib/commonjs/AudioBrowser.js.map +1 -1
  421. package/lib/commonjs/CLAUDE.md +57 -0
  422. package/lib/commonjs/features/battery.js +16 -12
  423. package/lib/commonjs/features/battery.js.map +1 -1
  424. package/lib/commonjs/features/browser-config.js +13 -9
  425. package/lib/commonjs/features/browser-config.js.map +1 -1
  426. package/lib/commonjs/features/browser.js +78 -20
  427. package/lib/commonjs/features/browser.js.map +1 -1
  428. package/lib/commonjs/features/carConnection.js +3 -4
  429. package/lib/commonjs/features/carConnection.js.map +1 -1
  430. package/lib/commonjs/features/equalizer.js +9 -5
  431. package/lib/commonjs/features/equalizer.js.map +1 -1
  432. package/lib/commonjs/features/errors.js +35 -21
  433. package/lib/commonjs/features/errors.js.map +1 -1
  434. package/lib/commonjs/features/favorites.js +28 -23
  435. package/lib/commonjs/features/favorites.js.map +1 -1
  436. package/lib/commonjs/features/gate.js +27 -6
  437. package/lib/commonjs/features/gate.js.map +1 -1
  438. package/lib/commonjs/features/metadata.js +61 -11
  439. package/lib/commonjs/features/metadata.js.map +1 -1
  440. package/lib/commonjs/features/network.js +5 -1
  441. package/lib/commonjs/features/network.js.map +1 -1
  442. package/lib/commonjs/features/nowPlaying.js +28 -14
  443. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  444. package/lib/commonjs/features/output.js +9 -4
  445. package/lib/commonjs/features/output.js.map +1 -1
  446. package/lib/commonjs/features/playback/controls.js +13 -6
  447. package/lib/commonjs/features/playback/controls.js.map +1 -1
  448. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  449. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  450. package/lib/commonjs/features/playback/playing.js +5 -3
  451. package/lib/commonjs/features/playback/playing.js.map +1 -1
  452. package/lib/commonjs/features/playback/progress.js +13 -6
  453. package/lib/commonjs/features/playback/progress.js.map +1 -1
  454. package/lib/commonjs/features/playback/rate.js +8 -1
  455. package/lib/commonjs/features/playback/rate.js.map +1 -1
  456. package/lib/commonjs/features/playback/state.js +5 -6
  457. package/lib/commonjs/features/playback/state.js.map +1 -1
  458. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  459. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  460. package/lib/commonjs/features/playback/volume.js +6 -5
  461. package/lib/commonjs/features/playback/volume.js.map +1 -1
  462. package/lib/commonjs/features/player/options.js +20 -10
  463. package/lib/commonjs/features/player/options.js.map +1 -1
  464. package/lib/commonjs/features/player/setup.js +44 -43
  465. package/lib/commonjs/features/player/setup.js.map +1 -1
  466. package/lib/commonjs/features/player/validateOptions.js +3 -4
  467. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  468. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  469. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  470. package/lib/commonjs/features/queue/queue.js +56 -21
  471. package/lib/commonjs/features/queue/queue.js.map +1 -1
  472. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  473. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  474. package/lib/commonjs/features/queue/shuffle.js +0 -1
  475. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  476. package/lib/commonjs/features/remoteControls.js +59 -35
  477. package/lib/commonjs/features/remoteControls.js.map +1 -1
  478. package/lib/commonjs/features/sleepTimer.js +23 -6
  479. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  480. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  481. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  482. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  483. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  484. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  485. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  486. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  487. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  488. package/lib/commonjs/utils/useDebug.js +16 -3
  489. package/lib/commonjs/utils/useDebug.js.map +1 -1
  490. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  491. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  492. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  493. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  494. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  495. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  496. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  497. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  498. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  499. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  500. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  501. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  502. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  503. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  504. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  505. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  506. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  507. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  508. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  509. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  510. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  511. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  512. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  513. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  514. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  515. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  516. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  517. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  518. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  519. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  520. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  521. package/lib/commonjs/web/browser/sections.js +89 -0
  522. package/lib/commonjs/web/browser/sections.js.map +1 -0
  523. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  524. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  525. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  526. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  527. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  528. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  529. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  530. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  531. package/lib/module/AudioBrowser.js +2 -4
  532. package/lib/module/AudioBrowser.js.map +1 -1
  533. package/lib/module/CLAUDE.md +57 -0
  534. package/lib/module/features/battery.js +16 -12
  535. package/lib/module/features/battery.js.map +1 -1
  536. package/lib/module/features/browser-config.js +13 -9
  537. package/lib/module/features/browser-config.js.map +1 -1
  538. package/lib/module/features/browser.js +78 -20
  539. package/lib/module/features/browser.js.map +1 -1
  540. package/lib/module/features/carConnection.js +3 -4
  541. package/lib/module/features/carConnection.js.map +1 -1
  542. package/lib/module/features/equalizer.js +9 -5
  543. package/lib/module/features/equalizer.js.map +1 -1
  544. package/lib/module/features/errors.js +35 -21
  545. package/lib/module/features/errors.js.map +1 -1
  546. package/lib/module/features/favorites.js +28 -23
  547. package/lib/module/features/favorites.js.map +1 -1
  548. package/lib/module/features/gate.js +27 -6
  549. package/lib/module/features/gate.js.map +1 -1
  550. package/lib/module/features/metadata.js +59 -11
  551. package/lib/module/features/metadata.js.map +1 -1
  552. package/lib/module/features/network.js +5 -1
  553. package/lib/module/features/network.js.map +1 -1
  554. package/lib/module/features/nowPlaying.js +28 -14
  555. package/lib/module/features/nowPlaying.js.map +1 -1
  556. package/lib/module/features/output.js +9 -4
  557. package/lib/module/features/output.js.map +1 -1
  558. package/lib/module/features/playback/controls.js +13 -6
  559. package/lib/module/features/playback/controls.js.map +1 -1
  560. package/lib/module/features/playback/playWhenReady.js +6 -5
  561. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  562. package/lib/module/features/playback/playing.js +5 -3
  563. package/lib/module/features/playback/playing.js.map +1 -1
  564. package/lib/module/features/playback/progress.js +13 -6
  565. package/lib/module/features/playback/progress.js.map +1 -1
  566. package/lib/module/features/playback/rate.js +8 -1
  567. package/lib/module/features/playback/rate.js.map +1 -1
  568. package/lib/module/features/playback/state.js +5 -6
  569. package/lib/module/features/playback/state.js.map +1 -1
  570. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  571. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  572. package/lib/module/features/playback/volume.js +6 -5
  573. package/lib/module/features/playback/volume.js.map +1 -1
  574. package/lib/module/features/player/options.js +20 -10
  575. package/lib/module/features/player/options.js.map +1 -1
  576. package/lib/module/features/player/setup.js +44 -43
  577. package/lib/module/features/player/setup.js.map +1 -1
  578. package/lib/module/features/player/validateOptions.js +3 -4
  579. package/lib/module/features/player/validateOptions.js.map +1 -1
  580. package/lib/module/features/queue/activeTrack.js +14 -4
  581. package/lib/module/features/queue/activeTrack.js.map +1 -1
  582. package/lib/module/features/queue/queue.js +56 -21
  583. package/lib/module/features/queue/queue.js.map +1 -1
  584. package/lib/module/features/queue/repeatMode.js +2 -1
  585. package/lib/module/features/queue/repeatMode.js.map +1 -1
  586. package/lib/module/features/queue/shuffle.js +0 -1
  587. package/lib/module/features/queue/shuffle.js.map +1 -1
  588. package/lib/module/features/remoteControls.js +59 -35
  589. package/lib/module/features/remoteControls.js.map +1 -1
  590. package/lib/module/features/sleepTimer.js +24 -7
  591. package/lib/module/features/sleepTimer.js.map +1 -1
  592. package/lib/module/test-utils/reactNativeStub.js +58 -0
  593. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  594. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  595. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  596. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  597. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  598. package/lib/module/utils/getTrackIdentity.js +22 -0
  599. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  600. package/lib/module/utils/useDebug.js +16 -3
  601. package/lib/module/utils/useDebug.js.map +1 -1
  602. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  603. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  604. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  605. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  606. package/lib/module/web/NativeAudioBrowser.js +207 -84
  607. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  608. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  609. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  610. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  611. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  612. package/lib/module/web/TrackPlayer/Player.js +256 -40
  613. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  614. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  615. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  616. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  617. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  618. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  619. package/lib/module/web/browser/BrowserManager.js +175 -100
  620. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  621. package/lib/module/web/browser/FavoriteManager.js +31 -21
  622. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  623. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  624. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  625. package/lib/module/web/browser/SearchManager.js +18 -23
  626. package/lib/module/web/browser/SearchManager.js.map +1 -1
  627. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  628. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  629. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  630. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  631. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  632. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  633. package/lib/module/web/browser/sections.js +83 -0
  634. package/lib/module/web/browser/sections.js.map +1 -0
  635. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  636. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  637. package/lib/module/web/http/followMediaRedirect.js +215 -0
  638. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  639. package/lib/module/web/player/NowPlayingManager.js +4 -3
  640. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  641. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  642. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  643. package/lib/typescript/package.json +1 -0
  644. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  645. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  646. package/lib/typescript/src/features/battery.d.ts +17 -12
  647. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  648. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  649. package/lib/typescript/src/features/browser.d.ts +67 -19
  650. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  651. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  652. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  653. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  654. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  655. package/lib/typescript/src/features/errors.d.ts +37 -22
  656. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  657. package/lib/typescript/src/features/favorites.d.ts +28 -23
  658. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  659. package/lib/typescript/src/features/gate.d.ts +29 -8
  660. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  661. package/lib/typescript/src/features/metadata.d.ts +65 -14
  662. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  663. package/lib/typescript/src/features/network.d.ts +5 -1
  664. package/lib/typescript/src/features/network.d.ts.map +1 -1
  665. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  666. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  667. package/lib/typescript/src/features/output.d.ts +9 -4
  668. package/lib/typescript/src/features/output.d.ts.map +1 -1
  669. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  670. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  671. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  672. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  673. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  674. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  675. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  676. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  677. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  678. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  679. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  680. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  681. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  682. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  683. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  684. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  685. package/lib/typescript/src/features/player/options.d.ts +73 -56
  686. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  687. package/lib/typescript/src/features/player/setup.d.ts +129 -73
  688. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  689. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  690. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  691. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  692. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  693. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  694. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  695. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  696. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  697. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  698. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  699. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  700. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  701. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  702. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  703. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  704. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  705. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  706. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  707. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  708. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  709. package/lib/typescript/src/types/browser.d.ts +242 -173
  710. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  711. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  712. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  713. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  714. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  715. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  716. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  717. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  718. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  719. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  720. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  721. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  722. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  723. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  724. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  725. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  726. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  727. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  728. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  732. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  733. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  734. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  735. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  740. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  742. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  743. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  745. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  747. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  748. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  749. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  750. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  752. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  753. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  754. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  755. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  756. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  757. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  759. 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
  760. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  761. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  763. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  764. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  765. 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
  766. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  771. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  773. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  775. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  777. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  778. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  783. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  785. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  796. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  799. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  800. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  802. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  805. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  807. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  808. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  810. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  813. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  815. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  816. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  819. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  822. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  824. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  825. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  826. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  827. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  830. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  832. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  833. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  836. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  838. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  840. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  841. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  842. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  844. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  845. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  846. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  847. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  848. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  850. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  851. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  852. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  853. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  854. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  855. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  856. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  857. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  858. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  859. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  860. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  861. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  862. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  863. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  864. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  865. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  866. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  867. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  868. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  869. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  870. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  871. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  872. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  873. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  874. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  875. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  876. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  877. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  878. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  879. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  880. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  881. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  882. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  883. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  884. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  885. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  905. 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
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  912. 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
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  915. 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
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  918. 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
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  1002. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  1003. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  1004. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  1005. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  1006. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  1007. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  1008. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  1009. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  1010. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  1011. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  1012. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  1018. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  1019. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  1020. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  1021. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  1022. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1023. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1024. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1025. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1026. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1027. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1028. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1029. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1030. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1031. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1032. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1033. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1034. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1035. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1036. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1037. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1038. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1039. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1040. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1041. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1042. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1043. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1044. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1045. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1046. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1047. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1048. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1049. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1050. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1051. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1052. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1053. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1054. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1055. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1056. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1057. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1058. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1059. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1060. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1061. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1062. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1063. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1064. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1065. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1066. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1067. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1068. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1069. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1070. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1071. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1072. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1073. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1074. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1075. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1076. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1077. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1078. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1079. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1080. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1081. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1082. package/package.json +26 -13
  1083. package/src/AudioBrowser.ts +2 -4
  1084. package/src/CLAUDE.md +57 -0
  1085. package/src/docs-floors.test.ts +71 -0
  1086. package/src/features/battery.test.ts +79 -0
  1087. package/src/features/battery.ts +17 -13
  1088. package/src/features/browser-config.test.ts +21 -6
  1089. package/src/features/browser-config.ts +13 -9
  1090. package/src/features/browser.test.ts +1 -1
  1091. package/src/features/browser.ts +69 -20
  1092. package/src/features/carConnection.ts +3 -4
  1093. package/src/features/equalizer.ts +9 -5
  1094. package/src/features/errors.ts +37 -22
  1095. package/src/features/favorites.ts +28 -23
  1096. package/src/features/gate.ts +29 -8
  1097. package/src/features/hook-wiring.test.ts +302 -0
  1098. package/src/features/metadata.ts +80 -14
  1099. package/src/features/network.ts +5 -1
  1100. package/src/features/nowPlaying.ts +28 -14
  1101. package/src/features/output.ts +9 -4
  1102. package/src/features/playback/controls.ts +13 -6
  1103. package/src/features/playback/playWhenReady.ts +6 -5
  1104. package/src/features/playback/playing.ts +16 -3
  1105. package/src/features/playback/progress.test.ts +169 -0
  1106. package/src/features/playback/progress.ts +13 -6
  1107. package/src/features/playback/rate.ts +8 -1
  1108. package/src/features/playback/state.ts +10 -6
  1109. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1110. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1111. package/src/features/playback/volume.ts +6 -5
  1112. package/src/features/player/options.ts +81 -62
  1113. package/src/features/player/setup.test.ts +12 -3
  1114. package/src/features/player/setup.ts +141 -76
  1115. package/src/features/player/validateOptions.ts +3 -4
  1116. package/src/features/queue/activeTrack.ts +14 -4
  1117. package/src/features/queue/queue.ts +56 -21
  1118. package/src/features/queue/repeatMode.ts +1 -1
  1119. package/src/features/queue/shuffle.ts +0 -1
  1120. package/src/features/remoteControls.ts +59 -35
  1121. package/src/features/sleepTimer.test.ts +171 -0
  1122. package/src/features/sleepTimer.ts +24 -8
  1123. package/src/nitro-stub-drift.test.ts +277 -0
  1124. package/src/public-surface.test.ts +48 -24
  1125. package/src/specs/audio-browser.nitro.ts +15 -8
  1126. package/src/style-resolution.test.ts +210 -0
  1127. package/src/test-utils/reactNativeStub.ts +60 -0
  1128. package/src/types/browser-native.ts +7 -3
  1129. package/src/types/browser-nodes.ts +417 -151
  1130. package/src/types/browser.ts +248 -177
  1131. package/src/utils/LazyNativeEmitter.ts +17 -10
  1132. package/src/utils/NativeUpdatedValue.ts +30 -16
  1133. package/src/utils/getTrackIdentity.ts +22 -0
  1134. package/src/utils/useDebug.test.ts +182 -0
  1135. package/src/utils/useDebug.ts +16 -3
  1136. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1137. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1138. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1139. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1140. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1141. package/src/web/NativeAudioBrowser.ts +247 -92
  1142. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1143. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1144. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1145. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1146. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1147. package/src/web/TrackPlayer/Player.ts +286 -38
  1148. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1149. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1150. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1151. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1152. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1153. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1154. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1155. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1156. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1157. package/src/web/__tests__/retry.test.ts +169 -0
  1158. package/src/web/browser/BrowserManager.ts +209 -111
  1159. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1160. package/src/web/browser/FavoriteManager.ts +28 -23
  1161. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1162. package/src/web/browser/SearchManager.test.ts +75 -0
  1163. package/src/web/browser/SearchManager.ts +25 -28
  1164. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1165. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1166. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1167. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1168. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1169. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1170. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1171. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1172. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1173. package/src/web/browser/parseSearchResponse.ts +3 -4
  1174. package/src/web/browser/sections.test.ts +91 -0
  1175. package/src/web/browser/sections.ts +72 -0
  1176. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1177. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1178. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1179. package/src/web/http/followMediaRedirect.ts +253 -0
  1180. package/src/web/player/NowPlayingManager.ts +4 -3
  1181. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1182. package/src/web/util/BrowserPathHelper.ts +68 -13
  1183. package/website/guide/android-auto.md +126 -0
  1184. package/website/guide/android-certificates.md +488 -0
  1185. package/website/guide/artwork.md +300 -0
  1186. package/website/guide/audio-output.md +357 -0
  1187. package/website/guide/automotive.md +91 -0
  1188. package/website/guide/basic-usage.md +154 -0
  1189. package/website/guide/battery.md +142 -0
  1190. package/website/guide/browser.md +674 -0
  1191. package/website/guide/carplay.md +733 -0
  1192. package/website/guide/configuration.md +215 -0
  1193. package/website/guide/equalizer.md +235 -0
  1194. package/website/guide/errors.md +359 -0
  1195. package/website/guide/favorites.md +164 -0
  1196. package/website/guide/gate.md +157 -0
  1197. package/website/guide/getting-started.md +99 -0
  1198. package/website/guide/hooks.md +247 -0
  1199. package/website/guide/live-streams.md +189 -0
  1200. package/website/guide/metadata.md +289 -0
  1201. package/website/guide/migrating-from-track-player.md +289 -0
  1202. package/website/guide/native-callback-fetch.md +137 -0
  1203. package/website/guide/network.md +103 -0
  1204. package/website/guide/now-playing.md +203 -0
  1205. package/website/guide/playback.md +405 -0
  1206. package/website/guide/queue.md +334 -0
  1207. package/website/guide/remote-controls.md +314 -0
  1208. package/website/guide/search.md +270 -0
  1209. package/website/guide/sleep-timer.md +289 -0
  1210. package/website/guide/track.md +271 -0
  1211. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +0 -50
  1212. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1213. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +0 -40
  1214. package/ios/Bridge.h +0 -8
  1215. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1216. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1217. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1218. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1219. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1220. package/ios/Model/MediaURL.swift +0 -67
  1221. package/ios/Model/SourceType.swift +0 -6
  1222. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1223. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1224. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1225. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1226. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1227. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1228. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1229. package/ios/Option/PitchAlgorithms.swift +0 -17
  1230. package/ios/Option/TimeEventFrequency.swift +0 -18
  1231. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1232. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1233. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1234. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1235. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1236. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1237. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1238. package/ios/Player/PlaybackStateStore.swift +0 -27
  1239. package/ios/Player/PlayingStateManager.swift +0 -33
  1240. package/ios/Player/RetryManager.swift +0 -323
  1241. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1242. package/ios/Player/SleepTimerHandling.swift +0 -15
  1243. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1244. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1245. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1246. package/ios/Tests/MediaResolveTests.swift +0 -126
  1247. package/ios/Tests/OnceValueTests.swift +0 -79
  1248. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1249. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1250. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1251. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1252. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1253. package/ios/Tests/RetryManagerTests.swift +0 -89
  1254. package/ios/TrackPlayer.swift +0 -1014
  1255. package/ios/TrackPlayerCallbacks.swift +0 -53
  1256. package/ios/Util/MetadataAdapter.swift +0 -131
  1257. package/ios/Util/OnceValue.swift +0 -104
  1258. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1259. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1260. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1261. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1262. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1263. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1264. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1265. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1266. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1267. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1268. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1269. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1270. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1271. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -0,0 +1,189 @@
1
+ ---
2
+ description: "The map for live audio: stream formats, missing durations, dropped connections, expiring URLs, song titles carried in-band, and Android's periodic position updates."
3
+ ---
4
+
5
+ # Live Streams
6
+
7
+ Live audio is what most of this player's edge cases are about: streams that
8
+ have no duration, drop in tunnels, expire their URLs, and carry their song
9
+ titles in-band.
10
+
11
+ The pieces live in their own guides — this page is the map,
12
+ with just enough of each to know which link you need.
13
+
14
+ ## Stream formats
15
+
16
+ Point [`src`](/api/types/browser-nodes/#src) at the stream URL — there is
17
+ no format field; each platform's player detects the container:
18
+
19
+ - **HLS** (`.m3u8`) — iOS, Android and web. iOS and Android read in-band
20
+ ID3 timed metadata.
21
+ - **ICY / Icecast / Shoutcast** — plain HTTP radio, iOS, Android and web. On
22
+ iOS and Android the ICY `StreamTitle` arrives as timed metadata, filling
23
+ only `title`.
24
+ - **Progressive HTTP** — ordinary MP3/AAC/… files and endless streams, iOS,
25
+ Android and web.
26
+ - **DASH** — Android (bundled Media3 module) and web; iOS's AVPlayer doesn't
27
+ support it. **SmoothStreaming** is Android only.
28
+
29
+ Timed metadata of either kind reaches the lock screen only once your
30
+ [now-playing formatter](/guide/now-playing#the-formatter-derived-continuous)
31
+ applies it, never automatically (see
32
+ [Metadata](/guide/metadata#timed-metadata-the-live-song)).
33
+
34
+ Mark the track itself with [`live: true`](/api/types/browser-nodes/#live):
35
+ it arms [`seekToLiveEdge()`](#the-live-edge) on every platform, and gives
36
+ now-playing non-scrubbing controls on iOS and Android. On Android a cast
37
+ receiver also loads it as a live stream. On iOS it also shows the live
38
+ indicator, turns an end of stream or a stall into a reconnect at the live
39
+ edge, and skips saving a position. Declare it on every live track.
40
+
41
+ To hear it, put the track in the queue (or serve it from a
42
+ [browse tree](/guide/basic-usage)) after
43
+ [`setupPlayer()`](/guide/basic-usage#set-up-the-player) has run:
44
+
45
+ ```ts
46
+ import { play, setQueue } from 'react-native-audio-browser'
47
+
48
+ setQueue([
49
+ {
50
+ src: 'https://stream.example.com/main.mp3',
51
+ title: 'Beacon FM',
52
+ live: true
53
+ }
54
+ ])
55
+ play()
56
+ ```
57
+
58
+ ## Dropouts: stalls and retry
59
+
60
+ A connection drop mid-stream surfaces one of two ways, with different owners:
61
+
62
+ - **A stall** (how most iOS drops surface) — the player holds `'buffering'`
63
+ with play intent, and re-establishes the stream by itself when
64
+ connectivity returns (see
65
+ [Network → You may not need this](/guide/network#you-may-not-need-this)).
66
+ While stalled offline, the [now-playing formatter](/guide/now-playing#the-formatter-derived-continuous)
67
+ receives `stalled: 'offline'` (vs `'buffering'` when online) so the lock
68
+ screen can say why.
69
+ - **A playback error** (how most Android drops surface) — recovery belongs
70
+ to [automatic retry](/guide/errors#automatic-retry)
71
+ (`setupPlayer({ retry })`, off by default). Which of
72
+ [two duration budgets](/guide/errors#two-duration-budgets) applies depends
73
+ on whether this load has ever produced audio:
74
+ - **First connect**, for a stream that never played. Only online time
75
+ counts, so a station tapped in a tunnel still gets its chance when the
76
+ network returns.
77
+ - **Recovery**, once playback proved the stream works. This one is
78
+ wall-clock time and includes offline time, so playback never resumes by
79
+ surprise after a long outage.
80
+
81
+ Once the budget runs out, the state is `'error'`, and
82
+ [`retry()`](/guide/errors#manual-retry) and your error UI take over.
83
+
84
+ Android's reconnect-on-restore only arms through the retry machinery, so
85
+ the platform whose drops become errors is also the one that won't heal
86
+ without it. **If surviving tunnels matters to you, enable `retry`.**
87
+
88
+ The web implementation has no automatic retry at all, and no timed metadata,
89
+ neither ICY nor HLS ID3. Every web error is terminal.
90
+
91
+ ## Fresh URLs on reconnect
92
+
93
+ If your stream URLs are signed or short-lived, build them in
94
+ [`media.resolve`](/guide/browser#media-and-artwork) — the per-track layer of
95
+ the stream request. When a reconnect re-runs it depends on the platform:
96
+
97
+ - **iOS** re-runs it on every reload: automatic retry, network restore,
98
+ play-from-`'error'` and a live-edge reconnect. A URL that expired during
99
+ the outage is re-signed instead of re-failing.
100
+ - **Android** reuses the URL it resolved, and re-runs `media.resolve` only
101
+ after an attempt to open that URL has failed. A URL that expired
102
+ mid-stream therefore costs one failed attempt.
103
+
104
+ With `retry` on, a status that retrying can't fix (a 401 or 403, say; see
105
+ [which failures qualify](/guide/errors#automatic-retry)) puts playback in
106
+ `'error'`, and the next [`retry()`](/guide/errors#manual-retry) or play
107
+ command re-resolves. With `retry` off, ExoPlayer's own few retries cover any
108
+ status, and the first of them re-resolves.
109
+
110
+ - **Web** re-runs it on every reload: play-from-`'error'` or after a stop,
111
+ `retry()` and a live-edge reconnect. Web has no automatic retry.
112
+
113
+ ```ts
114
+ import { configureBrowser } from 'react-native-audio-browser'
115
+
116
+ // Merge `media` into your one configureBrowser call — it replaces the
117
+ // whole config, so a media-only call would drop your tabs and routes.
118
+ configureBrowser({
119
+ media: {
120
+ resolve: async (track) => ({
121
+ path: `/stream/${track.id}`,
122
+ // sign() is yours — however your backend mints stream tokens
123
+ query: { token: await sign(track.id) }
124
+ })
125
+ }
126
+ })
127
+ ```
128
+
129
+ A relative `path` is joined to your configured `baseUrl` — see
130
+ [Shaping requests](/guide/browser#shaping-requests) for the layering.
131
+
132
+ ## The live edge
133
+
134
+ [`seekToLiveEdge()`](/api/features/playback/#seektoliveedge) jumps a live
135
+ track back to the newest available audio — a no-op unless the current track
136
+ declares `live: true`.
137
+
138
+ On a stream with a seekable live window (HLS with a sliding window) it seeks
139
+ to the window's edge; on a non-seekable one (typical ICY radio) it
140
+ reconnects instead — a fresh connection _is_ the live edge.
141
+
142
+ On iOS and web the reconnect re-runs `media.resolve`. On Android it reuses the
143
+ resolved URL, so an expired one re-resolves only after that first attempt
144
+ fails (see [Fresh URLs on reconnect](#fresh-urls-on-reconnect)).
145
+ General seeking is in [Playback](/guide/playback).
146
+
147
+ ## Periodic position updates (Android)
148
+
149
+ While the player plays or loads, Media3's media session sends External
150
+ Surfaces the playback state again every 3 seconds: the notification, the lock
151
+ screen, Android Auto, Bluetooth, and Media3 controllers in other apps (a
152
+ watch, say). The update carries the current and buffered position, so a
153
+ surface that extrapolates the position corrects any drift.
154
+
155
+ A live track has no progress bar, so a drifting position never shows, and the
156
+ update only refreshes the state's timestamp. Android 16's Bluetooth service
157
+ logs each one as `tried to update with no new data`.
158
+
159
+ If your app plays only live streams, turn the update off with a literal
160
+ `false` in your app's manifest:
161
+
162
+ ```xml
163
+ <!-- android/app/src/main/AndroidManifest.xml, inside <application> -->
164
+ <meta-data
165
+ android:name="com.audiobrowser.PERIODIC_POSITION_UPDATES"
166
+ android:value="false" />
167
+ ```
168
+
169
+ Every real change still reaches the surfaces at once: state, play and pause,
170
+ seeks, speed, Now Playing and the queue. Surfaces extrapolate an on-demand
171
+ position from the last state, so their progress bars keep moving. What stops
172
+ is the correction: a position that drifts with no state change (a Sonos
173
+ speaker that slips while it still reports playing, say) stays wrong on the
174
+ surfaces until the next change.
175
+
176
+ Leave it on, the default, if your app plays on-demand audio. The flag is
177
+ Android-only: iOS and web have no such update.
178
+
179
+ ## API summary
180
+
181
+ | API | Purpose |
182
+ | ----------------------------------------------------------------- | ----------------------------------------------------------------------- |
183
+ | [`Track.live`](/api/types/browser-nodes/#live) | Declare a live track: iOS live indicator, arms the live edge. |
184
+ | [`seekToLiveEdge()`](/api/features/playback/#seektoliveedge) | Jump to the newest audio (no-op for non-live tracks). |
185
+ | [`setupPlayer({ retry })`](/guide/errors#automatic-retry) | Automatic retry with first-connect and recovery budgets. |
186
+ | [`retry()`](/guide/errors#manual-retry) | Restart from `'error'` with fresh budgets. |
187
+ | [`media.resolve`](/guide/browser#media-and-artwork) | Build the stream request — signed / short-lived URLs. |
188
+ | [`useOnline()`](/guide/network) | Connectivity for your own UI; playback reacts on its own. |
189
+ | [`PERIODIC_POSITION_UPDATES`](#periodic-position-updates-android) | Android manifest flag: stop the 3 s position update for live-only apps. |
@@ -0,0 +1,289 @@
1
+ ---
2
+ description: 'Read the metadata coming out of the media as it plays: the live ICY or HLS song, the static tags baked into a file, and chapter markers.'
3
+ ---
4
+
5
+ # Metadata
6
+
7
+ As a track plays, the player surfaces metadata it reads _from the media_ — the
8
+ live "now playing song" of a radio stream, the tags embedded in an audio file,
9
+ and chapter markers. These arrive as three independent event streams:
10
+
11
+ - [`onTimedMetadata`](/api/features/metadata/#ontimedmetadata) — the live song
12
+ from a stream (ICY radio or HLS in-band ID3), changing as the broadcast does.
13
+ - [`onTrackMetadata`](/api/features/metadata/#ontrackmetadata) — the track's
14
+ static metadata: on iOS the file's own tags, read when it loads; on Android
15
+ the player's merged view of the Track and the file.
16
+ - [`onChapterMetadata`](/api/features/metadata/#onchaptermetadata) — chapter
17
+ markers with time ranges, for podcasts and audiobooks.
18
+
19
+ These are **read-only signals coming _in_** from the media — they don't change
20
+ what's displayed anywhere. It's up to you to do something with them: feed the
21
+ [Now Playing](/guide/now-playing) surfaces, render your own UI, or build a
22
+ chapter list.
23
+
24
+ Timed metadata also has a getter and a hook,
25
+ [`getTimedMetadata()`](/api/features/metadata/#gettimedmetadata) and
26
+ [`useTimedMetadata()`](/api/features/metadata/#usetimedmetadata), so a screen
27
+ that mounts mid-song still has the title. Track metadata and chapters are
28
+ subscription-only: you subscribe and keep the latest value yourself, as shown
29
+ below.
30
+
31
+ The UI snippets below import `useEffect` / `useState` from `react`, and `Text` /
32
+ `Button` / `FlatList` from `react-native`; those import lines are
33
+ omitted for brevity. Everything else comes from `react-native-audio-browser`.
34
+
35
+ ## Subscribing
36
+
37
+ Every metadata event follows the same shape: `addListener` registers a callback
38
+ and returns a cleanup function that unsubscribes.
39
+
40
+ ```ts
41
+ import { onTimedMetadata } from 'react-native-audio-browser'
42
+
43
+ const unsubscribe = onTimedMetadata.addListener((metadata) => {
44
+ console.log('now playing:', metadata.title)
45
+ })
46
+
47
+ // later:
48
+ unsubscribe()
49
+ ```
50
+
51
+ Because the cleanup function is exactly what React's `useEffect` wants returned,
52
+ turning any of these into reactive state is a one-liner — see
53
+ [Holding metadata in state](#holding-metadata-in-state).
54
+
55
+ ## Timed metadata: the live song
56
+
57
+ [`onTimedMetadata`](/api/features/metadata/#ontimedmetadata) delivers the
58
+ "now playing song" announced by a live stream. Two formats arrive through this
59
+ one event:
60
+
61
+ - **ICY** metadata — Shoutcast / Icecast HTTP radio.
62
+ - **In-band ID3** timed metadata — how **HLS** live streams (and some others)
63
+ carry the current song.
64
+
65
+ It fires each time the stream announces a new song, so the value changes
66
+ throughout a single track.
67
+
68
+ ::: info iOS also fires it for a file's tags
69
+ On iOS, a file without chapter markers fires `onTimedMetadata` too. It fires
70
+ once on load for each metadata format the file carries (ID3, iTunes), with the
71
+ file's own tags: `title`, `artist`, `album` and so on.
72
+
73
+ The
74
+ [Now Playing formatter](/guide/now-playing#the-formatter-derived-continuous)
75
+ then gets them as `timedMetadata` for an on-demand file too. A formatter that
76
+ reads `timedMetadata.title` shows the file's title. Android fires it only for
77
+ metadata the media sends during playback.
78
+ :::
79
+
80
+ [`TimedMetadata`](/api/features/metadata/#timedmetadata) — every field optional:
81
+
82
+ | Field | Meaning |
83
+ | -------- | ------------------------------------------------ |
84
+ | `title` | The song title (often "Artist - Song" in ICY). |
85
+ | `artist` | The artist, when the stream sends it separately. |
86
+ | `album` | The album, when present. |
87
+ | `date` | A date string, when present. |
88
+ | `genre` | The genre, when present. |
89
+
90
+ ::: warning ICY sends only a title
91
+ Shoutcast / Icecast (ICY) radio populates **only `title`** — typically a combined
92
+ `"Artist - Song"` string. `artist`, `album`, `date`, and `genre` stay `undefined`
93
+ for ICY; they're filled only by ID3 / HLS / file metadata. For a radio app,
94
+ parse `title` yourself rather than binding `metadata.artist`.
95
+ :::
96
+
97
+ This is the signal behind a live station's "now playing" line. To show it on the
98
+ lock screen / car, you usually don't subscribe here directly — you read it inside
99
+ the Now Playing formatter, which is re-invoked on every timed-metadata update.
100
+ See [Now Playing → the formatter](/guide/now-playing#the-formatter-derived-continuous).
101
+
102
+ For the live song in _your own_ UI, use `useTimedMetadata()`. It returns the
103
+ last timed metadata of the current track, and `undefined` from a track change
104
+ until the new track's first update:
105
+
106
+ ```tsx
107
+ function NowPlayingSong() {
108
+ const song = useTimedMetadata()
109
+ return <Text>{song?.title ?? 'Unknown'}</Text>
110
+ }
111
+ ```
112
+
113
+ Outside React, `getTimedMetadata()` reads the same value.
114
+
115
+ ## Track metadata: the track's static fields
116
+
117
+ [`onTrackMetadata`](/api/features/metadata/#ontrackmetadata) delivers a
118
+ track's static metadata. What it carries depends on the platform:
119
+
120
+ - **iOS** reads the file's own tags (ID3 on an MP3, the metadata atoms in an
121
+ MP4/M4A) when the player loads the asset. It fires once, and only if the file
122
+ has tags.
123
+ - **Android** reports the player's merged metadata. The Track's own fields
124
+ (`title`, `subtitle` as `artist`, `album`, `description`, `genre`, artwork)
125
+ win over the file's tags. Once the [Now Playing](/guide/now-playing) line is
126
+ rendered, its title, artist and album replace them.
127
+
128
+ The event fires again whenever that merged view changes: a new now-playing
129
+ line, new artwork, or stream metadata that fills a field the Track leaves
130
+ empty.
131
+
132
+ So on Android, `title` and `artist` are what you or your formatter set, not the
133
+ file's. On iOS, use it for on-demand content (podcast episodes, audiobooks,
134
+ downloaded files) whose tags you didn't set yourself.
135
+
136
+ [`TrackMetadata`](/api/features/metadata/#trackmetadata) is richer than the
137
+ timed shape. **Every field is an optional `string`:**
138
+
139
+ | Field | Meaning |
140
+ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
141
+ | `title` | Track title. |
142
+ | `artist` | Track artist. |
143
+ | `albumTitle` | Album name. |
144
+ | `subtitle` | Secondary line. On Android, the now-playing artist line once it is rendered. |
145
+ | `description` | Long description / show notes. |
146
+ | `artworkUri` | Android only: the artwork URL the player publishes for the Track, not the file's embedded cover art. |
147
+ | `trackNumber` | Track number within the album. |
148
+ | `composer` | Composer credit. |
149
+ | `conductor` | Conductor credit. |
150
+ | `genre` | Genre. |
151
+ | `station` | Android only: the station name from a Shoutcast / Icecast stream's headers. |
152
+ | `mediaType` | Android only, usually unset: a Media3 `MEDIA_TYPE_*` constant, as a number string. |
153
+ | `creationDate` | iOS: the tag's date string (ID3 `TDRC`, the iTunes release date). Android: day and month only, as `DDMM` (or `DD` or `MM` alone), with no year. |
154
+ | `creationYear` | Creation year. On iOS, the first four characters of `creationDate` when there is no year tag. |
155
+
156
+ `compilation` and `url` are in the type but neither platform sets them. Neither
157
+ platform exposes a file's embedded cover art.
158
+
159
+ ```tsx
160
+ import { onTrackMetadata, type TrackMetadata } from 'react-native-audio-browser'
161
+
162
+ function FileInfo() {
163
+ const [meta, setMeta] = useState<TrackMetadata>()
164
+ useEffect(() => onTrackMetadata.addListener(setMeta), [])
165
+ if (!meta) return null
166
+ return (
167
+ <>
168
+ <Text>
169
+ {meta.title} — {meta.artist}
170
+ </Text>
171
+ <Text>{meta.description}</Text>
172
+ </>
173
+ )
174
+ }
175
+ ```
176
+
177
+ ::: tip Mind the field names
178
+ Two traps when moving between the streams:
179
+
180
+ - **title vs title:** `TimedMetadata.title` is the _song_ (changes during a live
181
+ stream). `TrackMetadata.title` is the _file's_ title on iOS, and on Android
182
+ the Track's title or the now-playing title.
183
+ - **album vs albumTitle:** timed metadata uses `album`; track metadata uses
184
+ `albumTitle`. Neither carries the file's cover art. `TimedMetadata` has no
185
+ artwork field, and `TrackMetadata.artworkUri` is the Track's artwork as
186
+ Android publishes it.
187
+ :::
188
+
189
+ ## Chapter metadata: podcast & audiobook chapters
190
+
191
+ [`onChapterMetadata`](/api/features/metadata/#onchaptermetadata) delivers the
192
+ full list of chapters for the current track as a
193
+ [`ChapterMetadata[]`](/api/features/metadata/#chaptermetadata):
194
+
195
+ | Field | Type | Meaning |
196
+ | ----------- | --------- | ------------------------------------------------------------------------------- |
197
+ | `startTime` | `number` | Chapter start, in **seconds**. |
198
+ | `endTime` | `number` | Chapter end, in **seconds**. |
199
+ | `title` | `string?` | Chapter title. Android falls back to the chapter's element ID (such as `chp0`). |
200
+ | `url` | `string?` | Android only: the chapter's URL link, if present. |
201
+
202
+ Because Android fills an untitled chapter with its element ID, the
203
+ `item.title ?? 'Chapter'` fallback below applies only on iOS.
204
+
205
+ Because `startTime` is in seconds, it drops straight into
206
+ [`seekTo`](/guide/playback#seeking) to make a tappable chapter list:
207
+
208
+ ```tsx
209
+ import {
210
+ onChapterMetadata,
211
+ seekTo,
212
+ type ChapterMetadata
213
+ } from 'react-native-audio-browser'
214
+
215
+ function ChapterList() {
216
+ const [chapters, setChapters] = useState<ChapterMetadata[]>([])
217
+ useEffect(() => onChapterMetadata.addListener(setChapters), [])
218
+
219
+ return (
220
+ <FlatList
221
+ data={chapters}
222
+ keyExtractor={(chapter) => String(chapter.startTime)}
223
+ renderItem={({ item }) => (
224
+ <Button
225
+ title={item.title ?? 'Chapter'}
226
+ onPress={() => seekTo(item.startTime)}
227
+ />
228
+ )}
229
+ />
230
+ )
231
+ }
232
+ ```
233
+
234
+ ## Which metadata is which
235
+
236
+ | | `onTimedMetadata` | `onTrackMetadata` | `onChapterMetadata` |
237
+ | ----------- | -------------------------------------------------------------------------- | ------------------------------------------------------------- | --------------------------- |
238
+ | Source | Live stream (ICY / ID3); on iOS also a file's tags | iOS: the file's tags. Android: the Track merged with the file | Chapter markers in the file |
239
+ | Changes | Throughout the track; on iOS also once on load for a file without chapters | iOS: once, on load. Android: whenever the merged view changes | Once, on load |
240
+ | Shape | One `TimedMetadata` | One `TrackMetadata` | A `ChapterMetadata[]` |
241
+ | Typical use | Live "now playing" song | Podcast/file info | Chapter navigation |
242
+ | Platform | iOS, Android | iOS, Android | iOS, Android |
243
+
244
+ ::: warning Not available on web
245
+ All three are iOS and Android only. On web they are subscribable but never
246
+ fire, so a listener sees nothing and
247
+ [`FormatNowPlayingParams.timedMetadata`](/api/features/player/#formatnowplayingparams)
248
+ stays `undefined`.
249
+
250
+ ICY is the hard case: the browser strips the interleaved metadata before the
251
+ player can reach it, and no API exposes it. In-band ID3 from HLS _is_ reachable
252
+ through the web player and simply isn't wired up yet — that part is tracked in
253
+ [#118](https://github.com/radio-garden/react-native-audio-browser/issues/118).
254
+ :::
255
+
256
+ ## Holding metadata in state
257
+
258
+ Track metadata and chapters come with no built-in hook, but each `addListener`
259
+ returns the cleanup function `useEffect` expects, so a reusable hook is a few
260
+ lines:
261
+
262
+ ```tsx
263
+ import {
264
+ onChapterMetadata,
265
+ type ChapterMetadata
266
+ } from 'react-native-audio-browser'
267
+
268
+ // Returns ChapterMetadata[] | undefined (undefined until the first event).
269
+ function useChapters(): ChapterMetadata[] | undefined {
270
+ const [chapters, setChapters] = useState<ChapterMetadata[]>()
271
+ useEffect(() => onChapterMetadata.addListener(setChapters), [])
272
+ return chapters
273
+ }
274
+ ```
275
+
276
+ The same pattern works for `onTrackMetadata`: swap the event and the state type.
277
+ A hook built this way stays `undefined` until the next event, so a screen that
278
+ mounts after the file loaded sees nothing.
279
+
280
+ ## API summary
281
+
282
+ | API | Delivers |
283
+ | ------------------- | -------------------------------------------------------------------------------------------- |
284
+ | `onTimedMetadata` | Live `TimedMetadata` (the streaming "now playing" song; on iOS also a file's tags, on load). |
285
+ | `onTrackMetadata` | `TrackMetadata` (iOS: the file's tags; Android: the Track merged with them). |
286
+ | `onChapterMetadata` | `ChapterMetadata[]` (chapter markers, times in seconds). |
287
+
288
+ All three are subscriptions: `addListener(cb)` returns an unsubscribe function.
289
+ `getTimedMetadata()` and `useTimedMetadata()` read the current timed metadata.