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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1026) hide show
  1. package/README.md +36 -22
  2. package/android/build.gradle +42 -15
  3. package/android/gradle.properties +2 -2
  4. package/android/src/main/AndroidManifest.xml +3 -1
  5. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +543 -280
  6. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +38 -0
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +18 -2
  8. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +131 -0
  9. package/android/src/main/java/com/audiobrowser/Service.kt +41 -11
  10. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  11. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  12. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  13. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  14. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  15. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  16. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  17. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  18. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  19. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  20. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  21. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  22. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  23. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  24. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +7 -0
  25. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +12 -12
  26. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +111 -58
  27. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  28. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  29. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  30. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +530 -230
  31. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +218 -252
  32. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +23 -26
  33. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  34. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  35. package/android/src/main/java/com/audiobrowser/player/Player.kt +130 -63
  36. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  37. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  38. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +12 -4
  39. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  40. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  41. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  42. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  43. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  44. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  45. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  46. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  47. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +62 -40
  48. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  49. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  50. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  51. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +56 -52
  52. package/android/src/main/res/values/strings.xml +25 -5
  53. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  54. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  55. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +159 -0
  56. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  57. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  58. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  59. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  60. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  61. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  62. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  63. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  64. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  65. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  66. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  67. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  68. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  69. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +385 -0
  70. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +101 -58
  71. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  72. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  73. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +45 -0
  74. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +42 -2
  75. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  76. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  77. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  78. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  79. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +192 -0
  80. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  81. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  82. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  83. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  84. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  85. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  86. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  87. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  88. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  89. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  90. package/ios/AVPlayerEngine.swift +362 -0
  91. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  92. package/ios/Browser/BrowseGate.swift +58 -0
  93. package/ios/Browser/BrowserConfig.swift +115 -81
  94. package/ios/Browser/BrowserError.swift +16 -0
  95. package/ios/Browser/BrowserManager.swift +155 -654
  96. package/ios/Browser/BrowserPathHelper.swift +68 -51
  97. package/ios/Browser/FavoriteSet.swift +46 -0
  98. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  99. package/ios/Browser/JsonModels.swift +270 -321
  100. package/ios/Browser/NavigationErrorState.swift +41 -0
  101. package/ios/Browser/PageResolver.swift +147 -0
  102. package/ios/Browser/RequestLayer.swift +185 -0
  103. package/ios/Browser/RequestPipeline.swift +303 -0
  104. package/ios/Browser/SearchDrillIn.swift +7 -7
  105. package/ios/Browser/SectionScope.swift +82 -23
  106. package/ios/Browser/SimpleRouter.swift +73 -144
  107. package/ios/Browser/StyleResolver.swift +58 -0
  108. package/ios/Browser/TabBarEntries.swift +9 -3
  109. package/ios/Browser/TrackIdTemplate.swift +37 -0
  110. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  111. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  112. package/ios/CarPlay/CarPlayController.swift +37 -1297
  113. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  114. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  115. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  116. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  117. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  118. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  119. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  120. package/ios/CarPlay/CarPlaySession.swift +207 -0
  121. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  122. package/ios/CarPlay/IntentHandlers.swift +96 -0
  123. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  124. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  125. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  126. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  127. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  128. package/ios/CarPlay/SectionPresentation.swift +77 -0
  129. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  130. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  131. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  132. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  133. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  134. package/ios/Extension/SearchParams+Query.swift +28 -0
  135. package/ios/Extension/Section+Copying.swift +29 -0
  136. package/ios/Extension/String+IcyCharset.swift +21 -0
  137. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  138. package/ios/Extension/Track+AVPlayer.swift +0 -16
  139. package/ios/Extension/Track+Copying.swift +11 -13
  140. package/ios/Extension/Track+Identity.swift +25 -0
  141. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  142. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  143. package/ios/Extension/URLError+Connectivity.swift +15 -0
  144. package/ios/Http/HttpClient.swift +71 -165
  145. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  146. package/ios/HybridAudioBrowser+Options.swift +105 -0
  147. package/ios/HybridAudioBrowser+Player.swift +341 -0
  148. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  149. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  150. package/ios/HybridAudioBrowser.swift +132 -1652
  151. package/ios/Model/NitroTypeStubs.swift +239 -24
  152. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  153. package/ios/Model/RemoteCommand.swift +6 -60
  154. package/ios/Model/TrackPlayerError.swift +2 -2
  155. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  156. package/ios/Observer/ItemObserver.swift +90 -0
  157. package/ios/Observer/PlayerObserver.swift +59 -0
  158. package/ios/Option/SessionCategories.swift +42 -92
  159. package/ios/Player/AudioSessionController.swift +191 -0
  160. package/ios/Player/DeferredSeek.swift +70 -0
  161. package/ios/Player/ErrorStatus.swift +50 -0
  162. package/ios/Player/MediaLoader.swift +66 -87
  163. package/ios/Player/NowPlayingLines.swift +36 -0
  164. package/ios/Player/NowPlayingUpdater.swift +180 -85
  165. package/ios/Player/PlaybackFailure.swift +125 -0
  166. package/ios/Player/PlaybackPersistence.swift +73 -0
  167. package/ios/Player/PlaybackTimer.swift +8 -2
  168. package/ios/Player/Player.swift +960 -0
  169. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  170. package/ios/Player/PlayerEngine.swift +104 -0
  171. package/ios/Player/PlayerStatusTypes.swift +2 -6
  172. package/ios/Player/QueueManager.swift +93 -67
  173. package/ios/Player/RetryLoop.swift +291 -0
  174. package/ios/Player/ShuffleOrder.swift +33 -0
  175. package/ios/Player/SleepTimerManager.swift +14 -16
  176. package/ios/Player/VolumeFader.swift +5 -0
  177. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  178. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  179. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  180. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  181. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  182. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  183. package/ios/Tests/DeferredSeekTests.swift +70 -0
  184. package/ios/Tests/EmitterTests.swift +22 -38
  185. package/ios/Tests/ErrorStatusTests.swift +50 -0
  186. package/ios/Tests/FavoriteSetTests.swift +60 -0
  187. package/ios/Tests/GenerationMemoTests.swift +121 -0
  188. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  189. package/ios/Tests/JsonModelsTests.swift +194 -1
  190. package/ios/Tests/LRUCacheTests.swift +110 -0
  191. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  192. package/ios/Tests/MediaLoaderTests.swift +36 -67
  193. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  194. package/ios/Tests/NowPlayingLinesTests.swift +43 -0
  195. package/ios/Tests/ObserverTests.swift +88 -0
  196. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  197. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  198. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  199. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  200. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +489 -311
  201. package/ios/Tests/PlayingStateTests.swift +42 -0
  202. package/ios/Tests/QueueManagerTests.swift +196 -115
  203. package/ios/Tests/ReadyValueTests.swift +73 -0
  204. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  205. package/ios/Tests/RequestLayerTests.swift +228 -0
  206. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  207. package/ios/Tests/RetryLoopTests.swift +305 -0
  208. package/ios/Tests/SearchDrillInTests.swift +16 -16
  209. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  210. package/ios/Tests/SectionPresentationTests.swift +98 -0
  211. package/ios/Tests/SectionScopeTests.swift +139 -54
  212. package/ios/Tests/SimpleRouterTests.swift +38 -3
  213. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  214. package/ios/Tests/StyleResolverTests.swift +132 -0
  215. package/ios/Tests/Support/TestTypes.swift +146 -101
  216. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  217. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  218. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  219. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  220. package/ios/Tests/TrackIdentityTests.swift +20 -0
  221. package/ios/Tests/TrackSelectorTests.swift +168 -33
  222. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  223. package/ios/TrackSelector.swift +62 -65
  224. package/ios/Util/ArtworkImageFetcher.swift +58 -1
  225. package/ios/Util/ConcurrentMap.swift +19 -0
  226. package/ios/Util/Emitter.swift +40 -12
  227. package/ios/Util/GenerationMemo.swift +36 -0
  228. package/ios/Util/LRUCache.swift +23 -159
  229. package/ios/Util/NetworkMonitor.swift +32 -32
  230. package/ios/Util/OutputPicker.swift +48 -0
  231. package/ios/Util/ReadyValue.swift +56 -0
  232. package/ios/Util/SFSymbolRenderer.swift +59 -31
  233. package/ios/Util/SVGProcessor.swift +9 -12
  234. package/lib/commonjs/AudioBrowser.js +8 -8
  235. package/lib/commonjs/AudioBrowser.js.map +1 -1
  236. package/lib/commonjs/CLAUDE.md +52 -0
  237. package/lib/commonjs/features/browser-config.js +12 -8
  238. package/lib/commonjs/features/browser-config.js.map +1 -1
  239. package/lib/commonjs/features/browser.js +11 -3
  240. package/lib/commonjs/features/browser.js.map +1 -1
  241. package/lib/commonjs/features/carConnection.js +1 -1
  242. package/lib/commonjs/features/equalizer.js +1 -1
  243. package/lib/commonjs/features/errors.js +3 -3
  244. package/lib/commonjs/features/favorites.js +14 -11
  245. package/lib/commonjs/features/favorites.js.map +1 -1
  246. package/lib/commonjs/features/gate.js +16 -1
  247. package/lib/commonjs/features/gate.js.map +1 -1
  248. package/lib/commonjs/features/metadata.js +20 -3
  249. package/lib/commonjs/features/metadata.js.map +1 -1
  250. package/lib/commonjs/features/network.js +1 -1
  251. package/lib/commonjs/features/nowPlaying.js +1 -1
  252. package/lib/commonjs/features/output.js +1 -1
  253. package/lib/commonjs/features/playback/controls.js +4 -2
  254. package/lib/commonjs/features/playback/controls.js.map +1 -1
  255. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  256. package/lib/commonjs/features/playback/playing.js +1 -1
  257. package/lib/commonjs/features/playback/progress.js +3 -2
  258. package/lib/commonjs/features/playback/progress.js.map +1 -1
  259. package/lib/commonjs/features/playback/rate.js +8 -1
  260. package/lib/commonjs/features/playback/rate.js.map +1 -1
  261. package/lib/commonjs/features/playback/state.js +3 -4
  262. package/lib/commonjs/features/playback/state.js.map +1 -1
  263. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  264. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  265. package/lib/commonjs/features/playback/volume.js +1 -1
  266. package/lib/commonjs/features/player/options.js +48 -34
  267. package/lib/commonjs/features/player/options.js.map +1 -1
  268. package/lib/commonjs/features/player/setup.js +18 -9
  269. package/lib/commonjs/features/player/setup.js.map +1 -1
  270. package/lib/commonjs/features/player/validateOptions.js +23 -0
  271. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  272. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  273. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  274. package/lib/commonjs/features/queue/queue.js +13 -6
  275. package/lib/commonjs/features/queue/queue.js.map +1 -1
  276. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  277. package/lib/commonjs/features/queue/shuffle.js +1 -1
  278. package/lib/commonjs/features/remoteControls.js +13 -92
  279. package/lib/commonjs/features/remoteControls.js.map +1 -1
  280. package/lib/commonjs/features/sleepTimer.js +13 -1
  281. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  282. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  283. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  284. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  285. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  286. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  287. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  288. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  289. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  290. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  291. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  292. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  293. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  294. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  295. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  296. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  297. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  298. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  299. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  300. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  301. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  302. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  303. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  304. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  305. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  306. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  307. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  308. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  309. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  310. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  311. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  312. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  313. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  314. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  315. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  316. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  317. package/lib/commonjs/web/browser/sections.js +89 -0
  318. package/lib/commonjs/web/browser/sections.js.map +1 -0
  319. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  320. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  321. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  322. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  323. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  324. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  325. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  326. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  327. package/lib/module/AudioBrowser.js +2 -1
  328. package/lib/module/AudioBrowser.js.map +1 -1
  329. package/lib/module/CLAUDE.md +52 -0
  330. package/lib/module/features/browser-config.js +12 -8
  331. package/lib/module/features/browser-config.js.map +1 -1
  332. package/lib/module/features/browser.js +11 -3
  333. package/lib/module/features/browser.js.map +1 -1
  334. package/lib/module/features/carConnection.js +1 -1
  335. package/lib/module/features/equalizer.js +1 -1
  336. package/lib/module/features/errors.js +3 -3
  337. package/lib/module/features/favorites.js +14 -11
  338. package/lib/module/features/favorites.js.map +1 -1
  339. package/lib/module/features/gate.js +16 -1
  340. package/lib/module/features/gate.js.map +1 -1
  341. package/lib/module/features/metadata.js +20 -3
  342. package/lib/module/features/metadata.js.map +1 -1
  343. package/lib/module/features/network.js +1 -1
  344. package/lib/module/features/nowPlaying.js +1 -1
  345. package/lib/module/features/output.js +1 -1
  346. package/lib/module/features/playback/controls.js +4 -2
  347. package/lib/module/features/playback/controls.js.map +1 -1
  348. package/lib/module/features/playback/playWhenReady.js +1 -1
  349. package/lib/module/features/playback/playing.js +1 -1
  350. package/lib/module/features/playback/progress.js +3 -2
  351. package/lib/module/features/playback/progress.js.map +1 -1
  352. package/lib/module/features/playback/rate.js +8 -1
  353. package/lib/module/features/playback/rate.js.map +1 -1
  354. package/lib/module/features/playback/state.js +3 -4
  355. package/lib/module/features/playback/state.js.map +1 -1
  356. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  357. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  358. package/lib/module/features/playback/volume.js +1 -1
  359. package/lib/module/features/player/options.js +47 -32
  360. package/lib/module/features/player/options.js.map +1 -1
  361. package/lib/module/features/player/setup.js +17 -8
  362. package/lib/module/features/player/setup.js.map +1 -1
  363. package/lib/module/features/player/validateOptions.js +19 -0
  364. package/lib/module/features/player/validateOptions.js.map +1 -0
  365. package/lib/module/features/queue/activeTrack.js +15 -4
  366. package/lib/module/features/queue/activeTrack.js.map +1 -1
  367. package/lib/module/features/queue/queue.js +13 -6
  368. package/lib/module/features/queue/queue.js.map +1 -1
  369. package/lib/module/features/queue/repeatMode.js +1 -1
  370. package/lib/module/features/queue/shuffle.js +1 -1
  371. package/lib/module/features/remoteControls.js +13 -92
  372. package/lib/module/features/remoteControls.js.map +1 -1
  373. package/lib/module/features/sleepTimer.js +13 -1
  374. package/lib/module/features/sleepTimer.js.map +1 -1
  375. package/lib/module/test-utils/reactNativeStub.js +58 -0
  376. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  377. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  378. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  379. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  380. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  381. package/lib/module/utils/getTrackIdentity.js +20 -0
  382. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  383. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  384. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  385. package/lib/module/web/NativeAudioBrowser.js +202 -77
  386. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  387. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  388. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  389. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  390. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  391. package/lib/module/web/TrackPlayer/Player.js +254 -39
  392. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  393. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  394. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  395. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  396. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  397. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  398. package/lib/module/web/browser/BrowserManager.js +175 -100
  399. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  400. package/lib/module/web/browser/FavoriteManager.js +31 -21
  401. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  402. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  403. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  404. package/lib/module/web/browser/SearchManager.js +18 -23
  405. package/lib/module/web/browser/SearchManager.js.map +1 -1
  406. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  407. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  408. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  409. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  410. package/lib/module/web/browser/sections.js +83 -0
  411. package/lib/module/web/browser/sections.js.map +1 -0
  412. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  413. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  414. package/lib/module/web/http/followMediaRedirect.js +215 -0
  415. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  416. package/lib/module/web/player/NowPlayingManager.js +4 -3
  417. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  418. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  419. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  420. package/lib/typescript/package.json +1 -0
  421. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  422. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  423. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  424. package/lib/typescript/src/features/browser.d.ts +10 -2
  425. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  426. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  427. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  428. package/lib/typescript/src/features/errors.d.ts +3 -3
  429. package/lib/typescript/src/features/favorites.d.ts +14 -11
  430. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  431. package/lib/typescript/src/features/gate.d.ts +18 -2
  432. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  433. package/lib/typescript/src/features/metadata.d.ts +20 -3
  434. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  435. package/lib/typescript/src/features/network.d.ts +1 -1
  436. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  437. package/lib/typescript/src/features/output.d.ts +1 -1
  438. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  439. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  440. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  441. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  442. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  443. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  444. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  445. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  446. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  447. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  448. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  449. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  450. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  451. package/lib/typescript/src/features/player/options.d.ts +108 -56
  452. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  453. package/lib/typescript/src/features/player/setup.d.ts +14 -4
  454. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  455. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  456. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  457. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  458. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  459. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  460. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  461. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  462. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  463. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  464. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  465. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  466. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  467. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  468. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  469. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  470. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  471. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  472. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  473. package/lib/typescript/src/types/browser.d.ts +93 -61
  474. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  475. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  476. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  477. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  478. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  479. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  480. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  481. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  482. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  483. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  484. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  485. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +1 -2
  486. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  487. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  488. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  489. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +12 -12
  490. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  491. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  492. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  493. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  494. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  495. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  496. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  497. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  498. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  499. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  500. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  501. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  502. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  503. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  504. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  505. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  506. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  507. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  508. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  509. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  510. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  511. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  512. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  513. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  514. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  515. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  516. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  517. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  518. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  519. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  520. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  521. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  522. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  523. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  524. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  525. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  526. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  527. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  528. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  529. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  530. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  531. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  532. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  533. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  534. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +9 -12
  535. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  536. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  537. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  538. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  539. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  540. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  541. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  542. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  543. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  544. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  545. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  546. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  547. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  548. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  549. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  550. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  551. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  552. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  553. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  554. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  555. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  556. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  557. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  558. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  559. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  560. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  561. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  564. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  565. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  566. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -53
  567. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  568. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  572. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  573. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  574. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  575. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  576. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  577. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  578. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  579. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  581. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  582. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  583. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  584. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  585. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +17 -14
  586. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +9 -12
  587. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  588. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  589. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  590. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  591. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +12 -12
  592. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  593. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  594. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  595. package/nitrogen/generated/android/c++/JOptions.hpp +9 -12
  596. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  597. package/nitrogen/generated/android/c++/JOutputType.hpp +2 -2
  598. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  599. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  600. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  602. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  605. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  607. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  608. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  609. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  610. package/nitrogen/generated/android/c++/{JNotificationButton.hpp → JRemoteButton.hpp} +19 -19
  611. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +86 -0
  612. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  613. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  616. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  619. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  621. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  622. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  623. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  625. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  626. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  627. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  628. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  630. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  631. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  632. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  633. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  634. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  635. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  637. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  638. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  639. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  640. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  641. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  642. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp +26 -0
  643. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +75 -0
  644. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  645. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  646. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  647. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +20 -3
  648. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  649. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  650. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  651. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  652. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  653. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  654. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  655. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  656. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  657. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  658. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  659. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  660. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  661. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  662. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  663. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  664. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  665. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  666. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  667. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  668. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  669. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  670. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  671. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  672. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  673. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  674. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  675. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  676. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  677. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  678. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  679. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  680. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  681. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  682. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  683. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  684. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  685. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  686. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  687. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  688. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  689. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  690. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  691. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  692. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  693. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  694. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  695. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  696. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  697. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  698. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  699. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  700. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  701. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  702. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  703. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  704. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  705. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  706. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  707. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  708. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  709. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  710. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  711. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  712. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  713. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  714. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  715. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  716. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  717. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  718. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  719. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +29 -0
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +20 -3
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  739. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  746. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  749. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{NotificationButton.kt → RemoteButton.kt} +3 -3
  752. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +61 -0
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Variant_NullType_NotificationButtonLayout.kt → Variant_NullType_RemoteButtonLayout.kt} +24 -15
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  782. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  783. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  784. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  785. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +779 -665
  786. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +34 -16
  787. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +36 -18
  788. package/nitrogen/generated/ios/swift/AndroidOptions.swift +12 -12
  789. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  790. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  791. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  792. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  793. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  794. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  795. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  796. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  797. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  798. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  799. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  800. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  801. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  802. package/nitrogen/generated/ios/swift/NitroAndroidUpdateOptions.swift +12 -12
  803. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  804. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  805. package/nitrogen/generated/ios/swift/{NotificationButton.swift → RemoteButton.swift} +6 -6
  806. package/nitrogen/generated/ios/swift/RemoteButtonLayout.swift +57 -0
  807. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  808. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  809. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  810. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  811. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  812. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  813. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  814. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  815. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  816. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  817. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +30 -0
  818. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  819. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  820. package/nitrogen/generated/shared/c++/AndroidOptions.hpp +8 -8
  821. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  822. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  823. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  824. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  825. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  826. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  827. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  828. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  829. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  830. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  831. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  832. package/nitrogen/generated/shared/c++/NitroAndroidUpdateOptions.hpp +8 -8
  833. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  834. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  835. package/nitrogen/generated/shared/c++/{NotificationButton.hpp → RemoteButton.hpp} +19 -19
  836. package/nitrogen/generated/shared/c++/RemoteButtonLayout.hpp +94 -0
  837. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  838. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  839. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  840. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  841. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  842. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  843. package/package.json +24 -11
  844. package/src/AudioBrowser.ts +2 -1
  845. package/src/CLAUDE.md +52 -0
  846. package/src/features/battery.test.ts +79 -0
  847. package/src/features/browser-config.test.ts +21 -6
  848. package/src/features/browser-config.ts +12 -8
  849. package/src/features/browser.test.ts +1 -1
  850. package/src/features/browser.ts +11 -3
  851. package/src/features/carConnection.ts +1 -1
  852. package/src/features/equalizer.ts +1 -1
  853. package/src/features/errors.ts +3 -3
  854. package/src/features/favorites.ts +14 -11
  855. package/src/features/gate.ts +16 -1
  856. package/src/features/hook-wiring.test.ts +302 -0
  857. package/src/features/metadata.ts +20 -3
  858. package/src/features/network.ts +1 -1
  859. package/src/features/nowPlaying.ts +1 -1
  860. package/src/features/output.ts +1 -1
  861. package/src/features/playback/controls.ts +4 -2
  862. package/src/features/playback/playWhenReady.ts +1 -1
  863. package/src/features/playback/playing.ts +1 -1
  864. package/src/features/playback/progress.test.ts +169 -0
  865. package/src/features/playback/progress.ts +3 -2
  866. package/src/features/playback/rate.ts +8 -1
  867. package/src/features/playback/state.ts +3 -4
  868. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  869. package/src/features/playback/trackPlaybackTime.ts +1 -6
  870. package/src/features/playback/volume.ts +1 -1
  871. package/src/features/player/options.ts +126 -76
  872. package/src/features/player/setup.test.ts +24 -7
  873. package/src/features/player/setup.ts +22 -10
  874. package/src/features/player/validateOptions.ts +21 -0
  875. package/src/features/queue/activeTrack.ts +15 -4
  876. package/src/features/queue/queue.ts +13 -6
  877. package/src/features/queue/repeatMode.ts +1 -1
  878. package/src/features/queue/shuffle.ts +1 -1
  879. package/src/features/remoteControls.ts +13 -92
  880. package/src/features/sleepTimer.test.ts +172 -0
  881. package/src/features/sleepTimer.ts +9 -1
  882. package/src/nitro-stub-drift.test.ts +277 -0
  883. package/src/public-surface.test.ts +147 -0
  884. package/src/specs/audio-browser.nitro.ts +5 -4
  885. package/src/style-resolution.test.ts +210 -0
  886. package/src/test-utils/reactNativeStub.ts +60 -0
  887. package/src/types/browser-native.ts +7 -3
  888. package/src/types/browser-nodes.ts +403 -134
  889. package/src/types/browser.ts +97 -63
  890. package/src/utils/LazyNativeEmitter.ts +28 -15
  891. package/src/utils/NativeUpdatedValue.ts +29 -13
  892. package/src/utils/getTrackIdentity.ts +20 -0
  893. package/src/utils/useDebug.test.ts +182 -0
  894. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  895. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  896. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  897. package/src/web/NativeAudioBrowser.ts +241 -84
  898. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  899. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  900. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  901. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  902. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  903. package/src/web/TrackPlayer/Player.ts +284 -37
  904. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  905. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  906. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  907. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  908. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  909. package/src/web/__tests__/lifecycle.test.ts +345 -0
  910. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  911. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  912. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  913. package/src/web/__tests__/retry.test.ts +169 -0
  914. package/src/web/browser/BrowserManager.ts +209 -111
  915. package/src/web/browser/FavoriteManager.test.ts +84 -0
  916. package/src/web/browser/FavoriteManager.ts +28 -23
  917. package/src/web/browser/NavigationErrorManager.ts +3 -1
  918. package/src/web/browser/SearchManager.test.ts +75 -0
  919. package/src/web/browser/SearchManager.ts +25 -28
  920. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  921. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  922. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  923. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  924. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  925. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  926. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  927. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  928. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  929. package/src/web/browser/sections.test.ts +91 -0
  930. package/src/web/browser/sections.ts +72 -0
  931. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  932. package/src/web/http/RequestConfigBuilder.ts +140 -33
  933. package/src/web/http/followMediaRedirect.test.ts +289 -0
  934. package/src/web/http/followMediaRedirect.ts +253 -0
  935. package/src/web/player/NowPlayingManager.ts +4 -3
  936. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  937. package/src/web/util/BrowserPathHelper.ts +70 -13
  938. package/website/guide/android-auto.md +114 -0
  939. package/website/guide/android-certificates.md +409 -0
  940. package/website/guide/artwork.md +255 -0
  941. package/website/guide/audio-output.md +135 -0
  942. package/website/guide/automotive.md +86 -0
  943. package/website/guide/basic-usage.md +151 -0
  944. package/website/guide/battery.md +115 -0
  945. package/website/guide/browser.md +587 -0
  946. package/website/guide/carplay.md +650 -0
  947. package/website/guide/configuration.md +173 -0
  948. package/website/guide/equalizer.md +231 -0
  949. package/website/guide/errors.md +310 -0
  950. package/website/guide/favorites.md +154 -0
  951. package/website/guide/gate.md +143 -0
  952. package/website/guide/getting-started.md +46 -0
  953. package/website/guide/hooks.md +238 -0
  954. package/website/guide/live-streams.md +125 -0
  955. package/website/guide/metadata.md +239 -0
  956. package/website/guide/migrating-from-track-player.md +244 -0
  957. package/website/guide/native-callback-fetch.md +127 -0
  958. package/website/guide/network.md +86 -0
  959. package/website/guide/now-playing.md +175 -0
  960. package/website/guide/playback.md +328 -0
  961. package/website/guide/queue.md +300 -0
  962. package/website/guide/remote-controls.md +256 -0
  963. package/website/guide/search.md +255 -0
  964. package/website/guide/sleep-timer.md +268 -0
  965. package/website/guide/track.md +247 -0
  966. package/ios/Bridge.h +0 -8
  967. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  968. package/ios/Browser/MediaResolveComposer.swift +0 -114
  969. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  970. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  971. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  972. package/ios/Model/MediaURL.swift +0 -67
  973. package/ios/Model/SourceType.swift +0 -6
  974. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  975. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  976. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  977. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  978. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  979. package/ios/Observer/PlayerStateObserver.swift +0 -50
  980. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  981. package/ios/Option/PitchAlgorithms.swift +0 -17
  982. package/ios/Option/TimeEventFrequency.swift +0 -18
  983. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  984. package/ios/Player/MediaIntentCriteria.swift +0 -139
  985. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  986. package/ios/Player/PlaybackCoordinator.swift +0 -754
  987. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  988. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  989. package/ios/Player/PlaybackStateStore.swift +0 -27
  990. package/ios/Player/PlayingStateManager.swift +0 -33
  991. package/ios/Player/RetryManager.swift +0 -322
  992. package/ios/Player/SeekCompletionHandler.swift +0 -3
  993. package/ios/Player/SleepTimerHandling.swift +0 -15
  994. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  995. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  996. package/ios/Tests/MediaResolveTests.swift +0 -126
  997. package/ios/Tests/OnceValueTests.swift +0 -79
  998. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  999. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1000. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1001. package/ios/Tests/RetryManagerTests.swift +0 -89
  1002. package/ios/TrackPlayer.swift +0 -1014
  1003. package/ios/TrackPlayerCallbacks.swift +0 -86
  1004. package/ios/Util/MetadataAdapter.swift +0 -131
  1005. package/ios/Util/OnceValue.swift +0 -104
  1006. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1007. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1008. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1009. package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp +0 -94
  1010. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1011. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1012. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp +0 -26
  1013. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp +0 -75
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt +0 -50
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1018. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1019. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1020. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1021. package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift +0 -92
  1022. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1023. package/nitrogen/generated/ios/swift/Variant_NullType_NotificationButtonLayout.swift +0 -18
  1024. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1025. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
  1026. package/nitrogen/generated/shared/c++/NotificationButtonLayout.hpp +0 -102
@@ -0,0 +1,960 @@
1
+ import Foundation
2
+ import os.log
3
+
4
+ #if canImport(NitroModules)
5
+ import NitroModules
6
+ #endif
7
+
8
+ /// The player: the playback state machine, the queue, retries, the sleep timer, persistence,
9
+ /// and every decision about loading, seeking and recovering. The media stack under it is a
10
+ /// `PlayerEngine` (AVPlayerEngine in production, a mock in tests), which carries the decisions out
11
+ /// and reports what it observes.
12
+ @MainActor
13
+ final class Player {
14
+ let logger = Logger(subsystem: "com.audiobrowser", category: "Player")
15
+
16
+ // MARK: - Dependencies
17
+
18
+ let engine: any PlayerEngine
19
+ weak var callbacks: PlayerCallbacks?
20
+
21
+ let queue = QueueManager()
22
+ let retry: RetryLoop
23
+ let sleepTimerManager: SleepTimerManager
24
+ var deferredSeek = DeferredSeek()
25
+
26
+ private lazy var progressTimer = PlaybackTimer(
27
+ isActive: { $0 == .loading || $0 == .buffering || $0 == .playing },
28
+ ) { [weak self] in
29
+ guard let self, queue.currentIndex >= 0 else { return }
30
+ let progressEvent = PlaybackProgressUpdatedEvent(
31
+ track: Double(queue.currentIndex),
32
+ position: engine.currentTime,
33
+ duration: engine.duration,
34
+ buffered: engine.bufferedPosition,
35
+ )
36
+ callbacks?.playerDidUpdateProgress(progressEvent)
37
+ }
38
+
39
+ private lazy var intervalTimer = PlaybackTimer(
40
+ isActive: { $0 == .playing },
41
+ ) { [weak self] in
42
+ self?.callbacks?.playerDidFirePlaybackInterval()
43
+ }
44
+
45
+ // MARK: - State
46
+
47
+ private(set) var state: PlaybackState = .none
48
+ private(set) var errorStatus: ErrorStatus = .none
49
+
50
+ /// One track's playback session, which automatic retry reloads keep (glossary: Load).
51
+ struct Load: Equatable {
52
+ let id: UInt
53
+ /// Audio has rendered: retries get the recovery budget, not the first-connect one (ADR 0004).
54
+ var hasPlayed = false
55
+ /// The silent primer has run for this load's first failure (ADR 0005).
56
+ var primedNowPlaying = false
57
+ /// One of this load's items is in the engine; until then it reports the previous one's position.
58
+ var itemPrepared = false
59
+
60
+ /// True the first time it is asked, so the silent primer runs once per load.
61
+ mutating func claimNowPlayingPrime() -> Bool {
62
+ guard !primedNowPlaying else { return false }
63
+ primedNowPlaying = true
64
+ return true
65
+ }
66
+ }
67
+
68
+ private(set) var load: Load?
69
+ private var loadCount: UInt = 0
70
+
71
+ /// Starts a Load: a track becoming current, or a restart of this one from a terminal error.
72
+ /// Fresh retry budgets, no pending seek, unproven playback.
73
+ private func beginLoad() {
74
+ loadCount &+= 1
75
+ load = Load(id: loadCount)
76
+ retry.reset()
77
+ deferredSeek.reset()
78
+ }
79
+
80
+ /// The play intent captured when the current interruption began; its end resumes only then.
81
+ private var shouldResumeAfterInterruption = false
82
+
83
+ /// Playback rate (1.0 = normal speed). A non-positive rate, which could never play, is refused.
84
+ /// Speed and play intent are independent, as on Android and web.
85
+ var rate: Float = 1.0 {
86
+ didSet {
87
+ guard rate > 0 else {
88
+ rate = oldValue
89
+ return
90
+ }
91
+ engine.setRate(rate, playing: playWhenReady)
92
+ persistence.save()
93
+ }
94
+ }
95
+
96
+ private let persistenceDefaults: UserDefaults
97
+ private let persistenceSaveInterval: Duration
98
+ private lazy var persistence = PlaybackPersistence(
99
+ defaults: persistenceDefaults, saveInterval: persistenceSaveInterval,
100
+ ) { [unowned self] in
101
+ currentTrack.map {
102
+ PlaybackPersistence.snapshot(
103
+ of: $0, state: state, position: enginePositionIsCurrent ? engine.currentTime : deferredSeek.target ?? 0,
104
+ repeatMode: repeatMode,
105
+ shuffleEnabled: shuffleEnabled, rate: rate,
106
+ )
107
+ }
108
+ }
109
+
110
+ /// Whether the engine reports this Load's position: not before one of its items is prepared,
111
+ /// nor while one reloads.
112
+ private var enginePositionIsCurrent: Bool {
113
+ state != .loading && load?.itemPrepared == true
114
+ }
115
+
116
+ /// Where a reload resumes this Load.
117
+ private var resumePosition: TimeInterval? {
118
+ enginePositionIsCurrent ? engine.resumePosition : deferredSeek.target
119
+ }
120
+
121
+ // MARK: - Track State (for active track changed events)
122
+
123
+ private var lastIndex: Int = -1
124
+ private var lastTrack: Track?
125
+
126
+ // MARK: - TrackSelectionPlayer and NowPlayingSource
127
+
128
+ var tracks: [Track] { queue.tracks }
129
+ var queueSourcePath: String? { queue.queueSourcePath }
130
+ var currentTrack: Track? { queue.currentTrack }
131
+ var currentTime: Double { engine.currentTime }
132
+ var nitroPlaybackError: PlaybackError? { errorStatus.nitroError }
133
+
134
+ var repeatMode: RepeatMode {
135
+ get { queue.repeatMode }
136
+ set {
137
+ guard queue.repeatMode != newValue else { return }
138
+ queue.repeatMode = newValue
139
+ engine.updateRemoteRepeatMode(newValue)
140
+ // Persisted on each change, or a mode toggled while paused would miss the resume snapshot.
141
+ persistence.save()
142
+ pushSkipAvailability()
143
+ callbacks?.playerDidChangeRepeatMode(
144
+ RepeatModeChangedEvent(repeatMode: newValue),
145
+ )
146
+ }
147
+ }
148
+
149
+ var shuffleEnabled: Bool {
150
+ get { queue.shuffleEnabled }
151
+ set {
152
+ guard queue.shuffleEnabled != newValue else { return }
153
+ queue.shuffleEnabled = newValue
154
+ engine.updateRemoteShuffleMode(newValue)
155
+ persistence.save()
156
+ pushSkipAvailability()
157
+ callbacks?.playerDidChangeShuffleEnabled(newValue)
158
+ }
159
+ }
160
+
161
+ private func pushSkipAvailability() {
162
+ engine.updateSkipAvailability(canNext: queue.canNext, canPrevious: queue.canPrevious)
163
+ }
164
+
165
+ // MARK: - playWhenReady
166
+
167
+ /// The intent to play, applied through `setPlayWhenReady`.
168
+ private(set) var playWhenReady = false
169
+
170
+ func setPlayWhenReady(_ newValue: Bool) {
171
+ let changed = newValue != playWhenReady
172
+ playWhenReady = newValue
173
+ // A play during an interruption owns the intent: a later pause must not be auto-resumed.
174
+ if newValue { shouldResumeAfterInterruption = false }
175
+
176
+ // A terminal state has no item to play, or one parked at its end: reload, re-resolving a URL
177
+ // that may have expired since. Only .error resumes from the last position.
178
+ if newValue, state == .error || state == .stopped || state == .ended {
179
+ reloadResolving(startFromCurrentTime: state == .error)
180
+ }
181
+ if state != .loading {
182
+ if newValue { engine.play() } else { engine.pause() }
183
+ }
184
+
185
+ guard changed else { return }
186
+ // A pause during the sleep fade ends the timer early, restoring the pre-fade volume.
187
+ if !newValue, sleepTimerManager.isFading { sleepTimerManager.clear() }
188
+ publish()
189
+ evaluateSessionRelease()
190
+ }
191
+
192
+ /// Playing with intent, in a state that can play; buffering while loading or rebuffering.
193
+ static func playingState(playWhenReady: Bool, state: PlaybackState) -> PlayingState {
194
+ PlayingState(
195
+ playing: playWhenReady && ![.error, .ended, .none, .stopped].contains(state),
196
+ buffering: playWhenReady && (state == .loading || state == .buffering),
197
+ )
198
+ }
199
+
200
+ var playingState: PlayingState {
201
+ Self.playingState(playWhenReady: playWhenReady, state: state)
202
+ }
203
+
204
+ var playbackActive: Bool {
205
+ switch state {
206
+ case .none, .stopped, .ended, .error:
207
+ false
208
+ default: true
209
+ }
210
+ }
211
+
212
+ // MARK: - Init
213
+
214
+ /// - Parameters:
215
+ /// - persistenceDefaults: Where the resume snapshot is kept.
216
+ /// - persistenceSaveInterval: How often the snapshot is saved while the play intent is active.
217
+ init(
218
+ engine: any PlayerEngine,
219
+ callbacks: PlayerCallbacks? = nil,
220
+ retry: RetryLoop = RetryLoop(),
221
+ sleepTimerScheduler: any SleepTimerScheduling = MainQueueSleepTimerScheduler(),
222
+ persistenceDefaults: UserDefaults = PlaybackPersistence.standardDefaults,
223
+ persistenceSaveInterval: Duration = .seconds(5),
224
+ ) {
225
+ self.engine = engine
226
+ self.callbacks = callbacks
227
+ self.retry = retry
228
+ sleepTimerManager = SleepTimerManager(
229
+ fader: VolumeFader(
230
+ getVolume: { [weak engine] in engine?.volume ?? 1 },
231
+ setVolume: { [weak engine] in engine?.volume = $0 },
232
+ ),
233
+ scheduler: sleepTimerScheduler,
234
+ )
235
+ self.persistenceDefaults = persistenceDefaults
236
+ self.persistenceSaveInterval = persistenceSaveInterval
237
+ engine.onEvent = { [weak self] in self?.engineDidEmit($0) }
238
+
239
+ sleepTimerManager.onComplete = { [weak self] in self?.pause() }
240
+ sleepTimerManager.onChanged = { [weak self] in self?.callbacks?.playerDidChangeSleepTimer($0) }
241
+
242
+ retry.onError = { [weak self] in self?.transition(.errorOccurred($0)) }
243
+ retry.onRetryingError = { [weak self] in self?.reportRetryingError($0) }
244
+ retry.onRetry = { [weak self] in self?.reloadResolving(startFromCurrentTime: $0) }
245
+ retry.shouldRetry = { [weak self] in self?.playWhenReady ?? false }
246
+ retry.hasPlayed = { [weak self] in self?.load?.hasPlayed ?? false }
247
+ }
248
+
249
+ /// Shows a failure the retry loop is still working on over the current state: not a
250
+ /// transition, and not a `playerDidError`, which is for terminal errors.
251
+ private func reportRetryingError(_ error: TrackPlayerError.PlaybackError) {
252
+ guard state.carriesAdvisoryError else { return }
253
+ errorStatus = .retrying(error)
254
+ publish()
255
+ }
256
+
257
+ // MARK: - Playback State Machine
258
+
259
+ func transition(_ event: PlaybackEvent) {
260
+ guard let newState = nextPlaybackState(from: state, on: event) else { return }
261
+ let oldState = state
262
+ errorStatus = errorStatus.after(event: event, from: oldState, to: newState)
263
+ guard newState != oldState else {
264
+ publish()
265
+ return
266
+ }
267
+ state = newState
268
+ applySideEffects(old: oldState, new: newState)
269
+ publish()
270
+ // While nothing plays, no periodic save runs: every transition rewrites the snapshot, so it
271
+ // never keeps a position from before a track change or a seek.
272
+ if !(playbackActive && playWhenReady) { persistence.save() }
273
+ // Repeat modes never end the queue (matches web's endsQueue()): a repeat-track pause at the
274
+ // track boundary (e.g. the end-of-track sleep timer) must not read as "playlist over".
275
+ if newState == .ended, queue.isLastInPlaybackOrder, repeatMode == .off {
276
+ callbacks?.playerDidEndQueue(
277
+ PlaybackQueueEndedEvent(track: Double(queue.currentIndex), position: engine.currentTime),
278
+ )
279
+ }
280
+ }
281
+
282
+ private struct Published: Equatable {
283
+ var state = PlaybackState.none
284
+ var errorStatus = ErrorStatus.none
285
+ var playWhenReady = false
286
+ var playing = false
287
+ var buffering = false
288
+ var playIntentActive = false
289
+ }
290
+
291
+ private var published = Published()
292
+
293
+ /// Emits what changed since the last publish, in order: the play intent, the playing state,
294
+ /// the playback (state and error), the terminal error, the active play intent. The one place
295
+ /// these leave the Player, so each goes out once per change, with the audio-session and
296
+ /// now-playing effects it drives.
297
+ private func publish() {
298
+ let playing = playingState
299
+ let now = Published(
300
+ state: state, errorStatus: errorStatus, playWhenReady: playWhenReady,
301
+ playing: playing.playing, buffering: playing.buffering,
302
+ playIntentActive: playbackActive && playWhenReady,
303
+ )
304
+ let old = published
305
+ guard now != old else { return }
306
+ published = now
307
+ if now.playWhenReady != old.playWhenReady {
308
+ if now.playWhenReady { engine.cancelAudioSessionRelease() }
309
+ callbacks?.playerDidChangePlayWhenReady(now.playWhenReady)
310
+ }
311
+ if now.playing != old.playing || now.buffering != old.buffering {
312
+ callbacks?.playerDidChangePlayingState(playing)
313
+ // Activated on output, not at setup: activating at launch interrupts other apps' audio.
314
+ if playing.playing || playing.buffering { engine.activateAudioSession() }
315
+ // A stall starting or recovering may leave the state as it was.
316
+ engine.renderNowPlaying()
317
+ }
318
+ if now.state != old.state || now.errorStatus != old.errorStatus {
319
+ callbacks?.playerDidChangePlayback(Playback(state: now.state, error: now.errorStatus.nitroError))
320
+ engine.renderNowPlaying()
321
+ }
322
+ let erred = now.state == .error, wasErred = old.state == .error
323
+ if erred != wasErred || (erred && now.errorStatus != old.errorStatus) {
324
+ callbacks?.playerDidError(PlaybackErrorEvent(error: now.errorStatus.nitroError))
325
+ }
326
+ if now.playIntentActive != old.playIntentActive {
327
+ persistence.playIntentDidChange(active: now.playIntentActive)
328
+ }
329
+ }
330
+
331
+ private func applySideEffects(old: PlaybackState, new: PlaybackState) {
332
+ if new == .playing {
333
+ retry.playbackBecameAudible()
334
+ } else if old == .playing {
335
+ retry.playbackStoppedBeingAudible()
336
+ }
337
+
338
+ switch new {
339
+ case .ready:
340
+ engine.applyTimePitchAlgorithm()
341
+ if playWhenReady { engine.play() }
342
+ case .loading:
343
+ engine.applyTimePitchAlgorithm()
344
+ case .ended:
345
+ // A natural end exhausts the play intent; the setter also requests the session release.
346
+ setPlayWhenReady(false)
347
+ default: break
348
+ }
349
+
350
+ progressTimer.onPlaybackStateChanged(new)
351
+ intervalTimer.onPlaybackStateChanged(new)
352
+ }
353
+
354
+ // MARK: - Player Actions
355
+
356
+ func play() {
357
+ setPlayWhenReady(true)
358
+ }
359
+
360
+ func pause() {
361
+ setPlayWhenReady(false)
362
+ }
363
+
364
+ func togglePlayback() {
365
+ setPlayWhenReady(!playWhenReady)
366
+ }
367
+
368
+ func stop() {
369
+ // Before the intent drop: a pending retry would surface .error and hold the session.
370
+ retry.cancel()
371
+ shouldResumeAfterInterruption = false
372
+ transition(.stopped)
373
+ setPlayWhenReady(false)
374
+ if currentTrack?.live != true { seek(to: 0) }
375
+ }
376
+
377
+ // MARK: - Audio Session Interruptions
378
+
379
+ /// The output route went away (headphones unplugged): pause, and cancel any interruption
380
+ /// resume, so a call ending cannot start the built-in speaker.
381
+ func handleRouteDisconnected() {
382
+ shouldResumeAfterInterruption = false
383
+ pause()
384
+ }
385
+
386
+ /// iOS has already paused the AVPlayer, but that pause is swallowed while the intent holds, so
387
+ /// the paused state is forced here.
388
+ func handleInterruptionBegan() {
389
+ // A nested interruption keeps the intent the first one captured.
390
+ shouldResumeAfterInterruption = shouldResumeAfterInterruption || playWhenReady
391
+ pause()
392
+ if playbackActive, state != .loading {
393
+ transition(.avPlayerPaused(hasAsset: engine.hasLoadedAsset))
394
+ }
395
+ }
396
+
397
+ /// Whether the interruption's end will resume playback, so the session reactivates first.
398
+ var willResumeAfterInterruption: Bool { shouldResumeAfterInterruption }
399
+
400
+ func handleInterruptionEnded(shouldResume: Bool) {
401
+ guard shouldResumeAfterInterruption else { return }
402
+ shouldResumeAfterInterruption = false
403
+ if shouldResume {
404
+ play()
405
+ } else {
406
+ evaluateSessionRelease()
407
+ }
408
+ }
409
+
410
+ /// Requests a session release once playback is deliberately stopped: no intent, no
411
+ /// interruption to resume from, and no retry pending, whose reconnect needs the session. The
412
+ /// engine debounces it.
413
+ private func evaluateSessionRelease() {
414
+ guard !playWhenReady,
415
+ !shouldResumeAfterInterruption,
416
+ retry.pendingTask == nil
417
+ else { return }
418
+ engine.scheduleAudioSessionRelease()
419
+ }
420
+
421
+ func getPlayback() -> Playback {
422
+ Playback(state: state, error: errorStatus.nitroError)
423
+ }
424
+
425
+ /// Drops the intent before `action` or raises it after, as `playWhenReady` asks.
426
+ private func handlePlayWhenReady(_ playWhenReady: Bool?, action: () throws -> Void) rethrows {
427
+ if playWhenReady == false { setPlayWhenReady(false) }
428
+ try action()
429
+ if playWhenReady == true { setPlayWhenReady(true) }
430
+ }
431
+
432
+ // MARK: - Queue Methods
433
+
434
+ func load(_ track: Track, playWhenReady: Bool? = nil) {
435
+ handlePlayWhenReady(playWhenReady) {
436
+ if queue.currentIndex == -1 {
437
+ afterQueueMutation(queue.add([track], initialIndex: 0))
438
+ } else {
439
+ // In bounds, as -1 took the branch above.
440
+ do {
441
+ try queue.replace(queue.currentIndex, track)
442
+ afterQueueMutation(.tracksAndCurrent)
443
+ } catch {
444
+ logger.error("load: replace at \(self.queue.currentIndex) failed: \(error)")
445
+ }
446
+ }
447
+ }
448
+ }
449
+
450
+ func replace(_ index: Int, _ track: Track) throws {
451
+ try afterQueueMutation(queue.replace(index, track))
452
+ }
453
+
454
+ func setQueue(
455
+ _ newTracks: [Track],
456
+ initialIndex: Int = 0,
457
+ startPositionMs: Double? = nil,
458
+ playWhenReady: Bool? = nil,
459
+ sourcePath: String? = nil,
460
+ ) {
461
+ guard !newTracks.isEmpty else {
462
+ clear()
463
+ return
464
+ }
465
+ handlePlayWhenReady(playWhenReady) {
466
+ afterQueueMutation(
467
+ queue.setQueue(newTracks, initialIndex: initialIndex, sourcePath: sourcePath),
468
+ startingAt: startPositionMs.flatMap { $0 > 0 ? $0 / 1000 : nil },
469
+ )
470
+ }
471
+ }
472
+
473
+ func add(_ tracks: [Track], initialIndex: Int? = nil, playWhenReady: Bool? = nil) {
474
+ handlePlayWhenReady(playWhenReady) {
475
+ afterQueueMutation(queue.add(tracks, initialIndex: initialIndex ?? 0))
476
+ }
477
+ }
478
+
479
+ func add(_ tracks: [Track], at index: Int) throws {
480
+ try afterQueueMutation(queue.addAt(tracks, at: index))
481
+ }
482
+
483
+ func next() {
484
+ let result = queue.next()
485
+ switch result {
486
+ case .trackChanged: handleCurrentTrackChanged()
487
+ case .sameTrackReplay: if playWhenReady { replay() }
488
+ case .noChange: break
489
+ }
490
+ }
491
+
492
+ func previous() {
493
+ let result = queue.previous()
494
+ switch result {
495
+ case .trackChanged: handleCurrentTrackChanged()
496
+ case .sameTrackReplay: if playWhenReady { replay() }
497
+ case .noChange: break
498
+ }
499
+ }
500
+
501
+ func remove(_ index: Int) throws {
502
+ try afterQueueMutation(queue.remove(index))
503
+ }
504
+
505
+ func skipTo(_ index: Int, playWhenReady: Bool? = nil) throws {
506
+ try handlePlayWhenReady(playWhenReady) {
507
+ if index == queue.currentIndex {
508
+ seek(to: 0)
509
+ } else {
510
+ try queue.skipTo(index)
511
+ handleCurrentTrackChanged()
512
+ }
513
+ }
514
+ }
515
+
516
+ func move(fromIndex: Int, toIndex: Int) throws {
517
+ try afterQueueMutation(queue.move(fromIndex: fromIndex, toIndex: toIndex))
518
+ }
519
+
520
+ func removeUpcomingTracks() {
521
+ afterQueueMutation(queue.removeUpcomingTracks())
522
+ }
523
+
524
+ func replay() {
525
+ seek(to: 0) { [weak self] succeeded in
526
+ if succeeded { self?.play() }
527
+ }
528
+ }
529
+
530
+ /// The one place a settled queue mutation is published: the new track list, then the
531
+ /// current-track change, then next/previous availability.
532
+ private func afterQueueMutation(_ change: QueueChange, startingAt start: TimeInterval? = nil) {
533
+ if change.tracks { callbacks?.playerDidChangeQueue(queue.tracks) }
534
+ if change.currentTrack {
535
+ handleCurrentTrackChanged(startingAt: start)
536
+ } else if change.tracks {
537
+ pushSkipAvailability()
538
+ }
539
+ }
540
+
541
+ func clear() {
542
+ afterQueueMutation(queue.clear())
543
+ unload()
544
+ engine.clearNowPlaying()
545
+ }
546
+
547
+ // MARK: - Track Loading
548
+
549
+ private func trackDidPlayToEnd() {
550
+ sleepTimerManager.onTrackPlayedToEnd()
551
+
552
+ if repeatMode == .track {
553
+ // The end-of-track sleep timer has just cleared the intent: settle in .ended, not replay.
554
+ if playWhenReady {
555
+ replay()
556
+ } else {
557
+ transition(.trackEndedNaturally)
558
+ }
559
+ } else if repeatMode == .queue || !queue.isLastInPlaybackOrder {
560
+ next()
561
+ } else {
562
+ transition(.trackEndedNaturally)
563
+ }
564
+ }
565
+
566
+ /// Loads the new current track. `start` is held as the deferred seek, so the ready transition
567
+ /// waits for it (no flash at 0) and the snapshot saved on the way records it.
568
+ func handleCurrentTrackChanged(startingAt start: TimeInterval? = nil) {
569
+ defer { pushSkipAvailability() }
570
+ sleepTimerManager.onTrackChanged()
571
+
572
+ engine.cancelLoading()
573
+ beginLoad()
574
+ if let start { deferredSeek.capture(start) }
575
+
576
+ // Published by the .trackLoading or .trackUnloaded transition below, even when it is a no-op.
577
+ errorStatus = .none
578
+
579
+ let lastPosition = engine.currentTime
580
+ let shouldContinuePlayback = playWhenReady
581
+ if let currentTrack {
582
+ engine.stopObservingItem()
583
+ engine.pause()
584
+
585
+ // Loading first, so the setter does not play the item that is gone.
586
+ transition(.trackLoading)
587
+ setPlayWhenReady(shouldContinuePlayback)
588
+
589
+ engine.loadNowPlayingMetadata(for: currentTrack)
590
+ persistence.save()
591
+
592
+ guard let src = currentTrack.src else {
593
+ logger.error("No src for track \(currentTrack.path ?? currentTrack.title)")
594
+ clearItem()
595
+ transition(.errorOccurred(.invalidSourceUrl("nil")))
596
+ return
597
+ }
598
+ engine.resolveAndLoad(src: src, track: currentTrack)
599
+ } else {
600
+ unload()
601
+ engine.clearNowPlaying()
602
+ }
603
+
604
+ let eventData = PlaybackActiveTrackChangedEvent(
605
+ lastIndex: lastIndex == -1 ? nil : Double(lastIndex),
606
+ lastTrack: lastTrack,
607
+ lastPosition: lastPosition,
608
+ index: queue.currentIndex == -1 ? nil : Double(queue.currentIndex),
609
+ track: currentTrack,
610
+ )
611
+ callbacks?.playerDidChangeActiveTrack(eventData)
612
+ engine.nowPlayingTrackChanged()
613
+ lastTrack = currentTrack
614
+ lastIndex = queue.currentIndex
615
+ }
616
+
617
+ // MARK: - Seeking
618
+
619
+ /// Seeks the current item. While loading, the target is held until the item is ready and the
620
+ /// ready transition waits for it (`DeferredSeek`); `completion` then reports false at once.
621
+ func seek(to seconds: TimeInterval, completion: @escaping @MainActor (Bool) -> Void = { _ in }) {
622
+ if state == .loading {
623
+ deferredSeek.capture(seconds)
624
+ completion(false)
625
+ } else if engine.hasItem {
626
+ seekItem(to: seconds, completion: completion)
627
+ } else {
628
+ completion(false)
629
+ }
630
+ }
631
+
632
+ func seek(by offset: TimeInterval) {
633
+ if state == .loading {
634
+ seek(to: (deferredSeek.target ?? 0) + offset)
635
+ } else if engine.hasItem {
636
+ seek(to: engine.currentTime + offset)
637
+ }
638
+ }
639
+
640
+ /// Jumps to the live edge: the end of the seekable window when there is one; without one
641
+ /// (ICY) there is nothing to seek within, so it reconnects. No-op for a track that isn't live.
642
+ func seekToLiveEdge() {
643
+ guard currentTrack?.live == true, engine.hasItem else { return }
644
+ if let edge = engine.liveEdge {
645
+ engine.seek(to: edge) { _ in }
646
+ } else {
647
+ reloadResolving(startFromCurrentTime: false)
648
+ }
649
+ }
650
+
651
+ /// A completion arriving after a track change belongs to the old item, and reports false
652
+ /// without touching the new one's deferred seek.
653
+ private func seekItem(to seconds: TimeInterval, completion: @escaping @MainActor (Bool) -> Void) {
654
+ let generation = deferredSeek.generation
655
+ engine.seek(to: seconds) { [weak self] finished in
656
+ guard let self, deferredSeek.generation == generation else {
657
+ completion(false)
658
+ return
659
+ }
660
+ seekDidLand()
661
+ completion(finished)
662
+ }
663
+ }
664
+
665
+ /// Issues the deferred seek if one is pending; true when it did, so ready waits for it.
666
+ private func beginDeferredSeek() -> Bool {
667
+ guard let time = deferredSeek.begin() else { return false }
668
+ seekItem(to: time) { _ in }
669
+ return true
670
+ }
671
+
672
+ private func seekDidLand() {
673
+ switch deferredSeek.land() {
674
+ case .done:
675
+ if state == .loading { transition(.loadSeekCompleted) }
676
+ case let .reseek(time):
677
+ seekItem(to: time) { _ in }
678
+ case .none:
679
+ break
680
+ }
681
+ }
682
+
683
+ // MARK: - Reloading
684
+
685
+ /// Loads the current track again, re-running the media-URL resolver, so a consumer whose
686
+ /// resolver mints short-lived URLs or tokens recovers once they expire. A track without a `src`
687
+ /// fails as an invalid source; with no current track, nothing loads.
688
+ func reloadResolving(startFromCurrentTime: Bool) {
689
+ guard let track = currentTrack else { return }
690
+ guard let src = track.src else {
691
+ transition(.errorOccurred(.invalidSourceUrl("nil")))
692
+ return
693
+ }
694
+ prepareForReload(resumingAt: startFromCurrentTime ? resumePosition : nil)
695
+ engine.resolveAndLoad(src: src, track: track)
696
+ }
697
+
698
+ /// A restart from a terminal error begins a new Load on a new AVPlayer; automatic retries
699
+ /// never get here in .error, since the retry loop keeps the state non-terminal. `time` is held
700
+ /// as the deferred seek before the loading transition saves the snapshot.
701
+ private func prepareForReload(resumingAt time: TimeInterval?) {
702
+ if state == .error {
703
+ beginLoad()
704
+ clearItem()
705
+ engine.recreate()
706
+ } else {
707
+ engine.cancelLoading()
708
+ engine.dropAsset()
709
+ engine.pause()
710
+ }
711
+ if let time { deferredSeek.capture(time) }
712
+ transition(.trackLoading)
713
+ }
714
+
715
+ private func clearItem() {
716
+ engine.clearItem()
717
+ deferredSeek.reset()
718
+ }
719
+
720
+ private func unload() {
721
+ clearItem()
722
+ transition(.trackUnloaded)
723
+ }
724
+
725
+ /// Recovers from a media-services reset: every AVPlayer and session handle is invalid, so a
726
+ /// new player reloads the current track, keeping the play intent, so a live stream reconnects
727
+ /// instead of going silent. No-op when nothing is loaded.
728
+ func mediaServicesWereReset() {
729
+ guard currentTrack != nil else { return }
730
+ logger.info("Media services were reset — recreating player and reloading current track")
731
+ clearItem()
732
+ engine.recreate()
733
+ reloadResolving(startFromCurrentTime: false)
734
+ }
735
+
736
+ // MARK: - Engine Events
737
+
738
+ private func engineDidEmit(_ event: EngineEvent) {
739
+ switch event {
740
+ case let .itemPrepared(likelyToKeepUp):
741
+ load?.itemPrepared = true
742
+ if playWhenReady { engine.play() }
743
+ if !beginDeferredSeek(), likelyToKeepUp { bufferBecameSufficient() }
744
+ case let .loadFailed(error):
745
+ primeNowPlayingIfNeeded()
746
+ retry.handleError(error, context: .mediaLoad)
747
+ case .unplayable:
748
+ primeNowPlayingIfNeeded()
749
+ transition(.errorOccurred(.trackWasUnplayable))
750
+ case let .invalidSource(url):
751
+ primeNowPlayingIfNeeded()
752
+ transition(.errorOccurred(.invalidSourceUrl(url)))
753
+ case let .failed(error, httpStatusCode):
754
+ retry.handleError(error, context: .playback, httpStatusCode: httpStatusCode)
755
+ case let .likelyToKeepUp(isLikely):
756
+ guard isLikely, engine.hasItem, !beginDeferredSeek() else { return }
757
+ bufferBecameSufficient()
758
+ case let .timeControlStatus(status, waitingForNoItem):
759
+ recoverIfAirPlayStalled(transitioningTo: status, waitingForNoItem: waitingForNoItem)
760
+ timeControlStatusDidChange(status)
761
+ case .audioDidStart:
762
+ load?.hasPlayed = true
763
+ if state != .loading { transition(.audioFrameDecoded) }
764
+ case .playedToEnd:
765
+ itemDidPlayToEnd()
766
+ case .stalled:
767
+ // Nudge, don't reconnect: a genuine drop is recovered by the retry and network paths.
768
+ recoverFromStall(reconnectIfLive: false)
769
+ case let .timedMetadata(metadata):
770
+ callbacks?.playerDidReceiveTimedMetadata(metadata)
771
+ engine.applyTimedMetadata(metadata)
772
+ }
773
+ }
774
+
775
+ /// The item can play through: ready, unless a seek still holds the ready transition.
776
+ private func bufferBecameSufficient() {
777
+ guard engine.hasLoadedAsset, !deferredSeek.defersReady, state != .playing else { return }
778
+ transition(.bufferingSufficient)
779
+ }
780
+
781
+ /// While loading, a status change belongs to the previous item. A pause near the end is the
782
+ /// end arriving, which `.playedToEnd` handles; one with the play intent is a buffer or a seek.
783
+ private func timeControlStatusDidChange(_ status: PlayerTimeControlStatus) {
784
+ guard state != .loading else { return }
785
+ switch status {
786
+ case .paused:
787
+ let duration = engine.duration
788
+ guard duration <= 0 || engine.currentTime < duration - 0.5 else { return }
789
+ if !engine.hasLoadedAsset {
790
+ if state != .stopped { transition(.avPlayerPaused(hasAsset: false)) }
791
+ } else if state != .error, state != .stopped, !playWhenReady {
792
+ transition(.avPlayerPaused(hasAsset: true))
793
+ }
794
+ case .waitingToPlayAtSpecifiedRate:
795
+ if engine.hasLoadedAsset { transition(.avPlayerWaiting) }
796
+ case .playing:
797
+ transition(.avPlayerPlaying)
798
+ }
799
+ }
800
+
801
+ /// A failed load renders no audio, and without it iOS never elects the app onto the
802
+ /// now-playing surfaces (ADR 0005). Once per load: one burst either elects it or never will.
803
+ private func primeNowPlayingIfNeeded() {
804
+ guard playWhenReady, load?.claimNowPlayingPrime() == true else { return }
805
+ engine.primeNowPlaying()
806
+ }
807
+
808
+ /// A genuine end advances the queue; a dropped live stream or an underrun reported as an end
809
+ /// is recovered instead (see `EndOfTrackJudgement`).
810
+ private func itemDidPlayToEnd() {
811
+ let judgement = EndOfTrackJudgement(
812
+ isLive: currentTrack?.live == true,
813
+ currentTime: engine.currentTime,
814
+ duration: engine.duration,
815
+ )
816
+ switch judgement.outcome {
817
+ case .ended: trackDidPlayToEnd()
818
+ case .stalled: recoverFromStall(reconnectIfLive: true)
819
+ }
820
+ }
821
+
822
+ /// Recovers from a stall while the play intent holds: a live stream that ran out of data
823
+ /// (`reconnectIfLive`) rejoins the edge; otherwise play() un-parks AVPlayer from waiting.
824
+ private func recoverFromStall(reconnectIfLive: Bool) {
825
+ guard playWhenReady else { return }
826
+ if reconnectIfLive, currentTrack?.live == true {
827
+ seekToLiveEdge()
828
+ } else {
829
+ engine.play()
830
+ }
831
+ }
832
+
833
+ private var previousTimeControlStatus: PlayerTimeControlStatus?
834
+ private var previousWaitingForNoItem = false
835
+
836
+ /// AVPlayer can strand itself in .paused after a `.noItemToPlay` wait over AirPlay while the
837
+ /// intent is to play: play() is re-issued on exactly that transition.
838
+ private func recoverIfAirPlayStalled(transitioningTo current: PlayerTimeControlStatus, waitingForNoItem: Bool) {
839
+ let stalled = AirPlayStallJudgement(
840
+ previous: previousTimeControlStatus,
841
+ current: current,
842
+ previousWaitingReasonWasNoItemToPlay: previousWaitingForNoItem,
843
+ isAirPlay: engine.isAirPlayRoute,
844
+ playWhenReady: playWhenReady,
845
+ ).shouldNudge
846
+ previousTimeControlStatus = current
847
+ previousWaitingForNoItem = current == .waitingToPlayAtSpecifiedRate && waitingForNoItem
848
+ if stalled {
849
+ logger.info("AirPlay waiting→paused stall detected — nudging play()")
850
+ engine.play()
851
+ }
852
+ }
853
+
854
+ // MARK: - Connectivity
855
+
856
+ /// Re-renders the now-playing lines, whose stall line tells offline from buffering, and when
857
+ /// connectivity returns re-establishes a stalled stream. AVPlayer doesn't reliably report a
858
+ /// live stream's mid-stream drop as a failure: it waits with no error, so the retry loop never
859
+ /// engages. Only while stalled (.buffering) with play intent, so a pause or a retry that gave up
860
+ /// isn't resumed; and not while the retry loop is itself waiting for the network, which owns
861
+ /// that reload.
862
+ func networkStatusDidChange(isOnline: Bool) {
863
+ engine.renderNowPlaying()
864
+ guard isOnline, playWhenReady, state == .buffering, !retry.isWaitingForNetwork else { return }
865
+ logger.info("Connectivity restored while stalled — re-resolving to reconnect")
866
+ reloadResolving(startFromCurrentTime: true)
867
+ }
868
+
869
+ /// Time playback must have progressed before a buffer dip counts as a stall, so the initial
870
+ /// connect or a seek doesn't read as one.
871
+ private static let stallGraceSeconds: TimeInterval = 0.5
872
+
873
+ /// Ongoing playback is waiting for data. Mirrors Android's `stalled`, which ExoPlayer
874
+ /// distinguishes natively; iOS has no rebuffer-vs-initial signal.
875
+ var isStalled: Bool {
876
+ guard engine.hasItem else { return false }
877
+ return engine.currentTime > Self.stallGraceSeconds && playWhenReady && !engine.isPlaybackLikelyToKeepUp
878
+ }
879
+
880
+ // MARK: - Resume
881
+
882
+ /// The last persisted session; nil when nothing was persisted, or its track has since become
883
+ /// `disabled`, which never plays.
884
+ func persistedSession() -> PersistedPlaybackState? {
885
+ guard let snapshot = persistence.load() else {
886
+ logger.error("resume: nothing persisted")
887
+ return nil
888
+ }
889
+ guard snapshot.track.disabled != true else {
890
+ logger.info("resume: persisted track is disabled — refusing")
891
+ return nil
892
+ }
893
+ return snapshot
894
+ }
895
+
896
+ /// Plays a persisted session (a cold-start resume): its settings, then its queue — `expanded`,
897
+ /// the expansion of the track's contextual path, or the track alone.
898
+ func resume(_ snapshot: PersistedPlaybackState, queue expanded: (tracks: [Track], selectedIndex: Int)?) {
899
+ let track = snapshot.track.toNitro()
900
+ logger.info("resume: cold — restoring persisted track")
901
+ // Settings first: `setQueue` builds the shuffle order, and the mode events then precede the
902
+ // queue change, as on Android.
903
+ repeatMode = RepeatMode(fromString: snapshot.repeatMode) ?? .off
904
+ shuffleEnabled = snapshot.shuffleEnabled
905
+ rate = snapshot.playbackSpeed
906
+ let startMs = track.live == true ? nil : snapshot.positionMs
907
+ if let expanded {
908
+ setQueue(expanded.tracks, initialIndex: expanded.selectedIndex, startPositionMs: startMs, playWhenReady: true)
909
+ } else {
910
+ setQueue([track], initialIndex: 0, startPositionMs: startMs, playWhenReady: true)
911
+ }
912
+ }
913
+
914
+ /// Plays what `TrackSelector` resolved a picked track to.
915
+ func execute(_ intent: TrackSelector.PlaybackIntent) {
916
+ switch intent {
917
+ case let .skipTo(index):
918
+ do {
919
+ try skipTo(index, playWhenReady: true)
920
+ } catch {
921
+ logger.error("Failed to skip to track at index \(index): \(error)")
922
+ }
923
+ case let .setQueue(tracks, startIndex, sourcePath):
924
+ setQueue(tracks, initialIndex: startIndex, playWhenReady: true, sourcePath: sourcePath)
925
+ case let .loadTrack(track):
926
+ load(track, playWhenReady: true)
927
+ }
928
+ }
929
+
930
+ // MARK: - Now Playing Preview
931
+
932
+ /// Shows `track` on the now-playing surface before it is current, so a tapped track shows at
933
+ /// once while its queue and media resolve.
934
+ func previewNowPlaying(_ track: Track) {
935
+ engine.loadNowPlayingMetadata(for: track)
936
+ }
937
+
938
+ /// Puts the current track back over a preview that will not play, or clears the surface when
939
+ /// nothing is current.
940
+ func endNowPlayingPreview() {
941
+ guard let currentTrack else {
942
+ engine.clearNowPlaying()
943
+ return
944
+ }
945
+ engine.loadNowPlayingMetadata(for: currentTrack)
946
+ engine.renderNowPlaying()
947
+ }
948
+
949
+ // MARK: - Progress Updates
950
+
951
+ func setProgressUpdateInterval(_ interval: TimeInterval?) {
952
+ progressTimer.setInterval(interval)
953
+ }
954
+
955
+ func setPlaybackIntervalEnabled(_ enabled: Bool) {
956
+ intervalTimer.setInterval(enabled ? 1 : nil)
957
+ }
958
+ }
959
+
960
+ extension Player: TrackSelectionPlayer, NowPlayingSource {}