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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1223) hide show
  1. package/README.md +66 -39
  2. package/android/build.gradle +58 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +592 -438
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  9. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  10. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  11. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  12. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  13. package/android/src/main/java/com/audiobrowser/Service.kt +77 -82
  14. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  15. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  16. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  17. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +345 -537
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +37 -68
  19. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  20. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  21. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  22. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  23. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -29
  24. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  25. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  26. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +5 -15
  27. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  28. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  29. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  30. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  32. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  33. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +18 -40
  34. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  35. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  36. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  37. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  38. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  39. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  40. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  41. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  42. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  43. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  44. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +23 -34
  45. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  46. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +38 -27
  47. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  48. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  49. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +102 -117
  50. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  51. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +47 -37
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +123 -136
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  54. package/android/src/main/java/com/audiobrowser/player/Player.kt +425 -566
  55. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  56. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -21
  57. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +69 -120
  58. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +51 -122
  59. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  60. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  61. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  62. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  63. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +32 -67
  64. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  65. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  66. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  67. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  68. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +690 -0
  70. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  71. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  72. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  73. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  86. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  87. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  88. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  89. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  90. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  91. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  92. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  93. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  94. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -15
  95. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  96. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  97. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  98. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  99. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  100. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  101. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  102. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  103. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  104. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  105. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  106. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  107. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  108. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  109. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  110. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  111. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  112. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  113. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -82
  114. package/android/src/main/res/values/strings.xml +25 -5
  115. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  116. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  117. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  118. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  119. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  120. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  121. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +287 -0
  122. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -43
  123. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  124. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  125. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  126. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  127. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -23
  128. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +314 -8
  129. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  130. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  131. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -4
  132. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  133. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -55
  134. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  135. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  136. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  137. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  138. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +8 -16
  139. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  140. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  141. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +460 -0
  142. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  143. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  144. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  145. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  146. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  147. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  148. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  149. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  150. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +226 -21
  151. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +2 -26
  152. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +53 -39
  153. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  154. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  155. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  156. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  157. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  158. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  159. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  160. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +353 -0
  161. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +93 -0
  162. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  163. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  164. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +190 -0
  165. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +46 -0
  166. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +34 -72
  167. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -5
  168. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  169. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  170. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  171. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +2 -23
  172. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +285 -0
  173. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  174. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  175. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  176. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +926 -0
  177. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  178. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  179. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  180. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  181. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  182. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  183. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  184. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  185. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  186. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  187. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  188. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  189. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  190. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  191. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  192. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  193. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  194. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  195. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  196. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  197. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  198. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  199. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  200. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  201. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  202. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  203. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  204. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  205. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  206. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  207. package/android/src/test/resources/sonos/device_description.xml +78 -0
  208. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  209. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  210. package/ios/AVPlayerEngine.swift +354 -0
  211. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  212. package/ios/Browser/BrowseGate.swift +57 -0
  213. package/ios/Browser/BrowserConfig.swift +123 -104
  214. package/ios/Browser/BrowserError.swift +15 -0
  215. package/ios/Browser/BrowserManager.swift +153 -675
  216. package/ios/Browser/BrowserPathHelper.swift +54 -117
  217. package/ios/Browser/FavoriteSet.swift +43 -0
  218. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  219. package/ios/Browser/JsonModels.swift +244 -335
  220. package/ios/Browser/NavigationErrorState.swift +42 -0
  221. package/ios/Browser/PageResolver.swift +137 -0
  222. package/ios/Browser/RequestLayer.swift +181 -0
  223. package/ios/Browser/RequestPipeline.swift +293 -0
  224. package/ios/Browser/SearchDrillIn.swift +11 -17
  225. package/ios/Browser/SectionScope.swift +73 -26
  226. package/ios/Browser/SimpleRouter.swift +76 -154
  227. package/ios/Browser/StyleResolver.swift +41 -0
  228. package/ios/Browser/TabBarEntries.swift +8 -7
  229. package/ios/Browser/TrackIdTemplate.swift +29 -0
  230. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  231. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  232. package/ios/CarPlay/CarPlayController.swift +37 -1297
  233. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  234. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  235. package/ios/CarPlay/CarPlayNowPlayingManager.swift +129 -204
  236. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  237. package/ios/CarPlay/CarPlaySession+PageLoader.swift +92 -0
  238. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  239. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  240. package/ios/CarPlay/CarPlaySession.swift +203 -0
  241. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  242. package/ios/CarPlay/IntentHandlers.swift +94 -0
  243. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  244. package/ios/CarPlay/MediaIntentHandler.swift +63 -0
  245. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  246. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  247. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  248. package/ios/CarPlay/SectionPresentation.swift +67 -0
  249. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  250. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  251. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  252. package/ios/Extension/CxxVectorConformances.swift +4 -16
  253. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  254. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  255. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  256. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  257. package/ios/Extension/SearchParams+Query.swift +28 -0
  258. package/ios/Extension/Section+Copying.swift +26 -0
  259. package/ios/Extension/String+IcyCharset.swift +21 -0
  260. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  261. package/ios/Extension/Track+AVPlayer.swift +1 -18
  262. package/ios/Extension/Track+Copying.swift +13 -21
  263. package/ios/Extension/Track+Identity.swift +20 -0
  264. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  265. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  266. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  267. package/ios/Extension/URLError+Connectivity.swift +15 -0
  268. package/ios/Extension/Variant+Artwork.swift +8 -22
  269. package/ios/Http/HttpClient.swift +73 -167
  270. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  271. package/ios/HybridAudioBrowser+Options.swift +116 -0
  272. package/ios/HybridAudioBrowser+Player.swift +337 -0
  273. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  274. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  275. package/ios/HybridAudioBrowser.swift +148 -1688
  276. package/ios/Model/NitroTypeStubs.swift +240 -32
  277. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  278. package/ios/Model/RemoteCommand.swift +6 -60
  279. package/ios/Model/TrackPlayerError.swift +14 -23
  280. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  281. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  282. package/ios/Observer/ItemObserver.swift +92 -0
  283. package/ios/Observer/PlayerObserver.swift +59 -0
  284. package/ios/Option/SessionCategories.swift +42 -92
  285. package/ios/PlaybackEvent.swift +4 -2
  286. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  287. package/ios/Player/AudioSessionController.swift +190 -0
  288. package/ios/Player/DeferredSeek.swift +73 -0
  289. package/ios/Player/EndOfTrackJudgement.swift +6 -13
  290. package/ios/Player/ErrorStatus.swift +52 -0
  291. package/ios/Player/MediaLoader.swift +73 -98
  292. package/ios/Player/NowPlayingLines.swift +49 -0
  293. package/ios/Player/NowPlayingUpdater.swift +175 -105
  294. package/ios/Player/PersistedPlaybackState.swift +1 -2
  295. package/ios/Player/PlaybackFailure.swift +121 -0
  296. package/ios/Player/PlaybackPersistence.swift +72 -0
  297. package/ios/Player/PlaybackStateMachine.swift +11 -11
  298. package/ios/Player/PlaybackTimer.swift +11 -8
  299. package/ios/Player/Player.swift +991 -0
  300. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  301. package/ios/Player/PlayerEngine.swift +105 -0
  302. package/ios/Player/PlayerStatusTypes.swift +1 -6
  303. package/ios/Player/QueueManager.swift +80 -98
  304. package/ios/Player/RetryLoop.swift +274 -0
  305. package/ios/Player/ShuffleOrder.swift +36 -43
  306. package/ios/Player/SleepTimerManager.swift +25 -42
  307. package/ios/Player/VolumeFader.swift +20 -15
  308. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  309. package/ios/RemoteCommand/RemoteCommandController.swift +101 -336
  310. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  311. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  312. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  313. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  314. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  315. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  316. package/ios/Tests/DeferredSeekTests.swift +76 -0
  317. package/ios/Tests/EmitterTests.swift +22 -39
  318. package/ios/Tests/EndOfTrackJudgementTests.swift +1 -6
  319. package/ios/Tests/ErrorStatusTests.swift +50 -0
  320. package/ios/Tests/FavoriteSetTests.swift +61 -0
  321. package/ios/Tests/GenerationMemoTests.swift +121 -0
  322. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  323. package/ios/Tests/JsonModelsTests.swift +189 -3
  324. package/ios/Tests/LRUCacheTests.swift +106 -0
  325. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  326. package/ios/Tests/MediaLoaderTests.swift +38 -78
  327. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  328. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  329. package/ios/Tests/ObserverTests.swift +88 -0
  330. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  331. package/ios/Tests/PlaybackFailureTests.swift +181 -0
  332. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  333. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  334. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  335. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  336. package/ios/Tests/PlayerPolicyTests.swift +547 -0
  337. package/ios/Tests/PlayerTests.swift +1590 -0
  338. package/ios/Tests/PlayingStateTests.swift +41 -0
  339. package/ios/Tests/QueueManagerTests.swift +205 -174
  340. package/ios/Tests/ReadyValueTests.swift +73 -0
  341. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  342. package/ios/Tests/RequestLayerTests.swift +228 -0
  343. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  344. package/ios/Tests/RetryLoopTests.swift +282 -0
  345. package/ios/Tests/SearchDrillInTests.swift +16 -17
  346. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  347. package/ios/Tests/SectionPresentationTests.swift +85 -0
  348. package/ios/Tests/SectionScopeTests.swift +136 -54
  349. package/ios/Tests/SimpleRouterTests.swift +39 -8
  350. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  351. package/ios/Tests/StyleResolverTests.swift +123 -0
  352. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  353. package/ios/Tests/Support/TestTypes.swift +135 -100
  354. package/ios/Tests/TabBarEntriesTests.swift +19 -21
  355. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  356. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  357. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  358. package/ios/Tests/TrackIdentityTests.swift +20 -0
  359. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  360. package/ios/Tests/TrackSelectorTests.swift +157 -34
  361. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  362. package/ios/TrackSelector.swift +62 -77
  363. package/ios/Util/ArtworkFreshness.swift +42 -0
  364. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  365. package/ios/Util/ConcurrentMap.swift +19 -0
  366. package/ios/Util/Emitter.swift +45 -22
  367. package/ios/Util/GenerationMemo.swift +36 -0
  368. package/ios/Util/LRUCache.swift +23 -159
  369. package/ios/Util/NetworkMonitor.swift +31 -33
  370. package/ios/Util/OutputPicker.swift +48 -0
  371. package/ios/Util/ReadyValue.swift +57 -0
  372. package/ios/Util/SFSymbolRenderer.swift +64 -49
  373. package/ios/Util/SVGProcessor.swift +9 -16
  374. package/lib/commonjs/AudioBrowser.js +8 -8
  375. package/lib/commonjs/AudioBrowser.js.map +1 -1
  376. package/lib/commonjs/CLAUDE.md +57 -0
  377. package/lib/commonjs/features/battery.js +16 -12
  378. package/lib/commonjs/features/battery.js.map +1 -1
  379. package/lib/commonjs/features/browser-config.js +13 -9
  380. package/lib/commonjs/features/browser-config.js.map +1 -1
  381. package/lib/commonjs/features/browser.js +78 -20
  382. package/lib/commonjs/features/browser.js.map +1 -1
  383. package/lib/commonjs/features/carConnection.js +3 -4
  384. package/lib/commonjs/features/carConnection.js.map +1 -1
  385. package/lib/commonjs/features/equalizer.js +10 -6
  386. package/lib/commonjs/features/equalizer.js.map +1 -1
  387. package/lib/commonjs/features/errors.js +35 -21
  388. package/lib/commonjs/features/errors.js.map +1 -1
  389. package/lib/commonjs/features/favorites.js +29 -24
  390. package/lib/commonjs/features/favorites.js.map +1 -1
  391. package/lib/commonjs/features/gate.js +28 -7
  392. package/lib/commonjs/features/gate.js.map +1 -1
  393. package/lib/commonjs/features/metadata.js +64 -14
  394. package/lib/commonjs/features/metadata.js.map +1 -1
  395. package/lib/commonjs/features/network.js +6 -2
  396. package/lib/commonjs/features/network.js.map +1 -1
  397. package/lib/commonjs/features/nowPlaying.js +29 -15
  398. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  399. package/lib/commonjs/features/output.js +10 -5
  400. package/lib/commonjs/features/output.js.map +1 -1
  401. package/lib/commonjs/features/playback/controls.js +13 -6
  402. package/lib/commonjs/features/playback/controls.js.map +1 -1
  403. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  404. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  405. package/lib/commonjs/features/playback/playing.js +5 -3
  406. package/lib/commonjs/features/playback/playing.js.map +1 -1
  407. package/lib/commonjs/features/playback/progress.js +13 -6
  408. package/lib/commonjs/features/playback/progress.js.map +1 -1
  409. package/lib/commonjs/features/playback/rate.js +8 -1
  410. package/lib/commonjs/features/playback/rate.js.map +1 -1
  411. package/lib/commonjs/features/playback/state.js +5 -6
  412. package/lib/commonjs/features/playback/state.js.map +1 -1
  413. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -7
  414. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  415. package/lib/commonjs/features/playback/volume.js +6 -5
  416. package/lib/commonjs/features/playback/volume.js.map +1 -1
  417. package/lib/commonjs/features/player/options.js +23 -29
  418. package/lib/commonjs/features/player/options.js.map +1 -1
  419. package/lib/commonjs/features/player/setup.js +41 -41
  420. package/lib/commonjs/features/player/setup.js.map +1 -1
  421. package/lib/commonjs/features/player/validateOptions.js +23 -0
  422. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  423. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  424. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  425. package/lib/commonjs/features/queue/queue.js +58 -23
  426. package/lib/commonjs/features/queue/queue.js.map +1 -1
  427. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  428. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  429. package/lib/commonjs/features/queue/shuffle.js +1 -2
  430. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  431. package/lib/commonjs/features/remoteControls.js +70 -125
  432. package/lib/commonjs/features/remoteControls.js.map +1 -1
  433. package/lib/commonjs/features/sleepTimer.js +24 -7
  434. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  435. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  436. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  437. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -14
  438. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  439. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  440. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  441. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  442. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  443. package/lib/commonjs/utils/useDebug.js +16 -3
  444. package/lib/commonjs/utils/useDebug.js.map +1 -1
  445. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  446. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  447. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  448. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  449. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  450. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  451. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  452. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  453. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  454. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  455. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  456. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  457. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  458. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  459. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  460. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  461. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  462. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  463. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  464. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  465. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  466. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  467. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  468. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  469. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  470. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  471. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  472. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  473. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  474. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  475. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  476. package/lib/commonjs/web/browser/sections.js +89 -0
  477. package/lib/commonjs/web/browser/sections.js.map +1 -0
  478. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  479. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  480. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  481. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  482. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  483. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  484. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  485. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  486. package/lib/module/AudioBrowser.js +2 -1
  487. package/lib/module/AudioBrowser.js.map +1 -1
  488. package/lib/module/CLAUDE.md +57 -0
  489. package/lib/module/features/battery.js +16 -12
  490. package/lib/module/features/battery.js.map +1 -1
  491. package/lib/module/features/browser-config.js +13 -9
  492. package/lib/module/features/browser-config.js.map +1 -1
  493. package/lib/module/features/browser.js +78 -20
  494. package/lib/module/features/browser.js.map +1 -1
  495. package/lib/module/features/carConnection.js +3 -4
  496. package/lib/module/features/carConnection.js.map +1 -1
  497. package/lib/module/features/equalizer.js +10 -6
  498. package/lib/module/features/equalizer.js.map +1 -1
  499. package/lib/module/features/errors.js +35 -21
  500. package/lib/module/features/errors.js.map +1 -1
  501. package/lib/module/features/favorites.js +29 -24
  502. package/lib/module/features/favorites.js.map +1 -1
  503. package/lib/module/features/gate.js +28 -7
  504. package/lib/module/features/gate.js.map +1 -1
  505. package/lib/module/features/metadata.js +62 -14
  506. package/lib/module/features/metadata.js.map +1 -1
  507. package/lib/module/features/network.js +6 -2
  508. package/lib/module/features/network.js.map +1 -1
  509. package/lib/module/features/nowPlaying.js +29 -15
  510. package/lib/module/features/nowPlaying.js.map +1 -1
  511. package/lib/module/features/output.js +10 -5
  512. package/lib/module/features/output.js.map +1 -1
  513. package/lib/module/features/playback/controls.js +13 -6
  514. package/lib/module/features/playback/controls.js.map +1 -1
  515. package/lib/module/features/playback/playWhenReady.js +6 -5
  516. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  517. package/lib/module/features/playback/playing.js +5 -3
  518. package/lib/module/features/playback/playing.js.map +1 -1
  519. package/lib/module/features/playback/progress.js +13 -6
  520. package/lib/module/features/playback/progress.js.map +1 -1
  521. package/lib/module/features/playback/rate.js +8 -1
  522. package/lib/module/features/playback/rate.js.map +1 -1
  523. package/lib/module/features/playback/state.js +5 -6
  524. package/lib/module/features/playback/state.js.map +1 -1
  525. package/lib/module/features/playback/trackPlaybackTime.js +6 -6
  526. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  527. package/lib/module/features/playback/volume.js +6 -5
  528. package/lib/module/features/playback/volume.js.map +1 -1
  529. package/lib/module/features/player/options.js +22 -27
  530. package/lib/module/features/player/options.js.map +1 -1
  531. package/lib/module/features/player/setup.js +40 -40
  532. package/lib/module/features/player/setup.js.map +1 -1
  533. package/lib/module/features/player/validateOptions.js +19 -0
  534. package/lib/module/features/player/validateOptions.js.map +1 -0
  535. package/lib/module/features/queue/activeTrack.js +15 -5
  536. package/lib/module/features/queue/activeTrack.js.map +1 -1
  537. package/lib/module/features/queue/queue.js +58 -23
  538. package/lib/module/features/queue/queue.js.map +1 -1
  539. package/lib/module/features/queue/repeatMode.js +3 -2
  540. package/lib/module/features/queue/repeatMode.js.map +1 -1
  541. package/lib/module/features/queue/shuffle.js +1 -2
  542. package/lib/module/features/queue/shuffle.js.map +1 -1
  543. package/lib/module/features/remoteControls.js +70 -125
  544. package/lib/module/features/remoteControls.js.map +1 -1
  545. package/lib/module/features/sleepTimer.js +25 -8
  546. package/lib/module/features/sleepTimer.js.map +1 -1
  547. package/lib/module/test-utils/reactNativeStub.js +58 -0
  548. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  549. package/lib/module/utils/LazyNativeEmitter.js +25 -14
  550. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  551. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  552. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  553. package/lib/module/utils/getTrackIdentity.js +22 -0
  554. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  555. package/lib/module/utils/useDebug.js +16 -3
  556. package/lib/module/utils/useDebug.js.map +1 -1
  557. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  558. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  559. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  560. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  561. package/lib/module/web/NativeAudioBrowser.js +207 -84
  562. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  563. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  564. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  565. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  566. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  567. package/lib/module/web/TrackPlayer/Player.js +256 -40
  568. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  569. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  570. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  571. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  572. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  573. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  574. package/lib/module/web/browser/BrowserManager.js +175 -100
  575. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  576. package/lib/module/web/browser/FavoriteManager.js +31 -21
  577. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  578. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  579. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  580. package/lib/module/web/browser/SearchManager.js +18 -23
  581. package/lib/module/web/browser/SearchManager.js.map +1 -1
  582. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  583. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  584. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  585. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  586. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  587. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  588. package/lib/module/web/browser/sections.js +83 -0
  589. package/lib/module/web/browser/sections.js.map +1 -0
  590. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  591. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  592. package/lib/module/web/http/followMediaRedirect.js +215 -0
  593. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  594. package/lib/module/web/player/NowPlayingManager.js +4 -3
  595. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  596. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  597. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  598. package/lib/typescript/package.json +1 -0
  599. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  600. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  601. package/lib/typescript/src/features/battery.d.ts +17 -12
  602. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  603. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  604. package/lib/typescript/src/features/browser.d.ts +67 -19
  605. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  606. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  607. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  608. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  609. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  610. package/lib/typescript/src/features/errors.d.ts +37 -22
  611. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  612. package/lib/typescript/src/features/favorites.d.ts +29 -24
  613. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  614. package/lib/typescript/src/features/gate.d.ts +32 -10
  615. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  616. package/lib/typescript/src/features/metadata.d.ts +68 -17
  617. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  618. package/lib/typescript/src/features/network.d.ts +6 -2
  619. package/lib/typescript/src/features/network.d.ts.map +1 -1
  620. package/lib/typescript/src/features/nowPlaying.d.ts +29 -15
  621. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  622. package/lib/typescript/src/features/output.d.ts +10 -5
  623. package/lib/typescript/src/features/output.d.ts.map +1 -1
  624. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  625. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  626. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  627. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  628. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  629. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  630. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  631. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  632. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  633. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  634. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  635. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  636. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  637. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  638. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  639. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  640. package/lib/typescript/src/features/player/options.d.ts +74 -57
  641. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  642. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  643. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  644. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  645. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  646. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  647. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  648. package/lib/typescript/src/features/queue/queue.d.ts +52 -21
  649. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  650. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  651. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  652. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  653. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  654. package/lib/typescript/src/features/remoteControls.d.ts +81 -47
  655. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  656. package/lib/typescript/src/features/sleepTimer.d.ts +16 -8
  657. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  658. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  659. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  660. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  661. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  662. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  663. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  664. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  665. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  666. package/lib/typescript/src/types/browser.d.ts +242 -173
  667. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  668. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -16
  669. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  670. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  671. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  672. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  673. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  674. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  675. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  676. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  677. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  678. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  679. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  680. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  681. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  682. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  683. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  684. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  686. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  687. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  689. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  690. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  691. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  692. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  694. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  695. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  696. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  697. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  698. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  699. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  700. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  701. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  702. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  703. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  704. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  705. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  706. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  707. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  710. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  711. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  712. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  713. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  714. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  717. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  718. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  720. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  721. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  722. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  723. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  724. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  725. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  726. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  727. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  728. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  732. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  735. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  742. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  743. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  749. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  752. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  753. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  755. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  756. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  757. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  762. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  764. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  765. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  770. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  773. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  776. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  777. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  779. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  781. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  782. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  783. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  784. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  785. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  787. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  790. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  793. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  795. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  797. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  802. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  805. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  809. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  810. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  812. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  815. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  816. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  820. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  824. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  825. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  826. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  830. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  832. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  833. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  836. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  838. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  839. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  840. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  841. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  842. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  852. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  858. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  859. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  860. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  861. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  862. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  981. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  982. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  983. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  984. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  985. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  986. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  987. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  988. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  989. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  990. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  991. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  992. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  993. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  994. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  995. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  996. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  997. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  998. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  999. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1000. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1001. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1002. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1003. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1004. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1005. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1006. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1007. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1008. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1009. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1010. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1011. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1012. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1013. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1014. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1015. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1016. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1017. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1018. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1019. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1020. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1021. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1022. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1023. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1024. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1025. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1026. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1027. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1028. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1029. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1030. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1031. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1032. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1033. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1034. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1035. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1036. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1037. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1038. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1039. package/package.json +26 -12
  1040. package/src/AudioBrowser.ts +2 -1
  1041. package/src/CLAUDE.md +57 -0
  1042. package/src/docs-floors.test.ts +71 -0
  1043. package/src/features/battery.test.ts +79 -0
  1044. package/src/features/battery.ts +17 -13
  1045. package/src/features/browser-config.test.ts +21 -6
  1046. package/src/features/browser-config.ts +13 -9
  1047. package/src/features/browser.test.ts +1 -1
  1048. package/src/features/browser.ts +69 -20
  1049. package/src/features/carConnection.ts +3 -4
  1050. package/src/features/equalizer.ts +10 -6
  1051. package/src/features/errors.ts +37 -22
  1052. package/src/features/favorites.ts +29 -24
  1053. package/src/features/gate.ts +30 -9
  1054. package/src/features/hook-wiring.test.ts +302 -0
  1055. package/src/features/metadata.ts +83 -17
  1056. package/src/features/network.ts +6 -2
  1057. package/src/features/nowPlaying.ts +29 -15
  1058. package/src/features/output.ts +10 -5
  1059. package/src/features/playback/controls.ts +13 -6
  1060. package/src/features/playback/playWhenReady.ts +6 -5
  1061. package/src/features/playback/playing.ts +16 -3
  1062. package/src/features/playback/progress.test.ts +169 -0
  1063. package/src/features/playback/progress.ts +13 -6
  1064. package/src/features/playback/rate.ts +8 -1
  1065. package/src/features/playback/state.ts +10 -6
  1066. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  1067. package/src/features/playback/trackPlaybackTime.ts +9 -7
  1068. package/src/features/playback/volume.ts +6 -5
  1069. package/src/features/player/options.ts +83 -82
  1070. package/src/features/player/setup.test.ts +12 -3
  1071. package/src/features/player/setup.ts +123 -64
  1072. package/src/features/player/validateOptions.ts +21 -0
  1073. package/src/features/queue/activeTrack.ts +15 -5
  1074. package/src/features/queue/queue.ts +58 -23
  1075. package/src/features/queue/repeatMode.ts +2 -2
  1076. package/src/features/queue/shuffle.ts +1 -2
  1077. package/src/features/remoteControls.ts +70 -125
  1078. package/src/features/sleepTimer.test.ts +171 -0
  1079. package/src/features/sleepTimer.ts +25 -9
  1080. package/src/nitro-stub-drift.test.ts +277 -0
  1081. package/src/public-surface.test.ts +147 -0
  1082. package/src/specs/audio-browser.nitro.ts +15 -8
  1083. package/src/style-resolution.test.ts +210 -0
  1084. package/src/test-utils/reactNativeStub.ts +60 -0
  1085. package/src/types/browser-native.ts +7 -3
  1086. package/src/types/browser-nodes.ts +417 -151
  1087. package/src/types/browser.ts +248 -177
  1088. package/src/utils/LazyNativeEmitter.ts +25 -15
  1089. package/src/utils/NativeUpdatedValue.ts +30 -16
  1090. package/src/utils/getTrackIdentity.ts +22 -0
  1091. package/src/utils/useDebug.test.ts +182 -0
  1092. package/src/utils/useDebug.ts +16 -3
  1093. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1094. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1095. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1096. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1097. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1098. package/src/web/NativeAudioBrowser.ts +247 -92
  1099. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1100. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1101. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1102. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1103. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1104. package/src/web/TrackPlayer/Player.ts +286 -38
  1105. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1106. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1107. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1108. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1109. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1110. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1111. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1112. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1113. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1114. package/src/web/__tests__/retry.test.ts +169 -0
  1115. package/src/web/browser/BrowserManager.ts +209 -111
  1116. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1117. package/src/web/browser/FavoriteManager.ts +28 -23
  1118. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1119. package/src/web/browser/SearchManager.test.ts +75 -0
  1120. package/src/web/browser/SearchManager.ts +25 -28
  1121. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1122. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1123. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1124. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1125. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1126. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1127. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1128. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1129. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1130. package/src/web/browser/parseSearchResponse.ts +3 -4
  1131. package/src/web/browser/sections.test.ts +91 -0
  1132. package/src/web/browser/sections.ts +72 -0
  1133. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1134. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1135. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1136. package/src/web/http/followMediaRedirect.ts +253 -0
  1137. package/src/web/player/NowPlayingManager.ts +4 -3
  1138. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1139. package/src/web/util/BrowserPathHelper.ts +68 -13
  1140. package/website/guide/android-auto.md +126 -0
  1141. package/website/guide/android-certificates.md +488 -0
  1142. package/website/guide/artwork.md +300 -0
  1143. package/website/guide/audio-output.md +357 -0
  1144. package/website/guide/automotive.md +91 -0
  1145. package/website/guide/basic-usage.md +154 -0
  1146. package/website/guide/battery.md +142 -0
  1147. package/website/guide/browser.md +674 -0
  1148. package/website/guide/carplay.md +733 -0
  1149. package/website/guide/configuration.md +215 -0
  1150. package/website/guide/equalizer.md +235 -0
  1151. package/website/guide/errors.md +355 -0
  1152. package/website/guide/favorites.md +164 -0
  1153. package/website/guide/gate.md +157 -0
  1154. package/website/guide/getting-started.md +99 -0
  1155. package/website/guide/hooks.md +247 -0
  1156. package/website/guide/live-streams.md +156 -0
  1157. package/website/guide/metadata.md +289 -0
  1158. package/website/guide/migrating-from-track-player.md +289 -0
  1159. package/website/guide/native-callback-fetch.md +137 -0
  1160. package/website/guide/network.md +102 -0
  1161. package/website/guide/now-playing.md +203 -0
  1162. package/website/guide/playback.md +405 -0
  1163. package/website/guide/queue.md +334 -0
  1164. package/website/guide/remote-controls.md +314 -0
  1165. package/website/guide/search.md +270 -0
  1166. package/website/guide/sleep-timer.md +289 -0
  1167. package/website/guide/track.md +271 -0
  1168. package/ios/Bridge.h +0 -8
  1169. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1170. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1171. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1172. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1173. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1174. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -70
  1175. package/ios/Model/MediaURL.swift +0 -67
  1176. package/ios/Model/SourceType.swift +0 -6
  1177. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1178. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1179. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1180. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1181. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1182. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1183. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1184. package/ios/Option/PitchAlgorithms.swift +0 -17
  1185. package/ios/Option/TimeEventFrequency.swift +0 -18
  1186. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1187. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1188. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1189. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1190. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1191. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1192. package/ios/Player/PlaybackStateStore.swift +0 -27
  1193. package/ios/Player/PlayingStateManager.swift +0 -33
  1194. package/ios/Player/RetryManager.swift +0 -322
  1195. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1196. package/ios/Player/SleepTimerHandling.swift +0 -15
  1197. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1198. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1199. package/ios/Tests/MediaResolveTests.swift +0 -126
  1200. package/ios/Tests/OnceValueTests.swift +0 -79
  1201. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1202. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1203. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1204. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1205. package/ios/Tests/RetryManagerTests.swift +0 -89
  1206. package/ios/TrackPlayer.swift +0 -1014
  1207. package/ios/TrackPlayerCallbacks.swift +0 -86
  1208. package/ios/Util/MetadataAdapter.swift +0 -131
  1209. package/ios/Util/OnceValue.swift +0 -104
  1210. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1211. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1212. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1213. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1214. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1215. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1216. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1217. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1218. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1219. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1220. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1221. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1222. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1223. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -41,6 +41,11 @@ function applyImageQueryParams(config, imgParams, context) {
41
41
  };
42
42
  }
43
43
 
44
+ /** Whether `after` carries a header `before` had not already set identically. */
45
+ function addsHeaders(before, after) {
46
+ if (!after) return false;
47
+ return Object.entries(after).some(([key, value]) => before?.[key] !== value);
48
+ }
44
49
  /**
45
50
  * Builds and merges request configurations.
46
51
  * Mirrors Android's RequestConfigBuilder.kt
@@ -81,7 +86,9 @@ export const RequestConfigBuilder = {
81
86
  * A layer with a transform wins completely — it receives the base (plus route
82
87
  * params) and its result replaces the base; the layer's own static fields are
83
88
  * ignored. A layer without a transform merges its static fields over the base.
84
- * `path` is carried from the base — only a transform may change it.
89
+ * `path` is carried from the base — only a transform may change it. A
90
+ * throwing transform falls back to the base, so the layer is skipped and the
91
+ * ladder continues.
85
92
  *
86
93
  * Mirrors native's BrowserManager.applyLayer so web resolves the shared
87
94
  * `request` → `<kind>` → route chain identically across platforms.
@@ -92,10 +99,21 @@ export const RequestConfigBuilder = {
92
99
  // its result replaces it. When both are set they run as a pipeline — async
93
100
  // first, then sync (mirrors native applyLayer).
94
101
  if (layer.transform || layer.transformSync) {
95
- let cfg = base;
96
- if (layer.transform) cfg = await layer.transform(cfg, params);
97
- if (layer.transformSync) cfg = layer.transformSync(cfg, params);
98
- return cfg;
102
+ try {
103
+ let cfg = base;
104
+ if (layer.transform) cfg = await layer.transform(cfg, params);
105
+ if (layer.transformSync) cfg = layer.transformSync(cfg, params);
106
+ return cfg;
107
+ } catch (e) {
108
+ // A throwing transform costs its own layer, not the ladder: the layers
109
+ // under it stand, so a relative path still gets the shared `baseUrl`
110
+ // and a media request keeps the shared credential. One catch around
111
+ // the pair, as native has it, so a sync stage that throws after a
112
+ // successful async one also falls back to the layer's input rather
113
+ // than to a half-applied config.
114
+ console.error('Failed to apply transform function, using base config', e);
115
+ return base;
116
+ }
99
117
  }
100
118
  return {
101
119
  method: layer.method ?? base.method,
@@ -138,31 +156,103 @@ export const RequestConfigBuilder = {
138
156
  };
139
157
  },
140
158
  /**
141
- * Resolves a media URL using the media configuration.
142
- * Creates a RequestConfig with the track's src as the path, then builds the URL.
143
- * Supports the transform callback for URL manipulation.
159
+ * Resolves a media request from the layered configuration, returning the
160
+ * whole request rather than just its URL.
161
+ *
162
+ * The layers resolve headers (and a user agent) alongside the URL, and the
163
+ * media request needs all of them: native applies them to the AVURLAsset /
164
+ * ExoPlayer DataSpec, so web has to apply them to Shaka's requests or the
165
+ * same configuration authenticates on iOS and Android but 401s here.
144
166
  *
145
- * The shared `request` layer is applied first (its transform runs for media
146
- * too, per the documented contract — e.g. a dynamic baseUrl), then the media
147
- * transform / static fields on top. Mirrors native's resolveMediaUrl,
148
- * including its best-effort behaviour: if a transform throws, fall back to the
149
- * original `src` rather than failing the load.
167
+ * The resolved URL is returned in `path`, with `baseUrl` already folded into
168
+ * it. Best-effort throughout, but at two levels: a throwing transform or
169
+ * resolver costs only its own layer (see {@link applyLayer}), and the catch
170
+ * here is the backstop for anything left — a malformed `baseUrl` reaching
171
+ * `buildUrl`, say — which falls back to the bare `src`.
172
+ *
173
+ * The chain is `request` → `media` → `media.resolve(track)`, matching
174
+ * native's. See {@link applyMediaResolve} for why the per-track resolver goes
175
+ * last.
150
176
  *
151
177
  * @param src The track's src value (may be relative or absolute)
152
178
  * @param requestConfig The shared request configuration (applied first)
153
179
  * @param mediaConfig The media request configuration
154
- * @returns The resolved absolute URL
180
+ * @param track The track being loaded, for `media.resolve`; without it the
181
+ * per-track layer is skipped and the static layers stand
182
+ * @returns The resolved request, its URL in `path`
155
183
  */
156
- async resolveMediaUrl(src, requestConfig, mediaConfig) {
184
+ async resolveMediaRequest(src, requestConfig, mediaConfig, track) {
157
185
  try {
158
- const config = await this.applyLayers({
186
+ // The layers are applied one at a time rather than through `applyLayers`
187
+ // so the media layer's own header contribution stays visible; each
188
+ // transform still runs exactly once.
189
+ const shared = await this.applyLayer({
159
190
  path: src
160
- }, [requestConfig, mediaConfig]);
161
- return BrowserPathHelper.buildUrl(config.baseUrl, config.path ?? src);
191
+ }, requestConfig);
192
+ const layered = await this.applyLayer(shared, mediaConfig);
193
+ const config = await this.applyMediaResolve(layered, mediaConfig, track);
194
+ // buildUrl folds in baseUrl *and* appends `query`; both are cleared on
195
+ // the way out so the resolved url can't be rebuilt and double-applied.
196
+ return {
197
+ ...config,
198
+ baseUrl: undefined,
199
+ query: undefined,
200
+ path: this.buildUrl({
201
+ ...config,
202
+ path: config.path ?? src
203
+ }),
204
+ mediaLayerHeaders: addsHeaders(shared.headers, config.headers)
205
+ };
162
206
  } catch (e) {
163
207
  console.error('Failed to resolve media URL, using original src', e);
164
- return BrowserPathHelper.buildUrl(undefined, src);
208
+ return {
209
+ path: BrowserPathHelper.buildUrl(undefined, src),
210
+ mediaLayerHeaders: false
211
+ };
212
+ }
213
+ },
214
+ /**
215
+ * Applies `media.resolve(track)` / `media.resolveSync(track)` as the final,
216
+ * most-specific layer over an already request+media-layered config. A no-op
217
+ * without a track or a resolver, so the layers stand on their own.
218
+ *
219
+ * Last, not first: native runs the media layer's transform and then lets the
220
+ * per-track resolver win over the result (Android `applyMediaResolve`, iOS
221
+ * `applyMediaResolveLayer`), so a resolver minting a signed URL is not
222
+ * overwritten by the static layer that shaped the unsigned one. Override-wins
223
+ * on every field, `path` included — replacing the URL outright is the point.
224
+ *
225
+ * A throwing resolver falls back to the layered config, as native does: the
226
+ * per-track shaping is lost, the layers under it are not.
227
+ */
228
+ async applyMediaResolve(layered, mediaConfig, track) {
229
+ if (!track || !mediaConfig) return layered;
230
+ if (!mediaConfig.resolve && !mediaConfig.resolveSync) return layered;
231
+ try {
232
+ const resolved = await this.composeResolved(mediaConfig, track);
233
+ return resolved ? this.mergeConfig(layered, resolved) : layered;
234
+ } catch (e) {
235
+ console.error('Failed to apply media.resolve, using layered config', e);
236
+ return layered;
237
+ }
238
+ },
239
+ /**
240
+ * Runs a config's per-track resolvers and composes their output: async
241
+ * `resolve` first, then `resolveSync` merged over it, sync winning.
242
+ * `undefined` when neither is set or neither produced a config.
243
+ *
244
+ * Media and artwork share the pairing, so it lives here rather than in both
245
+ * — the same reason native has `composeResolved`. Errors are the callers' to
246
+ * handle: the two paths differ on what a throwing resolver costs.
247
+ */
248
+ async composeResolved(config, track) {
249
+ let resolved;
250
+ if (config.resolve) resolved = await config.resolve(track);
251
+ if (config.resolveSync) {
252
+ const sync = config.resolveSync(track);
253
+ resolved = resolved ? this.mergeConfig(resolved, sync) : sync;
165
254
  }
255
+ return resolved;
166
256
  },
167
257
  /**
168
258
  * Resolves an artwork URL and creates an ImageSource.
@@ -246,14 +336,7 @@ export const RequestConfigBuilder = {
246
336
 
247
337
  // Step 1: Per-track resolution — async `resolve` first, then `resolveSync`
248
338
  // merged over it (mirrors native).
249
- let resolvedConfig;
250
- if (artworkConfig.resolve) {
251
- resolvedConfig = await artworkConfig.resolve(track);
252
- }
253
- if (artworkConfig.resolveSync) {
254
- const r = artworkConfig.resolveSync(track);
255
- resolvedConfig = resolvedConfig ? this.mergeConfig(resolvedConfig, r) : r;
256
- }
339
+ const resolvedConfig = await this.composeResolved(artworkConfig, track);
257
340
  // If a resolver ran but produced nothing and there's no artwork URL, no artwork
258
341
  if ((artworkConfig.resolve || artworkConfig.resolveSync) && !resolvedConfig && artworkUrl === undefined) {
259
342
  return undefined;
@@ -1 +1 @@
1
- {"version":3,"names":["artworkUrl","resolveArtworkUrl","BrowserPathHelper","appendQueryParams","url","query","Object","keys","length","params","URLSearchParams","key","value","entries","undefined","append","String","queryString","toString","separator","includes","applyImageQueryParams","config","imgParams","context","width","height","RequestConfigBuilder","buildUrl","path","baseUrl","mergeConfig","base","override","method","headers","mergeHeaders","mergeQuery","body","contentType","userAgent","applyLayer","layer","transform","transformSync","cfg","applyLayers","layers","merged","toRequestConfig","resolveMediaUrl","src","requestConfig","mediaConfig","e","console","error","resolveArtworkSource","artworkConfig","resolvedUri","uri","resolveArtworkSourceAsync","track","imageContext","artwork","baseConfig","resolvedConfig","resolve","resolveSync","r","mergedConfig","imageQueryParams","request","finalUri","transformTrackArtwork","artworkSource"],"sourceRoot":"../../../../src","sources":["web/http/RequestConfigBuilder.ts"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["artworkUrl","resolveArtworkUrl","BrowserPathHelper","appendQueryParams","url","query","Object","keys","length","params","URLSearchParams","key","value","entries","undefined","append","String","queryString","toString","separator","includes","applyImageQueryParams","config","imgParams","context","width","height","addsHeaders","before","after","some","RequestConfigBuilder","buildUrl","path","baseUrl","mergeConfig","base","override","method","headers","mergeHeaders","mergeQuery","body","contentType","userAgent","applyLayer","layer","transform","transformSync","cfg","e","console","error","applyLayers","layers","merged","toRequestConfig","resolveMediaRequest","src","requestConfig","mediaConfig","track","shared","layered","applyMediaResolve","mediaLayerHeaders","resolve","resolveSync","resolved","composeResolved","sync","resolveArtworkSource","artworkConfig","resolvedUri","uri","resolveArtworkSourceAsync","imageContext","artwork","baseConfig","resolvedConfig","mergedConfig","imageQueryParams","request","finalUri","transformTrackArtwork","artworkSource"],"sourceRoot":"../../../../src","sources":["web/http/RequestConfigBuilder.ts"],"mappings":"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","ignoreList":[]}
@@ -0,0 +1,215 @@
1
+ "use strict";
2
+
3
+ /**
4
+ * Resolves a media URL that is authenticated by a header.
5
+ *
6
+ * Shaka only routes manifest requests through its networking engine, where a
7
+ * request filter can attach headers. A progressive file is played by assigning
8
+ * `mediaElement.src`, and a media element cannot send custom headers — so such
9
+ * a URL is unplayable that way. Following the redirect here yields the signed,
10
+ * public URL these endpoints hand back, which needs no auth of its own.
11
+ *
12
+ * Best effort and bounded: anything that fails — including taking too long, see
13
+ * {@link PROBE_TIMEOUT_MS} — falls back to the original URL, so the load fails
14
+ * or succeeds on its own terms rather than ours. It must never be the reason a
15
+ * load hangs: `load()` awaits this before Shaka sees the URL at all.
16
+ *
17
+ * Gated, because the probe is not free: a HEAD at a third-party stream host
18
+ * costs a CORS preflight, and most will refuse it, so an app that never
19
+ * authenticates its media would pay a round trip on every play for a result it
20
+ * always discards. It runs only for headers that look like media credentials
21
+ * ({@link isMediaAuth}), on media a media element actually has to play
22
+ * ({@link isManifestUrl}), and never on a URL the browser resolves locally.
23
+ */
24
+
25
+ /** URLs the browser resolves locally; there is no redirect to follow. */
26
+ const isLocalUrl = url => /^(file|blob|data|mediasource):/i.test(url);
27
+
28
+ /**
29
+ * Extensions Shaka types as a manifest, from its own `EXTENSIONS_TO_MIME_TYPES_`
30
+ * map: HLS, DASH and Smooth Streaming.
31
+ */
32
+ const MANIFEST_EXTENSIONS = new Set(['m3u8', 'mpd', 'ism']);
33
+
34
+ /**
35
+ * Whether Shaka will parse this as a manifest rather than hand it to the media
36
+ * element — in which case the probe has nothing to offer and something to cost.
37
+ *
38
+ * A manifest goes through Shaka's networking engine, where the request filter
39
+ * attaches the headers to the manifest, its segments and any key requests. The
40
+ * probe cannot improve on that, and it actively breaks it: on a cross-origin
41
+ * redirect the probe clears the headers, so the segments that Android still
42
+ * authenticates would go out bare and 401. So this is a correctness fix as much
43
+ * as it is one fewer round trip.
44
+ *
45
+ * Extension-based, and therefore partial — Shaka guesses the same way
46
+ * (`NetworkingUtils.getExtension`), but plenty of HLS endpoints have no
47
+ * extension at all. Those still get probed, which is the status quo rather than
48
+ * a regression. Nothing on `Track` carries a MIME type to do better with.
49
+ */
50
+ const isManifestUrl = url => {
51
+ const path = url.split(/[?#]/)[0] ?? '';
52
+ const filename = path.slice(path.lastIndexOf('/') + 1);
53
+ const pieces = filename.split('.');
54
+ return pieces.length > 1 && MANIFEST_EXTENSIONS.has(pieces[pieces.length - 1].toLowerCase());
55
+ };
56
+ /**
57
+ * How long the probe may take before the original URL is played instead.
58
+ *
59
+ * The same 8s the Android media client allows a connect or a read
60
+ * (`MediaFactory.mediaHttpClient`), which is generous for a HEAD but errs the
61
+ * safe way: a slow-but-working auth endpoint should not be abandoned, since
62
+ * giving up means playing a URL that will 401.
63
+ */
64
+ const PROBE_TIMEOUT_MS = 8_000;
65
+
66
+ /**
67
+ * `AbortSignal.timeout` where it exists (Safari 16+, Chrome 103+, Node 17.3+),
68
+ * else a hand-rolled equivalent, else nothing — an environment with neither
69
+ * still gets the deadline below, just without cancelling the request.
70
+ */
71
+ const timeoutSignal = ms => {
72
+ if (typeof AbortSignal === 'undefined') return undefined;
73
+ if (typeof AbortSignal.timeout === 'function') return AbortSignal.timeout(ms);
74
+ if (typeof AbortController === 'undefined') return undefined;
75
+ const controller = new AbortController();
76
+ setTimeout(() => controller.abort(), ms);
77
+ return controller.signal;
78
+ };
79
+
80
+ /**
81
+ * The probe, with a deadline. `load()` awaits this before Shaka is asked to
82
+ * play anything, so an unreachable host would otherwise stall the load
83
+ * indefinitely — no audio, and no error to show for it.
84
+ *
85
+ * Two mechanisms, each with its own job: the signal cancels the request, so a
86
+ * dead host does not hold a connection open behind us, and the race bounds *us*
87
+ * even where the fetch implementation ignores the signal. Whichever fires, the
88
+ * caller treats it as any other probe failure and plays the original URL.
89
+ */
90
+ const fetchWithDeadline = async (doFetch, url, headers, timeoutMs) => {
91
+ let timer;
92
+ try {
93
+ return await Promise.race([doFetch(url, {
94
+ method: 'HEAD',
95
+ headers,
96
+ redirect: 'follow',
97
+ signal: timeoutSignal(timeoutMs)
98
+ }), new Promise((_resolve, reject) => {
99
+ timer = setTimeout(() => reject(new Error(`Media redirect probe timed out (${timeoutMs}ms)`)), timeoutMs);
100
+ })]);
101
+ } finally {
102
+ if (timer !== undefined) clearTimeout(timer);
103
+ }
104
+ };
105
+
106
+ /**
107
+ * Whether these headers look like a media credential — the only thing the
108
+ * probe can fix, and the only thing worth a preflight.
109
+ *
110
+ * A header the `media` layer set is media-specific by construction. Otherwise
111
+ * only `Authorization` counts: an app authenticating one API for browse and
112
+ * media alike puts it on the shared `request` layer, and that is the common
113
+ * shape. Shared plumbing that also rides browse requests — an `X-Client-Version`
114
+ * — is not a credential and must not trigger the probe.
115
+ *
116
+ * The residual case is a shared layer carrying a custom auth header, say
117
+ * `X-Api-Key`, for media that needs it: move it to the `media` layer and the
118
+ * probe runs.
119
+ */
120
+ const isMediaAuth = (headers, mediaLayerHeaders) => mediaLayerHeaders || Object.keys(headers).some(key => key.toLowerCase() === 'authorization');
121
+ /**
122
+ * Origin of an http(s) URL, or undefined when it cannot be determined.
123
+ *
124
+ * Relative URLs are resolved against the document, because that is what the
125
+ * probe's own `fetch` does — a `src` of `/api/authed/7` is a request to the
126
+ * page's origin, so the credential went there. Without this a relative `src`
127
+ * has no origin, never matches the absolute URL the response reports, and the
128
+ * headers are dropped from every load that uses one.
129
+ *
130
+ * Parsed rather than pattern-matched so the comparison normalizes the way
131
+ * Android's `CrossOriginHeaderStripper.sameOrigin` does: `URL.host` omits a
132
+ * default port, so `https://a.com` and `https://a.com:443` are one origin, and
133
+ * it excludes userinfo, so `https://user@a.com` is not a third.
134
+ */
135
+ const originOf = url => {
136
+ try {
137
+ const base = typeof location === 'undefined' ? undefined : location.href;
138
+ const {
139
+ protocol,
140
+ host
141
+ } = new URL(url, base);
142
+ if (protocol !== 'http:' && protocol !== 'https:') return undefined;
143
+ return `${protocol}//${host}`;
144
+ } catch {
145
+ return undefined;
146
+ }
147
+ };
148
+
149
+ /**
150
+ * Whether the redirect left the origin the credential was addressed to.
151
+ *
152
+ * Only when both origins are known and differ. An origin we could not work out
153
+ * — a relative URL with no document base, outside a browser — is not evidence
154
+ * of a hop, and treating it as one is how the headers went missing before.
155
+ */
156
+ const leftTheOrigin = (from, to) => {
157
+ const origin = originOf(from);
158
+ return origin !== undefined && originOf(to) !== origin;
159
+ };
160
+ export async function followMediaRedirect(url, headers, {
161
+ fetchImpl,
162
+ mediaLayerHeaders = false,
163
+ timeoutMs = PROBE_TIMEOUT_MS
164
+ } = {}) {
165
+ if (!headers || Object.keys(headers).length === 0) return {
166
+ src: url,
167
+ headers
168
+ };
169
+ if (!isMediaAuth(headers, mediaLayerHeaders)) return {
170
+ src: url,
171
+ headers
172
+ };
173
+ if (isManifestUrl(url)) return {
174
+ src: url,
175
+ headers
176
+ };
177
+ if (isLocalUrl(url)) return {
178
+ src: url,
179
+ headers
180
+ };
181
+ const doFetch = fetchImpl ?? globalThis.fetch;
182
+ if (typeof doFetch !== 'function') return {
183
+ src: url,
184
+ headers
185
+ };
186
+ try {
187
+ // HEAD walks the chain without tripping download counting, which keys off
188
+ // ranged GETs. Deadlined, because the load waits on it.
189
+ const response = await fetchWithDeadline(doFetch, url, headers, timeoutMs);
190
+ const src = response.url || url;
191
+
192
+ // The status belongs to the *last* hop, so it only speaks for the
193
+ // authenticating endpoint when there was no redirect. Once one has
194
+ // happened, hop one authenticated and handed us its target, and a refusal
195
+ // past that is routinely about the method rather than the credential:
196
+ // presigned S3 and GCS URLs sign it — SigV4's canonical request opens with
197
+ // HTTPMethod, GCS V4's with HTTP_VERB — so a URL signed for GET answers a
198
+ // HEAD with 403. Keep the signed URL, which is the whole point of the walk,
199
+ // and let a real error surface through the player.
200
+ if (!response.ok && src === url) return {
201
+ src: url,
202
+ headers
203
+ };
204
+ return {
205
+ src,
206
+ headers: leftTheOrigin(url, src) ? undefined : headers
207
+ };
208
+ } catch {
209
+ return {
210
+ src: url,
211
+ headers
212
+ };
213
+ }
214
+ }
215
+ //# sourceMappingURL=followMediaRedirect.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["isLocalUrl","url","test","MANIFEST_EXTENSIONS","Set","isManifestUrl","path","split","filename","slice","lastIndexOf","pieces","length","has","toLowerCase","PROBE_TIMEOUT_MS","timeoutSignal","ms","AbortSignal","undefined","timeout","AbortController","controller","setTimeout","abort","signal","fetchWithDeadline","doFetch","headers","timeoutMs","timer","Promise","race","method","redirect","_resolve","reject","Error","clearTimeout","isMediaAuth","mediaLayerHeaders","Object","keys","some","key","originOf","base","location","href","protocol","host","URL","leftTheOrigin","from","to","origin","followMediaRedirect","fetchImpl","src","globalThis","fetch","response","ok"],"sourceRoot":"../../../../src","sources":["web/http/followMediaRedirect.ts"],"mappings":"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","ignoreList":[]}
@@ -1,6 +1,7 @@
1
1
  "use strict";
2
2
 
3
3
  import { artworkUrl } from '../../utils/artwork';
4
+ import { getTrackIdentity } from '../../utils/getTrackIdentity';
4
5
 
5
6
  /**
6
7
  * Manages now playing metadata overrides.
@@ -28,7 +29,7 @@ export class NowPlayingManager {
28
29
  album: update.album ?? currentTrack.album,
29
30
  artwork: artworkUrl(currentTrack.artwork),
30
31
  description: currentTrack.description,
31
- mediaId: currentTrack.src ?? currentTrack.url,
32
+ mediaId: getTrackIdentity(currentTrack) ?? currentTrack.path,
32
33
  genre: currentTrack.genre,
33
34
  duration
34
35
  } : {
@@ -37,7 +38,7 @@ export class NowPlayingManager {
37
38
  album: currentTrack.album,
38
39
  artwork: artworkUrl(currentTrack.artwork),
39
40
  description: currentTrack.description,
40
- mediaId: currentTrack.src ?? currentTrack.url,
41
+ mediaId: getTrackIdentity(currentTrack) ?? currentTrack.path,
41
42
  genre: currentTrack.genre,
42
43
  duration
43
44
  };
@@ -59,7 +60,7 @@ export class NowPlayingManager {
59
60
  album: this.override?.album ?? currentTrack.album,
60
61
  artwork: artworkUrl(currentTrack.artwork),
61
62
  description: currentTrack.description,
62
- mediaId: currentTrack.src ?? currentTrack.url,
63
+ mediaId: getTrackIdentity(currentTrack) ?? currentTrack.path,
63
64
  genre: currentTrack.genre,
64
65
  duration
65
66
  };
@@ -1 +1 @@
1
- {"version":3,"names":["artworkUrl","NowPlayingManager","onNowPlayingChanged","updateNowPlaying","update","currentTrack","duration","override","metadata","title","artist","album","artwork","description","mediaId","src","url","genre","getNowPlaying","undefined","clearNowPlayingOverride"],"sourceRoot":"../../../../src","sources":["web/player/NowPlayingManager.ts"],"mappings":";;AAEA,SAASA,UAAU,QAAQ,qBAAqB;;AAEhD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,CAAC;EAG7B;EACAC,mBAAmB,GAA2CA,CAAA,KAAM,CAAC,CAAC;;EAEtE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,gBAAgBA,CACdC,MAAoC,EACpCC,YAA+B,EAC/BC,QAAgB,EACV;IACN,IAAI,CAACC,QAAQ,GAAGH,MAAM;IAEtB,IAAI,CAACC,YAAY,EAAE;IAEnB,MAAMG,QAA4B,GAAGJ,MAAM,GACvC;MACEK,KAAK,EAAEL,MAAM,CAACK,KAAK,IAAIJ,YAAY,CAACI,KAAK;MACzCC,MAAM,EAAEN,MAAM,CAACM,MAAM,IAAIL,YAAY,CAACK,MAAM;MAC5CC,KAAK,EAAEP,MAAM,CAACO,KAAK,IAAIN,YAAY,CAACM,KAAK;MACzCC,OAAO,EAAEZ,UAAU,CAACK,YAAY,CAACO,OAAO,CAAC;MACzCC,WAAW,EAAER,YAAY,CAACQ,WAAW;MACrCC,OAAO,EAAET,YAAY,CAACU,GAAG,IAAIV,YAAY,CAACW,GAAG;MAC7CC,KAAK,EAAEZ,YAAY,CAACY,KAAK;MACzBX;IACF,CAAC,GACD;MACEG,KAAK,EAAEJ,YAAY,CAACI,KAAK;MACzBC,MAAM,EAAEL,YAAY,CAACK,MAAM;MAC3BC,KAAK,EAAEN,YAAY,CAACM,KAAK;MACzBC,OAAO,EAAEZ,UAAU,CAACK,YAAY,CAACO,OAAO,CAAC;MACzCC,WAAW,EAAER,YAAY,CAACQ,WAAW;MACrCC,OAAO,EAAET,YAAY,CAACU,GAAG,IAAIV,YAAY,CAACW,GAAG;MAC7CC,KAAK,EAAEZ,YAAY,CAACY,KAAK;MACzBX;IACF,CAAC;IAEL,IAAI,CAACJ,mBAAmB,CAACM,QAAQ,CAAC;EACpC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACEU,aAAaA,CACXb,YAA+B,EAC/BC,QAAgB,EACgB;IAChC,IAAI,CAACD,YAAY,EAAE,OAAOc,SAAS;IAEnC,OAAO;MACLV,KAAK,EAAE,IAAI,CAACF,QAAQ,EAAEE,KAAK,IAAIJ,YAAY,CAACI,KAAK;MACjDC,MAAM,EAAE,IAAI,CAACH,QAAQ,EAAEG,MAAM,IAAIL,YAAY,CAACK,MAAM;MACpDC,KAAK,EAAE,IAAI,CAACJ,QAAQ,EAAEI,KAAK,IAAIN,YAAY,CAACM,KAAK;MACjDC,OAAO,EAAEZ,UAAU,CAACK,YAAY,CAACO,OAAO,CAAC;MACzCC,WAAW,EAAER,YAAY,CAACQ,WAAW;MACrCC,OAAO,EAAET,YAAY,CAACU,GAAG,IAAIV,YAAY,CAACW,GAAG;MAC7CC,KAAK,EAAEZ,YAAY,CAACY,KAAK;MACzBX;IACF,CAAC;EACH;;EAEA;AACF;AACA;AACA;EACEc,uBAAuBA,CAAA,EAAS;IAC9B,IAAI,CAACb,QAAQ,GAAGY,SAAS;EAC3B;AACF","ignoreList":[]}
1
+ {"version":3,"names":["artworkUrl","getTrackIdentity","NowPlayingManager","onNowPlayingChanged","updateNowPlaying","update","currentTrack","duration","override","metadata","title","artist","album","artwork","description","mediaId","path","genre","getNowPlaying","undefined","clearNowPlayingOverride"],"sourceRoot":"../../../../src","sources":["web/player/NowPlayingManager.ts"],"mappings":";;AAEA,SAASA,UAAU,QAAQ,qBAAqB;AAChD,SAASC,gBAAgB,QAAQ,8BAA8B;;AAE/D;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,CAAC;EAG7B;EACAC,mBAAmB,GAA2CA,CAAA,KAAM,CAAC,CAAC;;EAEtE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,gBAAgBA,CACdC,MAAoC,EACpCC,YAA+B,EAC/BC,QAAgB,EACV;IACN,IAAI,CAACC,QAAQ,GAAGH,MAAM;IAEtB,IAAI,CAACC,YAAY,EAAE;IAEnB,MAAMG,QAA4B,GAAGJ,MAAM,GACvC;MACEK,KAAK,EAAEL,MAAM,CAACK,KAAK,IAAIJ,YAAY,CAACI,KAAK;MACzCC,MAAM,EAAEN,MAAM,CAACM,MAAM,IAAIL,YAAY,CAACK,MAAM;MAC5CC,KAAK,EAAEP,MAAM,CAACO,KAAK,IAAIN,YAAY,CAACM,KAAK;MACzCC,OAAO,EAAEb,UAAU,CAACM,YAAY,CAACO,OAAO,CAAC;MACzCC,WAAW,EAAER,YAAY,CAACQ,WAAW;MACrCC,OAAO,EAAEd,gBAAgB,CAACK,YAAY,CAAC,IAAIA,YAAY,CAACU,IAAI;MAC5DC,KAAK,EAAEX,YAAY,CAACW,KAAK;MACzBV;IACF,CAAC,GACD;MACEG,KAAK,EAAEJ,YAAY,CAACI,KAAK;MACzBC,MAAM,EAAEL,YAAY,CAACK,MAAM;MAC3BC,KAAK,EAAEN,YAAY,CAACM,KAAK;MACzBC,OAAO,EAAEb,UAAU,CAACM,YAAY,CAACO,OAAO,CAAC;MACzCC,WAAW,EAAER,YAAY,CAACQ,WAAW;MACrCC,OAAO,EAAEd,gBAAgB,CAACK,YAAY,CAAC,IAAIA,YAAY,CAACU,IAAI;MAC5DC,KAAK,EAAEX,YAAY,CAACW,KAAK;MACzBV;IACF,CAAC;IAEL,IAAI,CAACJ,mBAAmB,CAACM,QAAQ,CAAC;EACpC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACES,aAAaA,CACXZ,YAA+B,EAC/BC,QAAgB,EACgB;IAChC,IAAI,CAACD,YAAY,EAAE,OAAOa,SAAS;IAEnC,OAAO;MACLT,KAAK,EAAE,IAAI,CAACF,QAAQ,EAAEE,KAAK,IAAIJ,YAAY,CAACI,KAAK;MACjDC,MAAM,EAAE,IAAI,CAACH,QAAQ,EAAEG,MAAM,IAAIL,YAAY,CAACK,MAAM;MACpDC,KAAK,EAAE,IAAI,CAACJ,QAAQ,EAAEI,KAAK,IAAIN,YAAY,CAACM,KAAK;MACjDC,OAAO,EAAEb,UAAU,CAACM,YAAY,CAACO,OAAO,CAAC;MACzCC,WAAW,EAAER,YAAY,CAACQ,WAAW;MACrCC,OAAO,EAAEd,gBAAgB,CAACK,YAAY,CAAC,IAAIA,YAAY,CAACU,IAAI;MAC5DC,KAAK,EAAEX,YAAY,CAACW,KAAK;MACzBV;IACF,CAAC;EACH;;EAEA;AACF;AACA;AACA;EACEa,uBAAuBA,CAAA,EAAS;IAC9B,IAAI,CAACZ,QAAQ,GAAGW,SAAS;EAC3B;AACF","ignoreList":[]}
@@ -8,8 +8,12 @@
8
8
  * 1. System paths (prefixed with `/__`): Root, recent, and search paths
9
9
  * 2. Contextual URLs: Embed parent context in track identifiers for Media3 integration
10
10
  *
11
- * Contextual URL format: `{parentPath}?__trackId={trackSrc}`
12
- * Example: "/library/radio?__trackId=song.mp3"
11
+ * Contextual URL format: `{parentPath}?__trackId={trackIdentity}&__index={childIndex}`
12
+ * Example: "/library/radio?__trackId=song.mp3&__index=2"
13
+ *
14
+ * `__trackId` is the identity check; `__index` (the child's position on the
15
+ * page at stamp time) is only a tie-breaker between surfaces that carry the
16
+ * same identity — a stale index never selects a different track.
13
17
  *
14
18
  * This allows:
15
19
  * - Media3 to reference playable-only tracks (tracks with `src` but no `url`)
@@ -21,6 +25,14 @@ export const BrowserPathHelper = {
21
25
  SEARCH_PATH_PREFIX: '/__search',
22
26
  /** Query parameter name for contextual track identifiers */
23
27
  CONTEXTUAL_TRACK_PARAM: '__trackId',
28
+ /** Query parameter name for the tapped child's page position (tie-breaker) */
29
+ CONTEXTUAL_INDEX_PARAM: '__index',
30
+ /**
31
+ * Whether a navigation error on this path came from a browse or a search
32
+ */
33
+ navigationErrorKind(path) {
34
+ return path.startsWith(`${this.SEARCH_PATH_PREFIX}?`) ? 'search' : 'browse';
35
+ },
24
36
  /**
25
37
  * Create a search path for a given query
26
38
  */
@@ -38,13 +50,13 @@ export const BrowserPathHelper = {
38
50
  return path.includes(`?${this.CONTEXTUAL_TRACK_PARAM}=`) || path.includes(`&${this.CONTEXTUAL_TRACK_PARAM}=`);
39
51
  },
40
52
  /**
41
- * Strips the __trackId parameter from a contextual URL to get the parent path.
42
- * If the URL is not contextual, returns it unchanged.
53
+ * Strips the contextual parameters (__trackId and __index) from a contextual
54
+ * URL to get the parent path. If the URL is not contextual, returns it unchanged.
43
55
  *
44
56
  * @param url The URL to process
45
- * @returns The URL without the __trackId parameter
57
+ * @returns The URL without the contextual parameters
46
58
  *
47
- * Example: "/library/radio?__trackId=song.mp3" → "/library/radio"
59
+ * Example: "/library/radio?__trackId=song.mp3&__index=2" → "/library/radio"
48
60
  * Example: "/search?q=jazz&__trackId=song.mp3" → "/search?q=jazz"
49
61
  */
50
62
  stripTrackId(url) {
@@ -56,8 +68,9 @@ export const BrowserPathHelper = {
56
68
  const isFullUrl = url.startsWith('http://') || url.startsWith('https://');
57
69
  const urlObj = new URL(url, isFullUrl ? undefined : 'http://placeholder');
58
70
 
59
- // Remove the __trackId parameter
71
+ // Remove the contextual parameters
60
72
  urlObj.searchParams.delete(this.CONTEXTUAL_TRACK_PARAM);
73
+ urlObj.searchParams.delete(this.CONTEXTUAL_INDEX_PARAM);
61
74
 
62
75
  // Return the appropriate format
63
76
  if (isFullUrl) {
@@ -68,7 +81,7 @@ export const BrowserPathHelper = {
68
81
  }
69
82
  } catch {
70
83
  // Fallback: simple string manipulation
71
- const paramPattern = new RegExp(`[?&]${this.CONTEXTUAL_TRACK_PARAM}=[^&]*`, 'g');
84
+ const paramPattern = new RegExp(`[?&](?:${this.CONTEXTUAL_TRACK_PARAM}|${this.CONTEXTUAL_INDEX_PARAM})=[^&]*`, 'g');
72
85
  let result = url.replace(paramPattern, '');
73
86
  // Clean up any trailing ? or &
74
87
  result = result.replace(/[?&]$/, '');
@@ -77,6 +90,20 @@ export const BrowserPathHelper = {
77
90
  return result;
78
91
  }
79
92
  },
93
+ /**
94
+ * Builds a contextual URL by appending a track identifier — and optionally
95
+ * the tapped child's page position — to a parent path.
96
+ *
97
+ * @param trackId The track identity (`id` when non-empty, else `src`)
98
+ * @param index The child's position on the page at stamp time (tie-breaker)
99
+ *
100
+ * Example: build("/library", "song.mp3", 2) → "/library?__trackId=song.mp3&__index=2"
101
+ */
102
+ build(parentPath, trackId, index) {
103
+ const separator = parentPath.includes('?') ? '&' : '?';
104
+ const indexParam = index === undefined ? '' : `&${this.CONTEXTUAL_INDEX_PARAM}=${index}`;
105
+ return `${parentPath}${separator}${this.CONTEXTUAL_TRACK_PARAM}=${encodeURIComponent(trackId)}${indexParam}`;
106
+ },
80
107
  /**
81
108
  * Extracts the track ID from a contextual URL.
82
109
  * Returns undefined if the URL is not contextual or doesn't contain the track ID parameter.
@@ -90,14 +117,36 @@ export const BrowserPathHelper = {
90
117
  if (!this.isContextual(path)) {
91
118
  return undefined;
92
119
  }
120
+ return this.extractParam(path, this.CONTEXTUAL_TRACK_PARAM);
121
+ },
122
+ /**
123
+ * Extracts the stamped page index from a contextual URL, or undefined when
124
+ * the URL is not contextual or carries no (valid, non-negative) index.
125
+ *
126
+ * Example: "/library/radio?__trackId=song.mp3&__index=2" → 2
127
+ */
128
+ extractIndex(path) {
129
+ if (!this.isContextual(path)) {
130
+ return undefined;
131
+ }
132
+ const raw = this.extractParam(path, this.CONTEXTUAL_INDEX_PARAM);
133
+ if (raw === undefined || !/^\d+$/.test(raw)) {
134
+ return undefined;
135
+ }
136
+ return Number.parseInt(raw, 10);
137
+ },
138
+ /**
139
+ * Extracts a single query parameter, handling both full URLs and paths,
140
+ * with a regex fallback for input the URL parser rejects.
141
+ */
142
+ extractParam(path, param) {
93
143
  try {
94
- // Parse the URL - handle both full URLs and paths
95
144
  const isFullUrl = path.startsWith('http://') || path.startsWith('https://');
96
145
  const urlObj = new URL(path, isFullUrl ? undefined : 'http://placeholder');
97
- return urlObj.searchParams.get(this.CONTEXTUAL_TRACK_PARAM) ?? undefined;
146
+ return urlObj.searchParams.get(param) ?? undefined;
98
147
  } catch {
99
148
  // Fallback: regex extraction
100
- const match = path.match(new RegExp(`[?&]${this.CONTEXTUAL_TRACK_PARAM}=([^&]*)`));
149
+ const match = path.match(new RegExp(`[?&]${param}=([^&]*)`));
101
150
  return match?.[1] ? decodeURIComponent(match[1]) : undefined;
102
151
  }
103
152
  },