react-native-audio-browser 0.2.0-next.5 → 0.2.0-next.51

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 (1092) hide show
  1. package/README.md +37 -23
  2. package/android/build.gradle +58 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +215 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +546 -283
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +38 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +18 -2
  9. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +131 -0
  10. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +165 -0
  11. package/android/src/main/java/com/audiobrowser/Service.kt +41 -11
  12. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  13. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +23 -10
  14. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  15. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  16. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  17. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  18. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  19. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  20. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  21. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  22. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  23. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  24. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  25. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  26. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  27. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +16 -0
  28. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +1 -1
  29. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  30. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  31. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +4 -1
  32. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  33. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  34. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +639 -278
  35. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +85 -33
  36. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +88 -44
  37. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  38. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  39. package/android/src/main/java/com/audiobrowser/player/Player.kt +333 -186
  40. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  41. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  42. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +33 -16
  43. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  44. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  45. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +10 -13
  46. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +64 -0
  47. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +98 -0
  48. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  49. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +110 -0
  50. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +696 -0
  51. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +113 -0
  52. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  53. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  54. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +92 -0
  55. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +105 -0
  56. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  57. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  58. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +550 -0
  59. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +99 -0
  60. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +201 -0
  61. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  62. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +66 -0
  63. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  64. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +63 -0
  65. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +63 -0
  66. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +68 -0
  67. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  68. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  69. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  70. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  71. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  72. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  73. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  74. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +15 -0
  75. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +61 -40
  76. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  77. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +5 -1
  78. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +24 -49
  79. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +23 -1
  80. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  81. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +2 -2
  82. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  83. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +103 -67
  84. package/android/src/main/res/values/strings.xml +25 -5
  85. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +18 -0
  86. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  87. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  88. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  89. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  90. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +159 -0
  91. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  92. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  93. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  94. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  95. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  96. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  97. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  98. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  99. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  100. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  101. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  102. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  103. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  104. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  105. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +477 -0
  106. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +1 -2
  107. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  108. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -0
  109. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  110. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +138 -0
  111. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  112. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +212 -2
  113. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  114. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  115. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  116. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +136 -0
  117. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +67 -0
  118. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  119. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +213 -0
  120. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +192 -0
  121. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  122. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  123. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +151 -0
  124. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +275 -0
  125. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  126. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  127. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  128. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +815 -0
  129. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +203 -0
  130. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +90 -0
  131. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +73 -0
  132. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +135 -0
  133. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +170 -0
  134. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +174 -0
  135. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +691 -0
  136. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  137. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +165 -0
  138. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  139. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +204 -0
  140. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +99 -0
  141. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  142. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  143. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  144. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  145. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  146. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  147. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  148. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  149. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  150. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  151. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  152. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  153. package/android/src/test/resources/sonos/device_description.xml +78 -0
  154. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  155. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +79 -0
  156. package/ios/AVPlayerEngine.swift +362 -0
  157. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  158. package/ios/Browser/BrowseGate.swift +58 -0
  159. package/ios/Browser/BrowserConfig.swift +115 -81
  160. package/ios/Browser/BrowserError.swift +16 -0
  161. package/ios/Browser/BrowserManager.swift +155 -654
  162. package/ios/Browser/BrowserPathHelper.swift +68 -51
  163. package/ios/Browser/FavoriteSet.swift +46 -0
  164. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  165. package/ios/Browser/JsonModels.swift +270 -321
  166. package/ios/Browser/NavigationErrorState.swift +41 -0
  167. package/ios/Browser/PageResolver.swift +147 -0
  168. package/ios/Browser/RequestLayer.swift +185 -0
  169. package/ios/Browser/RequestPipeline.swift +303 -0
  170. package/ios/Browser/SearchDrillIn.swift +7 -7
  171. package/ios/Browser/SectionScope.swift +82 -23
  172. package/ios/Browser/SimpleRouter.swift +73 -144
  173. package/ios/Browser/StyleResolver.swift +58 -0
  174. package/ios/Browser/TabBarEntries.swift +9 -3
  175. package/ios/Browser/TrackIdTemplate.swift +37 -0
  176. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  177. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  178. package/ios/CarPlay/CarPlayController.swift +37 -1297
  179. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  180. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  181. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  182. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  183. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  184. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  185. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  186. package/ios/CarPlay/CarPlaySession.swift +207 -0
  187. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  188. package/ios/CarPlay/IntentHandlers.swift +96 -0
  189. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  190. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  191. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  192. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  193. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  194. package/ios/CarPlay/SectionPresentation.swift +77 -0
  195. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  196. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  197. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  198. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  199. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  200. package/ios/Extension/SearchParams+Query.swift +28 -0
  201. package/ios/Extension/Section+Copying.swift +29 -0
  202. package/ios/Extension/String+IcyCharset.swift +21 -0
  203. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  204. package/ios/Extension/Track+AVPlayer.swift +0 -16
  205. package/ios/Extension/Track+Copying.swift +11 -13
  206. package/ios/Extension/Track+Identity.swift +25 -0
  207. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  208. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  209. package/ios/Extension/URLError+Connectivity.swift +15 -0
  210. package/ios/Http/HttpClient.swift +71 -165
  211. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  212. package/ios/HybridAudioBrowser+Options.swift +105 -0
  213. package/ios/HybridAudioBrowser+Player.swift +341 -0
  214. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  215. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  216. package/ios/HybridAudioBrowser.swift +131 -1652
  217. package/ios/Model/NitroTypeStubs.swift +239 -24
  218. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  219. package/ios/Model/RemoteCommand.swift +6 -60
  220. package/ios/Model/TrackPlayerError.swift +6 -2
  221. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  222. package/ios/Observer/ItemObserver.swift +90 -0
  223. package/ios/Observer/PlayerObserver.swift +59 -0
  224. package/ios/Option/SessionCategories.swift +42 -92
  225. package/ios/Player/AudioSessionController.swift +191 -0
  226. package/ios/Player/DeferredSeek.swift +70 -0
  227. package/ios/Player/ErrorStatus.swift +50 -0
  228. package/ios/Player/MediaLoader.swift +66 -87
  229. package/ios/Player/NowPlayingLines.swift +52 -0
  230. package/ios/Player/NowPlayingUpdater.swift +182 -85
  231. package/ios/Player/PlaybackFailure.swift +125 -0
  232. package/ios/Player/PlaybackPersistence.swift +73 -0
  233. package/ios/Player/PlaybackTimer.swift +8 -2
  234. package/ios/Player/Player.swift +975 -0
  235. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  236. package/ios/Player/PlayerEngine.swift +104 -0
  237. package/ios/Player/PlayerStatusTypes.swift +2 -6
  238. package/ios/Player/QueueManager.swift +93 -67
  239. package/ios/Player/RetryLoop.swift +291 -0
  240. package/ios/Player/ShuffleOrder.swift +33 -0
  241. package/ios/Player/SleepTimerManager.swift +14 -16
  242. package/ios/Player/VolumeFader.swift +5 -0
  243. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  244. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  245. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  246. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  247. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  248. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  249. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  250. package/ios/Tests/DeferredSeekTests.swift +70 -0
  251. package/ios/Tests/EmitterTests.swift +22 -38
  252. package/ios/Tests/ErrorStatusTests.swift +50 -0
  253. package/ios/Tests/FavoriteSetTests.swift +60 -0
  254. package/ios/Tests/GenerationMemoTests.swift +121 -0
  255. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  256. package/ios/Tests/JsonModelsTests.swift +194 -1
  257. package/ios/Tests/LRUCacheTests.swift +110 -0
  258. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  259. package/ios/Tests/MediaLoaderTests.swift +36 -67
  260. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  261. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  262. package/ios/Tests/ObserverTests.swift +88 -0
  263. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  264. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  265. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  266. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  267. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  268. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +573 -395
  269. package/ios/Tests/PlayingStateTests.swift +42 -0
  270. package/ios/Tests/QueueManagerTests.swift +196 -115
  271. package/ios/Tests/ReadyValueTests.swift +73 -0
  272. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  273. package/ios/Tests/RequestLayerTests.swift +228 -0
  274. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  275. package/ios/Tests/RetryLoopTests.swift +305 -0
  276. package/ios/Tests/SearchDrillInTests.swift +16 -16
  277. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  278. package/ios/Tests/SectionPresentationTests.swift +98 -0
  279. package/ios/Tests/SectionScopeTests.swift +139 -54
  280. package/ios/Tests/SimpleRouterTests.swift +38 -3
  281. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  282. package/ios/Tests/StyleResolverTests.swift +132 -0
  283. package/ios/Tests/Support/TestTypes.swift +146 -101
  284. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  285. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  286. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  287. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  288. package/ios/Tests/TrackIdentityTests.swift +20 -0
  289. package/ios/Tests/TrackSelectorTests.swift +168 -33
  290. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  291. package/ios/TrackSelector.swift +62 -65
  292. package/ios/Util/ArtworkFreshness.swift +42 -0
  293. package/ios/Util/ArtworkImageFetcher.swift +143 -5
  294. package/ios/Util/ConcurrentMap.swift +19 -0
  295. package/ios/Util/Emitter.swift +40 -12
  296. package/ios/Util/GenerationMemo.swift +36 -0
  297. package/ios/Util/LRUCache.swift +23 -159
  298. package/ios/Util/NetworkMonitor.swift +32 -32
  299. package/ios/Util/OutputPicker.swift +48 -0
  300. package/ios/Util/ReadyValue.swift +56 -0
  301. package/ios/Util/SFSymbolRenderer.swift +59 -31
  302. package/ios/Util/SVGProcessor.swift +9 -12
  303. package/lib/commonjs/AudioBrowser.js +8 -8
  304. package/lib/commonjs/AudioBrowser.js.map +1 -1
  305. package/lib/commonjs/CLAUDE.md +52 -0
  306. package/lib/commonjs/features/browser-config.js +12 -8
  307. package/lib/commonjs/features/browser-config.js.map +1 -1
  308. package/lib/commonjs/features/browser.js +11 -3
  309. package/lib/commonjs/features/browser.js.map +1 -1
  310. package/lib/commonjs/features/carConnection.js +1 -1
  311. package/lib/commonjs/features/equalizer.js +1 -1
  312. package/lib/commonjs/features/errors.js +3 -3
  313. package/lib/commonjs/features/favorites.js +14 -11
  314. package/lib/commonjs/features/favorites.js.map +1 -1
  315. package/lib/commonjs/features/gate.js +16 -1
  316. package/lib/commonjs/features/gate.js.map +1 -1
  317. package/lib/commonjs/features/metadata.js +20 -3
  318. package/lib/commonjs/features/metadata.js.map +1 -1
  319. package/lib/commonjs/features/network.js +1 -1
  320. package/lib/commonjs/features/nowPlaying.js +1 -1
  321. package/lib/commonjs/features/output.js +4 -3
  322. package/lib/commonjs/features/output.js.map +1 -1
  323. package/lib/commonjs/features/playback/controls.js +4 -2
  324. package/lib/commonjs/features/playback/controls.js.map +1 -1
  325. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  326. package/lib/commonjs/features/playback/playing.js +1 -1
  327. package/lib/commonjs/features/playback/progress.js +3 -2
  328. package/lib/commonjs/features/playback/progress.js.map +1 -1
  329. package/lib/commonjs/features/playback/rate.js +8 -1
  330. package/lib/commonjs/features/playback/rate.js.map +1 -1
  331. package/lib/commonjs/features/playback/state.js +3 -4
  332. package/lib/commonjs/features/playback/state.js.map +1 -1
  333. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  334. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  335. package/lib/commonjs/features/playback/volume.js +1 -1
  336. package/lib/commonjs/features/player/options.js +3 -19
  337. package/lib/commonjs/features/player/options.js.map +1 -1
  338. package/lib/commonjs/features/player/setup.js +7 -3
  339. package/lib/commonjs/features/player/setup.js.map +1 -1
  340. package/lib/commonjs/features/player/validateOptions.js +23 -0
  341. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  342. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  343. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  344. package/lib/commonjs/features/queue/queue.js +13 -6
  345. package/lib/commonjs/features/queue/queue.js.map +1 -1
  346. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  347. package/lib/commonjs/features/queue/shuffle.js +1 -1
  348. package/lib/commonjs/features/remoteControls.js +13 -92
  349. package/lib/commonjs/features/remoteControls.js.map +1 -1
  350. package/lib/commonjs/features/sleepTimer.js +13 -1
  351. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  352. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  353. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  354. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  355. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  356. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  357. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  358. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  359. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  360. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  361. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  362. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  363. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  364. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  365. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  366. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  367. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  368. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  369. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  370. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  371. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  372. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  373. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  374. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  375. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  376. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  377. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  378. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  379. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  380. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  381. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  382. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  383. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  384. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  385. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  386. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  387. package/lib/commonjs/web/browser/sections.js +89 -0
  388. package/lib/commonjs/web/browser/sections.js.map +1 -0
  389. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  390. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  391. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  392. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  393. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  394. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  395. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  396. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  397. package/lib/module/AudioBrowser.js +2 -1
  398. package/lib/module/AudioBrowser.js.map +1 -1
  399. package/lib/module/CLAUDE.md +52 -0
  400. package/lib/module/features/browser-config.js +12 -8
  401. package/lib/module/features/browser-config.js.map +1 -1
  402. package/lib/module/features/browser.js +11 -3
  403. package/lib/module/features/browser.js.map +1 -1
  404. package/lib/module/features/carConnection.js +1 -1
  405. package/lib/module/features/equalizer.js +1 -1
  406. package/lib/module/features/errors.js +3 -3
  407. package/lib/module/features/favorites.js +14 -11
  408. package/lib/module/features/favorites.js.map +1 -1
  409. package/lib/module/features/gate.js +16 -1
  410. package/lib/module/features/gate.js.map +1 -1
  411. package/lib/module/features/metadata.js +20 -3
  412. package/lib/module/features/metadata.js.map +1 -1
  413. package/lib/module/features/network.js +1 -1
  414. package/lib/module/features/nowPlaying.js +1 -1
  415. package/lib/module/features/output.js +4 -3
  416. package/lib/module/features/output.js.map +1 -1
  417. package/lib/module/features/playback/controls.js +4 -2
  418. package/lib/module/features/playback/controls.js.map +1 -1
  419. package/lib/module/features/playback/playWhenReady.js +1 -1
  420. package/lib/module/features/playback/playing.js +1 -1
  421. package/lib/module/features/playback/progress.js +3 -2
  422. package/lib/module/features/playback/progress.js.map +1 -1
  423. package/lib/module/features/playback/rate.js +8 -1
  424. package/lib/module/features/playback/rate.js.map +1 -1
  425. package/lib/module/features/playback/state.js +3 -4
  426. package/lib/module/features/playback/state.js.map +1 -1
  427. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  428. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  429. package/lib/module/features/playback/volume.js +1 -1
  430. package/lib/module/features/player/options.js +2 -17
  431. package/lib/module/features/player/options.js.map +1 -1
  432. package/lib/module/features/player/setup.js +6 -2
  433. package/lib/module/features/player/setup.js.map +1 -1
  434. package/lib/module/features/player/validateOptions.js +19 -0
  435. package/lib/module/features/player/validateOptions.js.map +1 -0
  436. package/lib/module/features/queue/activeTrack.js +15 -4
  437. package/lib/module/features/queue/activeTrack.js.map +1 -1
  438. package/lib/module/features/queue/queue.js +13 -6
  439. package/lib/module/features/queue/queue.js.map +1 -1
  440. package/lib/module/features/queue/repeatMode.js +1 -1
  441. package/lib/module/features/queue/shuffle.js +1 -1
  442. package/lib/module/features/remoteControls.js +13 -92
  443. package/lib/module/features/remoteControls.js.map +1 -1
  444. package/lib/module/features/sleepTimer.js +13 -1
  445. package/lib/module/features/sleepTimer.js.map +1 -1
  446. package/lib/module/test-utils/reactNativeStub.js +58 -0
  447. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  448. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  449. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  450. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  451. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  452. package/lib/module/utils/getTrackIdentity.js +20 -0
  453. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  454. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  455. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  456. package/lib/module/web/NativeAudioBrowser.js +202 -77
  457. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  458. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  459. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  460. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  461. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  462. package/lib/module/web/TrackPlayer/Player.js +254 -39
  463. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  464. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  465. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  466. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  467. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  468. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  469. package/lib/module/web/browser/BrowserManager.js +175 -100
  470. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  471. package/lib/module/web/browser/FavoriteManager.js +31 -21
  472. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  473. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  474. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  475. package/lib/module/web/browser/SearchManager.js +18 -23
  476. package/lib/module/web/browser/SearchManager.js.map +1 -1
  477. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  478. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  479. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  480. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  481. package/lib/module/web/browser/sections.js +83 -0
  482. package/lib/module/web/browser/sections.js.map +1 -0
  483. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  484. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  485. package/lib/module/web/http/followMediaRedirect.js +215 -0
  486. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  487. package/lib/module/web/player/NowPlayingManager.js +4 -3
  488. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  489. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  490. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  491. package/lib/typescript/package.json +1 -0
  492. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  493. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  494. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  495. package/lib/typescript/src/features/browser.d.ts +10 -2
  496. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  497. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  498. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  499. package/lib/typescript/src/features/errors.d.ts +3 -3
  500. package/lib/typescript/src/features/favorites.d.ts +14 -11
  501. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  502. package/lib/typescript/src/features/gate.d.ts +18 -2
  503. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  504. package/lib/typescript/src/features/metadata.d.ts +20 -3
  505. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  506. package/lib/typescript/src/features/network.d.ts +1 -1
  507. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  508. package/lib/typescript/src/features/output.d.ts +4 -3
  509. package/lib/typescript/src/features/output.d.ts.map +1 -1
  510. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  511. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  512. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  513. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  514. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  515. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  516. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  517. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  518. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  519. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  520. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  521. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  522. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  523. package/lib/typescript/src/features/player/options.d.ts +24 -21
  524. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  525. package/lib/typescript/src/features/player/setup.d.ts +46 -1
  526. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  527. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  528. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  529. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  530. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  531. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  532. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  533. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  534. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  535. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  536. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  537. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  538. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  539. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  540. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  541. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  542. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  543. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  544. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  545. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  546. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  547. package/lib/typescript/src/types/browser.d.ts +93 -61
  548. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  549. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  550. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  551. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  552. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  553. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  554. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  555. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  556. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  557. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  558. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  559. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  560. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  561. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  564. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  565. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  566. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  567. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  568. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  572. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  573. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  574. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  575. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  576. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  577. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  578. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  579. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  581. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  582. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  583. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  584. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  585. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  586. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  587. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  588. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  589. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  590. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  591. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  592. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  593. 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
  594. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  595. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  596. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  597. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  598. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  599. 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
  600. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  602. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  605. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  607. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  608. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  609. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  610. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  611. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  612. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  613. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  616. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  619. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  621. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  622. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  623. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  625. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  626. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  627. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  628. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  630. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  631. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  632. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  633. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  634. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  635. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  637. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  638. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  639. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  640. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +72 -44
  641. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  642. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  643. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  644. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  645. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  646. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  647. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  648. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  649. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  650. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  651. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  652. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  653. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  654. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  655. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  656. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  657. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  658. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  659. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  660. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  661. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  662. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  663. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  664. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  665. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  666. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  667. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  668. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  669. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  670. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  671. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  672. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  673. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  674. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  675. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  676. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  677. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  678. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  679. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  680. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  681. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  682. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  683. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  684. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  686. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  687. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  689. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  690. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  691. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  692. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  694. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  695. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  696. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  697. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  698. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  699. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  700. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  701. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  702. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  703. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  704. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  705. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  707. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  709. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  710. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  711. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  712. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  713. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  715. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  716. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  717. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  718. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  719. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  739. 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
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  746. 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
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  749. 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
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  752. 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
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  782. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  783. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  784. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  785. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  786. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  787. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  788. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  789. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  790. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  791. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  792. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  793. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  794. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  795. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  796. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  797. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  798. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  799. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  800. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  801. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  802. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  803. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  804. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  805. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  806. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  807. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  808. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  809. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  810. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  811. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  812. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  813. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  814. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  815. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  816. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  817. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  818. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  819. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  820. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  821. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  822. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  823. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  824. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  825. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  826. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  827. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  828. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  829. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  830. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  831. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  832. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  833. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  834. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  835. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  836. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  837. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  838. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  839. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  840. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  841. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  842. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  852. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  858. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  859. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  860. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +788 -641
  861. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  862. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +33 -12
  863. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  864. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  865. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  866. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  867. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  868. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  869. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  870. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  871. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  872. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  873. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  874. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  875. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  876. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  877. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  878. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  879. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  880. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  881. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  882. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  883. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  884. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  885. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  886. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  887. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  888. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  889. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  890. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  891. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  892. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  893. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  894. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  895. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  896. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  897. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  898. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  899. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  900. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  901. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  902. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  903. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  904. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  905. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  906. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  907. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  908. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  909. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  910. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  911. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  912. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  913. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  914. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  915. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  916. package/package.json +24 -11
  917. package/src/AudioBrowser.ts +2 -1
  918. package/src/CLAUDE.md +52 -0
  919. package/src/features/battery.test.ts +79 -0
  920. package/src/features/browser-config.test.ts +21 -6
  921. package/src/features/browser-config.ts +12 -8
  922. package/src/features/browser.test.ts +1 -1
  923. package/src/features/browser.ts +11 -3
  924. package/src/features/carConnection.ts +1 -1
  925. package/src/features/equalizer.ts +1 -1
  926. package/src/features/errors.ts +3 -3
  927. package/src/features/favorites.ts +14 -11
  928. package/src/features/gate.ts +16 -1
  929. package/src/features/hook-wiring.test.ts +302 -0
  930. package/src/features/metadata.ts +20 -3
  931. package/src/features/network.ts +1 -1
  932. package/src/features/nowPlaying.ts +1 -1
  933. package/src/features/output.ts +4 -3
  934. package/src/features/playback/controls.ts +4 -2
  935. package/src/features/playback/playWhenReady.ts +1 -1
  936. package/src/features/playback/playing.ts +1 -1
  937. package/src/features/playback/progress.test.ts +169 -0
  938. package/src/features/playback/progress.ts +3 -2
  939. package/src/features/playback/rate.ts +8 -1
  940. package/src/features/playback/state.ts +3 -4
  941. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  942. package/src/features/playback/trackPlaybackTime.ts +1 -6
  943. package/src/features/playback/volume.ts +1 -1
  944. package/src/features/player/options.ts +31 -40
  945. package/src/features/player/setup.test.ts +12 -3
  946. package/src/features/player/setup.ts +58 -5
  947. package/src/features/player/validateOptions.ts +21 -0
  948. package/src/features/queue/activeTrack.ts +15 -4
  949. package/src/features/queue/queue.ts +13 -6
  950. package/src/features/queue/repeatMode.ts +1 -1
  951. package/src/features/queue/shuffle.ts +1 -1
  952. package/src/features/remoteControls.ts +13 -92
  953. package/src/features/sleepTimer.test.ts +172 -0
  954. package/src/features/sleepTimer.ts +9 -1
  955. package/src/nitro-stub-drift.test.ts +277 -0
  956. package/src/public-surface.test.ts +147 -0
  957. package/src/specs/audio-browser.nitro.ts +10 -8
  958. package/src/style-resolution.test.ts +210 -0
  959. package/src/test-utils/reactNativeStub.ts +60 -0
  960. package/src/types/browser-native.ts +7 -3
  961. package/src/types/browser-nodes.ts +403 -134
  962. package/src/types/browser.ts +97 -63
  963. package/src/utils/LazyNativeEmitter.ts +28 -15
  964. package/src/utils/NativeUpdatedValue.ts +29 -13
  965. package/src/utils/getTrackIdentity.ts +20 -0
  966. package/src/utils/useDebug.test.ts +182 -0
  967. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  968. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  969. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  970. package/src/web/NativeAudioBrowser.ts +241 -84
  971. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  972. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  973. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  974. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  975. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  976. package/src/web/TrackPlayer/Player.ts +284 -37
  977. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  978. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  979. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  980. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  981. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  982. package/src/web/__tests__/lifecycle.test.ts +345 -0
  983. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  984. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  985. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  986. package/src/web/__tests__/retry.test.ts +169 -0
  987. package/src/web/browser/BrowserManager.ts +209 -111
  988. package/src/web/browser/FavoriteManager.test.ts +84 -0
  989. package/src/web/browser/FavoriteManager.ts +28 -23
  990. package/src/web/browser/NavigationErrorManager.ts +3 -1
  991. package/src/web/browser/SearchManager.test.ts +75 -0
  992. package/src/web/browser/SearchManager.ts +25 -28
  993. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  994. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  995. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  996. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  997. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  998. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  999. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1000. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1001. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1002. package/src/web/browser/sections.test.ts +91 -0
  1003. package/src/web/browser/sections.ts +72 -0
  1004. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1005. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1006. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1007. package/src/web/http/followMediaRedirect.ts +253 -0
  1008. package/src/web/player/NowPlayingManager.ts +4 -3
  1009. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1010. package/src/web/util/BrowserPathHelper.ts +70 -13
  1011. package/website/guide/android-auto.md +114 -0
  1012. package/website/guide/android-certificates.md +409 -0
  1013. package/website/guide/artwork.md +255 -0
  1014. package/website/guide/audio-output.md +339 -0
  1015. package/website/guide/automotive.md +86 -0
  1016. package/website/guide/basic-usage.md +151 -0
  1017. package/website/guide/battery.md +115 -0
  1018. package/website/guide/browser.md +587 -0
  1019. package/website/guide/carplay.md +650 -0
  1020. package/website/guide/configuration.md +179 -0
  1021. package/website/guide/equalizer.md +231 -0
  1022. package/website/guide/errors.md +310 -0
  1023. package/website/guide/favorites.md +154 -0
  1024. package/website/guide/gate.md +143 -0
  1025. package/website/guide/getting-started.md +46 -0
  1026. package/website/guide/hooks.md +238 -0
  1027. package/website/guide/live-streams.md +125 -0
  1028. package/website/guide/metadata.md +239 -0
  1029. package/website/guide/migrating-from-track-player.md +244 -0
  1030. package/website/guide/native-callback-fetch.md +127 -0
  1031. package/website/guide/network.md +86 -0
  1032. package/website/guide/now-playing.md +175 -0
  1033. package/website/guide/playback.md +328 -0
  1034. package/website/guide/queue.md +300 -0
  1035. package/website/guide/remote-controls.md +256 -0
  1036. package/website/guide/search.md +255 -0
  1037. package/website/guide/sleep-timer.md +268 -0
  1038. package/website/guide/track.md +247 -0
  1039. package/ios/Bridge.h +0 -8
  1040. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1041. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1042. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1043. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1044. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1045. package/ios/Model/MediaURL.swift +0 -67
  1046. package/ios/Model/SourceType.swift +0 -6
  1047. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1048. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1049. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1050. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1051. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1052. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1053. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1054. package/ios/Option/PitchAlgorithms.swift +0 -17
  1055. package/ios/Option/TimeEventFrequency.swift +0 -18
  1056. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1057. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1058. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1059. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1060. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1061. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1062. package/ios/Player/PlaybackStateStore.swift +0 -27
  1063. package/ios/Player/PlayingStateManager.swift +0 -33
  1064. package/ios/Player/RetryManager.swift +0 -322
  1065. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1066. package/ios/Player/SleepTimerHandling.swift +0 -15
  1067. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1068. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1069. package/ios/Tests/MediaResolveTests.swift +0 -126
  1070. package/ios/Tests/OnceValueTests.swift +0 -79
  1071. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1072. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1073. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1074. package/ios/Tests/RetryManagerTests.swift +0 -89
  1075. package/ios/TrackPlayer.swift +0 -1014
  1076. package/ios/TrackPlayerCallbacks.swift +0 -86
  1077. package/ios/Util/MetadataAdapter.swift +0 -131
  1078. package/ios/Util/OnceValue.swift +0 -104
  1079. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1080. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1081. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1082. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1083. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1084. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1085. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1086. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1087. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1088. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1089. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1090. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1091. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1092. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -2,46 +2,43 @@
2
2
  import Foundation
3
3
  import Testing
4
4
 
5
- /// Helper to build a coordinator with mocks for testing.
5
+ /// Helper to build a player with mocks for testing.
6
6
  @MainActor
7
7
  private func makeCoordinator() -> (
8
- coordinator: PlaybackCoordinator,
9
- effectHandler: MockPlaybackEffectHandler,
10
- callbacks: MockPlaybackCoordinatorCallbacks,
11
- sleepTimer: MockSleepTimerHandling,
8
+ player: Player,
9
+ engine: MockPlayerEngine,
10
+ callbacks: MockPlayerCallbacks,
11
+ clock: ManualSleepTimerScheduler,
12
12
  ) {
13
- let retryHandler = MockRetryHandling()
14
- let errorHandler = PlaybackErrorHandler(retryHandler: retryHandler)
15
- let sleepTimer = MockSleepTimerHandling()
16
- let coordinator = PlaybackCoordinator(errorHandler: errorHandler, sleepTimerManager: sleepTimer)
17
- let effectHandler = MockPlaybackEffectHandler()
18
- let callbacks = MockPlaybackCoordinatorCallbacks()
19
- coordinator.effectHandler = effectHandler
20
- coordinator.callbacks = callbacks
21
- return (coordinator, effectHandler, callbacks, sleepTimer)
13
+ let clock = ManualSleepTimerScheduler()
14
+ let engine = MockPlayerEngine()
15
+ let player = makePlayer(engine: engine, retries: false, sleepTimerScheduler: clock)
16
+ let callbacks = MockPlayerCallbacks()
17
+ player.callbacks = callbacks
18
+ return (player, engine, callbacks, clock)
22
19
  }
23
20
 
24
- /// Helper to load a track into the coordinator's queue so it has a currentTrack.
21
+ /// Helper to load a track into the player's queue so it has a currentTrack.
25
22
  @MainActor
26
23
  private func loadTrack(
27
- _ coordinator: PlaybackCoordinator,
24
+ _ player: Player,
28
25
  id: String = "t1",
29
26
  src: String? = "https://example.com/audio.mp3",
30
27
  title: String = "Test Track",
31
- ) {
28
+ ) throws {
32
29
  let track = Track(id: id, src: src, title: title)
33
- coordinator.setQueue([track])
30
+ try player.setQueue([track])
34
31
  }
35
32
 
36
33
  // MARK: - Transition + Side Effects
37
34
 
38
- @Suite("PlaybackCoordinator - transition + side effects")
35
+ @Suite("Player - transition + side effects")
39
36
  struct TransitionTests {
40
37
  @Test @MainActor
41
- func toReady_startsPlayback_whenPlayWhenReady() {
38
+ func toReady_startsPlayback_whenPlayWhenReady() throws {
42
39
  let (c, eh, _, _) = makeCoordinator()
43
- loadTrack(c)
44
- c.playWhenReady = true
40
+ try loadTrack(c)
41
+ c.setPlayWhenReady(true)
45
42
  eh.startPlaybackCallCount = 0 // reset from playWhenReady setter
46
43
 
47
44
  c.transition(.bufferingSufficient)
@@ -51,9 +48,9 @@ struct TransitionTests {
51
48
  }
52
49
 
53
50
  @Test @MainActor
54
- func toReady_doesNotStart_whenNotPlayWhenReady() {
51
+ func toReady_doesNotStart_whenNotPlayWhenReady() throws {
55
52
  let (c, eh, _, _) = makeCoordinator()
56
- loadTrack(c)
53
+ try loadTrack(c)
57
54
  c.transition(.bufferingSufficient)
58
55
 
59
56
  #expect(c.state == .ready)
@@ -77,19 +74,19 @@ struct TransitionTests {
77
74
  c.transition(.errorOccurred(.playbackFailed))
78
75
 
79
76
  #expect(c.state == .error)
80
- #expect(c.playbackError == .playbackFailed)
77
+ #expect(c.errorStatus.error == .playbackFailed)
81
78
  }
82
79
 
83
80
  @Test @MainActor
84
81
  func leavingError_clearsPlaybackError() {
85
82
  let (c, _, _, _) = makeCoordinator()
86
83
  c.transition(.errorOccurred(.playbackFailed))
87
- #expect(c.playbackError == .playbackFailed)
84
+ #expect(c.errorStatus.error == .playbackFailed)
88
85
 
89
86
  c.transition(.trackLoading)
90
87
 
91
88
  #expect(c.state == .loading)
92
- #expect(c.playbackError == nil)
89
+ #expect(c.errorStatus.error == nil)
93
90
  }
94
91
 
95
92
  @Test @MainActor
@@ -103,7 +100,7 @@ struct TransitionTests {
103
100
 
104
101
  // State stays .error but error is updated
105
102
  #expect(c.state == .error)
106
- #expect(c.playbackError == .notConnectedToInternet)
103
+ #expect(c.errorStatus.error == .notConnectedToInternet)
107
104
  #expect(cb.playbackChanges.count == 1)
108
105
  #expect(cb.errorEvents.count == 1)
109
106
  }
@@ -114,29 +111,21 @@ struct TransitionTests {
114
111
  /// Advisory errors from the retry loop: attached to the current non-terminal
115
112
  /// state via `playerDidChangePlayback`, never a state transition and never a
116
113
  /// `playerDidError`.
117
- /// Builds a coordinator whose retry handler will accept the error and
118
- /// pretend the (instant) retry succeeded, so only the advisory path runs.
119
- /// The effect handler is returned solely to keep the weak reference alive.
114
+ /// Builds a player whose retries reload at once, so the advisory path is what shows.
120
115
  @MainActor
121
116
  private func makeRetrying() -> (
122
- PlaybackCoordinator, MockRetryHandling, MockPlaybackCoordinatorCallbacks,
123
- MockPlaybackEffectHandler
117
+ Player, RetryLoop, MockPlayerCallbacks,
118
+ MockPlayerEngine,
124
119
  ) {
125
- let retryHandler = MockRetryHandling()
126
- retryHandler.isRetryableResult = true
127
- retryHandler.attemptRetryResult = true
128
- let errorHandler = PlaybackErrorHandler(retryHandler: retryHandler)
129
- let coordinator = PlaybackCoordinator(
130
- errorHandler: errorHandler, sleepTimerManager: MockSleepTimerHandling(),
131
- )
132
- let effectHandler = MockPlaybackEffectHandler()
133
- coordinator.effectHandler = effectHandler
134
- let callbacks = MockPlaybackCoordinatorCallbacks()
135
- coordinator.callbacks = callbacks
136
- return (coordinator, retryHandler, callbacks, effectHandler)
120
+ let retryHandler = makeRetryLoop()
121
+ let engine = MockPlayerEngine()
122
+ let player = makePlayer(engine: engine, retry: retryHandler)
123
+ let callbacks = MockPlayerCallbacks()
124
+ player.callbacks = callbacks
125
+ return (player, retryHandler, callbacks, engine)
137
126
  }
138
127
 
139
- @Suite("PlaybackCoordinator - retrying errors")
128
+ @Suite("Player - retrying errors")
140
129
  struct RetryingErrorTests {
141
130
  @Test @MainActor
142
131
  func retryingError_attachesToCurrentState() async {
@@ -144,16 +133,16 @@ struct RetryingErrorTests {
144
133
  c.transition(.trackLoading)
145
134
  cb.playbackChanges.removeAll()
146
135
 
147
- c.errorHandler.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
136
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
148
137
 
149
138
  #expect(c.state == .loading)
150
- #expect(c.playbackError == .hostUnreachable)
139
+ #expect(c.errorStatus.error == .hostUnreachable)
151
140
  #expect(cb.playbackChanges.count == 1)
152
141
  #expect(cb.playbackChanges.last?.state == .loading)
153
142
  #expect(cb.playbackChanges.last?.error?.retrying == true)
154
143
  // Advisory, not terminal: the error event is reserved for .error.
155
144
  #expect(cb.errorEvents.isEmpty)
156
- await c.errorHandler.pendingRetryTask?.value
145
+ await c.retry.pendingTask?.value
157
146
  }
158
147
 
159
148
  /// Every failed attempt re-reports through `handleError`; identical repeats
@@ -164,10 +153,10 @@ struct RetryingErrorTests {
164
153
  c.transition(.trackLoading)
165
154
  cb.playbackChanges.removeAll()
166
155
 
167
- c.errorHandler.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
168
- await c.errorHandler.pendingRetryTask?.value
169
- c.errorHandler.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
170
- await c.errorHandler.pendingRetryTask?.value
156
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
157
+ await c.retry.pendingTask?.value
158
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
159
+ await c.retry.pendingTask?.value
171
160
 
172
161
  #expect(cb.playbackChanges.count == 1)
173
162
  }
@@ -180,11 +169,11 @@ struct RetryingErrorTests {
180
169
  c.transition(.avPlayerPlaying)
181
170
  cb.playbackChanges.removeAll()
182
171
 
183
- c.errorHandler.handleError(URLError(.cannotConnectToHost), context: .playback)
172
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .playback)
184
173
 
185
- #expect(c.playbackError == nil)
174
+ #expect(c.errorStatus.error == nil)
186
175
  #expect(cb.playbackChanges.isEmpty)
187
- await c.errorHandler.pendingRetryTask?.value
176
+ await c.retry.pendingTask?.value
188
177
  }
189
178
 
190
179
  /// Reaching .ready proves the retry recovered: the advisory error must not
@@ -193,13 +182,13 @@ struct RetryingErrorTests {
193
182
  func recovery_clearsTheRetryingError() async {
194
183
  let (c, _, cb, _) = makeRetrying()
195
184
  c.transition(.trackLoading)
196
- c.errorHandler.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
197
- await c.errorHandler.pendingRetryTask?.value
185
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
186
+ await c.retry.pendingTask?.value
198
187
 
199
188
  c.transition(.loadSeekCompleted)
200
189
 
201
190
  #expect(c.state == .ready)
202
- #expect(c.playbackError == nil)
191
+ #expect(c.errorStatus.error == nil)
203
192
  #expect(cb.playbackChanges.last?.error == nil)
204
193
  }
205
194
 
@@ -209,12 +198,12 @@ struct RetryingErrorTests {
209
198
  func exhaustion_hardensIntoTerminalError() async {
210
199
  let (c, retryHandler, cb, _) = makeRetrying()
211
200
  c.transition(.trackLoading)
212
- c.errorHandler.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
213
- await c.errorHandler.pendingRetryTask?.value
201
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
202
+ await c.retry.pendingTask?.value
214
203
 
215
- retryHandler.attemptRetryResult = false
216
- c.errorHandler.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
217
- await c.errorHandler.pendingRetryTask?.value
204
+ retryHandler.shouldRetry = { false }
205
+ c.retry.handleError(URLError(.cannotConnectToHost), context: .mediaLoad)
206
+ await c.retry.pendingTask?.value
218
207
 
219
208
  #expect(c.state == .error)
220
209
  #expect(cb.playbackChanges.last?.state == .error)
@@ -225,7 +214,7 @@ struct RetryingErrorTests {
225
214
 
226
215
  // MARK: - emitStateChange
227
216
 
228
- @Suite("PlaybackCoordinator - emitStateChange")
217
+ @Suite("Player - emitStateChange")
229
218
  struct EmitStateChangeTests {
230
219
  @Test @MainActor
231
220
  func alwaysEmits_playerDidChangePlayback() {
@@ -259,9 +248,9 @@ struct EmitStateChangeTests {
259
248
  }
260
249
 
261
250
  @Test @MainActor
262
- func emitsQueueEnded_onEndedAndLastTrack() {
251
+ func emitsQueueEnded_onEndedAndLastTrack() throws {
263
252
  let (c, eh, cb, _) = makeCoordinator()
264
- loadTrack(c)
253
+ try loadTrack(c)
265
254
  eh.currentTime = 42
266
255
  cb.queueEndedEvents.removeAll()
267
256
 
@@ -275,7 +264,7 @@ struct EmitStateChangeTests {
275
264
 
276
265
  // MARK: - Observer Guards
277
266
 
278
- @Suite("PlaybackCoordinator - observer guards")
267
+ @Suite("Player - observer guards")
279
268
  struct ObserverGuardTests {
280
269
  @Test @MainActor
281
270
  func timeControlStatus_paused_nearTrackEnd_ignored() {
@@ -286,7 +275,7 @@ struct ObserverGuardTests {
286
275
  eh.currentTime = 99.8
287
276
  eh.duration = 100
288
277
 
289
- c.avPlayerDidChangeTimeControlStatus(.paused)
278
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
290
279
 
291
280
  // State should remain .playing — the pause near track end is ignored
292
281
  #expect(c.state == .playing)
@@ -300,7 +289,7 @@ struct ObserverGuardTests {
300
289
  eh.currentTime = 0
301
290
  eh.duration = 0
302
291
 
303
- c.avPlayerDidChangeTimeControlStatus(.paused)
292
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
304
293
 
305
294
  #expect(c.state == .none)
306
295
  }
@@ -312,9 +301,9 @@ struct ObserverGuardTests {
312
301
  eh.hasLoadedAsset = true
313
302
  eh.currentTime = 10
314
303
  eh.duration = 100
315
- c.playWhenReady = false
304
+ c.setPlayWhenReady(false)
316
305
 
317
- c.avPlayerDidChangeTimeControlStatus(.paused)
306
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
318
307
 
319
308
  #expect(c.state == .paused)
320
309
  }
@@ -326,9 +315,9 @@ struct ObserverGuardTests {
326
315
  eh.hasLoadedAsset = true
327
316
  eh.currentTime = 10
328
317
  eh.duration = 100
329
- c.playWhenReady = true
318
+ c.setPlayWhenReady(true)
330
319
 
331
- c.avPlayerDidChangeTimeControlStatus(.paused)
320
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
332
321
 
333
322
  // playWhenReady is true — pause is ignored (likely buffering/seeking)
334
323
  #expect(c.state == .playing)
@@ -336,11 +325,11 @@ struct ObserverGuardTests {
336
325
 
337
326
  @Test @MainActor
338
327
  func timeControlStatus_ignored_duringLoading() {
339
- let (c, _, cb, _) = makeCoordinator()
328
+ let (c, eh, cb, _) = makeCoordinator()
340
329
  c.transition(.trackLoading)
341
330
  cb.playbackChanges.removeAll()
342
331
 
343
- c.avPlayerDidChangeTimeControlStatus(.paused)
332
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
344
333
 
345
334
  #expect(c.state == .loading)
346
335
  #expect(cb.playbackChanges.isEmpty)
@@ -352,7 +341,7 @@ struct ObserverGuardTests {
352
341
  c.transition(.avPlayerPlaying)
353
342
  eh.hasLoadedAsset = false
354
343
 
355
- c.avPlayerDidChangeTimeControlStatus(.waitingToPlayAtSpecifiedRate)
344
+ eh.emit(.timeControlStatus(.waitingToPlayAtSpecifiedRate, waitingForNoItem: false))
356
345
 
357
346
  #expect(c.state == .playing) // unchanged
358
347
  }
@@ -363,18 +352,18 @@ struct ObserverGuardTests {
363
352
  c.transition(.avPlayerPlaying)
364
353
  eh.hasLoadedAsset = true
365
354
 
366
- c.avPlayerDidChangeTimeControlStatus(.waitingToPlayAtSpecifiedRate)
355
+ eh.emit(.timeControlStatus(.waitingToPlayAtSpecifiedRate, waitingForNoItem: false))
367
356
 
368
357
  #expect(c.state == .buffering)
369
358
  }
370
359
 
371
360
  @Test @MainActor
372
361
  func playbackLikelyToKeepUp_false_ignored() {
373
- let (c, _, cb, _) = makeCoordinator()
362
+ let (c, eh, cb, _) = makeCoordinator()
374
363
  c.transition(.trackLoading)
375
364
  cb.playbackChanges.removeAll()
376
365
 
377
- c.avItemDidUpdatePlaybackLikelyToKeepUp(false)
366
+ eh.emit(.likelyToKeepUp(false))
378
367
 
379
368
  #expect(c.state == .loading)
380
369
  #expect(cb.playbackChanges.isEmpty)
@@ -385,28 +374,29 @@ struct ObserverGuardTests {
385
374
  let (c, eh, _, _) = makeCoordinator()
386
375
  c.transition(.trackLoading)
387
376
  eh.hasLoadedAsset = true
377
+ eh.hasItem = true
388
378
 
389
- c.avItemDidUpdatePlaybackLikelyToKeepUp(true)
379
+ eh.emit(.likelyToKeepUp(true))
390
380
 
391
381
  #expect(c.state == .ready)
392
382
  }
393
383
 
394
384
  @Test @MainActor
395
385
  func audioDidStart_ignored_duringLoading() {
396
- let (c, _, _, _) = makeCoordinator()
386
+ let (c, eh, _, _) = makeCoordinator()
397
387
  c.transition(.trackLoading)
398
388
 
399
- c.audioDidStart()
389
+ eh.emit(.audioDidStart)
400
390
 
401
391
  #expect(c.state == .loading)
402
392
  }
403
393
 
404
394
  @Test @MainActor
405
395
  func audioDidStart_transitionsToPlaying() {
406
- let (c, _, _, _) = makeCoordinator()
396
+ let (c, eh, _, _) = makeCoordinator()
407
397
  c.transition(.bufferingSufficient)
408
398
 
409
- c.audioDidStart()
399
+ eh.emit(.audioDidStart)
410
400
 
411
401
  #expect(c.state == .playing)
412
402
  }
@@ -414,28 +404,39 @@ struct ObserverGuardTests {
414
404
 
415
405
  // MARK: - playWhenReady
416
406
 
417
- @Suite("PlaybackCoordinator - playWhenReady")
407
+ @Suite("Player - playWhenReady")
418
408
  struct PlayWhenReadyTests {
419
409
  @Test @MainActor
420
- func true_fromError_triggersReload() {
410
+ func true_fromError_triggersReload() throws {
421
411
  let (c, eh, _, _) = makeCoordinator()
412
+ try loadTrack(c)
413
+ eh.emit(.itemPrepared(likelyToKeepUp: false))
422
414
  c.transition(.errorOccurred(.playbackFailed))
415
+ eh.resumePosition = 42
416
+ let resolvesBefore = eh.resolveAndLoadCalls.count
423
417
 
424
- c.playWhenReady = true
418
+ c.setPlayWhenReady(true)
425
419
 
426
- #expect(eh.reloadTrackCalls.count == 1)
427
- #expect(eh.reloadTrackCalls.first == true) // startFromCurrentTime for error
420
+ // A restart from .error is a new Load on a new AVPlayer, resuming where it failed.
421
+ #expect(eh.recreateCount == 1)
422
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore + 1)
423
+ #expect(c.state == .loading)
424
+ #expect(c.deferredSeek.target == 42)
428
425
  }
429
426
 
430
427
  @Test @MainActor
431
- func true_fromStopped_triggersReload() {
428
+ func true_fromStopped_triggersReload() throws {
432
429
  let (c, eh, _, _) = makeCoordinator()
430
+ try loadTrack(c)
433
431
  c.transition(.stopped)
432
+ eh.resumePosition = 42
433
+ let resolvesBefore = eh.resolveAndLoadCalls.count
434
434
 
435
- c.playWhenReady = true
435
+ c.setPlayWhenReady(true)
436
436
 
437
- #expect(eh.reloadTrackCalls.count == 1)
438
- #expect(eh.reloadTrackCalls.first == false) // startFromCurrentTime for stopped
437
+ #expect(eh.recreateCount == 0)
438
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore + 1)
439
+ #expect(c.deferredSeek.target == nil) // a stop restarts from the start
439
440
  }
440
441
 
441
442
  @Test @MainActor
@@ -443,7 +444,7 @@ struct PlayWhenReadyTests {
443
444
  let (c, eh, _, _) = makeCoordinator()
444
445
  c.transition(.bufferingSufficient) // .ready state
445
446
 
446
- c.playWhenReady = true
447
+ c.setPlayWhenReady(true)
447
448
 
448
449
  #expect(eh.startPlaybackCallCount >= 1)
449
450
  }
@@ -452,10 +453,10 @@ struct PlayWhenReadyTests {
452
453
  func false_notLoading_pausesPlayback() {
453
454
  let (c, eh, _, _) = makeCoordinator()
454
455
  c.transition(.avPlayerPlaying)
455
- c.playWhenReady = true
456
+ c.setPlayWhenReady(true)
456
457
  eh.pausePlaybackCallCount = 0
457
458
 
458
- c.playWhenReady = false
459
+ c.setPlayWhenReady(false)
459
460
 
460
461
  #expect(eh.pausePlaybackCallCount == 1)
461
462
  }
@@ -467,7 +468,7 @@ struct PlayWhenReadyTests {
467
468
  eh.startPlaybackCallCount = 0
468
469
  eh.pausePlaybackCallCount = 0
469
470
 
470
- c.playWhenReady = true
471
+ c.setPlayWhenReady(true)
471
472
 
472
473
  // During loading, should NOT call start/pause
473
474
  #expect(eh.startPlaybackCallCount == 0)
@@ -478,7 +479,7 @@ struct PlayWhenReadyTests {
478
479
  func emitsCallback_onChange() {
479
480
  let (c, _, cb, _) = makeCoordinator()
480
481
 
481
- c.playWhenReady = true
482
+ c.setPlayWhenReady(true)
482
483
 
483
484
  #expect(cb.playWhenReadyChanges.count == 1)
484
485
  #expect(cb.playWhenReadyChanges.first == true)
@@ -487,7 +488,7 @@ struct PlayWhenReadyTests {
487
488
 
488
489
  // MARK: - Skip availability (next/previous greying)
489
490
 
490
- @Suite("PlaybackCoordinator - skip availability")
491
+ @Suite("Player - skip availability")
491
492
  struct SkipAvailabilityCoordinatorTests {
492
493
  private static func multiTrack() -> [Track] {
493
494
  [
@@ -497,27 +498,27 @@ struct SkipAvailabilityCoordinatorTests {
497
498
  }
498
499
 
499
500
  @Test @MainActor
500
- func singleTrack_disablesBoth() {
501
+ func singleTrack_disablesBoth() throws {
501
502
  let (c, eh, _, _) = makeCoordinator()
502
- c.setQueue([Track(id: "t1", src: "https://example.com/1.mp3", title: "Track 1")])
503
+ try c.setQueue([Track(id: "t1", src: "https://example.com/1.mp3", title: "Track 1")])
503
504
 
504
505
  #expect(eh.updateSkipAvailabilityCalls.last?.canNext == false)
505
506
  #expect(eh.updateSkipAvailabilityCalls.last?.canPrevious == false)
506
507
  }
507
508
 
508
509
  @Test @MainActor
509
- func firstOfMany_nextOnly() {
510
+ func firstOfMany_nextOnly() throws {
510
511
  let (c, eh, _, _) = makeCoordinator()
511
- c.setQueue(Self.multiTrack())
512
+ try c.setQueue(Self.multiTrack())
512
513
 
513
514
  #expect(eh.updateSkipAvailabilityCalls.last?.canNext == true)
514
515
  #expect(eh.updateSkipAvailabilityCalls.last?.canPrevious == false)
515
516
  }
516
517
 
517
518
  @Test @MainActor
518
- func lastOfMany_previousOnly() {
519
+ func lastOfMany_previousOnly() throws {
519
520
  let (c, eh, _, _) = makeCoordinator()
520
- c.setQueue(Self.multiTrack())
521
+ try c.setQueue(Self.multiTrack())
521
522
  try? c.skipTo(1)
522
523
 
523
524
  #expect(eh.updateSkipAvailabilityCalls.last?.canNext == false)
@@ -525,9 +526,9 @@ struct SkipAvailabilityCoordinatorTests {
525
526
  }
526
527
 
527
528
  @Test @MainActor
528
- func repeatAll_repushesAvailability_atEnd() {
529
+ func repeatAll_repushesAvailability_atEnd() throws {
529
530
  let (c, eh, _, _) = makeCoordinator()
530
- c.setQueue(Self.multiTrack())
531
+ try c.setQueue(Self.multiTrack())
531
532
  try? c.skipTo(1) // last track
532
533
  eh.updateSkipAvailabilityCalls.removeAll()
533
534
 
@@ -541,49 +542,49 @@ struct SkipAvailabilityCoordinatorTests {
541
542
 
542
543
  // MARK: - handleCurrentTrackChanged
543
544
 
544
- @Suite("PlaybackCoordinator - handleCurrentTrackChanged")
545
+ @Suite("Player - handleCurrentTrackChanged")
545
546
  struct HandleCurrentTrackChangedTests {
546
547
  @Test @MainActor
547
- func clearsError_beforeTransition() {
548
+ func clearsError_beforeTransition() throws {
548
549
  let (c, eh, _, _) = makeCoordinator()
549
550
  eh.hasLoadedAsset = true
550
551
  c.transition(.errorOccurred(.playbackFailed))
551
- #expect(c.playbackError != nil)
552
+ #expect(c.errorStatus.error != nil)
552
553
 
553
- loadTrack(c)
554
+ try loadTrack(c)
554
555
 
555
556
  // After loading a track, the error should be cleared
556
- #expect(c.playbackError == nil)
557
+ #expect(c.errorStatus.error == nil)
557
558
  }
558
559
 
559
560
  @Test @MainActor
560
- func preservesPlayWhenReady_acrossLoading() {
561
+ func preservesPlayWhenReady_acrossLoading() throws {
561
562
  let (c, _, _, _) = makeCoordinator()
562
- c.playWhenReady = true
563
+ c.setPlayWhenReady(true)
563
564
 
564
- loadTrack(c)
565
+ try loadTrack(c)
565
566
 
566
567
  #expect(c.playWhenReady == true)
567
568
  #expect(c.state == .loading)
568
569
  }
569
570
 
570
571
  @Test @MainActor
571
- func nilSrc_transitionsToError() {
572
+ func nilSrc_transitionsToError() throws {
572
573
  let (c, _, cb, _) = makeCoordinator()
573
574
 
574
- let track = Track(id: "t1", src: nil, title: "No Source")
575
- c.setQueue([track])
575
+ let track = Track(id: "t1", path: "/no-source", src: nil, title: "No Source")
576
+ try c.setQueue([track])
576
577
 
577
578
  #expect(c.state == .error)
578
- #expect(c.playbackError == .invalidSourceUrl("nil"))
579
+ #expect(c.errorStatus.error == .invalidSourceUrl("nil"))
579
580
  #expect(cb.errorEvents.count >= 1)
580
581
  }
581
582
 
582
583
  @Test @MainActor
583
- func emitsActiveTrackChangedEvent() {
584
+ func emitsActiveTrackChangedEvent() throws {
584
585
  let (c, _, cb, _) = makeCoordinator()
585
586
 
586
- loadTrack(c)
587
+ try loadTrack(c)
587
588
 
588
589
  #expect(cb.activeTrackChanges.count == 1)
589
590
  let event = cb.activeTrackChanges.first!
@@ -595,19 +596,19 @@ struct HandleCurrentTrackChangedTests {
595
596
 
596
597
  // MARK: - handleTrackDidPlayToEndTime
597
598
 
598
- @Suite("PlaybackCoordinator - handleTrackDidPlayToEndTime")
599
+ @Suite("Player - handleTrackDidPlayToEndTime")
599
600
  struct HandleTrackDidPlayToEndTimeTests {
600
601
  @Test @MainActor
601
- func repeatTrack_replays() {
602
+ func repeatTrack_replays() throws {
602
603
  let (c, eh, _, _) = makeCoordinator()
603
- loadTrack(c)
604
+ try startPlaying(c, eh)
604
605
  c.repeatMode = .track
605
- c.playWhenReady = true
606
+ eh.startPlaybackCallCount = 0
606
607
 
607
- c.handleTrackDidPlayToEndTime()
608
+ eh.emit(.playedToEnd)
608
609
 
609
- // replay delegates to effectHandler.replayCurrentTrack (seek to 0 + play)
610
- #expect(eh.replayCurrentTrackCallCount == 1)
610
+ #expect(eh.seekCalls == [0])
611
+ #expect(eh.startPlaybackCallCount == 1)
611
612
  }
612
613
 
613
614
  /// The end-of-track sleep timer pauses (clears intent) just before this
@@ -616,45 +617,44 @@ struct HandleTrackDidPlayToEndTimeTests {
616
617
  /// reloads (a bare .paused would park at the end, where play() no-ops).
617
618
  /// A repeating queue never conceptually ends, so no queue-ended reaches JS.
618
619
  @Test @MainActor
619
- func repeatTrack_withoutIntent_settlesEnded() {
620
+ func repeatTrack_withoutIntent_settlesEnded() throws {
620
621
  let (c, eh, cb, _) = makeCoordinator()
621
- loadTrack(c)
622
+ try loadTrack(c)
622
623
  c.repeatMode = .track
623
- c.playWhenReady = false
624
+ c.setPlayWhenReady(false)
624
625
 
625
- c.handleTrackDidPlayToEndTime()
626
+ eh.emit(.playedToEnd)
626
627
 
627
628
  #expect(cb.queueEndedEvents.isEmpty)
628
- #expect(eh.replayCurrentTrackCallCount == 0)
629
+ #expect(eh.seekCalls.isEmpty)
629
630
  #expect(c.state == .ended)
630
631
  }
631
632
 
632
633
  @Test @MainActor
633
- func lastTrack_noRepeat_transitionsToEnded() {
634
+ func lastTrack_noRepeat_transitionsToEnded() throws {
634
635
  let (c, eh, cb, _) = makeCoordinator()
635
- _ = eh // retain weak effectHandler
636
- loadTrack(c)
636
+ try loadTrack(c)
637
637
  c.repeatMode = .off
638
638
 
639
- c.handleTrackDidPlayToEndTime()
639
+ eh.emit(.playedToEnd)
640
640
 
641
641
  #expect(c.state == .ended)
642
642
  #expect(cb.queueEndedEvents.count >= 1)
643
643
  }
644
644
 
645
645
  @Test @MainActor
646
- func midQueue_advancesToNext() {
647
- let (c, _, cb, _) = makeCoordinator()
646
+ func midQueue_advancesToNext() throws {
647
+ let (c, eh, cb, _) = makeCoordinator()
648
648
  let tracks = [
649
649
  Track(id: "t1", src: "https://example.com/1.mp3", title: "Track 1"),
650
650
  Track(id: "t2", src: "https://example.com/2.mp3", title: "Track 2"),
651
651
  ]
652
- c.setQueue(tracks)
652
+ try c.setQueue(tracks)
653
653
  cb.activeTrackChanges.removeAll()
654
654
 
655
- c.handleTrackDidPlayToEndTime()
655
+ eh.emit(.playedToEnd)
656
656
 
657
- #expect(c.currentIndex == 1)
657
+ #expect(c.queue.currentIndex == 1)
658
658
  #expect(cb.activeTrackChanges.count == 1)
659
659
  #expect(cb.activeTrackChanges.first?.track?.id == "t2")
660
660
  }
@@ -666,71 +666,73 @@ struct HandleTrackDidPlayToEndTimeTests {
666
666
  /// `playWhenReady` must not stay true. Keeping it inverted the play/pause
667
667
  /// toggle, held the audio session forever, armed interruption auto-resume into
668
668
  /// silence, and made play-from-ended a silent no-op.
669
- @Suite("PlaybackCoordinator - natural end drops play intent")
669
+ @Suite("Player - natural end drops play intent")
670
670
  struct NaturalEndPlayIntentTests {
671
671
  @Test @MainActor
672
- func naturalEnd_clearsPlayWhenReady() {
672
+ func naturalEnd_clearsPlayWhenReady() throws {
673
673
  let (c, eh, _, _) = makeCoordinator()
674
- startPlaying(c, eh)
674
+ try startPlaying(c, eh)
675
675
 
676
- c.handleTrackDidPlayToEndTime()
676
+ eh.emit(.playedToEnd)
677
677
 
678
678
  #expect(c.state == .ended)
679
679
  #expect(c.playWhenReady == false)
680
680
  }
681
681
 
682
682
  @Test @MainActor
683
- func naturalEnd_requestsSessionRelease() {
684
- let (c, eh, callbacks, _) = makeCoordinator()
685
- startPlaying(c, eh)
686
- callbacks.releaseSessionCount = 0
683
+ func naturalEnd_requestsSessionRelease() throws {
684
+ let (c, eh, _, _) = makeCoordinator()
685
+ try startPlaying(c, eh)
686
+ eh.scheduleAudioSessionReleaseCount = 0
687
687
 
688
- c.handleTrackDidPlayToEndTime()
688
+ eh.emit(.playedToEnd)
689
689
 
690
- #expect(callbacks.releaseSessionCount == 1)
690
+ #expect(eh.scheduleAudioSessionReleaseCount == 1)
691
691
  }
692
692
 
693
693
  /// play() from .ended must reload from the start — startPlayback() alone is a
694
694
  /// silent no-op on a player parked at the end of its item.
695
695
  @Test @MainActor
696
- func playAfterNaturalEnd_reloadsFromStart() {
696
+ func playAfterNaturalEnd_reloadsFromStart() throws {
697
697
  let (c, eh, _, _) = makeCoordinator()
698
- startPlaying(c, eh)
699
- c.handleTrackDidPlayToEndTime()
700
- eh.reloadTrackCalls.removeAll()
698
+ try startPlaying(c, eh)
699
+ eh.emit(.playedToEnd)
700
+ eh.resumePosition = 300
701
+ let resolvesBefore = eh.resolveAndLoadCalls.count
701
702
 
702
703
  c.play()
703
704
 
704
- #expect(eh.reloadTrackCalls == [false])
705
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore + 1)
706
+ #expect(c.deferredSeek.target == nil)
705
707
  }
706
708
 
707
709
  /// The cleared intent opens the call-site `!playWhenReady` gate, so a stray
708
710
  /// timeControlStatus pause after the end reaches the state machine — the
709
711
  /// table's .ended guard must hold the state.
710
712
  @Test @MainActor
711
- func strayPauseAfterNaturalEnd_staysEnded() {
713
+ func strayPauseAfterNaturalEnd_staysEnded() throws {
712
714
  let (c, eh, _, _) = makeCoordinator()
713
- startPlaying(c, eh)
714
- c.handleTrackDidPlayToEndTime()
715
+ try startPlaying(c, eh)
716
+ eh.emit(.playedToEnd)
715
717
  #expect(c.state == .ended)
716
718
 
717
- c.avPlayerDidChangeTimeControlStatus(.paused)
719
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
718
720
 
719
721
  #expect(c.state == .ended)
720
722
  }
721
723
 
722
724
  @Test @MainActor
723
- func interruptionAfterNaturalEnd_doesNotArmResume() {
725
+ func interruptionAfterNaturalEnd_doesNotArmResume() throws {
724
726
  let (c, eh, _, _) = makeCoordinator()
725
- startPlaying(c, eh)
726
- c.handleTrackDidPlayToEndTime()
727
- eh.reloadTrackCalls.removeAll()
727
+ try startPlaying(c, eh)
728
+ eh.emit(.playedToEnd)
729
+ let resolvesBefore = eh.resolveAndLoadCalls.count
728
730
 
729
731
  c.handleInterruptionBegan()
730
732
  c.handleInterruptionEnded(shouldResume: true)
731
733
 
732
734
  #expect(c.playWhenReady == false) // nothing was playing — never resume
733
- #expect(eh.reloadTrackCalls.isEmpty)
735
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore)
734
736
  }
735
737
  }
736
738
 
@@ -740,192 +742,118 @@ struct NaturalEndPlayIntentTests {
740
742
  /// window/attempt counters must refill (mirrors Android's healthy-playback
741
743
  /// refill) — otherwise a long-lived stream permanently loses retry after its
742
744
  /// first recovered blip.
743
- @Suite("PlaybackCoordinator - healthy playback resets retry budget")
745
+ @Suite("Player - healthy playback resets retry budget")
744
746
  struct HealthyPlaybackRetryResetTests {
747
+ /// A player whose retry loop has already executed one retry, so a reset shows.
748
+ @MainActor
749
+ private func makeAfterOneRetry(delay: TimeInterval = 0) async -> (Player, RetryLoop, MockPlayerEngine) {
750
+ let retry = makeRetryLoop(delay: delay)
751
+ let engine = MockPlayerEngine()
752
+ let player = makePlayer(engine: engine, retry: retry)
753
+ if delay == 0 {
754
+ retry.handleError(URLError(.timedOut), context: .playback)
755
+ await retry.pendingTask?.value
756
+ }
757
+ return (player, retry, engine)
758
+ }
759
+
745
760
  @Test @MainActor
746
761
  func sustainedPlayback_resetsRetryBudget() async {
747
- let retryHandler = MockRetryHandling()
748
- let errorHandler = PlaybackErrorHandler(retryHandler: retryHandler)
749
- let coordinator = PlaybackCoordinator(
750
- errorHandler: errorHandler, sleepTimerManager: MockSleepTimerHandling(),
751
- )
752
- let effectHandler = MockPlaybackEffectHandler()
753
- coordinator.effectHandler = effectHandler
754
- coordinator.healthyPlaybackDuration = 0.01
762
+ let (player, retry, _) = await makeAfterOneRetry()
763
+ #expect(retry.attempts == 1)
764
+ retry.healthyPlaybackDuration = .milliseconds(10)
755
765
 
756
- coordinator.transition(.avPlayerPlaying)
757
- await coordinator.healthyPlaybackTask?.value
766
+ player.transition(.avPlayerPlaying)
767
+ await retry.healthyPlaybackTask?.value
758
768
 
759
- #expect(retryHandler.resetCallCount == 1)
769
+ #expect(retry.attempts == 0)
760
770
  }
761
771
 
762
- /// resetRetry() cancels a pending retry — firing the refill mid-episode
772
+ /// reset() cancels a pending retry — firing the refill mid-episode
763
773
  /// would kill an in-flight reconnect silently (stuck .playing forever).
764
774
  @Test @MainActor
765
775
  func refill_skipsWhileRetryIsPending() async {
766
- let retryHandler = MockRetryHandling()
767
- retryHandler.isRetryableResult = true
768
- retryHandler.attemptRetryDelayNs = 1_000_000_000
769
- let errorHandler = PlaybackErrorHandler(retryHandler: retryHandler)
770
- let coordinator = PlaybackCoordinator(
771
- errorHandler: errorHandler, sleepTimerManager: MockSleepTimerHandling(),
772
- )
773
- let effectHandler = MockPlaybackEffectHandler()
774
- coordinator.effectHandler = effectHandler
775
- coordinator.healthyPlaybackDuration = 0.01
776
+ let (player, retry, _) = await makeAfterOneRetry(delay: 1)
777
+ retry.healthyPlaybackDuration = .milliseconds(10)
776
778
 
777
- coordinator.transition(.avPlayerPlaying)
778
- errorHandler.handleError(URLError(.timedOut), context: .playback)
779
- await coordinator.healthyPlaybackTask?.value
779
+ player.transition(.avPlayerPlaying)
780
+ retry.handleError(URLError(.timedOut), context: .playback)
781
+ await retry.healthyPlaybackTask?.value
780
782
 
781
- #expect(retryHandler.resetCallCount == 0)
782
- #expect(errorHandler.pendingRetryTask != nil)
783
+ #expect(retry.pendingTask != nil)
784
+ retry.cancel()
783
785
  }
784
786
 
785
787
  @Test @MainActor
786
788
  func playbackInterruptedBeforeThreshold_doesNotReset() async {
787
- let retryHandler = MockRetryHandling()
788
- let errorHandler = PlaybackErrorHandler(retryHandler: retryHandler)
789
- let coordinator = PlaybackCoordinator(
790
- errorHandler: errorHandler, sleepTimerManager: MockSleepTimerHandling(),
791
- )
792
- let effectHandler = MockPlaybackEffectHandler()
793
- coordinator.effectHandler = effectHandler
794
- effectHandler.hasLoadedAsset = true
795
- coordinator.healthyPlaybackDuration = 0.5
789
+ let (player, retry, engine) = await makeAfterOneRetry()
790
+ engine.hasLoadedAsset = true
791
+ retry.healthyPlaybackDuration = .milliseconds(500)
796
792
 
797
- coordinator.transition(.avPlayerPlaying)
798
- let refill = coordinator.healthyPlaybackTask
799
- coordinator.transition(.avPlayerWaiting) // stalls before the threshold
793
+ player.transition(.avPlayerPlaying)
794
+ let refill = retry.healthyPlaybackTask
795
+ player.transition(.avPlayerWaiting) // stalls before the threshold
800
796
 
801
797
  // Leaving .playing cancels the refill; awaiting the cancelled task is the
802
798
  // deterministic way to reach the point where it would have fired.
803
799
  await refill?.value
804
800
 
805
- #expect(retryHandler.resetCallCount == 0)
806
- }
807
- }
808
-
809
- @Suite("PlaybackCoordinator - now playing state")
810
- struct PlaybackCoordinatorNowPlayingStateTests {
811
- @Test @MainActor
812
- func change_updatesNowPlayingState_evenDuringLoading() {
813
- let (c, eh, _, _) = makeCoordinator()
814
- c.transition(.trackLoading) // mid track-load; start/pause is deferred
815
- eh.updateNowPlayingStateCalls.removeAll()
816
-
817
- c.playWhenReady = true
818
-
819
- // The lock-screen / CarPlay play-pause button reflects the user's play
820
- // *intent* immediately, even while the new item is still loading — otherwise
821
- // it stays stuck showing "paused" until a later state transition repairs it.
822
- #expect(eh.updateNowPlayingStateCalls.last == true)
823
- }
824
-
825
- @Test @MainActor
826
- func staysPlaying_whenBufferRunsDry() {
827
- let (c, eh, _, _) = makeCoordinator()
828
- c.playWhenReady = true
829
- c.transition(.avPlayerPlaying)
830
- eh.updateNowPlayingStateCalls.removeAll()
831
-
832
- c.transition(.avPlayerWaiting) // buffer ran dry → .buffering
833
-
834
- // A buffer underrun doesn't change play intent, so the button stays "playing"
835
- // (the system shows buffering) — it must NOT flip to paused like a user pause.
836
- #expect(eh.updateNowPlayingStateCalls.last == true)
837
- }
838
-
839
- @Test @MainActor
840
- func fallsBackToPaused_onError() {
841
- let (c, eh, _, _) = makeCoordinator()
842
- c.playWhenReady = true
843
- c.transition(.trackLoading) // active + intent → playing
844
- eh.updateNowPlayingStateCalls.removeAll()
845
-
846
- c.transition(.errorOccurred(.playbackFailed))
847
-
848
- // On a terminal error the button must fall back to paused — never stick on
849
- // "playing" — even though playWhenReady is still true.
850
- #expect(eh.updateNowPlayingStateCalls.last == false)
851
- }
852
-
853
- @Test @MainActor
854
- func change_doesNotStampNowPlayingState_fromTerminalState() {
855
- let (c, eh, _, _) = makeCoordinator()
856
- c.transition(.errorOccurred(.playbackFailed)) // terminal, not playbackActive
857
- eh.updateNowPlayingStateCalls.removeAll()
858
-
859
- c.playWhenReady = true
860
-
861
- // Must NOT stamp .playing from a terminal state: the reload may fail and no
862
- // active transition would repair a premature "playing", leaving a phantom
863
- // playing button. The reload's own .loading/.ready transition stamps it.
864
- #expect(eh.updateNowPlayingStateCalls.isEmpty)
865
- }
866
-
867
- @Test @MainActor
868
- func selectingNewTrack_whileStopped_showsPlayingInNowPlaying() {
869
- let (c, eh, _, _) = makeCoordinator()
870
- let tracks = [
871
- Track(id: "t1", src: "https://example.com/1.mp3", title: "Track 1"),
872
- Track(id: "t2", src: "https://example.com/2.mp3", title: "Track 2"),
873
- ]
874
- c.setQueue(tracks) // loads t1 (playWhenReady defaults to false)
875
- c.transition(.stopped) // user had paused/stopped
876
- eh.updateNowPlayingStateCalls.removeAll()
877
-
878
- // User selects another track, intending to play it.
879
- try? c.skipTo(1, playWhenReady: true)
880
-
881
- // Audio will play, so the now-playing button must end up "playing" — not the
882
- // stale "paused" captured before playWhenReady flipped true during loading.
883
- #expect(eh.updateNowPlayingStateCalls.last == true)
801
+ #expect(retry.attempts == 1)
884
802
  }
885
803
  }
886
804
 
887
805
  // MARK: - Sleep Timer Fade
888
806
 
889
- @Suite("PlaybackCoordinator - sleep timer fade")
807
+ @Suite("Player - sleep timer fade")
890
808
  struct SleepTimerFadeTests {
809
+ /// A 20 s timer whose 10 s fade has begun.
810
+ @MainActor
811
+ private func startFade(_ c: Player, _ clock: ManualSleepTimerScheduler) {
812
+ c.sleepTimerManager.set(seconds: 20, fadeDuration: 10)
813
+ clock.advance(to: 10)
814
+ }
815
+
891
816
  @Test @MainActor
892
817
  func fadeStart_capturesPreFadeVolume() {
893
- let (c, eh, _, st) = makeCoordinator()
818
+ let (c, eh, _, clock) = makeCoordinator()
894
819
  eh.volume = 0.8
895
820
 
896
- st.onFadeStart?(10)
821
+ startFade(c, clock)
822
+ eh.volume = 0.1 // mid-fade
897
823
 
898
- #expect(c.volumeFader.isActive)
899
- #expect(c.volumeFader.originalVolume == 0.8)
824
+ #expect(c.sleepTimerManager.isFading)
825
+ c.sleepTimerManager.clear()
826
+ #expect(eh.volume == 0.8)
900
827
  }
901
828
 
902
829
  @Test @MainActor
903
- func completion_pausesThenRestoresPreFadeVolume() {
904
- let (c, eh, _, st) = makeCoordinator()
905
- loadTrack(c)
906
- c.playWhenReady = true
830
+ func completion_pausesThenRestoresPreFadeVolume() throws {
831
+ let (c, eh, _, clock) = makeCoordinator()
832
+ try loadTrack(c)
833
+ c.setPlayWhenReady(true)
907
834
  c.transition(.bufferingSufficient) // leave .loading so pause reaches the player
908
835
  eh.pausePlaybackCallCount = 0
909
836
 
910
- st.onFadeStart?(10)
837
+ startFade(c, clock)
911
838
  eh.volume = 0.2 // mid-fade
912
839
 
913
- st.onComplete?()
840
+ clock.advance(to: 20)
914
841
 
915
842
  #expect(c.playWhenReady == false)
916
843
  #expect(eh.pausePlaybackCallCount == 1)
917
844
  #expect(eh.volume == 1.0)
918
- #expect(!c.volumeFader.isActive)
845
+ #expect(!c.sleepTimerManager.isFading)
919
846
  }
920
847
 
921
848
  @Test @MainActor
922
- func completion_withoutFade_justPauses() {
923
- let (c, eh, _, st) = makeCoordinator()
924
- loadTrack(c)
925
- c.playWhenReady = true
849
+ func completion_withoutFade_justPauses() throws {
850
+ let (c, eh, _, clock) = makeCoordinator()
851
+ try loadTrack(c)
852
+ c.setPlayWhenReady(true)
926
853
  eh.volume = 0.8
854
+ c.sleepTimerManager.set(seconds: 20)
927
855
 
928
- st.onComplete?()
856
+ clock.advance(to: 20)
929
857
 
930
858
  #expect(c.playWhenReady == false)
931
859
  #expect(eh.volume == 0.8) // untouched — no fade ran
@@ -933,59 +861,61 @@ struct SleepTimerFadeTests {
933
861
 
934
862
  @Test @MainActor
935
863
  func fadeCancel_restoresPreFadeVolume() {
936
- let (c, eh, _, st) = makeCoordinator()
864
+ let (c, eh, _, clock) = makeCoordinator()
937
865
  eh.volume = 0.8
938
866
 
939
- st.onFadeStart?(10)
867
+ startFade(c, clock)
940
868
  eh.volume = 0.1 // mid-fade
941
869
 
942
- st.onFadeCancel?()
870
+ c.sleepTimerManager.set(seconds: 60)
943
871
 
944
872
  #expect(eh.volume == 0.8)
945
- #expect(!c.volumeFader.isActive)
873
+ #expect(!c.sleepTimerManager.isFading)
946
874
  }
947
875
 
948
876
  @Test @MainActor
949
- func pauseDuringFade_clearsSleepTimer() {
950
- let (c, _, _, st) = makeCoordinator()
951
- loadTrack(c)
952
- c.playWhenReady = true
877
+ func pauseDuringFade_clearsSleepTimer() throws {
878
+ let (c, _, _, clock) = makeCoordinator()
879
+ try loadTrack(c)
880
+ c.setPlayWhenReady(true)
953
881
 
954
- st.onFadeStart?(10)
882
+ startFade(c, clock)
955
883
  c.pause()
956
884
 
957
- #expect(st.clearCallCount == 1)
885
+ #expect(c.sleepTimerManager.get() == nil)
958
886
  }
959
887
 
960
888
  @Test @MainActor
961
- func pauseWithoutFade_leavesSleepTimerAlone() {
962
- let (c, _, _, st) = makeCoordinator()
963
- loadTrack(c)
964
- c.playWhenReady = true
889
+ func pauseWithoutFade_leavesSleepTimerAlone() throws {
890
+ let (c, _, _, _) = makeCoordinator()
891
+ try loadTrack(c)
892
+ c.setPlayWhenReady(true)
893
+ c.sleepTimerManager.set(seconds: 60, fadeDuration: 10)
965
894
 
966
895
  c.pause()
967
896
 
968
- #expect(st.clearCallCount == 0)
897
+ #expect(c.sleepTimerManager.get() != nil)
969
898
  }
970
899
  }
971
900
 
972
901
  // MARK: - Audio Session Interruptions
973
902
 
974
- /// Helper to drive the coordinator into an actively-playing state.
903
+ /// Helper to drive the player into an actively-playing state.
975
904
  @MainActor
976
- private func startPlaying(_ c: PlaybackCoordinator, _ eh: MockPlaybackEffectHandler) {
977
- loadTrack(c)
905
+ private func startPlaying(_ c: Player, _ eh: MockPlayerEngine) throws {
906
+ try loadTrack(c)
978
907
  eh.hasLoadedAsset = true
979
- c.playWhenReady = true
908
+ eh.hasItem = true
909
+ c.setPlayWhenReady(true)
980
910
  c.transition(.avPlayerPlaying)
981
911
  }
982
912
 
983
- @Suite("PlaybackCoordinator - audio session interruptions")
913
+ @Suite("Player - audio session interruptions")
984
914
  struct InterruptionTests {
985
915
  @Test @MainActor
986
- func began_whilePlaying_pauses() {
916
+ func began_whilePlaying_pauses() throws {
987
917
  let (c, eh, _, _) = makeCoordinator()
988
- startPlaying(c, eh)
918
+ try startPlaying(c, eh)
989
919
  #expect(c.state == .playing)
990
920
 
991
921
  c.handleInterruptionBegan()
@@ -998,11 +928,11 @@ struct InterruptionTests {
998
928
  /// is swallowed because `playWhenReady` is still true, so the state stays
999
929
  /// `.playing`. The interruption handler must force the pause regardless.
1000
930
  @Test @MainActor
1001
- func began_afterSwallowedTimeControlPause_stillPauses() {
931
+ func began_afterSwallowedTimeControlPause_stillPauses() throws {
1002
932
  let (c, eh, _, _) = makeCoordinator()
1003
- startPlaying(c, eh)
933
+ try startPlaying(c, eh)
1004
934
 
1005
- c.avPlayerDidChangeTimeControlStatus(.paused)
935
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
1006
936
  #expect(c.state == .playing) // swallowed — the symptom this fix targets
1007
937
 
1008
938
  c.handleInterruptionBegan()
@@ -1011,9 +941,9 @@ struct InterruptionTests {
1011
941
  }
1012
942
 
1013
943
  @Test @MainActor
1014
- func ended_shouldResume_resumesWhenWasPlaying() {
944
+ func ended_shouldResume_resumesWhenWasPlaying() throws {
1015
945
  let (c, eh, _, _) = makeCoordinator()
1016
- startPlaying(c, eh)
946
+ try startPlaying(c, eh)
1017
947
  c.handleInterruptionBegan()
1018
948
  #expect(c.playWhenReady == false)
1019
949
  eh.startPlaybackCallCount = 0
@@ -1025,9 +955,9 @@ struct InterruptionTests {
1025
955
  }
1026
956
 
1027
957
  @Test @MainActor
1028
- func ended_withoutShouldResume_staysPaused() {
958
+ func ended_withoutShouldResume_staysPaused() throws {
1029
959
  let (c, eh, _, _) = makeCoordinator()
1030
- startPlaying(c, eh)
960
+ try startPlaying(c, eh)
1031
961
  c.handleInterruptionBegan()
1032
962
 
1033
963
  c.handleInterruptionEnded(shouldResume: false)
@@ -1040,9 +970,9 @@ struct InterruptionTests {
1040
970
  /// paused-when-interrupted must not grab a non-mixable session for a resume
1041
971
  /// that never happens.
1042
972
  @Test @MainActor
1043
- func willResumeAfterInterruption_reflectsCapturedIntent() {
973
+ func willResumeAfterInterruption_reflectsCapturedIntent() throws {
1044
974
  let (c, eh, _, _) = makeCoordinator()
1045
- startPlaying(c, eh)
975
+ try startPlaying(c, eh)
1046
976
 
1047
977
  c.handleInterruptionBegan()
1048
978
  #expect(c.willResumeAfterInterruption == true)
@@ -1058,9 +988,9 @@ struct InterruptionTests {
1058
988
  /// iOS can deliver nested interruptions (Siri, then a phone call) — a second
1059
989
  /// .began must not re-capture the now-false intent and wipe the resume flag.
1060
990
  @Test @MainActor
1061
- func doubleBegan_preservesResumeIntent() {
991
+ func doubleBegan_preservesResumeIntent() throws {
1062
992
  let (c, eh, _, _) = makeCoordinator()
1063
- startPlaying(c, eh)
993
+ try startPlaying(c, eh)
1064
994
 
1065
995
  c.handleInterruptionBegan()
1066
996
  c.handleInterruptionBegan()
@@ -1072,9 +1002,9 @@ struct InterruptionTests {
1072
1002
  /// Unplugging headphones during a call is a deliberate output loss — the
1073
1003
  /// call ending must not blast playback from the built-in speaker.
1074
1004
  @Test @MainActor
1075
- func routeDisconnectDuringInterruption_cancelsResume() {
1005
+ func routeDisconnectDuringInterruption_cancelsResume() throws {
1076
1006
  let (c, eh, _, _) = makeCoordinator()
1077
- startPlaying(c, eh)
1007
+ try startPlaying(c, eh)
1078
1008
  c.handleInterruptionBegan()
1079
1009
 
1080
1010
  c.handleRouteDisconnected()
@@ -1086,25 +1016,26 @@ struct InterruptionTests {
1086
1016
  /// An explicit stop during the interruption is a terminal command — the
1087
1017
  /// interruption-end must not restart playback over it.
1088
1018
  @Test @MainActor
1089
- func stopDuringInterruption_isNotOverriddenByResume() {
1019
+ func stopDuringInterruption_isNotOverriddenByResume() throws {
1090
1020
  let (c, eh, _, _) = makeCoordinator()
1091
- startPlaying(c, eh)
1021
+ try startPlaying(c, eh)
1092
1022
  c.handleInterruptionBegan()
1023
+ let resolvesBefore = eh.resolveAndLoadCalls.count
1093
1024
 
1094
1025
  c.stop()
1095
1026
  c.handleInterruptionEnded(shouldResume: true)
1096
1027
 
1097
1028
  #expect(c.state == .stopped)
1098
1029
  #expect(c.playWhenReady == false)
1099
- #expect(eh.reloadTrackCalls.isEmpty)
1030
+ #expect(eh.resolveAndLoadCalls.count == resolvesBefore)
1100
1031
  }
1101
1032
 
1102
1033
  /// A user who plays then pauses during the interruption has taken ownership
1103
1034
  /// of the intent — interruption-end must not override their pause.
1104
1035
  @Test @MainActor
1105
- func userPauseDuringInterruption_overridesResume() {
1036
+ func userPauseDuringInterruption_overridesResume() throws {
1106
1037
  let (c, eh, _, _) = makeCoordinator()
1107
- startPlaying(c, eh)
1038
+ try startPlaying(c, eh)
1108
1039
  c.handleInterruptionBegan()
1109
1040
 
1110
1041
  c.play()
@@ -1115,12 +1046,12 @@ struct InterruptionTests {
1115
1046
  }
1116
1047
 
1117
1048
  @Test @MainActor
1118
- func ended_doesNotResume_whenNotPlayingBeforeInterruption() {
1049
+ func ended_doesNotResume_whenNotPlayingBeforeInterruption() throws {
1119
1050
  let (c, eh, _, _) = makeCoordinator()
1120
- startPlaying(c, eh)
1051
+ try startPlaying(c, eh)
1121
1052
  // Pause before the interruption (e.g. user already paused).
1122
- c.playWhenReady = false
1123
- c.avPlayerDidChangeTimeControlStatus(.paused)
1053
+ c.setPlayWhenReady(false)
1054
+ eh.emit(.timeControlStatus(.paused, waitingForNoItem: false))
1124
1055
  #expect(c.state == .paused)
1125
1056
 
1126
1057
  c.handleInterruptionBegan()
@@ -1132,15 +1063,14 @@ struct InterruptionTests {
1132
1063
 
1133
1064
  // MARK: - Skip availability freshness
1134
1065
 
1135
- /// tracks.didSet pushes availability mid-mutation, while currentIndex and the
1136
- /// shuffle order are still stale — the coordinator must re-push after the
1137
- /// mutation settles or the lock-screen buttons keep the wrong state.
1138
- @Suite("PlaybackCoordinator - skip availability after mutations")
1066
+ /// A mutation pushes next/previous availability once, after currentIndex and the
1067
+ /// shuffle order have settled; an earlier push leaves the lock-screen buttons wrong.
1068
+ @Suite("Player - skip availability after mutations")
1139
1069
  struct MutationSkipAvailabilityTests {
1140
1070
  @Test @MainActor
1141
1071
  func move_pushesPostMutationAvailability() throws {
1142
1072
  let (c, eh, _, _) = makeCoordinator()
1143
- c.setQueue([
1073
+ try c.setQueue([
1144
1074
  Track(id: "a", src: "https://example.com/a.mp3", title: "A"),
1145
1075
  Track(id: "b", src: "https://example.com/b.mp3", title: "B"),
1146
1076
  ])
@@ -1149,13 +1079,14 @@ struct MutationSkipAvailabilityTests {
1149
1079
  try c.move(fromIndex: 0, toIndex: 1)
1150
1080
 
1151
1081
  // Current track is now last: nothing to skip to.
1082
+ #expect(eh.updateSkipAvailabilityCalls.count == 1)
1152
1083
  #expect(eh.updateSkipAvailabilityCalls.last?.canNext == false)
1153
1084
  }
1154
1085
 
1155
1086
  @Test @MainActor
1156
1087
  func removeBeforeCurrent_pushesPostMutationAvailability() throws {
1157
1088
  let (c, eh, _, _) = makeCoordinator()
1158
- c.setQueue(
1089
+ try c.setQueue(
1159
1090
  [
1160
1091
  Track(id: "a", src: "https://example.com/a.mp3", title: "A"),
1161
1092
  Track(id: "b", src: "https://example.com/b.mp3", title: "B"),
@@ -1167,94 +1098,341 @@ struct MutationSkipAvailabilityTests {
1167
1098
  try c.remove(0)
1168
1099
 
1169
1100
  // Current settled at index 1 of 2: previous available, next not.
1101
+ #expect(eh.updateSkipAvailabilityCalls.count == 1)
1170
1102
  #expect(eh.updateSkipAvailabilityCalls.last?.canNext == false)
1171
1103
  #expect(eh.updateSkipAvailabilityCalls.last?.canPrevious == true)
1172
1104
  }
1173
1105
  }
1174
1106
 
1107
+ // MARK: - Publishing
1108
+
1109
+ @Suite("Player - publishing")
1110
+ struct PublishingTests {
1111
+ /// The order JS has always seen: the intent, then the playing state, then the playback. A
1112
+ /// natural end clears the intent on the way in; each change still goes out once.
1113
+ @Test @MainActor
1114
+ func endingPublishesTheIntentThenThePlayingStateThenThePlayback() {
1115
+ let (c, _, cb, _) = makeCoordinator()
1116
+ c.setPlayWhenReady(true)
1117
+ c.transition(.avPlayerPlaying)
1118
+ cb.publishOrder.removeAll()
1119
+
1120
+ c.transition(.trackEndedNaturally)
1121
+
1122
+ #expect(cb.publishOrder == ["playWhenReady", "playingState", "playback"])
1123
+ }
1124
+
1125
+ @Test @MainActor
1126
+ func aTransitionPublishesThePlayingStateBeforeThePlayback() {
1127
+ let (c, _, cb, _) = makeCoordinator()
1128
+ c.setPlayWhenReady(true)
1129
+ cb.publishOrder.removeAll()
1130
+
1131
+ c.transition(.avPlayerPlaying)
1132
+
1133
+ #expect(cb.publishOrder == ["playingState", "playback"])
1134
+ }
1135
+
1136
+ @Test @MainActor
1137
+ func aRepeatedTerminalErrorIsReportedAgain() {
1138
+ let (c, _, cb, _) = makeCoordinator()
1139
+ c.transition(.errorOccurred(.playbackFailed))
1140
+ c.transition(.errorOccurred(.playbackFailed))
1141
+
1142
+ #expect(cb.errorEvents.count == 2)
1143
+ }
1144
+ }
1145
+
1146
+ // MARK: - Load
1147
+
1148
+ @Suite("Player - Load")
1149
+ struct LoadTests {
1150
+ @MainActor
1151
+ private func track(_ id: String) -> Track {
1152
+ Track(id: id, src: "https://example.com/\(id).mp3", title: id)
1153
+ }
1154
+
1155
+ @Test @MainActor
1156
+ func aNewTrackStartsAnUnprovenLoad() throws {
1157
+ let (c, eh, _, _) = makeCoordinator()
1158
+ try c.setQueue([track("a"), track("b")])
1159
+ let first = c.load
1160
+ eh.emit(.audioDidStart)
1161
+ #expect(c.load?.hasPlayed == true)
1162
+
1163
+ c.next()
1164
+
1165
+ #expect(c.load != nil && c.load?.id != first?.id)
1166
+ #expect(c.load?.hasPlayed == false)
1167
+ }
1168
+
1169
+ /// The healthy-playback refill resets the retry budgets mid-play; the load, and with it the
1170
+ /// recovery budget, must survive it.
1171
+ @Test @MainActor
1172
+ func aRetryResetKeepsTheLoad() throws {
1173
+ let (c, eh, _, _) = makeCoordinator()
1174
+ try c.setQueue([track("a")])
1175
+ eh.emit(.audioDidStart)
1176
+ let load = c.load
1177
+
1178
+ c.retry.reset()
1179
+
1180
+ #expect(c.load == load)
1181
+ #expect(c.load?.hasPlayed == true)
1182
+ }
1183
+
1184
+ @Test
1185
+ func theNowPlayingPrimeIsClaimedOnce() {
1186
+ var load = Player.Load(id: 1)
1187
+ let first = load.claimNowPlayingPrime()
1188
+ let second = load.claimNowPlayingPrime()
1189
+ #expect(first)
1190
+ #expect(!second)
1191
+ }
1192
+ }
1193
+
1194
+ // MARK: - Queue publication
1195
+
1196
+ @Suite("Player - queue publication")
1197
+ struct QueuePublicationTests {
1198
+ @MainActor
1199
+ private func threeTracks() -> [Track] {
1200
+ ["a", "b", "c"].map { Track(id: $0, src: "https://example.com/\($0).mp3", title: $0) }
1201
+ }
1202
+
1203
+ @Test @MainActor
1204
+ func setQueue_publishesTheQueueBeforeTheActiveTrack() throws {
1205
+ let (c, _, cb, _) = makeCoordinator()
1206
+ try c.setQueue(threeTracks())
1207
+ #expect(cb.queueChanges.map { $0.map(\.id) } == [["a", "b", "c"]])
1208
+ #expect(cb.queueAndTrackOrder == ["queue", "activeTrack"])
1209
+ }
1210
+
1211
+ @Test @MainActor
1212
+ func move_publishesTheSettledQueueOnce() throws {
1213
+ let (c, _, cb, _) = makeCoordinator()
1214
+ try c.setQueue(threeTracks())
1215
+ cb.queueChanges.removeAll()
1216
+ try c.move(fromIndex: 0, toIndex: 2)
1217
+ #expect(cb.queueChanges.map { $0.map(\.id) } == [["b", "c", "a"]])
1218
+ }
1219
+
1220
+ @Test @MainActor
1221
+ func clear_publishesAnEmptyQueue() throws {
1222
+ let (c, _, cb, _) = makeCoordinator()
1223
+ try c.setQueue(threeTracks())
1224
+ cb.queueChanges.removeAll()
1225
+ c.clear()
1226
+ #expect(cb.queueChanges.map(\.count) == [0])
1227
+ }
1228
+
1229
+ @Test @MainActor
1230
+ func navigation_publishesNoQueue() throws {
1231
+ let (c, _, cb, _) = makeCoordinator()
1232
+ try c.setQueue(threeTracks())
1233
+ cb.queueChanges.removeAll()
1234
+ c.next()
1235
+ c.previous()
1236
+ try c.skipTo(2)
1237
+ #expect(cb.queueChanges.isEmpty)
1238
+ }
1239
+ }
1240
+
1175
1241
  // MARK: - Stop cancels pending retry
1176
1242
 
1177
- @Suite("PlaybackCoordinator - stop cancels pending retry")
1243
+ @Suite("Player - stop cancels pending retry")
1178
1244
  struct StopCancelsRetryTests {
1179
1245
  /// A retry surviving stop() gives up later (intent dropped) and surfaced
1180
1246
  /// .errorOccurred over the deliberate stop — the UI showed an error seconds
1181
1247
  /// after the user stopped.
1182
1248
  @Test @MainActor
1183
1249
  func stop_cancelsPendingRetry_andStaysSilent() async {
1184
- let retryHandler = MockRetryHandling()
1185
- retryHandler.isRetryableResult = true
1186
- retryHandler.attemptRetryResult = false
1187
- retryHandler.attemptRetryDelayNs = 50_000_000
1188
- let errorHandler = PlaybackErrorHandler(retryHandler: retryHandler)
1189
- let coordinator = PlaybackCoordinator(
1190
- errorHandler: errorHandler, sleepTimerManager: MockSleepTimerHandling(),
1191
- )
1192
- let effectHandler = MockPlaybackEffectHandler()
1193
- let callbacks = MockPlaybackCoordinatorCallbacks()
1194
- coordinator.effectHandler = effectHandler
1195
- coordinator.callbacks = callbacks
1250
+ let errorHandler = makeRetryLoop(delay: 0.05)
1251
+ let engine = MockPlayerEngine()
1252
+ let player = makePlayer(engine: engine, retry: errorHandler)
1253
+ let callbacks = MockPlayerCallbacks()
1254
+ player.callbacks = callbacks
1196
1255
 
1197
1256
  errorHandler.handleError(URLError(.timedOut), context: .playback)
1198
- let task = errorHandler.pendingRetryTask
1257
+ let task = errorHandler.pendingTask
1199
1258
  #expect(task != nil)
1200
1259
 
1201
- coordinator.stop()
1202
- #expect(errorHandler.pendingRetryTask == nil)
1260
+ player.stop()
1261
+ #expect(errorHandler.pendingTask == nil)
1203
1262
 
1204
1263
  await task?.value
1205
- #expect(coordinator.state == .stopped)
1264
+ #expect(player.state == .stopped)
1206
1265
  #expect(callbacks.errorEvents.isEmpty)
1207
1266
  }
1208
1267
  }
1209
1268
 
1210
1269
  // MARK: - Audio session release (#60)
1211
1270
 
1212
- @Suite("PlaybackCoordinator - audio session release")
1271
+ @Suite("Player - audio session release")
1213
1272
  struct SessionReleaseTests {
1214
1273
  @Test @MainActor
1215
- func deliberatePause_requestsRelease() {
1216
- let (c, eh, callbacks, _) = makeCoordinator()
1217
- startPlaying(c, eh)
1218
- callbacks.releaseSessionCount = 0
1274
+ func deliberatePause_requestsRelease() throws {
1275
+ let (c, eh, _, _) = makeCoordinator()
1276
+ try startPlaying(c, eh)
1277
+ eh.scheduleAudioSessionReleaseCount = 0
1219
1278
  c.pause()
1220
- #expect(callbacks.releaseSessionCount == 1)
1279
+ #expect(eh.scheduleAudioSessionReleaseCount == 1)
1221
1280
  }
1222
1281
 
1223
1282
  @Test @MainActor
1224
- func play_doesNotRequestRelease() {
1225
- let (c, eh, callbacks, _) = makeCoordinator()
1226
- startPlaying(c, eh)
1227
- #expect(callbacks.releaseSessionCount == 0)
1283
+ func play_doesNotRequestRelease() throws {
1284
+ let (c, eh, _, _) = makeCoordinator()
1285
+ try startPlaying(c, eh)
1286
+ #expect(eh.scheduleAudioSessionReleaseCount == 0)
1228
1287
  }
1229
1288
 
1230
1289
  @Test @MainActor
1231
- func interruptionBegan_doesNotRequestRelease() {
1290
+ func interruptionBegan_doesNotRequestRelease() throws {
1232
1291
  // A phone call pauses (playWhenReady → false) but is meant to resume, so the session must be
1233
1292
  // held — the exact race the intent-gating design exists to avoid.
1234
- let (c, eh, callbacks, _) = makeCoordinator()
1235
- startPlaying(c, eh)
1236
- callbacks.releaseSessionCount = 0
1293
+ let (c, eh, _, _) = makeCoordinator()
1294
+ try startPlaying(c, eh)
1295
+ eh.scheduleAudioSessionReleaseCount = 0
1237
1296
  c.handleInterruptionBegan()
1238
- #expect(callbacks.releaseSessionCount == 0)
1297
+ #expect(eh.scheduleAudioSessionReleaseCount == 0)
1239
1298
  }
1240
1299
 
1241
1300
  @Test @MainActor
1242
- func interruptionEnded_withResume_doesNotRequestRelease() {
1243
- let (c, eh, callbacks, _) = makeCoordinator()
1244
- startPlaying(c, eh)
1301
+ func interruptionEnded_withResume_doesNotRequestRelease() throws {
1302
+ let (c, eh, _, _) = makeCoordinator()
1303
+ try startPlaying(c, eh)
1245
1304
  c.handleInterruptionBegan()
1246
- callbacks.releaseSessionCount = 0
1305
+ eh.scheduleAudioSessionReleaseCount = 0
1247
1306
  c.handleInterruptionEnded(shouldResume: true)
1248
- #expect(callbacks.releaseSessionCount == 0)
1307
+ #expect(eh.scheduleAudioSessionReleaseCount == 0)
1249
1308
  }
1250
1309
 
1251
1310
  @Test @MainActor
1252
- func interruptionEnded_withoutResume_requestsRelease() {
1253
- let (c, eh, callbacks, _) = makeCoordinator()
1254
- startPlaying(c, eh)
1311
+ func interruptionEnded_withoutResume_requestsRelease() throws {
1312
+ let (c, eh, _, _) = makeCoordinator()
1313
+ try startPlaying(c, eh)
1255
1314
  c.handleInterruptionBegan()
1256
- callbacks.releaseSessionCount = 0
1315
+ eh.scheduleAudioSessionReleaseCount = 0
1257
1316
  c.handleInterruptionEnded(shouldResume: false)
1258
- #expect(callbacks.releaseSessionCount == 1)
1317
+ #expect(eh.scheduleAudioSessionReleaseCount == 1)
1318
+ }
1319
+ }
1320
+
1321
+ // MARK: - Media-stack effects of a publish
1322
+
1323
+ /// The audio-session and now-playing effects the Player drives through its engine, in their
1324
+ /// order relative to the callbacks JS hears.
1325
+ @Suite("Player - media-stack effects")
1326
+ struct MediaStackEffectTests {
1327
+ @MainActor
1328
+ private func makeTraced() -> (Player, MockPlayerEngine, MockPlayerCallbacks) {
1329
+ let (c, eh, cb, _) = makeCoordinator()
1330
+ eh.onSeamCall = { [weak cb] in cb?.publishOrder.append($0) }
1331
+ return (c, eh, cb)
1332
+ }
1333
+
1334
+ @Test @MainActor
1335
+ func playIntent_cancelsTheReleaseBeforeJSHearsIt_thenActivatesOnOutput() throws {
1336
+ let (c, _, cb) = makeTraced()
1337
+ try loadTrack(c)
1338
+ cb.publishOrder.removeAll()
1339
+
1340
+ c.setPlayWhenReady(true)
1341
+
1342
+ #expect(cb.publishOrder == [
1343
+ "cancelAudioSessionRelease", "playWhenReady",
1344
+ "playingState", "activateAudioSession", "renderNowPlaying",
1345
+ ])
1346
+ }
1347
+
1348
+ @Test @MainActor
1349
+ func pause_rendersWithoutActivating_thenSchedulesTheRelease() throws {
1350
+ let (c, eh, cb) = makeTraced()
1351
+ try startPlaying(c, eh)
1352
+ cb.publishOrder.removeAll()
1353
+
1354
+ c.pause()
1355
+
1356
+ #expect(cb.publishOrder == [
1357
+ "playWhenReady", "playingState", "renderNowPlaying", "scheduleAudioSessionRelease",
1358
+ ])
1359
+ }
1360
+
1361
+ @Test @MainActor
1362
+ func playbackChange_rendersAfterJSHearsIt() throws {
1363
+ let (c, _, cb) = makeTraced()
1364
+ try loadTrack(c)
1365
+ cb.publishOrder.removeAll()
1366
+
1367
+ c.transition(.errorOccurred(.playbackFailed))
1368
+
1369
+ #expect(cb.publishOrder == ["playback", "renderNowPlaying"])
1370
+ }
1371
+
1372
+ @Test @MainActor
1373
+ func activeTrackChange_resetsTheNowPlayingLinesAfterJSHearsIt() throws {
1374
+ let (c, eh, cb, _) = makeCoordinator()
1375
+ eh.onSeamCall = { [weak cb] call in
1376
+ if call == "nowPlayingTrackChanged" { cb?.queueAndTrackOrder.append(call) }
1377
+ }
1378
+
1379
+ try c.setQueue([Track(id: "t1", src: "https://example.com/a.mp3", title: "A")])
1380
+
1381
+ #expect(cb.queueAndTrackOrder == ["queue", "activeTrack", "nowPlayingTrackChanged"])
1382
+ #expect(eh.nowPlayingTrackChangedCount == 1)
1383
+ }
1384
+
1385
+ @Test @MainActor
1386
+ func timedMetadata_reachesJSThenTheNowPlayingLines() {
1387
+ let (c, eh, cb) = makeTraced()
1388
+ let metadata = TimedMetadata(title: "Song", artist: "Artist")
1389
+
1390
+ eh.emit(.timedMetadata(metadata))
1391
+ withExtendedLifetime(c) {}
1392
+
1393
+ #expect(cb.publishOrder == ["timedMetadata", "applyTimedMetadata"])
1394
+ #expect(cb.timedMetadata == [metadata])
1395
+ #expect(eh.appliedTimedMetadata == [metadata])
1396
+ }
1397
+ }
1398
+
1399
+ @Suite("Player - now-playing preview")
1400
+ struct NowPlayingPreviewTests {
1401
+ @Test @MainActor
1402
+ func preview_showsTheTappedTrackWithoutLoadingIt() {
1403
+ let (c, eh, _, _) = makeCoordinator()
1404
+ let tapped = Track(id: "tapped", src: "https://example.com/tapped.mp3", title: "Tapped")
1405
+
1406
+ c.previewNowPlaying(tapped)
1407
+
1408
+ #expect(eh.loadNowPlayingMetadataCalls.map(\.id) == ["tapped"])
1409
+ #expect(eh.resolveAndLoadCalls.isEmpty)
1410
+ #expect(c.currentTrack == nil)
1411
+ }
1412
+
1413
+ @Test @MainActor
1414
+ func endingPreview_restoresTheCurrentTrackAndRendersItsLines() throws {
1415
+ let (c, eh, _, _) = makeCoordinator()
1416
+ try loadTrack(c, id: "current")
1417
+ c.previewNowPlaying(Track(id: "tapped", src: "https://example.com/tapped.mp3", title: "Tapped"))
1418
+ let rendersBefore = eh.nowPlayingRenderCount
1419
+
1420
+ c.endNowPlayingPreview()
1421
+
1422
+ #expect(eh.loadNowPlayingMetadataCalls.last?.id == "current")
1423
+ #expect(eh.nowPlayingRenderCount == rendersBefore + 1)
1424
+ #expect(eh.clearNowPlayingCallCount == 0)
1425
+ }
1426
+
1427
+ @Test @MainActor
1428
+ func endingPreview_withNothingCurrent_clearsTheSurface() {
1429
+ let (c, eh, _, _) = makeCoordinator()
1430
+ c.previewNowPlaying(Track(id: "tapped", src: "https://example.com/tapped.mp3", title: "Tapped"))
1431
+
1432
+ c.endNowPlayingPreview()
1433
+
1434
+ #expect(eh.clearNowPlayingCallCount == 1)
1435
+ #expect(eh.loadNowPlayingMetadataCalls.map(\.id) == ["tapped"])
1436
+ #expect(eh.nowPlayingRenderCount == 0)
1259
1437
  }
1260
1438
  }