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

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