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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1026) hide show
  1. package/README.md +36 -22
  2. package/android/build.gradle +42 -15
  3. package/android/gradle.properties +2 -2
  4. package/android/src/main/AndroidManifest.xml +3 -1
  5. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +543 -280
  6. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +38 -0
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +18 -2
  8. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +131 -0
  9. package/android/src/main/java/com/audiobrowser/Service.kt +41 -11
  10. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  11. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  12. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  13. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  14. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  15. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  16. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  17. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  18. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  19. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  20. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  21. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  22. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  23. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  24. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +7 -0
  25. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +12 -12
  26. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +111 -58
  27. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  28. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  29. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  30. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +530 -230
  31. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +218 -252
  32. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +23 -26
  33. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  34. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  35. package/android/src/main/java/com/audiobrowser/player/Player.kt +130 -63
  36. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  37. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  38. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +12 -4
  39. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  40. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  41. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  42. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  43. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  44. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  45. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  46. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  47. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +62 -40
  48. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  49. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  50. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  51. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +56 -52
  52. package/android/src/main/res/values/strings.xml +25 -5
  53. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  54. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  55. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +159 -0
  56. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  57. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  58. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  59. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  60. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  61. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  62. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  63. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  64. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  65. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  66. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  67. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  68. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  69. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +385 -0
  70. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +101 -58
  71. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  72. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  73. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +45 -0
  74. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +42 -2
  75. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  76. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  77. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  78. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  79. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +192 -0
  80. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  81. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  82. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  83. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  84. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  85. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  86. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  87. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  88. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  89. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  90. package/ios/AVPlayerEngine.swift +362 -0
  91. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  92. package/ios/Browser/BrowseGate.swift +58 -0
  93. package/ios/Browser/BrowserConfig.swift +115 -81
  94. package/ios/Browser/BrowserError.swift +16 -0
  95. package/ios/Browser/BrowserManager.swift +155 -654
  96. package/ios/Browser/BrowserPathHelper.swift +68 -51
  97. package/ios/Browser/FavoriteSet.swift +46 -0
  98. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  99. package/ios/Browser/JsonModels.swift +270 -321
  100. package/ios/Browser/NavigationErrorState.swift +41 -0
  101. package/ios/Browser/PageResolver.swift +147 -0
  102. package/ios/Browser/RequestLayer.swift +185 -0
  103. package/ios/Browser/RequestPipeline.swift +303 -0
  104. package/ios/Browser/SearchDrillIn.swift +7 -7
  105. package/ios/Browser/SectionScope.swift +82 -23
  106. package/ios/Browser/SimpleRouter.swift +73 -144
  107. package/ios/Browser/StyleResolver.swift +58 -0
  108. package/ios/Browser/TabBarEntries.swift +9 -3
  109. package/ios/Browser/TrackIdTemplate.swift +37 -0
  110. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  111. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  112. package/ios/CarPlay/CarPlayController.swift +37 -1297
  113. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  114. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  115. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  116. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  117. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  118. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  119. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  120. package/ios/CarPlay/CarPlaySession.swift +207 -0
  121. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  122. package/ios/CarPlay/IntentHandlers.swift +96 -0
  123. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  124. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  125. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  126. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  127. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  128. package/ios/CarPlay/SectionPresentation.swift +77 -0
  129. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  130. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  131. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  132. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  133. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  134. package/ios/Extension/SearchParams+Query.swift +28 -0
  135. package/ios/Extension/Section+Copying.swift +29 -0
  136. package/ios/Extension/String+IcyCharset.swift +21 -0
  137. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  138. package/ios/Extension/Track+AVPlayer.swift +0 -16
  139. package/ios/Extension/Track+Copying.swift +11 -13
  140. package/ios/Extension/Track+Identity.swift +25 -0
  141. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  142. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  143. package/ios/Extension/URLError+Connectivity.swift +15 -0
  144. package/ios/Http/HttpClient.swift +71 -165
  145. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  146. package/ios/HybridAudioBrowser+Options.swift +105 -0
  147. package/ios/HybridAudioBrowser+Player.swift +341 -0
  148. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  149. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  150. package/ios/HybridAudioBrowser.swift +132 -1652
  151. package/ios/Model/NitroTypeStubs.swift +239 -24
  152. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  153. package/ios/Model/RemoteCommand.swift +6 -60
  154. package/ios/Model/TrackPlayerError.swift +2 -2
  155. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  156. package/ios/Observer/ItemObserver.swift +90 -0
  157. package/ios/Observer/PlayerObserver.swift +59 -0
  158. package/ios/Option/SessionCategories.swift +42 -92
  159. package/ios/Player/AudioSessionController.swift +191 -0
  160. package/ios/Player/DeferredSeek.swift +70 -0
  161. package/ios/Player/ErrorStatus.swift +50 -0
  162. package/ios/Player/MediaLoader.swift +66 -87
  163. package/ios/Player/NowPlayingLines.swift +36 -0
  164. package/ios/Player/NowPlayingUpdater.swift +180 -85
  165. package/ios/Player/PlaybackFailure.swift +125 -0
  166. package/ios/Player/PlaybackPersistence.swift +73 -0
  167. package/ios/Player/PlaybackTimer.swift +8 -2
  168. package/ios/Player/Player.swift +960 -0
  169. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  170. package/ios/Player/PlayerEngine.swift +104 -0
  171. package/ios/Player/PlayerStatusTypes.swift +2 -6
  172. package/ios/Player/QueueManager.swift +93 -67
  173. package/ios/Player/RetryLoop.swift +291 -0
  174. package/ios/Player/ShuffleOrder.swift +33 -0
  175. package/ios/Player/SleepTimerManager.swift +14 -16
  176. package/ios/Player/VolumeFader.swift +5 -0
  177. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  178. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  179. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  180. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  181. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  182. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  183. package/ios/Tests/DeferredSeekTests.swift +70 -0
  184. package/ios/Tests/EmitterTests.swift +22 -38
  185. package/ios/Tests/ErrorStatusTests.swift +50 -0
  186. package/ios/Tests/FavoriteSetTests.swift +60 -0
  187. package/ios/Tests/GenerationMemoTests.swift +121 -0
  188. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  189. package/ios/Tests/JsonModelsTests.swift +194 -1
  190. package/ios/Tests/LRUCacheTests.swift +110 -0
  191. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  192. package/ios/Tests/MediaLoaderTests.swift +36 -67
  193. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  194. package/ios/Tests/NowPlayingLinesTests.swift +43 -0
  195. package/ios/Tests/ObserverTests.swift +88 -0
  196. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  197. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  198. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  199. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  200. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +489 -311
  201. package/ios/Tests/PlayingStateTests.swift +42 -0
  202. package/ios/Tests/QueueManagerTests.swift +196 -115
  203. package/ios/Tests/ReadyValueTests.swift +73 -0
  204. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  205. package/ios/Tests/RequestLayerTests.swift +228 -0
  206. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  207. package/ios/Tests/RetryLoopTests.swift +305 -0
  208. package/ios/Tests/SearchDrillInTests.swift +16 -16
  209. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  210. package/ios/Tests/SectionPresentationTests.swift +98 -0
  211. package/ios/Tests/SectionScopeTests.swift +139 -54
  212. package/ios/Tests/SimpleRouterTests.swift +38 -3
  213. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  214. package/ios/Tests/StyleResolverTests.swift +132 -0
  215. package/ios/Tests/Support/TestTypes.swift +146 -101
  216. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  217. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  218. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  219. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  220. package/ios/Tests/TrackIdentityTests.swift +20 -0
  221. package/ios/Tests/TrackSelectorTests.swift +168 -33
  222. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  223. package/ios/TrackSelector.swift +62 -65
  224. package/ios/Util/ArtworkImageFetcher.swift +58 -1
  225. package/ios/Util/ConcurrentMap.swift +19 -0
  226. package/ios/Util/Emitter.swift +40 -12
  227. package/ios/Util/GenerationMemo.swift +36 -0
  228. package/ios/Util/LRUCache.swift +23 -159
  229. package/ios/Util/NetworkMonitor.swift +32 -32
  230. package/ios/Util/OutputPicker.swift +48 -0
  231. package/ios/Util/ReadyValue.swift +56 -0
  232. package/ios/Util/SFSymbolRenderer.swift +59 -31
  233. package/ios/Util/SVGProcessor.swift +9 -12
  234. package/lib/commonjs/AudioBrowser.js +8 -8
  235. package/lib/commonjs/AudioBrowser.js.map +1 -1
  236. package/lib/commonjs/CLAUDE.md +52 -0
  237. package/lib/commonjs/features/browser-config.js +12 -8
  238. package/lib/commonjs/features/browser-config.js.map +1 -1
  239. package/lib/commonjs/features/browser.js +11 -3
  240. package/lib/commonjs/features/browser.js.map +1 -1
  241. package/lib/commonjs/features/carConnection.js +1 -1
  242. package/lib/commonjs/features/equalizer.js +1 -1
  243. package/lib/commonjs/features/errors.js +3 -3
  244. package/lib/commonjs/features/favorites.js +14 -11
  245. package/lib/commonjs/features/favorites.js.map +1 -1
  246. package/lib/commonjs/features/gate.js +16 -1
  247. package/lib/commonjs/features/gate.js.map +1 -1
  248. package/lib/commonjs/features/metadata.js +20 -3
  249. package/lib/commonjs/features/metadata.js.map +1 -1
  250. package/lib/commonjs/features/network.js +1 -1
  251. package/lib/commonjs/features/nowPlaying.js +1 -1
  252. package/lib/commonjs/features/output.js +1 -1
  253. package/lib/commonjs/features/playback/controls.js +4 -2
  254. package/lib/commonjs/features/playback/controls.js.map +1 -1
  255. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  256. package/lib/commonjs/features/playback/playing.js +1 -1
  257. package/lib/commonjs/features/playback/progress.js +3 -2
  258. package/lib/commonjs/features/playback/progress.js.map +1 -1
  259. package/lib/commonjs/features/playback/rate.js +8 -1
  260. package/lib/commonjs/features/playback/rate.js.map +1 -1
  261. package/lib/commonjs/features/playback/state.js +3 -4
  262. package/lib/commonjs/features/playback/state.js.map +1 -1
  263. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  264. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  265. package/lib/commonjs/features/playback/volume.js +1 -1
  266. package/lib/commonjs/features/player/options.js +48 -34
  267. package/lib/commonjs/features/player/options.js.map +1 -1
  268. package/lib/commonjs/features/player/setup.js +18 -9
  269. package/lib/commonjs/features/player/setup.js.map +1 -1
  270. package/lib/commonjs/features/player/validateOptions.js +23 -0
  271. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  272. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  273. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  274. package/lib/commonjs/features/queue/queue.js +13 -6
  275. package/lib/commonjs/features/queue/queue.js.map +1 -1
  276. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  277. package/lib/commonjs/features/queue/shuffle.js +1 -1
  278. package/lib/commonjs/features/remoteControls.js +13 -92
  279. package/lib/commonjs/features/remoteControls.js.map +1 -1
  280. package/lib/commonjs/features/sleepTimer.js +13 -1
  281. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  282. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  283. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  284. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  285. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  286. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  287. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  288. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  289. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  290. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  291. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  292. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  293. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  294. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  295. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  296. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  297. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  298. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  299. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  300. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  301. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  302. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  303. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  304. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  305. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  306. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  307. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  308. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  309. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  310. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  311. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  312. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  313. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  314. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  315. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  316. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  317. package/lib/commonjs/web/browser/sections.js +89 -0
  318. package/lib/commonjs/web/browser/sections.js.map +1 -0
  319. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  320. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  321. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  322. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  323. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  324. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  325. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  326. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  327. package/lib/module/AudioBrowser.js +2 -1
  328. package/lib/module/AudioBrowser.js.map +1 -1
  329. package/lib/module/CLAUDE.md +52 -0
  330. package/lib/module/features/browser-config.js +12 -8
  331. package/lib/module/features/browser-config.js.map +1 -1
  332. package/lib/module/features/browser.js +11 -3
  333. package/lib/module/features/browser.js.map +1 -1
  334. package/lib/module/features/carConnection.js +1 -1
  335. package/lib/module/features/equalizer.js +1 -1
  336. package/lib/module/features/errors.js +3 -3
  337. package/lib/module/features/favorites.js +14 -11
  338. package/lib/module/features/favorites.js.map +1 -1
  339. package/lib/module/features/gate.js +16 -1
  340. package/lib/module/features/gate.js.map +1 -1
  341. package/lib/module/features/metadata.js +20 -3
  342. package/lib/module/features/metadata.js.map +1 -1
  343. package/lib/module/features/network.js +1 -1
  344. package/lib/module/features/nowPlaying.js +1 -1
  345. package/lib/module/features/output.js +1 -1
  346. package/lib/module/features/playback/controls.js +4 -2
  347. package/lib/module/features/playback/controls.js.map +1 -1
  348. package/lib/module/features/playback/playWhenReady.js +1 -1
  349. package/lib/module/features/playback/playing.js +1 -1
  350. package/lib/module/features/playback/progress.js +3 -2
  351. package/lib/module/features/playback/progress.js.map +1 -1
  352. package/lib/module/features/playback/rate.js +8 -1
  353. package/lib/module/features/playback/rate.js.map +1 -1
  354. package/lib/module/features/playback/state.js +3 -4
  355. package/lib/module/features/playback/state.js.map +1 -1
  356. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  357. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  358. package/lib/module/features/playback/volume.js +1 -1
  359. package/lib/module/features/player/options.js +47 -32
  360. package/lib/module/features/player/options.js.map +1 -1
  361. package/lib/module/features/player/setup.js +17 -8
  362. package/lib/module/features/player/setup.js.map +1 -1
  363. package/lib/module/features/player/validateOptions.js +19 -0
  364. package/lib/module/features/player/validateOptions.js.map +1 -0
  365. package/lib/module/features/queue/activeTrack.js +15 -4
  366. package/lib/module/features/queue/activeTrack.js.map +1 -1
  367. package/lib/module/features/queue/queue.js +13 -6
  368. package/lib/module/features/queue/queue.js.map +1 -1
  369. package/lib/module/features/queue/repeatMode.js +1 -1
  370. package/lib/module/features/queue/shuffle.js +1 -1
  371. package/lib/module/features/remoteControls.js +13 -92
  372. package/lib/module/features/remoteControls.js.map +1 -1
  373. package/lib/module/features/sleepTimer.js +13 -1
  374. package/lib/module/features/sleepTimer.js.map +1 -1
  375. package/lib/module/test-utils/reactNativeStub.js +58 -0
  376. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  377. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  378. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  379. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  380. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  381. package/lib/module/utils/getTrackIdentity.js +20 -0
  382. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  383. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  384. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  385. package/lib/module/web/NativeAudioBrowser.js +202 -77
  386. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  387. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  388. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  389. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  390. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  391. package/lib/module/web/TrackPlayer/Player.js +254 -39
  392. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  393. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  394. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  395. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  396. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  397. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  398. package/lib/module/web/browser/BrowserManager.js +175 -100
  399. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  400. package/lib/module/web/browser/FavoriteManager.js +31 -21
  401. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  402. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  403. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  404. package/lib/module/web/browser/SearchManager.js +18 -23
  405. package/lib/module/web/browser/SearchManager.js.map +1 -1
  406. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  407. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  408. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  409. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  410. package/lib/module/web/browser/sections.js +83 -0
  411. package/lib/module/web/browser/sections.js.map +1 -0
  412. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  413. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  414. package/lib/module/web/http/followMediaRedirect.js +215 -0
  415. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  416. package/lib/module/web/player/NowPlayingManager.js +4 -3
  417. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  418. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  419. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  420. package/lib/typescript/package.json +1 -0
  421. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  422. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  423. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  424. package/lib/typescript/src/features/browser.d.ts +10 -2
  425. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  426. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  427. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  428. package/lib/typescript/src/features/errors.d.ts +3 -3
  429. package/lib/typescript/src/features/favorites.d.ts +14 -11
  430. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  431. package/lib/typescript/src/features/gate.d.ts +18 -2
  432. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  433. package/lib/typescript/src/features/metadata.d.ts +20 -3
  434. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  435. package/lib/typescript/src/features/network.d.ts +1 -1
  436. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  437. package/lib/typescript/src/features/output.d.ts +1 -1
  438. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  439. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  440. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  441. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  442. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  443. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  444. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  445. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  446. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  447. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  448. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  449. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  450. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  451. package/lib/typescript/src/features/player/options.d.ts +108 -56
  452. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  453. package/lib/typescript/src/features/player/setup.d.ts +14 -4
  454. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  455. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  456. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  457. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  458. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  459. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  460. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  461. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  462. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  463. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  464. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  465. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  466. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  467. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  468. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  469. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  470. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  471. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  472. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  473. package/lib/typescript/src/types/browser.d.ts +93 -61
  474. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  475. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  476. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  477. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  478. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  479. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  480. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  481. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  482. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  483. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  484. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  485. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +1 -2
  486. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  487. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  488. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  489. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +12 -12
  490. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  491. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  492. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  493. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  494. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  495. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  496. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  497. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  498. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  499. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  500. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  501. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  502. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  503. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  504. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  505. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  506. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  507. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  508. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  509. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  510. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  511. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  512. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  513. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  514. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  515. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  516. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  517. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  518. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  519. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  520. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  521. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  522. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  523. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  524. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  525. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  526. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  527. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  528. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  529. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  530. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  531. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  532. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  533. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  534. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +9 -12
  535. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  536. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  537. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  538. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  539. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  540. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  541. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  542. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  543. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  544. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  545. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  546. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  547. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  548. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  549. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  550. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  551. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  552. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  553. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  554. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  555. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  556. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  557. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  558. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  559. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  560. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  561. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  564. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  565. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  566. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -53
  567. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  568. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  572. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  573. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  574. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  575. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  576. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  577. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  578. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  579. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  581. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  582. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  583. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  584. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  585. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +17 -14
  586. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +9 -12
  587. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  588. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  589. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  590. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  591. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +12 -12
  592. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  593. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  594. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  595. package/nitrogen/generated/android/c++/JOptions.hpp +9 -12
  596. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  597. package/nitrogen/generated/android/c++/JOutputType.hpp +2 -2
  598. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  599. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  600. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  602. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  605. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  607. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  608. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  609. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  610. package/nitrogen/generated/android/c++/{JNotificationButton.hpp → JRemoteButton.hpp} +19 -19
  611. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +86 -0
  612. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  613. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  616. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  619. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  621. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  622. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  623. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  625. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  626. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  627. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  628. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  630. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  631. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  632. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  633. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  634. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  635. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  637. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  638. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  639. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  640. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  641. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  642. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp +26 -0
  643. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +75 -0
  644. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  645. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  646. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  647. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +20 -3
  648. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  649. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  650. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  651. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  652. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  653. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  654. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  655. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  656. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  657. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  658. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  659. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  660. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  661. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  662. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  663. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  664. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  665. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  666. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  667. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  668. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  669. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  670. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  671. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  672. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  673. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  674. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  675. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  676. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  677. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  678. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  679. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  680. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  681. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  682. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  683. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  684. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  685. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  686. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  687. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  688. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  689. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  690. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  691. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  692. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  693. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  694. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  695. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  696. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  697. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  698. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  699. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  700. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  701. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  702. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  703. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  704. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  705. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  706. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  707. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  708. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  709. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  710. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  711. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  712. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  713. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  714. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  715. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  716. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  717. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  718. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  719. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +29 -0
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +20 -3
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  739. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  746. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  749. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{NotificationButton.kt → RemoteButton.kt} +3 -3
  752. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +61 -0
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Variant_NullType_NotificationButtonLayout.kt → Variant_NullType_RemoteButtonLayout.kt} +24 -15
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  782. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  783. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  784. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  785. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +779 -665
  786. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +34 -16
  787. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +36 -18
  788. package/nitrogen/generated/ios/swift/AndroidOptions.swift +12 -12
  789. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  790. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  791. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  792. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  793. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  794. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  795. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  796. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  797. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  798. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  799. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  800. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  801. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  802. package/nitrogen/generated/ios/swift/NitroAndroidUpdateOptions.swift +12 -12
  803. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  804. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  805. package/nitrogen/generated/ios/swift/{NotificationButton.swift → RemoteButton.swift} +6 -6
  806. package/nitrogen/generated/ios/swift/RemoteButtonLayout.swift +57 -0
  807. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  808. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  809. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  810. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  811. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  812. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  813. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  814. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  815. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  816. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  817. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +30 -0
  818. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  819. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  820. package/nitrogen/generated/shared/c++/AndroidOptions.hpp +8 -8
  821. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  822. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  823. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  824. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  825. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  826. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  827. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  828. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  829. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  830. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  831. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  832. package/nitrogen/generated/shared/c++/NitroAndroidUpdateOptions.hpp +8 -8
  833. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  834. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  835. package/nitrogen/generated/shared/c++/{NotificationButton.hpp → RemoteButton.hpp} +19 -19
  836. package/nitrogen/generated/shared/c++/RemoteButtonLayout.hpp +94 -0
  837. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  838. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  839. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  840. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  841. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  842. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  843. package/package.json +24 -11
  844. package/src/AudioBrowser.ts +2 -1
  845. package/src/CLAUDE.md +52 -0
  846. package/src/features/battery.test.ts +79 -0
  847. package/src/features/browser-config.test.ts +21 -6
  848. package/src/features/browser-config.ts +12 -8
  849. package/src/features/browser.test.ts +1 -1
  850. package/src/features/browser.ts +11 -3
  851. package/src/features/carConnection.ts +1 -1
  852. package/src/features/equalizer.ts +1 -1
  853. package/src/features/errors.ts +3 -3
  854. package/src/features/favorites.ts +14 -11
  855. package/src/features/gate.ts +16 -1
  856. package/src/features/hook-wiring.test.ts +302 -0
  857. package/src/features/metadata.ts +20 -3
  858. package/src/features/network.ts +1 -1
  859. package/src/features/nowPlaying.ts +1 -1
  860. package/src/features/output.ts +1 -1
  861. package/src/features/playback/controls.ts +4 -2
  862. package/src/features/playback/playWhenReady.ts +1 -1
  863. package/src/features/playback/playing.ts +1 -1
  864. package/src/features/playback/progress.test.ts +169 -0
  865. package/src/features/playback/progress.ts +3 -2
  866. package/src/features/playback/rate.ts +8 -1
  867. package/src/features/playback/state.ts +3 -4
  868. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  869. package/src/features/playback/trackPlaybackTime.ts +1 -6
  870. package/src/features/playback/volume.ts +1 -1
  871. package/src/features/player/options.ts +126 -76
  872. package/src/features/player/setup.test.ts +24 -7
  873. package/src/features/player/setup.ts +22 -10
  874. package/src/features/player/validateOptions.ts +21 -0
  875. package/src/features/queue/activeTrack.ts +15 -4
  876. package/src/features/queue/queue.ts +13 -6
  877. package/src/features/queue/repeatMode.ts +1 -1
  878. package/src/features/queue/shuffle.ts +1 -1
  879. package/src/features/remoteControls.ts +13 -92
  880. package/src/features/sleepTimer.test.ts +172 -0
  881. package/src/features/sleepTimer.ts +9 -1
  882. package/src/nitro-stub-drift.test.ts +277 -0
  883. package/src/public-surface.test.ts +147 -0
  884. package/src/specs/audio-browser.nitro.ts +5 -4
  885. package/src/style-resolution.test.ts +210 -0
  886. package/src/test-utils/reactNativeStub.ts +60 -0
  887. package/src/types/browser-native.ts +7 -3
  888. package/src/types/browser-nodes.ts +403 -134
  889. package/src/types/browser.ts +97 -63
  890. package/src/utils/LazyNativeEmitter.ts +28 -15
  891. package/src/utils/NativeUpdatedValue.ts +29 -13
  892. package/src/utils/getTrackIdentity.ts +20 -0
  893. package/src/utils/useDebug.test.ts +182 -0
  894. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  895. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  896. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  897. package/src/web/NativeAudioBrowser.ts +241 -84
  898. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  899. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  900. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  901. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  902. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  903. package/src/web/TrackPlayer/Player.ts +284 -37
  904. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  905. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  906. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  907. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  908. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  909. package/src/web/__tests__/lifecycle.test.ts +345 -0
  910. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  911. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  912. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  913. package/src/web/__tests__/retry.test.ts +169 -0
  914. package/src/web/browser/BrowserManager.ts +209 -111
  915. package/src/web/browser/FavoriteManager.test.ts +84 -0
  916. package/src/web/browser/FavoriteManager.ts +28 -23
  917. package/src/web/browser/NavigationErrorManager.ts +3 -1
  918. package/src/web/browser/SearchManager.test.ts +75 -0
  919. package/src/web/browser/SearchManager.ts +25 -28
  920. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  921. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  922. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  923. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  924. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  925. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  926. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  927. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  928. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  929. package/src/web/browser/sections.test.ts +91 -0
  930. package/src/web/browser/sections.ts +72 -0
  931. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  932. package/src/web/http/RequestConfigBuilder.ts +140 -33
  933. package/src/web/http/followMediaRedirect.test.ts +289 -0
  934. package/src/web/http/followMediaRedirect.ts +253 -0
  935. package/src/web/player/NowPlayingManager.ts +4 -3
  936. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  937. package/src/web/util/BrowserPathHelper.ts +70 -13
  938. package/website/guide/android-auto.md +114 -0
  939. package/website/guide/android-certificates.md +409 -0
  940. package/website/guide/artwork.md +255 -0
  941. package/website/guide/audio-output.md +135 -0
  942. package/website/guide/automotive.md +86 -0
  943. package/website/guide/basic-usage.md +151 -0
  944. package/website/guide/battery.md +115 -0
  945. package/website/guide/browser.md +587 -0
  946. package/website/guide/carplay.md +650 -0
  947. package/website/guide/configuration.md +173 -0
  948. package/website/guide/equalizer.md +231 -0
  949. package/website/guide/errors.md +310 -0
  950. package/website/guide/favorites.md +154 -0
  951. package/website/guide/gate.md +143 -0
  952. package/website/guide/getting-started.md +46 -0
  953. package/website/guide/hooks.md +238 -0
  954. package/website/guide/live-streams.md +125 -0
  955. package/website/guide/metadata.md +239 -0
  956. package/website/guide/migrating-from-track-player.md +244 -0
  957. package/website/guide/native-callback-fetch.md +127 -0
  958. package/website/guide/network.md +86 -0
  959. package/website/guide/now-playing.md +175 -0
  960. package/website/guide/playback.md +328 -0
  961. package/website/guide/queue.md +300 -0
  962. package/website/guide/remote-controls.md +256 -0
  963. package/website/guide/search.md +255 -0
  964. package/website/guide/sleep-timer.md +268 -0
  965. package/website/guide/track.md +247 -0
  966. package/ios/Bridge.h +0 -8
  967. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  968. package/ios/Browser/MediaResolveComposer.swift +0 -114
  969. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  970. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  971. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  972. package/ios/Model/MediaURL.swift +0 -67
  973. package/ios/Model/SourceType.swift +0 -6
  974. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  975. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  976. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  977. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  978. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  979. package/ios/Observer/PlayerStateObserver.swift +0 -50
  980. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  981. package/ios/Option/PitchAlgorithms.swift +0 -17
  982. package/ios/Option/TimeEventFrequency.swift +0 -18
  983. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  984. package/ios/Player/MediaIntentCriteria.swift +0 -139
  985. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  986. package/ios/Player/PlaybackCoordinator.swift +0 -754
  987. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  988. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  989. package/ios/Player/PlaybackStateStore.swift +0 -27
  990. package/ios/Player/PlayingStateManager.swift +0 -33
  991. package/ios/Player/RetryManager.swift +0 -322
  992. package/ios/Player/SeekCompletionHandler.swift +0 -3
  993. package/ios/Player/SleepTimerHandling.swift +0 -15
  994. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  995. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  996. package/ios/Tests/MediaResolveTests.swift +0 -126
  997. package/ios/Tests/OnceValueTests.swift +0 -79
  998. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  999. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1000. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1001. package/ios/Tests/RetryManagerTests.swift +0 -89
  1002. package/ios/TrackPlayer.swift +0 -1014
  1003. package/ios/TrackPlayerCallbacks.swift +0 -86
  1004. package/ios/Util/MetadataAdapter.swift +0 -131
  1005. package/ios/Util/OnceValue.swift +0 -104
  1006. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1007. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1008. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1009. package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp +0 -94
  1010. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1011. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1012. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp +0 -26
  1013. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp +0 -75
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt +0 -50
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1018. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1019. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1020. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1021. package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift +0 -92
  1022. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1023. package/nitrogen/generated/ios/swift/Variant_NullType_NotificationButtonLayout.swift +0 -18
  1024. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1025. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
  1026. package/nitrogen/generated/shared/c++/NotificationButtonLayout.hpp +0 -102
@@ -0,0 +1,291 @@
1
+ import AVFoundation
2
+ import Foundation
3
+ #if canImport(NitroModules)
4
+ import NitroModules
5
+ #endif
6
+ import os.log
7
+
8
+ /// Abstracts `NetworkMonitor` so tests can fake connectivity. Sendable because
9
+ /// the network-restore race reads it from a task-group child.
10
+ protocol NetworkStatusProviding: AnyObject, Sendable {
11
+ var isOnline: Bool { get }
12
+ }
13
+
14
+ /// Distinguishes playback failures from media-load failures.
15
+ /// Each context carries the retry strategy and the fallback error classification.
16
+ public enum PlaybackErrorContext {
17
+ /// AVPlayer/AVPlayerItem status failure — retry from current time, fallback `.playbackFailed`.
18
+ case playback
19
+ /// MediaLoader key-value load failure — retry from start, fallback `.failedToLoadKeyValue`.
20
+ case mediaLoad
21
+
22
+ var startFromCurrentTime: Bool {
23
+ switch self {
24
+ case .playback: true
25
+ case .mediaLoad: false
26
+ }
27
+ }
28
+
29
+ var fallbackError: TrackPlayerError.PlaybackError {
30
+ switch self {
31
+ case .playback: .playbackFailed
32
+ case .mediaLoad: .failedToLoadKeyValue
33
+ }
34
+ }
35
+ }
36
+
37
+ /// Retries failed loads: classifies each failure (`PlaybackFailure`), reports the ones it is
38
+ /// working on as advisory, and reloads after an exponential backoff until a budget runs out,
39
+ /// when it reports the error as terminal. Similar to Android's RetryLoadErrorHandlingPolicy.
40
+ ///
41
+ /// Two duration budgets apply, chosen by whether the current Load has produced audio
42
+ /// (`hasPlayed`, ADR 0004): a short first-connect budget, since a stream that fails before ever
43
+ /// playing is usually dead and the listener is waiting for a verdict, and the full recovery
44
+ /// budget for a stream that played and dropped. The short budget counts only online time, and
45
+ /// while offline a scheduled retry fires as soon as connectivity returns.
46
+ @MainActor
47
+ final class RetryLoop {
48
+ private let logger = Logger(subsystem: "com.audiobrowser", category: "RetryLoop")
49
+
50
+ enum Policy {
51
+ case disabled
52
+ case infinite
53
+ case limited(maxRetries: Int)
54
+ }
55
+
56
+ private static let defaultMaxRetryDurationMs: Double = 120_000
57
+ private static let defaultFirstConnectMaxRetryDurationMs: Double = 12_000
58
+
59
+ /// Prevents surprising playback resumption after long periods offline.
60
+ private var maxRetryDuration: TimeInterval = defaultMaxRetryDurationMs / 1000
61
+ /// Bounds retries of a load that has never produced audio, while online.
62
+ private var firstConnectMaxRetryDuration: TimeInterval = defaultFirstConnectMaxRetryDurationMs / 1000
63
+
64
+ /// Whether the current Load has produced audio. Read from the Load, which a mid-play `reset()`
65
+ /// (the healthy-playback refill) leaves alone.
66
+ var hasPlayed: () -> Bool = { false }
67
+ /// Whether a retry is still wanted (the play intent); checked before and after the backoff.
68
+ var shouldRetry: () -> Bool = { true }
69
+ /// Reloads, from the current time or from the start.
70
+ var onRetry: ((Bool) -> Void)?
71
+ /// The retries gave up, or the failure cannot be retried.
72
+ var onError: ((TrackPlayerError.PlaybackError) -> Void)?
73
+ /// A failure a retry is now scheduled for, reported before the backoff so UIs can show the
74
+ /// cause while the state stays non-terminal.
75
+ var onRetryingError: ((TrackPlayerError.PlaybackError) -> Void)?
76
+
77
+ weak var networkMonitor: (any NetworkStatusProviding)?
78
+
79
+ /// The retry in flight; session release waits while there is one.
80
+ private(set) var pendingTask: Task<Void, Never>?
81
+ /// True only while a scheduled retry waits for connectivity to return, so a stall-driven
82
+ /// reconnect can defer to it rather than load twice.
83
+ private(set) var isWaitingForNetwork = false
84
+ /// Retries executed since the budgets last reset.
85
+ private(set) var attempts = 0
86
+
87
+ /// Continuous audible playback that proves the stream recovered, so the budgets refill
88
+ /// (Android's HEALTHY_PLAYBACK_MS); without it a long-lived stream keeps its spent budget until
89
+ /// the track changes.
90
+ var healthyPlaybackDuration: Duration = .seconds(20)
91
+ /// The pending refill. Readable so tests can await the window instead of sleeping past it.
92
+ private(set) var healthyPlaybackTask: Task<Void, Never>?
93
+
94
+ private var policy: Policy = .disabled
95
+ private var firstRetryTime: Date?
96
+ /// First failure observed while online for the current load: the first-connect budget's
97
+ /// clock. Never set while offline, and wiped by any offline observation, so an offline stretch
98
+ /// cannot burn the short budget.
99
+ private var firstOnlineRetryTime: Date?
100
+
101
+ private let sleep: @Sendable (TimeInterval) async throws -> Void
102
+
103
+ /// - Parameter sleep: Waits out a backoff or a connectivity poll; tests make it instant.
104
+ init(
105
+ networkMonitor: (any NetworkStatusProviding)? = nil,
106
+ sleep: @escaping @Sendable (TimeInterval) async throws -> Void = { try await Task.sleep(for: .seconds($0)) },
107
+ ) {
108
+ self.networkMonitor = networkMonitor
109
+ self.sleep = sleep
110
+ }
111
+
112
+ var isEnabled: Bool {
113
+ if case .disabled = policy { return false }
114
+ return true
115
+ }
116
+
117
+ // MARK: - Configuration
118
+
119
+ func updatePolicy(from config: Variant_Bool_RetryConfig?) {
120
+ maxRetryDuration = Self.defaultMaxRetryDurationMs / 1000
121
+ firstConnectMaxRetryDuration = Self.defaultFirstConnectMaxRetryDurationMs / 1000
122
+ switch config {
123
+ case nil:
124
+ policy = .disabled
125
+ case let .first(enabled):
126
+ policy = enabled ? .infinite : .disabled
127
+ case let .second(retryConfig):
128
+ maxRetryDuration = (retryConfig.maxRetryDurationMs ?? Self.defaultMaxRetryDurationMs) / 1000
129
+ firstConnectMaxRetryDuration =
130
+ (retryConfig.firstConnectMaxRetryDurationMs ?? Self.defaultFirstConnectMaxRetryDurationMs) / 1000
131
+ // No attempt cap: retry indefinitely, bounded only by the duration.
132
+ policy = retryConfig.maxRetries.map { .limited(maxRetries: Int($0)) } ?? .infinite
133
+ }
134
+ logger.debug("Retry policy: \(String(describing: self.policy)), max duration \(self.maxRetryDuration)s")
135
+ }
136
+
137
+ // MARK: - Failures
138
+
139
+ func handleError(_ error: Error?, context: PlaybackErrorContext, httpStatusCode: Int? = nil) {
140
+ if let error {
141
+ let nsError = error as NSError
142
+ logger.error("[\(String(describing: context))] failure: domain=\(nsError.domain), code=\(nsError.code), localizedDescription=\(error.localizedDescription)")
143
+ } else {
144
+ logger.error("[\(String(describing: context))] failure with nil error")
145
+ }
146
+
147
+ let failure = PlaybackFailure.classify(error, httpStatusCode: httpStatusCode, fallback: context.fallbackError)
148
+ guard isEnabled, failure.retryable else {
149
+ logger.warning("Error not retryable, surfacing \(String(describing: failure.error))")
150
+ onError?(failure.error)
151
+ return
152
+ }
153
+ onRetryingError?(failure.error)
154
+ pendingTask?.cancel()
155
+ pendingTask = Task { [weak self] in
156
+ guard let self else { return }
157
+ let retried = await attemptRetry(startFromCurrentTime: context.startFromCurrentTime)
158
+ // Cancelled (track change, stop): stay silent, or the new track or a deliberate stop
159
+ // would flip to .error. The canceller owns the handle.
160
+ if Task.isCancelled { return }
161
+ if !retried { onError?(failure.error) }
162
+ pendingTask = nil
163
+ }
164
+ }
165
+
166
+ /// Drops the retry in flight without touching the budgets.
167
+ func cancel() {
168
+ pendingTask?.cancel()
169
+ pendingTask = nil
170
+ }
171
+
172
+ /// Drops the retry in flight and restarts the budgets.
173
+ func reset() {
174
+ cancel()
175
+ attempts = 0
176
+ firstRetryTime = nil
177
+ firstOnlineRetryTime = nil
178
+ isWaitingForNetwork = false
179
+ }
180
+
181
+ // MARK: - Healthy Playback
182
+
183
+ /// Starts the healthy-playback window; when it elapses between failures, the budgets refill.
184
+ func playbackBecameAudible() {
185
+ healthyPlaybackTask?.cancel()
186
+ healthyPlaybackTask = Task { [weak self, healthyPlaybackDuration] in
187
+ try? await Task.sleep(for: healthyPlaybackDuration)
188
+ guard let self, !Task.isCancelled else { return }
189
+ // reset() cancels a pending retry, which would silently kill an in-flight reconnect.
190
+ guard pendingTask == nil else { return }
191
+ reset()
192
+ }
193
+ }
194
+
195
+ func playbackStoppedBeingAudible() {
196
+ healthyPlaybackTask?.cancel()
197
+ healthyPlaybackTask = nil
198
+ }
199
+
200
+ // MARK: - Budgets
201
+
202
+ private var isOnline: Bool { networkMonitor?.isOnline ?? true }
203
+
204
+ /// The exhausted budget, or nil while budget remains. The recovery duration bounds everything,
205
+ /// offline waits included; the first-connect duration also bounds never-played loads, online
206
+ /// only.
207
+ private func exhaustedBudget() -> String? {
208
+ let now = Date()
209
+ if let start = firstRetryTime, now.timeIntervalSince(start) >= maxRetryDuration {
210
+ return "max retry duration (\(maxRetryDuration)s)"
211
+ }
212
+ if !hasPlayed(), isOnline, let start = firstOnlineRetryTime,
213
+ now.timeIntervalSince(start) >= firstConnectMaxRetryDuration
214
+ {
215
+ return "first-connect retry duration (\(firstConnectMaxRetryDuration)s)"
216
+ }
217
+ return nil
218
+ }
219
+
220
+ /// 1 s, 1.5 s, 2.3 s, 3.4 s, then 5 s.
221
+ private var backoff: TimeInterval {
222
+ min(1.0 * pow(1.5, Double(attempts)), 5.0)
223
+ }
224
+
225
+ /// Waits out the backoff, or connectivity's return, then reloads. False when the policy, the
226
+ /// play intent or a budget says stop, or the wait was cancelled.
227
+ func attemptRetry(startFromCurrentTime: Bool) async -> Bool {
228
+ guard isEnabled, shouldRetry() else { return false }
229
+ if case let .limited(maxRetries) = policy, attempts >= maxRetries {
230
+ logger.info("Max retries (\(maxRetries)) exceeded, giving up")
231
+ return false
232
+ }
233
+
234
+ if firstRetryTime == nil { firstRetryTime = Date() }
235
+ if isOnline {
236
+ if firstOnlineRetryTime == nil { firstOnlineRetryTime = Date() }
237
+ } else {
238
+ // Offline restarts the first-connect clock: the station gets its full online seconds
239
+ // again once connectivity returns.
240
+ firstOnlineRetryTime = nil
241
+ }
242
+ if let budget = exhaustedBudget() {
243
+ logger.info("\(budget) exceeded, giving up")
244
+ return false
245
+ }
246
+
247
+ logger.info("Scheduling retry after \(self.backoff)s")
248
+ guard await waitForDelayOrNetworkRestored(delaySeconds: backoff), !Task.isCancelled, shouldRetry() else {
249
+ return false
250
+ }
251
+ // Re-checked: the wait for connectivity may have been long.
252
+ if let budget = exhaustedBudget() {
253
+ logger.info("\(budget) exceeded after waiting, giving up")
254
+ return false
255
+ }
256
+
257
+ attempts += 1
258
+ logger.info("Executing retry #\(self.attempts)")
259
+ onRetry?(startFromCurrentTime)
260
+ return true
261
+ }
262
+
263
+ // MARK: - Network-Aware Waiting
264
+
265
+ /// True when it is time to retry, false when the wait was cancelled.
266
+ private func waitForDelayOrNetworkRestored(delaySeconds: TimeInterval) async -> Bool {
267
+ guard let monitor = networkMonitor, !monitor.isOnline else {
268
+ return await (try? sleep(delaySeconds)) != nil
269
+ }
270
+ logger.debug("Device is offline, will retry immediately when connectivity is restored")
271
+ let sleep = sleep
272
+ return await withTaskGroup(of: Bool.self, returning: Bool.self) { group in
273
+ group.addTask { await (try? sleep(delaySeconds)) != nil }
274
+ group.addTask { [weak self] in await self?.waitForNetworkRestored(monitor: monitor) ?? false }
275
+ let result = await group.next() ?? false
276
+ group.cancelAll()
277
+ return result
278
+ }
279
+ }
280
+
281
+ /// True when connectivity returned, false when cancelled.
282
+ private func waitForNetworkRestored(monitor: any NetworkStatusProviding) async -> Bool {
283
+ isWaitingForNetwork = true
284
+ defer { isWaitingForNetwork = false }
285
+ while !monitor.isOnline {
286
+ guard await (try? sleep(0.5)) != nil else { return false }
287
+ }
288
+ logger.info("Network restored, accelerating retry")
289
+ return true
290
+ }
291
+ }
@@ -39,6 +39,16 @@ struct ShuffleOrder {
39
39
  indexInShuffled = Self.buildIndexInShuffled(from: shuffled)
40
40
  }
41
41
 
42
+ /// Creates a shuffle order for the given length with `firstIndex` pinned to shuffle position 0.
43
+ ///
44
+ /// Playback starts on that track, so leaving it wherever the permutation put it would end the
45
+ /// queue as soon as it is reached — on average after half the queue, and immediately whenever it
46
+ /// lands last.
47
+ init(length: Int, firstIndex: Int) {
48
+ self.init(length: length)
49
+ reshuffle(keepingFirst: firstIndex)
50
+ }
51
+
42
52
  /// Creates a shuffle order with pre-defined indices
43
53
  init(shuffledIndices: [Int]) {
44
54
  shuffled = shuffledIndices
@@ -91,6 +101,13 @@ struct ShuffleOrder {
91
101
  return indexInShuffled[index] == 0
92
102
  }
93
103
 
104
+ /// The item's position in the shuffle order, or nil when it has none.
105
+ func shufflePosition(of index: Int) -> Int? {
106
+ guard index >= 0, index < indexInShuffled.count else { return nil }
107
+ let position = indexInShuffled[index]
108
+ return position >= 0 ? position : nil
109
+ }
110
+
94
111
  // MARK: - Mutation
95
112
 
96
113
  /// Inserts items at random positions in the shuffle order
@@ -115,6 +132,22 @@ struct ShuffleOrder {
115
132
  indexInShuffled = Self.buildIndexInShuffled(from: shuffled)
116
133
  }
117
134
 
135
+ /// Inserts one item at `insertionIndex`, placing it at an explicit shuffle
136
+ /// position rather than a random one.
137
+ ///
138
+ /// Used by a queue `move`, which permutes positions but not identities: the
139
+ /// item already had a place in the playback order, and re-randomising it
140
+ /// silently reorders playback. For the *playing* track it can drop it at the
141
+ /// end of the order, which then reads as `isLastInPlaybackOrder` — the queue
142
+ /// reports itself over at the next track end, with tracks still unplayed.
143
+ mutating func insert(at insertionIndex: Int, atShufflePosition position: Int) {
144
+ for i in 0 ..< shuffled.count where shuffled[i] >= insertionIndex {
145
+ shuffled[i] += 1
146
+ }
147
+ shuffled.insert(insertionIndex, at: min(max(0, position), shuffled.count))
148
+ indexInShuffled = Self.buildIndexInShuffled(from: shuffled)
149
+ }
150
+
118
151
  /// Removes items in the specified range from the shuffle order
119
152
  mutating func remove(from indexFrom: Int, to indexToExclusive: Int) {
120
153
  let removeCount = indexToExclusive - indexFrom
@@ -40,19 +40,25 @@ struct MainQueueSleepTimerScheduler: SleepTimerScheduling {
40
40
  /// Manages sleep timer functionality for the audio player.
41
41
  /// Supports both time-based timers and end-of-track timers.
42
42
  @MainActor
43
- class SleepTimerManager: SleepTimerHandling {
43
+ final class SleepTimerManager {
44
44
  // MARK: - Properties
45
45
 
46
46
  private let scheduler: any SleepTimerScheduling
47
+ /// Fades the volume out before a time-based timer's deadline.
48
+ private let fader: VolumeFader
47
49
 
48
50
  // nonisolated(unsafe) for deinit cleanup — deinit is always nonisolated in Swift 6.
49
51
  private nonisolated(unsafe) var sleepTimerJob: (any SleepTimerJob)?
50
52
  private nonisolated(unsafe) var fadeJob: (any SleepTimerJob)?
51
53
 
52
- init(scheduler: any SleepTimerScheduling = MainQueueSleepTimerScheduler()) {
54
+ init(fader: VolumeFader, scheduler: any SleepTimerScheduling = MainQueueSleepTimerScheduler()) {
55
+ self.fader = fader
53
56
  self.scheduler = scheduler
54
57
  }
55
58
 
59
+ /// Whether the fade before the deadline is running.
60
+ var isFading: Bool { fader.isActive }
61
+
56
62
  /// The time when playback should stop (seconds since epoch), or -1 if inactive
57
63
  private(set) var sleepTimerTime: TimeInterval = -1 {
58
64
  didSet {
@@ -73,17 +79,9 @@ class SleepTimerManager: SleepTimerHandling {
73
79
  }
74
80
  }
75
81
 
76
- /// Callback invoked when the sleep timer fires
82
+ /// Halts playback when the timer fires; the pre-fade volume is restored after it returns.
77
83
  var onComplete: (() -> Void)?
78
84
 
79
- /// Callback invoked when the fade-out window of a time-based timer begins
80
- var onFadeStart: ((_ duration: TimeInterval) -> Void)?
81
-
82
- /// Callback invoked when a timer is cancelled/replaced while its fade may be
83
- /// running — the listener restores the pre-fade volume. Not invoked on
84
- /// completion: there the pause lands first, then the volume is restored.
85
- var onFadeCancel: (() -> Void)?
86
-
87
85
  /// Callback invoked when the sleep timer state changes
88
86
  var onChanged: ((SleepTimerState) -> Void)?
89
87
 
@@ -97,7 +95,7 @@ class SleepTimerManager: SleepTimerHandling {
97
95
  if !hasSleepTimer { return false }
98
96
  sleepTimerTime = -1
99
97
  willSleepWhenCurrentItemReachesEnd = false
100
- onFadeCancel?()
98
+ fader.cancel(restoringVolume: true)
101
99
  onChanged?(.first(NullType.null))
102
100
  return true
103
101
  }
@@ -129,7 +127,7 @@ class SleepTimerManager: SleepTimerHandling {
129
127
  /// deadline (clamped to `seconds`); silence lands exactly at the deadline
130
128
  func set(seconds: TimeInterval, fadeDuration: TimeInterval? = nil) {
131
129
  cancelSleepTimerJob()
132
- onFadeCancel?()
130
+ fader.cancel(restoringVolume: true)
133
131
  sleepTimerTime = Date().timeIntervalSince1970 + seconds
134
132
  sleepTimerJob = scheduler.schedule(after: seconds) { [weak self] in
135
133
  self?.complete()
@@ -137,7 +135,7 @@ class SleepTimerManager: SleepTimerHandling {
137
135
  if let fadeDuration, fadeDuration > 0 {
138
136
  let fade = min(fadeDuration, seconds)
139
137
  fadeJob = scheduler.schedule(after: seconds - fade) { [weak self] in
140
- self?.onFadeStart?(fade)
138
+ self?.fader.start(duration: fade)
141
139
  }
142
140
  }
143
141
  if let state = get() { onChanged?(state) }
@@ -148,7 +146,7 @@ class SleepTimerManager: SleepTimerHandling {
148
146
  let changed = !willSleepWhenCurrentItemReachesEnd
149
147
  willSleepWhenCurrentItemReachesEnd = true
150
148
  if changed {
151
- onFadeCancel?()
149
+ fader.cancel(restoringVolume: true)
152
150
  if let state = get() { onChanged?(state) }
153
151
  }
154
152
  }
@@ -182,7 +180,7 @@ class SleepTimerManager: SleepTimerHandling {
182
180
  sleepTimerTime = -1
183
181
  willSleepWhenCurrentItemReachesEnd = false
184
182
  onChanged?(.first(NullType.null))
185
- onComplete?()
183
+ fader.resolve { onComplete?() }
186
184
  }
187
185
 
188
186
  deinit {
@@ -19,6 +19,9 @@ final class VolumeFader {
19
19
 
20
20
  var isActive: Bool { originalVolume != nil }
21
21
 
22
+ /// The length of the running fade.
23
+ private(set) var duration: TimeInterval?
24
+
22
25
  init(getVolume: @escaping () -> Float, setVolume: @escaping (Float) -> Void) {
23
26
  self.getVolume = getVolume
24
27
  self.setVolume = setVolume
@@ -30,6 +33,7 @@ final class VolumeFader {
30
33
  let baseVolume = originalVolume ?? getVolume()
31
34
  cancel(restoringVolume: false)
32
35
  originalVolume = baseVolume
36
+ self.duration = duration
33
37
  guard duration > 0 else { return }
34
38
 
35
39
  let startDate = Date()
@@ -57,6 +61,7 @@ final class VolumeFader {
57
61
  timer = nil
58
62
  guard let originalVolume else { return }
59
63
  self.originalVolume = nil
64
+ duration = nil
60
65
  if restoringVolume { setVolume(originalVolume) }
61
66
  }
62
67
 
@@ -0,0 +1,43 @@
1
+ #if canImport(NitroModules)
2
+ import NitroModules
3
+ #endif
4
+
5
+ /// The callbacks `RemoteCommandController` invokes when the system delivers a
6
+ /// remote command (lock screen, Control Center, CarPlay, headset).
7
+ ///
8
+ /// Its own protocol so the controller depends only on what it calls.
9
+ /// `AVPlayerEngineCallbacks` extends it, so conformers implement both at once.
10
+ @MainActor protocol RemoteCommandCallbacks: AnyObject {
11
+ /// Called when play is triggered remotely.
12
+ func remotePlay()
13
+
14
+ /// Called when pause is triggered remotely.
15
+ func remotePause()
16
+
17
+ /// Called when stop is triggered remotely.
18
+ func remoteStop()
19
+
20
+ /// Called when next is triggered remotely.
21
+ func remoteNext()
22
+
23
+ /// Called when previous is triggered remotely.
24
+ func remotePrevious()
25
+
26
+ /// Called when jump forward is triggered remotely.
27
+ func remoteJumpForward(interval: Double)
28
+
29
+ /// Called when jump backward is triggered remotely.
30
+ func remoteJumpBackward(interval: Double)
31
+
32
+ /// Called when seek is triggered remotely.
33
+ func remoteSeek(position: Double)
34
+
35
+ /// Called when repeat mode change is triggered remotely (CarPlay/lock screen).
36
+ func remoteChangeRepeatMode(mode: RepeatMode)
37
+
38
+ /// Called when shuffle mode change is triggered remotely (CarPlay/lock screen).
39
+ func remoteChangeShuffleMode(enabled: Bool)
40
+
41
+ /// Called when playback rate change is triggered remotely (CarPlay/lock screen).
42
+ func remoteChangePlaybackRate(rate: Float)
43
+ }