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

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 (1246) hide show
  1. package/README.md +66 -39
  2. package/android/build.gradle +53 -14
  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 +588 -441
  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 +84 -104
  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 +358 -541
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +36 -66
  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 -28
  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 +10 -18
  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 +28 -42
  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 +67 -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 +93 -52
  45. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  46. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  47. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +50 -33
  48. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  50. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +110 -116
  51. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +62 -38
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +121 -132
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  55. package/android/src/main/java/com/audiobrowser/player/Player.kt +490 -581
  56. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  57. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -23
  58. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +107 -129
  59. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +97 -0
  60. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +49 -128
  61. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  62. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  63. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  64. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  65. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  66. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  67. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  68. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  70. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  71. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  72. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +736 -0
  73. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  89. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  90. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  91. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  92. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  93. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  94. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  95. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  96. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  97. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  98. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  99. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  100. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  101. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  102. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  103. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  104. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  105. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  106. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  107. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  108. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  109. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  110. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  111. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  112. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  113. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  114. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  115. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  116. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  117. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  118. package/android/src/main/res/values/strings.xml +25 -5
  119. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  120. package/android/src/test/java/androidx/media3/session/SessionViews.kt +10 -0
  121. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  122. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  123. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  124. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  125. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  126. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  127. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  128. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +322 -0
  129. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  130. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  131. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  132. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  133. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  134. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  135. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  136. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  137. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  138. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  139. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  140. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  141. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  142. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  143. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +43 -0
  144. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  145. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  146. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  147. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  148. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  149. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  150. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  151. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  152. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  153. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  154. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  155. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  156. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +372 -0
  157. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  158. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  159. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  160. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  161. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  162. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  163. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  164. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  165. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  166. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  167. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  168. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  169. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  170. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  171. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +478 -0
  172. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +221 -0
  173. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  174. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  176. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +379 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +199 -0
  178. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  179. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +34 -79
  180. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +236 -0
  181. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  182. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +188 -0
  183. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  184. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  185. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  186. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  187. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +308 -0
  188. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  189. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  190. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  191. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1000 -0
  192. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  193. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  194. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  195. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  196. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  197. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  198. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  199. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  200. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  201. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  202. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  203. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  204. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  205. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  206. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  207. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  208. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  209. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  210. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  211. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  212. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  213. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  214. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  215. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  216. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  217. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  218. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  219. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  220. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  221. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  222. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  223. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  224. package/android/src/test/resources/sonos/device_description.xml +78 -0
  225. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  226. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  227. package/ios/AVPlayerEngine.swift +363 -0
  228. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  229. package/ios/Browser/BrowseGate.swift +57 -0
  230. package/ios/Browser/BrowserConfig.swift +123 -104
  231. package/ios/Browser/BrowserError.swift +15 -0
  232. package/ios/Browser/BrowserManager.swift +153 -675
  233. package/ios/Browser/BrowserPathHelper.swift +54 -117
  234. package/ios/Browser/FavoriteSet.swift +43 -0
  235. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  236. package/ios/Browser/JsonModels.swift +244 -335
  237. package/ios/Browser/NavigationErrorState.swift +42 -0
  238. package/ios/Browser/PageResolver.swift +132 -0
  239. package/ios/Browser/RequestLayer.swift +181 -0
  240. package/ios/Browser/RequestPipeline.swift +295 -0
  241. package/ios/Browser/SearchDrillIn.swift +10 -16
  242. package/ios/Browser/SectionScope.swift +73 -26
  243. package/ios/Browser/SimpleRouter.swift +76 -154
  244. package/ios/Browser/StyleResolver.swift +41 -0
  245. package/ios/Browser/TabBarEntries.swift +8 -7
  246. package/ios/Browser/TrackIdTemplate.swift +29 -0
  247. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  248. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  249. package/ios/CarPlay/CarPlayController.swift +37 -1297
  250. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  251. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  252. package/ios/CarPlay/CarPlayNowPlayingManager.swift +130 -205
  253. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  254. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  255. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  256. package/ios/CarPlay/CarPlaySession+TabBar.swift +187 -0
  257. package/ios/CarPlay/CarPlaySession.swift +203 -0
  258. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  259. package/ios/CarPlay/IntentHandlers.swift +94 -0
  260. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  261. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +9 -16
  262. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  263. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  264. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  265. package/ios/CarPlay/SectionPresentation.swift +67 -0
  266. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  267. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  268. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  269. package/ios/Extension/CxxVectorConformances.swift +4 -16
  270. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  271. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  272. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  273. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  274. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  275. package/ios/Extension/SearchParams+Query.swift +28 -0
  276. package/ios/Extension/Section+Copying.swift +26 -0
  277. package/ios/Extension/String+IcyCharset.swift +21 -0
  278. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  279. package/ios/Extension/Track+AVPlayer.swift +1 -18
  280. package/ios/Extension/Track+Copying.swift +13 -21
  281. package/ios/Extension/Track+Identity.swift +20 -0
  282. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  283. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  284. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  285. package/ios/Extension/URLError+Connectivity.swift +15 -0
  286. package/ios/Extension/Variant+Artwork.swift +8 -22
  287. package/ios/Http/HttpClient.swift +73 -167
  288. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  289. package/ios/HybridAudioBrowser+Options.swift +116 -0
  290. package/ios/HybridAudioBrowser+Player.swift +347 -0
  291. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  292. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  293. package/ios/HybridAudioBrowser.swift +148 -1689
  294. package/ios/Model/NitroTypeStubs.swift +240 -32
  295. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  296. package/ios/Model/RemoteCommand.swift +6 -78
  297. package/ios/Model/TrackPlayerError.swift +12 -21
  298. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  299. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  300. package/ios/Observer/ItemObserver.swift +92 -0
  301. package/ios/Observer/PlayerObserver.swift +59 -0
  302. package/ios/Option/SessionCategories.swift +41 -92
  303. package/ios/PlaybackEvent.swift +4 -2
  304. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  305. package/ios/Player/AudioSessionController.swift +190 -0
  306. package/ios/Player/DeferredSeek.swift +73 -0
  307. package/ios/Player/ErrorStatus.swift +52 -0
  308. package/ios/Player/MediaLoader.swift +73 -98
  309. package/ios/Player/NowPlayingLines.swift +49 -0
  310. package/ios/Player/NowPlayingUpdater.swift +180 -105
  311. package/ios/Player/PersistedPlaybackState.swift +1 -2
  312. package/ios/Player/PlaybackFailure.swift +121 -0
  313. package/ios/Player/PlaybackPersistence.swift +72 -0
  314. package/ios/Player/PlaybackStateMachine.swift +11 -11
  315. package/ios/Player/PlaybackTimer.swift +11 -8
  316. package/ios/Player/Player.swift +1010 -0
  317. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  318. package/ios/Player/PlayerEngine.swift +109 -0
  319. package/ios/Player/PlayerStatusTypes.swift +1 -6
  320. package/ios/Player/QueueManager.swift +80 -98
  321. package/ios/Player/ReconnectPacer.swift +83 -0
  322. package/ios/Player/RetryLoop.swift +334 -0
  323. package/ios/Player/ShuffleOrder.swift +36 -43
  324. package/ios/Player/SilenceBudget.swift +78 -0
  325. package/ios/Player/SleepTimerManager.swift +25 -42
  326. package/ios/Player/VolumeFader.swift +20 -15
  327. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  328. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  329. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  330. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  331. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  332. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  333. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  334. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  335. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  336. package/ios/Tests/DeferredSeekTests.swift +76 -0
  337. package/ios/Tests/EmitterTests.swift +22 -39
  338. package/ios/Tests/ErrorStatusTests.swift +50 -0
  339. package/ios/Tests/FavoriteSetTests.swift +61 -0
  340. package/ios/Tests/GenerationMemoTests.swift +178 -0
  341. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  342. package/ios/Tests/JsonModelsTests.swift +189 -3
  343. package/ios/Tests/LRUCacheTests.swift +106 -0
  344. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  345. package/ios/Tests/MediaLoaderTests.swift +38 -78
  346. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  347. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  348. package/ios/Tests/ObserverTests.swift +88 -0
  349. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  350. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  351. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  352. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  353. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  354. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  355. package/ios/Tests/PlayerPolicyTests.swift +991 -0
  356. package/ios/Tests/PlayerTests.swift +1719 -0
  357. package/ios/Tests/PlayingStateTests.swift +41 -0
  358. package/ios/Tests/QueueManagerTests.swift +205 -174
  359. package/ios/Tests/ReadyValueTests.swift +73 -0
  360. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  361. package/ios/Tests/RequestLayerTests.swift +228 -0
  362. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  363. package/ios/Tests/RetryCaseTests.swift +146 -0
  364. package/ios/Tests/RetryLoopTests.swift +307 -0
  365. package/ios/Tests/SearchDrillInTests.swift +16 -17
  366. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  367. package/ios/Tests/SectionPresentationTests.swift +85 -0
  368. package/ios/Tests/SectionScopeTests.swift +136 -54
  369. package/ios/Tests/SimpleRouterTests.swift +39 -8
  370. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  371. package/ios/Tests/StyleResolverTests.swift +123 -0
  372. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  373. package/ios/Tests/Support/TestTypes.swift +152 -100
  374. package/ios/Tests/Support/TimeLimit.swift +43 -0
  375. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  376. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  377. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  378. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  379. package/ios/Tests/TrackIdentityTests.swift +20 -0
  380. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  381. package/ios/Tests/TrackSelectorTests.swift +157 -34
  382. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  383. package/ios/TrackSelector.swift +62 -77
  384. package/ios/Util/ArtworkFreshness.swift +42 -0
  385. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  386. package/ios/Util/AwaitCallback.swift +80 -0
  387. package/ios/Util/ConcurrentMap.swift +19 -0
  388. package/ios/Util/Emitter.swift +45 -22
  389. package/ios/Util/GenerationMemo.swift +43 -0
  390. package/ios/Util/LRUCache.swift +23 -159
  391. package/ios/Util/NetworkMonitor.swift +31 -33
  392. package/ios/Util/OutputPicker.swift +48 -0
  393. package/ios/Util/ReadyValue.swift +57 -0
  394. package/ios/Util/SFSymbolRenderer.swift +64 -49
  395. package/ios/Util/SVGProcessor.swift +9 -16
  396. package/lib/commonjs/AudioBrowser.js +11 -0
  397. package/lib/commonjs/AudioBrowser.js.map +1 -1
  398. package/lib/commonjs/CLAUDE.md +57 -0
  399. package/lib/commonjs/features/battery.js +16 -12
  400. package/lib/commonjs/features/battery.js.map +1 -1
  401. package/lib/commonjs/features/browser-config.js +13 -9
  402. package/lib/commonjs/features/browser-config.js.map +1 -1
  403. package/lib/commonjs/features/browser.js +78 -20
  404. package/lib/commonjs/features/browser.js.map +1 -1
  405. package/lib/commonjs/features/carConnection.js +3 -4
  406. package/lib/commonjs/features/carConnection.js.map +1 -1
  407. package/lib/commonjs/features/equalizer.js +9 -5
  408. package/lib/commonjs/features/equalizer.js.map +1 -1
  409. package/lib/commonjs/features/errors.js +35 -21
  410. package/lib/commonjs/features/errors.js.map +1 -1
  411. package/lib/commonjs/features/favorites.js +28 -23
  412. package/lib/commonjs/features/favorites.js.map +1 -1
  413. package/lib/commonjs/features/gate.js +27 -6
  414. package/lib/commonjs/features/gate.js.map +1 -1
  415. package/lib/commonjs/features/metadata.js +61 -11
  416. package/lib/commonjs/features/metadata.js.map +1 -1
  417. package/lib/commonjs/features/network.js +5 -1
  418. package/lib/commonjs/features/network.js.map +1 -1
  419. package/lib/commonjs/features/nowPlaying.js +28 -14
  420. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  421. package/lib/commonjs/features/output.js +9 -4
  422. package/lib/commonjs/features/output.js.map +1 -1
  423. package/lib/commonjs/features/playback/controls.js +13 -6
  424. package/lib/commonjs/features/playback/controls.js.map +1 -1
  425. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  426. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  427. package/lib/commonjs/features/playback/playing.js +5 -3
  428. package/lib/commonjs/features/playback/playing.js.map +1 -1
  429. package/lib/commonjs/features/playback/progress.js +13 -6
  430. package/lib/commonjs/features/playback/progress.js.map +1 -1
  431. package/lib/commonjs/features/playback/rate.js +8 -1
  432. package/lib/commonjs/features/playback/rate.js.map +1 -1
  433. package/lib/commonjs/features/playback/state.js +5 -6
  434. package/lib/commonjs/features/playback/state.js.map +1 -1
  435. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  436. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  437. package/lib/commonjs/features/playback/volume.js +6 -5
  438. package/lib/commonjs/features/playback/volume.js.map +1 -1
  439. package/lib/commonjs/features/player/options.js +21 -11
  440. package/lib/commonjs/features/player/options.js.map +1 -1
  441. package/lib/commonjs/features/player/setup.js +39 -39
  442. package/lib/commonjs/features/player/setup.js.map +1 -1
  443. package/lib/commonjs/features/player/validateOptions.js +3 -4
  444. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  445. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  446. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  447. package/lib/commonjs/features/queue/queue.js +56 -21
  448. package/lib/commonjs/features/queue/queue.js.map +1 -1
  449. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  450. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  451. package/lib/commonjs/features/queue/shuffle.js +0 -1
  452. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  453. package/lib/commonjs/features/remoteControls.js +59 -35
  454. package/lib/commonjs/features/remoteControls.js.map +1 -1
  455. package/lib/commonjs/features/sleepTimer.js +23 -6
  456. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  457. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  458. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  459. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  460. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  461. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  462. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  463. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  464. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  465. package/lib/commonjs/utils/useDebug.js +16 -3
  466. package/lib/commonjs/utils/useDebug.js.map +1 -1
  467. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  468. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  469. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  470. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  471. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  472. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  473. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  474. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  475. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  476. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  477. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  478. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  479. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  480. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  481. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  482. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  483. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  484. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  485. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  486. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  487. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  488. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  489. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  490. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  491. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  492. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  493. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  494. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  495. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  496. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  497. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  498. package/lib/commonjs/web/browser/sections.js +89 -0
  499. package/lib/commonjs/web/browser/sections.js.map +1 -0
  500. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  501. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  502. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  503. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  504. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  505. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  506. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  507. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  508. package/lib/module/AudioBrowser.js +2 -4
  509. package/lib/module/AudioBrowser.js.map +1 -1
  510. package/lib/module/CLAUDE.md +57 -0
  511. package/lib/module/features/battery.js +16 -12
  512. package/lib/module/features/battery.js.map +1 -1
  513. package/lib/module/features/browser-config.js +13 -9
  514. package/lib/module/features/browser-config.js.map +1 -1
  515. package/lib/module/features/browser.js +78 -20
  516. package/lib/module/features/browser.js.map +1 -1
  517. package/lib/module/features/carConnection.js +3 -4
  518. package/lib/module/features/carConnection.js.map +1 -1
  519. package/lib/module/features/equalizer.js +9 -5
  520. package/lib/module/features/equalizer.js.map +1 -1
  521. package/lib/module/features/errors.js +35 -21
  522. package/lib/module/features/errors.js.map +1 -1
  523. package/lib/module/features/favorites.js +28 -23
  524. package/lib/module/features/favorites.js.map +1 -1
  525. package/lib/module/features/gate.js +27 -6
  526. package/lib/module/features/gate.js.map +1 -1
  527. package/lib/module/features/metadata.js +59 -11
  528. package/lib/module/features/metadata.js.map +1 -1
  529. package/lib/module/features/network.js +5 -1
  530. package/lib/module/features/network.js.map +1 -1
  531. package/lib/module/features/nowPlaying.js +28 -14
  532. package/lib/module/features/nowPlaying.js.map +1 -1
  533. package/lib/module/features/output.js +9 -4
  534. package/lib/module/features/output.js.map +1 -1
  535. package/lib/module/features/playback/controls.js +13 -6
  536. package/lib/module/features/playback/controls.js.map +1 -1
  537. package/lib/module/features/playback/playWhenReady.js +6 -5
  538. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  539. package/lib/module/features/playback/playing.js +5 -3
  540. package/lib/module/features/playback/playing.js.map +1 -1
  541. package/lib/module/features/playback/progress.js +13 -6
  542. package/lib/module/features/playback/progress.js.map +1 -1
  543. package/lib/module/features/playback/rate.js +8 -1
  544. package/lib/module/features/playback/rate.js.map +1 -1
  545. package/lib/module/features/playback/state.js +5 -6
  546. package/lib/module/features/playback/state.js.map +1 -1
  547. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  548. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  549. package/lib/module/features/playback/volume.js +6 -5
  550. package/lib/module/features/playback/volume.js.map +1 -1
  551. package/lib/module/features/player/options.js +21 -11
  552. package/lib/module/features/player/options.js.map +1 -1
  553. package/lib/module/features/player/setup.js +39 -39
  554. package/lib/module/features/player/setup.js.map +1 -1
  555. package/lib/module/features/player/validateOptions.js +3 -4
  556. package/lib/module/features/player/validateOptions.js.map +1 -1
  557. package/lib/module/features/queue/activeTrack.js +14 -4
  558. package/lib/module/features/queue/activeTrack.js.map +1 -1
  559. package/lib/module/features/queue/queue.js +56 -21
  560. package/lib/module/features/queue/queue.js.map +1 -1
  561. package/lib/module/features/queue/repeatMode.js +2 -1
  562. package/lib/module/features/queue/repeatMode.js.map +1 -1
  563. package/lib/module/features/queue/shuffle.js +0 -1
  564. package/lib/module/features/queue/shuffle.js.map +1 -1
  565. package/lib/module/features/remoteControls.js +59 -35
  566. package/lib/module/features/remoteControls.js.map +1 -1
  567. package/lib/module/features/sleepTimer.js +24 -7
  568. package/lib/module/features/sleepTimer.js.map +1 -1
  569. package/lib/module/test-utils/reactNativeStub.js +58 -0
  570. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  571. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  572. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  573. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  574. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  575. package/lib/module/utils/getTrackIdentity.js +22 -0
  576. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  577. package/lib/module/utils/useDebug.js +16 -3
  578. package/lib/module/utils/useDebug.js.map +1 -1
  579. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  580. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  581. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  582. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  583. package/lib/module/web/NativeAudioBrowser.js +207 -84
  584. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  585. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  586. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  587. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  588. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  589. package/lib/module/web/TrackPlayer/Player.js +256 -40
  590. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  591. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  592. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  593. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  594. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  595. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  596. package/lib/module/web/browser/BrowserManager.js +175 -100
  597. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  598. package/lib/module/web/browser/FavoriteManager.js +31 -21
  599. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  600. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  601. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  602. package/lib/module/web/browser/SearchManager.js +18 -23
  603. package/lib/module/web/browser/SearchManager.js.map +1 -1
  604. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  605. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  606. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  607. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  608. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  609. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  610. package/lib/module/web/browser/sections.js +83 -0
  611. package/lib/module/web/browser/sections.js.map +1 -0
  612. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  613. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  614. package/lib/module/web/http/followMediaRedirect.js +215 -0
  615. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  616. package/lib/module/web/player/NowPlayingManager.js +4 -3
  617. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  618. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  619. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  620. package/lib/typescript/package.json +1 -0
  621. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  622. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  623. package/lib/typescript/src/features/battery.d.ts +17 -12
  624. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  625. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  626. package/lib/typescript/src/features/browser.d.ts +67 -19
  627. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  628. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  629. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  630. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  631. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  632. package/lib/typescript/src/features/errors.d.ts +37 -22
  633. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  634. package/lib/typescript/src/features/favorites.d.ts +28 -23
  635. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  636. package/lib/typescript/src/features/gate.d.ts +29 -8
  637. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  638. package/lib/typescript/src/features/metadata.d.ts +65 -14
  639. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  640. package/lib/typescript/src/features/network.d.ts +5 -1
  641. package/lib/typescript/src/features/network.d.ts.map +1 -1
  642. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  643. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  644. package/lib/typescript/src/features/output.d.ts +9 -4
  645. package/lib/typescript/src/features/output.d.ts.map +1 -1
  646. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  647. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  648. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  649. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  650. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  651. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  652. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  653. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  654. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  655. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  656. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  657. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  658. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  659. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  660. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  661. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  662. package/lib/typescript/src/features/player/options.d.ts +73 -56
  663. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  664. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  665. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  666. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  667. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  668. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  669. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  670. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  671. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  672. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  673. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  674. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  675. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  676. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  677. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  678. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  679. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  680. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  681. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  682. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  683. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  684. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  685. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  686. package/lib/typescript/src/types/browser.d.ts +242 -173
  687. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  688. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  689. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  690. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  691. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  692. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  693. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  694. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  695. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  696. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  697. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  698. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  699. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  700. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  701. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  702. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  703. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  704. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  705. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  707. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  710. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  711. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  712. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  713. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  717. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  718. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  720. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  721. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  722. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  723. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  724. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  725. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  726. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  727. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  728. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  730. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  731. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  732. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  733. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  734. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  735. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  736. 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
  737. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  738. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  740. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  741. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  742. 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
  743. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  748. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  749. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  752. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  755. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  756. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  757. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  765. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  773. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  776. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  777. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  782. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  783. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  784. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  785. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  790. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  793. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  796. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  799. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  801. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  802. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  803. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  804. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  807. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  810. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  813. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  815. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  816. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  817. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  825. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  826. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  829. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  830. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  832. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  833. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  838. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  840. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  841. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  842. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  844. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  845. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  846. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  847. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  848. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  850. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  851. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  852. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  853. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  854. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  855. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  856. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  857. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  858. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  859. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  860. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  861. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  862. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  882. 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
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  889. 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
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  892. 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
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  895. 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
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1001. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1002. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1003. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1004. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1005. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1006. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1007. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1008. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1009. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1010. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1011. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1012. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1013. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1014. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1015. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1016. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1017. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1018. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1019. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1020. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1021. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1022. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1023. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1024. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1025. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1026. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1027. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1028. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1029. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1030. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1031. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1032. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1033. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1034. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1035. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1036. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1037. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1038. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1039. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1040. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1041. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1042. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1043. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1044. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1045. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1046. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1047. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1048. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1049. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1050. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1051. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1052. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1053. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1054. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1055. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1056. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1057. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1058. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1059. package/package.json +26 -13
  1060. package/src/AudioBrowser.ts +2 -4
  1061. package/src/CLAUDE.md +57 -0
  1062. package/src/docs-floors.test.ts +71 -0
  1063. package/src/features/battery.test.ts +79 -0
  1064. package/src/features/battery.ts +17 -13
  1065. package/src/features/browser-config.test.ts +21 -6
  1066. package/src/features/browser-config.ts +13 -9
  1067. package/src/features/browser.test.ts +1 -1
  1068. package/src/features/browser.ts +69 -20
  1069. package/src/features/carConnection.ts +3 -4
  1070. package/src/features/equalizer.ts +9 -5
  1071. package/src/features/errors.ts +37 -22
  1072. package/src/features/favorites.ts +28 -23
  1073. package/src/features/gate.ts +29 -8
  1074. package/src/features/hook-wiring.test.ts +302 -0
  1075. package/src/features/metadata.ts +80 -14
  1076. package/src/features/network.ts +5 -1
  1077. package/src/features/nowPlaying.ts +28 -14
  1078. package/src/features/output.ts +9 -4
  1079. package/src/features/playback/controls.ts +13 -6
  1080. package/src/features/playback/playWhenReady.ts +6 -5
  1081. package/src/features/playback/playing.ts +16 -3
  1082. package/src/features/playback/progress.test.ts +169 -0
  1083. package/src/features/playback/progress.ts +13 -6
  1084. package/src/features/playback/rate.ts +8 -1
  1085. package/src/features/playback/state.ts +10 -6
  1086. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1087. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1088. package/src/features/playback/volume.ts +6 -5
  1089. package/src/features/player/options.ts +82 -63
  1090. package/src/features/player/setup.test.ts +12 -3
  1091. package/src/features/player/setup.ts +122 -63
  1092. package/src/features/player/validateOptions.ts +3 -4
  1093. package/src/features/queue/activeTrack.ts +14 -4
  1094. package/src/features/queue/queue.ts +56 -21
  1095. package/src/features/queue/repeatMode.ts +1 -1
  1096. package/src/features/queue/shuffle.ts +0 -1
  1097. package/src/features/remoteControls.ts +59 -35
  1098. package/src/features/sleepTimer.test.ts +171 -0
  1099. package/src/features/sleepTimer.ts +24 -8
  1100. package/src/nitro-stub-drift.test.ts +277 -0
  1101. package/src/public-surface.test.ts +56 -25
  1102. package/src/specs/audio-browser.nitro.ts +15 -8
  1103. package/src/style-resolution.test.ts +210 -0
  1104. package/src/test-utils/reactNativeStub.ts +60 -0
  1105. package/src/types/browser-native.ts +7 -3
  1106. package/src/types/browser-nodes.ts +417 -151
  1107. package/src/types/browser.ts +248 -177
  1108. package/src/utils/LazyNativeEmitter.ts +17 -10
  1109. package/src/utils/NativeUpdatedValue.ts +30 -16
  1110. package/src/utils/getTrackIdentity.ts +22 -0
  1111. package/src/utils/useDebug.test.ts +182 -0
  1112. package/src/utils/useDebug.ts +16 -3
  1113. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1114. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1115. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1116. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1117. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1118. package/src/web/NativeAudioBrowser.ts +247 -92
  1119. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1120. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1121. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1122. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1123. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1124. package/src/web/TrackPlayer/Player.ts +286 -38
  1125. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1126. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1127. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1128. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1129. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1130. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1131. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1132. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1133. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1134. package/src/web/__tests__/retry.test.ts +169 -0
  1135. package/src/web/browser/BrowserManager.ts +209 -111
  1136. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1137. package/src/web/browser/FavoriteManager.ts +28 -23
  1138. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1139. package/src/web/browser/SearchManager.test.ts +75 -0
  1140. package/src/web/browser/SearchManager.ts +25 -28
  1141. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1142. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1143. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1144. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1145. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1146. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1147. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1148. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1149. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1150. package/src/web/browser/parseSearchResponse.ts +3 -4
  1151. package/src/web/browser/sections.test.ts +91 -0
  1152. package/src/web/browser/sections.ts +72 -0
  1153. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1154. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1155. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1156. package/src/web/http/followMediaRedirect.ts +253 -0
  1157. package/src/web/player/NowPlayingManager.ts +4 -3
  1158. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1159. package/src/web/util/BrowserPathHelper.ts +68 -13
  1160. package/website/guide/android-auto.md +126 -0
  1161. package/website/guide/android-certificates.md +488 -0
  1162. package/website/guide/artwork.md +300 -0
  1163. package/website/guide/audio-output.md +357 -0
  1164. package/website/guide/automotive.md +91 -0
  1165. package/website/guide/basic-usage.md +154 -0
  1166. package/website/guide/battery.md +142 -0
  1167. package/website/guide/browser.md +674 -0
  1168. package/website/guide/carplay.md +733 -0
  1169. package/website/guide/configuration.md +215 -0
  1170. package/website/guide/equalizer.md +235 -0
  1171. package/website/guide/errors.md +355 -0
  1172. package/website/guide/favorites.md +164 -0
  1173. package/website/guide/gate.md +157 -0
  1174. package/website/guide/getting-started.md +99 -0
  1175. package/website/guide/hooks.md +247 -0
  1176. package/website/guide/live-streams.md +156 -0
  1177. package/website/guide/metadata.md +289 -0
  1178. package/website/guide/migrating-from-track-player.md +289 -0
  1179. package/website/guide/native-callback-fetch.md +137 -0
  1180. package/website/guide/network.md +102 -0
  1181. package/website/guide/now-playing.md +203 -0
  1182. package/website/guide/playback.md +405 -0
  1183. package/website/guide/queue.md +334 -0
  1184. package/website/guide/remote-controls.md +314 -0
  1185. package/website/guide/search.md +270 -0
  1186. package/website/guide/sleep-timer.md +289 -0
  1187. package/website/guide/track.md +271 -0
  1188. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1189. package/ios/Bridge.h +0 -8
  1190. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1191. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1192. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1193. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1194. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1195. package/ios/Model/MediaURL.swift +0 -67
  1196. package/ios/Model/SourceType.swift +0 -6
  1197. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1198. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1199. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1200. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1201. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1202. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1203. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1204. package/ios/Option/PitchAlgorithms.swift +0 -17
  1205. package/ios/Option/TimeEventFrequency.swift +0 -18
  1206. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1207. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1208. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1209. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1210. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1211. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1212. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1213. package/ios/Player/PlaybackStateStore.swift +0 -27
  1214. package/ios/Player/PlayingStateManager.swift +0 -33
  1215. package/ios/Player/RetryManager.swift +0 -323
  1216. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1217. package/ios/Player/SleepTimerHandling.swift +0 -15
  1218. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1219. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1220. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1221. package/ios/Tests/MediaResolveTests.swift +0 -126
  1222. package/ios/Tests/OnceValueTests.swift +0 -79
  1223. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1224. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1225. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1226. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1227. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1228. package/ios/Tests/RetryManagerTests.swift +0 -89
  1229. package/ios/TrackPlayer.swift +0 -1014
  1230. package/ios/TrackPlayerCallbacks.swift +0 -53
  1231. package/ios/Util/MetadataAdapter.swift +0 -131
  1232. package/ios/Util/OnceValue.swift +0 -104
  1233. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1234. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1235. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1236. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1237. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1238. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1239. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1240. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1241. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1242. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1243. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1244. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1245. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1246. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -5,7 +5,7 @@ import os.log
5
5
 
6
6
  @MainActor protocol TrackSelectionBrowser {
7
7
  func awaitTrackLoadHandler(event: TrackLoadEvent) async -> Bool
8
- func expandQueueFromContextualUrl(_ url: String) async throws -> (tracks: [Track], selectedIndex: Int)?
8
+ func expandQueueFromContextualPath(_ path: String) async throws -> (tracks: [Track], selectedIndex: Int)?
9
9
  }
10
10
 
11
11
  @MainActor protocol TrackSelectionPlayer {
@@ -13,13 +13,8 @@ import os.log
13
13
  var queueSourcePath: String? { get }
14
14
  }
15
15
 
16
- /// Encapsulates the shared track selection decision tree used by both
17
- /// HybridAudioBrowser and CarPlayController.
18
- ///
19
- /// Resolves a track selection to a concrete `SelectionResult` describing
20
- /// what the caller should do. Each caller then executes the action in its
21
- /// own way (CarPlay: showNowPlaying + completion; HybridAudioBrowser:
22
- /// direct player calls).
16
+ /// Decides what selecting a track does, for both HybridAudioBrowser and CarPlaySession;
17
+ /// each caller carries out the returned `SelectionResult` its own way.
23
18
  @MainActor
24
19
  class TrackSelector {
25
20
  private let logger = Logger(subsystem: "com.audiobrowser", category: "TrackSelector")
@@ -32,110 +27,100 @@ class TrackSelector {
32
27
  // MARK: - Result Types
33
28
 
34
29
  enum SelectionResult {
35
- /// Playback action determined and not intercepted by JS handler.
36
30
  case play(PlaybackIntent)
37
- /// JS handleTrackLoad handler intercepted — caller should not play.
31
+ /// The app's `handleTrackLoad` took the selection; the caller plays nothing.
38
32
  case intercepted
39
- /// Track is browsable — caller should navigate to this URL.
40
- case browse(url: String)
41
- /// Nothing to do (no src, no url).
33
+ /// The track has no `src`; the caller navigates to `path`.
34
+ case browse(path: String)
42
35
  case none
43
36
  }
44
37
 
45
38
  enum PlaybackIntent {
46
- /// Skip to an index in the existing queue.
47
39
  case skipTo(index: Int)
48
- /// Replace queue with new tracks.
49
40
  case setQueue(tracks: [Track], startIndex: Int, sourcePath: String?)
50
- /// Load a single track.
51
41
  case loadTrack(Track)
52
42
  }
53
43
 
54
44
  // MARK: - Selection
55
45
 
56
- /// Resolves a track selection to a concrete action.
57
- /// Handles contextual URL expansion, queue reuse, and handler interception.
46
+ /// Resolves a selection: nothing for a disabled track; for a contextual path, a skip within
47
+ /// the current queue when it came from the same parent, else the parent expanded into a queue
48
+ /// (the track alone if expansion fails); a single track for a `src`; browse for a bare `path`.
49
+ /// A playback is first offered to the app's `handleTrackLoad`, which can intercept it.
58
50
  func select(
59
51
  track: Track,
60
52
  player: some TrackSelectionPlayer,
61
53
  ) async -> SelectionResult {
62
- let url = track.url
63
-
64
- // 1. Contextual URL (playable-only track with queue context)
65
- if let url, BrowserPathHelper.isContextual(url) {
66
- return await handleContextualUrl(url, track: track, player: player)
54
+ // Checked here, not only in the UI: a stale resume path can still deliver a disabled track.
55
+ if track.disabled == true {
56
+ return .none
67
57
  }
68
58
 
69
- // 2. Has src — single playable track
70
- if track.src != nil {
71
- return await handlePlayableTrack(track, player: player)
59
+ let playback: PlannedPlayback
60
+ if let path = track.path, BrowserPathHelper.isContextual(path) {
61
+ playback = await contextualPlayback(path, track: track, player: player)
62
+ } else if track.src != nil {
63
+ playback = .single(track)
64
+ } else if let path = track.path {
65
+ return .browse(path: path)
66
+ } else {
67
+ return .none
72
68
  }
73
69
 
74
- // 3. Has url — browsable
75
- if let url {
76
- return .browse(url: url)
70
+ let event = TrackLoadEvent(track: track, queue: playback.queue, startIndex: Double(playback.index))
71
+ if await browserManager.awaitTrackLoadHandler(event: event) {
72
+ return .intercepted
77
73
  }
78
-
79
- // 4. Neither
80
- return .none
74
+ return .play(playback.intent)
81
75
  }
82
76
 
83
77
  // MARK: - Private Helpers
84
78
 
85
- private func handleContextualUrl(
86
- _ url: String,
79
+ /// What a selection plays, and the queue and index the track-load handler is shown.
80
+ private struct PlannedPlayback {
81
+ let queue: [Track]
82
+ let index: Int
83
+ let intent: PlaybackIntent
84
+
85
+ static func single(_ track: Track) -> PlannedPlayback {
86
+ PlannedPlayback(queue: [track], index: 0, intent: .loadTrack(track))
87
+ }
88
+ }
89
+
90
+ private func contextualPlayback(
91
+ _ path: String,
87
92
  track: Track,
88
93
  player: some TrackSelectionPlayer,
89
- ) async -> SelectionResult {
90
- let parentPath = BrowserPathHelper.stripTrackId(url)
91
- let trackId = BrowserPathHelper.extractTrackId(url)
92
-
93
- // Check if queue already came from this parent path — just skip to the track
94
- if let trackId,
95
- parentPath == player.queueSourcePath,
96
- let index = player.tracks.firstIndex(where: { $0.src == trackId })
97
- {
98
- logger.debug("Queue already from \(parentPath), skipping to index \(index)")
99
- let queue = player.tracks
100
- let event = TrackLoadEvent(track: track, queue: queue, startIndex: Double(index))
101
- if await browserManager.awaitTrackLoadHandler(event: event) {
102
- return .intercepted
94
+ ) async -> PlannedPlayback {
95
+ let parentPath = BrowserPathHelper.stripTrackId(path)
96
+ let trackId = BrowserPathHelper.extractTrackId(path)
97
+
98
+ // Exact path first: its `__index` pins the tapped copy when the page holds the same identity
99
+ // more than once. Identity matching is only for index-less paths (e.g. from persisted state
100
+ // without one); an indexed path with no exact match expands instead, re-scoping
101
+ // the queue to the tapped section.
102
+ if parentPath == player.queueSourcePath {
103
+ var skipIndex = player.tracks.firstIndex(where: { $0.path == path })
104
+ if skipIndex == nil, BrowserPathHelper.extractIndex(path) == nil, let trackId {
105
+ skipIndex = player.tracks.firstIndex(where: { $0.identity == trackId })
106
+ }
107
+ if let index = skipIndex {
108
+ logger.debug("Queue already from \(parentPath), skipping to index \(index)")
109
+ return PlannedPlayback(queue: player.tracks, index: index, intent: .skipTo(index: index))
103
110
  }
104
- return .play(.skipTo(index: index))
105
111
  }
106
112
 
107
- // Expand the queue from the contextual URL
108
113
  do {
109
- if let expanded = try await browserManager.expandQueueFromContextualUrl(url) {
110
- let (tracks, startIndex) = expanded
111
- let event = TrackLoadEvent(track: track, queue: tracks, startIndex: Double(startIndex))
112
- if await browserManager.awaitTrackLoadHandler(event: event) {
113
- return .intercepted
114
- }
115
- return .play(.setQueue(tracks: tracks, startIndex: startIndex, sourcePath: parentPath))
116
- } else {
117
- // Fallback: single track
118
- return await singleTrackResult(track)
114
+ guard let (tracks, startIndex) = try await browserManager.expandQueueFromContextualPath(path) else {
115
+ return .single(track)
119
116
  }
117
+ return PlannedPlayback(
118
+ queue: tracks, index: startIndex,
119
+ intent: .setQueue(tracks: tracks, startIndex: startIndex, sourcePath: parentPath),
120
+ )
120
121
  } catch {
121
122
  logger.error("Error expanding queue: \(error.localizedDescription)")
122
- // Fallback to single track
123
- return await singleTrackResult(track)
124
- }
125
- }
126
-
127
- private func handlePlayableTrack(
128
- _ track: Track,
129
- player _: some TrackSelectionPlayer,
130
- ) async -> SelectionResult {
131
- await singleTrackResult(track)
132
- }
133
-
134
- private func singleTrackResult(_ track: Track) async -> SelectionResult {
135
- let event = TrackLoadEvent(track: track, queue: [track], startIndex: 0)
136
- if await browserManager.awaitTrackLoadHandler(event: event) {
137
- return .intercepted
123
+ return .single(track)
138
124
  }
139
- return .play(.loadTrack(track))
140
125
  }
141
126
  }
@@ -0,0 +1,42 @@
1
+ import Foundation
2
+
3
+ enum ArtworkFreshness {
4
+ /// Used when no response states a lifetime; matches Kingfisher's default disk expiry.
5
+ static let defaultLifetime: TimeInterval = 7 * 24 * 60 * 60
6
+
7
+ /// The shortest lifetime stated across `responses` (every redirect and the final response):
8
+ /// `max-age` minus `Age`, or 0 for `no-cache` or `no-store`. Responses that state none are
9
+ /// ignored; `defaultLifetime` when none states one.
10
+ static func lifetime(of responses: [HTTPURLResponse]) -> TimeInterval {
11
+ responses.compactMap(lifetime(of:)).min() ?? defaultLifetime
12
+ }
13
+
14
+ private static func lifetime(of response: HTTPURLResponse) -> TimeInterval? {
15
+ guard let cacheControl = response.value(forHTTPHeaderField: "Cache-Control") else { return nil }
16
+ var maxAge: TimeInterval?
17
+ for directive in cacheControl.split(separator: ",") {
18
+ let parts = directive.split(separator: "=", maxSplits: 1, omittingEmptySubsequences: false)
19
+ let name = parts[0].trimmingCharacters(in: .whitespaces).lowercased()
20
+ let value = parts.count == 2 ? parts[1].trimmingCharacters(in: .whitespaces).trimmingCharacters(in: ["\""]) : nil
21
+ switch name {
22
+ // `no-cache="field"` restricts reuse of that field only, not of the response.
23
+ case "no-cache" where value == nil, "no-store":
24
+ return 0
25
+ case "max-age":
26
+ maxAge = value.flatMap(deltaSeconds) ?? maxAge
27
+ default:
28
+ break
29
+ }
30
+ }
31
+ guard let maxAge else { return nil }
32
+ let age = response.value(forHTTPHeaderField: "Age").flatMap(deltaSeconds) ?? 0
33
+ return max(0, maxAge - age)
34
+ }
35
+
36
+ /// RFC 9111 delta-seconds: digits only (so `inf` or `1e999` are rejected), capped at 2^31.
37
+ private static func deltaSeconds(_ value: String) -> TimeInterval? {
38
+ guard !value.isEmpty, value.allSatisfy({ ("0" ... "9").contains($0) }), let seconds = TimeInterval(value)
39
+ else { return nil }
40
+ return min(seconds, 2_147_483_648)
41
+ }
42
+ }
@@ -1,14 +1,24 @@
1
1
  import Kingfisher
2
+ import Network
2
3
  import NitroModules
3
4
  import os.log
4
5
  import UIKit
5
6
 
6
- /// Single entry point for loading artwork images from URLs via Kingfisher.
7
+ /// Loads artwork through Kingfisher, refetching an HTTP image once its cached copy is stale.
7
8
  enum ArtworkImageFetcher {
8
9
  private static let logger = Logger(subsystem: "com.audiobrowser", category: "ArtworkImageFetcher")
9
10
 
11
+ /// Returns nil when the image cannot be loaded, logging a failed fetch (not an unparseable URI). A stale image whose refetch fails
12
+ /// falls back to the cached copy. `svgScale` wins over `downsampleTo`.
13
+ /// - Parameter waitsForConnectivity: A fetch that fails for want of a connection waits for one
14
+ /// and tries again. A cancelled fetch that is waiting ends when the connection returns.
10
15
  @MainActor
11
- static func fetchImage(from source: ImageSource, svgScale: CGFloat? = nil) async -> UIImage? {
16
+ static func fetchImage(
17
+ from source: ImageSource,
18
+ svgScale: CGFloat? = nil,
19
+ downsampleTo: (size: CGSize, scale: CGFloat)? = nil,
20
+ waitsForConnectivity: Bool = false,
21
+ ) async -> UIImage? {
12
22
  guard let url = URL(string: source.uri) else { return nil }
13
23
 
14
24
  var options: KingfisherOptionsInfo = []
@@ -22,16 +32,143 @@ enum ArtworkImageFetcher {
22
32
  }
23
33
  options.append(.requestModifier(modifier))
24
34
  }
35
+ let processor: (any ImageProcessor)?
25
36
  if let svgScale {
26
- options.append(.processor(SVGProcessor(size: nil, scale: svgScale)))
37
+ processor = SVGProcessor(size: nil, scale: svgScale)
38
+ } else if let downsampleTo {
39
+ // The only sizing that is guaranteed: a size hint sent upstream is advisory and a CDN may
40
+ // return the original. cacheOriginalImage keeps the original on disk so another target
41
+ // size re-processes it instead of downloading it again.
42
+ processor = DownsamplingImageProcessor(size: downsampleTo.size)
43
+ options.append(.scaleFactor(downsampleTo.scale))
44
+ options.append(.cacheOriginalImage)
45
+ } else {
46
+ processor = nil
27
47
  }
48
+ if let processor { options.append(.processor(processor)) }
49
+ let retry: KingfisherOptionsInfo = waitsForConnectivity ? [.retryStrategy(ConnectivityRetry())] : []
28
50
 
51
+ // Each processed variant is fresh on its own: a variant cached before the image changed
52
+ // would otherwise outlive the refetch of another.
53
+ let key = url.absoluteString + (processor?.identifier ?? "")
54
+ // Only HTTP fetches record a lifetime, so any other scheme would otherwise refetch on every call.
55
+ let isFresh = if ["http", "https"].contains(url.scheme?.lowercased()) { await freshness.isFresh(key) } else { true }
56
+ let result: Result<UIImage, any Error> = if isFresh {
57
+ await retrieve(url, options: options + retry, freshnessKey: key)
58
+ } else {
59
+ await refetch(url, options: options, retry: retry, freshnessKey: key)
60
+ }
61
+ switch result {
62
+ case let .success(image):
63
+ return image
64
+ case let .failure(error):
65
+ logger.error("Failed to load artwork from \(source.uri): \(error.localizedDescription)")
66
+ return nil
67
+ }
68
+ }
69
+
70
+ private static let freshness = FreshnessStore()
71
+
72
+ /// Fetches past the cache. On failure returns the cached copy if there is one; otherwise, with
73
+ /// `retry`, a connectivity failure waits for a connection and fetches again. The first fetch
74
+ /// skips `retry` so a cached copy is shown without waiting for the network.
75
+ @MainActor
76
+ private static func refetch(
77
+ _ url: URL,
78
+ options: KingfisherOptionsInfo,
79
+ retry: KingfisherOptionsInfo,
80
+ freshnessKey: String,
81
+ ) async -> Result<UIImage, any Error> {
82
+ let fetched = await retrieve(url, options: options + [.forceRefresh], freshnessKey: freshnessKey)
83
+ guard case let .failure(error) = fetched else { return fetched }
84
+ if let cached = try? await KingfisherManager.shared.retrieveImage(with: url, options: options + [.onlyFromCache]) {
85
+ return .success(cached.image)
86
+ }
87
+ guard !retry.isEmpty, (error as? KingfisherError)?.isConnectivity == true else { return fetched }
88
+ return await retrieve(url, options: options + [.forceRefresh] + retry, freshnessKey: freshnessKey)
89
+ }
90
+
91
+ /// Fetches through Kingfisher and records the freshness lifetime of an image that was downloaded.
92
+ @MainActor
93
+ private static func retrieve(
94
+ _ url: URL,
95
+ options: KingfisherOptionsInfo,
96
+ freshnessKey: String,
97
+ ) async -> Result<UIImage, any Error> {
29
98
  do {
30
99
  let result = try await KingfisherManager.shared.retrieveImage(with: url, options: options)
31
- return result.image
100
+ // `.none` also covers an image re-processed from the cached original; only metrics mark a download.
101
+ if result.cacheType == .none, let metrics = result.metrics {
102
+ let responses = metrics.rawMetrics.transactionMetrics.compactMap { $0.response as? HTTPURLResponse }
103
+ await freshness.record(freshnessKey, lifetime: ArtworkFreshness.lifetime(of: responses))
104
+ }
105
+ return .success(result.image)
32
106
  } catch {
33
- logger.error("Failed to load artwork from \(source.uri): \(error.localizedDescription)")
34
- return nil
107
+ return .failure(error)
35
108
  }
36
109
  }
37
110
  }
111
+
112
+ /// Cache keys whose image is still fresh, each stored on disk with its lifetime as expiry.
113
+ private actor FreshnessStore {
114
+ private let storage = try? DiskStorage.Backend<Data>(
115
+ config: DiskStorage.Config(name: "com.audiobrowser.artwork-freshness", sizeLimit: 0),
116
+ )
117
+ private var sweptExpired = false
118
+
119
+ func isFresh(_ key: String) -> Bool {
120
+ guard let storage else { return false }
121
+ if !sweptExpired {
122
+ sweptExpired = true
123
+ _ = try? storage.removeExpiredValues()
124
+ }
125
+ return storage.isCached(forKey: key)
126
+ }
127
+
128
+ func record(_ key: String, lifetime: TimeInterval) {
129
+ guard let storage else { return }
130
+ if lifetime > 0 {
131
+ try? storage.store(value: Data(), forKey: key, expiration: .seconds(lifetime))
132
+ } else {
133
+ try? storage.remove(forKey: key)
134
+ }
135
+ }
136
+ }
137
+
138
+ private extension KingfisherError {
139
+ var isConnectivity: Bool {
140
+ guard case let .responseError(reason: .URLSessionError(error)) = self else { return false }
141
+ return (error as? URLError)?.isConnectivity == true
142
+ }
143
+ }
144
+
145
+ /// Retries a connectivity failure once a connection is back, up to `maxRetries` times; any other
146
+ /// failure, a 404 included, stops immediately.
147
+ private struct ConnectivityRetry: RetryStrategy {
148
+ private static let maxRetries = 3
149
+
150
+ func retry(context: RetryContext, retryHandler: @escaping @Sendable (RetryDecision) -> Void) {
151
+ guard context.retriedCount < Self.maxRetries, context.error.isConnectivity else {
152
+ retryHandler(.stop)
153
+ return
154
+ }
155
+ Self.whenConnected { retryHandler(.retry(userInfo: nil)) }
156
+ }
157
+
158
+ /// Calls `body` once there is a usable path, immediately if there is one already: a monitor
159
+ /// reports the current path when it starts, so a reconnect cannot be missed. The handler keeps
160
+ /// the monitor alive until it fires.
161
+ private static func whenConnected(_ body: @escaping @Sendable () -> Void) {
162
+ let monitor = NWPathMonitor()
163
+ monitor.pathUpdateHandler = { path in
164
+ guard path.status == .satisfied, monitor.pathUpdateHandler != nil else { return }
165
+ monitor.pathUpdateHandler = nil
166
+ monitor.cancel()
167
+ body()
168
+ }
169
+ monitor.start(queue: queue)
170
+ }
171
+
172
+ // Serial, so a monitor's handler never runs concurrently with itself.
173
+ private static let queue = DispatchQueue(label: "com.audiobrowser.artwork-connectivity", qos: .utility)
174
+ }
@@ -0,0 +1,80 @@
1
+ import Foundation
2
+
3
+ /// How long a JS callback with a fallback may stay silent before its caller falls back.
4
+ let callbackFallbackTimeout: Duration = .seconds(10)
5
+
6
+ /// Thrown when a JS callback stays silent past its timeout. Not a `CancellationError`: the
7
+ /// caller is still running and falls back.
8
+ struct CallbackTimeoutError: Error {}
9
+
10
+ /// Hands the subscriber the closure to call with the callback's result. Calls after the first,
11
+ /// and any after the wait has ended, are ignored.
12
+ typealias CallbackSubscription<T> = (_ deliver: @escaping @Sendable (Result<T, Error>) -> Void) -> Void
13
+
14
+ /// The result `subscribe` delivers. Unlike Nitro's `Promise.await`, a cancelled caller throws
15
+ /// `CancellationError` at once, and with a `timeout`, a silent callback throws
16
+ /// `CallbackTimeoutError` once it elapses.
17
+ nonisolated(nonsending) func awaitCallback<T>(timeout: Duration? = nil, _ subscribe: CallbackSubscription<T>) async throws -> T {
18
+ let once = ResumeOnce<T>()
19
+ let timer = timeout.map { timeout in
20
+ Task {
21
+ try await Task.sleep(for: timeout)
22
+ once.resume(.failure(CallbackTimeoutError()))
23
+ }
24
+ }
25
+ defer { timer?.cancel() }
26
+ return try await withTaskCancellationHandler {
27
+ try await withCheckedThrowingContinuation { continuation in
28
+ once.start(continuation)
29
+ subscribe { once.resume($0) }
30
+ }
31
+ } onCancel: {
32
+ once.resume(.failure(CancellationError()))
33
+ }
34
+ }
35
+
36
+ /// Resumes its continuation with the first result only, whichever thread sends it and whether it
37
+ /// comes before or after the continuation exists. A result is handed over once and never read
38
+ /// again, hence `nonisolated(unsafe)`.
39
+ private final class ResumeOnce<T>: @unchecked Sendable {
40
+ private enum State {
41
+ case waiting
42
+ case early(Result<T, Error>)
43
+ case started(CheckedContinuation<T, Error>)
44
+ case done
45
+ }
46
+
47
+ private let lock = NSLock()
48
+ private var state = State.waiting
49
+
50
+ func start(_ continuation: CheckedContinuation<T, Error>) {
51
+ let early: Result<T, Error>? = lock.withLock {
52
+ guard case let .early(result) = state else {
53
+ state = .started(continuation)
54
+ return nil
55
+ }
56
+ state = .done
57
+ return result
58
+ }
59
+ guard let early else { return }
60
+ nonisolated(unsafe) let result = early
61
+ continuation.resume(with: result)
62
+ }
63
+
64
+ func resume(_ result: Result<T, Error>) {
65
+ let continuation: CheckedContinuation<T, Error>? = lock.withLock {
66
+ switch state {
67
+ case .waiting:
68
+ state = .early(result)
69
+ return nil
70
+ case let .started(continuation):
71
+ state = .done
72
+ return continuation
73
+ case .early, .done:
74
+ return nil
75
+ }
76
+ }
77
+ nonisolated(unsafe) let result = result
78
+ continuation?.resume(with: result)
79
+ }
80
+ }
@@ -0,0 +1,19 @@
1
+ extension Array where Element: Sendable {
2
+ /// Runs `transform` on every element concurrently and returns the results in element order.
3
+ /// Cancelling the caller cancels every transform still running.
4
+ func concurrentMap<T: Sendable>(_ transform: @escaping @MainActor (Element) async -> T) async -> [T] {
5
+ await withTaskGroup(of: (Int, T).self) { group in
6
+ for (index, element) in enumerated() {
7
+ group.addTask {
8
+ let result = await transform(element)
9
+ return (index, result)
10
+ }
11
+ }
12
+ var results: [(Int, T)] = []
13
+ for await result in group {
14
+ results.append(result)
15
+ }
16
+ return results.sorted { $0.0 < $1.0 }.map(\.1)
17
+ }
18
+ }
19
+ }
@@ -1,11 +1,11 @@
1
1
  import Foundation
2
2
 
3
- /// Opaque token returned by `addListener` for targeted removal.
4
3
  public struct EmitterToken: Sendable {
5
4
  fileprivate let id: Int
6
5
  }
7
6
 
8
- /// Generic event emitter that allows multiple listeners for a single event type
7
+ /// Delivers each event to every listener, synchronously on the emitting thread. Any method may be
8
+ /// called from any thread, including from inside a listener.
9
9
  public final class Emitter<T>: @unchecked Sendable {
10
10
  private let lock = NSLock()
11
11
  private var nextId = 0
@@ -13,9 +13,6 @@ public final class Emitter<T>: @unchecked Sendable {
13
13
 
14
14
  public init() {}
15
15
 
16
- /// Adds a listener to this emitter
17
- /// - Parameter listener: The callback to invoke when an event is emitted
18
- /// - Returns: A token that can be passed to `removeListener` for targeted removal
19
16
  @discardableResult
20
17
  public func addListener(_ listener: @escaping (T) -> Void) -> EmitterToken {
21
18
  lock.lock()
@@ -29,8 +26,6 @@ public final class Emitter<T>: @unchecked Sendable {
29
26
  return EmitterToken(id: id)
30
27
  }
31
28
 
32
- /// Removes a specific listener by its token
33
- /// - Parameter token: The token returned by `addListener`
34
29
  public func removeListener(_ token: EmitterToken) {
35
30
  lock.lock()
36
31
  defer { lock.unlock() }
@@ -40,29 +35,57 @@ public final class Emitter<T>: @unchecked Sendable {
40
35
  snapshot = next
41
36
  }
42
37
 
43
- /// Removes all listeners
44
- public func removeAllListeners() {
45
- lock.lock()
46
- defer { lock.unlock() }
47
- snapshot = []
48
- }
49
-
50
- /// Emits an event to all registered listeners
51
- /// - Parameter event: The event data to emit
52
38
  public func emit(_ event: T) {
39
+ // Listeners run outside the lock, so one may add or remove listeners; a listener removed
40
+ // during an emit still receives that event.
53
41
  lock.lock()
54
- let current = snapshot // O(1) reference bump; no array copy here
42
+ let current = snapshot
55
43
  lock.unlock()
56
44
 
57
45
  for entry in current {
58
46
  entry.handler(event)
59
47
  }
60
48
  }
49
+ }
61
50
 
62
- /// Returns the number of registered listeners
63
- public var listenerCount: Int {
64
- lock.lock()
65
- defer { lock.unlock() }
66
- return snapshot.count
51
+ /// A listener registration that ends when cancelled or released.
52
+ final class Subscription {
53
+ private var cancelHandler: (() -> Void)?
54
+
55
+ init(cancel: @escaping () -> Void) {
56
+ cancelHandler = cancel
67
57
  }
58
+
59
+ func cancel() {
60
+ cancelHandler?()
61
+ cancelHandler = nil
62
+ }
63
+
64
+ deinit {
65
+ cancelHandler?()
66
+ }
67
+ }
68
+
69
+ extension Emitter {
70
+ /// Adds `listener` until the returned subscription is cancelled or released.
71
+ func subscribe(_ listener: @escaping (T) -> Void) -> Subscription {
72
+ let token = addListener(listener)
73
+ return Subscription { [weak self] in self?.removeListener(token) }
74
+ }
75
+ }
76
+
77
+ extension Emitter {
78
+ /// Like `subscribe`, but `handler` runs later on the main actor, in a Task, whichever thread
79
+ /// emitted. Off main it may run before the emit returns.
80
+ func subscribeOnMain(_ handler: @escaping @MainActor (T) -> Void) -> Subscription {
81
+ subscribe { value in
82
+ let event = MainActorHop(value: value)
83
+ Task { @MainActor in handler(event.value) }
84
+ }
85
+ }
86
+ }
87
+
88
+ /// Carries a non-Sendable emitted value to the main actor, where it is only read.
89
+ private struct MainActorHop<T>: @unchecked Sendable {
90
+ let value: T
68
91
  }
@@ -0,0 +1,43 @@
1
+ /// A value computed at most once per generation and shared by every caller of that generation.
2
+ ///
3
+ /// `invalidate()` starts a new generation. A caller whose computation finishes or fails after
4
+ /// an invalidation computes again, so `value(_:)` never returns a stale result; `compute` must
5
+ /// therefore read the state it depends on when it runs, not capture it. A failure is not kept:
6
+ /// the next caller of the same generation tries again. A cancelled caller leaves at once and stops
7
+ /// retrying; the computation runs on for the others.
8
+ @MainActor
9
+ final class GenerationMemo<Value: Sendable> {
10
+ private var generation = 0
11
+ private var current: (generation: Int, task: Task<Value, Error>)?
12
+
13
+ func invalidate() {
14
+ generation += 1
15
+ }
16
+
17
+ func value(_ compute: @escaping @MainActor () async throws -> Value) async throws -> Value {
18
+ while true {
19
+ try Task.checkCancellation()
20
+ let generation = generation
21
+ let task: Task<Value, Error>
22
+ if let current, current.generation == generation {
23
+ task = current.task
24
+ } else {
25
+ task = Task {
26
+ do {
27
+ return try await compute()
28
+ } catch {
29
+ if self.current?.generation == generation { self.current = nil }
30
+ throw error
31
+ }
32
+ }
33
+ current = (generation, task)
34
+ }
35
+ do {
36
+ let value = try await awaitCallback { deliver in Task { await deliver(task.result) } }
37
+ if generation == self.generation { return value }
38
+ } catch {
39
+ if generation == self.generation { throw error }
40
+ }
41
+ }
42
+ }
43
+ }