react-native-audio-browser 0.2.0-next.7 → 0.2.0-next.71

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