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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1247) hide show
  1. package/AudioBrowser.podspec +1 -1
  2. package/README.md +68 -39
  3. package/android/build.gradle +53 -14
  4. package/android/gradle.properties +3 -3
  5. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  6. package/android/src/main/AndroidManifest.xml +14 -1
  7. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +588 -441
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  9. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  10. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  11. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  12. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  13. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  14. package/android/src/main/java/com/audiobrowser/Service.kt +84 -104
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  16. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  17. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +358 -541
  19. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +36 -66
  20. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  21. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  22. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  23. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  24. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -28
  25. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  26. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  27. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +10 -18
  28. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  29. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  30. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  31. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  32. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  33. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  34. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +28 -42
  35. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  36. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  37. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  38. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  39. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  40. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  41. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  42. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  43. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  44. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  45. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +93 -52
  46. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  47. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  48. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +50 -33
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  50. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  51. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +110 -116
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +62 -38
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +121 -132
  55. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  56. package/android/src/main/java/com/audiobrowser/player/Player.kt +490 -581
  57. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  58. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -23
  59. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +107 -129
  60. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +97 -0
  61. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +49 -128
  62. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  63. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  64. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  65. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  66. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  67. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  68. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  70. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  71. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  72. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  73. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +736 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  90. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  91. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  92. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  93. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  94. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  95. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  96. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  97. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  98. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  99. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  100. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  101. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  102. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  103. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  104. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  105. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  106. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  107. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  108. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  109. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  110. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  111. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  112. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  113. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  114. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  115. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  116. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  117. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  118. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  119. package/android/src/main/res/values/strings.xml +25 -5
  120. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  121. package/android/src/test/java/androidx/media3/session/SessionViews.kt +10 -0
  122. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  123. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  124. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  125. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  126. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  127. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  128. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  129. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +322 -0
  130. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  131. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  132. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  133. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  134. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  135. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  136. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  137. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  138. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  139. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  140. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  141. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  142. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  143. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  144. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +43 -0
  145. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  146. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  147. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  148. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  149. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  150. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  151. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  152. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  153. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  154. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  155. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  156. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  157. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +372 -0
  158. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  159. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  160. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  161. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  162. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  163. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  164. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  165. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  166. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  167. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  168. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  169. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  170. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  171. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  172. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +478 -0
  173. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +221 -0
  174. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  176. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +379 -0
  178. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +199 -0
  179. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  180. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +34 -79
  181. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +236 -0
  182. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  183. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +188 -0
  184. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  185. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  186. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  187. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  188. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +308 -0
  189. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  190. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  191. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  192. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1000 -0
  193. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  194. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  195. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  196. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  197. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  198. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  199. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  200. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  201. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  202. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  203. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  204. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  205. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  206. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  207. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  208. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  209. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  210. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  211. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  212. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  213. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  214. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  215. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  216. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  217. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  218. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  219. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  220. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  221. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  222. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  223. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  224. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  225. package/android/src/test/resources/sonos/device_description.xml +78 -0
  226. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  227. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  228. package/ios/AVPlayerEngine.swift +363 -0
  229. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  230. package/ios/Browser/BrowseGate.swift +57 -0
  231. package/ios/Browser/BrowserConfig.swift +123 -104
  232. package/ios/Browser/BrowserError.swift +15 -0
  233. package/ios/Browser/BrowserManager.swift +153 -675
  234. package/ios/Browser/BrowserPathHelper.swift +54 -117
  235. package/ios/Browser/FavoriteSet.swift +43 -0
  236. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  237. package/ios/Browser/JsonModels.swift +244 -335
  238. package/ios/Browser/NavigationErrorState.swift +42 -0
  239. package/ios/Browser/PageResolver.swift +132 -0
  240. package/ios/Browser/RequestLayer.swift +185 -0
  241. package/ios/Browser/RequestPipeline.swift +295 -0
  242. package/ios/Browser/SearchDrillIn.swift +10 -16
  243. package/ios/Browser/SectionScope.swift +73 -26
  244. package/ios/Browser/SimpleRouter.swift +76 -154
  245. package/ios/Browser/StyleResolver.swift +41 -0
  246. package/ios/Browser/TabBarEntries.swift +8 -7
  247. package/ios/Browser/TrackIdTemplate.swift +29 -0
  248. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  249. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  250. package/ios/CarPlay/CarPlayController.swift +37 -1297
  251. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  252. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  253. package/ios/CarPlay/CarPlayNowPlayingManager.swift +130 -205
  254. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  255. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  256. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  257. package/ios/CarPlay/CarPlaySession+TabBar.swift +187 -0
  258. package/ios/CarPlay/CarPlaySession.swift +203 -0
  259. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  260. package/ios/CarPlay/IntentHandlers.swift +94 -0
  261. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  262. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +9 -16
  263. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  264. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  265. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  266. package/ios/CarPlay/SectionPresentation.swift +67 -0
  267. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  268. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  269. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  270. package/ios/Extension/CxxVectorConformances.swift +4 -16
  271. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  272. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  273. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  274. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  275. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  276. package/ios/Extension/SearchParams+Query.swift +28 -0
  277. package/ios/Extension/Section+Copying.swift +26 -0
  278. package/ios/Extension/String+IcyCharset.swift +21 -0
  279. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  280. package/ios/Extension/Track+AVPlayer.swift +1 -18
  281. package/ios/Extension/Track+Copying.swift +13 -21
  282. package/ios/Extension/Track+Identity.swift +20 -0
  283. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  284. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  285. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  286. package/ios/Extension/URLError+Connectivity.swift +15 -0
  287. package/ios/Extension/Variant+Artwork.swift +8 -22
  288. package/ios/Http/HttpClient.swift +73 -167
  289. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  290. package/ios/HybridAudioBrowser+Options.swift +116 -0
  291. package/ios/HybridAudioBrowser+Player.swift +347 -0
  292. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  293. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  294. package/ios/HybridAudioBrowser.swift +148 -1689
  295. package/ios/Model/NitroTypeStubs.swift +240 -32
  296. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  297. package/ios/Model/RemoteCommand.swift +6 -78
  298. package/ios/Model/TrackPlayerError.swift +12 -21
  299. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  300. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  301. package/ios/Observer/ItemObserver.swift +92 -0
  302. package/ios/Observer/PlayerObserver.swift +59 -0
  303. package/ios/Option/SessionCategories.swift +41 -92
  304. package/ios/PlaybackEvent.swift +4 -2
  305. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  306. package/ios/Player/AudioSessionController.swift +190 -0
  307. package/ios/Player/DeferredSeek.swift +73 -0
  308. package/ios/Player/ErrorStatus.swift +52 -0
  309. package/ios/Player/MediaLoader.swift +73 -98
  310. package/ios/Player/NowPlayingLines.swift +49 -0
  311. package/ios/Player/NowPlayingUpdater.swift +180 -105
  312. package/ios/Player/PersistedPlaybackState.swift +1 -2
  313. package/ios/Player/PlaybackFailure.swift +121 -0
  314. package/ios/Player/PlaybackPersistence.swift +72 -0
  315. package/ios/Player/PlaybackStateMachine.swift +11 -11
  316. package/ios/Player/PlaybackTimer.swift +11 -8
  317. package/ios/Player/Player.swift +1010 -0
  318. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  319. package/ios/Player/PlayerEngine.swift +109 -0
  320. package/ios/Player/PlayerStatusTypes.swift +1 -6
  321. package/ios/Player/QueueManager.swift +80 -98
  322. package/ios/Player/ReconnectPacer.swift +83 -0
  323. package/ios/Player/RetryLoop.swift +334 -0
  324. package/ios/Player/ShuffleOrder.swift +36 -43
  325. package/ios/Player/SilenceBudget.swift +78 -0
  326. package/ios/Player/SleepTimerManager.swift +25 -42
  327. package/ios/Player/VolumeFader.swift +20 -15
  328. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  329. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  330. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  331. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  332. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  333. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  334. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  335. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  336. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  337. package/ios/Tests/DeferredSeekTests.swift +76 -0
  338. package/ios/Tests/EmitterTests.swift +22 -39
  339. package/ios/Tests/ErrorStatusTests.swift +50 -0
  340. package/ios/Tests/FavoriteSetTests.swift +61 -0
  341. package/ios/Tests/GenerationMemoTests.swift +178 -0
  342. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  343. package/ios/Tests/JsonModelsTests.swift +189 -3
  344. package/ios/Tests/LRUCacheTests.swift +106 -0
  345. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  346. package/ios/Tests/MediaLoaderTests.swift +38 -78
  347. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  348. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  349. package/ios/Tests/ObserverTests.swift +88 -0
  350. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  351. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  352. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  353. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  354. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  355. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  356. package/ios/Tests/PlayerPolicyTests.swift +991 -0
  357. package/ios/Tests/PlayerTests.swift +1719 -0
  358. package/ios/Tests/PlayingStateTests.swift +41 -0
  359. package/ios/Tests/QueueManagerTests.swift +205 -174
  360. package/ios/Tests/ReadyValueTests.swift +73 -0
  361. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  362. package/ios/Tests/RequestLayerTests.swift +228 -0
  363. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  364. package/ios/Tests/RetryCaseTests.swift +146 -0
  365. package/ios/Tests/RetryLoopTests.swift +307 -0
  366. package/ios/Tests/SearchDrillInTests.swift +16 -17
  367. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  368. package/ios/Tests/SectionPresentationTests.swift +85 -0
  369. package/ios/Tests/SectionScopeTests.swift +136 -54
  370. package/ios/Tests/SimpleRouterTests.swift +39 -8
  371. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  372. package/ios/Tests/StyleResolverTests.swift +123 -0
  373. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  374. package/ios/Tests/Support/TestTypes.swift +152 -100
  375. package/ios/Tests/Support/TimeLimit.swift +43 -0
  376. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  377. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  378. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  379. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  380. package/ios/Tests/TrackIdentityTests.swift +20 -0
  381. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  382. package/ios/Tests/TrackSelectorTests.swift +157 -34
  383. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  384. package/ios/TrackSelector.swift +62 -77
  385. package/ios/Util/ArtworkFreshness.swift +42 -0
  386. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  387. package/ios/Util/AwaitCallback.swift +80 -0
  388. package/ios/Util/ConcurrentMap.swift +19 -0
  389. package/ios/Util/Emitter.swift +45 -22
  390. package/ios/Util/GenerationMemo.swift +43 -0
  391. package/ios/Util/LRUCache.swift +23 -159
  392. package/ios/Util/NetworkMonitor.swift +31 -33
  393. package/ios/Util/OutputPicker.swift +48 -0
  394. package/ios/Util/ReadyValue.swift +57 -0
  395. package/ios/Util/SFSymbolRenderer.swift +64 -49
  396. package/ios/Util/SVGProcessor.swift +9 -16
  397. package/lib/commonjs/AudioBrowser.js +11 -0
  398. package/lib/commonjs/AudioBrowser.js.map +1 -1
  399. package/lib/commonjs/CLAUDE.md +57 -0
  400. package/lib/commonjs/features/battery.js +16 -12
  401. package/lib/commonjs/features/battery.js.map +1 -1
  402. package/lib/commonjs/features/browser-config.js +13 -9
  403. package/lib/commonjs/features/browser-config.js.map +1 -1
  404. package/lib/commonjs/features/browser.js +78 -20
  405. package/lib/commonjs/features/browser.js.map +1 -1
  406. package/lib/commonjs/features/carConnection.js +3 -4
  407. package/lib/commonjs/features/carConnection.js.map +1 -1
  408. package/lib/commonjs/features/equalizer.js +9 -5
  409. package/lib/commonjs/features/equalizer.js.map +1 -1
  410. package/lib/commonjs/features/errors.js +35 -21
  411. package/lib/commonjs/features/errors.js.map +1 -1
  412. package/lib/commonjs/features/favorites.js +28 -23
  413. package/lib/commonjs/features/favorites.js.map +1 -1
  414. package/lib/commonjs/features/gate.js +27 -6
  415. package/lib/commonjs/features/gate.js.map +1 -1
  416. package/lib/commonjs/features/metadata.js +61 -11
  417. package/lib/commonjs/features/metadata.js.map +1 -1
  418. package/lib/commonjs/features/network.js +5 -1
  419. package/lib/commonjs/features/network.js.map +1 -1
  420. package/lib/commonjs/features/nowPlaying.js +28 -14
  421. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  422. package/lib/commonjs/features/output.js +9 -4
  423. package/lib/commonjs/features/output.js.map +1 -1
  424. package/lib/commonjs/features/playback/controls.js +13 -6
  425. package/lib/commonjs/features/playback/controls.js.map +1 -1
  426. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  427. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  428. package/lib/commonjs/features/playback/playing.js +5 -3
  429. package/lib/commonjs/features/playback/playing.js.map +1 -1
  430. package/lib/commonjs/features/playback/progress.js +13 -6
  431. package/lib/commonjs/features/playback/progress.js.map +1 -1
  432. package/lib/commonjs/features/playback/rate.js +8 -1
  433. package/lib/commonjs/features/playback/rate.js.map +1 -1
  434. package/lib/commonjs/features/playback/state.js +5 -6
  435. package/lib/commonjs/features/playback/state.js.map +1 -1
  436. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  437. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  438. package/lib/commonjs/features/playback/volume.js +6 -5
  439. package/lib/commonjs/features/playback/volume.js.map +1 -1
  440. package/lib/commonjs/features/player/options.js +21 -11
  441. package/lib/commonjs/features/player/options.js.map +1 -1
  442. package/lib/commonjs/features/player/setup.js +39 -39
  443. package/lib/commonjs/features/player/setup.js.map +1 -1
  444. package/lib/commonjs/features/player/validateOptions.js +3 -4
  445. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  446. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  447. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  448. package/lib/commonjs/features/queue/queue.js +56 -21
  449. package/lib/commonjs/features/queue/queue.js.map +1 -1
  450. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  451. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  452. package/lib/commonjs/features/queue/shuffle.js +0 -1
  453. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  454. package/lib/commonjs/features/remoteControls.js +59 -35
  455. package/lib/commonjs/features/remoteControls.js.map +1 -1
  456. package/lib/commonjs/features/sleepTimer.js +23 -6
  457. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  458. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  459. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  460. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  461. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  462. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  463. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  464. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  465. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  466. package/lib/commonjs/utils/useDebug.js +16 -3
  467. package/lib/commonjs/utils/useDebug.js.map +1 -1
  468. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  469. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  470. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  471. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  472. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  473. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  474. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  475. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  476. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  477. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  478. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  479. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  480. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  481. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  482. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  483. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  484. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  485. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  486. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  487. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  488. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  489. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  490. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  491. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  492. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  493. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  494. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  495. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  496. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  497. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  498. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  499. package/lib/commonjs/web/browser/sections.js +89 -0
  500. package/lib/commonjs/web/browser/sections.js.map +1 -0
  501. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  502. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  503. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  504. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  505. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  506. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  507. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  508. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  509. package/lib/module/AudioBrowser.js +2 -4
  510. package/lib/module/AudioBrowser.js.map +1 -1
  511. package/lib/module/CLAUDE.md +57 -0
  512. package/lib/module/features/battery.js +16 -12
  513. package/lib/module/features/battery.js.map +1 -1
  514. package/lib/module/features/browser-config.js +13 -9
  515. package/lib/module/features/browser-config.js.map +1 -1
  516. package/lib/module/features/browser.js +78 -20
  517. package/lib/module/features/browser.js.map +1 -1
  518. package/lib/module/features/carConnection.js +3 -4
  519. package/lib/module/features/carConnection.js.map +1 -1
  520. package/lib/module/features/equalizer.js +9 -5
  521. package/lib/module/features/equalizer.js.map +1 -1
  522. package/lib/module/features/errors.js +35 -21
  523. package/lib/module/features/errors.js.map +1 -1
  524. package/lib/module/features/favorites.js +28 -23
  525. package/lib/module/features/favorites.js.map +1 -1
  526. package/lib/module/features/gate.js +27 -6
  527. package/lib/module/features/gate.js.map +1 -1
  528. package/lib/module/features/metadata.js +59 -11
  529. package/lib/module/features/metadata.js.map +1 -1
  530. package/lib/module/features/network.js +5 -1
  531. package/lib/module/features/network.js.map +1 -1
  532. package/lib/module/features/nowPlaying.js +28 -14
  533. package/lib/module/features/nowPlaying.js.map +1 -1
  534. package/lib/module/features/output.js +9 -4
  535. package/lib/module/features/output.js.map +1 -1
  536. package/lib/module/features/playback/controls.js +13 -6
  537. package/lib/module/features/playback/controls.js.map +1 -1
  538. package/lib/module/features/playback/playWhenReady.js +6 -5
  539. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  540. package/lib/module/features/playback/playing.js +5 -3
  541. package/lib/module/features/playback/playing.js.map +1 -1
  542. package/lib/module/features/playback/progress.js +13 -6
  543. package/lib/module/features/playback/progress.js.map +1 -1
  544. package/lib/module/features/playback/rate.js +8 -1
  545. package/lib/module/features/playback/rate.js.map +1 -1
  546. package/lib/module/features/playback/state.js +5 -6
  547. package/lib/module/features/playback/state.js.map +1 -1
  548. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  549. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  550. package/lib/module/features/playback/volume.js +6 -5
  551. package/lib/module/features/playback/volume.js.map +1 -1
  552. package/lib/module/features/player/options.js +21 -11
  553. package/lib/module/features/player/options.js.map +1 -1
  554. package/lib/module/features/player/setup.js +39 -39
  555. package/lib/module/features/player/setup.js.map +1 -1
  556. package/lib/module/features/player/validateOptions.js +3 -4
  557. package/lib/module/features/player/validateOptions.js.map +1 -1
  558. package/lib/module/features/queue/activeTrack.js +14 -4
  559. package/lib/module/features/queue/activeTrack.js.map +1 -1
  560. package/lib/module/features/queue/queue.js +56 -21
  561. package/lib/module/features/queue/queue.js.map +1 -1
  562. package/lib/module/features/queue/repeatMode.js +2 -1
  563. package/lib/module/features/queue/repeatMode.js.map +1 -1
  564. package/lib/module/features/queue/shuffle.js +0 -1
  565. package/lib/module/features/queue/shuffle.js.map +1 -1
  566. package/lib/module/features/remoteControls.js +59 -35
  567. package/lib/module/features/remoteControls.js.map +1 -1
  568. package/lib/module/features/sleepTimer.js +24 -7
  569. package/lib/module/features/sleepTimer.js.map +1 -1
  570. package/lib/module/test-utils/reactNativeStub.js +58 -0
  571. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  572. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  573. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  574. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  575. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  576. package/lib/module/utils/getTrackIdentity.js +22 -0
  577. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  578. package/lib/module/utils/useDebug.js +16 -3
  579. package/lib/module/utils/useDebug.js.map +1 -1
  580. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  581. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  582. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  583. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  584. package/lib/module/web/NativeAudioBrowser.js +207 -84
  585. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  586. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  587. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  588. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  589. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  590. package/lib/module/web/TrackPlayer/Player.js +256 -40
  591. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  592. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  593. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  594. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  595. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  596. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  597. package/lib/module/web/browser/BrowserManager.js +175 -100
  598. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  599. package/lib/module/web/browser/FavoriteManager.js +31 -21
  600. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  601. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  602. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  603. package/lib/module/web/browser/SearchManager.js +18 -23
  604. package/lib/module/web/browser/SearchManager.js.map +1 -1
  605. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  606. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  607. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  608. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  609. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  610. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  611. package/lib/module/web/browser/sections.js +83 -0
  612. package/lib/module/web/browser/sections.js.map +1 -0
  613. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  614. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  615. package/lib/module/web/http/followMediaRedirect.js +215 -0
  616. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  617. package/lib/module/web/player/NowPlayingManager.js +4 -3
  618. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  619. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  620. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  621. package/lib/typescript/package.json +1 -0
  622. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  623. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  624. package/lib/typescript/src/features/battery.d.ts +17 -12
  625. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  626. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  627. package/lib/typescript/src/features/browser.d.ts +67 -19
  628. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  629. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  630. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  631. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  632. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  633. package/lib/typescript/src/features/errors.d.ts +37 -22
  634. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  635. package/lib/typescript/src/features/favorites.d.ts +28 -23
  636. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  637. package/lib/typescript/src/features/gate.d.ts +29 -8
  638. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  639. package/lib/typescript/src/features/metadata.d.ts +65 -14
  640. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  641. package/lib/typescript/src/features/network.d.ts +5 -1
  642. package/lib/typescript/src/features/network.d.ts.map +1 -1
  643. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  644. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  645. package/lib/typescript/src/features/output.d.ts +9 -4
  646. package/lib/typescript/src/features/output.d.ts.map +1 -1
  647. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  648. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  649. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  650. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  651. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  652. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  653. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  654. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  655. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  656. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  657. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  658. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  659. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  660. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  661. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  662. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  663. package/lib/typescript/src/features/player/options.d.ts +73 -56
  664. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  665. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  666. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  667. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  668. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  669. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  670. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  671. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  672. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  673. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  674. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  675. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  676. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  677. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  678. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  679. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  680. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  681. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  682. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  683. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  684. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  685. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  686. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  687. package/lib/typescript/src/types/browser.d.ts +242 -173
  688. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  689. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  690. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  691. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  692. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  693. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  694. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  695. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  696. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  697. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  698. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  699. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  700. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  701. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  702. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  703. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  704. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  705. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  707. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  710. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  711. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  712. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  713. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  717. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  718. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  720. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  721. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  722. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  723. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  724. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  725. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  726. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  727. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  728. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  731. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  732. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  733. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  734. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  735. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  738. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  739. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  741. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  742. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  743. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  744. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  749. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  752. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  753. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  755. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  756. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  757. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  765. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  773. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  774. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  777. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  778. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  783. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  785. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  786. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  791. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  794. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  797. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  800. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  802. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  803. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  804. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  805. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  808. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  810. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  811. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  814. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  815. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  816. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  818. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  825. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  826. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  830. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  832. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  833. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  838. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  840. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  841. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  842. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  844. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  845. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  846. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  847. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  848. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  850. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  851. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  852. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  853. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  854. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  855. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  856. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  857. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  858. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  859. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  860. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  861. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  862. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  863. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1002. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1003. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1004. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1005. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1006. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1007. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1008. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1009. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1010. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1011. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1012. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1013. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1014. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1015. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1016. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1017. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1018. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1019. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1020. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1021. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1022. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1023. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1024. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1025. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1026. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1027. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1028. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1029. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1030. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1031. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1032. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1033. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1034. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1035. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1036. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1037. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1038. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1039. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1040. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1041. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1042. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1043. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1044. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1045. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1046. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1047. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1048. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1049. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1050. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1051. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1052. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1053. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1054. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1055. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1056. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1057. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1058. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1059. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1060. package/package.json +26 -13
  1061. package/src/AudioBrowser.ts +2 -4
  1062. package/src/CLAUDE.md +57 -0
  1063. package/src/docs-floors.test.ts +71 -0
  1064. package/src/features/battery.test.ts +79 -0
  1065. package/src/features/battery.ts +17 -13
  1066. package/src/features/browser-config.test.ts +21 -6
  1067. package/src/features/browser-config.ts +13 -9
  1068. package/src/features/browser.test.ts +1 -1
  1069. package/src/features/browser.ts +69 -20
  1070. package/src/features/carConnection.ts +3 -4
  1071. package/src/features/equalizer.ts +9 -5
  1072. package/src/features/errors.ts +37 -22
  1073. package/src/features/favorites.ts +28 -23
  1074. package/src/features/gate.ts +29 -8
  1075. package/src/features/hook-wiring.test.ts +302 -0
  1076. package/src/features/metadata.ts +80 -14
  1077. package/src/features/network.ts +5 -1
  1078. package/src/features/nowPlaying.ts +28 -14
  1079. package/src/features/output.ts +9 -4
  1080. package/src/features/playback/controls.ts +13 -6
  1081. package/src/features/playback/playWhenReady.ts +6 -5
  1082. package/src/features/playback/playing.ts +16 -3
  1083. package/src/features/playback/progress.test.ts +169 -0
  1084. package/src/features/playback/progress.ts +13 -6
  1085. package/src/features/playback/rate.ts +8 -1
  1086. package/src/features/playback/state.ts +10 -6
  1087. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1088. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1089. package/src/features/playback/volume.ts +6 -5
  1090. package/src/features/player/options.ts +82 -63
  1091. package/src/features/player/setup.test.ts +12 -3
  1092. package/src/features/player/setup.ts +122 -63
  1093. package/src/features/player/validateOptions.ts +3 -4
  1094. package/src/features/queue/activeTrack.ts +14 -4
  1095. package/src/features/queue/queue.ts +56 -21
  1096. package/src/features/queue/repeatMode.ts +1 -1
  1097. package/src/features/queue/shuffle.ts +0 -1
  1098. package/src/features/remoteControls.ts +59 -35
  1099. package/src/features/sleepTimer.test.ts +171 -0
  1100. package/src/features/sleepTimer.ts +24 -8
  1101. package/src/nitro-stub-drift.test.ts +277 -0
  1102. package/src/public-surface.test.ts +56 -25
  1103. package/src/specs/audio-browser.nitro.ts +15 -8
  1104. package/src/style-resolution.test.ts +210 -0
  1105. package/src/test-utils/reactNativeStub.ts +60 -0
  1106. package/src/types/browser-native.ts +7 -3
  1107. package/src/types/browser-nodes.ts +417 -151
  1108. package/src/types/browser.ts +248 -177
  1109. package/src/utils/LazyNativeEmitter.ts +17 -10
  1110. package/src/utils/NativeUpdatedValue.ts +30 -16
  1111. package/src/utils/getTrackIdentity.ts +22 -0
  1112. package/src/utils/useDebug.test.ts +182 -0
  1113. package/src/utils/useDebug.ts +16 -3
  1114. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1115. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1116. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1117. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1118. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1119. package/src/web/NativeAudioBrowser.ts +247 -92
  1120. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1121. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1122. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1123. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1124. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1125. package/src/web/TrackPlayer/Player.ts +286 -38
  1126. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1127. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1128. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1129. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1130. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1131. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1132. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1133. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1134. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1135. package/src/web/__tests__/retry.test.ts +169 -0
  1136. package/src/web/browser/BrowserManager.ts +209 -111
  1137. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1138. package/src/web/browser/FavoriteManager.ts +28 -23
  1139. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1140. package/src/web/browser/SearchManager.test.ts +75 -0
  1141. package/src/web/browser/SearchManager.ts +25 -28
  1142. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1143. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1144. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1145. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1146. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1147. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1148. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1149. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1150. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1151. package/src/web/browser/parseSearchResponse.ts +3 -4
  1152. package/src/web/browser/sections.test.ts +91 -0
  1153. package/src/web/browser/sections.ts +72 -0
  1154. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1155. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1156. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1157. package/src/web/http/followMediaRedirect.ts +253 -0
  1158. package/src/web/player/NowPlayingManager.ts +4 -3
  1159. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1160. package/src/web/util/BrowserPathHelper.ts +68 -13
  1161. package/website/guide/android-auto.md +126 -0
  1162. package/website/guide/android-certificates.md +488 -0
  1163. package/website/guide/artwork.md +300 -0
  1164. package/website/guide/audio-output.md +357 -0
  1165. package/website/guide/automotive.md +91 -0
  1166. package/website/guide/basic-usage.md +154 -0
  1167. package/website/guide/battery.md +142 -0
  1168. package/website/guide/browser.md +674 -0
  1169. package/website/guide/carplay.md +733 -0
  1170. package/website/guide/configuration.md +215 -0
  1171. package/website/guide/equalizer.md +235 -0
  1172. package/website/guide/errors.md +355 -0
  1173. package/website/guide/favorites.md +164 -0
  1174. package/website/guide/gate.md +157 -0
  1175. package/website/guide/getting-started.md +99 -0
  1176. package/website/guide/hooks.md +247 -0
  1177. package/website/guide/live-streams.md +156 -0
  1178. package/website/guide/metadata.md +289 -0
  1179. package/website/guide/migrating-from-track-player.md +289 -0
  1180. package/website/guide/native-callback-fetch.md +137 -0
  1181. package/website/guide/network.md +102 -0
  1182. package/website/guide/now-playing.md +203 -0
  1183. package/website/guide/playback.md +405 -0
  1184. package/website/guide/queue.md +334 -0
  1185. package/website/guide/remote-controls.md +314 -0
  1186. package/website/guide/search.md +270 -0
  1187. package/website/guide/sleep-timer.md +289 -0
  1188. package/website/guide/track.md +271 -0
  1189. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1190. package/ios/Bridge.h +0 -8
  1191. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1192. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1193. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1194. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1195. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1196. package/ios/Model/MediaURL.swift +0 -67
  1197. package/ios/Model/SourceType.swift +0 -6
  1198. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1199. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1200. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1201. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1202. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1203. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1204. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1205. package/ios/Option/PitchAlgorithms.swift +0 -17
  1206. package/ios/Option/TimeEventFrequency.swift +0 -18
  1207. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1208. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1209. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1210. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1211. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1212. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1213. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1214. package/ios/Player/PlaybackStateStore.swift +0 -27
  1215. package/ios/Player/PlayingStateManager.swift +0 -33
  1216. package/ios/Player/RetryManager.swift +0 -323
  1217. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1218. package/ios/Player/SleepTimerHandling.swift +0 -15
  1219. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1220. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1221. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1222. package/ios/Tests/MediaResolveTests.swift +0 -126
  1223. package/ios/Tests/OnceValueTests.swift +0 -79
  1224. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1225. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1226. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1227. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1228. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1229. package/ios/Tests/RetryManagerTests.swift +0 -89
  1230. package/ios/TrackPlayer.swift +0 -1014
  1231. package/ios/TrackPlayerCallbacks.swift +0 -53
  1232. package/ios/Util/MetadataAdapter.swift +0 -131
  1233. package/ios/Util/OnceValue.swift +0 -104
  1234. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1235. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1236. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1237. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1238. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1239. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1240. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1241. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1242. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1243. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1244. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1245. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1246. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1247. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -0,0 +1,1719 @@
1
+ @testable import AudioBrowserTestable
2
+ import Foundation
3
+ import Testing
4
+
5
+ @MainActor
6
+ private func makeCoordinator() -> (
7
+ player: Player,
8
+ engine: MockPlayerEngine,
9
+ callbacks: MockPlayerCallbacks,
10
+ clock: ManualSleepTimerScheduler,
11
+ ) {
12
+ let clock = ManualSleepTimerScheduler()
13
+ let engine = MockPlayerEngine()
14
+ let player = makePlayer(engine: engine, retries: false, sleepTimerScheduler: clock)
15
+ let callbacks = MockPlayerCallbacks()
16
+ player.callbacks = callbacks
17
+ return (player, engine, callbacks, clock)
18
+ }
19
+
20
+ @MainActor
21
+ private func loadTrack(
22
+ _ player: Player,
23
+ id: String = "t1",
24
+ src: String? = "https://example.com/audio.mp3",
25
+ title: String = "Test Track",
26
+ ) throws {
27
+ let track = Track(id: id, src: src, title: title)
28
+ try player.setQueue([track])
29
+ }
30
+
31
+ // MARK: - Transition + Side Effects
32
+
33
+ @Suite("Player - transition + side effects")
34
+ struct TransitionTests {
35
+ @Test @MainActor
36
+ func toReady_startsPlayback_whenPlayWhenReady() throws {
37
+ let (c, eh, _, _) = makeCoordinator()
38
+ try loadTrack(c)
39
+ c.setPlayWhenReady(true)
40
+ eh.startPlaybackCallCount = 0
41
+
42
+ c.transition(.bufferingSufficient)
43
+
44
+ #expect(c.state == .ready)
45
+ #expect(eh.startPlaybackCallCount == 1)
46
+ }
47
+
48
+ @Test @MainActor
49
+ func toReady_doesNotStart_whenNotPlayWhenReady() throws {
50
+ let (c, eh, _, _) = makeCoordinator()
51
+ try loadTrack(c)
52
+ c.transition(.bufferingSufficient)
53
+
54
+ #expect(c.state == .ready)
55
+ #expect(eh.startPlaybackCallCount == 0)
56
+ }
57
+
58
+ @Test @MainActor
59
+ func toLoading_setsTimePitchAlgorithm() {
60
+ let (c, eh, _, _) = makeCoordinator()
61
+
62
+ c.transition(.trackLoading)
63
+
64
+ #expect(c.state == .loading)
65
+ #expect(eh.setTimePitchCallCount == 1)
66
+ }
67
+
68
+ @Test @MainActor
69
+ func toError_setsPlaybackError() {
70
+ let (c, _, _, _) = makeCoordinator()
71
+
72
+ c.transition(.errorOccurred(.playbackFailed))
73
+
74
+ #expect(c.state == .error)
75
+ #expect(c.errorStatus.error == .playbackFailed)
76
+ }
77
+
78
+ @Test @MainActor
79
+ func leavingError_clearsPlaybackError() {
80
+ let (c, _, _, _) = makeCoordinator()
81
+ c.transition(.errorOccurred(.playbackFailed))
82
+ #expect(c.errorStatus.error == .playbackFailed)
83
+
84
+ c.transition(.trackLoading)
85
+
86
+ #expect(c.state == .loading)
87
+ #expect(c.errorStatus.error == nil)
88
+ }
89
+
90
+ @Test @MainActor
91
+ func errorToError_updatesAndEmits() {
92
+ let (c, _, cb, _) = makeCoordinator()
93
+ c.transition(.errorOccurred(.playbackFailed))
94
+ cb.playbackChanges.removeAll()
95
+ cb.errorEvents.removeAll()
96
+
97
+ c.transition(.errorOccurred(.notConnectedToInternet))
98
+
99
+ #expect(c.state == .error)
100
+ #expect(c.errorStatus.error == .notConnectedToInternet)
101
+ #expect(cb.playbackChanges.count == 1)
102
+ #expect(cb.errorEvents.count == 1)
103
+ }
104
+ }
105
+
106
+ // MARK: - Retrying Errors
107
+
108
+ @MainActor
109
+ private func makeRetrying() -> (
110
+ Player, RetryLoop, MockPlayerCallbacks,
111
+ MockPlayerEngine,
112
+ ) {
113
+ let retryHandler = makeRetryLoop()
114
+ let engine = MockPlayerEngine()
115
+ let player = makePlayer(engine: engine, retry: retryHandler)
116
+ let callbacks = MockPlayerCallbacks()
117
+ player.callbacks = callbacks
118
+ return (player, retryHandler, callbacks, engine)
119
+ }
120
+
121
+ /// Retry-loop errors are advisory: they ride on the current state's playbackChanges,
122
+ /// never transition it and never reach playerDidError.
123
+ @Suite("Player - retrying errors")
124
+ struct RetryingErrorTests {
125
+ @Test @MainActor
126
+ func retryingError_attachesToCurrentState() async {
127
+ let (c, _, cb, _) = makeRetrying()
128
+ c.transition(.trackLoading)
129
+ cb.playbackChanges.removeAll()
130
+
131
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
132
+
133
+ #expect(c.state == .loading)
134
+ #expect(c.errorStatus.error == .hostUnreachable)
135
+ #expect(cb.playbackChanges.count == 1)
136
+ #expect(cb.playbackChanges.last?.state == .loading)
137
+ #expect(cb.playbackChanges.last?.error?.retrying == true)
138
+ #expect(cb.errorEvents.isEmpty)
139
+ await c.retry.pendingTask?.value
140
+ }
141
+
142
+ /// Each emission re-renders now-playing, so a repeat every backoff tick must not re-emit.
143
+ @Test @MainActor
144
+ func repeatedIdenticalFailure_emitsOnce() async {
145
+ let (c, _, cb, _) = makeRetrying()
146
+ c.transition(.trackLoading)
147
+ cb.playbackChanges.removeAll()
148
+
149
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
150
+ await c.retry.pendingTask?.value
151
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
152
+ await c.retry.pendingTask?.value
153
+
154
+ #expect(cb.playbackChanges.count == 1)
155
+ }
156
+
157
+ /// Buffered audio still plays, so the advisory must not replace the song line (as on Android).
158
+ @Test @MainActor
159
+ func retryingErrorWhilePlaying_isSuppressed() async {
160
+ let (c, _, cb, _) = makeRetrying()
161
+ c.transition(.avPlayerPlaying)
162
+ cb.playbackChanges.removeAll()
163
+
164
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .playback)
165
+
166
+ #expect(c.errorStatus.error == nil)
167
+ #expect(cb.playbackChanges.isEmpty)
168
+ await c.retry.pendingTask?.value
169
+ }
170
+
171
+ @Test @MainActor
172
+ func recovery_clearsTheRetryingError() async {
173
+ let (c, _, cb, _) = makeRetrying()
174
+ c.transition(.trackLoading)
175
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
176
+ await c.retry.pendingTask?.value
177
+
178
+ c.transition(.loadSeekCompleted)
179
+
180
+ #expect(c.state == .ready)
181
+ #expect(c.errorStatus.error == nil)
182
+ #expect(cb.playbackChanges.last?.error == nil)
183
+ }
184
+
185
+ @Test @MainActor
186
+ func exhaustion_hardensIntoTerminalError() async {
187
+ let (c, retryHandler, cb, _) = makeRetrying()
188
+ retryHandler.updatePolicy(from: .second(RetryConfig(
189
+ maxRetries: 1, maxRetryDurationMs: nil, firstConnectMaxRetryDurationMs: nil,
190
+ )))
191
+ c.transition(.trackLoading)
192
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
193
+ await c.retry.pendingTask?.value
194
+
195
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
196
+ await c.retry.pendingTask?.value
197
+
198
+ #expect(c.state == .error)
199
+ #expect(cb.playbackChanges.last?.state == .error)
200
+ #expect(cb.playbackChanges.last?.error?.retrying == nil)
201
+ #expect(cb.errorEvents.count == 1)
202
+ }
203
+
204
+ /// The listener chose to pause, so the retry the pause stops is no failure; the next play
205
+ /// reloads where it failed, since the item it would have replaced is dead.
206
+ @Test @MainActor
207
+ func pauseDuringRetry_staysQuietAndReloadsOnPlay() async throws {
208
+ let (c, eh, cb) = try makePlayingWithRetries()
209
+ eh.resumePosition = 42
210
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .playback)
211
+ let retrying = c.retry.pendingTask
212
+
213
+ c.pause()
214
+ await retrying?.value
215
+
216
+ #expect(c.state != .error)
217
+ #expect(cb.errorEvents.isEmpty)
218
+ #expect(eh.resolveAndLoadCalls.isEmpty)
219
+
220
+ c.play()
221
+
222
+ #expect(eh.resolveAndLoadCalls.count == 1)
223
+ #expect(c.deferredSeek.target == 42)
224
+ }
225
+
226
+ /// AVPlayer fails a paused live item once its data stalls.
227
+ @Test @MainActor
228
+ func retryableFailureWhilePaused_staysPausedAndReloadsOnPlay() throws {
229
+ let (c, eh, cb) = try makePlayingWithRetries()
230
+ eh.resumePosition = 42
231
+ c.pause()
232
+ let changesBefore = cb.playbackChanges.count
233
+
234
+ eh.emit(.failed(NSError(domain: "CoreMediaErrorDomain", code: -16830), httpStatusCode: nil))
235
+
236
+ #expect(c.state == .paused)
237
+ #expect(cb.errorEvents.isEmpty)
238
+ #expect(cb.playbackChanges.dropFirst(changesBefore).allSatisfy { $0.error == nil })
239
+ #expect(c.retry.pendingTask == nil)
240
+ #expect(eh.resolveAndLoadCalls.isEmpty)
241
+ #expect(c.getPlayback().state == .paused)
242
+ #expect(c.getPlayback().error == nil)
243
+
244
+ c.play()
245
+
246
+ #expect(eh.resolveAndLoadCalls.count == 1)
247
+ #expect(c.deferredSeek.target == 42)
248
+ }
249
+
250
+ @Test @MainActor
251
+ func aParkedLoadThatKeepsFailingAfterPlay_endsInTheTerminalErrorOnAFullBudget() async throws {
252
+ let (c, eh, cb) = try makePlayingWithRetries()
253
+ c.retry.updatePolicy(from: .second(RetryConfig(
254
+ maxRetries: 2, maxRetryDurationMs: nil, firstConnectMaxRetryDurationMs: nil,
255
+ )))
256
+ let stall = NSError(domain: "CoreMediaErrorDomain", code: -16830)
257
+ // One retry spent before the pause; the park refills the budget.
258
+ eh.emit(.failed(stall, httpStatusCode: nil))
259
+ await c.retry.pendingTask?.value
260
+ #expect(c.retry.attempts == 1)
261
+
262
+ c.pause()
263
+ eh.emit(.failed(stall, httpStatusCode: nil))
264
+ #expect(c.retry.attempts == 0)
265
+ c.play()
266
+ eh.resolveAndLoadCalls.removeAll()
267
+
268
+ for _ in 0 ..< 3 {
269
+ eh.emit(.failed(stall, httpStatusCode: nil))
270
+ await c.retry.pendingTask?.value
271
+ }
272
+
273
+ #expect(eh.resolveAndLoadCalls.count == 2)
274
+ #expect(c.state == .error)
275
+ #expect(cb.errorEvents.count == 1)
276
+ #expect(c.getPlayback().error != nil)
277
+ }
278
+
279
+ @Test @MainActor
280
+ func nonRetryableFailureWhilePaused_isTerminal() throws {
281
+ let (c, eh, cb) = try makePlayingWithRetries()
282
+ c.pause()
283
+ eh.emit(.failed(URLError(.fileDoesNotExist), httpStatusCode: 404))
284
+ #expect(c.state == .error)
285
+ #expect(cb.errorEvents.count == 1)
286
+ }
287
+
288
+ @Test @MainActor
289
+ func pauseDuringRetry_whileBuffering_reportsPausedWithoutTheRetryingError() throws {
290
+ let (c, eh, cb) = try makePlayingWithRetries()
291
+ c.transition(.avPlayerWaiting)
292
+ eh.emit(.failed(URLError(.cannotConnectToHost), httpStatusCode: nil))
293
+ #expect(cb.playbackChanges.last?.error?.retrying == true)
294
+
295
+ c.pause()
296
+
297
+ #expect(cb.playbackChanges.last?.state == .paused)
298
+ #expect(cb.playbackChanges.last?.error == nil)
299
+ }
300
+
301
+ @Test @MainActor
302
+ func pauseDuringRetry_whileLoading_reportsPausedWithoutTheRetryingError() throws {
303
+ let (c, eh, cb) = try makePlayingWithRetries()
304
+ c.reloadResolving(startFromCurrentTime: false)
305
+ eh.emit(.loadFailed(URLError(.cannotConnectToHost)))
306
+ #expect(cb.playbackChanges.last?.state == .loading)
307
+ #expect(cb.playbackChanges.last?.error?.retrying == true)
308
+
309
+ c.pause()
310
+
311
+ #expect(cb.playbackChanges.last?.state == .paused)
312
+ #expect(cb.playbackChanges.last?.error == nil)
313
+ }
314
+
315
+ @Test @MainActor
316
+ func interruptionDuringALoadRetry_reportsPaused() throws {
317
+ let (c, eh, cb) = try makePlayingWithRetries()
318
+ c.reloadResolving(startFromCurrentTime: false)
319
+ eh.hasLoadedAsset = false
320
+ eh.emit(.loadFailed(URLError(.cannotConnectToHost)))
321
+
322
+ c.handleInterruptionBegan()
323
+
324
+ #expect(cb.playbackChanges.last?.state == .paused)
325
+ }
326
+
327
+ /// The failed item can't seek, so a seek waits for the reload, as one does while loading.
328
+ @Test @MainActor
329
+ func seekAfterPauseDuringRetry_landsOnTheReload() throws {
330
+ let (c, eh, _) = try makePlayingWithRetries()
331
+ eh.resumePosition = 42
332
+ eh.currentTime = 42
333
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .playback)
334
+ c.pause()
335
+
336
+ c.seek(by: 10)
337
+ #expect(c.deferredSeek.target == 52)
338
+ c.seek(to: 100)
339
+ c.play()
340
+
341
+ #expect(eh.seekCalls.isEmpty)
342
+ #expect(c.deferredSeek.target == 100)
343
+ }
344
+
345
+ @Test @MainActor
346
+ func pauseDuringRetry_refillsTheBudgets() async throws {
347
+ let (c, _, cb) = try makePlayingWithRetries()
348
+ c.retry.updatePolicy(from: .second(RetryConfig(
349
+ maxRetries: 1, maxRetryDurationMs: nil, firstConnectMaxRetryDurationMs: nil,
350
+ )))
351
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .playback)
352
+ await c.retry.pendingTask?.value
353
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .playback)
354
+
355
+ c.pause()
356
+ c.play()
357
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .playback)
358
+ await c.retry.pendingTask?.value
359
+
360
+ #expect(c.state != .error)
361
+ #expect(cb.errorEvents.isEmpty)
362
+ }
363
+
364
+ @Test @MainActor
365
+ func aRetryNowDuringABackoff_reloadsOnce() async throws {
366
+ let (c, eh, cb) = try makePlayingWithRetries()
367
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .playback)
368
+ let retrying = c.retry.pendingTask
369
+
370
+ c.retryNow()
371
+ await retrying?.value
372
+
373
+ #expect(eh.resolveAndLoadCalls.count == 1)
374
+ #expect(c.retry.pendingTask == nil)
375
+ #expect(cb.errorEvents.isEmpty)
376
+ }
377
+
378
+ @Test @MainActor
379
+ func pauseDuringRetry_thenStop_playsFromTheStart() throws {
380
+ let (c, eh, _) = try makePlayingWithRetries()
381
+ eh.resumePosition = 42
382
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .playback)
383
+
384
+ c.pause()
385
+ c.stop()
386
+ c.play()
387
+
388
+ #expect(eh.resolveAndLoadCalls.count == 1)
389
+ #expect(c.deferredSeek.target ?? 0 == 0)
390
+ }
391
+ }
392
+
393
+ /// Playing a track whose retries follow the play intent and back off long enough to pause in.
394
+ @MainActor
395
+ private func makePlayingWithRetries() throws -> (Player, MockPlayerEngine, MockPlayerCallbacks) {
396
+ let engine = MockPlayerEngine()
397
+ let player = makePlayer(engine: engine, retry: makeRetryLoop(delay: 0.05), retries: nil)
398
+ let callbacks = MockPlayerCallbacks()
399
+ player.callbacks = callbacks
400
+ try startPlaying(player, engine)
401
+ // The engine's position counts only once an item is prepared.
402
+ engine.emit(.itemPrepared(likelyToKeepUp: false))
403
+ engine.resolveAndLoadCalls.removeAll()
404
+ return (player, engine, callbacks)
405
+ }
406
+
407
+ // MARK: - emitStateChange
408
+
409
+ @Suite("Player - emitStateChange")
410
+ struct EmitStateChangeTests {
411
+ @Test @MainActor
412
+ func alwaysEmits_playerDidChangePlayback() {
413
+ let (c, _, cb, _) = makeCoordinator()
414
+
415
+ c.transition(.trackLoading)
416
+
417
+ #expect(cb.playbackChanges.count == 1)
418
+ #expect(cb.playbackChanges.first?.state == .loading)
419
+ }
420
+
421
+ @Test @MainActor
422
+ func emitsErrorCallback_onEnterError() {
423
+ let (c, _, cb, _) = makeCoordinator()
424
+
425
+ c.transition(.errorOccurred(.playbackFailed))
426
+
427
+ #expect(cb.errorEvents.count == 1)
428
+ }
429
+
430
+ @Test @MainActor
431
+ func emitsErrorCallback_onLeaveError() {
432
+ let (c, _, cb, _) = makeCoordinator()
433
+ c.transition(.errorOccurred(.playbackFailed))
434
+ cb.errorEvents.removeAll()
435
+
436
+ c.transition(.trackLoading)
437
+
438
+ #expect(cb.errorEvents.count == 1)
439
+ #expect(cb.errorEvents.first?.error == nil)
440
+ }
441
+
442
+ @Test @MainActor
443
+ func emitsQueueEnded_onEndedAndLastTrack() throws {
444
+ let (c, eh, cb, _) = makeCoordinator()
445
+ try loadTrack(c)
446
+ eh.currentTime = 42
447
+ cb.queueEndedEvents.removeAll()
448
+
449
+ c.transition(.trackEndedNaturally)
450
+
451
+ #expect(cb.queueEndedEvents.count == 1)
452
+ #expect(cb.queueEndedEvents.first?.position == 42)
453
+ #expect(cb.queueEndedEvents.first?.track == 0)
454
+ }
455
+ }
456
+
457
+ // MARK: - Observer Guards
458
+
459
+ @Suite("Player - observer guards")
460
+ struct ObserverGuardTests {
461
+ @Test @MainActor
462
+ func timeControlStatus_paused_nearTrackEnd_ignored() {
463
+ let (c, eh, cb, _) = makeCoordinator()
464
+ c.transition(.avPlayerPlaying)
465
+ cb.playbackChanges.removeAll()
466
+ eh.hasLoadedAsset = true
467
+ // Within the last 0.5 s, where Player ignores a pause.
468
+ eh.currentTime = 99.8
469
+ eh.duration = 100
470
+
471
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
472
+
473
+ #expect(c.state == .playing)
474
+ }
475
+
476
+ @Test @MainActor
477
+ func timeControlStatus_paused_noAsset_transitionsToNone() {
478
+ let (c, eh, _, _) = makeCoordinator()
479
+ c.transition(.avPlayerPlaying)
480
+ eh.hasLoadedAsset = false
481
+ eh.currentTime = 0
482
+ eh.duration = 0
483
+
484
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
485
+
486
+ #expect(c.state == .none)
487
+ }
488
+
489
+ @Test @MainActor
490
+ func timeControlStatus_paused_withAsset_notPlayWhenReady_transitionsToPaused() {
491
+ let (c, eh, _, _) = makeCoordinator()
492
+ c.transition(.avPlayerPlaying)
493
+ eh.hasLoadedAsset = true
494
+ eh.currentTime = 10
495
+ eh.duration = 100
496
+ c.setPlayWhenReady(false)
497
+
498
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
499
+
500
+ #expect(c.state == .paused)
501
+ }
502
+
503
+ @Test @MainActor
504
+ func timeControlStatus_paused_withAsset_playWhenReady_ignored() {
505
+ let (c, eh, _, _) = makeCoordinator()
506
+ c.transition(.avPlayerPlaying)
507
+ eh.hasLoadedAsset = true
508
+ eh.currentTime = 10
509
+ eh.duration = 100
510
+ c.setPlayWhenReady(true)
511
+
512
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
513
+
514
+ #expect(c.state == .playing)
515
+ }
516
+
517
+ @Test @MainActor
518
+ func timeControlStatus_ignored_duringLoading() {
519
+ let (c, eh, cb, _) = makeCoordinator()
520
+ c.transition(.trackLoading)
521
+ cb.playbackChanges.removeAll()
522
+
523
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
524
+
525
+ #expect(c.state == .loading)
526
+ #expect(cb.playbackChanges.isEmpty)
527
+ }
528
+
529
+ @Test @MainActor
530
+ func waiting_noAsset_ignored() {
531
+ let (c, eh, _, _) = makeCoordinator()
532
+ c.transition(.avPlayerPlaying)
533
+ eh.hasLoadedAsset = false
534
+
535
+ eh.emit(.timeControlStatus(.waitingToPlayAtSpecifiedRate, waitingForNoItem: false))
536
+
537
+ #expect(c.state == .playing)
538
+ }
539
+
540
+ @Test @MainActor
541
+ func waiting_withAsset_transitionsToBuffering() {
542
+ let (c, eh, _, _) = makeCoordinator()
543
+ c.transition(.avPlayerPlaying)
544
+ eh.hasLoadedAsset = true
545
+
546
+ eh.emit(.timeControlStatus(.waitingToPlayAtSpecifiedRate, waitingForNoItem: false))
547
+
548
+ #expect(c.state == .buffering)
549
+ }
550
+
551
+ @Test @MainActor
552
+ func playbackLikelyToKeepUp_false_ignored() {
553
+ let (c, eh, cb, _) = makeCoordinator()
554
+ c.transition(.trackLoading)
555
+ cb.playbackChanges.removeAll()
556
+
557
+ eh.emit(.likelyToKeepUp(false))
558
+
559
+ #expect(c.state == .loading)
560
+ #expect(cb.playbackChanges.isEmpty)
561
+ }
562
+
563
+ @Test @MainActor
564
+ func playbackLikelyToKeepUp_true_transitionsToReady() {
565
+ let (c, eh, _, _) = makeCoordinator()
566
+ c.transition(.trackLoading)
567
+ eh.hasLoadedAsset = true
568
+ eh.hasItem = true
569
+
570
+ eh.emit(.likelyToKeepUp(true))
571
+
572
+ #expect(c.state == .ready)
573
+ }
574
+
575
+ @Test @MainActor
576
+ func audioDidStart_ignored_duringLoading() {
577
+ let (c, eh, _, _) = makeCoordinator()
578
+ c.transition(.trackLoading)
579
+
580
+ eh.emit(.audioDidStart)
581
+
582
+ #expect(c.state == .loading)
583
+ }
584
+
585
+ @Test @MainActor
586
+ func audioDidStart_transitionsToPlaying() {
587
+ let (c, eh, _, _) = makeCoordinator()
588
+ c.transition(.bufferingSufficient)
589
+
590
+ eh.emit(.audioDidStart)
591
+
592
+ #expect(c.state == .playing)
593
+ }
594
+ }
595
+
596
+ // MARK: - playWhenReady
597
+
598
+ @Suite("Player - playWhenReady")
599
+ struct PlayWhenReadyTests {
600
+ @Test @MainActor
601
+ func true_fromError_triggersReload() throws {
602
+ let (c, eh, _, _) = makeCoordinator()
603
+ try loadTrack(c)
604
+ // The engine's position counts only once an item is prepared.
605
+ eh.emit(.itemPrepared(likelyToKeepUp: false))
606
+ c.transition(.errorOccurred(.playbackFailed))
607
+ eh.resumePosition = 42
608
+ let resolvesBefore = eh.resolveAndLoadCalls.count
609
+
610
+ c.setPlayWhenReady(true)
611
+
612
+ // .error recreates the AVPlayer and resumes where it failed.
613
+ #expect(eh.recreateCount == 1)
614
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore + 1)
615
+ #expect(c.state == .loading)
616
+ #expect(c.deferredSeek.target == 42)
617
+ }
618
+
619
+ @Test @MainActor
620
+ func toggle_fromErrorWithIntentRaised_reloads() throws {
621
+ let (c, eh, _, _) = makeCoordinator()
622
+ try loadTrack(c)
623
+ c.setPlayWhenReady(true)
624
+ c.transition(.errorOccurred(.playbackFailed))
625
+ let resolvesBefore = eh.resolveAndLoadCalls.count
626
+
627
+ c.togglePlayback()
628
+
629
+ #expect(c.playWhenReady)
630
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore + 1)
631
+ #expect(c.state == .loading)
632
+ }
633
+
634
+ @Test @MainActor
635
+ func true_fromStopped_triggersReload() throws {
636
+ let (c, eh, _, _) = makeCoordinator()
637
+ try loadTrack(c)
638
+ c.transition(.stopped)
639
+ eh.resumePosition = 42
640
+ let resolvesBefore = eh.resolveAndLoadCalls.count
641
+
642
+ c.setPlayWhenReady(true)
643
+
644
+ #expect(eh.recreateCount == 0)
645
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore + 1)
646
+ #expect(c.deferredSeek.target == nil) // a stop restarts from the start
647
+ }
648
+
649
+ @Test @MainActor
650
+ func true_notLoading_startsPlayback() {
651
+ let (c, eh, _, _) = makeCoordinator()
652
+ c.transition(.bufferingSufficient)
653
+
654
+ c.setPlayWhenReady(true)
655
+
656
+ #expect(eh.startPlaybackCallCount >= 1)
657
+ }
658
+
659
+ @Test @MainActor
660
+ func false_notLoading_pausesPlayback() {
661
+ let (c, eh, _, _) = makeCoordinator()
662
+ c.transition(.avPlayerPlaying)
663
+ c.setPlayWhenReady(true)
664
+ eh.pausePlaybackCallCount = 0
665
+
666
+ c.setPlayWhenReady(false)
667
+
668
+ #expect(eh.pausePlaybackCallCount == 1)
669
+ }
670
+
671
+ @Test @MainActor
672
+ func noOp_duringLoading() {
673
+ let (c, eh, _, _) = makeCoordinator()
674
+ c.transition(.trackLoading)
675
+ eh.startPlaybackCallCount = 0
676
+ eh.pausePlaybackCallCount = 0
677
+
678
+ c.setPlayWhenReady(true)
679
+
680
+ #expect(eh.startPlaybackCallCount == 0)
681
+ #expect(eh.pausePlaybackCallCount == 0)
682
+ }
683
+
684
+ @Test @MainActor
685
+ func emitsCallback_onChange() {
686
+ let (c, _, cb, _) = makeCoordinator()
687
+
688
+ c.setPlayWhenReady(true)
689
+
690
+ #expect(cb.playWhenReadyChanges.count == 1)
691
+ #expect(cb.playWhenReadyChanges.first == true)
692
+ }
693
+ }
694
+
695
+ // MARK: - Skip availability (next/previous greying)
696
+
697
+ @Suite("Player - skip availability")
698
+ struct SkipAvailabilityCoordinatorTests {
699
+ private static func multiTrack() -> [Track] {
700
+ [
701
+ Track(id: "t1", src: "https://example.com/1.mp3", title: "Track 1"),
702
+ Track(id: "t2", src: "https://example.com/2.mp3", title: "Track 2"),
703
+ ]
704
+ }
705
+
706
+ @Test @MainActor
707
+ func singleTrack_disablesBoth() throws {
708
+ let (c, eh, _, _) = makeCoordinator()
709
+ try c.setQueue([Track(id: "t1", src: "https://example.com/1.mp3", title: "Track 1")])
710
+
711
+ #expect(eh.updateSkipAvailabilityCalls.last?.canNext == false)
712
+ #expect(eh.updateSkipAvailabilityCalls.last?.canPrevious == false)
713
+ }
714
+
715
+ @Test @MainActor
716
+ func firstOfMany_nextOnly() throws {
717
+ let (c, eh, _, _) = makeCoordinator()
718
+ try c.setQueue(Self.multiTrack())
719
+
720
+ #expect(eh.updateSkipAvailabilityCalls.last?.canNext == true)
721
+ #expect(eh.updateSkipAvailabilityCalls.last?.canPrevious == false)
722
+ }
723
+
724
+ @Test @MainActor
725
+ func lastOfMany_previousOnly() throws {
726
+ let (c, eh, _, _) = makeCoordinator()
727
+ try c.setQueue(Self.multiTrack())
728
+ try? c.skipTo(1)
729
+
730
+ #expect(eh.updateSkipAvailabilityCalls.last?.canNext == false)
731
+ #expect(eh.updateSkipAvailabilityCalls.last?.canPrevious == true)
732
+ }
733
+
734
+ @Test @MainActor
735
+ func repeatAll_repushesAvailability_atEnd() throws {
736
+ let (c, eh, _, _) = makeCoordinator()
737
+ try c.setQueue(Self.multiTrack())
738
+ try? c.skipTo(1)
739
+ eh.updateSkipAvailabilityCalls.removeAll()
740
+
741
+ // Repeat-all wraps, so Next is available again at the last track.
742
+ c.repeatMode = .queue
743
+
744
+ #expect(eh.updateSkipAvailabilityCalls.last?.canNext == true)
745
+ #expect(eh.updateSkipAvailabilityCalls.last?.canPrevious == true)
746
+ }
747
+ }
748
+
749
+ // MARK: - handleCurrentTrackChanged
750
+
751
+ @Suite("Player - handleCurrentTrackChanged")
752
+ struct HandleCurrentTrackChangedTests {
753
+ @Test @MainActor
754
+ func clearsError_beforeTransition() throws {
755
+ let (c, eh, _, _) = makeCoordinator()
756
+ eh.hasLoadedAsset = true
757
+ c.transition(.errorOccurred(.playbackFailed))
758
+ #expect(c.errorStatus.error != nil)
759
+
760
+ try loadTrack(c)
761
+
762
+ #expect(c.errorStatus.error == nil)
763
+ }
764
+
765
+ @Test @MainActor
766
+ func preservesPlayWhenReady_acrossLoading() throws {
767
+ let (c, _, _, _) = makeCoordinator()
768
+ c.setPlayWhenReady(true)
769
+
770
+ try loadTrack(c)
771
+
772
+ #expect(c.playWhenReady == true)
773
+ #expect(c.state == .loading)
774
+ }
775
+
776
+ @Test @MainActor
777
+ func nilSrc_transitionsToError() throws {
778
+ let (c, _, cb, _) = makeCoordinator()
779
+
780
+ let track = Track(id: "t1", path: "/no-source", src: nil, title: "No Source")
781
+ try c.setQueue([track])
782
+
783
+ #expect(c.state == .error)
784
+ #expect(c.errorStatus.error == .invalidSourceUrl("nil"))
785
+ #expect(cb.errorEvents.count >= 1)
786
+ }
787
+
788
+ @Test @MainActor
789
+ func nilSrc_emitsActiveTrackChangedEvent() throws {
790
+ let (c, _, cb, _) = makeCoordinator()
791
+ try c.setQueue([
792
+ Track(id: "t1", src: "https://example.com/1.mp3", title: "Track 1"),
793
+ Track(id: "t2", path: "/no-source", src: nil, title: "No Source"),
794
+ ])
795
+ cb.activeTrackChanges.removeAll()
796
+
797
+ try c.skipTo(1)
798
+
799
+ #expect(cb.activeTrackChanges.count == 1)
800
+ let event = cb.activeTrackChanges.first
801
+ #expect(event?.track?.id == "t2")
802
+ #expect(event?.index == 1)
803
+ #expect(event?.lastTrack?.id == "t1")
804
+ #expect(event?.lastIndex == 0)
805
+ #expect(c.state == .error)
806
+ #expect(c.errorStatus.error == .invalidSourceUrl("nil"))
807
+
808
+ cb.activeTrackChanges.removeAll()
809
+ try c.skipTo(0)
810
+
811
+ #expect(cb.activeTrackChanges.first?.lastTrack?.id == "t2")
812
+ #expect(cb.activeTrackChanges.first?.lastIndex == 1)
813
+ }
814
+
815
+ @Test @MainActor
816
+ func emitsActiveTrackChangedEvent() throws {
817
+ let (c, _, cb, _) = makeCoordinator()
818
+
819
+ try loadTrack(c)
820
+
821
+ #expect(cb.activeTrackChanges.count == 1)
822
+ let event = cb.activeTrackChanges.first!
823
+ #expect(event.lastIndex == nil)
824
+ #expect(event.index == 0)
825
+ #expect(event.track?.id == "t1")
826
+ }
827
+ }
828
+
829
+ // MARK: - handleTrackDidPlayToEndTime
830
+
831
+ @Suite("Player - handleTrackDidPlayToEndTime")
832
+ struct HandleTrackDidPlayToEndTimeTests {
833
+ @Test @MainActor
834
+ func repeatTrack_replays() throws {
835
+ let (c, eh, _, _) = makeCoordinator()
836
+ try startPlaying(c, eh)
837
+ c.repeatMode = .track
838
+ eh.startPlaybackCallCount = 0
839
+
840
+ eh.emit(.playedToEnd)
841
+
842
+ #expect(eh.seekCalls == [0])
843
+ #expect(eh.startPlaybackCallCount == 1)
844
+ }
845
+
846
+ /// The end-of-track sleep timer clears the intent just before this handler runs, so replaying
847
+ /// would resume right after it paused. Without intent the track settles in .ended, where play()
848
+ /// reloads. A repeating queue never ends, so no queue-ended event.
849
+ @Test @MainActor
850
+ func repeatTrack_withoutIntent_settlesEnded() throws {
851
+ let (c, eh, cb, _) = makeCoordinator()
852
+ try loadTrack(c)
853
+ c.repeatMode = .track
854
+ c.setPlayWhenReady(false)
855
+
856
+ eh.emit(.playedToEnd)
857
+
858
+ #expect(cb.queueEndedEvents.isEmpty)
859
+ #expect(eh.seekCalls.isEmpty)
860
+ #expect(c.state == .ended)
861
+ }
862
+
863
+ @Test @MainActor
864
+ func lastTrack_noRepeat_transitionsToEnded() throws {
865
+ let (c, eh, cb, _) = makeCoordinator()
866
+ try loadTrack(c)
867
+ c.repeatMode = .off
868
+
869
+ eh.emit(.playedToEnd)
870
+
871
+ #expect(c.state == .ended)
872
+ #expect(cb.queueEndedEvents.count >= 1)
873
+ }
874
+
875
+ @Test @MainActor
876
+ func midQueue_advancesToNext() throws {
877
+ let (c, eh, cb, _) = makeCoordinator()
878
+ let tracks = [
879
+ Track(id: "t1", src: "https://example.com/1.mp3", title: "Track 1"),
880
+ Track(id: "t2", src: "https://example.com/2.mp3", title: "Track 2"),
881
+ ]
882
+ try c.setQueue(tracks)
883
+ cb.activeTrackChanges.removeAll()
884
+
885
+ eh.emit(.playedToEnd)
886
+
887
+ #expect(c.queue.currentIndex == 1)
888
+ #expect(cb.activeTrackChanges.count == 1)
889
+ #expect(cb.activeTrackChanges.first?.track?.id == "t2")
890
+ }
891
+ }
892
+
893
+ // MARK: - Natural end drops play intent
894
+
895
+ /// A natural queue end leaves nothing to play, so `playWhenReady` drops. Held, it would invert
896
+ /// the play/pause toggle, hold the audio session, arm interruption resume into silence, and
897
+ /// leave play() from .ended a no-op.
898
+ @Suite("Player - natural end drops play intent")
899
+ struct NaturalEndPlayIntentTests {
900
+ @Test @MainActor
901
+ func naturalEnd_clearsPlayWhenReady() throws {
902
+ let (c, eh, _, _) = makeCoordinator()
903
+ try startPlaying(c, eh)
904
+
905
+ eh.emit(.playedToEnd)
906
+
907
+ #expect(c.state == .ended)
908
+ #expect(c.playWhenReady == false)
909
+ }
910
+
911
+ @Test @MainActor
912
+ func naturalEnd_requestsSessionRelease() throws {
913
+ let (c, eh, _, _) = makeCoordinator()
914
+ try startPlaying(c, eh)
915
+ eh.scheduleAudioSessionReleaseCount = 0
916
+
917
+ eh.emit(.playedToEnd)
918
+
919
+ #expect(eh.scheduleAudioSessionReleaseCount == 1)
920
+ }
921
+
922
+ /// startPlayback() alone is a silent no-op on a player parked at the end of its item.
923
+ @Test @MainActor
924
+ func playAfterNaturalEnd_reloadsFromStart() throws {
925
+ let (c, eh, _, _) = makeCoordinator()
926
+ try startPlaying(c, eh)
927
+ eh.emit(.playedToEnd)
928
+ eh.resumePosition = 300
929
+ let resolvesBefore = eh.resolveAndLoadCalls.count
930
+
931
+ c.play()
932
+
933
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore + 1)
934
+ #expect(c.deferredSeek.target == nil)
935
+ }
936
+
937
+ /// The cleared intent opens the call site's `!playWhenReady` gate, so this pause reaches the
938
+ /// state machine; the table's .ended guard must hold the state.
939
+ @Test @MainActor
940
+ func strayPauseAfterNaturalEnd_staysEnded() throws {
941
+ let (c, eh, _, _) = makeCoordinator()
942
+ try startPlaying(c, eh)
943
+ eh.emit(.playedToEnd)
944
+ #expect(c.state == .ended)
945
+
946
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
947
+
948
+ #expect(c.state == .ended)
949
+ }
950
+
951
+ @Test @MainActor
952
+ func interruptionAfterNaturalEnd_doesNotArmResume() throws {
953
+ let (c, eh, _, _) = makeCoordinator()
954
+ try startPlaying(c, eh)
955
+ eh.emit(.playedToEnd)
956
+ let resolvesBefore = eh.resolveAndLoadCalls.count
957
+
958
+ c.handleInterruptionBegan()
959
+ c.handleInterruptionEnded(shouldResume: true)
960
+
961
+ #expect(c.playWhenReady == false)
962
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore)
963
+ }
964
+ }
965
+
966
+ // MARK: - Healthy playback refills the retry budget
967
+
968
+ /// Sustained playback proves the stream recovered, so the retry budget refills (as on
969
+ /// Android); otherwise a long-lived stream loses retry after its first recovered blip.
970
+ @Suite("Player - healthy playback resets retry budget")
971
+ struct HealthyPlaybackRetryResetTests {
972
+ /// A nonzero delay skips the retry, leaving the caller to start one that stays pending.
973
+ @MainActor
974
+ private func makeAfterOneRetry(delay: TimeInterval = 0) async -> (Player, RetryLoop, MockPlayerEngine) {
975
+ let retry = makeRetryLoop(delay: delay)
976
+ let engine = MockPlayerEngine()
977
+ let player = makePlayer(engine: engine, retry: retry)
978
+ if delay == 0 {
979
+ retry.handleError(URLError(.timedOut), context: .playback)
980
+ await retry.pendingTask?.value
981
+ }
982
+ return (player, retry, engine)
983
+ }
984
+
985
+ @Test @MainActor
986
+ func sustainedPlayback_resetsRetryBudget() async {
987
+ let (player, retry, _) = await makeAfterOneRetry()
988
+ #expect(retry.attempts == 1)
989
+ retry.healthyPlaybackDuration = .milliseconds(10)
990
+
991
+ player.transition(.avPlayerPlaying)
992
+ await retry.healthyPlaybackTask?.value
993
+
994
+ #expect(retry.attempts == 0)
995
+ }
996
+
997
+ /// reset() cancels a pending retry: a refill now would silently kill an in-flight reconnect.
998
+ @Test @MainActor
999
+ func refill_skipsWhileRetryIsPending() async {
1000
+ let (player, retry, _) = await makeAfterOneRetry(delay: 1)
1001
+ retry.healthyPlaybackDuration = .milliseconds(10)
1002
+
1003
+ player.transition(.avPlayerPlaying)
1004
+ retry.handleError(URLError(.timedOut), context: .playback)
1005
+ await retry.healthyPlaybackTask?.value
1006
+
1007
+ #expect(retry.pendingTask != nil)
1008
+ retry.cancel()
1009
+ }
1010
+
1011
+ @Test @MainActor
1012
+ func playbackInterruptedBeforeThreshold_doesNotReset() async {
1013
+ let (player, retry, engine) = await makeAfterOneRetry()
1014
+ engine.hasLoadedAsset = true
1015
+ retry.healthyPlaybackDuration = .milliseconds(500)
1016
+
1017
+ player.transition(.avPlayerPlaying)
1018
+ let refill = retry.healthyPlaybackTask
1019
+ player.transition(.avPlayerWaiting)
1020
+
1021
+ // Leaving .playing cancels the refill; awaiting the cancelled task reaches, deterministically,
1022
+ // the point where it would have fired.
1023
+ await refill?.value
1024
+
1025
+ #expect(retry.attempts == 1)
1026
+ }
1027
+ }
1028
+
1029
+ // MARK: - Sleep Timer Fade
1030
+
1031
+ @Suite("Player - sleep timer fade")
1032
+ struct SleepTimerFadeTests {
1033
+ /// A 20 s timer whose 10 s fade has begun.
1034
+ @MainActor
1035
+ private func startFade(_ c: Player, _ clock: ManualSleepTimerScheduler) {
1036
+ c.sleepTimerManager.set(seconds: 20, fadeDuration: 10)
1037
+ clock.advance(to: 10)
1038
+ }
1039
+
1040
+ @Test @MainActor
1041
+ func fadeStart_capturesPreFadeVolume() {
1042
+ let (c, eh, _, clock) = makeCoordinator()
1043
+ eh.volume = 0.8
1044
+
1045
+ startFade(c, clock)
1046
+ eh.volume = 0.1 // mid-fade
1047
+
1048
+ #expect(c.sleepTimerManager.isFading)
1049
+ c.sleepTimerManager.clear()
1050
+ #expect(eh.volume == 0.8)
1051
+ }
1052
+
1053
+ @Test @MainActor
1054
+ func completion_pausesThenRestoresPreFadeVolume() throws {
1055
+ let (c, eh, _, clock) = makeCoordinator()
1056
+ try loadTrack(c)
1057
+ c.setPlayWhenReady(true)
1058
+ c.transition(.bufferingSufficient) // leave .loading so pause reaches the player
1059
+ eh.pausePlaybackCallCount = 0
1060
+
1061
+ startFade(c, clock)
1062
+ eh.volume = 0.2 // mid-fade
1063
+
1064
+ clock.advance(to: 20)
1065
+
1066
+ #expect(c.playWhenReady == false)
1067
+ #expect(eh.pausePlaybackCallCount == 1)
1068
+ #expect(eh.volume == 1.0)
1069
+ #expect(!c.sleepTimerManager.isFading)
1070
+ }
1071
+
1072
+ @Test @MainActor
1073
+ func completion_withoutFade_justPauses() throws {
1074
+ let (c, eh, _, clock) = makeCoordinator()
1075
+ try loadTrack(c)
1076
+ c.setPlayWhenReady(true)
1077
+ eh.volume = 0.8
1078
+ c.sleepTimerManager.set(seconds: 20)
1079
+
1080
+ clock.advance(to: 20)
1081
+
1082
+ #expect(c.playWhenReady == false)
1083
+ #expect(eh.volume == 0.8)
1084
+ }
1085
+
1086
+ @Test @MainActor
1087
+ func fadeCancel_restoresPreFadeVolume() {
1088
+ let (c, eh, _, clock) = makeCoordinator()
1089
+ eh.volume = 0.8
1090
+
1091
+ startFade(c, clock)
1092
+ eh.volume = 0.1 // mid-fade
1093
+
1094
+ c.sleepTimerManager.set(seconds: 60)
1095
+
1096
+ #expect(eh.volume == 0.8)
1097
+ #expect(!c.sleepTimerManager.isFading)
1098
+ }
1099
+
1100
+ @Test @MainActor
1101
+ func pauseDuringFade_clearsSleepTimer() throws {
1102
+ let (c, _, _, clock) = makeCoordinator()
1103
+ try loadTrack(c)
1104
+ c.setPlayWhenReady(true)
1105
+
1106
+ startFade(c, clock)
1107
+ c.pause()
1108
+
1109
+ #expect(c.sleepTimerManager.get() == nil)
1110
+ }
1111
+
1112
+ @Test @MainActor
1113
+ func pauseWithoutFade_leavesSleepTimerAlone() throws {
1114
+ let (c, _, _, _) = makeCoordinator()
1115
+ try loadTrack(c)
1116
+ c.setPlayWhenReady(true)
1117
+ c.sleepTimerManager.set(seconds: 60, fadeDuration: 10)
1118
+
1119
+ c.pause()
1120
+
1121
+ #expect(c.sleepTimerManager.get() != nil)
1122
+ }
1123
+ }
1124
+
1125
+ // MARK: - Audio Session Interruptions
1126
+
1127
+ @MainActor
1128
+ private func startPlaying(_ c: Player, _ eh: MockPlayerEngine) throws {
1129
+ try loadTrack(c)
1130
+ eh.hasLoadedAsset = true
1131
+ eh.hasItem = true
1132
+ c.setPlayWhenReady(true)
1133
+ c.transition(.avPlayerPlaying)
1134
+ }
1135
+
1136
+ @Suite("Player - audio session interruptions")
1137
+ struct InterruptionTests {
1138
+ @Test @MainActor
1139
+ func began_whilePlaying_pauses() throws {
1140
+ let (c, eh, _, _) = makeCoordinator()
1141
+ try startPlaying(c, eh)
1142
+ #expect(c.state == .playing)
1143
+
1144
+ c.handleInterruptionBegan()
1145
+
1146
+ #expect(c.state == .paused)
1147
+ #expect(c.playWhenReady == false)
1148
+ }
1149
+
1150
+ /// iOS pauses the AVPlayer before the interruption arrives; with `playWhenReady` still true
1151
+ /// that pause is swallowed, so the handler must force the pause itself.
1152
+ @Test @MainActor
1153
+ func began_afterSwallowedTimeControlPause_stillPauses() throws {
1154
+ let (c, eh, _, _) = makeCoordinator()
1155
+ try startPlaying(c, eh)
1156
+
1157
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
1158
+ #expect(c.state == .playing)
1159
+
1160
+ c.handleInterruptionBegan()
1161
+
1162
+ #expect(c.state == .paused)
1163
+ }
1164
+
1165
+ @Test @MainActor
1166
+ func ended_shouldResume_resumesWhenWasPlaying() throws {
1167
+ let (c, eh, _, _) = makeCoordinator()
1168
+ try startPlaying(c, eh)
1169
+ c.handleInterruptionBegan()
1170
+ #expect(c.playWhenReady == false)
1171
+ eh.startPlaybackCallCount = 0
1172
+
1173
+ c.handleInterruptionEnded(shouldResume: true)
1174
+
1175
+ #expect(c.playWhenReady == true)
1176
+ #expect(eh.startPlaybackCallCount == 1)
1177
+ }
1178
+
1179
+ @Test @MainActor
1180
+ func ended_withoutShouldResume_staysPaused() throws {
1181
+ let (c, eh, _, _) = makeCoordinator()
1182
+ try startPlaying(c, eh)
1183
+ c.handleInterruptionBegan()
1184
+
1185
+ c.handleInterruptionEnded(shouldResume: false)
1186
+
1187
+ #expect(c.state == .paused)
1188
+ #expect(c.playWhenReady == false)
1189
+ }
1190
+
1191
+ /// The host gates audio-session reactivation at interruption end on this, so a player paused
1192
+ /// when interrupted does not take a non-mixable session for a resume that never comes.
1193
+ @Test @MainActor
1194
+ func willResumeAfterInterruption_reflectsCapturedIntent() throws {
1195
+ let (c, eh, _, _) = makeCoordinator()
1196
+ try startPlaying(c, eh)
1197
+
1198
+ c.handleInterruptionBegan()
1199
+ #expect(c.willResumeAfterInterruption == true)
1200
+
1201
+ c.handleInterruptionEnded(shouldResume: false)
1202
+ #expect(c.willResumeAfterInterruption == false)
1203
+
1204
+ // Paused by the first interruption, so nothing to resume.
1205
+ c.handleInterruptionBegan()
1206
+ #expect(c.willResumeAfterInterruption == false)
1207
+ }
1208
+
1209
+ /// iOS nests interruptions (Siri, then a call): a second began must not re-capture the
1210
+ /// now-false intent.
1211
+ @Test @MainActor
1212
+ func doubleBegan_preservesResumeIntent() throws {
1213
+ let (c, eh, _, _) = makeCoordinator()
1214
+ try startPlaying(c, eh)
1215
+
1216
+ c.handleInterruptionBegan()
1217
+ c.handleInterruptionBegan()
1218
+ c.handleInterruptionEnded(shouldResume: true)
1219
+
1220
+ #expect(c.playWhenReady == true)
1221
+ }
1222
+
1223
+ /// Unplugging headphones during a call is a deliberate output loss: the call's end must not
1224
+ /// resume on the built-in speaker.
1225
+ @Test @MainActor
1226
+ func routeDisconnectDuringInterruption_cancelsResume() throws {
1227
+ let (c, eh, _, _) = makeCoordinator()
1228
+ try startPlaying(c, eh)
1229
+ c.handleInterruptionBegan()
1230
+
1231
+ c.handleRouteDisconnected()
1232
+ c.handleInterruptionEnded(shouldResume: true)
1233
+
1234
+ #expect(c.playWhenReady == false)
1235
+ }
1236
+
1237
+ @Test @MainActor
1238
+ func stopDuringInterruption_isNotOverriddenByResume() throws {
1239
+ let (c, eh, _, _) = makeCoordinator()
1240
+ try startPlaying(c, eh)
1241
+ c.handleInterruptionBegan()
1242
+ let resolvesBefore = eh.resolveAndLoadCalls.count
1243
+
1244
+ c.stop()
1245
+ c.handleInterruptionEnded(shouldResume: true)
1246
+
1247
+ #expect(c.state == .stopped)
1248
+ #expect(c.playWhenReady == false)
1249
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore)
1250
+ }
1251
+
1252
+ @Test @MainActor
1253
+ func userPauseDuringInterruption_overridesResume() throws {
1254
+ let (c, eh, _, _) = makeCoordinator()
1255
+ try startPlaying(c, eh)
1256
+ c.handleInterruptionBegan()
1257
+
1258
+ c.play()
1259
+ c.pause()
1260
+ c.handleInterruptionEnded(shouldResume: true)
1261
+
1262
+ #expect(c.playWhenReady == false)
1263
+ }
1264
+
1265
+ @Test @MainActor
1266
+ func ended_doesNotResume_whenNotPlayingBeforeInterruption() throws {
1267
+ let (c, eh, _, _) = makeCoordinator()
1268
+ try startPlaying(c, eh)
1269
+ c.setPlayWhenReady(false)
1270
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
1271
+ #expect(c.state == .paused)
1272
+
1273
+ c.handleInterruptionBegan()
1274
+ c.handleInterruptionEnded(shouldResume: true)
1275
+
1276
+ #expect(c.playWhenReady == false)
1277
+ }
1278
+ }
1279
+
1280
+ // MARK: - Skip availability freshness
1281
+
1282
+ /// A mutation pushes next/previous availability once, after currentIndex and the shuffle order
1283
+ /// settle; an earlier push leaves the lock-screen buttons wrong.
1284
+ @Suite("Player - skip availability after mutations")
1285
+ struct MutationSkipAvailabilityTests {
1286
+ @Test @MainActor
1287
+ func move_pushesPostMutationAvailability() throws {
1288
+ let (c, eh, _, _) = makeCoordinator()
1289
+ try c.setQueue([
1290
+ Track(id: "a", src: "https://example.com/a.mp3", title: "A"),
1291
+ Track(id: "b", src: "https://example.com/b.mp3", title: "B"),
1292
+ ])
1293
+ eh.updateSkipAvailabilityCalls.removeAll()
1294
+
1295
+ try c.move(fromIndex: 0, toIndex: 1)
1296
+
1297
+ // Current is now last.
1298
+ #expect(eh.updateSkipAvailabilityCalls.count == 1)
1299
+ #expect(eh.updateSkipAvailabilityCalls.last?.canNext == false)
1300
+ }
1301
+
1302
+ @Test @MainActor
1303
+ func removeBeforeCurrent_pushesPostMutationAvailability() throws {
1304
+ let (c, eh, _, _) = makeCoordinator()
1305
+ try c.setQueue(
1306
+ [
1307
+ Track(id: "a", src: "https://example.com/a.mp3", title: "A"),
1308
+ Track(id: "b", src: "https://example.com/b.mp3", title: "B"),
1309
+ Track(id: "c", src: "https://example.com/c.mp3", title: "C"),
1310
+ ], initialIndex: 2,
1311
+ )
1312
+ eh.updateSkipAvailabilityCalls.removeAll()
1313
+
1314
+ try c.remove(0)
1315
+
1316
+ // Current settled at index 1 of 2.
1317
+ #expect(eh.updateSkipAvailabilityCalls.count == 1)
1318
+ #expect(eh.updateSkipAvailabilityCalls.last?.canNext == false)
1319
+ #expect(eh.updateSkipAvailabilityCalls.last?.canPrevious == true)
1320
+ }
1321
+ }
1322
+
1323
+ // MARK: - Publishing
1324
+
1325
+ @Suite("Player - publishing")
1326
+ struct PublishingTests {
1327
+ /// The order JS depends on: the intent, the playing state, the playback. A natural end clears
1328
+ /// the intent on the way in; each change still goes out once.
1329
+ @Test @MainActor
1330
+ func endingPublishesTheIntentThenThePlayingStateThenThePlayback() {
1331
+ let (c, _, cb, _) = makeCoordinator()
1332
+ c.setPlayWhenReady(true)
1333
+ c.transition(.avPlayerPlaying)
1334
+ cb.publishOrder.removeAll()
1335
+
1336
+ c.transition(.trackEndedNaturally)
1337
+
1338
+ #expect(cb.publishOrder == ["playWhenReady", "playingState", "playback"])
1339
+ }
1340
+
1341
+ @Test @MainActor
1342
+ func aTransitionPublishesThePlayingStateBeforeThePlayback() {
1343
+ let (c, _, cb, _) = makeCoordinator()
1344
+ c.setPlayWhenReady(true)
1345
+ cb.publishOrder.removeAll()
1346
+
1347
+ c.transition(.avPlayerPlaying)
1348
+
1349
+ #expect(cb.publishOrder == ["playingState", "playback"])
1350
+ }
1351
+
1352
+ @Test @MainActor
1353
+ func aRepeatedTerminalErrorIsReportedAgain() {
1354
+ let (c, _, cb, _) = makeCoordinator()
1355
+ c.transition(.errorOccurred(.playbackFailed))
1356
+ c.transition(.errorOccurred(.playbackFailed))
1357
+
1358
+ #expect(cb.errorEvents.count == 2)
1359
+ }
1360
+ }
1361
+
1362
+ // MARK: - Load
1363
+
1364
+ @Suite("Player - Load")
1365
+ struct LoadTests {
1366
+ @MainActor
1367
+ private func track(_ id: String) -> Track {
1368
+ Track(id: id, src: "https://example.com/\(id).mp3", title: id)
1369
+ }
1370
+
1371
+ @Test @MainActor
1372
+ func aNewTrackStartsAnUnprovenLoad() throws {
1373
+ let (c, eh, _, _) = makeCoordinator()
1374
+ try c.setQueue([track("a"), track("b")])
1375
+ let first = c.load
1376
+ eh.emit(.audioDidStart)
1377
+ #expect(c.load?.hasPlayed == true)
1378
+
1379
+ c.next()
1380
+
1381
+ #expect(c.load != nil && c.load?.id != first?.id)
1382
+ #expect(c.load?.hasPlayed == false)
1383
+ }
1384
+
1385
+ /// The healthy-playback refill resets the retry budget mid-play; the load must survive it.
1386
+ @Test @MainActor
1387
+ func aRetryResetKeepsTheLoad() throws {
1388
+ let (c, eh, _, _) = makeCoordinator()
1389
+ try c.setQueue([track("a")])
1390
+ eh.emit(.audioDidStart)
1391
+ let load = c.load
1392
+
1393
+ c.retry.reset()
1394
+
1395
+ #expect(c.load == load)
1396
+ #expect(c.load?.hasPlayed == true)
1397
+ }
1398
+
1399
+ @Test
1400
+ func theNowPlayingPrimeIsClaimedOnce() {
1401
+ var load = Player.Load(id: 1)
1402
+ let first = load.claimNowPlayingPrime()
1403
+ let second = load.claimNowPlayingPrime()
1404
+ #expect(first)
1405
+ #expect(!second)
1406
+ }
1407
+ }
1408
+
1409
+ // MARK: - Queue publication
1410
+
1411
+ @Suite("Player - queue publication")
1412
+ struct QueuePublicationTests {
1413
+ @MainActor
1414
+ private func threeTracks() -> [Track] {
1415
+ ["a", "b", "c"].map { Track(id: $0, src: "https://example.com/\($0).mp3", title: $0) }
1416
+ }
1417
+
1418
+ @Test @MainActor
1419
+ func setQueue_publishesTheQueueBeforeTheActiveTrack() throws {
1420
+ let (c, _, cb, _) = makeCoordinator()
1421
+ try c.setQueue(threeTracks())
1422
+ #expect(cb.queueChanges.map { $0.map(\.id) } == [["a", "b", "c"]])
1423
+ #expect(cb.queueAndTrackOrder == ["queue", "activeTrack"])
1424
+ }
1425
+
1426
+ @Test @MainActor
1427
+ func move_publishesTheSettledQueueOnce() throws {
1428
+ let (c, _, cb, _) = makeCoordinator()
1429
+ try c.setQueue(threeTracks())
1430
+ cb.queueChanges.removeAll()
1431
+ try c.move(fromIndex: 0, toIndex: 2)
1432
+ #expect(cb.queueChanges.map { $0.map(\.id) } == [["b", "c", "a"]])
1433
+ }
1434
+
1435
+ @Test @MainActor
1436
+ func clear_publishesAnEmptyQueue() throws {
1437
+ let (c, _, cb, _) = makeCoordinator()
1438
+ try c.setQueue(threeTracks())
1439
+ cb.queueChanges.removeAll()
1440
+ c.clear()
1441
+ #expect(cb.queueChanges.map(\.count) == [0])
1442
+ }
1443
+
1444
+ @Test @MainActor
1445
+ func navigation_publishesNoQueue() throws {
1446
+ let (c, _, cb, _) = makeCoordinator()
1447
+ try c.setQueue(threeTracks())
1448
+ cb.queueChanges.removeAll()
1449
+ c.next()
1450
+ c.previous()
1451
+ try c.skipTo(2)
1452
+ #expect(cb.queueChanges.isEmpty)
1453
+ }
1454
+ }
1455
+
1456
+ // MARK: - Stop cancels pending retry
1457
+
1458
+ @Suite("Player - stop cancels pending retry")
1459
+ struct StopCancelsRetryTests {
1460
+ @Test @MainActor
1461
+ func stop_cancelsPendingRetry_andStaysSilent() async {
1462
+ let errorHandler = makeRetryLoop(delay: 0.05)
1463
+ let engine = MockPlayerEngine()
1464
+ let player = makePlayer(engine: engine, retry: errorHandler)
1465
+ let callbacks = MockPlayerCallbacks()
1466
+ player.callbacks = callbacks
1467
+
1468
+ errorHandler.handleError(URLError(.timedOut), context: .playback)
1469
+ let task = errorHandler.pendingTask
1470
+ #expect(task != nil)
1471
+
1472
+ player.stop()
1473
+ #expect(errorHandler.pendingTask == nil)
1474
+
1475
+ await task?.value
1476
+ #expect(player.state == .stopped)
1477
+ #expect(callbacks.errorEvents.isEmpty)
1478
+ }
1479
+ }
1480
+
1481
+ // MARK: - Audio session release (#60)
1482
+
1483
+ @Suite("Player - audio session release")
1484
+ struct SessionReleaseTests {
1485
+ @Test @MainActor
1486
+ func deliberatePause_requestsRelease() throws {
1487
+ let (c, eh, _, _) = makeCoordinator()
1488
+ try startPlaying(c, eh)
1489
+ eh.scheduleAudioSessionReleaseCount = 0
1490
+ c.pause()
1491
+ #expect(eh.scheduleAudioSessionReleaseCount == 1)
1492
+ }
1493
+
1494
+ @Test @MainActor
1495
+ func play_doesNotRequestRelease() throws {
1496
+ let (c, eh, _, _) = makeCoordinator()
1497
+ try startPlaying(c, eh)
1498
+ #expect(eh.scheduleAudioSessionReleaseCount == 0)
1499
+ }
1500
+
1501
+ @Test @MainActor
1502
+ func interruptionBegan_doesNotRequestRelease() throws {
1503
+ // A call pauses but is meant to resume, so the session is held.
1504
+ let (c, eh, _, _) = makeCoordinator()
1505
+ try startPlaying(c, eh)
1506
+ eh.scheduleAudioSessionReleaseCount = 0
1507
+ c.handleInterruptionBegan()
1508
+ #expect(eh.scheduleAudioSessionReleaseCount == 0)
1509
+ }
1510
+
1511
+ @Test @MainActor
1512
+ func interruptionEnded_withResume_doesNotRequestRelease() throws {
1513
+ let (c, eh, _, _) = makeCoordinator()
1514
+ try startPlaying(c, eh)
1515
+ c.handleInterruptionBegan()
1516
+ eh.scheduleAudioSessionReleaseCount = 0
1517
+ c.handleInterruptionEnded(shouldResume: true)
1518
+ #expect(eh.scheduleAudioSessionReleaseCount == 0)
1519
+ }
1520
+
1521
+ @Test @MainActor
1522
+ func interruptionEnded_withoutResume_requestsRelease() throws {
1523
+ let (c, eh, _, _) = makeCoordinator()
1524
+ try startPlaying(c, eh)
1525
+ c.handleInterruptionBegan()
1526
+ eh.scheduleAudioSessionReleaseCount = 0
1527
+ c.handleInterruptionEnded(shouldResume: false)
1528
+ #expect(eh.scheduleAudioSessionReleaseCount == 1)
1529
+ }
1530
+
1531
+ @Test @MainActor
1532
+ func pauseDuringRetry_requestsRelease() async throws {
1533
+ let (c, eh, _) = try makePlayingWithRetries()
1534
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .playback)
1535
+ let retrying = c.retry.pendingTask
1536
+ eh.scheduleAudioSessionReleaseCount = 0
1537
+
1538
+ c.pause()
1539
+ await retrying?.value
1540
+
1541
+ #expect(eh.scheduleAudioSessionReleaseCount == 1)
1542
+ }
1543
+ }
1544
+
1545
+ // MARK: - Media-stack effects of a publish
1546
+
1547
+ /// The audio-session and now-playing effects the Player drives through its engine, in order
1548
+ /// with the callbacks JS hears.
1549
+ @Suite("Player - media-stack effects")
1550
+ struct MediaStackEffectTests {
1551
+ @MainActor
1552
+ private func makeTraced() -> (Player, MockPlayerEngine, MockPlayerCallbacks) {
1553
+ let (c, eh, cb, _) = makeCoordinator()
1554
+ eh.onSeamCall = { [weak cb] in cb?.publishOrder.append($0) }
1555
+ return (c, eh, cb)
1556
+ }
1557
+
1558
+ @Test @MainActor
1559
+ func playIntent_cancelsTheReleaseBeforeJSHearsIt_thenActivatesOnOutput() throws {
1560
+ let (c, _, cb) = makeTraced()
1561
+ try loadTrack(c)
1562
+ cb.publishOrder.removeAll()
1563
+
1564
+ c.setPlayWhenReady(true)
1565
+
1566
+ #expect(cb.publishOrder == [
1567
+ "cancelAudioSessionRelease", "playWhenReady",
1568
+ "playingState", "activateAudioSession", "renderNowPlaying",
1569
+ ])
1570
+ }
1571
+
1572
+ @Test @MainActor
1573
+ func pause_rendersWithoutActivating_thenSchedulesTheRelease() throws {
1574
+ let (c, eh, cb) = makeTraced()
1575
+ try startPlaying(c, eh)
1576
+ cb.publishOrder.removeAll()
1577
+
1578
+ c.pause()
1579
+
1580
+ #expect(cb.publishOrder == [
1581
+ "playWhenReady", "playingState", "renderNowPlaying", "scheduleAudioSessionRelease",
1582
+ ])
1583
+ }
1584
+
1585
+ @Test @MainActor
1586
+ func playbackChange_rendersAfterJSHearsIt() throws {
1587
+ let (c, _, cb) = makeTraced()
1588
+ try loadTrack(c)
1589
+ cb.publishOrder.removeAll()
1590
+
1591
+ c.transition(.errorOccurred(.playbackFailed))
1592
+
1593
+ #expect(cb.publishOrder == ["playback", "renderNowPlaying"])
1594
+ }
1595
+
1596
+ @Test @MainActor
1597
+ func activeTrackChange_clearsTheTrackStateBeforeJSHearsIt_thenRendersTheLines() throws {
1598
+ let (c, eh, cb, _) = makeCoordinator()
1599
+ eh.onSeamCall = { [weak cb] call in
1600
+ if call == "nowPlayingTrackChanged" || call == "renderNowPlaying" {
1601
+ cb?.queueAndTrackOrder.append(call)
1602
+ }
1603
+ }
1604
+
1605
+ try c.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "A")])
1606
+
1607
+ let order = cb.queueAndTrackOrder
1608
+ let cleared = try #require(order.firstIndex(of: "nowPlayingTrackChanged"))
1609
+ let heard = try #require(order.firstIndex(of: "activeTrack"))
1610
+ #expect(cleared < heard)
1611
+ #expect(try #require(order.lastIndex(of: "renderNowPlaying")) > heard)
1612
+ #expect(eh.nowPlayingTrackChangedCount == 1)
1613
+ }
1614
+
1615
+ @Test @MainActor
1616
+ func timedMetadata_reachesJSThenTheNowPlayingLines() {
1617
+ let (c, eh, cb) = makeTraced()
1618
+ let metadata = TimedMetadata(title: "Song", artist: "Artist")
1619
+
1620
+ eh.emit(.timedMetadata(metadata))
1621
+ withExtendedLifetime(c) {}
1622
+
1623
+ #expect(cb.publishOrder == ["timedMetadata", "applyTimedMetadata"])
1624
+ #expect(cb.timedMetadata == [metadata])
1625
+ #expect(eh.appliedTimedMetadata == [metadata])
1626
+ }
1627
+
1628
+ @Test @MainActor
1629
+ func stop_clearsTheStreamTitleBeforeRendering() throws {
1630
+ let (c, eh, cb) = makeTraced()
1631
+ try startPlaying(c, eh)
1632
+ cb.publishOrder.removeAll()
1633
+
1634
+ c.stop()
1635
+
1636
+ let cleared = try #require(cb.publishOrder.firstIndex(of: "clearTimedMetadata"))
1637
+ #expect(try cleared < #require(cb.publishOrder.firstIndex(of: "renderNowPlaying")))
1638
+ }
1639
+
1640
+ @Test @MainActor
1641
+ func pause_keepsTheStreamTitle() throws {
1642
+ let (c, eh, cb) = makeTraced()
1643
+ try startPlaying(c, eh)
1644
+ cb.publishOrder.removeAll()
1645
+
1646
+ c.pause()
1647
+
1648
+ #expect(!cb.publishOrder.contains("clearTimedMetadata"))
1649
+ }
1650
+
1651
+ @Test @MainActor
1652
+ func trackEnd_keepsTheStreamTitle() throws {
1653
+ let (c, eh, cb) = makeTraced()
1654
+ try startPlaying(c, eh)
1655
+ cb.publishOrder.removeAll()
1656
+
1657
+ eh.emit(.playedToEnd)
1658
+
1659
+ #expect(c.state == .ended)
1660
+ #expect(!cb.publishOrder.contains("clearTimedMetadata"))
1661
+ }
1662
+
1663
+ /// The stream resends its current title after the reload; nothing may drop it as unchanged.
1664
+ @Test @MainActor
1665
+ func stopThenPlay_appliesTheSameTitleAgain() throws {
1666
+ let (c, eh, cb) = makeTraced()
1667
+ let metadata = TimedMetadata(title: "Song", artist: "Artist")
1668
+ try startPlaying(c, eh)
1669
+ eh.emit(.timedMetadata(metadata))
1670
+
1671
+ c.stop()
1672
+ c.play()
1673
+ eh.emit(.timedMetadata(metadata))
1674
+
1675
+ #expect(eh.appliedTimedMetadata == [metadata, metadata])
1676
+ #expect(cb.timedMetadata == [metadata, metadata])
1677
+ }
1678
+ }
1679
+
1680
+ @Suite("Player - now-playing preview")
1681
+ struct NowPlayingPreviewTests {
1682
+ @Test @MainActor
1683
+ func preview_showsTheTappedTrackWithoutLoadingIt() {
1684
+ let (c, eh, _, _) = makeCoordinator()
1685
+ let tapped = Track(id: "tapped", src: "https://example.com/tapped.mp3", title: "Tapped")
1686
+
1687
+ c.previewNowPlaying(tapped)
1688
+
1689
+ #expect(eh.loadNowPlayingMetadataCalls.map(\.id) == ["tapped"])
1690
+ #expect(eh.resolveAndLoadCalls.isEmpty)
1691
+ #expect(c.currentTrack == nil)
1692
+ }
1693
+
1694
+ @Test @MainActor
1695
+ func endingPreview_restoresTheCurrentTrackAndRendersItsLines() throws {
1696
+ let (c, eh, _, _) = makeCoordinator()
1697
+ try loadTrack(c, id: "current")
1698
+ c.previewNowPlaying(Track(id: "tapped", src: "https://example.com/tapped.mp3", title: "Tapped"))
1699
+ let rendersBefore = eh.nowPlayingRenderCount
1700
+
1701
+ c.endNowPlayingPreview()
1702
+
1703
+ #expect(eh.loadNowPlayingMetadataCalls.last?.id == "current")
1704
+ #expect(eh.nowPlayingRenderCount == rendersBefore + 1)
1705
+ #expect(eh.clearNowPlayingCallCount == 0)
1706
+ }
1707
+
1708
+ @Test @MainActor
1709
+ func endingPreview_withNothingCurrent_clearsTheSurface() {
1710
+ let (c, eh, _, _) = makeCoordinator()
1711
+ c.previewNowPlaying(Track(id: "tapped", src: "https://example.com/tapped.mp3", title: "Tapped"))
1712
+
1713
+ c.endNowPlayingPreview()
1714
+
1715
+ #expect(eh.clearNowPlayingCallCount == 1)
1716
+ #expect(eh.loadNowPlayingMetadataCalls.map(\.id) == ["tapped"])
1717
+ #expect(eh.nowPlayingRenderCount == 0)
1718
+ }
1719
+ }