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
@@ -5,7 +5,6 @@ import com.audiobrowser.util.EqualizerManager
5
5
  import com.margelo.nitro.audiobrowser.EqualizerSettings
6
6
  import timber.log.Timber
7
7
 
8
- /** The equalizer operations [EqualizerController] drives, so tests can stand in for the effect. */
9
8
  internal interface EqualizerEffect {
10
9
  val audioSessionId: Int
11
10
 
@@ -23,11 +22,10 @@ internal interface EqualizerEffect {
23
22
  }
24
23
 
25
24
  /**
26
- * Owns the equalizer's lifecycle across audio sessions. Android's Equalizer effect binds to a
27
- * single audioSessionId, so there are stretches with no effect at all: startup has no session until
28
- * the first audio output, and a session change (new ExoPlayer instance) needs a fresh one. Callers
29
- * see none of that — settings requested during a gap land on whichever effect comes next, and every
30
- * new effect announces itself through [onSettingsChanged].
25
+ * Keeps one equalizer effect on the player's current audio session. An effect binds to a single
26
+ * session, so there is none before the first audio output and a fresh one after a session change;
27
+ * settings asked for meanwhile apply to the next effect, and each new effect reports its settings
28
+ * through [onSettingsChanged].
31
29
  */
32
30
  internal class EqualizerController(
33
31
  private val onSettingsChanged: (EqualizerSettings) -> Unit,
@@ -36,14 +34,13 @@ internal class EqualizerController(
36
34
 
37
35
  private var effect: EqualizerEffect? = null
38
36
 
39
- // Settings to apply to the next effect: what the caller asked for during a gap, or what the
40
- // outgoing effect held across a session change. A preset and custom levels are exclusive — the
41
- // last one asked for wins, matching how the two setters behave on a live effect.
37
+ // For the next effect. A preset and custom levels exclude each other: the last one set wins, as
38
+ // on a live effect.
42
39
  private var pendingPreset: String? = null
43
40
  private var pendingLevels: DoubleArray? = null
44
41
  private var pendingEnabled: Boolean? = null
45
42
 
46
- /** Initializes for [audioSessionId]; deferred when the session is still unset. */
43
+ /** An unset session defers the effect to the first [onAudioSessionChanged]. */
47
44
  fun initialize(audioSessionId: Int) {
48
45
  if (audioSessionId == C.AUDIO_SESSION_ID_UNSET) {
49
46
  Timber.d("Skipping equalizer init - no audio session yet, will init on first playback")
@@ -53,10 +50,12 @@ internal class EqualizerController(
53
50
  }
54
51
 
55
52
  /**
56
- * Reacts to an audio session change: a no-op for the same session, otherwise a fresh effect that
57
- * picks up the outgoing one's settings.
53
+ * Moves the settings to a fresh effect on [newAudioSessionId]; the same session is a no-op. An
54
+ * unset session (playback on a remote output) keeps the effect on the local session, which it
55
+ * equalizes again on the way back: an effect on session 0 would equalize the whole device.
58
56
  */
59
57
  fun onAudioSessionChanged(newAudioSessionId: Int) {
58
+ if (newAudioSessionId == C.AUDIO_SESSION_ID_UNSET) return
60
59
  val old = effect
61
60
  if (old != null && old.audioSessionId == newAudioSessionId) return
62
61
 
@@ -73,6 +72,7 @@ internal class EqualizerController(
73
72
  effect = null
74
73
  }
75
74
 
75
+ /** Null while there is no effect, even when settings are pending. */
76
76
  fun getSettings(): EqualizerSettings? = effect?.getSettings()
77
77
 
78
78
  fun setEnabled(enabled: Boolean) {
@@ -102,17 +102,13 @@ internal class EqualizerController(
102
102
  effect.setLevels(levels)
103
103
  }
104
104
 
105
- /**
106
- * Creates the effect for [audioSessionId] and hands it the pending settings before wiring the
107
- * callback, so the restore stays silent and the caller gets one event describing the result. A
108
- * failed create keeps the pending settings for the next attempt.
109
- */
110
105
  private fun install(audioSessionId: Int) {
111
106
  val created =
112
107
  try {
113
108
  createEffect(audioSessionId)
114
109
  } catch (e: Exception) {
115
110
  Timber.e(e, "Failed to initialize equalizer")
111
+ // The pending settings stay for the next attempt.
116
112
  return
117
113
  }
118
114
  effect = created
@@ -125,9 +121,10 @@ internal class EqualizerController(
125
121
  pendingLevels = null
126
122
  pendingEnabled = null
127
123
 
124
+ // Wired after the restore, so its intermediate steps never reach the caller.
128
125
  created.setOnSettingsChanged(onSettingsChanged)
129
- // Announce unconditionally. The caller reads the settings once at startup, which is exactly
130
- // when there may be no effect yet, and nothing else would tell it the equalizer now exists.
126
+ // Always announced: the caller reads the settings once at startup, often before any effect
127
+ // exists, and nothing else tells it one does now.
131
128
  created.getSettings()?.let(onSettingsChanged)
132
129
  }
133
130
 
@@ -1,103 +1,144 @@
1
1
  package com.audiobrowser.player
2
2
 
3
3
  import androidx.media3.common.ForwardingPlayer
4
+ import androidx.media3.common.PlaybackException
4
5
  import androidx.media3.common.Player as MediaPlayer
5
6
  import com.audiobrowser.Callbacks
6
7
  import com.audiobrowser.model.PlayerUpdateOptions
8
+ import com.margelo.nitro.audiobrowser.PlaybackState
7
9
  import com.margelo.nitro.audiobrowser.RemoteJumpBackwardEvent
8
10
  import com.margelo.nitro.audiobrowser.RemoteJumpForwardEvent
9
11
  import com.margelo.nitro.audiobrowser.RemoteSeekEvent
10
12
 
11
13
  /**
12
- * The session-error masking rules, pure so their truth table is testable: with
13
- * `keepSessionAliveOnError`, a terminal load error (ExoPlayer idle + error present) is reported to
14
- * the platform session as paused-but-ready instead of STATE_NONE — Android Auto reads STATE_NONE as
15
- * "nothing playing" and tears down the now-playing screen, losing the next/previous buttons.
14
+ * What the platform session reads of an idle engine. Android Auto takes STATE_IDLE for "nothing
15
+ * playing": it closes the now-playing screen and its next/previous buttons with it. So an ended
16
+ * queue reads ended, as on an ended engine (a rebuild carries an ended engine idle), and with
17
+ * `keepAlive` a terminal error (the engine's, or ERROR once a rebuild dropped it) and a pause that
18
+ * cancelled a retry (PAUSED) read as paused and ready.
16
19
  */
17
- internal object SessionErrorMask {
18
- fun playbackState(state: Int, hasError: Boolean, keepAlive: Boolean): Int =
19
- if (keepAlive && state == MediaPlayer.STATE_IDLE && hasError) MediaPlayer.STATE_READY else state
20
+ internal object SessionView {
21
+ private val PARKED_STATES = setOf(PlaybackState.PAUSED, PlaybackState.ERROR)
22
+ private val SETTLED_STATES = setOf(PlaybackState.STOPPED, PlaybackState.NONE)
23
+
24
+ fun playbackState(
25
+ engineState: Int,
26
+ state: PlaybackState,
27
+ engineFailed: Boolean,
28
+ keepAlive: Boolean,
29
+ ): Int =
30
+ when {
31
+ engineState != MediaPlayer.STATE_IDLE -> engineState
32
+ state == PlaybackState.ENDED -> MediaPlayer.STATE_ENDED
33
+ !keepAlive -> engineState
34
+ state in PARKED_STATES -> MediaPlayer.STATE_READY
35
+ // The engine keeps its error through a stop or an emptied queue, until its next prepare. It
36
+ // counts until the player's state reaches ERROR, which follows the engine's IDLE event.
37
+ engineFailed && state !in SETTLED_STATES -> MediaPlayer.STATE_READY
38
+ else -> engineState
39
+ }
20
40
 
21
- fun playWhenReady(raw: Boolean, state: Int, hasError: Boolean, keepAlive: Boolean): Boolean =
22
- if (keepAlive && state == MediaPlayer.STATE_IDLE && hasError) false else raw
41
+ /** An idle engine read as anything else isn't loading, so it can't be about to play. */
42
+ fun playWhenReady(raw: Boolean, engineState: Int, view: Int): Boolean =
43
+ raw && (engineState != MediaPlayer.STATE_IDLE || view == MediaPlayer.STATE_IDLE)
23
44
  }
24
45
 
25
46
  /**
26
- * The Remote-command seam: intercepts transport controls arriving from External surfaces (lock
27
- * screen, notification, Bluetooth, Android Auto — all via the MediaSession) and offers each to the
28
- * app's `handleRemote*` callback first; a callback returning true consumes the command, anything
29
- * else falls through to the default behavior. Also masks a terminal playback error from the
30
- * platform session (see [SessionErrorMask]) so the session stays alive and skippable; the error
31
- * still surfaces via `onPlaybackError` and `playbackState`.
47
+ * The player the MediaSession sees. Offers each transport command from an external surface (lock
48
+ * screen, notification, Bluetooth, Android Auto) to the app's `handleRemote*` callback first: true
49
+ * consumes it, anything else runs the default. Shows the session the [SessionView] of an idle
50
+ * engine; the error still reaches JS through `onPlaybackError` and `playbackState`.
32
51
  */
33
52
  internal class InterceptingPlayer(
34
53
  player: MediaPlayer,
35
54
  private val callbacksProvider: () -> Callbacks?,
36
55
  private val optionsProvider: () -> PlayerUpdateOptions,
37
56
  private val keepSessionAliveOnError: Boolean,
57
+ private val playerState: () -> PlaybackState,
58
+ private val playPlayer: () -> Unit,
59
+ private val stopPlayer: () -> Unit,
38
60
  ) : ForwardingPlayer(player) {
39
61
 
40
- // Hide playback errors from the platform session. Media3 builds the legacy PlaybackStateCompat
41
- // from player.getPlayerError() (-> STATE_ERROR), which Android Auto and the notification render
42
- // as a disruptive error. The error still surfaces via the onPlaybackError JS callback and
43
- // `playbackState`, so a now-playing formatter can render it; playback context is preserved.
44
- override fun getPlayerError(): androidx.media3.common.PlaybackException? = null
62
+ private val listeners = mutableSetOf<MediaPlayer.Listener>()
63
+
64
+ override fun addListener(listener: MediaPlayer.Listener) {
65
+ listeners += listener
66
+ super.addListener(listener)
67
+ }
68
+
69
+ override fun removeListener(listener: MediaPlayer.Listener) {
70
+ listeners -= listener
71
+ super.removeListener(listener)
72
+ }
73
+
74
+ /**
75
+ * Call when the player's state changes from [old]: on an idle engine the view can move with no
76
+ * engine event.
77
+ */
78
+ fun onStateChanged(old: PlaybackState) {
79
+ val view = playbackState
80
+ val was =
81
+ SessionView.playbackState(
82
+ super.getPlaybackState(),
83
+ old,
84
+ engineFailed,
85
+ keepSessionAliveOnError,
86
+ )
87
+ if (view != was) listeners.toList().forEach { it.onPlaybackStateChanged(view) }
88
+ }
89
+
90
+ // Media3 maps a player error to the legacy STATE_ERROR, which Android Auto and the notification
91
+ // show as a disruptive error. Hidden whatever keepSessionAliveOnError says.
92
+ override fun getPlayerError(): PlaybackException? = null
93
+
94
+ private val engineFailed: Boolean
95
+ get() = super.getPlayerError() != null
45
96
 
46
- // Both masks read the real underlying error (super.getPlayerError()) so they're race-free with
47
- // state-change listeners.
48
97
  override fun getPlaybackState(): Int =
49
- SessionErrorMask.playbackState(
98
+ SessionView.playbackState(
50
99
  super.getPlaybackState(),
51
- hasError = super.getPlayerError() != null,
52
- keepAlive = keepSessionAliveOnError,
100
+ playerState(),
101
+ engineFailed,
102
+ keepSessionAliveOnError,
53
103
  )
54
104
 
55
105
  override fun getPlayWhenReady(): Boolean =
56
- SessionErrorMask.playWhenReady(
57
- super.getPlayWhenReady(),
58
- super.getPlaybackState(),
59
- hasError = super.getPlayerError() != null,
60
- keepAlive = keepSessionAliveOnError,
61
- )
62
-
63
- /**
64
- * A terminal error leaves ExoPlayer idle; the default transport controls (super.play() /
65
- * super.seekToNext()) then flip playWhenReady or move the queue index but never restart a stopped
66
- * player. prepare() recovers it (and early-returns when not idle, so it's a no-op during normal
67
- * playback) — so next/previous/play resume on the selected station from the masked error state
68
- * instead of doing nothing.
69
- */
70
- private fun recoverFromErrorIfNeeded() {
71
- if (keepSessionAliveOnError && super.getPlayerError() != null) {
72
- // Through the forwarding chain (no override exists), reaching the wrapped player.
106
+ SessionView.playWhenReady(super.getPlayWhenReady(), super.getPlaybackState(), playbackState)
107
+
108
+ // After a terminal error, a cancelled retry or a rebuild in ENDED the engine is idle, and the
109
+ // default skips only move the index. An ended queue that stayed put stays ended, as on an ended
110
+ // engine.
111
+ private fun loadIdleEngine(fromIndex: Int) {
112
+ if (super.getPlaybackState() != MediaPlayer.STATE_IDLE) return
113
+ val view = playbackState
114
+ if (
115
+ view == MediaPlayer.STATE_READY ||
116
+ view == MediaPlayer.STATE_ENDED && currentMediaItemIndex != fromIndex
117
+ ) {
73
118
  prepare()
74
119
  }
75
120
  }
76
121
 
77
- /**
78
- * One definition of the dispatch: offer the command to the app's handler; true consumes it,
79
- * anything else runs the default (and, for the resuming commands, the idle-error recovery).
80
- */
81
122
  private inline fun intercept(
82
123
  handler: (Callbacks) -> Boolean,
83
124
  recover: Boolean = false,
84
125
  fallback: () -> Unit,
85
126
  ) {
86
127
  if (callbacksProvider()?.let(handler) == true) return
128
+ val index = currentMediaItemIndex
87
129
  fallback()
88
- if (recover) recoverFromErrorIfNeeded()
130
+ if (recover) loadIdleEngine(index)
89
131
  }
90
132
 
91
- override fun play() = intercept({ it.handleRemotePlay() }, recover = true) { super.play() }
133
+ override fun play() = intercept({ it.handleRemotePlay() }) { playPlayer() }
92
134
 
93
135
  override fun pause() = intercept({ it.handleRemotePause() }) { super.pause() }
94
136
 
95
- // Media3 controllers may drive transport via setPlayWhenReady instead of play()/pause()
96
- // (the documented ForwardingPlayer hazard); route it through the same interception so the
97
- // remote handlers and the idle-error recovery aren't bypassed.
137
+ // Media3 controllers can send play/pause as setPlayWhenReady, which would bypass the handlers and
138
+ // the recovery.
98
139
  override fun setPlayWhenReady(playWhenReady: Boolean) = if (playWhenReady) play() else pause()
99
140
 
100
- override fun stop() = intercept({ it.handleRemoteStop() }) { super.stop() }
141
+ override fun stop() = intercept({ it.handleRemoteStop() }) { stopPlayer() }
101
142
 
102
143
  override fun seekToNext() =
103
144
  intercept({ it.handleRemoteNext() }, recover = true) { super.seekToNext() }
@@ -0,0 +1,65 @@
1
+ package com.audiobrowser.player
2
+
3
+ import android.net.Uri
4
+ import androidx.media3.common.C
5
+ import androidx.media3.common.PlaybackException
6
+ import androidx.media3.datasource.DataSourceException
7
+ import androidx.media3.extractor.Extractor
8
+ import androidx.media3.extractor.ExtractorInput
9
+ import androidx.media3.extractor.ExtractorOutput
10
+ import androidx.media3.extractor.ExtractorsFactory
11
+ import androidx.media3.extractor.ForwardingExtractor
12
+ import androidx.media3.extractor.ForwardingExtractorOutput
13
+ import androidx.media3.extractor.ForwardingExtractorsFactory
14
+ import androidx.media3.extractor.PositionHolder
15
+ import androidx.media3.extractor.SeekMap
16
+
17
+ /**
18
+ * Extracts a live track's progressive stream, which never ends: once its format is recognised, an
19
+ * end of a stream with neither a length nor a duration (media3's own test for live) is a dropped
20
+ * connection, thrown for the load error policy to reconnect. An end during the sniff stays the
21
+ * unrecognised format error, and a stream with a length or a declared end ends there.
22
+ */
23
+ class LiveStreamExtractor(extractor: Extractor) : ForwardingExtractor(extractor) {
24
+ @Volatile private var durationKnown = false
25
+
26
+ override fun init(output: ExtractorOutput) {
27
+ super.init(
28
+ object : ForwardingExtractorOutput(output) {
29
+ override fun seekMap(seekMap: SeekMap) {
30
+ durationKnown = seekMap.durationUs != C.TIME_UNSET
31
+ super.seekMap(seekMap)
32
+ }
33
+ }
34
+ )
35
+ }
36
+
37
+ override fun read(input: ExtractorInput, seekPosition: PositionHolder): Int {
38
+ val result = super.read(input, seekPosition)
39
+ if (
40
+ result == Extractor.RESULT_END_OF_INPUT &&
41
+ input.length == C.LENGTH_UNSET.toLong() &&
42
+ !durationKnown
43
+ ) {
44
+ throw DataSourceException(
45
+ "The server ended a live stream",
46
+ null,
47
+ PlaybackException.ERROR_CODE_IO_NETWORK_CONNECTION_FAILED,
48
+ )
49
+ }
50
+ return result
51
+ }
52
+
53
+ /** Wraps every extractor [factory] makes. */
54
+ class Factory(factory: ExtractorsFactory) : ForwardingExtractorsFactory(factory) {
55
+ override fun createExtractors(): Array<Extractor> = wrap(super.createExtractors())
56
+
57
+ override fun createExtractors(
58
+ uri: Uri,
59
+ responseHeaders: Map<String, List<String>>,
60
+ ): Array<Extractor> = wrap(super.createExtractors(uri, responseHeaders))
61
+
62
+ private fun wrap(extractors: Array<Extractor>): Array<Extractor> =
63
+ Array(extractors.size) { LiveStreamExtractor(extractors[it]) }
64
+ }
65
+ }
@@ -0,0 +1,49 @@
1
+ package com.audiobrowser.player
2
+
3
+ import androidx.media3.exoplayer.ExoPlayer
4
+ import androidx.media3.exoplayer.source.ShuffleOrder
5
+
6
+ /**
7
+ * The phone's ExoPlayer, for the work only it does: retries, reconnects and its shuffle order.
8
+ * While a remote output plays, each call does nothing.
9
+ */
10
+ internal class LocalEngine(
11
+ private val engine: () -> ExoPlayer,
12
+ private val isRemote: () -> Boolean,
13
+ ) {
14
+ private val playing: ExoPlayer?
15
+ get() = engine().takeIf { !isRemote() }
16
+
17
+ /** Whether the phone's ExoPlayer is what plays, rather than a remote output. */
18
+ val isActive: Boolean
19
+ get() = playing != null
20
+
21
+ /** Prepares again what failed or stalled, from the live edge when [toLiveEdge]. */
22
+ fun retry(toLiveEdge: Boolean = false) {
23
+ val engine = playing ?: return
24
+ if (toLiveEdge) engine.seekToDefaultPosition()
25
+ engine.prepare()
26
+ }
27
+
28
+ /**
29
+ * Reconnects at the live edge: a stream with a live window seeks there; anything else connects
30
+ * again, which for a stream that can't seek is the edge. False while remote.
31
+ */
32
+ fun reconnectAtLiveEdge(): Boolean {
33
+ val engine = playing ?: return false
34
+ if (engine.isCurrentMediaItemLive) {
35
+ engine.seekToDefaultPosition()
36
+ return true
37
+ }
38
+ // prepare() only re-prepares from STATE_IDLE, hence ExoPlayer's own stop(), not
39
+ // [Player.stop], which drops the play intent this reconnect keeps.
40
+ engine.stop()
41
+ engine.seekToDefaultPosition()
42
+ engine.prepare()
43
+ return true
44
+ }
45
+
46
+ fun setShuffleOrder(order: ShuffleOrder) {
47
+ playing?.setShuffleOrder(order)
48
+ }
49
+ }
@@ -4,41 +4,55 @@ import android.content.Context
4
4
  import androidx.media3.common.MediaItem
5
5
  import androidx.media3.datasource.DataSource
6
6
  import androidx.media3.datasource.DefaultDataSource
7
- import androidx.media3.datasource.DefaultHttpDataSource
8
7
  import androidx.media3.datasource.TransferListener
9
8
  import androidx.media3.datasource.cache.CacheDataSource
10
9
  import androidx.media3.datasource.cache.SimpleCache
10
+ import androidx.media3.datasource.okhttp.OkHttpDataSource
11
11
  import androidx.media3.exoplayer.drm.DrmSessionManagerProvider
12
12
  import androidx.media3.exoplayer.source.DefaultMediaSourceFactory
13
13
  import androidx.media3.exoplayer.source.MediaSource
14
14
  import androidx.media3.exoplayer.upstream.LoadErrorHandlingPolicy
15
15
  import androidx.media3.extractor.DefaultExtractorsFactory
16
+ import androidx.media3.extractor.ExtractorsFactory
16
17
  import com.audiobrowser.model.RetryPolicy
18
+ import com.audiobrowser.util.TrackFactory
17
19
  import com.margelo.nitro.audiobrowser.MediaRequestConfig
20
+ import com.margelo.nitro.audiobrowser.Track
18
21
  import java.io.IOException
22
+ import java.util.concurrent.TimeUnit
23
+ import okhttp3.OkHttpClient
19
24
 
20
25
  class MediaFactory(
21
26
  private val context: Context,
22
27
  private val cache: SimpleCache?,
23
28
  private val retryPolicy: RetryPolicy,
24
- private val shouldRetry: () -> Boolean,
25
29
  private val isOnline: () -> Boolean = { true },
26
30
  private val hasPlayed: () -> Boolean = { false },
27
- private val onRetryPending: ((exception: IOException, isNetworkError: Boolean) -> Unit)? = null,
31
+ private val onRetryPending: ((exception: IOException) -> Unit)? = null,
28
32
  private val transferListener: TransferListener? = null,
29
- private val getRequestConfig: (originalUrl: String) -> MediaRequestConfig?,
33
+ private val getRequestConfig: (originalUrl: String, track: Track) -> MediaRequestConfig?,
30
34
  ) : MediaSource.Factory {
31
35
 
32
36
  companion object {
33
37
  private const val DEFAULT_USER_AGENT = "react-native-audio-browser"
38
+
39
+ /**
40
+ * The client media requests go out on, one per process so connections are reused. Not
41
+ * `HttpClient`'s browse client, whose read timeout is sized for JSON and would cut a long media
42
+ * read short. The timeouts are media3's own defaults, which stall detection and
43
+ * [RetryLoadErrorHandlingPolicy] are tuned to.
44
+ */
45
+ private val mediaHttpClient: OkHttpClient by lazy {
46
+ OkHttpClient.Builder()
47
+ .connectTimeout(8, TimeUnit.SECONDS)
48
+ .readTimeout(8, TimeUnit.SECONDS)
49
+ .addNetworkInterceptor(CrossOriginHeaderStripper)
50
+ .build()
51
+ }
34
52
  }
35
53
 
36
- private val extractorsFactory =
37
- DefaultExtractorsFactory()
38
- // TODO: reconsider whether this should be enabled by default:
39
- .setConstantBitrateSeekingEnabled(true)
54
+ private val extractorsFactory = DefaultExtractorsFactory().setConstantBitrateSeekingEnabled(true)
40
55
 
41
- // Store reference to custom retry policy so we can reset it on track changes
42
56
  private val customRetryPolicy: RetryLoadErrorHandlingPolicy? =
43
57
  when (retryPolicy) {
44
58
  is RetryPolicy.Default -> null
@@ -47,7 +61,6 @@ class MediaFactory(
47
61
  maxRetries = null,
48
62
  maxRetryDurationMs = retryPolicy.maxRetryDurationMs,
49
63
  firstConnectMaxRetryDurationMs = retryPolicy.firstConnectMaxRetryDurationMs,
50
- shouldRetry = shouldRetry,
51
64
  isOnline = isOnline,
52
65
  hasPlayed = hasPlayed,
53
66
  onRetryPending = onRetryPending,
@@ -57,19 +70,22 @@ class MediaFactory(
57
70
  maxRetries = retryPolicy.maxRetries,
58
71
  maxRetryDurationMs = retryPolicy.maxRetryDurationMs,
59
72
  firstConnectMaxRetryDurationMs = retryPolicy.firstConnectMaxRetryDurationMs,
60
- shouldRetry = shouldRetry,
61
73
  isOnline = isOnline,
62
74
  hasPlayed = hasPlayed,
63
75
  onRetryPending = onRetryPending,
64
76
  )
65
77
  }
66
78
 
67
- private val mediaFactory =
68
- DefaultMediaSourceFactory(context, extractorsFactory).apply {
79
+ private fun mediaSourceFactory(extractors: ExtractorsFactory) =
80
+ DefaultMediaSourceFactory(context, extractors).apply {
69
81
  customRetryPolicy?.let { setLoadErrorHandlingPolicy(it) }
70
82
  }
71
83
 
72
- /** Resets the retry timer. Call when track changes. */
84
+ private val mediaFactory = mediaSourceFactory(extractorsFactory)
85
+
86
+ private val liveMediaFactory = mediaSourceFactory(LiveStreamExtractor.Factory(extractorsFactory))
87
+
88
+ /** Restarts the retry policy's time budgets. */
73
89
  fun resetRetryTimer() {
74
90
  customRetryPolicy?.reset()
75
91
  }
@@ -77,12 +93,14 @@ class MediaFactory(
77
93
  override fun setDrmSessionManagerProvider(
78
94
  drmSessionManagerProvider: DrmSessionManagerProvider
79
95
  ): MediaSource.Factory {
96
+ liveMediaFactory.setDrmSessionManagerProvider(drmSessionManagerProvider)
80
97
  return mediaFactory.setDrmSessionManagerProvider(drmSessionManagerProvider)
81
98
  }
82
99
 
83
100
  override fun setLoadErrorHandlingPolicy(
84
101
  loadErrorHandlingPolicy: LoadErrorHandlingPolicy
85
102
  ): MediaSource.Factory {
103
+ liveMediaFactory.setLoadErrorHandlingPolicy(loadErrorHandlingPolicy)
86
104
  return mediaFactory.setLoadErrorHandlingPolicy(loadErrorHandlingPolicy)
87
105
  }
88
106
 
@@ -91,30 +109,28 @@ class MediaFactory(
91
109
  }
92
110
 
93
111
  override fun createMediaSource(mediaItem: MediaItem): MediaSource {
94
- // URL transformation is deferred to TransformingDataSource.open() which runs on
95
- // ExoPlayer's IO thread. This prevents deadlocks when the JS thread is blocked by
96
- // synchronous Nitro calls (e.g., seekTo) while a media transform callback needs the
97
- // JS thread to resolve.
112
+ // The URL is resolved in TransformingDataSource.open(), on ExoPlayer's IO thread, not here:
113
+ // the request config callback needs the JS thread, which a synchronous Nitro call (seekTo)
114
+ // can be blocking while it waits on the player, a deadlock.
115
+
116
+ // OkHttp rather than DefaultHttpDataSource, for redirects: DefaultHttpDataSource re-applies the
117
+ // request headers on every hop, handing an Authorization header to whatever host the first one
118
+ // names. OkHttp drops that header itself, and [CrossOriginHeaderStripper] drops the rest.
98
119
  val httpFactory =
99
- DefaultHttpDataSource.Factory().apply {
100
- // Deliberately NOT setUserAgent(): DefaultHttpDataSource applies the factory
101
- // user-agent as a FINAL setRequestProperty("User-Agent", …) that runs after —
102
- // and overrides — the per-request DataSpec headers. That would clobber the
103
- // User-Agent TransformingDataSource sets per request (the whole point of the
104
- // per-request userAgent override). Supplying the same value as a default
105
- // request property keeps the default for un-overridden requests while letting
106
- // the per-request DataSpec header win.
120
+ OkHttpDataSource.Factory(mediaHttpClient).apply {
121
+ // Not setUserAgent(): it is applied last with addHeader(), which appends, so a request
122
+ // already carrying one would send two. As a default request property it is merged under
123
+ // dataSpec.httpRequestHeaders and applied with header(), so TransformingDataSource's
124
+ // per-request override wins.
107
125
  setDefaultRequestProperties(mapOf("User-Agent" to DEFAULT_USER_AGENT))
108
- setAllowCrossProtocolRedirects(true)
109
- // Connect transfer listener for bandwidth measurement
110
126
  transferListener?.let { setTransferListener(it) }
111
127
  }
112
128
  val baseFactory: DataSource.Factory = DefaultDataSource.Factory(context, httpFactory)
113
129
 
114
- // Wrap with TransformingDataSource to resolve URLs on the IO thread
115
- val transformingFactory = TransformingDataSource.Factory(baseFactory, getRequestConfig)
130
+ val track = TrackFactory.fromMedia3(mediaItem)
131
+ val transformingFactory =
132
+ TransformingDataSource.Factory(baseFactory) { url -> getRequestConfig(url, track) }
116
133
 
117
- // Configure data source factory with optional caching
118
134
  val dataSourceFactory =
119
135
  cache?.let {
120
136
  CacheDataSource.Factory()
@@ -123,7 +139,8 @@ class MediaFactory(
123
139
  .setFlags(CacheDataSource.FLAG_IGNORE_CACHE_ON_ERROR)
124
140
  } ?: transformingFactory
125
141
 
126
- // Use DefaultMediaSourceFactory which supports HLS, DASH, and progressive media
127
- return mediaFactory.setDataSourceFactory(dataSourceFactory).createMediaSource(mediaItem)
142
+ return (if (track.live == true) liveMediaFactory else mediaFactory)
143
+ .setDataSourceFactory(dataSourceFactory)
144
+ .createMediaSource(mediaItem)
128
145
  }
129
146
  }