react-native-audio-browser 0.2.0-next.9 → 0.2.0-next.90

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