react-native-audio-browser 0.2.0-next.8 → 0.2.0-next.81

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 (1247) 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 +588 -441
  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 +84 -104
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  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 +93 -52
  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 +50 -33
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  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 +121 -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 +490 -581
  57. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  58. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -23
  59. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +107 -129
  60. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +97 -0
  61. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +49 -128
  62. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  63. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  64. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  65. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  66. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  67. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  68. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  70. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  71. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  72. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  73. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +736 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  90. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  91. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  92. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  93. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  94. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  95. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  96. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  97. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  98. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  99. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  100. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  101. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  102. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  103. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  104. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  105. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  106. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  107. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  108. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  109. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  110. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  111. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  112. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  113. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  114. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  115. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  116. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  117. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  118. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  119. package/android/src/main/res/values/strings.xml +25 -5
  120. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  121. package/android/src/test/java/androidx/media3/session/SessionViews.kt +10 -0
  122. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  123. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  124. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  125. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  126. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  127. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  128. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  129. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +322 -0
  130. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  131. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  132. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  133. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  134. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  135. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  136. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  137. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  138. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  139. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  140. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  141. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  142. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  143. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  144. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +43 -0
  145. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  146. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  147. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  148. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  149. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  150. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  151. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  152. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  153. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  154. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  155. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  156. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  157. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +372 -0
  158. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  159. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  160. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  161. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  162. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  163. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  164. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  165. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  166. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  167. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  168. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  169. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  170. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  171. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  172. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +478 -0
  173. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +221 -0
  174. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  176. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +379 -0
  178. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +199 -0
  179. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  180. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +34 -79
  181. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +236 -0
  182. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  183. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +188 -0
  184. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  185. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  186. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  187. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  188. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +308 -0
  189. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  190. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  191. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  192. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1000 -0
  193. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  194. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  195. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  196. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  197. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  198. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  199. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  200. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  201. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  202. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  203. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  204. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  205. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  206. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  207. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  208. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  209. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  210. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  211. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  212. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  213. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  214. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  215. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  216. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  217. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  218. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  219. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  220. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  221. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  222. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  223. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  224. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  225. package/android/src/test/resources/sonos/device_description.xml +78 -0
  226. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  227. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  228. package/ios/AVPlayerEngine.swift +363 -0
  229. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  230. package/ios/Browser/BrowseGate.swift +57 -0
  231. package/ios/Browser/BrowserConfig.swift +123 -104
  232. package/ios/Browser/BrowserError.swift +15 -0
  233. package/ios/Browser/BrowserManager.swift +153 -675
  234. package/ios/Browser/BrowserPathHelper.swift +54 -117
  235. package/ios/Browser/FavoriteSet.swift +43 -0
  236. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  237. package/ios/Browser/JsonModels.swift +244 -335
  238. package/ios/Browser/NavigationErrorState.swift +42 -0
  239. package/ios/Browser/PageResolver.swift +132 -0
  240. package/ios/Browser/RequestLayer.swift +185 -0
  241. package/ios/Browser/RequestPipeline.swift +295 -0
  242. package/ios/Browser/SearchDrillIn.swift +10 -16
  243. package/ios/Browser/SectionScope.swift +73 -26
  244. package/ios/Browser/SimpleRouter.swift +76 -154
  245. package/ios/Browser/StyleResolver.swift +41 -0
  246. package/ios/Browser/TabBarEntries.swift +8 -7
  247. package/ios/Browser/TrackIdTemplate.swift +29 -0
  248. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  249. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  250. package/ios/CarPlay/CarPlayController.swift +37 -1297
  251. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  252. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  253. package/ios/CarPlay/CarPlayNowPlayingManager.swift +130 -205
  254. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  255. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  256. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  257. package/ios/CarPlay/CarPlaySession+TabBar.swift +187 -0
  258. package/ios/CarPlay/CarPlaySession.swift +203 -0
  259. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  260. package/ios/CarPlay/IntentHandlers.swift +94 -0
  261. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  262. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +9 -16
  263. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  264. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  265. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  266. package/ios/CarPlay/SectionPresentation.swift +67 -0
  267. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  268. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  269. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  270. package/ios/Extension/CxxVectorConformances.swift +4 -16
  271. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  272. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  273. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  274. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  275. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  276. package/ios/Extension/SearchParams+Query.swift +28 -0
  277. package/ios/Extension/Section+Copying.swift +26 -0
  278. package/ios/Extension/String+IcyCharset.swift +21 -0
  279. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  280. package/ios/Extension/Track+AVPlayer.swift +1 -18
  281. package/ios/Extension/Track+Copying.swift +13 -21
  282. package/ios/Extension/Track+Identity.swift +20 -0
  283. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  284. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  285. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  286. package/ios/Extension/URLError+Connectivity.swift +15 -0
  287. package/ios/Extension/Variant+Artwork.swift +8 -22
  288. package/ios/Http/HttpClient.swift +73 -167
  289. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  290. package/ios/HybridAudioBrowser+Options.swift +116 -0
  291. package/ios/HybridAudioBrowser+Player.swift +347 -0
  292. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  293. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  294. package/ios/HybridAudioBrowser.swift +148 -1689
  295. package/ios/Model/NitroTypeStubs.swift +240 -32
  296. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  297. package/ios/Model/RemoteCommand.swift +6 -78
  298. package/ios/Model/TrackPlayerError.swift +12 -21
  299. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  300. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  301. package/ios/Observer/ItemObserver.swift +92 -0
  302. package/ios/Observer/PlayerObserver.swift +59 -0
  303. package/ios/Option/SessionCategories.swift +41 -92
  304. package/ios/PlaybackEvent.swift +4 -2
  305. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  306. package/ios/Player/AudioSessionController.swift +190 -0
  307. package/ios/Player/DeferredSeek.swift +73 -0
  308. package/ios/Player/ErrorStatus.swift +52 -0
  309. package/ios/Player/MediaLoader.swift +73 -98
  310. package/ios/Player/NowPlayingLines.swift +49 -0
  311. package/ios/Player/NowPlayingUpdater.swift +180 -105
  312. package/ios/Player/PersistedPlaybackState.swift +1 -2
  313. package/ios/Player/PlaybackFailure.swift +121 -0
  314. package/ios/Player/PlaybackPersistence.swift +72 -0
  315. package/ios/Player/PlaybackStateMachine.swift +11 -11
  316. package/ios/Player/PlaybackTimer.swift +11 -8
  317. package/ios/Player/Player.swift +1010 -0
  318. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  319. package/ios/Player/PlayerEngine.swift +109 -0
  320. package/ios/Player/PlayerStatusTypes.swift +1 -6
  321. package/ios/Player/QueueManager.swift +80 -98
  322. package/ios/Player/ReconnectPacer.swift +83 -0
  323. package/ios/Player/RetryLoop.swift +334 -0
  324. package/ios/Player/ShuffleOrder.swift +36 -43
  325. package/ios/Player/SilenceBudget.swift +78 -0
  326. package/ios/Player/SleepTimerManager.swift +25 -42
  327. package/ios/Player/VolumeFader.swift +20 -15
  328. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  329. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  330. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  331. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  332. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  333. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  334. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  335. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  336. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  337. package/ios/Tests/DeferredSeekTests.swift +76 -0
  338. package/ios/Tests/EmitterTests.swift +22 -39
  339. package/ios/Tests/ErrorStatusTests.swift +50 -0
  340. package/ios/Tests/FavoriteSetTests.swift +61 -0
  341. package/ios/Tests/GenerationMemoTests.swift +178 -0
  342. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  343. package/ios/Tests/JsonModelsTests.swift +189 -3
  344. package/ios/Tests/LRUCacheTests.swift +106 -0
  345. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  346. package/ios/Tests/MediaLoaderTests.swift +38 -78
  347. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  348. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  349. package/ios/Tests/ObserverTests.swift +88 -0
  350. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  351. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  352. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  353. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  354. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  355. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  356. package/ios/Tests/PlayerPolicyTests.swift +991 -0
  357. package/ios/Tests/PlayerTests.swift +1719 -0
  358. package/ios/Tests/PlayingStateTests.swift +41 -0
  359. package/ios/Tests/QueueManagerTests.swift +205 -174
  360. package/ios/Tests/ReadyValueTests.swift +73 -0
  361. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  362. package/ios/Tests/RequestLayerTests.swift +228 -0
  363. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  364. package/ios/Tests/RetryCaseTests.swift +146 -0
  365. package/ios/Tests/RetryLoopTests.swift +307 -0
  366. package/ios/Tests/SearchDrillInTests.swift +16 -17
  367. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  368. package/ios/Tests/SectionPresentationTests.swift +85 -0
  369. package/ios/Tests/SectionScopeTests.swift +136 -54
  370. package/ios/Tests/SimpleRouterTests.swift +39 -8
  371. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  372. package/ios/Tests/StyleResolverTests.swift +123 -0
  373. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  374. package/ios/Tests/Support/TestTypes.swift +152 -100
  375. package/ios/Tests/Support/TimeLimit.swift +43 -0
  376. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  377. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  378. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  379. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  380. package/ios/Tests/TrackIdentityTests.swift +20 -0
  381. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  382. package/ios/Tests/TrackSelectorTests.swift +157 -34
  383. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  384. package/ios/TrackSelector.swift +62 -77
  385. package/ios/Util/ArtworkFreshness.swift +42 -0
  386. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  387. package/ios/Util/AwaitCallback.swift +80 -0
  388. package/ios/Util/ConcurrentMap.swift +19 -0
  389. package/ios/Util/Emitter.swift +45 -22
  390. package/ios/Util/GenerationMemo.swift +43 -0
  391. package/ios/Util/LRUCache.swift +23 -159
  392. package/ios/Util/NetworkMonitor.swift +31 -33
  393. package/ios/Util/OutputPicker.swift +48 -0
  394. package/ios/Util/ReadyValue.swift +57 -0
  395. package/ios/Util/SFSymbolRenderer.swift +64 -49
  396. package/ios/Util/SVGProcessor.swift +9 -16
  397. package/lib/commonjs/AudioBrowser.js +11 -0
  398. package/lib/commonjs/AudioBrowser.js.map +1 -1
  399. package/lib/commonjs/CLAUDE.md +57 -0
  400. package/lib/commonjs/features/battery.js +16 -12
  401. package/lib/commonjs/features/battery.js.map +1 -1
  402. package/lib/commonjs/features/browser-config.js +13 -9
  403. package/lib/commonjs/features/browser-config.js.map +1 -1
  404. package/lib/commonjs/features/browser.js +78 -20
  405. package/lib/commonjs/features/browser.js.map +1 -1
  406. package/lib/commonjs/features/carConnection.js +3 -4
  407. package/lib/commonjs/features/carConnection.js.map +1 -1
  408. package/lib/commonjs/features/equalizer.js +9 -5
  409. package/lib/commonjs/features/equalizer.js.map +1 -1
  410. package/lib/commonjs/features/errors.js +35 -21
  411. package/lib/commonjs/features/errors.js.map +1 -1
  412. package/lib/commonjs/features/favorites.js +28 -23
  413. package/lib/commonjs/features/favorites.js.map +1 -1
  414. package/lib/commonjs/features/gate.js +27 -6
  415. package/lib/commonjs/features/gate.js.map +1 -1
  416. package/lib/commonjs/features/metadata.js +61 -11
  417. package/lib/commonjs/features/metadata.js.map +1 -1
  418. package/lib/commonjs/features/network.js +5 -1
  419. package/lib/commonjs/features/network.js.map +1 -1
  420. package/lib/commonjs/features/nowPlaying.js +28 -14
  421. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  422. package/lib/commonjs/features/output.js +9 -4
  423. package/lib/commonjs/features/output.js.map +1 -1
  424. package/lib/commonjs/features/playback/controls.js +13 -6
  425. package/lib/commonjs/features/playback/controls.js.map +1 -1
  426. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  427. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  428. package/lib/commonjs/features/playback/playing.js +5 -3
  429. package/lib/commonjs/features/playback/playing.js.map +1 -1
  430. package/lib/commonjs/features/playback/progress.js +13 -6
  431. package/lib/commonjs/features/playback/progress.js.map +1 -1
  432. package/lib/commonjs/features/playback/rate.js +8 -1
  433. package/lib/commonjs/features/playback/rate.js.map +1 -1
  434. package/lib/commonjs/features/playback/state.js +5 -6
  435. package/lib/commonjs/features/playback/state.js.map +1 -1
  436. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  437. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  438. package/lib/commonjs/features/playback/volume.js +6 -5
  439. package/lib/commonjs/features/playback/volume.js.map +1 -1
  440. package/lib/commonjs/features/player/options.js +21 -11
  441. package/lib/commonjs/features/player/options.js.map +1 -1
  442. package/lib/commonjs/features/player/setup.js +39 -39
  443. package/lib/commonjs/features/player/setup.js.map +1 -1
  444. package/lib/commonjs/features/player/validateOptions.js +3 -4
  445. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  446. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  447. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  448. package/lib/commonjs/features/queue/queue.js +56 -21
  449. package/lib/commonjs/features/queue/queue.js.map +1 -1
  450. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  451. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  452. package/lib/commonjs/features/queue/shuffle.js +0 -1
  453. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  454. package/lib/commonjs/features/remoteControls.js +59 -35
  455. package/lib/commonjs/features/remoteControls.js.map +1 -1
  456. package/lib/commonjs/features/sleepTimer.js +23 -6
  457. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  458. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  459. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  460. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  461. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  462. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  463. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  464. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  465. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  466. package/lib/commonjs/utils/useDebug.js +16 -3
  467. package/lib/commonjs/utils/useDebug.js.map +1 -1
  468. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  469. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  470. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  471. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  472. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  473. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  474. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  475. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  476. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  477. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  478. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  479. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  480. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  481. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  482. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  483. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  484. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  485. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  486. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  487. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  488. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  489. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  490. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  491. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  492. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  493. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  494. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  495. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  496. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  497. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  498. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  499. package/lib/commonjs/web/browser/sections.js +89 -0
  500. package/lib/commonjs/web/browser/sections.js.map +1 -0
  501. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  502. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  503. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  504. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  505. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  506. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  507. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  508. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  509. package/lib/module/AudioBrowser.js +2 -4
  510. package/lib/module/AudioBrowser.js.map +1 -1
  511. package/lib/module/CLAUDE.md +57 -0
  512. package/lib/module/features/battery.js +16 -12
  513. package/lib/module/features/battery.js.map +1 -1
  514. package/lib/module/features/browser-config.js +13 -9
  515. package/lib/module/features/browser-config.js.map +1 -1
  516. package/lib/module/features/browser.js +78 -20
  517. package/lib/module/features/browser.js.map +1 -1
  518. package/lib/module/features/carConnection.js +3 -4
  519. package/lib/module/features/carConnection.js.map +1 -1
  520. package/lib/module/features/equalizer.js +9 -5
  521. package/lib/module/features/equalizer.js.map +1 -1
  522. package/lib/module/features/errors.js +35 -21
  523. package/lib/module/features/errors.js.map +1 -1
  524. package/lib/module/features/favorites.js +28 -23
  525. package/lib/module/features/favorites.js.map +1 -1
  526. package/lib/module/features/gate.js +27 -6
  527. package/lib/module/features/gate.js.map +1 -1
  528. package/lib/module/features/metadata.js +59 -11
  529. package/lib/module/features/metadata.js.map +1 -1
  530. package/lib/module/features/network.js +5 -1
  531. package/lib/module/features/network.js.map +1 -1
  532. package/lib/module/features/nowPlaying.js +28 -14
  533. package/lib/module/features/nowPlaying.js.map +1 -1
  534. package/lib/module/features/output.js +9 -4
  535. package/lib/module/features/output.js.map +1 -1
  536. package/lib/module/features/playback/controls.js +13 -6
  537. package/lib/module/features/playback/controls.js.map +1 -1
  538. package/lib/module/features/playback/playWhenReady.js +6 -5
  539. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  540. package/lib/module/features/playback/playing.js +5 -3
  541. package/lib/module/features/playback/playing.js.map +1 -1
  542. package/lib/module/features/playback/progress.js +13 -6
  543. package/lib/module/features/playback/progress.js.map +1 -1
  544. package/lib/module/features/playback/rate.js +8 -1
  545. package/lib/module/features/playback/rate.js.map +1 -1
  546. package/lib/module/features/playback/state.js +5 -6
  547. package/lib/module/features/playback/state.js.map +1 -1
  548. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  549. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  550. package/lib/module/features/playback/volume.js +6 -5
  551. package/lib/module/features/playback/volume.js.map +1 -1
  552. package/lib/module/features/player/options.js +21 -11
  553. package/lib/module/features/player/options.js.map +1 -1
  554. package/lib/module/features/player/setup.js +39 -39
  555. package/lib/module/features/player/setup.js.map +1 -1
  556. package/lib/module/features/player/validateOptions.js +3 -4
  557. package/lib/module/features/player/validateOptions.js.map +1 -1
  558. package/lib/module/features/queue/activeTrack.js +14 -4
  559. package/lib/module/features/queue/activeTrack.js.map +1 -1
  560. package/lib/module/features/queue/queue.js +56 -21
  561. package/lib/module/features/queue/queue.js.map +1 -1
  562. package/lib/module/features/queue/repeatMode.js +2 -1
  563. package/lib/module/features/queue/repeatMode.js.map +1 -1
  564. package/lib/module/features/queue/shuffle.js +0 -1
  565. package/lib/module/features/queue/shuffle.js.map +1 -1
  566. package/lib/module/features/remoteControls.js +59 -35
  567. package/lib/module/features/remoteControls.js.map +1 -1
  568. package/lib/module/features/sleepTimer.js +24 -7
  569. package/lib/module/features/sleepTimer.js.map +1 -1
  570. package/lib/module/test-utils/reactNativeStub.js +58 -0
  571. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  572. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  573. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  574. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  575. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  576. package/lib/module/utils/getTrackIdentity.js +22 -0
  577. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  578. package/lib/module/utils/useDebug.js +16 -3
  579. package/lib/module/utils/useDebug.js.map +1 -1
  580. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  581. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  582. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  583. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  584. package/lib/module/web/NativeAudioBrowser.js +207 -84
  585. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  586. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  587. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  588. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  589. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  590. package/lib/module/web/TrackPlayer/Player.js +256 -40
  591. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  592. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  593. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  594. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  595. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  596. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  597. package/lib/module/web/browser/BrowserManager.js +175 -100
  598. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  599. package/lib/module/web/browser/FavoriteManager.js +31 -21
  600. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  601. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  602. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  603. package/lib/module/web/browser/SearchManager.js +18 -23
  604. package/lib/module/web/browser/SearchManager.js.map +1 -1
  605. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  606. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  607. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  608. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  609. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  610. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  611. package/lib/module/web/browser/sections.js +83 -0
  612. package/lib/module/web/browser/sections.js.map +1 -0
  613. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  614. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  615. package/lib/module/web/http/followMediaRedirect.js +215 -0
  616. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  617. package/lib/module/web/player/NowPlayingManager.js +4 -3
  618. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  619. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  620. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  621. package/lib/typescript/package.json +1 -0
  622. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  623. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  624. package/lib/typescript/src/features/battery.d.ts +17 -12
  625. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  626. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  627. package/lib/typescript/src/features/browser.d.ts +67 -19
  628. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  629. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  630. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  631. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  632. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  633. package/lib/typescript/src/features/errors.d.ts +37 -22
  634. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  635. package/lib/typescript/src/features/favorites.d.ts +28 -23
  636. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  637. package/lib/typescript/src/features/gate.d.ts +29 -8
  638. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  639. package/lib/typescript/src/features/metadata.d.ts +65 -14
  640. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  641. package/lib/typescript/src/features/network.d.ts +5 -1
  642. package/lib/typescript/src/features/network.d.ts.map +1 -1
  643. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  644. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  645. package/lib/typescript/src/features/output.d.ts +9 -4
  646. package/lib/typescript/src/features/output.d.ts.map +1 -1
  647. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  648. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  649. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  650. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  651. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  652. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  653. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  654. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  655. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  656. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  657. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  658. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  659. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  660. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  661. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  662. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  663. package/lib/typescript/src/features/player/options.d.ts +73 -56
  664. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  665. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  666. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  667. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  668. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  669. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  670. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  671. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  672. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  673. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  674. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  675. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  676. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  677. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  678. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  679. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  680. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  681. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  682. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  683. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  684. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  685. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  686. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  687. package/lib/typescript/src/types/browser.d.ts +242 -173
  688. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  689. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  690. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  691. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  692. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  693. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  694. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  695. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  696. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  697. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  698. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  699. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  700. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  701. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  702. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  703. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  704. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  705. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  707. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  710. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  711. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  712. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  713. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  717. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  718. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  720. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  721. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  722. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  723. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  724. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  725. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  726. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  727. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  728. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  731. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  732. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  733. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  734. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  735. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  737. 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
  738. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  739. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  741. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  742. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  743. 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
  744. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  749. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  752. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  753. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  755. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  756. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  757. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  765. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  773. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  774. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  777. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  778. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  783. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  785. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  786. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  791. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  794. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  797. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  800. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  802. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  803. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  804. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  805. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  808. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  810. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  811. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  814. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  815. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  816. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  818. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  825. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  826. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  830. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  832. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  833. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  838. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  840. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  841. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  842. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  844. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  845. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  846. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  847. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  848. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  850. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  851. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  852. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  853. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  854. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  855. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  856. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  857. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  858. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  859. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  860. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  861. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  862. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  863. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  883. 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
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  890. 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
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  893. 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
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  896. 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
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1002. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1003. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1004. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1005. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1006. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1007. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1008. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1009. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1010. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1011. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1012. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1013. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1014. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1015. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1016. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1017. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1018. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1019. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1020. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1021. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1022. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1023. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1024. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1025. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1026. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1027. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1028. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1029. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1030. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1031. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1032. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1033. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1034. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1035. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1036. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1037. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1038. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1039. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1040. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1041. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1042. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1043. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1044. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1045. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1046. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1047. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1048. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1049. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1050. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1051. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1052. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1053. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1054. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1055. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1056. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1057. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1058. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1059. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1060. package/package.json +26 -13
  1061. package/src/AudioBrowser.ts +2 -4
  1062. package/src/CLAUDE.md +57 -0
  1063. package/src/docs-floors.test.ts +71 -0
  1064. package/src/features/battery.test.ts +79 -0
  1065. package/src/features/battery.ts +17 -13
  1066. package/src/features/browser-config.test.ts +21 -6
  1067. package/src/features/browser-config.ts +13 -9
  1068. package/src/features/browser.test.ts +1 -1
  1069. package/src/features/browser.ts +69 -20
  1070. package/src/features/carConnection.ts +3 -4
  1071. package/src/features/equalizer.ts +9 -5
  1072. package/src/features/errors.ts +37 -22
  1073. package/src/features/favorites.ts +28 -23
  1074. package/src/features/gate.ts +29 -8
  1075. package/src/features/hook-wiring.test.ts +302 -0
  1076. package/src/features/metadata.ts +80 -14
  1077. package/src/features/network.ts +5 -1
  1078. package/src/features/nowPlaying.ts +28 -14
  1079. package/src/features/output.ts +9 -4
  1080. package/src/features/playback/controls.ts +13 -6
  1081. package/src/features/playback/playWhenReady.ts +6 -5
  1082. package/src/features/playback/playing.ts +16 -3
  1083. package/src/features/playback/progress.test.ts +169 -0
  1084. package/src/features/playback/progress.ts +13 -6
  1085. package/src/features/playback/rate.ts +8 -1
  1086. package/src/features/playback/state.ts +10 -6
  1087. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1088. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1089. package/src/features/playback/volume.ts +6 -5
  1090. package/src/features/player/options.ts +82 -63
  1091. package/src/features/player/setup.test.ts +12 -3
  1092. package/src/features/player/setup.ts +122 -63
  1093. package/src/features/player/validateOptions.ts +3 -4
  1094. package/src/features/queue/activeTrack.ts +14 -4
  1095. package/src/features/queue/queue.ts +56 -21
  1096. package/src/features/queue/repeatMode.ts +1 -1
  1097. package/src/features/queue/shuffle.ts +0 -1
  1098. package/src/features/remoteControls.ts +59 -35
  1099. package/src/features/sleepTimer.test.ts +171 -0
  1100. package/src/features/sleepTimer.ts +24 -8
  1101. package/src/nitro-stub-drift.test.ts +277 -0
  1102. package/src/public-surface.test.ts +56 -25
  1103. package/src/specs/audio-browser.nitro.ts +15 -8
  1104. package/src/style-resolution.test.ts +210 -0
  1105. package/src/test-utils/reactNativeStub.ts +60 -0
  1106. package/src/types/browser-native.ts +7 -3
  1107. package/src/types/browser-nodes.ts +417 -151
  1108. package/src/types/browser.ts +248 -177
  1109. package/src/utils/LazyNativeEmitter.ts +17 -10
  1110. package/src/utils/NativeUpdatedValue.ts +30 -16
  1111. package/src/utils/getTrackIdentity.ts +22 -0
  1112. package/src/utils/useDebug.test.ts +182 -0
  1113. package/src/utils/useDebug.ts +16 -3
  1114. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1115. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1116. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1117. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1118. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1119. package/src/web/NativeAudioBrowser.ts +247 -92
  1120. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1121. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1122. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1123. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1124. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1125. package/src/web/TrackPlayer/Player.ts +286 -38
  1126. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1127. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1128. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1129. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1130. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1131. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1132. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1133. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1134. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1135. package/src/web/__tests__/retry.test.ts +169 -0
  1136. package/src/web/browser/BrowserManager.ts +209 -111
  1137. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1138. package/src/web/browser/FavoriteManager.ts +28 -23
  1139. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1140. package/src/web/browser/SearchManager.test.ts +75 -0
  1141. package/src/web/browser/SearchManager.ts +25 -28
  1142. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1143. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1144. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1145. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1146. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1147. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1148. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1149. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1150. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1151. package/src/web/browser/parseSearchResponse.ts +3 -4
  1152. package/src/web/browser/sections.test.ts +91 -0
  1153. package/src/web/browser/sections.ts +72 -0
  1154. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1155. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1156. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1157. package/src/web/http/followMediaRedirect.ts +253 -0
  1158. package/src/web/player/NowPlayingManager.ts +4 -3
  1159. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1160. package/src/web/util/BrowserPathHelper.ts +68 -13
  1161. package/website/guide/android-auto.md +126 -0
  1162. package/website/guide/android-certificates.md +488 -0
  1163. package/website/guide/artwork.md +300 -0
  1164. package/website/guide/audio-output.md +357 -0
  1165. package/website/guide/automotive.md +91 -0
  1166. package/website/guide/basic-usage.md +154 -0
  1167. package/website/guide/battery.md +142 -0
  1168. package/website/guide/browser.md +674 -0
  1169. package/website/guide/carplay.md +733 -0
  1170. package/website/guide/configuration.md +215 -0
  1171. package/website/guide/equalizer.md +235 -0
  1172. package/website/guide/errors.md +355 -0
  1173. package/website/guide/favorites.md +164 -0
  1174. package/website/guide/gate.md +157 -0
  1175. package/website/guide/getting-started.md +99 -0
  1176. package/website/guide/hooks.md +247 -0
  1177. package/website/guide/live-streams.md +156 -0
  1178. package/website/guide/metadata.md +289 -0
  1179. package/website/guide/migrating-from-track-player.md +289 -0
  1180. package/website/guide/native-callback-fetch.md +137 -0
  1181. package/website/guide/network.md +102 -0
  1182. package/website/guide/now-playing.md +203 -0
  1183. package/website/guide/playback.md +405 -0
  1184. package/website/guide/queue.md +334 -0
  1185. package/website/guide/remote-controls.md +314 -0
  1186. package/website/guide/search.md +270 -0
  1187. package/website/guide/sleep-timer.md +289 -0
  1188. package/website/guide/track.md +271 -0
  1189. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1190. package/ios/Bridge.h +0 -8
  1191. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1192. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1193. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1194. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1195. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1196. package/ios/Model/MediaURL.swift +0 -67
  1197. package/ios/Model/SourceType.swift +0 -6
  1198. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1199. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1200. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1201. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1202. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1203. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1204. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1205. package/ios/Option/PitchAlgorithms.swift +0 -17
  1206. package/ios/Option/TimeEventFrequency.swift +0 -18
  1207. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1208. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1209. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1210. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1211. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1212. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1213. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1214. package/ios/Player/PlaybackStateStore.swift +0 -27
  1215. package/ios/Player/PlayingStateManager.swift +0 -33
  1216. package/ios/Player/RetryManager.swift +0 -323
  1217. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1218. package/ios/Player/SleepTimerHandling.swift +0 -15
  1219. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1220. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1221. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1222. package/ios/Tests/MediaResolveTests.swift +0 -126
  1223. package/ios/Tests/OnceValueTests.swift +0 -79
  1224. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1225. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1226. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1227. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1228. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1229. package/ios/Tests/RetryManagerTests.swift +0 -89
  1230. package/ios/TrackPlayer.swift +0 -1014
  1231. package/ios/TrackPlayerCallbacks.swift +0 -53
  1232. package/ios/Util/MetadataAdapter.swift +0 -131
  1233. package/ios/Util/OnceValue.swift +0 -104
  1234. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1235. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1236. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1237. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1238. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1239. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1240. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1241. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1242. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1243. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1244. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1245. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1246. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1247. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -0,0 +1,302 @@
1
+ /** @vitest-environment happy-dom */
2
+
3
+ import { renderHook, act, cleanup } from '@testing-library/react'
4
+ import { describe, it, expect, afterEach, vi } from 'vitest'
5
+
6
+ /**
7
+ * The hooks that are a single delegation to `useNativeUpdatedValue`. Their
8
+ * behaviour is covered once in `utils/useNativeUpdatedValue.test.ts`; what is
9
+ * per-hook and untestable there is the wiring — which native callback slot the
10
+ * emitter claims, and which `eventKey` is pulled out of the payload.
11
+ * (`useActiveTrack` and `useQueue` are getter-refreshed instead — they update
12
+ * on transitions AND favorite toggles — and are covered in their own block.)
13
+ *
14
+ * Both are easy to get wrong and silent when wrong: the hook simply never
15
+ * updates, or yields the whole event where a field was meant. Five slots
16
+ * already differ in name from the emitter that claims them
17
+ * (`onPlaybackPlayWhenReadyChanged` behind `onPlayWhenReadyChanged`, and
18
+ * friends), so the names cannot be derived — they have to be pinned.
19
+ */
20
+ const slots = vi.hoisted(() => new Map<string, (event: unknown) => void>())
21
+
22
+ vi.mock('../native', () => ({
23
+ nativeBrowser: new Proxy({} as Record<string, unknown>, {
24
+ get(target, prop: string) {
25
+ // Getters are the pre-native fallback; undefined stands in for "native
26
+ // has not answered yet", which is what these tests start from.
27
+ target[prop] ??= vi.fn(() => undefined)
28
+ return target[prop]
29
+ },
30
+ set(target, prop: string, value) {
31
+ if (typeof value === 'function') slots.set(prop, value)
32
+ target[prop] = value
33
+ return true
34
+ }
35
+ })
36
+ }))
37
+
38
+ const { useBatteryOptimizationStatus, useBatteryWarningPending } =
39
+ await import('./battery')
40
+ const { useContent, usePath, useTabs } = await import('./browser')
41
+ const { useCarConnected } = await import('./carConnection')
42
+ const { useEqualizerSettings } = await import('./equalizer')
43
+ const { useFormattedNavigationError, useNavigationError, usePlaybackError } =
44
+ await import('./errors')
45
+ const { useOnline } = await import('./network')
46
+ const { useTimedMetadata } = await import('./metadata')
47
+ const { useNowPlaying } = await import('./nowPlaying')
48
+ const { useOutput } = await import('./output')
49
+ const { useOptions } = await import('./player/options')
50
+ const { usePlayingState } = await import('./playback/playing')
51
+ const { usePlayWhenReady } = await import('./playback/playWhenReady')
52
+ const { useProgress } = await import('./playback/progress')
53
+ const { usePlayback } = await import('./playback/state')
54
+ const { useSystemVolume } = await import('./playback/volume')
55
+ const { useActiveTrack } = await import('./queue/activeTrack')
56
+ const { useQueue } = await import('./queue/queue')
57
+ const { useRepeatMode } = await import('./queue/repeatMode')
58
+ const { useShuffle } = await import('./queue/shuffle')
59
+
60
+ afterEach(cleanup)
61
+
62
+ type Wiring = {
63
+ name: string
64
+ hook: () => unknown
65
+ /** The property on the Nitro object the emitter assigns its callback to. */
66
+ slot: string
67
+ event: unknown
68
+ /** What the hook returns — differs from `event` exactly when an eventKey applies. */
69
+ expected: unknown
70
+ }
71
+
72
+ const wirings: Wiring[] = [
73
+ // Payload passed through whole (no eventKey).
74
+ {
75
+ name: 'useOutput',
76
+ hook: useOutput,
77
+ slot: 'onOutputChanged',
78
+ event: { type: 'bluetooth' },
79
+ expected: { type: 'bluetooth' }
80
+ },
81
+ {
82
+ name: 'useNowPlaying',
83
+ hook: useNowPlaying,
84
+ slot: 'onNowPlayingChanged',
85
+ event: { title: 'Song' },
86
+ expected: { title: 'Song' }
87
+ },
88
+ {
89
+ name: 'useOnline',
90
+ hook: useOnline,
91
+ slot: 'onOnlineChanged',
92
+ event: true,
93
+ expected: true
94
+ },
95
+ {
96
+ name: 'useCarConnected',
97
+ hook: useCarConnected,
98
+ slot: 'onCarConnectedChanged',
99
+ event: true,
100
+ expected: true
101
+ },
102
+ {
103
+ name: 'useEqualizerSettings',
104
+ hook: useEqualizerSettings,
105
+ slot: 'onEqualizerChanged',
106
+ event: { enabled: true },
107
+ expected: { enabled: true }
108
+ },
109
+ {
110
+ name: 'usePath',
111
+ hook: usePath,
112
+ slot: 'onPathChanged',
113
+ event: '/artists/1',
114
+ expected: '/artists/1'
115
+ },
116
+ {
117
+ name: 'useContent',
118
+ hook: useContent,
119
+ slot: 'onContentChanged',
120
+ event: { src: 'a' },
121
+ expected: { src: 'a' }
122
+ },
123
+ {
124
+ name: 'useTabs',
125
+ hook: useTabs,
126
+ slot: 'onTabsChanged',
127
+ event: [{ src: 'a' }],
128
+ expected: [{ src: 'a' }]
129
+ },
130
+ {
131
+ name: 'usePlayback',
132
+ hook: usePlayback,
133
+ slot: 'onPlaybackChanged',
134
+ event: { state: 'playing' },
135
+ expected: { state: 'playing' }
136
+ },
137
+ {
138
+ name: 'useSystemVolume',
139
+ hook: useSystemVolume,
140
+ slot: 'onSystemVolumeChanged',
141
+ event: 0.4,
142
+ expected: 0.4
143
+ },
144
+ {
145
+ name: 'useProgress',
146
+ hook: useProgress,
147
+ slot: 'onPlaybackProgressUpdated',
148
+ event: { position: 1, duration: 2, buffered: 3 },
149
+ expected: { position: 1, duration: 2, buffered: 3 }
150
+ },
151
+ {
152
+ name: 'usePlayingState',
153
+ hook: usePlayingState,
154
+ slot: 'onPlaybackPlayingState',
155
+ event: { state: 'ready' },
156
+ expected: { state: 'ready' }
157
+ },
158
+ {
159
+ name: 'useShuffle',
160
+ hook: useShuffle,
161
+ slot: 'onPlaybackShuffleModeChanged',
162
+ event: true,
163
+ expected: true
164
+ },
165
+ {
166
+ name: 'useFormattedNavigationError',
167
+ hook: useFormattedNavigationError,
168
+ slot: 'onFormattedNavigationError',
169
+ event: { title: 'Offline' },
170
+ expected: { title: 'Offline' }
171
+ },
172
+ {
173
+ name: 'useOptions',
174
+ hook: useOptions,
175
+ slot: 'onOptionsChanged',
176
+ event: { playbackSpeed: 1.5 },
177
+ expected: { playbackSpeed: 1.5 }
178
+ },
179
+
180
+ // A field lifted out of the payload — the eventKey cases.
181
+ {
182
+ name: 'usePlaybackError',
183
+ hook: usePlaybackError,
184
+ slot: 'onPlaybackError',
185
+ event: { error: { code: 'network' } },
186
+ expected: { code: 'network' }
187
+ },
188
+ {
189
+ name: 'useNavigationError',
190
+ hook: useNavigationError,
191
+ slot: 'onNavigationError',
192
+ event: { error: { code: 'notFound' } },
193
+ expected: { code: 'notFound' }
194
+ },
195
+ {
196
+ name: 'usePlayWhenReady',
197
+ hook: usePlayWhenReady,
198
+ slot: 'onPlaybackPlayWhenReadyChanged',
199
+ event: { playWhenReady: true },
200
+ expected: true
201
+ },
202
+ {
203
+ name: 'useRepeatMode',
204
+ hook: useRepeatMode,
205
+ slot: 'onPlaybackRepeatModeChanged',
206
+ event: { repeatMode: 'queue' },
207
+ expected: 'queue'
208
+ },
209
+ {
210
+ name: 'useBatteryWarningPending',
211
+ hook: useBatteryWarningPending,
212
+ slot: 'onBatteryWarningPendingChanged',
213
+ event: { pending: true },
214
+ expected: true
215
+ },
216
+ {
217
+ name: 'useBatteryOptimizationStatus',
218
+ hook: useBatteryOptimizationStatus,
219
+ slot: 'onBatteryOptimizationStatusChanged',
220
+ event: { status: 'unrestricted' },
221
+ expected: 'unrestricted'
222
+ }
223
+ ]
224
+
225
+ describe.each(wirings)('$name', ({ hook, slot, event, expected }) => {
226
+ it(`reads $slot`, () => {
227
+ // A slot nothing claimed means the emitter assigns a different property
228
+ // than the one named here — the hook would never update in production.
229
+ expect(slots.has(slot)).toBe(true)
230
+
231
+ const { result } = renderHook(() => hook())
232
+ act(() => slots.get(slot)!(event))
233
+ expect(result.current).toEqual(expected)
234
+ })
235
+ })
236
+
237
+ describe('hook wiring table', () => {
238
+ it('covers every delegating hook exactly once', () => {
239
+ const names = wirings.map((w) => w.name)
240
+ expect(new Set(names).size).toBe(names.length)
241
+ expect(new Set(wirings.map((w) => w.slot)).size).toBe(wirings.length)
242
+ })
243
+ })
244
+
245
+ /**
246
+ * The getter-refreshed hooks re-read their native getter on each of two
247
+ * slots, because one of them changes the value without the other's event:
248
+ * a favorite toggle mutates the active track in place without a transition,
249
+ * and a track change clears timed metadata without a timed metadata event.
250
+ * Each slot gets an empty payload, so a hook that took the event instead of
251
+ * re-reading fails.
252
+ */
253
+ const { nativeBrowser } = await import('../native')
254
+
255
+ describe.each([
256
+ {
257
+ name: 'useActiveTrack',
258
+ hook: useActiveTrack,
259
+ getter: 'getActiveTrack',
260
+ slotsRead: ['onPlaybackActiveTrackChanged', 'onFavoriteChanged'],
261
+ reads: [
262
+ { src: 'a', favorited: false },
263
+ { src: 'a', favorited: true },
264
+ { src: 'a', favorited: false }
265
+ ]
266
+ },
267
+ {
268
+ name: 'useQueue',
269
+ hook: useQueue,
270
+ getter: 'getQueue',
271
+ slotsRead: ['onPlaybackQueueChanged', 'onFavoriteChanged'],
272
+ reads: [
273
+ [{ src: 'a', favorited: false }],
274
+ [{ src: 'a', favorited: true }],
275
+ [{ src: 'a', favorited: false }]
276
+ ]
277
+ },
278
+ {
279
+ name: 'useTimedMetadata',
280
+ hook: useTimedMetadata,
281
+ getter: 'getTimedMetadata',
282
+ slotsRead: ['onTimedMetadata', 'onPlaybackActiveTrackChanged'],
283
+ reads: [{ title: 'Song A' }, { title: 'Song B' }, undefined]
284
+ }
285
+ ])('$name (getter-refreshed)', ({ hook, getter, slotsRead, reads }) => {
286
+ it(`re-reads ${getter} on ${slotsRead.join(' and ')}`, () => {
287
+ const getterMock = (
288
+ nativeBrowser as unknown as Record<string, ReturnType<typeof vi.fn>>
289
+ )[getter]!
290
+
291
+ getterMock.mockReturnValue(reads[0])
292
+ const { result } = renderHook(() => hook())
293
+ expect(result.current).toEqual(reads[0])
294
+
295
+ slotsRead.forEach((slot, i) => {
296
+ expect(slots.has(slot)).toBe(true)
297
+ getterMock.mockReturnValue(reads[i + 1])
298
+ act(() => slots.get(slot)!({}))
299
+ expect(result.current).toEqual(reads[i + 1])
300
+ })
301
+ })
302
+ })
@@ -1,8 +1,11 @@
1
1
  import { nativeBrowser } from '../native'
2
2
  import { NativeUpdatedValue } from '../utils/NativeUpdatedValue'
3
+ import { useNativeValueRefreshedBy } from '../utils/useNativeValueRefreshedBy'
4
+ import { onActiveTrackChanged } from './queue/activeTrack'
3
5
 
4
6
  // MARK: - Types
5
7
 
8
+ /** The track fields {@link NowPlayingMetadata} carries. */
6
9
  export interface TrackMetadataBase {
7
10
  /** The track title */
8
11
  title?: string
@@ -16,20 +19,29 @@ export interface TrackMetadataBase {
16
19
  artwork?: string
17
20
  /** track description */
18
21
  description?: string
19
- /** track mediaId */
22
+ /**
23
+ * The track's `src`, or its `path` when it has none, on iOS and Android.
24
+ * On web, the track's Identity (`id` when set, else `src`), or its `path`:
25
+ * a track with an `id` reports different values on web and native.
26
+ */
20
27
  mediaId?: string
21
28
  /** The track genre */
22
29
  genre?: string
23
30
  }
24
31
 
25
32
  export interface NowPlayingMetadata extends TrackMetadataBase {
33
+ /**
34
+ * Playback position in seconds when this metadata was emitted or read, not
35
+ * a live value. iOS only; absent on Android and web. For a live position use
36
+ * `useProgress`.
37
+ */
26
38
  elapsedTime?: number
27
39
  }
28
40
 
29
41
  /**
30
42
  * Metadata update for the now playing notification.
31
- * Pass to `updateNowPlaying()` to override what's shown in the notification/lock screen.
32
- * Pass `null` to clear overrides and revert to track metadata.
43
+ * Pass to `updateNowPlaying()` to override what's shown in the
44
+ * notification/lock screen; pass it `null` to clear the override.
33
45
  */
34
46
  export type NowPlayingUpdate = {
35
47
  /** Title shown in notification */
@@ -45,8 +57,8 @@ export type NowPlayingUpdate = {
45
57
  }
46
58
 
47
59
  /**
48
- * Timed metadata received during playback.
49
- * Contains metadata from ICY streams (radio) or ID3 frames.
60
+ * Timed metadata received during playback: ICY (radio) or ID3 frames.
61
+ * On iOS, also a file's own tags, once on load, when the file has no chapters.
50
62
  */
51
63
  export interface TimedMetadata {
52
64
  title?: string
@@ -57,8 +69,9 @@ export interface TimedMetadata {
57
69
  }
58
70
 
59
71
  /**
60
- * Static track metadata from the media file.
61
- * Contains standardized metadata fields.
72
+ * Static track metadata. On iOS, the media file's own tags. On Android,
73
+ * Media3's merged metadata, where the Track's fields and the now-playing lines win over
74
+ * the file's tags. `compilation` and `url` are never set.
62
75
  */
63
76
  export interface TrackMetadata {
64
77
  title?: string
@@ -66,14 +79,24 @@ export interface TrackMetadata {
66
79
  albumTitle?: string
67
80
  subtitle?: string
68
81
  description?: string
82
+ /**
83
+ * Android only: the artwork URL published for the Track, not embedded
84
+ * cover art.
85
+ */
69
86
  artworkUri?: string
70
87
  trackNumber?: string
71
88
  composer?: string
72
89
  conductor?: string
73
90
  genre?: string
74
91
  compilation?: string
92
+ /** Android only: the station name from a Shoutcast / Icecast stream. */
75
93
  station?: string
94
+ /** Android only: a Media3 `MEDIA_TYPE_*` constant, as a number string. */
76
95
  mediaType?: string
96
+ /**
97
+ * iOS: the tag's date string. Android: day and month only, as `DDMM` (or
98
+ * `DD` or `MM`), no year.
99
+ */
77
100
  creationDate?: string
78
101
  creationYear?: string
79
102
  url?: string
@@ -88,17 +111,34 @@ export interface ChapterMetadata {
88
111
  startTime: number
89
112
  /** Chapter end time in seconds */
90
113
  endTime: number
91
- /** Chapter title */
114
+ /** Chapter title. Android falls back to the chapter's element ID. */
92
115
  title?: string
93
- /** URL associated with the chapter */
116
+ /** URL associated with the chapter. Android only. */
94
117
  url?: string
95
118
  }
96
119
 
120
+ // MARK: - Getters
121
+
122
+ /**
123
+ * Returns the last timed metadata received for the current track, or
124
+ * `undefined` when none has arrived since the track changed.
125
+ *
126
+ * @platform ios android
127
+ * Always `undefined` on web — see {@link onTimedMetadata} for why.
128
+ */
129
+ export function getTimedMetadata(): TimedMetadata | undefined {
130
+ return nativeBrowser.getTimedMetadata() ?? undefined
131
+ }
132
+
97
133
  // MARK: - Event Callbacks
98
134
 
99
135
  /**
100
136
  * Subscribes to chapter metadata events.
101
- * @param callback - Called when chapter metadata is received
137
+ *
138
+ * @platform ios android
139
+ * Never fires on web — the web player does not read chapter markers. See
140
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
141
+ *
102
142
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
103
143
  */
104
144
  export const onChapterMetadata = NativeUpdatedValue.emitterize<
@@ -106,8 +146,14 @@ export const onChapterMetadata = NativeUpdatedValue.emitterize<
106
146
  >((cb) => (nativeBrowser.onChapterMetadata = cb))
107
147
 
108
148
  /**
109
- * Subscribes to track metadata events.
110
- * @param callback - Called when static track metadata is received
149
+ * Subscribes to track metadata events. On iOS it fires once on load, when the
150
+ * file has tags. On Android it fires whenever the player's merged metadata
151
+ * changes.
152
+ *
153
+ * @platform ios android
154
+ * Never fires on web — the web player does not read embedded file tags. See
155
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
156
+ *
111
157
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
112
158
  */
113
159
  export const onTrackMetadata = NativeUpdatedValue.emitterize<TrackMetadata>(
@@ -115,10 +161,30 @@ export const onTrackMetadata = NativeUpdatedValue.emitterize<TrackMetadata>(
115
161
  )
116
162
 
117
163
  /**
118
- * Subscribes to timed metadata events (ICY/ID3 from live streams).
119
- * @param callback - Called when stream metadata is received (title, artist from ICY/ID3 tags)
164
+ * Subscribes to timed metadata events (ICY/ID3 from live streams). On iOS it
165
+ * also fires on load with a file's own tags when the file has no chapters.
166
+ *
167
+ * @platform ios android
168
+ * Never fires on web: the browser strips ICY metadata before the player sees
169
+ * it, and the web player does not read in-band ID3 from HLS. See
170
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
171
+ *
120
172
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
121
173
  */
122
174
  export const onTimedMetadata = NativeUpdatedValue.emitterize<TimedMetadata>(
123
175
  (cb) => (nativeBrowser.onTimedMetadata = cb)
124
176
  )
177
+
178
+ // MARK: - Hooks
179
+
180
+ // Module-level so the hook's subscription identity is stable across renders.
181
+ const timedMetadataInvalidators = [onTimedMetadata, onActiveTrackChanged]
182
+
183
+ /**
184
+ * Hook that returns the current timed metadata, updating when new timed
185
+ * metadata arrives and on a track change.
186
+ * @returns The current timed metadata or undefined
187
+ */
188
+ export function useTimedMetadata(): TimedMetadata | undefined {
189
+ return useNativeValueRefreshedBy(getTimedMetadata, timedMetadataInvalidators)
190
+ }
@@ -6,6 +6,8 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue'
6
6
 
7
7
  /**
8
8
  * Gets the current network connectivity state.
9
+ * On Android it reads `true` before `setupPlayer` has connected the player, and
10
+ * while its service restarts.
9
11
  * @returns true if the device is online, false otherwise
10
12
  */
11
13
  export function getOnline(): boolean {
@@ -16,7 +18,8 @@ export function getOnline(): boolean {
16
18
 
17
19
  /**
18
20
  * Subscribes to network connectivity changes.
19
- * @param callback - Called when network state changes
21
+ * On Android it fires nothing until `setupPlayer` has connected the player, and then
22
+ * fires once with the current state.
20
23
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
21
24
  */
22
25
  export const onOnlineChanged = NativeUpdatedValue.emitterize<boolean>(
@@ -27,6 +30,7 @@ export const onOnlineChanged = NativeUpdatedValue.emitterize<boolean>(
27
30
 
28
31
  /**
29
32
  * Hook that returns the current network connectivity state and updates when it changes.
33
+ * On Android it reads `true` until `setupPlayer` has connected the player.
30
34
  * @returns true if the device is online, false otherwise
31
35
  */
32
36
  export function useOnline(): boolean {
@@ -7,7 +7,11 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue'
7
7
 
8
8
  /**
9
9
  * Updates the now playing notification metadata.
10
- * Pass null/undefined to clear overrides and revert to track metadata.
10
+ *
11
+ * Lasts until you pass `null`, which clears it, or the active track changes. A `nowPlaying`
12
+ * formatter's fields win over it. With `nowPlaying: false` the iOS and
13
+ * Android surface ignores it, though `getNowPlaying` still reports it; web
14
+ * ignores `nowPlaying`.
11
15
  *
12
16
  * @example
13
17
  * ```ts
@@ -17,7 +21,7 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue'
17
21
  * artist: streamMetadata.artist,
18
22
  * })
19
23
  *
20
- * // Clear overrides, revert to track metadata
24
+ * // Clear the override
21
25
  * updateNowPlaying(null)
22
26
  * ```
23
27
  */
@@ -26,7 +30,10 @@ export function updateNowPlaying(update: NowPlayingUpdate | null): void {
26
30
  }
27
31
 
28
32
  /**
29
- * Gets the current now playing metadata (override if set, else track metadata).
33
+ * Returns what the now-playing surface shows: flash, formatter output,
34
+ * override or track fields, in that priority. `undefined` when there is no
35
+ * active track. With `nowPlaying: false`, it returns the flash, override or
36
+ * track fields, regardless of what the surface shows.
30
37
  */
31
38
  export function getNowPlaying(): NowPlayingMetadata | undefined {
32
39
  return nativeBrowser.getNowPlaying() ?? undefined
@@ -34,15 +41,19 @@ export function getNowPlaying(): NowPlayingMetadata | undefined {
34
41
 
35
42
  /**
36
43
  * Temporarily replaces now-playing fields for `durationMs`, then reverts to
37
- * the live metadata. The flash outranks the now-playing formatter and the
38
- * `updateNowPlaying` override while active (live metadata can't stomp it),
39
- * and the revert runs on a native timer — JS timers pause in a backgrounded
40
- * host (the lock screen case) — so it fires reliably. A track change clears
41
- * the flash early; repeated calls restart the window.
44
+ * the live metadata. While active it outranks the `nowPlaying` formatter
45
+ * ({@link features/player!FormatNowPlayingCallback | FormatNowPlayingCallback}) and the `updateNowPlaying` override.
46
+ * The revert runs on a native timer, so it fires while the app is
47
+ * backgrounded. A track change clears the flash early; repeated calls
48
+ * restart the window.
49
+ *
50
+ * On web the flash is a plain `updateNowPlaying` override on a JS timer. It
51
+ * replaces any override you set, the revert clears the override instead of
52
+ * restoring it, and a track change does not cancel the timer, so the revert
53
+ * can also clear an override set for the next track. With
54
+ * `nowPlaying: false`, Android ignores the flash; iOS still shows it.
42
55
  *
43
- * The feedback channel for refused remote commands: external surfaces have
44
- * no toast primitive, so a transient metadata swap is the only way to talk
45
- * to the user there.
56
+ * See the [Now playing guide](https://audiobrowser.dev/guide/now-playing#the-flash-transient-top-priority).
46
57
  *
47
58
  * @example
48
59
  * ```ts
@@ -62,7 +73,8 @@ export function flashNowPlaying(
62
73
 
63
74
  /**
64
75
  * Clears an active flash immediately, reverting to the live metadata.
65
- * No-op when no flash is active.
76
+ * No-op when no flash is active. On web it also clears the
77
+ * `updateNowPlaying` override.
66
78
  */
67
79
  export function clearNowPlayingFlash(): void {
68
80
  nativeBrowser.clearNowPlayingFlash()
@@ -72,8 +84,10 @@ export function clearNowPlayingFlash(): void {
72
84
 
73
85
  /**
74
86
  * Subscribes to now playing metadata change events.
75
- * Fires when updateNowPlaying is called or when the track changes.
76
- * @param callback - Called when now playing metadata changes
87
+ * Fires when the now-playing lines change: track change, `updateNowPlaying`,
88
+ * a flash starting or ending, or a new formatter result. On iOS and
89
+ * Android, an update that leaves the lines unchanged does not fire; on web
90
+ * every `updateNowPlaying` call, flash start and revert fires.
77
91
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
78
92
  */
79
93
  export const onNowPlayingChanged =
@@ -33,9 +33,12 @@ export function supportsOutputSwitcher(): boolean {
33
33
 
34
34
  /**
35
35
  * The current audio output, or `undefined` when unknown. iOS reports one while a
36
- * session is active; Android reports the active output route via AudioManager
37
- * (the `type` is coarse — e.g. wired headphones may report as `speaker`). Guard
38
- * for `undefined`.
36
+ * session is active. Android reports the device media is routed to, from
37
+ * AudioManager, or the remote output selected in the Output Switcher when
38
+ * `remoteOutputs` is on. On Android 13+ (API 33) the route is exact and follows
39
+ * manual reroutes. Below that it is picked from the connected devices and misses
40
+ * a reroute while a device stays connected.
41
+ * Guard for `undefined`.
39
42
  */
40
43
  export function getOutput(): Output | undefined {
41
44
  return nativeBrowser.getOutput()
@@ -45,7 +48,9 @@ export function getOutput(): Output | undefined {
45
48
 
46
49
  /**
47
50
  * Subscribes to current-output changes (headphones unplugged, Bluetooth speaker
48
- * connected, AirPlay/route selected). Fires on iOS and Android 11+; never below.
51
+ * connected, AirPlay/route selected). Fires on iOS and Android; never on web.
52
+ * On Android below 13 it cannot see a manual reroute between two connected
53
+ * devices.
49
54
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
50
55
  */
51
56
  export const onOutputChanged = NativeUpdatedValue.emitterize<Output>(
@@ -31,16 +31,20 @@ export function togglePlayback(): void {
31
31
  }
32
32
 
33
33
  /**
34
- * Stops playback and resets position to the beginning.
35
- * The track remains loaded and can be resumed with play().
36
- * For live streams, position is not reset.
34
+ * Stops playback. The track stays current, and play() starts it again.
35
+ * iOS rewinds a non-live track to the start; Android and web keep the
36
+ * position, so play() resumes where it stopped.
37
37
  */
38
38
  export function stop(): void {
39
39
  nativeBrowser.stop()
40
40
  }
41
41
 
42
42
  /**
43
- * Retries playing the current item when the playback state is `'error'`.
43
+ * Retries playing the current item. Meant for the `'error'` state, but not
44
+ * gated on it: on iOS it reloads the current item in any state, even while
45
+ * playing. On Android and web it reloads whenever the player is stopped or
46
+ * failed, without setting the play intent, so after stop() it loads the item
47
+ * but does not play it.
44
48
  *
45
49
  * @see {@link PlaybackState}
46
50
  * @see {@link usePlayback}
@@ -58,8 +62,11 @@ export function seekTo(position: number): void {
58
62
  }
59
63
 
60
64
  /**
61
- * Jump to the live edge of the current track. No-op for non-live tracks; for
62
- * live, seeks to the window end (HLS) or reconnects (non-seekable streams).
65
+ * Jump to the live edge of the current track; no-op unless the track
66
+ * declares `live: true`. A stream with a seekable live window (HLS) seeks
67
+ * to the window's edge; a non-seekable stream (e.g. ICY radio) reconnects
68
+ * to rejoin live. iOS re-runs `media.resolve` on the reconnect; Android
69
+ * reuses the resolved URL and re-resolves only after it fails to open.
63
70
  */
64
71
  export function seekToLiveEdge(): void {
65
72
  nativeBrowser.seekToLiveEdge()