react-native-audio-browser 0.2.0-next.4 → 0.2.0-next.41

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 (1026) hide show
  1. package/README.md +36 -22
  2. package/android/build.gradle +42 -15
  3. package/android/gradle.properties +2 -2
  4. package/android/src/main/AndroidManifest.xml +3 -1
  5. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +543 -280
  6. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +38 -0
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +18 -2
  8. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +131 -0
  9. package/android/src/main/java/com/audiobrowser/Service.kt +41 -11
  10. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  11. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  12. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  13. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  14. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  15. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  16. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  17. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  18. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  19. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  20. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  21. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  22. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  23. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  24. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +7 -0
  25. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +12 -12
  26. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +111 -58
  27. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  28. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  29. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  30. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +530 -230
  31. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +218 -252
  32. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +23 -26
  33. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  34. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  35. package/android/src/main/java/com/audiobrowser/player/Player.kt +130 -63
  36. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  37. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  38. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +12 -4
  39. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  40. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  41. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  42. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  43. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  44. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  45. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  46. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  47. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +62 -40
  48. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  49. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  50. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  51. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +56 -52
  52. package/android/src/main/res/values/strings.xml +25 -5
  53. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  54. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  55. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +159 -0
  56. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  57. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  58. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  59. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  60. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  61. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  62. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  63. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  64. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  65. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  66. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  67. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  68. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  69. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +385 -0
  70. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +101 -58
  71. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  72. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  73. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +45 -0
  74. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +42 -2
  75. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  76. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  77. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  78. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  79. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +192 -0
  80. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  81. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  82. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  83. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  84. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  85. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  86. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  87. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  88. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  89. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  90. package/ios/AVPlayerEngine.swift +362 -0
  91. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  92. package/ios/Browser/BrowseGate.swift +58 -0
  93. package/ios/Browser/BrowserConfig.swift +115 -81
  94. package/ios/Browser/BrowserError.swift +16 -0
  95. package/ios/Browser/BrowserManager.swift +155 -654
  96. package/ios/Browser/BrowserPathHelper.swift +68 -51
  97. package/ios/Browser/FavoriteSet.swift +46 -0
  98. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  99. package/ios/Browser/JsonModels.swift +270 -321
  100. package/ios/Browser/NavigationErrorState.swift +41 -0
  101. package/ios/Browser/PageResolver.swift +147 -0
  102. package/ios/Browser/RequestLayer.swift +185 -0
  103. package/ios/Browser/RequestPipeline.swift +303 -0
  104. package/ios/Browser/SearchDrillIn.swift +7 -7
  105. package/ios/Browser/SectionScope.swift +82 -23
  106. package/ios/Browser/SimpleRouter.swift +73 -144
  107. package/ios/Browser/StyleResolver.swift +58 -0
  108. package/ios/Browser/TabBarEntries.swift +9 -3
  109. package/ios/Browser/TrackIdTemplate.swift +37 -0
  110. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  111. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  112. package/ios/CarPlay/CarPlayController.swift +37 -1297
  113. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  114. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  115. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  116. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  117. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  118. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  119. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  120. package/ios/CarPlay/CarPlaySession.swift +207 -0
  121. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  122. package/ios/CarPlay/IntentHandlers.swift +96 -0
  123. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  124. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  125. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  126. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  127. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  128. package/ios/CarPlay/SectionPresentation.swift +77 -0
  129. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  130. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  131. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  132. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  133. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  134. package/ios/Extension/SearchParams+Query.swift +28 -0
  135. package/ios/Extension/Section+Copying.swift +29 -0
  136. package/ios/Extension/String+IcyCharset.swift +21 -0
  137. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  138. package/ios/Extension/Track+AVPlayer.swift +0 -16
  139. package/ios/Extension/Track+Copying.swift +11 -13
  140. package/ios/Extension/Track+Identity.swift +25 -0
  141. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  142. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  143. package/ios/Extension/URLError+Connectivity.swift +15 -0
  144. package/ios/Http/HttpClient.swift +71 -165
  145. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  146. package/ios/HybridAudioBrowser+Options.swift +105 -0
  147. package/ios/HybridAudioBrowser+Player.swift +341 -0
  148. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  149. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  150. package/ios/HybridAudioBrowser.swift +132 -1652
  151. package/ios/Model/NitroTypeStubs.swift +239 -24
  152. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  153. package/ios/Model/RemoteCommand.swift +6 -60
  154. package/ios/Model/TrackPlayerError.swift +2 -2
  155. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  156. package/ios/Observer/ItemObserver.swift +90 -0
  157. package/ios/Observer/PlayerObserver.swift +59 -0
  158. package/ios/Option/SessionCategories.swift +42 -92
  159. package/ios/Player/AudioSessionController.swift +191 -0
  160. package/ios/Player/DeferredSeek.swift +70 -0
  161. package/ios/Player/ErrorStatus.swift +50 -0
  162. package/ios/Player/MediaLoader.swift +66 -87
  163. package/ios/Player/NowPlayingLines.swift +36 -0
  164. package/ios/Player/NowPlayingUpdater.swift +180 -85
  165. package/ios/Player/PlaybackFailure.swift +125 -0
  166. package/ios/Player/PlaybackPersistence.swift +73 -0
  167. package/ios/Player/PlaybackTimer.swift +8 -2
  168. package/ios/Player/Player.swift +960 -0
  169. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  170. package/ios/Player/PlayerEngine.swift +104 -0
  171. package/ios/Player/PlayerStatusTypes.swift +2 -6
  172. package/ios/Player/QueueManager.swift +93 -67
  173. package/ios/Player/RetryLoop.swift +291 -0
  174. package/ios/Player/ShuffleOrder.swift +33 -0
  175. package/ios/Player/SleepTimerManager.swift +14 -16
  176. package/ios/Player/VolumeFader.swift +5 -0
  177. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  178. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  179. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  180. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  181. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  182. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  183. package/ios/Tests/DeferredSeekTests.swift +70 -0
  184. package/ios/Tests/EmitterTests.swift +22 -38
  185. package/ios/Tests/ErrorStatusTests.swift +50 -0
  186. package/ios/Tests/FavoriteSetTests.swift +60 -0
  187. package/ios/Tests/GenerationMemoTests.swift +121 -0
  188. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  189. package/ios/Tests/JsonModelsTests.swift +194 -1
  190. package/ios/Tests/LRUCacheTests.swift +110 -0
  191. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  192. package/ios/Tests/MediaLoaderTests.swift +36 -67
  193. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  194. package/ios/Tests/NowPlayingLinesTests.swift +43 -0
  195. package/ios/Tests/ObserverTests.swift +88 -0
  196. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  197. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  198. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  199. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  200. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +489 -311
  201. package/ios/Tests/PlayingStateTests.swift +42 -0
  202. package/ios/Tests/QueueManagerTests.swift +196 -115
  203. package/ios/Tests/ReadyValueTests.swift +73 -0
  204. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  205. package/ios/Tests/RequestLayerTests.swift +228 -0
  206. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  207. package/ios/Tests/RetryLoopTests.swift +305 -0
  208. package/ios/Tests/SearchDrillInTests.swift +16 -16
  209. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  210. package/ios/Tests/SectionPresentationTests.swift +98 -0
  211. package/ios/Tests/SectionScopeTests.swift +139 -54
  212. package/ios/Tests/SimpleRouterTests.swift +38 -3
  213. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  214. package/ios/Tests/StyleResolverTests.swift +132 -0
  215. package/ios/Tests/Support/TestTypes.swift +146 -101
  216. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  217. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  218. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  219. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  220. package/ios/Tests/TrackIdentityTests.swift +20 -0
  221. package/ios/Tests/TrackSelectorTests.swift +168 -33
  222. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  223. package/ios/TrackSelector.swift +62 -65
  224. package/ios/Util/ArtworkImageFetcher.swift +58 -1
  225. package/ios/Util/ConcurrentMap.swift +19 -0
  226. package/ios/Util/Emitter.swift +40 -12
  227. package/ios/Util/GenerationMemo.swift +36 -0
  228. package/ios/Util/LRUCache.swift +23 -159
  229. package/ios/Util/NetworkMonitor.swift +32 -32
  230. package/ios/Util/OutputPicker.swift +48 -0
  231. package/ios/Util/ReadyValue.swift +56 -0
  232. package/ios/Util/SFSymbolRenderer.swift +59 -31
  233. package/ios/Util/SVGProcessor.swift +9 -12
  234. package/lib/commonjs/AudioBrowser.js +8 -8
  235. package/lib/commonjs/AudioBrowser.js.map +1 -1
  236. package/lib/commonjs/CLAUDE.md +52 -0
  237. package/lib/commonjs/features/browser-config.js +12 -8
  238. package/lib/commonjs/features/browser-config.js.map +1 -1
  239. package/lib/commonjs/features/browser.js +11 -3
  240. package/lib/commonjs/features/browser.js.map +1 -1
  241. package/lib/commonjs/features/carConnection.js +1 -1
  242. package/lib/commonjs/features/equalizer.js +1 -1
  243. package/lib/commonjs/features/errors.js +3 -3
  244. package/lib/commonjs/features/favorites.js +14 -11
  245. package/lib/commonjs/features/favorites.js.map +1 -1
  246. package/lib/commonjs/features/gate.js +16 -1
  247. package/lib/commonjs/features/gate.js.map +1 -1
  248. package/lib/commonjs/features/metadata.js +20 -3
  249. package/lib/commonjs/features/metadata.js.map +1 -1
  250. package/lib/commonjs/features/network.js +1 -1
  251. package/lib/commonjs/features/nowPlaying.js +1 -1
  252. package/lib/commonjs/features/output.js +1 -1
  253. package/lib/commonjs/features/playback/controls.js +4 -2
  254. package/lib/commonjs/features/playback/controls.js.map +1 -1
  255. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  256. package/lib/commonjs/features/playback/playing.js +1 -1
  257. package/lib/commonjs/features/playback/progress.js +3 -2
  258. package/lib/commonjs/features/playback/progress.js.map +1 -1
  259. package/lib/commonjs/features/playback/rate.js +8 -1
  260. package/lib/commonjs/features/playback/rate.js.map +1 -1
  261. package/lib/commonjs/features/playback/state.js +3 -4
  262. package/lib/commonjs/features/playback/state.js.map +1 -1
  263. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  264. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  265. package/lib/commonjs/features/playback/volume.js +1 -1
  266. package/lib/commonjs/features/player/options.js +48 -34
  267. package/lib/commonjs/features/player/options.js.map +1 -1
  268. package/lib/commonjs/features/player/setup.js +18 -9
  269. package/lib/commonjs/features/player/setup.js.map +1 -1
  270. package/lib/commonjs/features/player/validateOptions.js +23 -0
  271. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  272. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  273. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  274. package/lib/commonjs/features/queue/queue.js +13 -6
  275. package/lib/commonjs/features/queue/queue.js.map +1 -1
  276. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  277. package/lib/commonjs/features/queue/shuffle.js +1 -1
  278. package/lib/commonjs/features/remoteControls.js +13 -92
  279. package/lib/commonjs/features/remoteControls.js.map +1 -1
  280. package/lib/commonjs/features/sleepTimer.js +13 -1
  281. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  282. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  283. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  284. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  285. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  286. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  287. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  288. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  289. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  290. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  291. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  292. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  293. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  294. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  295. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  296. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  297. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  298. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  299. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  300. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  301. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  302. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  303. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  304. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  305. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  306. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  307. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  308. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  309. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  310. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  311. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  312. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  313. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  314. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  315. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  316. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  317. package/lib/commonjs/web/browser/sections.js +89 -0
  318. package/lib/commonjs/web/browser/sections.js.map +1 -0
  319. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  320. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  321. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  322. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  323. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  324. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  325. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  326. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  327. package/lib/module/AudioBrowser.js +2 -1
  328. package/lib/module/AudioBrowser.js.map +1 -1
  329. package/lib/module/CLAUDE.md +52 -0
  330. package/lib/module/features/browser-config.js +12 -8
  331. package/lib/module/features/browser-config.js.map +1 -1
  332. package/lib/module/features/browser.js +11 -3
  333. package/lib/module/features/browser.js.map +1 -1
  334. package/lib/module/features/carConnection.js +1 -1
  335. package/lib/module/features/equalizer.js +1 -1
  336. package/lib/module/features/errors.js +3 -3
  337. package/lib/module/features/favorites.js +14 -11
  338. package/lib/module/features/favorites.js.map +1 -1
  339. package/lib/module/features/gate.js +16 -1
  340. package/lib/module/features/gate.js.map +1 -1
  341. package/lib/module/features/metadata.js +20 -3
  342. package/lib/module/features/metadata.js.map +1 -1
  343. package/lib/module/features/network.js +1 -1
  344. package/lib/module/features/nowPlaying.js +1 -1
  345. package/lib/module/features/output.js +1 -1
  346. package/lib/module/features/playback/controls.js +4 -2
  347. package/lib/module/features/playback/controls.js.map +1 -1
  348. package/lib/module/features/playback/playWhenReady.js +1 -1
  349. package/lib/module/features/playback/playing.js +1 -1
  350. package/lib/module/features/playback/progress.js +3 -2
  351. package/lib/module/features/playback/progress.js.map +1 -1
  352. package/lib/module/features/playback/rate.js +8 -1
  353. package/lib/module/features/playback/rate.js.map +1 -1
  354. package/lib/module/features/playback/state.js +3 -4
  355. package/lib/module/features/playback/state.js.map +1 -1
  356. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  357. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  358. package/lib/module/features/playback/volume.js +1 -1
  359. package/lib/module/features/player/options.js +47 -32
  360. package/lib/module/features/player/options.js.map +1 -1
  361. package/lib/module/features/player/setup.js +17 -8
  362. package/lib/module/features/player/setup.js.map +1 -1
  363. package/lib/module/features/player/validateOptions.js +19 -0
  364. package/lib/module/features/player/validateOptions.js.map +1 -0
  365. package/lib/module/features/queue/activeTrack.js +15 -4
  366. package/lib/module/features/queue/activeTrack.js.map +1 -1
  367. package/lib/module/features/queue/queue.js +13 -6
  368. package/lib/module/features/queue/queue.js.map +1 -1
  369. package/lib/module/features/queue/repeatMode.js +1 -1
  370. package/lib/module/features/queue/shuffle.js +1 -1
  371. package/lib/module/features/remoteControls.js +13 -92
  372. package/lib/module/features/remoteControls.js.map +1 -1
  373. package/lib/module/features/sleepTimer.js +13 -1
  374. package/lib/module/features/sleepTimer.js.map +1 -1
  375. package/lib/module/test-utils/reactNativeStub.js +58 -0
  376. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  377. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  378. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  379. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  380. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  381. package/lib/module/utils/getTrackIdentity.js +20 -0
  382. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  383. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  384. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  385. package/lib/module/web/NativeAudioBrowser.js +202 -77
  386. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  387. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  388. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  389. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  390. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  391. package/lib/module/web/TrackPlayer/Player.js +254 -39
  392. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  393. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  394. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  395. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  396. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  397. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  398. package/lib/module/web/browser/BrowserManager.js +175 -100
  399. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  400. package/lib/module/web/browser/FavoriteManager.js +31 -21
  401. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  402. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  403. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  404. package/lib/module/web/browser/SearchManager.js +18 -23
  405. package/lib/module/web/browser/SearchManager.js.map +1 -1
  406. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  407. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  408. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  409. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  410. package/lib/module/web/browser/sections.js +83 -0
  411. package/lib/module/web/browser/sections.js.map +1 -0
  412. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  413. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  414. package/lib/module/web/http/followMediaRedirect.js +215 -0
  415. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  416. package/lib/module/web/player/NowPlayingManager.js +4 -3
  417. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  418. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  419. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  420. package/lib/typescript/package.json +1 -0
  421. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  422. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  423. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  424. package/lib/typescript/src/features/browser.d.ts +10 -2
  425. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  426. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  427. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  428. package/lib/typescript/src/features/errors.d.ts +3 -3
  429. package/lib/typescript/src/features/favorites.d.ts +14 -11
  430. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  431. package/lib/typescript/src/features/gate.d.ts +18 -2
  432. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  433. package/lib/typescript/src/features/metadata.d.ts +20 -3
  434. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  435. package/lib/typescript/src/features/network.d.ts +1 -1
  436. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  437. package/lib/typescript/src/features/output.d.ts +1 -1
  438. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  439. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  440. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  441. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  442. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  443. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  444. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  445. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  446. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  447. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  448. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  449. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  450. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  451. package/lib/typescript/src/features/player/options.d.ts +108 -56
  452. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  453. package/lib/typescript/src/features/player/setup.d.ts +14 -4
  454. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  455. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  456. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  457. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  458. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  459. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  460. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  461. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  462. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  463. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  464. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  465. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  466. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  467. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  468. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  469. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  470. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  471. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  472. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  473. package/lib/typescript/src/types/browser.d.ts +93 -61
  474. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  475. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  476. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  477. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  478. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  479. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  480. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  481. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  482. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  483. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  484. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  485. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +1 -2
  486. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  487. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  488. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  489. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +12 -12
  490. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  491. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  492. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  493. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  494. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  495. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  496. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  497. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  498. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  499. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  500. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  501. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  502. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  503. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  504. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  505. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  506. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  507. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  508. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  509. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  510. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  511. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  512. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  513. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  514. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  515. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  516. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  517. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  518. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  519. 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
  520. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  521. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  522. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  523. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  524. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  525. 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
  526. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  527. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  528. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  529. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  530. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  531. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  532. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  533. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  534. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +9 -12
  535. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  536. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  537. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  538. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  539. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  540. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  541. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  542. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  543. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  544. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  545. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  546. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  547. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  548. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  549. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  550. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  551. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  552. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  553. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  554. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  555. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  556. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  557. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  558. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  559. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  560. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  561. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  564. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  565. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  566. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -53
  567. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  568. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  572. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  573. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  574. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  575. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  576. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  577. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  578. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  579. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  581. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  582. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  583. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  584. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  585. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +17 -14
  586. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +9 -12
  587. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  588. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  589. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  590. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  591. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +12 -12
  592. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  593. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  594. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  595. package/nitrogen/generated/android/c++/JOptions.hpp +9 -12
  596. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  597. package/nitrogen/generated/android/c++/JOutputType.hpp +2 -2
  598. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  599. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  600. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  602. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  605. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  607. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  608. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  609. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  610. package/nitrogen/generated/android/c++/{JNotificationButton.hpp → JRemoteButton.hpp} +19 -19
  611. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +86 -0
  612. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  613. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  616. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  619. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  621. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  622. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  623. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  625. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  626. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  627. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  628. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  630. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  631. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  632. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  633. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  634. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  635. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  637. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  638. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  639. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  640. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  641. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  642. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp +26 -0
  643. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +75 -0
  644. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  645. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  646. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  647. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +20 -3
  648. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  649. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  650. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  651. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  652. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  653. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  654. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  655. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  656. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  657. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  658. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  659. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  660. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  661. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  662. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  663. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  664. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  665. 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
  666. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  667. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  668. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  669. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  670. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  671. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  672. 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
  673. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  674. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  675. 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
  676. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  677. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  678. 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
  679. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  680. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  681. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  682. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  683. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  684. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  685. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  686. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  687. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  688. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  689. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  690. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  691. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  692. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  693. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  694. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  695. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  696. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  697. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  698. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  699. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  700. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  701. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  702. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  703. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  704. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  705. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  706. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  707. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  708. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  709. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  710. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  711. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  712. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  713. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  714. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  715. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  716. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  717. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  718. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  719. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +29 -0
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +20 -3
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  739. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  746. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  749. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{NotificationButton.kt → RemoteButton.kt} +3 -3
  752. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +61 -0
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Variant_NullType_NotificationButtonLayout.kt → Variant_NullType_RemoteButtonLayout.kt} +24 -15
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  782. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  783. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  784. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  785. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +779 -665
  786. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +34 -16
  787. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +36 -18
  788. package/nitrogen/generated/ios/swift/AndroidOptions.swift +12 -12
  789. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  790. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  791. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  792. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  793. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  794. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  795. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  796. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  797. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  798. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  799. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  800. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  801. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  802. package/nitrogen/generated/ios/swift/NitroAndroidUpdateOptions.swift +12 -12
  803. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  804. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  805. package/nitrogen/generated/ios/swift/{NotificationButton.swift → RemoteButton.swift} +6 -6
  806. package/nitrogen/generated/ios/swift/RemoteButtonLayout.swift +57 -0
  807. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  808. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  809. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  810. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  811. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  812. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  813. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  814. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  815. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  816. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  817. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +30 -0
  818. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  819. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  820. package/nitrogen/generated/shared/c++/AndroidOptions.hpp +8 -8
  821. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  822. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  823. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  824. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  825. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  826. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  827. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  828. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  829. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  830. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  831. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  832. package/nitrogen/generated/shared/c++/NitroAndroidUpdateOptions.hpp +8 -8
  833. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  834. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  835. package/nitrogen/generated/shared/c++/{NotificationButton.hpp → RemoteButton.hpp} +19 -19
  836. package/nitrogen/generated/shared/c++/RemoteButtonLayout.hpp +94 -0
  837. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  838. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  839. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  840. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  841. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  842. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  843. package/package.json +24 -11
  844. package/src/AudioBrowser.ts +2 -1
  845. package/src/CLAUDE.md +52 -0
  846. package/src/features/battery.test.ts +79 -0
  847. package/src/features/browser-config.test.ts +21 -6
  848. package/src/features/browser-config.ts +12 -8
  849. package/src/features/browser.test.ts +1 -1
  850. package/src/features/browser.ts +11 -3
  851. package/src/features/carConnection.ts +1 -1
  852. package/src/features/equalizer.ts +1 -1
  853. package/src/features/errors.ts +3 -3
  854. package/src/features/favorites.ts +14 -11
  855. package/src/features/gate.ts +16 -1
  856. package/src/features/hook-wiring.test.ts +302 -0
  857. package/src/features/metadata.ts +20 -3
  858. package/src/features/network.ts +1 -1
  859. package/src/features/nowPlaying.ts +1 -1
  860. package/src/features/output.ts +1 -1
  861. package/src/features/playback/controls.ts +4 -2
  862. package/src/features/playback/playWhenReady.ts +1 -1
  863. package/src/features/playback/playing.ts +1 -1
  864. package/src/features/playback/progress.test.ts +169 -0
  865. package/src/features/playback/progress.ts +3 -2
  866. package/src/features/playback/rate.ts +8 -1
  867. package/src/features/playback/state.ts +3 -4
  868. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  869. package/src/features/playback/trackPlaybackTime.ts +1 -6
  870. package/src/features/playback/volume.ts +1 -1
  871. package/src/features/player/options.ts +126 -76
  872. package/src/features/player/setup.test.ts +24 -7
  873. package/src/features/player/setup.ts +22 -10
  874. package/src/features/player/validateOptions.ts +21 -0
  875. package/src/features/queue/activeTrack.ts +15 -4
  876. package/src/features/queue/queue.ts +13 -6
  877. package/src/features/queue/repeatMode.ts +1 -1
  878. package/src/features/queue/shuffle.ts +1 -1
  879. package/src/features/remoteControls.ts +13 -92
  880. package/src/features/sleepTimer.test.ts +172 -0
  881. package/src/features/sleepTimer.ts +9 -1
  882. package/src/nitro-stub-drift.test.ts +277 -0
  883. package/src/public-surface.test.ts +147 -0
  884. package/src/specs/audio-browser.nitro.ts +5 -4
  885. package/src/style-resolution.test.ts +210 -0
  886. package/src/test-utils/reactNativeStub.ts +60 -0
  887. package/src/types/browser-native.ts +7 -3
  888. package/src/types/browser-nodes.ts +403 -134
  889. package/src/types/browser.ts +97 -63
  890. package/src/utils/LazyNativeEmitter.ts +28 -15
  891. package/src/utils/NativeUpdatedValue.ts +29 -13
  892. package/src/utils/getTrackIdentity.ts +20 -0
  893. package/src/utils/useDebug.test.ts +182 -0
  894. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  895. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  896. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  897. package/src/web/NativeAudioBrowser.ts +241 -84
  898. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  899. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  900. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  901. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  902. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  903. package/src/web/TrackPlayer/Player.ts +284 -37
  904. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  905. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  906. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  907. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  908. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  909. package/src/web/__tests__/lifecycle.test.ts +345 -0
  910. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  911. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  912. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  913. package/src/web/__tests__/retry.test.ts +169 -0
  914. package/src/web/browser/BrowserManager.ts +209 -111
  915. package/src/web/browser/FavoriteManager.test.ts +84 -0
  916. package/src/web/browser/FavoriteManager.ts +28 -23
  917. package/src/web/browser/NavigationErrorManager.ts +3 -1
  918. package/src/web/browser/SearchManager.test.ts +75 -0
  919. package/src/web/browser/SearchManager.ts +25 -28
  920. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  921. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  922. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  923. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  924. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  925. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  926. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  927. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  928. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  929. package/src/web/browser/sections.test.ts +91 -0
  930. package/src/web/browser/sections.ts +72 -0
  931. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  932. package/src/web/http/RequestConfigBuilder.ts +140 -33
  933. package/src/web/http/followMediaRedirect.test.ts +289 -0
  934. package/src/web/http/followMediaRedirect.ts +253 -0
  935. package/src/web/player/NowPlayingManager.ts +4 -3
  936. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  937. package/src/web/util/BrowserPathHelper.ts +70 -13
  938. package/website/guide/android-auto.md +114 -0
  939. package/website/guide/android-certificates.md +409 -0
  940. package/website/guide/artwork.md +255 -0
  941. package/website/guide/audio-output.md +135 -0
  942. package/website/guide/automotive.md +86 -0
  943. package/website/guide/basic-usage.md +151 -0
  944. package/website/guide/battery.md +115 -0
  945. package/website/guide/browser.md +587 -0
  946. package/website/guide/carplay.md +650 -0
  947. package/website/guide/configuration.md +173 -0
  948. package/website/guide/equalizer.md +231 -0
  949. package/website/guide/errors.md +310 -0
  950. package/website/guide/favorites.md +154 -0
  951. package/website/guide/gate.md +143 -0
  952. package/website/guide/getting-started.md +46 -0
  953. package/website/guide/hooks.md +238 -0
  954. package/website/guide/live-streams.md +125 -0
  955. package/website/guide/metadata.md +239 -0
  956. package/website/guide/migrating-from-track-player.md +244 -0
  957. package/website/guide/native-callback-fetch.md +127 -0
  958. package/website/guide/network.md +86 -0
  959. package/website/guide/now-playing.md +175 -0
  960. package/website/guide/playback.md +328 -0
  961. package/website/guide/queue.md +300 -0
  962. package/website/guide/remote-controls.md +256 -0
  963. package/website/guide/search.md +255 -0
  964. package/website/guide/sleep-timer.md +268 -0
  965. package/website/guide/track.md +247 -0
  966. package/ios/Bridge.h +0 -8
  967. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  968. package/ios/Browser/MediaResolveComposer.swift +0 -114
  969. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  970. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  971. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  972. package/ios/Model/MediaURL.swift +0 -67
  973. package/ios/Model/SourceType.swift +0 -6
  974. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  975. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  976. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  977. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  978. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  979. package/ios/Observer/PlayerStateObserver.swift +0 -50
  980. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  981. package/ios/Option/PitchAlgorithms.swift +0 -17
  982. package/ios/Option/TimeEventFrequency.swift +0 -18
  983. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  984. package/ios/Player/MediaIntentCriteria.swift +0 -139
  985. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  986. package/ios/Player/PlaybackCoordinator.swift +0 -754
  987. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  988. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  989. package/ios/Player/PlaybackStateStore.swift +0 -27
  990. package/ios/Player/PlayingStateManager.swift +0 -33
  991. package/ios/Player/RetryManager.swift +0 -322
  992. package/ios/Player/SeekCompletionHandler.swift +0 -3
  993. package/ios/Player/SleepTimerHandling.swift +0 -15
  994. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  995. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  996. package/ios/Tests/MediaResolveTests.swift +0 -126
  997. package/ios/Tests/OnceValueTests.swift +0 -79
  998. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  999. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1000. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1001. package/ios/Tests/RetryManagerTests.swift +0 -89
  1002. package/ios/TrackPlayer.swift +0 -1014
  1003. package/ios/TrackPlayerCallbacks.swift +0 -86
  1004. package/ios/Util/MetadataAdapter.swift +0 -131
  1005. package/ios/Util/OnceValue.swift +0 -104
  1006. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1007. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1008. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1009. package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp +0 -94
  1010. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1011. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1012. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp +0 -26
  1013. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp +0 -75
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt +0 -50
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1018. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1019. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1020. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1021. package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift +0 -92
  1022. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1023. package/nitrogen/generated/ios/swift/Variant_NullType_NotificationButtonLayout.swift +0 -18
  1024. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1025. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
  1026. package/nitrogen/generated/shared/c++/NotificationButtonLayout.hpp +0 -102
@@ -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
  ) {
32
29
  let track = Track(id: id, src: src, title: title)
33
- coordinator.setQueue([track])
30
+ 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
38
  func toReady_startsPlayback_whenPlayWhenReady() {
42
39
  let (c, eh, _, _) = makeCoordinator()
43
40
  loadTrack(c)
44
- c.playWhenReady = true
41
+ c.setPlayWhenReady(true)
45
42
  eh.startPlaybackCallCount = 0 // reset from playWhenReady setter
46
43
 
47
44
  c.transition(.bufferingSufficient)
@@ -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() {
@@ -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
410
  func true_fromError_triggersReload() {
421
411
  let (c, eh, _, _) = makeCoordinator()
412
+ 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
428
  func true_fromStopped_triggersReload() {
432
429
  let (c, eh, _, _) = makeCoordinator()
430
+ 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
  [
@@ -541,25 +542,25 @@ 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
548
  func clearsError_beforeTransition() {
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
554
  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
561
  func preservesPlayWhenReady_acrossLoading() {
561
562
  let (c, _, _, _) = makeCoordinator()
562
- c.playWhenReady = true
563
+ c.setPlayWhenReady(true)
563
564
 
564
565
  loadTrack(c)
565
566
 
@@ -575,7 +576,7 @@ struct HandleCurrentTrackChangedTests {
575
576
  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
 
@@ -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
602
  func repeatTrack_replays() {
602
603
  let (c, eh, _, _) = makeCoordinator()
603
- loadTrack(c)
604
+ 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
@@ -620,23 +621,22 @@ struct HandleTrackDidPlayToEndTimeTests {
620
621
  let (c, eh, cb, _) = makeCoordinator()
621
622
  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
634
  func lastTrack_noRepeat_transitionsToEnded() {
634
635
  let (c, eh, cb, _) = makeCoordinator()
635
- _ = eh // retain weak effectHandler
636
636
  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)
@@ -644,7 +644,7 @@ struct HandleTrackDidPlayToEndTimeTests {
644
644
 
645
645
  @Test @MainActor
646
646
  func midQueue_advancesToNext() {
647
- let (c, _, cb, _) = makeCoordinator()
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"),
@@ -652,9 +652,9 @@ struct HandleTrackDidPlayToEndTimeTests {
652
652
  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,14 +666,14 @@ 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
672
  func naturalEnd_clearsPlayWhenReady() {
673
673
  let (c, eh, _, _) = makeCoordinator()
674
674
  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)
@@ -681,13 +681,13 @@ struct NaturalEndPlayIntentTests {
681
681
 
682
682
  @Test @MainActor
683
683
  func naturalEnd_requestsSessionRelease() {
684
- let (c, eh, callbacks, _) = makeCoordinator()
684
+ let (c, eh, _, _) = makeCoordinator()
685
685
  startPlaying(c, eh)
686
- callbacks.releaseSessionCount = 0
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
@@ -696,12 +696,14 @@ struct NaturalEndPlayIntentTests {
696
696
  func playAfterNaturalEnd_reloadsFromStart() {
697
697
  let (c, eh, _, _) = makeCoordinator()
698
698
  startPlaying(c, eh)
699
- c.handleTrackDidPlayToEndTime()
700
- eh.reloadTrackCalls.removeAll()
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
@@ -711,10 +713,10 @@ struct NaturalEndPlayIntentTests {
711
713
  func strayPauseAfterNaturalEnd_staysEnded() {
712
714
  let (c, eh, _, _) = makeCoordinator()
713
715
  startPlaying(c, eh)
714
- c.handleTrackDidPlayToEndTime()
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
  }
@@ -723,14 +725,14 @@ struct NaturalEndPlayIntentTests {
723
725
  func interruptionAfterNaturalEnd_doesNotArmResume() {
724
726
  let (c, eh, _, _) = makeCoordinator()
725
727
  startPlaying(c, eh)
726
- c.handleTrackDidPlayToEndTime()
727
- eh.reloadTrackCalls.removeAll()
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
830
  func completion_pausesThenRestoresPreFadeVolume() {
904
- let (c, eh, _, st) = makeCoordinator()
831
+ let (c, eh, _, clock) = makeCoordinator()
905
832
  loadTrack(c)
906
- c.playWhenReady = true
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
849
  func completion_withoutFade_justPauses() {
923
- let (c, eh, _, st) = makeCoordinator()
850
+ let (c, eh, _, clock) = makeCoordinator()
924
851
  loadTrack(c)
925
- c.playWhenReady = true
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,54 +861,56 @@ 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
877
  func pauseDuringFade_clearsSleepTimer() {
950
- let (c, _, _, st) = makeCoordinator()
878
+ let (c, _, _, clock) = makeCoordinator()
951
879
  loadTrack(c)
952
- c.playWhenReady = true
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
889
  func pauseWithoutFade_leavesSleepTimerAlone() {
962
- let (c, _, _, st) = makeCoordinator()
890
+ let (c, _, _, _) = makeCoordinator()
963
891
  loadTrack(c)
964
- c.playWhenReady = true
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) {
905
+ private func startPlaying(_ c: Player, _ eh: MockPlayerEngine) {
977
906
  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
916
  func began_whilePlaying_pauses() {
@@ -1002,7 +932,7 @@ struct InterruptionTests {
1002
932
  let (c, eh, _, _) = makeCoordinator()
1003
933
  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()
@@ -1090,13 +1020,14 @@ struct InterruptionTests {
1090
1020
  let (c, eh, _, _) = makeCoordinator()
1091
1021
  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
@@ -1119,8 +1050,8 @@ struct InterruptionTests {
1119
1050
  let (c, eh, _, _) = makeCoordinator()
1120
1051
  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,10 +1063,9 @@ 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 {
@@ -1149,6 +1079,7 @@ 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
 
@@ -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() {
1157
+ let (c, eh, _, _) = makeCoordinator()
1158
+ 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() {
1173
+ let (c, eh, _, _) = makeCoordinator()
1174
+ 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() {
1205
+ let (c, _, cb, _) = makeCoordinator()
1206
+ 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
+ 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() {
1222
+ let (c, _, cb, _) = makeCoordinator()
1223
+ 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
+ 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
1274
  func deliberatePause_requestsRelease() {
1216
- let (c, eh, callbacks, _) = makeCoordinator()
1275
+ let (c, eh, _, _) = makeCoordinator()
1217
1276
  startPlaying(c, eh)
1218
- callbacks.releaseSessionCount = 0
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
1283
  func play_doesNotRequestRelease() {
1225
- let (c, eh, callbacks, _) = makeCoordinator()
1284
+ let (c, eh, _, _) = makeCoordinator()
1226
1285
  startPlaying(c, eh)
1227
- #expect(callbacks.releaseSessionCount == 0)
1286
+ #expect(eh.scheduleAudioSessionReleaseCount == 0)
1228
1287
  }
1229
1288
 
1230
1289
  @Test @MainActor
1231
1290
  func interruptionBegan_doesNotRequestRelease() {
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()
1293
+ let (c, eh, _, _) = makeCoordinator()
1235
1294
  startPlaying(c, eh)
1236
- callbacks.releaseSessionCount = 0
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
1301
  func interruptionEnded_withResume_doesNotRequestRelease() {
1243
- let (c, eh, callbacks, _) = makeCoordinator()
1302
+ let (c, eh, _, _) = makeCoordinator()
1244
1303
  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
1311
  func interruptionEnded_withoutResume_requestsRelease() {
1253
- let (c, eh, callbacks, _) = makeCoordinator()
1312
+ let (c, eh, _, _) = makeCoordinator()
1254
1313
  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() {
1336
+ let (c, _, cb) = makeTraced()
1337
+ 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() {
1350
+ let (c, eh, cb) = makeTraced()
1351
+ 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() {
1363
+ let (c, _, cb) = makeTraced()
1364
+ 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() {
1374
+ let (c, eh, cb, _) = makeCoordinator()
1375
+ eh.onSeamCall = { [weak cb] call in
1376
+ if call == "nowPlayingTrackChanged" { cb?.queueAndTrackOrder.append(call) }
1377
+ }
1378
+
1379
+ 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() {
1415
+ let (c, eh, _, _) = makeCoordinator()
1416
+ 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
  }