react-native-audio-browser 0.2.0 → 1.0.0-next.2

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 (1589) hide show
  1. package/AudioBrowser.podspec +2 -2
  2. package/README.md +209 -2
  3. package/android/build.gradle +65 -10
  4. package/android/gradle.properties +3 -3
  5. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  6. package/android/src/main/AndroidManifest.xml +29 -1
  7. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +817 -404
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  9. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  10. package/android/src/main/java/com/audiobrowser/Callbacks.kt +5 -16
  11. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  12. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  13. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +222 -0
  14. package/android/src/main/java/com/audiobrowser/Service.kt +143 -97
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  16. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +38 -0
  17. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +50 -0
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +571 -490
  19. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +269 -0
  20. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  21. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +75 -0
  22. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +104 -45
  23. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  24. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +66 -0
  25. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  26. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  27. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +14 -21
  28. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  29. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  30. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +44 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  32. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  33. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  34. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +101 -103
  35. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  36. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +15 -20
  37. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +64 -27
  38. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +42 -58
  39. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +93 -47
  40. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +136 -0
  41. package/android/src/main/java/com/audiobrowser/player/ConnectionEndSource.kt +145 -0
  42. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  43. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +25 -36
  44. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  45. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +150 -0
  46. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +204 -0
  47. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  48. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  49. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +82 -55
  50. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +809 -266
  51. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +241 -442
  52. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +341 -0
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +119 -0
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +109 -0
  55. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +126 -119
  56. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +60 -0
  57. package/android/src/main/java/com/audiobrowser/player/Player.kt +1024 -965
  58. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +7 -0
  59. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +120 -0
  60. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +225 -107
  61. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +96 -0
  62. package/android/src/main/java/com/audiobrowser/player/RetryFocus.kt +126 -0
  63. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +95 -157
  64. package/android/src/main/java/com/audiobrowser/player/RetryLocks.kt +52 -0
  65. package/android/src/main/java/com/audiobrowser/player/RetryLoop.kt +310 -0
  66. package/android/src/main/java/com/audiobrowser/player/RetryView.kt +31 -0
  67. package/android/src/main/java/com/audiobrowser/player/SessionViewListener.kt +168 -0
  68. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  69. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  70. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +41 -21
  71. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +76 -0
  72. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +96 -66
  73. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +85 -0
  74. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  75. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +104 -0
  76. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  77. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  78. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +742 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +203 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  90. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  91. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  92. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  93. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  94. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  95. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +160 -0
  96. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  97. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +72 -0
  98. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +54 -0
  99. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +363 -0
  100. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +149 -0
  101. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  102. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +29 -0
  103. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +13 -0
  104. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  105. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  106. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  107. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  108. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +54 -73
  109. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +49 -0
  110. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +33 -0
  111. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +23 -316
  112. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +18 -60
  113. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +26 -25
  114. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +12 -11
  115. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +25 -56
  116. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +204 -0
  117. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +45 -0
  118. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +8 -8
  119. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +13 -0
  120. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  121. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +3 -112
  122. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +21 -10
  123. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +127 -82
  124. package/android/src/main/res/values/strings.xml +26 -2
  125. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  126. package/android/src/test/java/androidx/media3/session/SessionViews.kt +38 -0
  127. package/android/src/test/java/com/audiobrowser/AudioFixtures.kt +59 -0
  128. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  129. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  130. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  131. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +90 -0
  132. package/android/src/test/java/com/audiobrowser/NetworkFixtures.kt +25 -0
  133. package/android/src/test/java/com/audiobrowser/RemoteOutputRoutesTest.kt +29 -0
  134. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +81 -0
  135. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  136. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  137. package/android/src/test/java/com/audiobrowser/ServiceFixtures.kt +48 -0
  138. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +290 -0
  139. package/android/src/test/java/com/audiobrowser/SessionPositionUpdatesTest.kt +114 -0
  140. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +247 -0
  141. package/android/src/test/java/com/audiobrowser/browser/ArtworkResolutionRegistryTest.kt +46 -0
  142. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +39 -0
  143. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +108 -0
  144. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  145. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  146. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +203 -0
  147. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -4
  148. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +233 -0
  149. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  150. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +53 -0
  151. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  152. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +157 -0
  153. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +2 -7
  154. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  155. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +44 -0
  156. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  157. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  158. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +134 -8
  159. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  160. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  161. package/android/src/test/java/com/audiobrowser/player/AutomaticBufferManagerTest.kt +208 -0
  162. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  163. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +193 -0
  164. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  165. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +55 -0
  166. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +219 -0
  167. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  168. package/android/src/test/java/com/audiobrowser/player/HandleTrackLoadSeekTest.kt +243 -0
  169. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  170. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +493 -0
  171. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  172. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +36 -0
  173. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  174. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +672 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  176. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +167 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +250 -0
  178. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  179. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +135 -0
  180. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  181. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  182. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  183. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +33 -0
  184. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  185. package/android/src/test/java/com/audiobrowser/player/PlayerQueueVersionTest.kt +79 -0
  186. package/android/src/test/java/com/audiobrowser/player/PlayerRemoteOutputsSeekTest.kt +105 -0
  187. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +738 -0
  188. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +195 -0
  189. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  190. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  191. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  192. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +365 -0
  193. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +222 -0
  194. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  195. package/android/src/test/java/com/audiobrowser/player/RetryFocusTest.kt +97 -0
  196. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +190 -0
  197. package/android/src/test/java/com/audiobrowser/player/RetryLocksTest.kt +48 -0
  198. package/android/src/test/java/com/audiobrowser/player/RetryLoopCaseTest.kt +181 -0
  199. package/android/src/test/java/com/audiobrowser/player/RetryLoopTest.kt +221 -0
  200. package/android/src/test/java/com/audiobrowser/player/RetryMaskingTest.kt +178 -0
  201. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +212 -0
  202. package/android/src/test/java/com/audiobrowser/player/SessionViewListenerTest.kt +225 -0
  203. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  204. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +234 -0
  205. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  206. package/android/src/test/java/com/audiobrowser/player/SleepTimerTest.kt +48 -0
  207. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  208. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +231 -0
  209. package/android/src/test/java/com/audiobrowser/player/VolumeFaderTest.kt +43 -0
  210. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +309 -0
  211. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  212. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  213. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  214. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1037 -0
  215. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  216. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  217. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  218. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  219. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  220. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  221. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  222. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  223. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +199 -0
  224. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  225. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  226. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  227. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  228. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +273 -0
  229. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +380 -0
  230. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  231. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +152 -0
  232. package/android/src/test/java/com/audiobrowser/tls/CertFixtures.kt +18 -0
  233. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +154 -0
  234. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +33 -0
  235. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  236. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +63 -0
  237. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +53 -0
  238. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +53 -0
  239. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +57 -0
  240. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  241. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  242. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +108 -0
  243. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  244. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +36 -0
  245. package/android/src/test/java/com/audiobrowser/util/RatingFavoritesTest.kt +34 -0
  246. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +50 -0
  247. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +61 -0
  248. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +125 -0
  249. package/android/src/test/resources/certs/isrg-root-x1.pem +31 -0
  250. package/android/src/test/resources/certs/letsencrypt-r13.der +0 -0
  251. package/android/src/test/resources/certs/letsencrypt-r13.pem +29 -0
  252. package/android/src/test/resources/certs/stationplaylist-leaf.pem +34 -0
  253. package/android/src/test/resources/sonos/device_description.xml +78 -0
  254. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  255. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  256. package/ios/AVPlayerEngine.swift +385 -0
  257. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  258. package/ios/Browser/BrowseGate.swift +70 -0
  259. package/ios/Browser/BrowserConfig.swift +131 -82
  260. package/ios/Browser/BrowserError.swift +15 -0
  261. package/ios/Browser/BrowserManager.swift +165 -494
  262. package/ios/Browser/BrowserPathHelper.swift +62 -96
  263. package/ios/Browser/FavoriteSet.swift +43 -0
  264. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  265. package/ios/Browser/JsonModels.swift +276 -146
  266. package/ios/Browser/NavigationErrorState.swift +42 -0
  267. package/ios/Browser/PageResolver.swift +132 -0
  268. package/ios/Browser/RequestLayer.swift +185 -0
  269. package/ios/Browser/RequestPipeline.swift +295 -0
  270. package/ios/Browser/SearchDrillIn.swift +38 -0
  271. package/ios/Browser/SectionScope.swift +82 -0
  272. package/ios/Browser/SimpleRouter.swift +76 -154
  273. package/ios/Browser/StyleResolver.swift +41 -0
  274. package/ios/Browser/TabBarEntries.swift +16 -0
  275. package/ios/Browser/TrackIdTemplate.swift +29 -0
  276. package/ios/CarPlay/CPInterfaceController+Safe.swift +167 -0
  277. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  278. package/ios/CarPlay/CarPlayController.swift +47 -717
  279. package/ios/CarPlay/CarPlayImageLoader.swift +88 -126
  280. package/ios/CarPlay/CarPlayListItemFactory.swift +244 -99
  281. package/ios/CarPlay/CarPlayNowPlayingManager.swift +206 -133
  282. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  283. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  284. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  285. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  286. package/ios/CarPlay/CarPlaySession.swift +203 -0
  287. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  288. package/ios/CarPlay/IntentHandlers.swift +94 -0
  289. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  290. package/ios/CarPlay/MediaIntentHandler.swift +68 -0
  291. package/ios/CarPlay/MediaIntentPlayback.swift +86 -0
  292. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  293. package/ios/CarPlay/RNABAudioBrowser.h +15 -10
  294. package/ios/CarPlay/RNABAudioBrowser.m +8 -15
  295. package/ios/CarPlay/RNABCarPlaySceneDelegate.m +2 -0
  296. package/ios/CarPlay/SectionPresentation.swift +67 -0
  297. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  298. package/ios/Extension/Capability+RemoteCommand.swift +22 -71
  299. package/ios/Extension/ChapterMetadata+AVFoundation.swift +3 -6
  300. package/ios/Extension/CxxVectorConformances.swift +4 -16
  301. package/ios/Extension/NavigationError+Conversion.swift +22 -8
  302. package/ios/Extension/PlayerCapabilities+Favorite.swift +5 -0
  303. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  304. package/ios/Extension/RequestConfig+Copying.swift +27 -0
  305. package/ios/Extension/ResolvedTrack+Copying.swift +20 -22
  306. package/ios/Extension/SearchParams+Query.swift +28 -0
  307. package/ios/Extension/Section+Copying.swift +26 -0
  308. package/ios/Extension/String+IcyCharset.swift +21 -0
  309. package/ios/Extension/TimedMetadata+AVFoundation.swift +11 -15
  310. package/ios/Extension/Track+AVPlayer.swift +5 -22
  311. package/ios/Extension/Track+Copying.swift +18 -20
  312. package/ios/Extension/Track+Identity.swift +20 -0
  313. package/ios/Extension/TrackMetadata+AVFoundation.swift +11 -14
  314. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  315. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  316. package/ios/Extension/URLError+Connectivity.swift +15 -0
  317. package/ios/Extension/Variant+Artwork.swift +35 -0
  318. package/ios/Http/HttpClient.swift +73 -167
  319. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  320. package/ios/HybridAudioBrowser+Options.swift +116 -0
  321. package/ios/HybridAudioBrowser+Player.swift +351 -0
  322. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  323. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  324. package/ios/HybridAudioBrowser.swift +164 -1127
  325. package/ios/Model/NitroTypeStubs.swift +533 -224
  326. package/ios/Model/PlayerUpdateOptions.swift +32 -38
  327. package/ios/Model/RemoteCommand.swift +6 -60
  328. package/ios/Model/TrackPlayerError.swift +73 -18
  329. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +65 -141
  330. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +67 -0
  331. package/ios/Observer/ItemObserver.swift +99 -0
  332. package/ios/Observer/PlayerObserver.swift +59 -0
  333. package/ios/Option/SessionCategories.swift +51 -79
  334. package/ios/PlaybackEvent.swift +4 -2
  335. package/ios/Player/AirPlayStallJudgement.swift +23 -0
  336. package/ios/Player/AudioSessionController.swift +190 -0
  337. package/ios/Player/DeferredSeek.swift +73 -0
  338. package/ios/Player/ErrorStatus.swift +56 -0
  339. package/ios/Player/MediaLoader.swift +94 -93
  340. package/ios/Player/NowPlayingLines.swift +49 -0
  341. package/ios/Player/NowPlayingUpdater.swift +213 -45
  342. package/ios/Player/PersistedPlaybackState.swift +10 -0
  343. package/ios/Player/PlaybackFailure.swift +121 -0
  344. package/ios/Player/PlaybackPersistence.swift +72 -0
  345. package/ios/Player/PlaybackStateMachine.swift +25 -17
  346. package/ios/Player/PlaybackTimer.swift +64 -0
  347. package/ios/Player/Player.swift +1127 -0
  348. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +6 -5
  349. package/ios/Player/PlayerEngine.swift +118 -0
  350. package/ios/Player/PlayerStatusTypes.swift +1 -6
  351. package/ios/Player/QueueManager.swift +137 -138
  352. package/ios/Player/ReconnectPacer.swift +83 -0
  353. package/ios/Player/RetryLoop.swift +374 -0
  354. package/ios/Player/ShuffleOrder.swift +36 -43
  355. package/ios/Player/SilenceBudget.swift +78 -0
  356. package/ios/Player/SleepTimerManager.swift +101 -31
  357. package/ios/Player/VolumeFader.swift +91 -0
  358. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  359. package/ios/RemoteCommand/RemoteCommandController.swift +112 -331
  360. package/ios/Tests/AirPlayStallJudgementTests.swift +52 -0
  361. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  362. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  363. package/ios/Tests/BrowseGateTests.swift +50 -0
  364. package/ios/Tests/BrowserPathHelperTests.swift +99 -0
  365. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  366. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  367. package/ios/Tests/ChapterMetadataAVFoundationTests.swift +2 -2
  368. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  369. package/ios/Tests/ConnectivityTests.swift +13 -0
  370. package/ios/Tests/DeferredSeekTests.swift +76 -0
  371. package/ios/Tests/EmitterTests.swift +22 -39
  372. package/ios/Tests/ErrorStatusTests.swift +50 -0
  373. package/ios/Tests/FavoriteSetTests.swift +61 -0
  374. package/ios/Tests/GenerationMemoTests.swift +178 -0
  375. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  376. package/ios/Tests/JsonModelsTests.swift +244 -0
  377. package/ios/Tests/LRUCacheTests.swift +106 -0
  378. package/ios/Tests/MediaIntentCriteriaTests.swift +176 -0
  379. package/ios/Tests/MediaIntentDeadlineTests.swift +75 -0
  380. package/ios/Tests/MediaLoaderAssetOptionsTests.swift +46 -0
  381. package/ios/Tests/MediaLoaderTests.swift +67 -74
  382. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  383. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  384. package/ios/Tests/ObserverTests.swift +106 -0
  385. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  386. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  387. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  388. package/ios/Tests/PlaybackStateMachineTests.swift +37 -20
  389. package/ios/Tests/PlaybackTimerTests.swift +54 -0
  390. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  391. package/ios/Tests/PlayerPolicyTests.swift +1808 -0
  392. package/ios/Tests/PlayerTests.swift +1677 -0
  393. package/ios/Tests/PlayingStateTests.swift +41 -0
  394. package/ios/Tests/QueueManagerTests.swift +366 -164
  395. package/ios/Tests/ReadyValueTests.swift +73 -0
  396. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  397. package/ios/Tests/RequestLayerTests.swift +228 -0
  398. package/ios/Tests/ResolvedTrackCopyingTests.swift +52 -43
  399. package/ios/Tests/RetryCaseTests.swift +146 -0
  400. package/ios/Tests/RetryLoopTests.swift +486 -0
  401. package/ios/Tests/SearchDrillInTests.swift +62 -0
  402. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  403. package/ios/Tests/SectionPresentationTests.swift +85 -0
  404. package/ios/Tests/SectionScopeTests.swift +164 -0
  405. package/ios/Tests/SimpleRouterTests.swift +39 -8
  406. package/ios/Tests/SleepTimerManagerTests.swift +156 -0
  407. package/ios/Tests/StyleResolverTests.swift +123 -0
  408. package/ios/Tests/SupersedingTaskTests.swift +148 -0
  409. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +42 -0
  410. package/ios/Tests/Support/SilentAudioFile.swift +13 -0
  411. package/ios/Tests/Support/TestTypes.swift +286 -84
  412. package/ios/Tests/Support/TimeLimit.swift +43 -0
  413. package/ios/Tests/TabBarEntriesTests.swift +69 -0
  414. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  415. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  416. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  417. package/ios/Tests/TrackIdentityTests.swift +20 -0
  418. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  419. package/ios/Tests/TrackSelectorTests.swift +171 -48
  420. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  421. package/ios/TrackSelector.swift +70 -80
  422. package/ios/Util/ArtworkFreshness.swift +42 -0
  423. package/ios/Util/ArtworkImageFetcher.swift +147 -8
  424. package/ios/Util/AwaitCallback.swift +80 -0
  425. package/ios/Util/ConcurrentMap.swift +19 -0
  426. package/ios/Util/Connectivity.swift +12 -0
  427. package/ios/Util/Deadline.swift +38 -0
  428. package/ios/Util/Emitter.swift +45 -22
  429. package/ios/Util/GenerationMemo.swift +43 -0
  430. package/ios/Util/LRUCache.swift +23 -159
  431. package/ios/Util/NetworkMonitor.swift +33 -31
  432. package/ios/Util/OutputPicker.swift +48 -0
  433. package/ios/Util/ReadyValue.swift +57 -0
  434. package/ios/Util/SFSymbolRenderer.swift +64 -49
  435. package/ios/Util/SVGProcessor.swift +9 -16
  436. package/ios/Util/SupersedingTask.swift +45 -0
  437. package/lib/commonjs/AudioBrowser.js +8 -8
  438. package/lib/commonjs/AudioBrowser.js.map +1 -1
  439. package/lib/commonjs/CLAUDE.md +57 -0
  440. package/lib/commonjs/features/battery.js +16 -12
  441. package/lib/commonjs/features/battery.js.map +1 -1
  442. package/lib/commonjs/features/browser-config.js +231 -0
  443. package/lib/commonjs/features/browser-config.js.map +1 -0
  444. package/lib/commonjs/features/browser.js +128 -169
  445. package/lib/commonjs/features/browser.js.map +1 -1
  446. package/lib/commonjs/features/carConnection.js +41 -0
  447. package/lib/commonjs/features/carConnection.js.map +1 -0
  448. package/lib/commonjs/features/equalizer.js +10 -6
  449. package/lib/commonjs/features/equalizer.js.map +1 -1
  450. package/lib/commonjs/features/errors.js +59 -13
  451. package/lib/commonjs/features/errors.js.map +1 -1
  452. package/lib/commonjs/features/favorites.js +29 -24
  453. package/lib/commonjs/features/favorites.js.map +1 -1
  454. package/lib/commonjs/features/gate.js +170 -0
  455. package/lib/commonjs/features/gate.js.map +1 -0
  456. package/lib/commonjs/features/index.js +22 -0
  457. package/lib/commonjs/features/index.js.map +1 -1
  458. package/lib/commonjs/features/metadata.js +64 -14
  459. package/lib/commonjs/features/metadata.js.map +1 -1
  460. package/lib/commonjs/features/network.js +6 -2
  461. package/lib/commonjs/features/network.js.map +1 -1
  462. package/lib/commonjs/features/nowPlaying.js +55 -6
  463. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  464. package/lib/commonjs/features/output.js +42 -23
  465. package/lib/commonjs/features/output.js.map +1 -1
  466. package/lib/commonjs/features/playback/controls.js +20 -4
  467. package/lib/commonjs/features/playback/controls.js.map +1 -1
  468. package/lib/commonjs/features/playback/index.js +11 -0
  469. package/lib/commonjs/features/playback/index.js.map +1 -1
  470. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  471. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  472. package/lib/commonjs/features/playback/playing.js +5 -3
  473. package/lib/commonjs/features/playback/playing.js.map +1 -1
  474. package/lib/commonjs/features/playback/progress.js +40 -17
  475. package/lib/commonjs/features/playback/progress.js.map +1 -1
  476. package/lib/commonjs/features/playback/rate.js +8 -1
  477. package/lib/commonjs/features/playback/rate.js.map +1 -1
  478. package/lib/commonjs/features/playback/state.js +5 -6
  479. package/lib/commonjs/features/playback/state.js.map +1 -1
  480. package/lib/commonjs/features/playback/trackPlaybackTime.js +91 -0
  481. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -0
  482. package/lib/commonjs/features/playback/volume.js +6 -5
  483. package/lib/commonjs/features/playback/volume.js.map +1 -1
  484. package/lib/commonjs/features/player/options.js +99 -39
  485. package/lib/commonjs/features/player/options.js.map +1 -1
  486. package/lib/commonjs/features/player/setup.js +258 -4
  487. package/lib/commonjs/features/player/setup.js.map +1 -1
  488. package/lib/commonjs/features/player/validateOptions.js +23 -0
  489. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  490. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  491. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  492. package/lib/commonjs/features/queue/queue.js +77 -24
  493. package/lib/commonjs/features/queue/queue.js.map +1 -1
  494. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  495. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  496. package/lib/commonjs/features/queue/shuffle.js +1 -2
  497. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  498. package/lib/commonjs/features/remoteControls.js +71 -137
  499. package/lib/commonjs/features/remoteControls.js.map +1 -1
  500. package/lib/commonjs/features/sleepTimer.js +33 -11
  501. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  502. package/lib/commonjs/native.js +5 -0
  503. package/lib/commonjs/native.js.map +1 -1
  504. package/lib/commonjs/native.web.js +4 -1
  505. package/lib/commonjs/native.web.js.map +1 -1
  506. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  507. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  508. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -17
  509. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  510. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -19
  511. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  512. package/lib/commonjs/utils/artwork.js +31 -0
  513. package/lib/commonjs/utils/artwork.js.map +1 -0
  514. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  515. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  516. package/lib/commonjs/utils/useDebug.js +16 -3
  517. package/lib/commonjs/utils/useDebug.js.map +1 -1
  518. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  519. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  520. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  521. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  522. package/lib/commonjs/web/NativeAudioBrowser.js +482 -177
  523. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  524. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  525. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  526. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +87 -0
  527. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -0
  528. package/lib/commonjs/web/TrackPlayer/PlaybackTimer.js +34 -0
  529. package/lib/commonjs/web/TrackPlayer/PlaybackTimer.js.map +1 -0
  530. package/lib/commonjs/web/TrackPlayer/Player.js +321 -41
  531. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  532. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +21 -0
  533. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js.map +1 -0
  534. package/lib/commonjs/web/TrackPlayer/QueueManager.js +287 -0
  535. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -0
  536. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +178 -0
  537. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -0
  538. package/lib/commonjs/web/TrackPlayer/RepeatMode.js +1 -1
  539. package/lib/commonjs/web/TrackPlayer/RepeatMode.js.map +1 -1
  540. package/lib/commonjs/web/TrackPlayer/SleepTimer.js +34 -3
  541. package/lib/commonjs/web/TrackPlayer/SleepTimer.js.map +1 -1
  542. package/lib/commonjs/web/TrackPlayer/VolumeFader.js +75 -0
  543. package/lib/commonjs/web/TrackPlayer/VolumeFader.js.map +1 -0
  544. package/lib/commonjs/web/TrackPlayer/index.js +13 -5
  545. package/lib/commonjs/web/TrackPlayer/index.js.map +1 -1
  546. package/lib/commonjs/web/browser/BrowserManager.js +341 -140
  547. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  548. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  549. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  550. package/lib/commonjs/web/browser/NavigationErrorManager.js +6 -2
  551. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  552. package/lib/commonjs/web/browser/SearchManager.js +22 -25
  553. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  554. package/lib/commonjs/web/browser/assertBrowsePageShape.js +22 -0
  555. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -0
  556. package/lib/commonjs/web/browser/classifyTrackNavigation.js +41 -0
  557. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -0
  558. package/lib/commonjs/web/browser/parseSearchResponse.js +19 -0
  559. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -0
  560. package/lib/commonjs/web/browser/sections.js +89 -0
  561. package/lib/commonjs/web/browser/sections.js.map +1 -0
  562. package/lib/commonjs/web/http/HttpClient.js +4 -23
  563. package/lib/commonjs/web/http/HttpClient.js.map +1 -1
  564. package/lib/commonjs/web/http/RequestConfigBuilder.js +194 -62
  565. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  566. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  567. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  568. package/lib/commonjs/web/playbackErrorKind.js +57 -0
  569. package/lib/commonjs/web/playbackErrorKind.js.map +1 -0
  570. package/lib/commonjs/web/player/MediaSessionManager.js +121 -0
  571. package/lib/commonjs/web/player/MediaSessionManager.js.map +1 -0
  572. package/lib/commonjs/web/player/NowPlayingManager.js +10 -8
  573. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  574. package/lib/commonjs/web/player/OptionsManager.js +9 -17
  575. package/lib/commonjs/web/player/OptionsManager.js.map +1 -1
  576. package/lib/commonjs/web/player/RemoteCommandController.js +96 -0
  577. package/lib/commonjs/web/player/RemoteCommandController.js.map +1 -0
  578. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  579. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  580. package/lib/module/AudioBrowser.js +2 -1
  581. package/lib/module/AudioBrowser.js.map +1 -1
  582. package/lib/module/CLAUDE.md +57 -0
  583. package/lib/module/features/battery.js +16 -12
  584. package/lib/module/features/battery.js.map +1 -1
  585. package/lib/module/features/browser-config.js +225 -0
  586. package/lib/module/features/browser-config.js.map +1 -0
  587. package/lib/module/features/browser.js +123 -168
  588. package/lib/module/features/browser.js.map +1 -1
  589. package/lib/module/features/carConnection.js +36 -0
  590. package/lib/module/features/carConnection.js.map +1 -0
  591. package/lib/module/features/equalizer.js +10 -6
  592. package/lib/module/features/equalizer.js.map +1 -1
  593. package/lib/module/features/errors.js +59 -13
  594. package/lib/module/features/errors.js.map +1 -1
  595. package/lib/module/features/favorites.js +29 -24
  596. package/lib/module/features/favorites.js.map +1 -1
  597. package/lib/module/features/gate.js +165 -0
  598. package/lib/module/features/gate.js.map +1 -0
  599. package/lib/module/features/index.js +2 -0
  600. package/lib/module/features/index.js.map +1 -1
  601. package/lib/module/features/metadata.js +62 -14
  602. package/lib/module/features/metadata.js.map +1 -1
  603. package/lib/module/features/network.js +6 -2
  604. package/lib/module/features/network.js.map +1 -1
  605. package/lib/module/features/nowPlaying.js +53 -6
  606. package/lib/module/features/nowPlaying.js.map +1 -1
  607. package/lib/module/features/output.js +37 -19
  608. package/lib/module/features/output.js.map +1 -1
  609. package/lib/module/features/playback/controls.js +19 -4
  610. package/lib/module/features/playback/controls.js.map +1 -1
  611. package/lib/module/features/playback/index.js +1 -0
  612. package/lib/module/features/playback/index.js.map +1 -1
  613. package/lib/module/features/playback/playWhenReady.js +6 -5
  614. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  615. package/lib/module/features/playback/playing.js +5 -3
  616. package/lib/module/features/playback/playing.js.map +1 -1
  617. package/lib/module/features/playback/progress.js +40 -17
  618. package/lib/module/features/playback/progress.js.map +1 -1
  619. package/lib/module/features/playback/rate.js +8 -1
  620. package/lib/module/features/playback/rate.js.map +1 -1
  621. package/lib/module/features/playback/state.js +5 -6
  622. package/lib/module/features/playback/state.js.map +1 -1
  623. package/lib/module/features/playback/trackPlaybackTime.js +88 -0
  624. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -0
  625. package/lib/module/features/playback/volume.js +6 -5
  626. package/lib/module/features/playback/volume.js.map +1 -1
  627. package/lib/module/features/player/options.js +99 -39
  628. package/lib/module/features/player/options.js.map +1 -1
  629. package/lib/module/features/player/setup.js +258 -4
  630. package/lib/module/features/player/setup.js.map +1 -1
  631. package/lib/module/features/player/validateOptions.js +19 -0
  632. package/lib/module/features/player/validateOptions.js.map +1 -0
  633. package/lib/module/features/queue/activeTrack.js +15 -5
  634. package/lib/module/features/queue/activeTrack.js.map +1 -1
  635. package/lib/module/features/queue/queue.js +76 -24
  636. package/lib/module/features/queue/queue.js.map +1 -1
  637. package/lib/module/features/queue/repeatMode.js +3 -2
  638. package/lib/module/features/queue/repeatMode.js.map +1 -1
  639. package/lib/module/features/queue/shuffle.js +1 -2
  640. package/lib/module/features/queue/shuffle.js.map +1 -1
  641. package/lib/module/features/remoteControls.js +70 -136
  642. package/lib/module/features/remoteControls.js.map +1 -1
  643. package/lib/module/features/sleepTimer.js +34 -12
  644. package/lib/module/features/sleepTimer.js.map +1 -1
  645. package/lib/module/native.js +5 -0
  646. package/lib/module/native.js.map +1 -1
  647. package/lib/module/native.web.js +4 -1
  648. package/lib/module/native.web.js.map +1 -1
  649. package/lib/module/test-utils/reactNativeStub.js +58 -0
  650. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  651. package/lib/module/utils/LazyNativeEmitter.js +25 -17
  652. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  653. package/lib/module/utils/NativeUpdatedValue.js +32 -19
  654. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  655. package/lib/module/utils/artwork.js +26 -0
  656. package/lib/module/utils/artwork.js.map +1 -0
  657. package/lib/module/utils/getTrackIdentity.js +22 -0
  658. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  659. package/lib/module/utils/useDebug.js +16 -3
  660. package/lib/module/utils/useDebug.js.map +1 -1
  661. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  662. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  663. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  664. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  665. package/lib/module/web/NativeAudioBrowser.js +483 -178
  666. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  667. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  668. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  669. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +83 -0
  670. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -0
  671. package/lib/module/web/TrackPlayer/PlaybackTimer.js +29 -0
  672. package/lib/module/web/TrackPlayer/PlaybackTimer.js.map +1 -0
  673. package/lib/module/web/TrackPlayer/Player.js +321 -41
  674. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  675. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +17 -0
  676. package/lib/module/web/TrackPlayer/PlayingStateFactory.js.map +1 -0
  677. package/lib/module/web/TrackPlayer/QueueManager.js +283 -0
  678. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -0
  679. package/lib/module/web/TrackPlayer/QueuePlayer.js +174 -0
  680. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -0
  681. package/lib/module/web/TrackPlayer/RepeatMode.js +1 -1
  682. package/lib/module/web/TrackPlayer/RepeatMode.js.map +1 -1
  683. package/lib/module/web/TrackPlayer/SleepTimer.js +34 -3
  684. package/lib/module/web/TrackPlayer/SleepTimer.js.map +1 -1
  685. package/lib/module/web/TrackPlayer/VolumeFader.js +70 -0
  686. package/lib/module/web/TrackPlayer/VolumeFader.js.map +1 -0
  687. package/lib/module/web/TrackPlayer/index.js +2 -1
  688. package/lib/module/web/TrackPlayer/index.js.map +1 -1
  689. package/lib/module/web/browser/BrowserManager.js +341 -140
  690. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  691. package/lib/module/web/browser/FavoriteManager.js +31 -21
  692. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  693. package/lib/module/web/browser/NavigationErrorManager.js +6 -2
  694. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  695. package/lib/module/web/browser/SearchManager.js +22 -25
  696. package/lib/module/web/browser/SearchManager.js.map +1 -1
  697. package/lib/module/web/browser/assertBrowsePageShape.js +18 -0
  698. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -0
  699. package/lib/module/web/browser/classifyTrackNavigation.js +38 -0
  700. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -0
  701. package/lib/module/web/browser/parseSearchResponse.js +15 -0
  702. package/lib/module/web/browser/parseSearchResponse.js.map +1 -0
  703. package/lib/module/web/browser/sections.js +83 -0
  704. package/lib/module/web/browser/sections.js.map +1 -0
  705. package/lib/module/web/http/HttpClient.js +4 -23
  706. package/lib/module/web/http/HttpClient.js.map +1 -1
  707. package/lib/module/web/http/RequestConfigBuilder.js +194 -62
  708. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  709. package/lib/module/web/http/followMediaRedirect.js +215 -0
  710. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  711. package/lib/module/web/playbackErrorKind.js +52 -0
  712. package/lib/module/web/playbackErrorKind.js.map +1 -0
  713. package/lib/module/web/player/MediaSessionManager.js +116 -0
  714. package/lib/module/web/player/MediaSessionManager.js.map +1 -0
  715. package/lib/module/web/player/NowPlayingManager.js +11 -8
  716. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  717. package/lib/module/web/player/OptionsManager.js +9 -17
  718. package/lib/module/web/player/OptionsManager.js.map +1 -1
  719. package/lib/module/web/player/RemoteCommandController.js +92 -0
  720. package/lib/module/web/player/RemoteCommandController.js.map +1 -0
  721. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  722. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  723. package/lib/typescript/package.json +1 -0
  724. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  725. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  726. package/lib/typescript/src/features/battery.d.ts +17 -12
  727. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  728. package/lib/typescript/src/features/browser-config.d.ts +12 -0
  729. package/lib/typescript/src/features/browser-config.d.ts.map +1 -0
  730. package/lib/typescript/src/features/browser.d.ts +99 -12
  731. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  732. package/lib/typescript/src/features/carConnection.d.ts +19 -0
  733. package/lib/typescript/src/features/carConnection.d.ts.map +1 -0
  734. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  735. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  736. package/lib/typescript/src/features/errors.d.ts +84 -14
  737. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  738. package/lib/typescript/src/features/favorites.d.ts +29 -24
  739. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  740. package/lib/typescript/src/features/gate.d.ts +99 -0
  741. package/lib/typescript/src/features/gate.d.ts.map +1 -0
  742. package/lib/typescript/src/features/index.d.ts +2 -0
  743. package/lib/typescript/src/features/index.d.ts.map +1 -1
  744. package/lib/typescript/src/features/metadata.d.ts +74 -21
  745. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  746. package/lib/typescript/src/features/network.d.ts +6 -2
  747. package/lib/typescript/src/features/network.d.ts.map +1 -1
  748. package/lib/typescript/src/features/nowPlaying.d.ts +47 -6
  749. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  750. package/lib/typescript/src/features/output.d.ts +33 -18
  751. package/lib/typescript/src/features/output.d.ts.map +1 -1
  752. package/lib/typescript/src/features/playback/controls.d.ts +16 -4
  753. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  754. package/lib/typescript/src/features/playback/index.d.ts +1 -0
  755. package/lib/typescript/src/features/playback/index.d.ts.map +1 -1
  756. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  757. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  758. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  759. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  760. package/lib/typescript/src/features/playback/progress.d.ts +14 -5
  761. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  762. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  763. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  764. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  765. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  766. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +41 -0
  767. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -0
  768. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  769. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  770. package/lib/typescript/src/features/player/options.d.ts +211 -145
  771. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  772. package/lib/typescript/src/features/player/setup.d.ts +288 -186
  773. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  774. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  775. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  776. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  777. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  778. package/lib/typescript/src/features/queue/queue.d.ts +65 -20
  779. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  780. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  781. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  782. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  783. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  784. package/lib/typescript/src/features/remoteControls.d.ts +81 -60
  785. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  786. package/lib/typescript/src/features/sleepTimer.d.ts +34 -11
  787. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  788. package/lib/typescript/src/index.d.ts.map +1 -1
  789. package/lib/typescript/src/native.d.ts +1 -2
  790. package/lib/typescript/src/native.d.ts.map +1 -1
  791. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +16 -225
  792. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  793. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  794. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  795. package/lib/typescript/src/types/browser-native.d.ts +10 -3
  796. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  797. package/lib/typescript/src/types/browser-nodes.d.ts +474 -84
  798. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  799. package/lib/typescript/src/types/browser.d.ts +518 -179
  800. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  801. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -18
  802. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  803. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -22
  804. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  805. package/lib/typescript/src/utils/artwork.d.ts +19 -0
  806. package/lib/typescript/src/utils/artwork.d.ts.map +1 -0
  807. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  808. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  809. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  810. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  811. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  812. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  813. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  814. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  815. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  816. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  817. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +3 -2
  818. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +28 -12
  819. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +8 -8
  820. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +12 -22
  822. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  825. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +43 -6
  826. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +61 -0
  827. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  830. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JBrowseResult.hpp +24 -7
  832. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  833. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +5 -5
  834. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  835. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  837. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  838. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  839. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +16 -5
  840. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  841. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +105 -0
  842. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +5 -4
  843. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +112 -0
  844. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +121 -0
  845. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +128 -0
  846. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  847. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +138 -0
  848. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +126 -0
  849. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +139 -0
  850. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  851. 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
  852. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +16 -5
  853. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +134 -0
  854. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +26 -12
  855. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +16 -4
  856. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  857. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +143 -0
  858. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  859. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  860. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  861. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  862. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +16 -5
  863. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +79 -0
  864. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  865. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -12
  866. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +13 -11
  867. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +80 -0
  868. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +4 -2
  869. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +16 -5
  870. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +4 -2
  871. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  872. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  873. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  874. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  875. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  876. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  877. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  878. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  879. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  880. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  881. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  882. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  883. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  884. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +12 -12
  885. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  886. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  887. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +23 -5
  888. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  889. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  890. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  891. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +30 -18
  892. package/nitrogen/generated/android/c++/JGate.hpp +62 -0
  893. package/nitrogen/generated/android/c++/JGateDecision.hpp +64 -0
  894. package/nitrogen/generated/android/c++/JGateEvent.hpp +58 -0
  895. package/nitrogen/generated/android/c++/JGateReason.hpp +58 -0
  896. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  897. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  898. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +317 -255
  899. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +30 -25
  900. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  901. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  902. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  903. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  904. package/nitrogen/generated/android/c++/JIOSOptions.hpp +101 -0
  905. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  906. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  907. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  908. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  909. package/nitrogen/generated/android/c++/JMediaReference.hpp +58 -0
  910. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +43 -6
  911. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  912. package/nitrogen/generated/android/c++/{JPartialAndroidSetupPlayerOptions.hpp → JNativeAndroidSetupOptions.hpp} +10 -10
  913. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +100 -40
  914. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +74 -0
  915. package/nitrogen/generated/android/c++/{JPartialIOSSetupPlayerOptions.hpp → JNativeIOSSetupOptions.hpp} +18 -18
  916. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +36 -13
  917. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +191 -0
  918. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +20 -26
  919. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  920. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  921. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  922. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +8 -2
  923. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +12 -22
  924. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +102 -0
  925. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +5 -19
  926. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +9 -5
  927. package/nitrogen/generated/android/c++/JOptions.hpp +18 -16
  928. package/nitrogen/generated/android/c++/{JIosOutput.hpp → JOutput.hpp} +15 -15
  929. package/nitrogen/generated/android/c++/JOutputType.hpp +88 -0
  930. package/nitrogen/generated/android/c++/JPlayback.hpp +4 -2
  931. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +16 -5
  932. package/nitrogen/generated/android/c++/JPlaybackError.hpp +20 -5
  933. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +4 -2
  934. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +76 -0
  935. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  936. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  937. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  938. package/nitrogen/generated/android/c++/JPlaybackState.hpp +5 -5
  939. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +2 -2
  940. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  941. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  942. package/nitrogen/generated/android/c++/{JNotificationButton.hpp → JRemoteButton.hpp} +20 -20
  943. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +86 -0
  944. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  945. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  946. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  947. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  948. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  949. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  950. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  951. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  952. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  953. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  954. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +85 -59
  955. package/nitrogen/generated/android/c++/JRetryConfig.hpp +13 -9
  956. package/nitrogen/generated/android/c++/JSearchMode.hpp +29 -11
  957. package/nitrogen/generated/android/c++/JSearchParams.hpp +11 -5
  958. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  959. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  960. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  961. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  962. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  963. package/nitrogen/generated/android/c++/JStallReason.hpp +58 -0
  964. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  965. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  966. package/nitrogen/generated/android/c++/JTrack.hpp +45 -48
  967. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +31 -15
  968. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  969. package/nitrogen/generated/android/c++/JTrackRequest.hpp +93 -0
  970. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  971. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +16 -3
  972. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  973. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  974. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  975. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp +26 -0
  976. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +75 -0
  977. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.cpp +41 -0
  978. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +133 -0
  979. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.cpp +26 -0
  980. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +70 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioContentType.kt +4 -4
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +20 -9
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{RatingType.kt → ArtworkRendering.kt} +5 -10
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +47 -4
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +56 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayNowPlayingButton.kt +3 -3
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{NotificationButton.kt → CarPlayPlayingIndicatorLocation.kt} +5 -8
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +71 -0
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +17 -2
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +78 -0
  1002. 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 +78 -0
  1003. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +78 -0
  1004. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  1005. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +78 -0
  1006. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +78 -0
  1007. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +78 -0
  1008. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  1009. 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
  1010. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  1011. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +78 -0
  1012. 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
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.kt → Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt} +12 -14
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  1018. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  1019. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  1020. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  1021. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_void_RemoteSetRatingEvent.kt → Func_void_GateEvent.kt} +9 -11
  1022. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  1023. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  1024. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  1025. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_void_IosOutput.kt → Func_void_Output.kt} +9 -11
  1026. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  1027. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  1028. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  1029. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  1030. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  1031. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  1032. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  1033. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  1034. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  1035. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  1036. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  1037. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  1038. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  1039. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  1040. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  1041. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  1042. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +9 -11
  1043. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  1044. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  1045. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  1046. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  1047. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  1048. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  1049. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  1050. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +56 -0
  1051. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +56 -0
  1052. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +51 -0
  1053. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateReason.kt +23 -0
  1054. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  1055. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +114 -110
  1056. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +66 -0
  1057. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  1058. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  1059. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  1060. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  1061. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaReference.kt +23 -0
  1062. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +45 -4
  1063. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  1064. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{PartialAndroidSetupPlayerOptions.kt → NativeAndroidSetupOptions.kt} +36 -5
  1065. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +64 -6
  1066. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +61 -0
  1067. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +71 -0
  1068. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +31 -4
  1069. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +100 -0
  1070. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +29 -6
  1071. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  1072. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  1073. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  1074. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorType.kt +3 -1
  1075. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +20 -9
  1076. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +66 -0
  1077. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +32 -6
  1078. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +23 -3
  1079. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +26 -3
  1080. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +61 -0
  1081. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +33 -0
  1082. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  1083. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  1084. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +33 -3
  1085. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  1086. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorKind.kt +29 -0
  1087. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  1088. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  1089. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  1090. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackState.kt +6 -6
  1091. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +35 -0
  1092. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  1093. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  1094. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButton.kt +26 -0
  1095. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +61 -0
  1096. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  1097. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  1098. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  1099. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  1100. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  1101. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  1102. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  1103. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  1104. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  1105. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +74 -13
  1106. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +24 -4
  1107. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchMode.kt +12 -6
  1108. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +33 -3
  1109. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  1110. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  1111. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  1112. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  1113. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  1114. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StallReason.kt +23 -0
  1115. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  1116. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  1117. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +62 -10
  1118. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +25 -3
  1119. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  1120. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +61 -0
  1121. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  1122. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +38 -4
  1123. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  1124. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  1125. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  1126. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Variant_NullType_NotificationButtonLayout.kt → Variant_NullType_RemoteButtonLayout.kt} +24 -15
  1127. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +75 -0
  1128. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +62 -0
  1129. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1130. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +162 -42
  1131. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +1476 -684
  1132. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +91 -49
  1133. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +219 -124
  1134. package/nitrogen/generated/ios/swift/AndroidAudioContentType.swift +8 -8
  1135. package/nitrogen/generated/ios/swift/AndroidOptions.swift +12 -22
  1136. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1137. package/nitrogen/generated/ios/swift/ArtworkRequestConfig.swift +95 -1
  1138. package/nitrogen/generated/ios/swift/ArtworkVariants.swift +34 -0
  1139. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1140. package/nitrogen/generated/ios/swift/CarPlayNowPlayingButton.swift +4 -4
  1141. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1142. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1143. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1144. package/nitrogen/generated/ios/swift/FormatNowPlayingParams.swift +67 -0
  1145. package/nitrogen/generated/ios/swift/FormattedNavigationError.swift +17 -4
  1146. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.swift +54 -0
  1147. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.swift +69 -0
  1148. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___Track.swift +54 -0
  1149. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.swift +60 -0
  1150. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__optional_std__string____Track.swift +60 -0
  1151. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.swift +61 -0
  1152. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.swift +61 -0
  1153. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1154. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.swift +77 -0
  1155. package/nitrogen/generated/ios/swift/Func_void_GateDecision.swift +46 -0
  1156. package/nitrogen/generated/ios/swift/{Func_void_RemoteSetRatingEvent.swift → Func_void_GateEvent.swift} +10 -10
  1157. package/nitrogen/generated/ios/swift/{Func_void_IosOutput.swift → Func_void_Output.swift} +10 -10
  1158. package/nitrogen/generated/ios/swift/Func_void_TransformableRequestConfig.swift +46 -0
  1159. package/nitrogen/generated/ios/swift/Func_void_bool.swift +5 -5
  1160. package/nitrogen/generated/ios/swift/Func_void_std__optional_NowPlayingUpdate_.swift +46 -0
  1161. package/nitrogen/generated/ios/swift/Func_void_std__optional_std__string_.swift +53 -0
  1162. package/nitrogen/generated/ios/swift/{Func_void_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError___.swift → Func_void_std__shared_ptr_Promise_GateDecision__.swift} +17 -17
  1163. package/nitrogen/generated/ios/swift/Func_void_std__shared_ptr_Promise_TransformableRequestConfig__.swift +66 -0
  1164. package/nitrogen/generated/ios/swift/Func_void_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError____.swift +81 -0
  1165. package/nitrogen/generated/ios/swift/Gate.swift +47 -0
  1166. package/nitrogen/generated/ios/swift/GateDecision.swift +40 -0
  1167. package/nitrogen/generated/ios/swift/GateEvent.swift +29 -0
  1168. package/nitrogen/generated/ios/swift/GateReason.swift +40 -0
  1169. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1170. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +23 -15
  1171. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +262 -199
  1172. package/nitrogen/generated/ios/swift/IOSOptions.swift +56 -0
  1173. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1174. package/nitrogen/generated/ios/swift/MediaReference.swift +40 -0
  1175. package/nitrogen/generated/ios/swift/MediaRequestConfig.swift +107 -1
  1176. package/nitrogen/generated/ios/swift/{PartialAndroidSetupPlayerOptions.swift → NativeAndroidSetupOptions.swift} +5 -5
  1177. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +208 -22
  1178. package/nitrogen/generated/ios/swift/NativeGateRequest.swift +58 -0
  1179. package/nitrogen/generated/ios/swift/{PartialIOSSetupPlayerOptions.swift → NativeIOSSetupOptions.swift} +5 -5
  1180. package/nitrogen/generated/ios/swift/NativeRouteEntry.swift +19 -19
  1181. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +217 -0
  1182. package/nitrogen/generated/ios/swift/NativeUpdateOptions.swift +12 -25
  1183. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1184. package/nitrogen/generated/ios/swift/NavigationErrorType.swift +8 -0
  1185. package/nitrogen/generated/ios/swift/NitroAndroidUpdateOptions.swift +12 -41
  1186. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +101 -0
  1187. package/nitrogen/generated/ios/swift/NowPlayingMetadata.swift +1 -48
  1188. package/nitrogen/generated/ios/swift/NowPlayingUpdate.swift +19 -1
  1189. package/nitrogen/generated/ios/swift/Options.swift +10 -4
  1190. package/nitrogen/generated/ios/swift/{IosOutput.swift → Output.swift} +7 -7
  1191. package/nitrogen/generated/ios/swift/OutputType.swift +80 -0
  1192. package/nitrogen/generated/ios/swift/PlaybackError.swift +43 -2
  1193. package/nitrogen/generated/ios/swift/PlaybackErrorKind.swift +64 -0
  1194. package/nitrogen/generated/ios/swift/PlaybackState.swift +4 -4
  1195. package/nitrogen/generated/ios/swift/{NotificationButton.swift → RemoteButton.swift} +10 -10
  1196. package/nitrogen/generated/ios/swift/RemoteButtonLayout.swift +57 -0
  1197. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1198. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +125 -70
  1199. package/nitrogen/generated/ios/swift/RetryConfig.swift +35 -4
  1200. package/nitrogen/generated/ios/swift/SearchMode.swift +36 -12
  1201. package/nitrogen/generated/ios/swift/SearchParams.swift +7 -2
  1202. package/nitrogen/generated/ios/swift/{ImageRowItem.swift → Section.swift} +33 -27
  1203. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1204. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1205. package/nitrogen/generated/ios/swift/StallReason.swift +40 -0
  1206. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1207. package/nitrogen/generated/ios/swift/Track.swift +91 -60
  1208. package/nitrogen/generated/ios/swift/TrackLoadEvent.swift +20 -2
  1209. package/nitrogen/generated/ios/swift/TrackRequest.swift +106 -0
  1210. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1211. package/nitrogen/generated/ios/swift/TransformableRequestConfig.swift +60 -1
  1212. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1213. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1214. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1215. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +30 -0
  1216. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +32 -0
  1217. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +30 -0
  1218. package/nitrogen/generated/shared/c++/AndroidAudioContentType.hpp +10 -10
  1219. package/nitrogen/generated/shared/c++/AndroidOptions.hpp +8 -19
  1220. package/nitrogen/generated/shared/c++/ArtworkRendering.hpp +76 -0
  1221. package/nitrogen/generated/shared/c++/ArtworkRequestConfig.hpp +10 -2
  1222. package/nitrogen/generated/shared/c++/{HeartRating.hpp → ArtworkVariants.hpp} +20 -16
  1223. package/nitrogen/generated/shared/c++/CarPlayNowPlayingButton.hpp +6 -6
  1224. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1225. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1226. package/nitrogen/generated/shared/c++/EqualizerSettings.hpp +0 -2
  1227. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1228. package/nitrogen/generated/shared/c++/FormatNowPlayingParams.hpp +110 -0
  1229. package/nitrogen/generated/shared/c++/FormattedNavigationError.hpp +6 -5
  1230. package/nitrogen/generated/shared/c++/{StarRating.hpp → Gate.hpp} +21 -16
  1231. package/nitrogen/generated/shared/c++/{ThumbsRating.hpp → GateDecision.hpp} +23 -17
  1232. package/nitrogen/generated/shared/c++/{PercentageRating.hpp → GateEvent.hpp} +18 -17
  1233. package/nitrogen/generated/shared/c++/GateReason.hpp +76 -0
  1234. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1235. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +24 -19
  1236. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +47 -36
  1237. package/nitrogen/generated/shared/c++/IOSOptions.hpp +98 -0
  1238. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1239. package/nitrogen/generated/shared/c++/MediaReference.hpp +76 -0
  1240. package/nitrogen/generated/shared/c++/MediaRequestConfig.hpp +10 -2
  1241. package/nitrogen/generated/shared/c++/{PartialAndroidSetupPlayerOptions.hpp → NativeAndroidSetupOptions.hpp} +11 -11
  1242. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +35 -15
  1243. package/nitrogen/generated/shared/c++/NativeGateRequest.hpp +97 -0
  1244. package/nitrogen/generated/shared/c++/{PartialIOSSetupPlayerOptions.hpp → NativeIOSSetupOptions.hpp} +11 -11
  1245. package/nitrogen/generated/shared/c++/NativeRouteEntry.hpp +5 -5
  1246. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +145 -0
  1247. package/nitrogen/generated/shared/c++/NativeUpdateOptions.hpp +9 -7
  1248. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1249. package/nitrogen/generated/shared/c++/NavigationErrorType.hpp +8 -0
  1250. package/nitrogen/generated/shared/c++/NitroAndroidUpdateOptions.hpp +8 -19
  1251. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +99 -0
  1252. package/nitrogen/generated/shared/c++/NowPlayingMetadata.hpp +3 -19
  1253. package/nitrogen/generated/shared/c++/NowPlayingUpdate.hpp +6 -2
  1254. package/nitrogen/generated/shared/c++/Options.hpp +8 -8
  1255. package/nitrogen/generated/shared/c++/{IosOutput.hpp → Output.hpp} +18 -18
  1256. package/nitrogen/generated/shared/c++/OutputType.hpp +116 -0
  1257. package/nitrogen/generated/shared/c++/PlaybackError.hpp +18 -3
  1258. package/nitrogen/generated/shared/c++/PlaybackErrorKind.hpp +100 -0
  1259. package/nitrogen/generated/shared/c++/PlaybackState.hpp +9 -9
  1260. package/nitrogen/generated/shared/c++/{NotificationButton.hpp → RemoteButton.hpp} +25 -25
  1261. package/nitrogen/generated/shared/c++/RemoteButtonLayout.hpp +94 -0
  1262. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1263. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +52 -37
  1264. package/nitrogen/generated/shared/c++/RetryConfig.hpp +10 -6
  1265. package/nitrogen/generated/shared/c++/SearchMode.hpp +39 -15
  1266. package/nitrogen/generated/shared/c++/SearchParams.hpp +9 -2
  1267. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1268. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1269. package/nitrogen/generated/shared/c++/StallReason.hpp +76 -0
  1270. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1271. package/nitrogen/generated/shared/c++/Track.hpp +37 -30
  1272. package/nitrogen/generated/shared/c++/TrackLoadEvent.hpp +7 -2
  1273. package/nitrogen/generated/shared/c++/TrackRequest.hpp +93 -0
  1274. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1275. package/nitrogen/generated/shared/c++/TransformableRequestConfig.hpp +6 -2
  1276. package/package.json +50 -20
  1277. package/src/AudioBrowser.ts +2 -1
  1278. package/src/CLAUDE.md +57 -0
  1279. package/src/codegen-no-config-variant.test.ts +70 -0
  1280. package/src/docs-floors.test.ts +71 -0
  1281. package/src/features/battery.test.ts +79 -0
  1282. package/src/features/battery.ts +17 -13
  1283. package/src/features/browser-config.test.ts +125 -0
  1284. package/src/features/browser-config.ts +297 -0
  1285. package/src/features/browser.test.ts +19 -0
  1286. package/src/features/browser.ts +119 -213
  1287. package/src/features/carConnection.ts +35 -0
  1288. package/src/features/equalizer.ts +10 -6
  1289. package/src/features/errors.ts +94 -13
  1290. package/src/features/favorites.ts +29 -24
  1291. package/src/features/gate.test.ts +72 -0
  1292. package/src/features/gate.ts +176 -0
  1293. package/src/features/hook-wiring.test.ts +302 -0
  1294. package/src/features/index.ts +2 -0
  1295. package/src/features/metadata.ts +89 -29
  1296. package/src/features/network.ts +6 -2
  1297. package/src/features/nowPlaying.ts +56 -6
  1298. package/src/features/output.ts +40 -22
  1299. package/src/features/playback/controls.ts +19 -4
  1300. package/src/features/playback/index.ts +1 -0
  1301. package/src/features/playback/playWhenReady.ts +6 -5
  1302. package/src/features/playback/playing.ts +16 -3
  1303. package/src/features/playback/progress.test.ts +169 -0
  1304. package/src/features/playback/progress.ts +43 -17
  1305. package/src/features/playback/rate.ts +8 -1
  1306. package/src/features/playback/state.ts +10 -6
  1307. package/src/features/playback/trackPlaybackTime.test.ts +76 -0
  1308. package/src/features/playback/trackPlaybackTime.ts +108 -0
  1309. package/src/features/playback/volume.ts +6 -5
  1310. package/src/features/player/options.test.ts +38 -0
  1311. package/src/features/player/options.ts +254 -128
  1312. package/src/features/player/setup.test.ts +134 -0
  1313. package/src/features/player/setup.ts +481 -194
  1314. package/src/features/player/validateOptions.ts +21 -0
  1315. package/src/features/queue/activeTrack.ts +15 -5
  1316. package/src/features/queue/queue.test.ts +36 -0
  1317. package/src/features/queue/queue.ts +80 -24
  1318. package/src/features/queue/repeatMode.ts +2 -2
  1319. package/src/features/queue/shuffle.ts +1 -2
  1320. package/src/features/remoteControls.ts +70 -148
  1321. package/src/features/sleepTimer.test.ts +171 -0
  1322. package/src/features/sleepTimer.ts +48 -13
  1323. package/src/native.ts +5 -0
  1324. package/src/native.web.ts +4 -1
  1325. package/src/nitro-stub-drift.test.ts +277 -0
  1326. package/src/public-surface.test.ts +147 -0
  1327. package/src/specs/audio-browser.nitro.ts +146 -42
  1328. package/src/style-resolution.test.ts +210 -0
  1329. package/src/test-utils/reactNativeStub.ts +60 -0
  1330. package/src/types/browser-native.ts +24 -7
  1331. package/src/types/browser-nodes.ts +505 -92
  1332. package/src/types/browser.ts +548 -183
  1333. package/src/utils/LazyNativeEmitter.ts +25 -17
  1334. package/src/utils/NativeUpdatedValue.ts +30 -18
  1335. package/src/utils/artwork.ts +30 -0
  1336. package/src/utils/getTrackIdentity.ts +22 -0
  1337. package/src/utils/useDebug.test.ts +182 -0
  1338. package/src/utils/useDebug.ts +16 -3
  1339. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1340. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1341. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1342. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1343. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +564 -0
  1344. package/src/web/NativeAudioBrowser.ts +588 -219
  1345. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1346. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +186 -0
  1347. package/src/web/TrackPlayer/PlaybackStateMachine.ts +98 -0
  1348. package/src/web/TrackPlayer/PlaybackTimer.test.ts +67 -0
  1349. package/src/web/TrackPlayer/PlaybackTimer.ts +33 -0
  1350. package/src/web/TrackPlayer/Player.dispatch.test.ts +274 -0
  1351. package/src/web/TrackPlayer/Player.load.test.ts +222 -0
  1352. package/src/web/TrackPlayer/Player.ts +377 -55
  1353. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +51 -0
  1354. package/src/web/TrackPlayer/PlayingStateFactory.ts +24 -0
  1355. package/src/web/TrackPlayer/QueueManager.test.ts +318 -0
  1356. package/src/web/TrackPlayer/QueueManager.ts +316 -0
  1357. package/src/web/TrackPlayer/QueuePlayer.ts +206 -0
  1358. package/src/web/TrackPlayer/RepeatMode.ts +1 -1
  1359. package/src/web/TrackPlayer/SleepTimer.ts +38 -3
  1360. package/src/web/TrackPlayer/VolumeFader.ts +74 -0
  1361. package/src/web/TrackPlayer/index.ts +2 -1
  1362. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1363. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1364. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1365. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1366. package/src/web/__tests__/retry.test.ts +169 -0
  1367. package/src/web/browser/BrowserManager.ts +421 -154
  1368. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1369. package/src/web/browser/FavoriteManager.ts +28 -23
  1370. package/src/web/browser/NavigationErrorManager.ts +6 -2
  1371. package/src/web/browser/SearchManager.test.ts +75 -0
  1372. package/src/web/browser/SearchManager.ts +26 -33
  1373. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1374. package/src/web/browser/__tests__/layer-resolver.test.ts +104 -0
  1375. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1376. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1377. package/src/web/browser/assertBrowsePageShape.test.ts +27 -0
  1378. package/src/web/browser/assertBrowsePageShape.ts +29 -0
  1379. package/src/web/browser/classifyTrackNavigation.test.ts +43 -0
  1380. package/src/web/browser/classifyTrackNavigation.ts +35 -0
  1381. package/src/web/browser/parseSearchResponse.test.ts +31 -0
  1382. package/src/web/browser/parseSearchResponse.ts +14 -0
  1383. package/src/web/browser/sections.test.ts +91 -0
  1384. package/src/web/browser/sections.ts +72 -0
  1385. package/src/web/http/HttpClient.ts +5 -35
  1386. package/src/web/http/RequestConfigBuilder.test.ts +299 -0
  1387. package/src/web/http/RequestConfigBuilder.ts +230 -66
  1388. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1389. package/src/web/http/followMediaRedirect.ts +253 -0
  1390. package/src/web/playbackErrorKind.test.ts +55 -0
  1391. package/src/web/playbackErrorKind.ts +56 -0
  1392. package/src/web/player/MediaSessionManager.test.ts +220 -0
  1393. package/src/web/player/MediaSessionManager.ts +151 -0
  1394. package/src/web/player/NowPlayingManager.test.ts +46 -0
  1395. package/src/web/player/NowPlayingManager.ts +10 -8
  1396. package/src/web/player/OptionsManager.ts +12 -18
  1397. package/src/web/player/RemoteCommandController.test.ts +171 -0
  1398. package/src/web/player/RemoteCommandController.ts +166 -0
  1399. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1400. package/src/web/util/BrowserPathHelper.ts +68 -13
  1401. package/website/guide/android-auto.md +126 -0
  1402. package/website/guide/android-certificates.md +488 -0
  1403. package/website/guide/artwork.md +300 -0
  1404. package/website/guide/audio-output.md +382 -0
  1405. package/website/guide/automotive.md +91 -0
  1406. package/website/guide/basic-usage.md +154 -0
  1407. package/website/guide/battery.md +142 -0
  1408. package/website/guide/browser.md +674 -0
  1409. package/website/guide/carplay.md +733 -0
  1410. package/website/guide/configuration.md +215 -0
  1411. package/website/guide/equalizer.md +235 -0
  1412. package/website/guide/errors.md +359 -0
  1413. package/website/guide/favorites.md +164 -0
  1414. package/website/guide/gate.md +157 -0
  1415. package/website/guide/getting-started.md +99 -0
  1416. package/website/guide/hooks.md +247 -0
  1417. package/website/guide/live-streams.md +218 -0
  1418. package/website/guide/metadata.md +289 -0
  1419. package/website/guide/migrating-from-track-player.md +289 -0
  1420. package/website/guide/native-callback-fetch.md +137 -0
  1421. package/website/guide/network.md +103 -0
  1422. package/website/guide/now-playing.md +203 -0
  1423. package/website/guide/playback.md +405 -0
  1424. package/website/guide/queue.md +334 -0
  1425. package/website/guide/remote-controls.md +314 -0
  1426. package/website/guide/search.md +270 -0
  1427. package/website/guide/sleep-timer.md +289 -0
  1428. package/website/guide/track.md +271 -0
  1429. package/android/src/main/java/com/audiobrowser/player/PlaybackProgressUpdateManager.kt +0 -59
  1430. package/android/src/main/java/com/audiobrowser/util/RatingFactory.kt +0 -72
  1431. package/android/src/main/java/com/audiobrowser/util/ResolvedTrackFactory.kt +0 -36
  1432. package/android/src/test/java/com/audiobrowser/player/PlaybackProgressUpdateManagerTest.kt +0 -146
  1433. package/ios/Bridge.h +0 -8
  1434. package/ios/Browser/BrowserManager+URLResolution.swift +0 -260
  1435. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -60
  1436. package/ios/CarPlay/Track+CarPlay.swift +0 -63
  1437. package/ios/Model/MediaURL.swift +0 -67
  1438. package/ios/Model/SourceType.swift +0 -6
  1439. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1440. package/ios/NowPlayingInfo/NowPlayingInfoCenter.swift +0 -9
  1441. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1442. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1443. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -79
  1444. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -110
  1445. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1446. package/ios/Observer/PlayerTimeObserver.swift +0 -105
  1447. package/ios/Option/PitchAlgorithms.swift +0 -17
  1448. package/ios/Option/TimeEventFrequency.swift +0 -18
  1449. package/ios/Player/LoadSeekCoordinator.swift +0 -84
  1450. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1451. package/ios/Player/PlaybackCoordinator.swift +0 -520
  1452. package/ios/Player/PlaybackEffectHandler.swift +0 -44
  1453. package/ios/Player/PlaybackErrorHandler.swift +0 -91
  1454. package/ios/Player/PlaybackProgressUpdateManager.swift +0 -68
  1455. package/ios/Player/PlayingStateManager.swift +0 -32
  1456. package/ios/Player/RetryManager.swift +0 -246
  1457. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1458. package/ios/Player/SleepTimerHandling.swift +0 -7
  1459. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1460. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -294
  1461. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -486
  1462. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -213
  1463. package/ios/Tests/PlaybackProgressUpdateManagerTests.swift +0 -166
  1464. package/ios/TrackPlayer.swift +0 -692
  1465. package/ios/TrackPlayerCallbacks.swift +0 -92
  1466. package/ios/Util/MetadataAdapter.swift +0 -131
  1467. package/ios/Util/OnceValue.swift +0 -70
  1468. package/lib/commonjs/features/rating.js +0 -2
  1469. package/lib/commonjs/features/rating.js.map +0 -1
  1470. package/lib/commonjs/types/player.js +0 -2
  1471. package/lib/commonjs/types/player.js.map +0 -1
  1472. package/lib/commonjs/web/SimpleRouter.test.js +0 -174
  1473. package/lib/commonjs/web/SimpleRouter.test.js.map +0 -1
  1474. package/lib/commonjs/web/TrackPlayer/PlaylistPlayer.js +0 -293
  1475. package/lib/commonjs/web/TrackPlayer/PlaylistPlayer.js.map +0 -1
  1476. package/lib/module/features/rating.js +0 -2
  1477. package/lib/module/features/rating.js.map +0 -1
  1478. package/lib/module/types/player.js +0 -2
  1479. package/lib/module/types/player.js.map +0 -1
  1480. package/lib/module/web/SimpleRouter.test.js +0 -174
  1481. package/lib/module/web/SimpleRouter.test.js.map +0 -1
  1482. package/lib/module/web/TrackPlayer/PlaylistPlayer.js +0 -288
  1483. package/lib/module/web/TrackPlayer/PlaylistPlayer.js.map +0 -1
  1484. package/lib/typescript/src/features/rating.d.ts +0 -14
  1485. package/lib/typescript/src/features/rating.d.ts.map +0 -1
  1486. package/lib/typescript/src/native.web.d.ts +0 -3
  1487. package/lib/typescript/src/native.web.d.ts.map +0 -1
  1488. package/lib/typescript/src/types/player.d.ts +0 -64
  1489. package/lib/typescript/src/types/player.d.ts.map +0 -1
  1490. package/lib/typescript/src/web/NativeAudioBrowser.d.ts +0 -188
  1491. package/lib/typescript/src/web/NativeAudioBrowser.d.ts.map +0 -1
  1492. package/lib/typescript/src/web/SimpleRouter.d.ts +0 -40
  1493. package/lib/typescript/src/web/SimpleRouter.d.ts.map +0 -1
  1494. package/lib/typescript/src/web/SimpleRouter.test.d.ts +0 -2
  1495. package/lib/typescript/src/web/SimpleRouter.test.d.ts.map +0 -1
  1496. package/lib/typescript/src/web/TrackPlayer/Event.d.ts +0 -11
  1497. package/lib/typescript/src/web/TrackPlayer/Event.d.ts.map +0 -1
  1498. package/lib/typescript/src/web/TrackPlayer/Player.d.ts +0 -59
  1499. package/lib/typescript/src/web/TrackPlayer/Player.d.ts.map +0 -1
  1500. package/lib/typescript/src/web/TrackPlayer/PlaylistPlayer.d.ts +0 -39
  1501. package/lib/typescript/src/web/TrackPlayer/PlaylistPlayer.d.ts.map +0 -1
  1502. package/lib/typescript/src/web/TrackPlayer/RepeatMode.d.ts +0 -6
  1503. package/lib/typescript/src/web/TrackPlayer/RepeatMode.d.ts.map +0 -1
  1504. package/lib/typescript/src/web/TrackPlayer/SetupNotCalledError.d.ts +0 -4
  1505. package/lib/typescript/src/web/TrackPlayer/SetupNotCalledError.d.ts.map +0 -1
  1506. package/lib/typescript/src/web/TrackPlayer/SleepTimer.d.ts +0 -34
  1507. package/lib/typescript/src/web/TrackPlayer/SleepTimer.d.ts.map +0 -1
  1508. package/lib/typescript/src/web/TrackPlayer/State.d.ts +0 -13
  1509. package/lib/typescript/src/web/TrackPlayer/State.d.ts.map +0 -1
  1510. package/lib/typescript/src/web/TrackPlayer/index.d.ts +0 -5
  1511. package/lib/typescript/src/web/TrackPlayer/index.d.ts.map +0 -1
  1512. package/lib/typescript/src/web/browser/BrowserManager.d.ts +0 -154
  1513. package/lib/typescript/src/web/browser/BrowserManager.d.ts.map +0 -1
  1514. package/lib/typescript/src/web/browser/FavoriteManager.d.ts +0 -42
  1515. package/lib/typescript/src/web/browser/FavoriteManager.d.ts.map +0 -1
  1516. package/lib/typescript/src/web/browser/NavigationErrorManager.d.ts +0 -40
  1517. package/lib/typescript/src/web/browser/NavigationErrorManager.d.ts.map +0 -1
  1518. package/lib/typescript/src/web/browser/SearchManager.d.ts +0 -22
  1519. package/lib/typescript/src/web/browser/SearchManager.d.ts.map +0 -1
  1520. package/lib/typescript/src/web/http/HttpClient.d.ts +0 -25
  1521. package/lib/typescript/src/web/http/HttpClient.d.ts.map +0 -1
  1522. package/lib/typescript/src/web/http/RequestConfigBuilder.d.ts +0 -98
  1523. package/lib/typescript/src/web/http/RequestConfigBuilder.d.ts.map +0 -1
  1524. package/lib/typescript/src/web/player/NowPlayingManager.d.ts +0 -34
  1525. package/lib/typescript/src/web/player/NowPlayingManager.d.ts.map +0 -1
  1526. package/lib/typescript/src/web/player/OptionsManager.d.ts +0 -32
  1527. package/lib/typescript/src/web/player/OptionsManager.d.ts.map +0 -1
  1528. package/lib/typescript/src/web/util/BrowserPathHelper.d.ts +0 -69
  1529. package/lib/typescript/src/web/util/BrowserPathHelper.d.ts.map +0 -1
  1530. package/lib/typescript/src/web/util/shuffle.d.ts +0 -8
  1531. package/lib/typescript/src/web/util/shuffle.d.ts.map +0 -1
  1532. package/nitrogen/generated/android/c++/JAndroidUpdateOptions.hpp +0 -86
  1533. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.hpp +0 -147
  1534. package/nitrogen/generated/android/c++/JFunc_void_IosOutput.hpp +0 -80
  1535. package/nitrogen/generated/android/c++/JFunc_void_RemoteSetRatingEvent.hpp +0 -87
  1536. package/nitrogen/generated/android/c++/JHeartRating.hpp +0 -57
  1537. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -75
  1538. package/nitrogen/generated/android/c++/JIosOutputType.hpp +0 -85
  1539. package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp +0 -94
  1540. package/nitrogen/generated/android/c++/JPartialSetupPlayerOptions.hpp +0 -96
  1541. package/nitrogen/generated/android/c++/JPercentageRating.hpp +0 -57
  1542. package/nitrogen/generated/android/c++/JRatingType.hpp +0 -73
  1543. package/nitrogen/generated/android/c++/JRemoteSetRatingEvent.hpp +0 -66
  1544. package/nitrogen/generated/android/c++/JStarRating.hpp +0 -57
  1545. package/nitrogen/generated/android/c++/JThumbsRating.hpp +0 -57
  1546. package/nitrogen/generated/android/c++/JUpdateOptions.hpp +0 -105
  1547. package/nitrogen/generated/android/c++/JVariant_HeartRating_ThumbsRating_StarRating_PercentageRating.cpp +0 -34
  1548. package/nitrogen/generated/android/c++/JVariant_HeartRating_ThumbsRating_StarRating_PercentageRating.hpp +0 -105
  1549. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp +0 -26
  1550. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp +0 -75
  1551. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidUpdateOptions.kt +0 -50
  1552. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HeartRating.kt +0 -38
  1553. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -47
  1554. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IosOutput.kt +0 -44
  1555. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IosOutputType.kt +0 -32
  1556. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt +0 -50
  1557. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PartialIOSSetupPlayerOptions.kt +0 -50
  1558. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PartialSetupPlayerOptions.kt +0 -47
  1559. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PercentageRating.kt +0 -38
  1560. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSetRatingEvent.kt +0 -38
  1561. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StarRating.kt +0 -38
  1562. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ThumbsRating.kt +0 -38
  1563. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/UpdateOptions.kt +0 -53
  1564. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_HeartRating_ThumbsRating_StarRating_PercentageRating.kt +0 -77
  1565. package/nitrogen/generated/ios/swift/AndroidUpdateOptions.swift +0 -119
  1566. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.swift +0 -68
  1567. package/nitrogen/generated/ios/swift/HeartRating.swift +0 -29
  1568. package/nitrogen/generated/ios/swift/IosOutputType.swift +0 -76
  1569. package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift +0 -92
  1570. package/nitrogen/generated/ios/swift/PartialSetupPlayerOptions.swift +0 -101
  1571. package/nitrogen/generated/ios/swift/PercentageRating.swift +0 -29
  1572. package/nitrogen/generated/ios/swift/RatingType.swift +0 -60
  1573. package/nitrogen/generated/ios/swift/RemoteSetRatingEvent.swift +0 -58
  1574. package/nitrogen/generated/ios/swift/StarRating.swift +0 -29
  1575. package/nitrogen/generated/ios/swift/ThumbsRating.swift +0 -29
  1576. package/nitrogen/generated/ios/swift/UpdateOptions.swift +0 -143
  1577. package/nitrogen/generated/ios/swift/Variant_HeartRating_ThumbsRating_StarRating_PercentageRating.swift +0 -20
  1578. package/nitrogen/generated/ios/swift/Variant_NullType_NotificationButtonLayout.swift +0 -18
  1579. package/nitrogen/generated/shared/c++/AndroidUpdateOptions.hpp +0 -109
  1580. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -98
  1581. package/nitrogen/generated/shared/c++/IosOutputType.hpp +0 -112
  1582. package/nitrogen/generated/shared/c++/NotificationButtonLayout.hpp +0 -102
  1583. package/nitrogen/generated/shared/c++/PartialSetupPlayerOptions.hpp +0 -104
  1584. package/nitrogen/generated/shared/c++/RatingType.hpp +0 -96
  1585. package/nitrogen/generated/shared/c++/RemoteSetRatingEvent.hpp +0 -94
  1586. package/nitrogen/generated/shared/c++/UpdateOptions.hpp +0 -111
  1587. package/src/features/rating.ts +0 -17
  1588. package/src/types/player.ts +0 -69
  1589. package/src/web/TrackPlayer/PlaylistPlayer.ts +0 -346
@@ -0,0 +1,1808 @@
1
+ @testable import AudioBrowserTestable
2
+ import Foundation
3
+ import Testing
4
+
5
+ @MainActor
6
+ private func makeLoading(
7
+ src: String? = "https://example.com/a.mp3",
8
+ live: Bool = false,
9
+ scheduler: any SleepTimerScheduling = ManualSleepTimerScheduler(),
10
+ ) throws -> (Player, MockPlayerEngine, MockPlayerCallbacks) {
11
+ let engine = MockPlayerEngine()
12
+ let player = makePlayer(engine: engine, sleepTimerScheduler: scheduler)
13
+ let callbacks = MockPlayerCallbacks()
14
+ player.callbacks = callbacks
15
+ try player.setQueue([Track(id: "t1", src: src, title: "T", live: live)])
16
+ return (player, engine, callbacks)
17
+ }
18
+
19
+ @MainActor
20
+ private func makePlaying(
21
+ live: Bool = false,
22
+ scheduler: any SleepTimerScheduling = ManualSleepTimerScheduler(),
23
+ ) throws -> (Player, MockPlayerEngine, MockPlayerCallbacks) {
24
+ let (player, engine, callbacks) = try makeLoading(live: live, scheduler: scheduler)
25
+ player.setPlayWhenReady(true)
26
+ engine.hasItem = true
27
+ engine.hasLoadedAsset = true
28
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
29
+ player.transition(.avPlayerPlaying)
30
+ return (player, engine, callbacks)
31
+ }
32
+
33
+ /// Playing with retries that follow the play intent, then stalled: the buffer ran dry and
34
+ /// AVPlayer waits (.buffering), with a stall timeout short enough to await.
35
+ @MainActor
36
+ private func makeStalling(givesUp: Bool = false) throws -> (Player, MockPlayerEngine, MockPlayerCallbacks) {
37
+ let engine = MockPlayerEngine()
38
+ let player = makePlayer(engine: engine, retry: makeRetryLoop(givesUp: givesUp))
39
+ player.retry.stallTimeout = .milliseconds(10)
40
+ let callbacks = MockPlayerCallbacks()
41
+ player.callbacks = callbacks
42
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], playWhenReady: true)
43
+ engine.hasItem = true
44
+ engine.hasLoadedAsset = true
45
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
46
+ player.transition(.avPlayerPlaying)
47
+ engine.emit(.stalled)
48
+ player.transition(.avPlayerWaiting)
49
+ return (player, engine, callbacks)
50
+ }
51
+
52
+ /// A live stream that loaded and waits to play, its retry loop on a virtual clock.
53
+ @MainActor
54
+ private func makeVirtual(online: Bool = true) throws -> (Player, MockPlayerEngine, MockPlayerCallbacks, VirtualClock) {
55
+ let clock = VirtualClock()
56
+ let retry = RetryLoop(online: online, clock: clock)
57
+ retry.updatePolicy(from: .first(true))
58
+ let engine = MockPlayerEngine()
59
+ let player = makePlayer(engine: engine, retry: retry)
60
+ let callbacks = MockPlayerCallbacks()
61
+ player.callbacks = callbacks
62
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T", live: true)], playWhenReady: true)
63
+ engine.hasItem = true
64
+ engine.hasLoadedAsset = true
65
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
66
+ return (player, engine, callbacks, clock)
67
+ }
68
+
69
+ /// A live stream connecting, its retry loop on a virtual clock; the engine reports `previousBuffered`
70
+ /// from the item the connect replaces until the test prepares one.
71
+ @MainActor
72
+ private func makeConnecting(
73
+ playWhenReady: Bool = true,
74
+ previousBuffered: Double = 0,
75
+ live: Bool = true,
76
+ ) throws -> (Player, MockPlayerEngine, VirtualClock) {
77
+ let clock = VirtualClock()
78
+ let retry = RetryLoop(clock: clock)
79
+ retry.updatePolicy(from: .first(true))
80
+ let engine = MockPlayerEngine()
81
+ engine.bufferedPosition = previousBuffered
82
+ let player = makePlayer(engine: engine, retry: retry)
83
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T", live: live)], playWhenReady: playWhenReady)
84
+ return (player, engine, clock)
85
+ }
86
+
87
+ @Suite("Player - seeking")
88
+ @MainActor
89
+ struct PlayerSeekingTests {
90
+ @Test func aSeekWhileLoadingWaitsForTheItem_andHoldsReadyUntilItLands() throws {
91
+ let (player, engine, _) = try makeLoading()
92
+ engine.seekResult = nil
93
+ player.seek(to: 30)
94
+ #expect(engine.seekCalls.isEmpty)
95
+
96
+ engine.hasItem = true
97
+ engine.hasLoadedAsset = true
98
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
99
+ #expect(engine.seekCalls == [30])
100
+ #expect(player.state == .loading)
101
+ }
102
+
103
+ @Test func theLoadBecomesReadyWhenTheDeferredSeekLands() throws {
104
+ let (player, engine, _) = try makeLoading()
105
+ player.seek(to: 30)
106
+ engine.hasItem = true
107
+ engine.hasLoadedAsset = true
108
+ engine.emit(.itemPrepared(likelyToKeepUp: false))
109
+ #expect(engine.seekCalls == [30])
110
+ #expect(player.state == .ready)
111
+ }
112
+
113
+ @Test func seekByWhileLoadingOffsetsTheDeferredTarget() throws {
114
+ let (player, _, _) = try makeLoading()
115
+ player.seek(to: 30)
116
+ player.seek(by: 15)
117
+ #expect(player.deferredSeek.target == 45)
118
+ }
119
+
120
+ @Test func aCompletionFromBeforeATrackChangeIsDropped() throws {
121
+ let (player, engine, _) = try makePlaying()
122
+ engine.seekResult = nil
123
+ var landed: [Bool] = []
124
+ player.seek(to: 10) { landed.append($0) }
125
+
126
+ try player.setQueue([Track(id: "t2", src: "https://example.com/b.mp3", title: "B")], startPositionMs: 25000)
127
+ engine.completeSeeks(true)
128
+
129
+ // The old item's seek reports false; the new track's start stays pending.
130
+ #expect(landed == [false])
131
+ #expect(player.deferredSeek.target == 25)
132
+ #expect(player.state == .loading)
133
+ }
134
+
135
+ @Test func aCompletionFromBeforeAReloadIsDropped() throws {
136
+ let engine = MockPlayerEngine()
137
+ let player = makePlayer(engine: engine)
138
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], startPositionMs: 25000)
139
+ engine.seekResult = nil
140
+ engine.hasItem = true
141
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
142
+
143
+ player.reloadResolving(startFromCurrentTime: true)
144
+ engine.completeSeeks(true)
145
+ engine.completeSeeks(true)
146
+
147
+ #expect(player.state == .loading)
148
+ #expect(player.deferredSeek.target == 25)
149
+ #expect(engine.seekCalls == [25])
150
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
151
+ #expect(engine.seekCalls == [25, 25])
152
+ }
153
+
154
+ @Test func aStartSeekCutShortWaitsForTheNextItem() throws {
155
+ let engine = MockPlayerEngine()
156
+ let player = makePlayer(engine: engine)
157
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], startPositionMs: 25000)
158
+ engine.seekResult = nil
159
+ engine.hasItem = true
160
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
161
+
162
+ engine.completeSeeks(false)
163
+
164
+ #expect(player.state == .loading)
165
+ #expect(player.deferredSeek.target == 25)
166
+ #expect(engine.seekCalls == [25])
167
+ }
168
+
169
+ /// A media-load retry passes no position, so the start in flight is what it resumes from.
170
+ @Test func aReloadThatDoesNotResumeKeepsTheStartInFlight() throws {
171
+ let engine = MockPlayerEngine()
172
+ let player = makePlayer(engine: engine)
173
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], startPositionMs: 25000)
174
+ engine.seekResult = nil
175
+ engine.hasItem = true
176
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
177
+
178
+ player.reloadResolving(startFromCurrentTime: false)
179
+ engine.completeSeeks(true)
180
+
181
+ #expect(player.state == .loading)
182
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
183
+ #expect(engine.seekCalls == [25, 25])
184
+ }
185
+
186
+ @Test func aMediaServicesResetDuringTheLoadKeepsTheStart() throws {
187
+ let engine = MockPlayerEngine()
188
+ let player = makePlayer(engine: engine)
189
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], startPositionMs: 25000)
190
+
191
+ player.mediaServicesWereReset()
192
+ engine.hasItem = true
193
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
194
+
195
+ #expect(engine.seekCalls == [25])
196
+ }
197
+
198
+ @Test func aPlayRightAfterAStopDuringTheStartSeekStartsOver() throws {
199
+ let engine = MockPlayerEngine()
200
+ let player = makePlayer(engine: engine)
201
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], startPositionMs: 25000)
202
+ engine.seekResult = nil
203
+ engine.hasItem = true
204
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
205
+
206
+ player.stop()
207
+ player.play()
208
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
209
+
210
+ #expect(engine.seekCalls == [25, 0])
211
+ #expect(player.deferredSeek.target == nil)
212
+ }
213
+
214
+ @Test func theLiveEdgeDuringALoadWaitsForTheStartSeek() throws {
215
+ let engine = MockPlayerEngine()
216
+ let player = makePlayer(engine: engine)
217
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.m3u8", title: "T", live: true)], startPositionMs: 25000)
218
+ player.play()
219
+ engine.seekResult = nil
220
+ engine.hasItem = true
221
+ engine.hasLoadedAsset = true
222
+ engine.liveEdge = 120
223
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
224
+
225
+ player.seekToLiveEdge()
226
+ #expect(engine.seekCalls == [25])
227
+ engine.completeSeeks(true)
228
+ engine.completeSeeks(true)
229
+
230
+ #expect(engine.seekCalls == [25, 120])
231
+ #expect(player.state != .loading)
232
+ }
233
+
234
+ @Test func theLiveEdgeIsTheSeekableWindowsEnd_orAReconnectWithoutOne() throws {
235
+ let (player, engine, _) = try makePlaying(live: true)
236
+ engine.liveEdge = 120
237
+ player.seekToLiveEdge()
238
+ #expect(engine.seekCalls == [120])
239
+
240
+ engine.liveEdge = nil
241
+ player.seekToLiveEdge()
242
+ #expect(engine.resolveAndLoadCalls.count == 2)
243
+ #expect(engine.shortStartBufferRequests == [false, false])
244
+ #expect(player.state == .loading)
245
+ }
246
+
247
+ @Test func theLiveEdgeInAnErrorIsAReconnect() throws {
248
+ let (player, engine, _) = try makePlaying(live: true)
249
+ engine.liveEdge = 120
250
+ engine.emit(.failed(nil, httpStatusCode: 404))
251
+ player.seekToLiveEdge()
252
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
253
+ #expect(engine.seekCalls.isEmpty)
254
+ #expect(engine.resolveAndLoadCalls.count == 2)
255
+ }
256
+ }
257
+
258
+ @Suite("Player - engine events")
259
+ @MainActor
260
+ struct PlayerEngineEventTests {
261
+ @Test func aFailedLoadPrimesNowPlayingOncePerLoad() throws {
262
+ let (player, engine, _) = try makeLoading()
263
+ player.setPlayWhenReady(true)
264
+ engine.emit(.loadFailed(URLError(.timedOut)))
265
+ engine.emit(.loadFailed(URLError(.timedOut)))
266
+ #expect(engine.primeCount == 1)
267
+
268
+ try player.setQueue([Track(id: "t2", src: "https://example.com/b.mp3", title: "B")])
269
+ engine.emit(.loadFailed(URLError(.timedOut)))
270
+ #expect(engine.primeCount == 2)
271
+ }
272
+
273
+ @Test func aFailedLoadWithoutIntentDoesNotPrime_andWaitsForAPlay() throws {
274
+ let (player, engine, _) = try makeLoading()
275
+ engine.emit(.loadFailed(URLError(.timedOut)))
276
+ #expect(engine.primeCount == 0)
277
+ #expect(player.state == .paused)
278
+
279
+ player.setPlayWhenReady(true)
280
+ #expect(engine.resolveAndLoadCalls.count == 2)
281
+ }
282
+
283
+ @Test func aPauseWhileLoadingReachesTheEngine_aPlayDoesNot() throws {
284
+ let (player, engine, _) = try makeLoading()
285
+ player.setPlayWhenReady(true)
286
+ engine.hasItem = true
287
+ engine.hasLoadedAsset = true
288
+ engine.emit(.itemPrepared(likelyToKeepUp: false))
289
+ #expect(player.state == .loading)
290
+ let plays = engine.startPlaybackCallCount
291
+ let pauses = engine.pausePlaybackCallCount
292
+
293
+ player.setPlayWhenReady(false)
294
+ #expect(engine.pausePlaybackCallCount == pauses + 1)
295
+
296
+ player.setPlayWhenReady(true)
297
+ #expect(engine.startPlaybackCallCount == plays)
298
+ engine.emit(.likelyToKeepUp(true))
299
+ #expect(engine.startPlaybackCallCount == plays + 1)
300
+ }
301
+
302
+ @Test func anUnplayableAssetIsTerminal() throws {
303
+ let (player, engine, _) = try makeLoading()
304
+ engine.emit(.unplayable)
305
+ #expect(player.state == .error)
306
+ #expect(player.errorStatus == .terminal(.trackWasUnplayable, report: 1))
307
+ }
308
+
309
+ @Test func anInvalidSourceIsTerminal() throws {
310
+ let (player, engine, _) = try makeLoading()
311
+ engine.emit(.invalidSource("::"))
312
+ #expect(player.errorStatus == .terminal(.invalidSourceUrl("::"), report: 1))
313
+ }
314
+
315
+ @Test func aPlayerFailureCarriesItsHTTPStatus() throws {
316
+ let (player, engine, _) = try makePlaying()
317
+ engine.emit(.failed(nil, httpStatusCode: 404))
318
+ #expect(player.errorStatus == .terminal(.httpStatus(404), report: 1))
319
+ }
320
+
321
+ @Test func aGenuineEndAdvances_aLiveEndReconnectsThroughTheRetryLoop() async throws {
322
+ let (player, engine, _) = try makePlaying()
323
+ engine.currentTime = 300
324
+ engine.duration = 300
325
+ engine.emit(.playedToEnd)
326
+ #expect(player.state == .ended)
327
+
328
+ let (live, liveEngine, _) = try makePlaying(live: true)
329
+ liveEngine.emit(.playedToEnd)
330
+ await live.retry.pendingTask?.value
331
+ #expect(live.state == .loading)
332
+ #expect(liveEngine.resolveAndLoadCalls.count == 2)
333
+ }
334
+
335
+ /// docs/adr/0014: a stream that keeps closing keeps playing, with a short gap at each close.
336
+ @Test func aLiveEndsReconnectStartsOnAShortBuffer_theListenersConnectsDoNot() async throws {
337
+ let (player, engine, _) = try makePlaying(live: true)
338
+ engine.emit(.playedToEnd)
339
+ await player.retry.pendingTask?.value
340
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
341
+ player.retryNow()
342
+ #expect(engine.shortStartBufferRequests == [false, true, false])
343
+ }
344
+
345
+ /// AVPlayer pauses an item at its end, so a seek within its window would leave it silent.
346
+ @Test func aLiveEndReconnectsEvenWithASeekableWindow() async throws {
347
+ let (player, engine, _) = try makePlaying(live: true)
348
+ engine.liveEdge = 120
349
+ engine.emit(.playedToEnd)
350
+ await player.retry.pendingTask?.value
351
+ #expect(engine.seekCalls.isEmpty)
352
+ #expect(engine.resolveAndLoadCalls.count == 2)
353
+ }
354
+
355
+ @Test func liveEndsThatKeepComingEndInATerminalErrorWithinTheBudget() async throws {
356
+ let (player, engine, callbacks) = try makePlaying(live: true)
357
+ player.retry.updatePolicy(from: .second(RetryConfig(
358
+ maxRetries: 3, maxRetryDurationMs: nil, firstConnectMaxRetryDurationMs: nil,
359
+ )))
360
+ for _ in 0 ..< 20 where player.state != .error {
361
+ engine.emit(.playedToEnd)
362
+ await player.retry.pendingTask?.value
363
+ engine.hasLoadedAsset = true
364
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
365
+ }
366
+ // The first connection played, so its end starts the count: four that deliver nothing follow.
367
+ #expect(engine.resolveAndLoadCalls.count == 5)
368
+ #expect(player.state == .error)
369
+ #expect(player.errorStatus.error == .playbackStalled)
370
+ #expect(callbacks.errorEvents.count == 1)
371
+ }
372
+
373
+ /// A connection that delivered audio starts `maxRetries`' count over (docs/adr/0014).
374
+ @Test func liveEndsBetweenAudioNeverSpendMaxRetries() async throws {
375
+ let (player, engine, callbacks) = try makePlaying(live: true)
376
+ player.retry.updatePolicy(from: .second(RetryConfig(
377
+ maxRetries: 1, maxRetryDurationMs: nil, firstConnectMaxRetryDurationMs: nil,
378
+ )))
379
+ for _ in 0 ..< 5 {
380
+ engine.emit(.playedToEnd)
381
+ await player.retry.pendingTask?.value
382
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
383
+ player.transition(.avPlayerPlaying)
384
+ }
385
+ #expect(engine.resolveAndLoadCalls.count == 6)
386
+ #expect(player.state == .playing)
387
+ #expect(callbacks.errorEvents.isEmpty)
388
+ }
389
+
390
+ @Test func aLiveEndWithRetryOffIsTerminal_withNoBufferingOnTheWay() throws {
391
+ let (player, engine, callbacks) = try makePlaying(live: true)
392
+ player.retry.updatePolicy(from: nil)
393
+ let changesBefore = callbacks.playbackChanges.count
394
+ engine.emit(.playedToEnd)
395
+ #expect(player.state == .error)
396
+ #expect(engine.resolveAndLoadCalls.count == 1)
397
+ #expect(callbacks.playbackChanges.dropFirst(changesBefore).map(\.state) == [.error])
398
+ }
399
+
400
+ /// The engine stops observing an item on a reload; a played-to-end it delivered late is stale.
401
+ @Test func aPlayedToEndDuringALoadIsIgnored() throws {
402
+ let (player, engine, _) = try makePlaying(live: true)
403
+ player.reloadResolving(startFromCurrentTime: false)
404
+ #expect(player.state == .loading)
405
+ engine.emit(.playedToEnd)
406
+ #expect(player.state == .loading)
407
+ #expect(player.retry.pendingTask == nil)
408
+ }
409
+
410
+ /// A truncated file stalls rather than ending (the stall watch's); a short end is a duration
411
+ /// AVPlayer overestimated, as for a VBR file without a header.
412
+ @Test func anOnDemandEndShortOfItsEstimatedDurationAdvances() throws {
413
+ let (player, engine, _) = try makePlaying()
414
+ try player.add([Track(id: "t2", src: "https://example.com/b.mp3", title: "B")])
415
+ engine.currentTime = 120
416
+ engine.duration = 300
417
+
418
+ engine.emit(.playedToEnd)
419
+
420
+ #expect(player.queue.currentIndex == 1)
421
+ #expect(player.retry.pendingTask == nil)
422
+ }
423
+
424
+ @Test func aStallNudgesPlayback_onlyWithIntent() throws {
425
+ let (player, engine, _) = try makePlaying()
426
+ engine.startPlaybackCallCount = 0
427
+ engine.emit(.stalled)
428
+ #expect(engine.startPlaybackCallCount == 1)
429
+
430
+ player.pause()
431
+ engine.startPlaybackCallCount = 0
432
+ engine.emit(.stalled)
433
+ #expect(engine.startPlaybackCallCount == 0)
434
+ }
435
+
436
+ @Test func anAirPlayStrandingIsNudged() throws {
437
+ let (player, engine, _) = try makePlaying()
438
+ engine.isAirPlayRoute = true
439
+ engine.emit(.timeControlStatus(.waitingToPlayAtSpecifiedRate, waitingForNoItem: true))
440
+ engine.startPlaybackCallCount = 0
441
+ engine.emit(.timeControlStatus(.paused, waitingForNoItem: false))
442
+ #expect(engine.startPlaybackCallCount == 1)
443
+ #expect(player.playWhenReady)
444
+ }
445
+ }
446
+
447
+ @Suite("Player - recovering")
448
+ @MainActor
449
+ struct PlayerRecoveringTests {
450
+ @Test func aStallThatOutlastsTheTimeoutIsRetried() async throws {
451
+ let (player, engine, callbacks) = try makeStalling()
452
+ await player.retry.stallTask?.value
453
+ #expect(callbacks.playbackChanges.last?.error?.code == TrackPlayerError.PlaybackError.playbackStalled.code)
454
+ #expect(callbacks.playbackChanges.last?.error?.retrying == true)
455
+ await player.retry.pendingTask?.value
456
+ #expect(engine.resolveAndLoadCalls.count == 2)
457
+ #expect(engine.shortStartBufferRequests == [false, true])
458
+ #expect(player.state == .loading)
459
+ }
460
+
461
+ @Test func aStallWithNoFailureEndsInPlaybackStalledOnceTheBudgetIsSpent() async throws {
462
+ let (player, engine, callbacks) = try makeStalling(givesUp: true)
463
+ await player.retry.stallTask?.value
464
+ await player.retry.pendingTask?.value
465
+ // The stalled connection had played, so even `maxRetries: 0` reconnects it once.
466
+ #expect(engine.resolveAndLoadCalls.count == 2)
467
+ player.transition(.avPlayerWaiting)
468
+ await player.retry.stallTask?.value
469
+ await player.retry.pendingTask?.value
470
+ #expect(player.state == .error)
471
+ #expect(player.errorStatus.error == .playbackStalled)
472
+ #expect(callbacks.errorEvents.count == 1)
473
+ }
474
+
475
+ @Test func aStallThatRecoversIsNotRetried() async throws {
476
+ let (player, engine, _) = try makeStalling()
477
+ player.transition(.avPlayerPlaying)
478
+ await player.retry.stallTask?.value
479
+ #expect(player.retry.pendingTask == nil)
480
+ #expect(engine.resolveAndLoadCalls.count == 1)
481
+ }
482
+
483
+ /// Without `automaticallyWaitsToMinimizeStalling`, AVPlayer reports a stall while the state
484
+ /// stays .playing, and audio may well be playing.
485
+ @Test func aStallReportedWhilePlayingStartsNoWatch() throws {
486
+ let (player, engine, _) = try makePlaying()
487
+ engine.emit(.stalled)
488
+ #expect(player.state == .playing)
489
+ #expect(player.retry.stallTask == nil)
490
+ }
491
+
492
+ @Test func aResumeIntoBufferingStartsANewWatch() throws {
493
+ let (player, engine, _) = try makeStalling()
494
+ player.pause()
495
+ engine.emit(.timeControlStatus(.paused, waitingForNoItem: false))
496
+ player.play()
497
+ engine.emit(.timeControlStatus(.waitingToPlayAtSpecifiedRate, waitingForNoItem: false))
498
+ #expect(player.state == .buffering)
499
+ #expect(player.retry.stallTask != nil)
500
+ player.retry.cancel()
501
+ }
502
+
503
+ @Test func aPauseEndsTheStallWatch() throws {
504
+ let (player, engine, _) = try makeStalling()
505
+ player.pause()
506
+ engine.emit(.timeControlStatus(.paused, waitingForNoItem: false))
507
+ #expect(player.retry.stallTask == nil)
508
+ #expect(player.load?.reloadOnPlay == false)
509
+ #expect(player.state == .paused)
510
+ }
511
+
512
+ @Test func aTrackChangeEndsTheStallWatch() throws {
513
+ let (player, _, _) = try makeStalling()
514
+ let stallWatch = player.retry.stallTask
515
+ try player.setQueue([Track(id: "t2", src: "https://example.com/b.mp3", title: "B")])
516
+ #expect(stallWatch?.isCancelled == true)
517
+ }
518
+
519
+ @Test func aConnectThatSendsNothingIsReplacedAfterTheTimeout() async throws {
520
+ let (player, engine, clock) = try makeConnecting()
521
+ await clock.run(until: 30_999)
522
+ #expect(engine.resolveAndLoadCalls.count == 1)
523
+ await clock.run(until: 31_000)
524
+ #expect(engine.resolveAndLoadCalls.count == 2)
525
+ #expect(player.state == .loading)
526
+ }
527
+
528
+ /// The item it replaces had buffered further than the new one has yet.
529
+ @Test func aSlowConnectThatKeepsReceivingDataIsKept() async throws {
530
+ let (player, engine, clock) = try makeConnecting(previousBuffered: 50)
531
+ engine.hasItem = true
532
+ engine.bufferedPosition = 1
533
+ engine.emit(.itemPrepared(likelyToKeepUp: false))
534
+ for atMs in stride(from: 20_000, through: 100_000, by: 20_000) {
535
+ clock.at(atMs) { engine.bufferedPosition += 1 }
536
+ }
537
+ await clock.run(until: 100_000)
538
+ #expect(player.state == .loading)
539
+ #expect(engine.resolveAndLoadCalls.count == 1)
540
+ }
541
+
542
+ /// A stall's reconnect: the stalled item stays in the engine, still buffering, while the new
543
+ /// connect sends nothing.
544
+ @Test func theItemAConnectReplacesBufferingOnIsNoProgress() async throws {
545
+ let (player, engine, _, clock) = try makeVirtual()
546
+ engine.bufferedPosition = 50
547
+ player.transition(.avPlayerPlaying)
548
+ await clock.run(until: 10_000)
549
+ player.transition(.avPlayerWaiting)
550
+ await clock.run(until: 40_000)
551
+ #expect(engine.resolveAndLoadCalls.count == 2)
552
+
553
+ for atMs in stride(from: 45_000, through: 70_000, by: 5_000) {
554
+ clock.at(atMs) { engine.bufferedPosition += 1 }
555
+ }
556
+ await clock.run(until: 70_000)
557
+ await clock.run(until: 71_000)
558
+ #expect(engine.resolveAndLoadCalls.count == 3)
559
+ }
560
+
561
+ @Test func aPauseDuringAnOnDemandConnectHoldsItPastTheTimeout() async throws {
562
+ let (player, engine, clock) = try makeConnecting(live: false)
563
+ await clock.run(until: 10_000)
564
+ player.pause()
565
+ await clock.run(until: 200_000)
566
+ #expect(engine.resolveAndLoadCalls.count == 1)
567
+ #expect(player.load?.reloadOnPlay == false)
568
+ #expect(player.state == .loading)
569
+ }
570
+
571
+ @Test func withRetryOffASilentConnectIsTerminalAtTheTimeout() async throws {
572
+ let (player, engine, clock) = try makeConnecting()
573
+ player.retry.updatePolicy(from: nil)
574
+ await clock.run(until: 29_999)
575
+ #expect(player.state == .loading)
576
+ await clock.run(until: 30_000)
577
+ #expect(player.state == .error)
578
+ #expect(player.errorStatus.error == .playbackStalled)
579
+ #expect(engine.resolveAndLoadCalls.count == 1)
580
+ }
581
+
582
+ /// On demand: a live stream queued without play intent does not connect.
583
+ @Test func aPlayWhileConnectingWatchesTheConnect() async throws {
584
+ let (player, engine, clock) = try makeConnecting(playWhenReady: false, live: false)
585
+ await clock.run(until: 10_000)
586
+ player.play()
587
+ await clock.run(until: 41_000)
588
+ #expect(engine.resolveAndLoadCalls.count == 2)
589
+ }
590
+
591
+ /// Ready and waiting for AVPlayer to start: its waiting is a stall, watched in .buffering.
592
+ @Test func aConnectThatIsReadyIsNoLongerWatched() async throws {
593
+ let (player, engine, clock) = try makeConnecting()
594
+ engine.hasItem = true
595
+ engine.hasLoadedAsset = true
596
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
597
+ #expect(player.state == .ready)
598
+ await clock.run(until: 100_000)
599
+ #expect(engine.resolveAndLoadCalls.count == 1)
600
+ }
601
+
602
+ /// A link slower than the bitrate rebuffers for longer than the timeout, and a reload would
603
+ /// throw away the buffer it is filling.
604
+ @Test func aStallThatStillReceivesDataKeepsWaiting_untilAWindowBringsNone() async throws {
605
+ let (player, engine, _) = try makeStalling()
606
+ engine.bufferedPosition = 12
607
+ await player.retry.stallTask?.value
608
+ #expect(player.retry.pendingTask == nil)
609
+ #expect(player.retry.stallTask != nil)
610
+ #expect(engine.resolveAndLoadCalls.count == 1)
611
+
612
+ await player.retry.stallTask?.value
613
+ await player.retry.pendingTask?.value
614
+ #expect(engine.resolveAndLoadCalls.count == 2)
615
+ }
616
+
617
+ /// Near a track's end, a pause leaves the state in .buffering, so the resume is no transition.
618
+ @Test func aResumeWhileTheStateHeldBufferingStartsANewWatch() async throws {
619
+ let (player, _, _) = try makeStalling()
620
+ player.pause()
621
+ await player.retry.stallTask?.value
622
+ #expect(player.state == .buffering)
623
+ #expect(player.retry.stallTask == nil)
624
+
625
+ player.play()
626
+ #expect(player.retry.stallTask != nil)
627
+ player.retry.cancel()
628
+ }
629
+
630
+ /// The stalled item is still alive: data arriving later must not play it under the error.
631
+ @Test func aTerminalStallLeavesNothingThatCanPlay() async throws {
632
+ let (player, engine, _) = try makeStalling()
633
+ player.retry.updatePolicy(from: nil)
634
+ let pauses = engine.pausePlaybackCallCount
635
+ await player.retry.stallTask?.value
636
+ #expect(player.state == .error)
637
+ #expect(engine.pausePlaybackCallCount == pauses + 1)
638
+
639
+ engine.startPlaybackCallCount = 0
640
+ engine.emit(.stalled)
641
+ #expect(engine.startPlaybackCallCount == 0)
642
+ }
643
+
644
+ @Test func anAirPlayStrandingInAnErrorIsNotNudged() throws {
645
+ let (player, engine, _) = try makePlaying()
646
+ engine.isAirPlayRoute = true
647
+ engine.emit(.timeControlStatus(.waitingToPlayAtSpecifiedRate, waitingForNoItem: true))
648
+ player.transition(.errorOccurred(.playbackStalled))
649
+ engine.startPlaybackCallCount = 0
650
+ engine.emit(.timeControlStatus(.paused, waitingForNoItem: false))
651
+ #expect(engine.startPlaybackCallCount == 0)
652
+ }
653
+
654
+ @Test func aStallWithRetryOffIsTerminalAtTheTimeout() async throws {
655
+ let (player, engine, _) = try makeStalling()
656
+ player.retry.updatePolicy(from: nil)
657
+ await player.retry.stallTask?.value
658
+ #expect(player.state == .error)
659
+ #expect(player.errorStatus.error == .playbackStalled)
660
+ #expect(engine.resolveAndLoadCalls.count == 1)
661
+ }
662
+
663
+ @Test func theDeadlineEndsASilentLoadInOneError_droppingTheConnectInFlight() async throws {
664
+ let clock = VirtualClock()
665
+ let retry = RetryLoop(clock: clock)
666
+ retry.updatePolicy(from: .first(true))
667
+ let engine = MockPlayerEngine()
668
+ let player = makePlayer(engine: engine, retry: retry)
669
+ let callbacks = MockPlayerCallbacks()
670
+ player.callbacks = callbacks
671
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], playWhenReady: true)
672
+ // The watch replaces the silent connect at 30 s, 1 s after it gives up on it; that failure
673
+ // brings the deadline to 42 s.
674
+ await clock.run(until: 31_000)
675
+ #expect(engine.resolveAndLoadCalls.count == 2)
676
+ let cancels = engine.cancelLoadingCount, stops = engine.stopObservingItemCount
677
+
678
+ await clock.run(until: 41_999)
679
+ #expect(player.state == .loading)
680
+ await clock.run(until: 42_000)
681
+
682
+ #expect(player.state == .error)
683
+ #expect(player.errorStatus.error == .playbackStalled)
684
+ #expect(callbacks.errorEvents.count == 1)
685
+ #expect(engine.cancelLoadingCount == cancels + 1)
686
+ #expect(engine.stopObservingItemCount == stops + 1)
687
+ }
688
+
689
+ /// The error pauses AVPlayer, and an item still connecting can report late: neither the pause,
690
+ /// nor its playing, nor its failure takes the state out of .error.
691
+ @Test func aTerminalErrorHoldsAgainstTheAVPlayersLateEvents() async throws {
692
+ let (player, engine, callbacks) = try makeStalling(givesUp: true)
693
+ engine.emit(.failed(URLError(.badURL), httpStatusCode: nil))
694
+ #expect(player.state == .error)
695
+ let loads = engine.resolveAndLoadCalls.count
696
+
697
+ engine.emit(.timeControlStatus(.paused, waitingForNoItem: false))
698
+ engine.emit(.timeControlStatus(.playing, waitingForNoItem: false))
699
+ engine.emit(.audioDidStart)
700
+ engine.emit(.failed(NSError(domain: "AVFoundationErrorDomain", code: -11800), httpStatusCode: nil))
701
+ await player.retry.pendingTask?.value
702
+
703
+ #expect(player.state == .error)
704
+ #expect(player.errorStatus.error == .playbackFailed)
705
+ #expect(callbacks.errorEvents.count == 1)
706
+ #expect(player.retry.pendingTask == nil)
707
+ #expect(engine.resolveAndLoadCalls.count == loads)
708
+ }
709
+
710
+ /// The stalled connection ends with the network, before its return reaches the loop, so it
711
+ /// grows no backoff: only the 1 s floor applies, long past.
712
+ @Test func theNetworkReturningReconnectsAStalledStreamAtOnce() async throws {
713
+ let (player, engine, _, clock) = try makeVirtual(online: false)
714
+ player.transition(.avPlayerWaiting)
715
+ #expect(player.state == .buffering)
716
+ await clock.run(until: 5_000)
717
+
718
+ player.networkStatusDidChange(isOnline: true)
719
+ await clock.run(until: 5_000)
720
+
721
+ #expect(engine.resolveAndLoadCalls.count == 2)
722
+ }
723
+
724
+ /// A short drop leaves the connection dead with audio still buffered: the stall comes after the
725
+ /// network is back, and AVPlayer never fails it.
726
+ @Test func aStallAfterAShortDropReconnectsAtOnce() async throws {
727
+ let (player, engine, _, clock) = try makeVirtual()
728
+ engine.bufferedPosition = 20
729
+ player.transition(.avPlayerPlaying)
730
+ await clock.run(until: 10_000)
731
+ player.networkStatusDidChange(isOnline: false)
732
+ await clock.run(until: 13_000)
733
+ player.networkStatusDidChange(isOnline: true)
734
+ await clock.run(until: 15_000)
735
+
736
+ player.transition(.avPlayerWaiting)
737
+ await clock.run(until: 15_000)
738
+
739
+ #expect(engine.resolveAndLoadCalls.count == 2)
740
+ }
741
+
742
+ @Test func aConnectionThatBuffersAfterTheDropWaitsOutTheWatch() async throws {
743
+ let (player, engine, _, clock) = try makeVirtual()
744
+ engine.bufferedPosition = 20
745
+ player.transition(.avPlayerPlaying)
746
+ player.networkStatusDidChange(isOnline: false)
747
+ player.networkStatusDidChange(isOnline: true)
748
+ await clock.run(until: 5_000)
749
+ engine.bufferedPosition = 25
750
+
751
+ player.transition(.avPlayerWaiting)
752
+ await clock.run(until: 34_999)
753
+ #expect(engine.resolveAndLoadCalls.count == 1)
754
+ await clock.run(until: 35_000)
755
+ #expect(engine.resolveAndLoadCalls.count == 2)
756
+ }
757
+
758
+ @Test func aConnectionStartedAfterTheDropWaitsOutTheWatch() async throws {
759
+ let (player, engine, _, clock) = try makeVirtual()
760
+ player.networkStatusDidChange(isOnline: false)
761
+ player.networkStatusDidChange(isOnline: true)
762
+ player.retryNow()
763
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
764
+ player.transition(.avPlayerPlaying)
765
+ await clock.run(until: 5_000)
766
+
767
+ player.transition(.avPlayerWaiting)
768
+ await clock.run(until: 34_999)
769
+ #expect(engine.resolveAndLoadCalls.count == 2)
770
+ await clock.run(until: 35_000)
771
+ #expect(engine.resolveAndLoadCalls.count == 3)
772
+ }
773
+
774
+ /// What arrives after the drop is reported was on its way before it.
775
+ @Test func audioDrainingInDuringTheDropLeavesTheConnectionDead() async throws {
776
+ let (player, engine, _, clock) = try makeVirtual()
777
+ engine.bufferedPosition = 20
778
+ player.transition(.avPlayerPlaying)
779
+ await clock.run(until: 10_000)
780
+ player.networkStatusDidChange(isOnline: false)
781
+ engine.bufferedPosition = 20.4
782
+ player.networkStatusDidChange(isOnline: true)
783
+
784
+ player.transition(.avPlayerWaiting)
785
+ await clock.run(until: 10_000)
786
+
787
+ #expect(engine.resolveAndLoadCalls.count == 2)
788
+ }
789
+
790
+ @Test func aSecondDropKillsAConnectionThatLivedThroughTheFirst() async throws {
791
+ let (player, engine, _, clock) = try makeVirtual()
792
+ engine.bufferedPosition = 20
793
+ player.transition(.avPlayerPlaying)
794
+ await clock.run(until: 10_000)
795
+ player.networkStatusDidChange(isOnline: false)
796
+ player.networkStatusDidChange(isOnline: true)
797
+ engine.bufferedPosition = 80
798
+ await clock.run(until: 60_000)
799
+ player.networkStatusDidChange(isOnline: false)
800
+ player.networkStatusDidChange(isOnline: true)
801
+
802
+ player.transition(.avPlayerWaiting)
803
+ await clock.run(until: 60_000)
804
+
805
+ #expect(engine.resolveAndLoadCalls.count == 2)
806
+ }
807
+
808
+ @Test func aSeekAfterTheDropWaitsForItsData_andPlayingAgainClearsTheDrop() async throws {
809
+ let (player, engine, _, clock) = try makeVirtual()
810
+ player.transition(.avPlayerPlaying)
811
+ player.networkStatusDidChange(isOnline: false)
812
+ player.networkStatusDidChange(isOnline: true)
813
+ player.transition(.avPlayerWaiting)
814
+ // The 1 s floor from the first connect's start.
815
+ await clock.run(until: 1_000)
816
+ #expect(engine.resolveAndLoadCalls.count == 2)
817
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
818
+ player.transition(.avPlayerPlaying)
819
+ player.networkStatusDidChange(isOnline: false)
820
+ player.networkStatusDidChange(isOnline: true)
821
+ player.seek(to: 300)
822
+ player.transition(.avPlayerWaiting)
823
+ await clock.run(until: 2_000)
824
+ #expect(engine.resolveAndLoadCalls.count == 2)
825
+ player.transition(.avPlayerPlaying)
826
+ await clock.run(until: 5_000)
827
+
828
+ player.transition(.avPlayerWaiting)
829
+ await clock.run(until: 34_999)
830
+ #expect(engine.resolveAndLoadCalls.count == 2)
831
+ await clock.run(until: 35_000)
832
+ #expect(engine.resolveAndLoadCalls.count == 3)
833
+ }
834
+
835
+ /// A connect that delivered nothing ends online, and counts toward `maxRetries`: only the watch
836
+ /// gives it up, as without the drop.
837
+ /// On demand: a live stream queued without play intent does not connect.
838
+ @Test func aSilentConnectFromBeforeTheDropWaitsOutTheWatch() async throws {
839
+ let clock = VirtualClock()
840
+ let retry = RetryLoop(online: false, clock: clock)
841
+ retry.updatePolicy(from: .second(RetryConfig(
842
+ maxRetries: 0, maxRetryDurationMs: nil, firstConnectMaxRetryDurationMs: nil,
843
+ )))
844
+ let engine = MockPlayerEngine()
845
+ let player = makePlayer(engine: engine, retry: retry)
846
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")])
847
+ player.networkStatusDidChange(isOnline: true)
848
+
849
+ player.play()
850
+ await clock.run(until: 29_999)
851
+
852
+ #expect(player.state == .loading)
853
+ #expect(engine.resolveAndLoadCalls.count == 1)
854
+ }
855
+
856
+ /// A live stream queued, then played, as a separate call: its connect is dropped and the engine
857
+ /// reports nothing about it, ever. The stall watch fails it at 30 s, and a Load that never played
858
+ /// gives up 12 s after its first failure.
859
+ @Test func aConnectThatEndsUnreportedStillEndsInTheError() async throws {
860
+ let clock = VirtualClock()
861
+ let retry = RetryLoop(clock: clock)
862
+ retry.updatePolicy(from: .first(true))
863
+ let engine = MockPlayerEngine()
864
+ let player = makePlayer(engine: engine, retry: retry)
865
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T", live: true)])
866
+ player.play()
867
+
868
+ await clock.run(until: 41_999)
869
+ #expect(player.state == .loading)
870
+ #expect(engine.resolveAndLoadCalls.count == 2)
871
+ await clock.run(until: 42_000)
872
+ #expect(player.state == .error)
873
+ #expect(player.errorStatus.error == .playbackStalled)
874
+ }
875
+
876
+ @Test func aStallAfterAShortDropWithRetryOffIsLeftToAVPlayer() async throws {
877
+ let (player, engine, callbacks, clock) = try makeVirtual()
878
+ player.retry.updatePolicy(from: nil)
879
+ player.transition(.avPlayerPlaying)
880
+ player.networkStatusDidChange(isOnline: false)
881
+ player.networkStatusDidChange(isOnline: true)
882
+
883
+ player.transition(.avPlayerWaiting)
884
+ await clock.run(until: 1_000)
885
+
886
+ #expect(player.state == .buffering)
887
+ #expect(engine.resolveAndLoadCalls.count == 1)
888
+ #expect(callbacks.errorEvents.isEmpty)
889
+ }
890
+
891
+ /// The stall that follows a short drop ends at the deadline, 120 s into its silence, when no
892
+ /// connection after it delivers audio.
893
+ @Test func aStallAfterAShortDropStillEndsAtTheDeadline() async throws {
894
+ let (player, engine, callbacks, clock) = try makeVirtual()
895
+ player.transition(.avPlayerPlaying)
896
+ await clock.run(until: 10_000)
897
+ player.networkStatusDidChange(isOnline: false)
898
+ await clock.run(until: 13_000)
899
+ player.networkStatusDidChange(isOnline: true)
900
+ await clock.run(until: 15_000)
901
+ player.transition(.avPlayerWaiting)
902
+
903
+ await clock.run(until: 134_999)
904
+ #expect(player.state == .loading)
905
+ #expect(engine.resolveAndLoadCalls.count > 1)
906
+ await clock.run(until: 135_000)
907
+ #expect(player.state == .error)
908
+ #expect(player.errorStatus.error == .playbackStalled)
909
+ #expect(callbacks.errorEvents.count == 1)
910
+ }
911
+
912
+ /// The watch replaces the stall at 40 s at once, having played, then each silent connect 30 s
913
+ /// after it starts, 1 s and then 1.5 s later: the deadline still falls 120 s into the silence.
914
+ @Test func playbackThatStopsWithNoFailureEndsAtTheDeadline() async throws {
915
+ let (player, engine, callbacks, clock) = try makeVirtual()
916
+ player.transition(.avPlayerPlaying)
917
+ await clock.run(until: 10_000)
918
+ player.transition(.avPlayerWaiting)
919
+
920
+ await clock.run(until: 129_999)
921
+ #expect(player.state == .loading)
922
+ #expect(engine.resolveAndLoadCalls.count == 4)
923
+ await clock.run(until: 130_000)
924
+ #expect(player.state == .error)
925
+ #expect(player.errorStatus.error == .playbackStalled)
926
+ #expect(callbacks.errorEvents.count == 1)
927
+ }
928
+
929
+ @Test func aRetryNowKeepsTheSilenceDeadline() async throws {
930
+ let (player, _, _, clock) = try makeVirtual()
931
+ // Its watch would end the reload's connect first.
932
+ player.retry.stallTimeout = .seconds(600)
933
+ await clock.run(until: 60_000)
934
+ player.retryNow()
935
+
936
+ await clock.run(until: 119_999)
937
+ #expect(player.state != .error)
938
+ await clock.run(until: 120_000)
939
+ #expect(player.state == .error)
940
+ }
941
+
942
+ @Test func hasPlayedSurvivesAPark_aRetryNowAndAMediaReset() async throws {
943
+ let engine = MockPlayerEngine()
944
+ let player = makePlayer(engine: engine, retry: makeRetryLoop(delay: 0.05))
945
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], playWhenReady: true)
946
+ engine.hasItem = true
947
+ engine.hasLoadedAsset = true
948
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
949
+ player.transition(.avPlayerPlaying)
950
+ #expect(player.retry.hasPlayed)
951
+
952
+ engine.emit(.failed(URLError(.timedOut), httpStatusCode: nil))
953
+ player.pause()
954
+ #expect(player.state == .paused)
955
+ player.play()
956
+ player.retryNow()
957
+ player.mediaServicesWereReset()
958
+
959
+ #expect(player.retry.hasPlayed)
960
+ player.retry.cancel()
961
+ }
962
+
963
+ @Test func aRateChangeInAnErrorLeavesTheAbandonedItemPaused() throws {
964
+ let (player, engine, _) = try makePlaying()
965
+ engine.emit(.failed(URLError(.badURL), httpStatusCode: nil))
966
+ #expect(player.state == .error)
967
+ #expect(player.playWhenReady)
968
+
969
+ player.rate = 1.5
970
+
971
+ #expect(engine.rates.last?.rate == 1.5)
972
+ #expect(engine.rates.last?.playing == false)
973
+ }
974
+
975
+ /// `maxRetries` counts connections in a row that delivered nothing; one that plays between
976
+ /// flaps starts it over, and only the silence deadline bounds it (docs/adr/0014).
977
+ @Test func aFlappingConnectionThatPlaysBetweenKeepsReconnecting() async throws {
978
+ let (player, engine, callbacks) = try makePlaying()
979
+ player.retry.updatePolicy(from: .second(RetryConfig(
980
+ maxRetries: 2, maxRetryDurationMs: nil, firstConnectMaxRetryDurationMs: nil,
981
+ )))
982
+ for _ in 1 ... 5 {
983
+ player.transition(.avPlayerWaiting)
984
+ player.networkStatusDidChange(isOnline: false)
985
+ player.networkStatusDidChange(isOnline: true)
986
+ await player.retry.pendingTask?.value
987
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
988
+ player.transition(.avPlayerPlaying)
989
+ }
990
+ #expect(engine.resolveAndLoadCalls.count == 6)
991
+ #expect(player.state == .playing)
992
+ #expect(callbacks.errorEvents.isEmpty)
993
+ }
994
+
995
+ @Test func theNetworkReturningWithRetryOffLeavesTheStallToAVPlayer() throws {
996
+ let (player, engine, callbacks) = try makePlaying()
997
+ player.retry.updatePolicy(from: nil)
998
+ player.transition(.avPlayerWaiting)
999
+ player.networkStatusDidChange(isOnline: false)
1000
+ player.networkStatusDidChange(isOnline: true)
1001
+ #expect(player.state == .buffering)
1002
+ #expect(engine.resolveAndLoadCalls.count == 1)
1003
+ #expect(callbacks.errorEvents.isEmpty)
1004
+ }
1005
+
1006
+ @Test func theNetworkReturningLeavesAPausedOrPlayingStreamAlone() throws {
1007
+ let (player, engine, _) = try makePlaying()
1008
+ player.networkStatusDidChange(isOnline: false)
1009
+ player.networkStatusDidChange(isOnline: true)
1010
+ player.pause()
1011
+ player.networkStatusDidChange(isOnline: false)
1012
+ player.networkStatusDidChange(isOnline: true)
1013
+ #expect(engine.resolveAndLoadCalls.count == 1)
1014
+ }
1015
+
1016
+ @Test func theNetworkReturningDuringABackoffLeavesTheReloadToTheRetry() async throws {
1017
+ let engine = MockPlayerEngine()
1018
+ let player = makePlayer(engine: engine, retry: makeRetryLoop(delay: 0.05))
1019
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")])
1020
+ player.play()
1021
+ player.transition(.avPlayerWaiting)
1022
+ engine.emit(.failed(URLError(.timedOut), httpStatusCode: nil))
1023
+ let retrying = player.retry.pendingTask
1024
+ let loadsBefore = engine.resolveAndLoadCalls.count
1025
+
1026
+ player.networkStatusDidChange(isOnline: false)
1027
+ player.networkStatusDidChange(isOnline: true)
1028
+ await retrying?.value
1029
+
1030
+ #expect(player.state == .loading)
1031
+ #expect(engine.resolveAndLoadCalls.count == loadsBefore + 1)
1032
+ }
1033
+
1034
+ @Test func theNetworkGoingReRendersTheStallLineWithoutReconnecting() throws {
1035
+ let (player, engine, _) = try makePlaying()
1036
+ player.transition(.avPlayerWaiting)
1037
+ engine.nowPlayingRenderCount = 0
1038
+
1039
+ player.networkStatusDidChange(isOnline: false)
1040
+
1041
+ #expect(engine.nowPlayingRenderCount == 1)
1042
+ #expect(engine.resolveAndLoadCalls.count == 1)
1043
+ }
1044
+
1045
+ @Test func theNetworkReturningReRendersBeforeReconnecting() async throws {
1046
+ let (player, engine, _) = try makePlaying()
1047
+ player.transition(.avPlayerWaiting)
1048
+ player.networkStatusDidChange(isOnline: false)
1049
+ var order: [String] = []
1050
+ engine.onSeamCall = { order.append($0) }
1051
+ let loadsBefore = engine.resolveAndLoadCalls.count
1052
+
1053
+ player.networkStatusDidChange(isOnline: true)
1054
+ await player.retry.pendingTask?.value
1055
+
1056
+ #expect(order.first == "renderNowPlaying")
1057
+ #expect(engine.resolveAndLoadCalls.count == loadsBefore + 1)
1058
+ }
1059
+
1060
+ @Test func aRestartFromAnErrorBeginsANewLoad() async throws {
1061
+ let (player, engine, _) = try makePlaying()
1062
+ engine.emit(.audioDidStart)
1063
+ let first = player.load
1064
+ #expect(player.retry.hasPlayed)
1065
+
1066
+ engine.emit(.unplayable)
1067
+ #expect(player.state == .error)
1068
+ player.play()
1069
+
1070
+ #expect(player.load?.id != first?.id)
1071
+ #expect(!player.retry.hasPlayed)
1072
+ #expect(player.load?.primedNowPlaying == false)
1073
+ #expect(engine.recreateCount == 1)
1074
+ }
1075
+
1076
+ @Test func aRetryKeepsItsLoad() async throws {
1077
+ let (player, engine, _) = try makePlaying()
1078
+ let first = player.load
1079
+ engine.emit(.failed(URLError(.timedOut), httpStatusCode: nil))
1080
+ await player.retry.pendingTask?.value
1081
+ #expect(player.load?.id == first?.id)
1082
+ #expect(engine.recreateCount == 0)
1083
+ }
1084
+
1085
+ @Test func aRetryAfterTheAVPlayerItselfFailedReloadsOnANewOne_inTheSameLoad() async throws {
1086
+ let (player, engine, _) = try makePlaying()
1087
+ engine.emit(.audioDidStart)
1088
+ let first = player.load
1089
+ engine.playerFailed = true
1090
+
1091
+ engine.emit(.failed(URLError(.networkConnectionLost), httpStatusCode: nil))
1092
+ await player.retry.pendingTask?.value
1093
+
1094
+ #expect(engine.recreateCount == 1)
1095
+ #expect(engine.resolveAndLoadCalls.count == 2)
1096
+ #expect(player.load?.id == first?.id)
1097
+ #expect(player.retry.hasPlayed)
1098
+ }
1099
+
1100
+ @Test func aMediaServicesResetDuringABackoffReloadsOnce() async throws {
1101
+ let engine = MockPlayerEngine()
1102
+ let player = makePlayer(engine: engine, retry: makeRetryLoop(delay: 0.05))
1103
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], playWhenReady: true)
1104
+ engine.hasItem = true
1105
+ engine.emit(.failed(URLError(.timedOut), httpStatusCode: nil))
1106
+ let retrying = player.retry.pendingTask
1107
+
1108
+ player.mediaServicesWereReset()
1109
+ await retrying?.value
1110
+
1111
+ #expect(engine.resolveAndLoadCalls.count == 2)
1112
+ #expect(player.retry.pendingTask == nil)
1113
+ }
1114
+
1115
+ @Test func aMediaServicesResetReloadsOnANewPlayer() throws {
1116
+ let (player, engine, _) = try makePlaying()
1117
+ player.mediaServicesWereReset()
1118
+ #expect(engine.recreateCount == 1)
1119
+ #expect(engine.resolveAndLoadCalls.count == 2)
1120
+ #expect(player.playWhenReady)
1121
+ }
1122
+
1123
+ @Test func aMediaServicesResetResumesAnOnDemandTrack_notALiveOne() throws {
1124
+ let (player, engine, _) = try makePlaying()
1125
+ engine.resumePosition = 120
1126
+ player.mediaServicesWereReset()
1127
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
1128
+ #expect(engine.seekCalls == [120])
1129
+
1130
+ let (live, liveEngine, _) = try makePlaying(live: true)
1131
+ liveEngine.resumePosition = 120
1132
+ live.mediaServicesWereReset()
1133
+ liveEngine.emit(.itemPrepared(likelyToKeepUp: true))
1134
+ #expect(liveEngine.seekCalls.isEmpty)
1135
+ }
1136
+
1137
+ @Test func aMediaServicesResetAfterTheEndOrAStopStartsOver() throws {
1138
+ let (ended, endedEngine, _) = try makePlaying()
1139
+ endedEngine.resumePosition = 300
1140
+ ended.transition(.trackEndedNaturally)
1141
+ ended.mediaServicesWereReset()
1142
+ #expect(ended.deferredSeek.target == nil)
1143
+
1144
+ let (stopped, stoppedEngine, _) = try makePlaying()
1145
+ stopped.stop()
1146
+ // The stop's rewind has not landed.
1147
+ stoppedEngine.resumePosition = 120
1148
+ stopped.mediaServicesWereReset()
1149
+ #expect(stopped.deferredSeek.target == nil)
1150
+ }
1151
+
1152
+ @Test func aReloadAfterTheEndStartsOver() throws {
1153
+ let (player, engine, _) = try makePlaying()
1154
+ engine.currentTime = 300
1155
+ engine.duration = 300
1156
+ engine.resumePosition = 300
1157
+ engine.emit(.playedToEnd)
1158
+ #expect(player.state == .ended)
1159
+
1160
+ player.reloadResolving(startFromCurrentTime: true)
1161
+ #expect(player.deferredSeek.target == nil)
1162
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
1163
+ #expect(engine.seekCalls.isEmpty)
1164
+ }
1165
+
1166
+ @Test func aReloadAfterAStopStartsOver() throws {
1167
+ let (player, engine, _) = try makePlaying()
1168
+ engine.seekResult = nil
1169
+ player.stop()
1170
+ // The stop's rewind has not landed.
1171
+ engine.resumePosition = 120
1172
+ player.reloadResolving(startFromCurrentTime: true)
1173
+ #expect(player.deferredSeek.target == nil)
1174
+ }
1175
+
1176
+ @Test func aStopRewindsAFiniteTrack_notALiveOne() throws {
1177
+ let (player, engine, _) = try makePlaying()
1178
+ player.stop()
1179
+ #expect(engine.seekCalls == [0])
1180
+
1181
+ let (live, liveEngine, _) = try makePlaying(live: true)
1182
+ live.stop()
1183
+ #expect(liveEngine.seekCalls.isEmpty)
1184
+ }
1185
+
1186
+ @Test func aNonPositiveRateIsRefused() throws {
1187
+ let (player, engine, _) = try makePlaying()
1188
+ player.rate = 1.5
1189
+ player.rate = 0
1190
+ #expect(player.rate == 1.5)
1191
+ #expect(engine.rates.map(\.rate) == [1.5])
1192
+ #expect(engine.rates.last?.playing == true)
1193
+ }
1194
+
1195
+ @Test func isStalledNeedsProgressIntentAndAThinBuffer() throws {
1196
+ let (player, engine, _) = try makePlaying()
1197
+ engine.currentTime = 10
1198
+ engine.isPlaybackLikelyToKeepUp = false
1199
+ #expect(player.isStalled)
1200
+ // Within Player.stallGraceSeconds.
1201
+ engine.currentTime = 0.2
1202
+ #expect(!player.isStalled)
1203
+ }
1204
+ }
1205
+
1206
+ // Serialized: every test shares makePlayer's "PlayerTests" defaults suite.
1207
+ @Suite("Player - review regressions", .serialized)
1208
+ @MainActor
1209
+ struct PlayerReviewRegressionTests {
1210
+ @Test func aRestartFromAnErrorDuringTheStartSeekKeepsTheStart() throws {
1211
+ UserDefaults(suiteName: "PlayerTests")!.removePersistentDomain(forName: "PlayerTests")
1212
+ let engine = MockPlayerEngine()
1213
+ let player = makePlayer(engine: engine)
1214
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], startPositionMs: 25000)
1215
+ engine.seekResult = nil
1216
+ engine.hasItem = true
1217
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
1218
+ // The failed item's own time.
1219
+ engine.resumePosition = 0
1220
+ engine.emit(.unplayable)
1221
+ #expect(player.state == .error)
1222
+ let saved = PlaybackPersistence(defaults: UserDefaults(suiteName: "PlayerTests")!) { nil }.load()
1223
+ #expect(saved?.positionMs == 25000)
1224
+
1225
+ player.play()
1226
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
1227
+
1228
+ #expect(engine.seekCalls == [25, 25])
1229
+ }
1230
+
1231
+ @Test func aSeekInAnErrorDuringTheStartSeekReplacesTheStart() throws {
1232
+ let engine = MockPlayerEngine()
1233
+ let player = makePlayer(engine: engine)
1234
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], startPositionMs: 25000)
1235
+ engine.seekResult = nil
1236
+ engine.hasItem = true
1237
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
1238
+ engine.emit(.failed(nil, httpStatusCode: 404))
1239
+ #expect(player.state == .error)
1240
+
1241
+ player.seek(to: 40)
1242
+ player.seek(by: 5)
1243
+ engine.completeSeeks(false)
1244
+ player.play()
1245
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
1246
+
1247
+ #expect(engine.seekCalls == [25, 45])
1248
+ }
1249
+
1250
+ @Test func aSeekInAnErrorIsWhereThePlayResumes() throws {
1251
+ let (player, engine, _) = try makePlaying()
1252
+ engine.resumePosition = 120
1253
+ engine.emit(.failed(nil, httpStatusCode: 404))
1254
+ #expect(player.state == .error)
1255
+
1256
+ player.seek(by: -80)
1257
+ player.play()
1258
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
1259
+
1260
+ #expect(engine.seekCalls == [40])
1261
+ }
1262
+
1263
+ @Test func endingWithTheIntentAlreadyOffSavesPositionZero() throws {
1264
+ UserDefaults(suiteName: "PlayerTests")!.removePersistentDomain(forName: "PlayerTests")
1265
+ let (player, engine, _) = try makePlaying()
1266
+ engine.currentTime = 300
1267
+ engine.duration = 300
1268
+ player.pause()
1269
+ // An end-of-track sleep timer drops the intent while still .playing; without the save on
1270
+ // entering .ended, a cold resume seeks to the end and re-ends.
1271
+ player.transition(.trackEndedNaturally)
1272
+ let saved = PlaybackPersistence(defaults: UserDefaults(suiteName: "PlayerTests")!) { nil }.load()
1273
+ #expect(saved?.positionMs == 0)
1274
+ }
1275
+
1276
+ @Test func skippingWhilePausedSavesTheNewTrackAtItsStart() throws {
1277
+ UserDefaults(suiteName: "PlayerTests")!.removePersistentDomain(forName: "PlayerTests")
1278
+ let (player, engine, _) = try makePlaying()
1279
+ try player.add([Track(id: "t2", src: "https://example.com/b.mp3", title: "B")])
1280
+ player.pause()
1281
+ // The engine still reports the old item's position until the new item is prepared.
1282
+ engine.currentTime = 1800
1283
+ player.next()
1284
+ let saved = PlaybackPersistence(defaults: UserDefaults(suiteName: "PlayerTests")!) { nil }.load()
1285
+ #expect(saved?.track.id == "t2")
1286
+ #expect(saved?.positionMs == 0)
1287
+ }
1288
+
1289
+ @Test func aRetryWhilePausedSavesWhereItWas() throws {
1290
+ UserDefaults(suiteName: "PlayerTests")!.removePersistentDomain(forName: "PlayerTests")
1291
+ let (player, engine, _) = try makePlaying()
1292
+ player.pause()
1293
+ engine.currentTime = 120
1294
+ engine.resumePosition = 120
1295
+ // The reload holds its resume position before the loading transition saves the snapshot.
1296
+ player.reloadResolving(startFromCurrentTime: true)
1297
+ let saved = PlaybackPersistence(defaults: UserDefaults(suiteName: "PlayerTests")!) { nil }.load()
1298
+ #expect(saved?.positionMs == 120_000)
1299
+ #expect(player.deferredSeek.target == 120)
1300
+ }
1301
+
1302
+ @Test func aFailedSkipKeepsTheNewTrackAtItsStart() throws {
1303
+ UserDefaults(suiteName: "PlayerTests")!.removePersistentDomain(forName: "PlayerTests")
1304
+ let (player, engine, _) = try makePlaying()
1305
+ try player.add([Track(id: "t2", src: "https://example.com/b.mp3", title: "B")])
1306
+ engine.currentTime = 1800
1307
+ engine.resumePosition = 1800
1308
+ player.next()
1309
+ // The failed load leaves the previous item, and its position, in the engine.
1310
+ engine.emit(.unplayable)
1311
+ #expect(player.state == .error)
1312
+ let saved = PlaybackPersistence(defaults: UserDefaults(suiteName: "PlayerTests")!) { nil }.load()
1313
+ #expect(saved?.track.id == "t2")
1314
+ #expect(saved?.positionMs == 0)
1315
+
1316
+ player.play()
1317
+ #expect(player.state == .loading)
1318
+ #expect(player.deferredSeek.target == nil)
1319
+ }
1320
+
1321
+ @Test func aStartPositionIsSavedWithTheTrackChange() throws {
1322
+ UserDefaults(suiteName: "PlayerTests")!.removePersistentDomain(forName: "PlayerTests")
1323
+ let player = makePlayer()
1324
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "A")], startPositionMs: 30000)
1325
+ let saved = PlaybackPersistence(defaults: UserDefaults(suiteName: "PlayerTests")!) { nil }.load()
1326
+ #expect(saved?.positionMs == 30000)
1327
+ #expect(player.deferredSeek.target == 30)
1328
+ }
1329
+
1330
+ @Test func playOnATrackWithoutASourceFailsInsteadOfReloading() throws {
1331
+ let (player, engine, _) = try makePlaying()
1332
+ try player.setQueue([Track(id: "t2", path: "/no-source", src: nil, title: "No source")])
1333
+ #expect(player.state == .error)
1334
+ let resolves = engine.resolveAndLoadCalls.count
1335
+
1336
+ // The media loader's last URL belongs to the earlier track: play must not reload it.
1337
+ player.play()
1338
+
1339
+ #expect(player.state == .error)
1340
+ #expect(player.nitroPlaybackError?.code == TrackPlayerError.PlaybackError.invalidSourceUrl("nil").code)
1341
+ #expect(engine.resolveAndLoadCalls.count == resolves)
1342
+ }
1343
+
1344
+ @Test func anErrorWhilePausedSavesWhereItStopped() throws {
1345
+ UserDefaults(suiteName: "PlayerTests")!.removePersistentDomain(forName: "PlayerTests")
1346
+ let (player, engine, _) = try makePlaying()
1347
+ player.pause()
1348
+ engine.currentTime = 42
1349
+ // Nothing plays, so no periodic save runs: the transition alone rewrites the snapshot.
1350
+ engine.emit(.failed(nil, httpStatusCode: nil))
1351
+ #expect(player.state == .error)
1352
+ let saved = PlaybackPersistence(defaults: UserDefaults(suiteName: "PlayerTests")!) { nil }.load()
1353
+ #expect(saved?.positionMs == 42000)
1354
+ }
1355
+
1356
+ @Test func playingSavesPeriodically() async throws {
1357
+ UserDefaults(suiteName: "PlayerTests")!.removePersistentDomain(forName: "PlayerTests")
1358
+ let engine = MockPlayerEngine()
1359
+ let player = makePlayer(engine: engine, saveInterval: .milliseconds(10))
1360
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T")], playWhenReady: true)
1361
+ engine.hasItem = true
1362
+ engine.hasLoadedAsset = true
1363
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
1364
+ player.transition(.avPlayerPlaying)
1365
+ engine.currentTime = 7
1366
+ let persistence = PlaybackPersistence(defaults: UserDefaults(suiteName: "PlayerTests")!) { nil }
1367
+ for _ in 0 ..< 100 where persistence.load()?.positionMs != 7000 {
1368
+ try await Task.sleep(for: .milliseconds(10))
1369
+ }
1370
+ #expect(persistence.load()?.positionMs == 7000)
1371
+ player.pause()
1372
+ }
1373
+
1374
+ @Test func aPersistedSessionResumesWhereItWasSaved() throws {
1375
+ let defaults = UserDefaults(suiteName: "PlayerTests")!
1376
+ defaults.removePersistentDomain(forName: "PlayerTests")
1377
+ let saved = PersistedPlaybackState(
1378
+ track: JsonTrack(from: Track(id: "t1", src: "https://example.com/a.mp3", title: "A")),
1379
+ positionMs: 30000, repeatMode: "queue", shuffleEnabled: false, playbackSpeed: 1.5,
1380
+ )
1381
+ PlaybackPersistence(defaults: defaults) { saved }.save()
1382
+
1383
+ let player = makePlayer()
1384
+ let session = try #require(player.persistedSession())
1385
+ player.resume(session, queue: nil)
1386
+ #expect(player.currentTrack?.id == "t1")
1387
+ #expect(player.deferredSeek.target == 30)
1388
+ #expect(player.repeatMode == .queue)
1389
+ #expect(player.rate == 1.5)
1390
+ #expect(player.playWhenReady)
1391
+ }
1392
+
1393
+ @Test func aDisabledPersistedTrackIsNotResumed() {
1394
+ let defaults = UserDefaults(suiteName: "PlayerTests")!
1395
+ defaults.removePersistentDomain(forName: "PlayerTests")
1396
+ let saved = PersistedPlaybackState(
1397
+ track: JsonTrack(from: Track(id: "t1", src: "https://example.com/a.mp3", title: "A", disabled: true)),
1398
+ positionMs: nil, repeatMode: "off", shuffleEnabled: false, playbackSpeed: 1,
1399
+ )
1400
+ PlaybackPersistence(defaults: defaults) { saved }.save()
1401
+ #expect(makePlayer().persistedSession() == nil)
1402
+ }
1403
+
1404
+ @Test func aTrackChangeClearsTheRetryingErrorOfTheTrackItLeaves() async throws {
1405
+ let (player, engine, callbacks) = try makeLoading()
1406
+ player.setPlayWhenReady(true)
1407
+ engine.emit(.loadFailed(URLError(.timedOut)))
1408
+ #expect(callbacks.playbackChanges.last?.error != nil)
1409
+
1410
+ try player.setQueue([Track(id: "t2", src: "https://example.com/b.mp3", title: "B")])
1411
+
1412
+ #expect(callbacks.playbackChanges.last?.state == .loading)
1413
+ #expect(callbacks.playbackChanges.last?.error == nil)
1414
+ player.retry.cancel()
1415
+ }
1416
+
1417
+ @Test func skippingAwayFromAnErrorNeverPublishesAnErrorlessError() throws {
1418
+ let (player, engine, callbacks) = try makeLoading()
1419
+ engine.emit(.unplayable)
1420
+ callbacks.playbackChanges.removeAll()
1421
+ callbacks.errorEvents.removeAll()
1422
+ try player.setQueue([Track(id: "t2", src: "https://example.com/b.mp3", title: "B")])
1423
+ #expect(!callbacks.playbackChanges.contains { $0.state == .error })
1424
+ #expect(callbacks.errorEvents.count == 1)
1425
+ }
1426
+ }
1427
+
1428
+ @Suite("Player - pausing a live stream")
1429
+ @MainActor
1430
+ struct PlayerLivePauseTests {
1431
+ @Test func aLivePauseClosesTheConnection() throws {
1432
+ let (player, engine, _) = try makePlaying(live: true)
1433
+ let carriers = engine.carrierCount
1434
+ player.pause()
1435
+ #expect(engine.carrierCount == carriers + 1)
1436
+ #expect(player.state == .paused)
1437
+ #expect(player.load?.reloadOnPlay == true)
1438
+ }
1439
+
1440
+ /// A skip back from the lock screen while paused, then a play.
1441
+ @Test func aPlayAfterALivePauseReconnectsAtTheLiveEdge() throws {
1442
+ let (player, engine, _) = try makePlaying(live: true)
1443
+ player.pause()
1444
+ engine.resumePosition = 120
1445
+ player.seek(by: -15)
1446
+ player.play()
1447
+ #expect(engine.resolveAndLoadCalls.count == 2)
1448
+ #expect(player.state == .loading)
1449
+
1450
+ engine.hasItem = true
1451
+ engine.hasLoadedAsset = true
1452
+ engine.emit(.itemPrepared(likelyToKeepUp: true))
1453
+ #expect(engine.seekCalls.isEmpty)
1454
+ }
1455
+
1456
+ /// A live HLS stream with a DVR window, playing 2 minutes behind its edge.
1457
+ @MainActor private func makePlayingSeekableLive(window: Double = 600) throws -> (Player, MockPlayerEngine) {
1458
+ let (player, engine, _) = try makePlaying(live: true)
1459
+ engine.liveWindowSeconds = window
1460
+ engine.liveEdge = 1000
1461
+ engine.currentTime = 880
1462
+ engine.resumePosition = 880
1463
+ return (player, engine)
1464
+ }
1465
+
1466
+ @Test func aSeekableLivePauseKeepsItsPositionAndResumesFromIt() throws {
1467
+ let (player, engine) = try makePlayingSeekableLive()
1468
+ let plays = engine.startPlaybackCallCount
1469
+ player.pause()
1470
+ engine.emit(.timeControlStatus(.paused, waitingForNoItem: false))
1471
+ #expect(engine.carrierCount == 0)
1472
+ #expect(player.state == .paused)
1473
+ #expect(player.load?.reloadOnPlay == false)
1474
+ #expect(engine.currentTime == 880)
1475
+
1476
+ player.play()
1477
+ #expect(engine.resolveAndLoadCalls.count == 1)
1478
+ #expect(engine.startPlaybackCallCount == plays + 1)
1479
+ #expect(engine.seekCalls.isEmpty)
1480
+ }
1481
+
1482
+ @Test func aJumpToTheLiveEdgeWhileASeekableLiveTrackIsPausedSeeksToTheWindowEnd() throws {
1483
+ let (player, engine) = try makePlayingSeekableLive()
1484
+ player.pause()
1485
+ player.seekToLiveEdge()
1486
+ #expect(engine.seekCalls == [1000])
1487
+ #expect(engine.resolveAndLoadCalls.count == 1)
1488
+ }
1489
+
1490
+ @Test func aPausedSeekableLiveItemCapsItsBufferUntilPlay() throws {
1491
+ let (player, engine) = try makePlayingSeekableLive()
1492
+ engine.forwardBufferCaps.removeAll()
1493
+ player.pause()
1494
+ #expect(engine.forwardBufferCaps == [Player.pausedLiveBufferSeconds])
1495
+ player.play()
1496
+ #expect(engine.forwardBufferCaps == [Player.pausedLiveBufferSeconds, nil])
1497
+ }
1498
+
1499
+ @Test func aStoppedSeekableLiveItemCapsItsBuffer() throws {
1500
+ let (player, engine) = try makePlayingSeekableLive()
1501
+ engine.forwardBufferCaps.removeAll()
1502
+ player.stop()
1503
+ #expect(engine.forwardBufferCaps == [Player.pausedLiveBufferSeconds])
1504
+ }
1505
+
1506
+ @Test func aPausedOnDemandItemKeepsItsBuffer() throws {
1507
+ let (player, engine, _) = try makePlaying()
1508
+ engine.forwardBufferCaps.removeAll()
1509
+ player.pause()
1510
+ #expect(!engine.forwardBufferCaps.contains { $0 != nil })
1511
+ }
1512
+
1513
+ @Test func aSeekableLiveStopKeepsItsItem() throws {
1514
+ let (player, engine) = try makePlayingSeekableLive()
1515
+ player.stop()
1516
+ #expect(engine.carrierCount == 0)
1517
+ #expect(player.state == .stopped)
1518
+ player.seekToLiveEdge()
1519
+ #expect(engine.seekCalls == [1000])
1520
+ }
1521
+
1522
+ @Test func aLiveWindowShorterThanAPauseIsWorthClosesLikeAStreamWithNone() throws {
1523
+ let (player, engine) = try makePlayingSeekableLive(window: Player.pausableLiveWindowSeconds - 1)
1524
+ player.pause()
1525
+ #expect(engine.carrierCount == 1)
1526
+ #expect(player.load?.reloadOnPlay == true)
1527
+ }
1528
+
1529
+ @Test func anOnDemandPauseKeepsTheItem() throws {
1530
+ let (player, engine, _) = try makePlaying()
1531
+ player.pause()
1532
+ engine.emit(.timeControlStatus(.paused, waitingForNoItem: false))
1533
+ #expect(engine.carrierCount == 0)
1534
+ #expect(player.state == .paused)
1535
+ #expect(player.load?.reloadOnPlay == false)
1536
+ }
1537
+
1538
+ @Test func aLiveStopClosesTheConnectionWithoutPassingThroughPaused() throws {
1539
+ let (player, engine, callbacks) = try makePlaying(live: true)
1540
+ let carriers = engine.carrierCount
1541
+ callbacks.playbackChanges.removeAll()
1542
+ player.stop()
1543
+ #expect(engine.carrierCount == carriers + 1)
1544
+ #expect(callbacks.playbackChanges.map(\.state) == [.stopped])
1545
+ player.play()
1546
+ #expect(engine.resolveAndLoadCalls.count == 2)
1547
+ }
1548
+
1549
+ @Test func aLiveStreamLoadedWithoutIntentOpensNoConnection() throws {
1550
+ let scheduler = ManualSleepTimerScheduler()
1551
+ let (player, engine, _) = try makeLoading(live: true, scheduler: scheduler)
1552
+ #expect(engine.resolveAndLoadCalls.isEmpty)
1553
+ #expect(engine.carrierCount == 0)
1554
+ #expect(player.state == .loading)
1555
+
1556
+ scheduler.advance(to: Player.idleLiveParkDelaySeconds)
1557
+ #expect(engine.resolveAndLoadCalls.isEmpty)
1558
+ #expect(engine.carrierCount == 1)
1559
+ #expect(player.state == .paused)
1560
+ player.play()
1561
+ #expect(engine.resolveAndLoadCalls.count == 1)
1562
+ }
1563
+
1564
+ /// A station started from paused as two calls, the way a consumer without `playWhenReady` does.
1565
+ @Test func aLiveStreamQueuedThenPlayedFromPausedNeverReportsPaused() throws {
1566
+ let scheduler = ManualSleepTimerScheduler()
1567
+ let (player, engine, callbacks) = try makePlaying(live: true, scheduler: scheduler)
1568
+ player.pause()
1569
+ let carriers = engine.carrierCount
1570
+ callbacks.playbackChanges.removeAll()
1571
+
1572
+ try player.setQueue([Track(id: "t2", src: "https://example.com/b.mp3", title: "B", live: true)])
1573
+ player.play()
1574
+ scheduler.advance(to: Player.idleLiveParkDelaySeconds)
1575
+ #expect(engine.resolveAndLoadCalls.count == 2)
1576
+ #expect(engine.carrierCount == carriers)
1577
+ #expect(!callbacks.playbackChanges.contains { $0.state == .paused })
1578
+ #expect(player.state == .loading)
1579
+ }
1580
+
1581
+ @Test func aPlayArriving100msAfterTheQueueNeverReportsPaused() async throws {
1582
+ let (player, engine, callbacks) = try makePlaying(live: true, scheduler: MainQueueSleepTimerScheduler())
1583
+ player.pause()
1584
+ let carriers = engine.carrierCount
1585
+ callbacks.playbackChanges.removeAll()
1586
+
1587
+ try player.setQueue([Track(id: "t2", src: "https://example.com/b.mp3", title: "B", live: true)])
1588
+ try await Task.sleep(for: .milliseconds(100))
1589
+ player.play()
1590
+ try await Task.sleep(for: .seconds(Player.idleLiveParkDelaySeconds + 0.5))
1591
+ #expect(engine.resolveAndLoadCalls.count == 2)
1592
+ #expect(engine.carrierCount == carriers)
1593
+ #expect(!callbacks.playbackChanges.contains { $0.state == .paused })
1594
+ #expect(player.state == .loading)
1595
+ }
1596
+
1597
+ @Test func withNoPlayTheDeferredParkFiresOnTheMainQueue() async throws {
1598
+ let (player, engine, _) = try makeLoading(live: true, scheduler: MainQueueSleepTimerScheduler())
1599
+ try await Task.sleep(for: .seconds(Player.idleLiveParkDelaySeconds + 0.5))
1600
+ #expect(engine.carrierCount == 1)
1601
+ #expect(player.state == .paused)
1602
+ }
1603
+
1604
+ @Test func aStopDuringTheDeferredParkClosesTheItemAndStaysStopped() throws {
1605
+ let scheduler = ManualSleepTimerScheduler()
1606
+ let (player, engine, _) = try makeLoading(live: true, scheduler: scheduler)
1607
+ player.stop()
1608
+ #expect(engine.carrierCount == 1)
1609
+ scheduler.advance(to: Player.idleLiveParkDelaySeconds)
1610
+ #expect(player.state == .stopped)
1611
+ #expect(engine.carrierCount == 1)
1612
+ }
1613
+
1614
+ @Test func aPauseDuringTheDeferredParkStillParksAtTheDeadline() throws {
1615
+ let scheduler = ManualSleepTimerScheduler()
1616
+ let (player, engine, _) = try makeLoading(live: true, scheduler: scheduler)
1617
+ player.pause()
1618
+ #expect(player.state == .loading)
1619
+ scheduler.advance(to: Player.idleLiveParkDelaySeconds)
1620
+ #expect(player.state == .paused)
1621
+ #expect(engine.resolveAndLoadCalls.isEmpty)
1622
+ }
1623
+
1624
+ @Test func aPlayPauseAndPlayInsideTheDelayIsNotParkedByIt() throws {
1625
+ let scheduler = ManualSleepTimerScheduler()
1626
+ let (player, engine, _) = try makeLoading(live: true, scheduler: scheduler)
1627
+ player.play()
1628
+ player.pause()
1629
+ player.play()
1630
+ let carriers = engine.carrierCount
1631
+ scheduler.advance(to: Player.idleLiveParkDelaySeconds)
1632
+ #expect(engine.carrierCount == carriers)
1633
+ #expect(player.state == .loading)
1634
+ #expect(engine.resolveAndLoadCalls.count == 2)
1635
+ }
1636
+
1637
+ @Test func aLiveStreamQueuedToPlayConnectsWithoutParking() throws {
1638
+ let engine = MockPlayerEngine()
1639
+ let player = makePlayer(engine: engine)
1640
+ let callbacks = MockPlayerCallbacks()
1641
+ player.callbacks = callbacks
1642
+ try player.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "T", live: true)], playWhenReady: true)
1643
+ #expect(engine.carrierCount == 0)
1644
+ #expect(engine.resolveAndLoadCalls.count == 1)
1645
+ #expect(!callbacks.playbackChanges.contains { $0.state == .paused })
1646
+ }
1647
+
1648
+ @Test func skippingToALiveStreamWhilePausedDoesNotConnect() throws {
1649
+ let scheduler = ManualSleepTimerScheduler()
1650
+ let (player, engine, _) = try makePlaying(scheduler: scheduler)
1651
+ try player.add([Track(id: "t2", src: "https://example.com/b.mp3", title: "B", live: true)])
1652
+ player.pause()
1653
+ player.next()
1654
+ scheduler.advance(to: Player.idleLiveParkDelaySeconds)
1655
+ #expect(engine.resolveAndLoadCalls.count == 1)
1656
+ #expect(player.state == .paused)
1657
+ }
1658
+
1659
+ @Test func aMediaServicesResetWhileParkedDoesNotConnect() throws {
1660
+ let scheduler = ManualSleepTimerScheduler()
1661
+ let (player, engine, _) = try makePlaying(live: true, scheduler: scheduler)
1662
+ player.pause()
1663
+ player.mediaServicesWereReset()
1664
+ scheduler.advance(to: Player.idleLiveParkDelaySeconds)
1665
+ #expect(engine.resolveAndLoadCalls.count == 1)
1666
+ #expect(player.state == .paused)
1667
+ }
1668
+
1669
+ /// The carrier item has no asset: the AVPlayer reports a pause without one.
1670
+ @Test func thePausedStatusOfTheEmptiedPlayerKeepsItPaused() throws {
1671
+ let (player, engine, _) = try makePlaying(live: true)
1672
+ player.pause()
1673
+ engine.emit(.timeControlStatus(.paused, waitingForNoItem: false))
1674
+ #expect(player.state == .paused)
1675
+ }
1676
+
1677
+ /// The dropped item's first audio, reported after the pause that dropped it.
1678
+ @Test func audioReportedAfterTheDropKeepsItPaused() throws {
1679
+ let (player, engine, _) = try makePlaying(live: true)
1680
+ player.pause()
1681
+ engine.emit(.audioDidStart)
1682
+ #expect(player.state == .paused)
1683
+ }
1684
+
1685
+ @Test func aLivePauseDuringAConnectClosesIt() async throws {
1686
+ let (player, engine, clock) = try makeConnecting()
1687
+ await clock.run(until: 10_000)
1688
+ player.pause()
1689
+ await clock.run(until: 200_000)
1690
+ #expect(engine.carrierCount == 1)
1691
+ #expect(engine.resolveAndLoadCalls.count == 1)
1692
+ #expect(player.state == .paused)
1693
+ }
1694
+
1695
+ @Test func aLivePauseDuringAStallLeavesNoReconnect() async throws {
1696
+ let (player, engine, _, clock) = try makeVirtual()
1697
+ player.transition(.avPlayerPlaying)
1698
+ await clock.run(until: 10_000)
1699
+ player.transition(.avPlayerWaiting)
1700
+ #expect(player.retry.stallTask != nil)
1701
+
1702
+ player.pause()
1703
+ #expect(player.retry.stallTask == nil)
1704
+ #expect(player.retry.pendingTask == nil)
1705
+ await clock.run(until: 600_000)
1706
+ #expect(engine.resolveAndLoadCalls.count == 1)
1707
+ #expect(player.state == .paused)
1708
+ }
1709
+
1710
+ @Test func aLivePauseAfterTheRetryGaveUpClosesTheConnection() throws {
1711
+ let (player, engine, _) = try makePlaying(live: true)
1712
+ player.transition(.errorOccurred(.playbackStalled))
1713
+ let carriers = engine.carrierCount
1714
+ player.pause()
1715
+ #expect(engine.carrierCount == carriers + 1)
1716
+ #expect(player.state == .error)
1717
+ player.play()
1718
+ #expect(engine.resolveAndLoadCalls.count == 2)
1719
+ }
1720
+
1721
+ @Test func aJumpToTheLiveEdgeAfterAStopStaysStopped() throws {
1722
+ let (player, engine, _) = try makePlaying(live: true)
1723
+ player.stop()
1724
+ player.seekToLiveEdge()
1725
+ player.retryNow()
1726
+ #expect(player.state == .stopped)
1727
+ #expect(engine.resolveAndLoadCalls.count == 1)
1728
+ }
1729
+
1730
+ /// Paused longer than any silence the loop tolerates: the reconnect gets a whole budget.
1731
+ @Test func aPlayAfterAPauseLongerThanTheBudgetReconnectsWithoutError() async throws {
1732
+ let (player, engine, callbacks, clock) = try makeVirtual()
1733
+ player.transition(.avPlayerPlaying)
1734
+ await clock.run(until: 10_000)
1735
+ player.pause()
1736
+ await clock.run(until: 610_000)
1737
+ player.play()
1738
+ await clock.run(until: 615_000)
1739
+ #expect(engine.resolveAndLoadCalls.count == 2)
1740
+ #expect(player.state == .loading)
1741
+ #expect(callbacks.errorEvents.isEmpty)
1742
+ }
1743
+ }
1744
+
1745
+ /// A stopped or ended track plays again only through a reload: an AVPlayer event that lands after
1746
+ /// the stop or the end must not move it out of that state, or the next play resumes the item left
1747
+ /// behind.
1748
+ @Suite("A late AVPlayer event does not cost the next play its reload")
1749
+ @MainActor
1750
+ struct LateEngineEventTests {
1751
+ enum LateAfterStop: String, CaseIterable, Sendable {
1752
+ case liveLatePlayingThenPaused = "live, a late playing then paused status"
1753
+ case liveLateFirstAudio = "live, a late first audio"
1754
+ case onDemandLateWaitingAfterTheRewind = "on-demand, a late waiting status after the rewind"
1755
+ case onDemandLatePlaying = "on-demand, a late playing status"
1756
+
1757
+ var live: Bool {
1758
+ switch self {
1759
+ case .liveLatePlayingThenPaused, .liveLateFirstAudio: true
1760
+ case .onDemandLateWaitingAfterTheRewind, .onDemandLatePlaying: false
1761
+ }
1762
+ }
1763
+
1764
+ var events: [EngineEvent] {
1765
+ switch self {
1766
+ case .liveLatePlayingThenPaused:
1767
+ [.timeControlStatus(.playing, waitingForNoItem: false), .timeControlStatus(.paused, waitingForNoItem: false)]
1768
+ case .liveLateFirstAudio: [.audioDidStart]
1769
+ case .onDemandLateWaitingAfterTheRewind: [.timeControlStatus(.waitingToPlayAtSpecifiedRate, waitingForNoItem: false)]
1770
+ case .onDemandLatePlaying: [.timeControlStatus(.playing, waitingForNoItem: false)]
1771
+ }
1772
+ }
1773
+ }
1774
+
1775
+ @Test(arguments: LateAfterStop.allCases)
1776
+ func aStoppedTrackReloadsOnPlay(_ late: LateAfterStop) throws {
1777
+ let (player, engine, _) = try makePlaying(live: late.live)
1778
+ player.stop()
1779
+ for event in late.events {
1780
+ engine.emit(event)
1781
+ }
1782
+ #expect(player.state == .stopped)
1783
+ engine.resolveAndLoadCalls.removeAll()
1784
+ player.play()
1785
+ #expect(engine.resolveAndLoadCalls.count == 1)
1786
+ }
1787
+
1788
+ @Test func anEndedTrackReloadsOnPlayAfterALateWaitingStatus() throws {
1789
+ let (player, engine, _) = try makePlaying()
1790
+ engine.currentTime = 300
1791
+ engine.duration = 300
1792
+ engine.emit(.playedToEnd)
1793
+ engine.emit(.timeControlStatus(.waitingToPlayAtSpecifiedRate, waitingForNoItem: false))
1794
+ #expect(player.state == .ended)
1795
+ engine.resolveAndLoadCalls.removeAll()
1796
+ player.play()
1797
+ #expect(engine.resolveAndLoadCalls.count == 1)
1798
+ }
1799
+
1800
+ @Test func aSecondStopThenPlayReloads() throws {
1801
+ let (player, engine, _) = try makePlaying(live: true)
1802
+ player.stop()
1803
+ player.stop()
1804
+ engine.resolveAndLoadCalls.removeAll()
1805
+ player.play()
1806
+ #expect(engine.resolveAndLoadCalls.count == 1)
1807
+ }
1808
+ }