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

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 (1025) 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 +9 -6
  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/TestFixtures.kt +123 -34
  56. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  57. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  58. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  59. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  60. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  61. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  62. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  63. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  64. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  65. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  66. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  67. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  68. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +385 -0
  69. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +101 -58
  70. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  71. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  72. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +45 -0
  73. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +42 -2
  74. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  75. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  76. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  77. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  78. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +185 -0
  79. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  80. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  81. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  82. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  83. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  84. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  85. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  86. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  87. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  88. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  89. package/ios/AVPlayerEngine.swift +362 -0
  90. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  91. package/ios/Browser/BrowseGate.swift +58 -0
  92. package/ios/Browser/BrowserConfig.swift +115 -81
  93. package/ios/Browser/BrowserError.swift +16 -0
  94. package/ios/Browser/BrowserManager.swift +155 -654
  95. package/ios/Browser/BrowserPathHelper.swift +68 -51
  96. package/ios/Browser/FavoriteSet.swift +46 -0
  97. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  98. package/ios/Browser/JsonModels.swift +270 -321
  99. package/ios/Browser/NavigationErrorState.swift +41 -0
  100. package/ios/Browser/PageResolver.swift +147 -0
  101. package/ios/Browser/RequestLayer.swift +185 -0
  102. package/ios/Browser/RequestPipeline.swift +303 -0
  103. package/ios/Browser/SearchDrillIn.swift +7 -7
  104. package/ios/Browser/SectionScope.swift +82 -23
  105. package/ios/Browser/SimpleRouter.swift +73 -144
  106. package/ios/Browser/StyleResolver.swift +58 -0
  107. package/ios/Browser/TabBarEntries.swift +9 -3
  108. package/ios/Browser/TrackIdTemplate.swift +37 -0
  109. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  110. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  111. package/ios/CarPlay/CarPlayController.swift +37 -1297
  112. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  113. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  114. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  115. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  116. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  117. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  118. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  119. package/ios/CarPlay/CarPlaySession.swift +207 -0
  120. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  121. package/ios/CarPlay/IntentHandlers.swift +96 -0
  122. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  123. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  124. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  125. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  126. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  127. package/ios/CarPlay/SectionPresentation.swift +77 -0
  128. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  129. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  130. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  131. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  132. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  133. package/ios/Extension/SearchParams+Query.swift +28 -0
  134. package/ios/Extension/Section+Copying.swift +29 -0
  135. package/ios/Extension/String+IcyCharset.swift +21 -0
  136. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  137. package/ios/Extension/Track+AVPlayer.swift +0 -16
  138. package/ios/Extension/Track+Copying.swift +11 -13
  139. package/ios/Extension/Track+Identity.swift +25 -0
  140. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  141. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  142. package/ios/Extension/URLError+Connectivity.swift +15 -0
  143. package/ios/Http/HttpClient.swift +71 -165
  144. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  145. package/ios/HybridAudioBrowser+Options.swift +105 -0
  146. package/ios/HybridAudioBrowser+Player.swift +341 -0
  147. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  148. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  149. package/ios/HybridAudioBrowser.swift +132 -1652
  150. package/ios/Model/NitroTypeStubs.swift +239 -24
  151. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  152. package/ios/Model/RemoteCommand.swift +6 -60
  153. package/ios/Model/TrackPlayerError.swift +2 -2
  154. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  155. package/ios/Observer/ItemObserver.swift +90 -0
  156. package/ios/Observer/PlayerObserver.swift +59 -0
  157. package/ios/Option/SessionCategories.swift +42 -92
  158. package/ios/Player/AudioSessionController.swift +191 -0
  159. package/ios/Player/DeferredSeek.swift +70 -0
  160. package/ios/Player/ErrorStatus.swift +50 -0
  161. package/ios/Player/MediaLoader.swift +66 -87
  162. package/ios/Player/NowPlayingLines.swift +36 -0
  163. package/ios/Player/NowPlayingUpdater.swift +180 -85
  164. package/ios/Player/PlaybackFailure.swift +125 -0
  165. package/ios/Player/PlaybackPersistence.swift +73 -0
  166. package/ios/Player/PlaybackTimer.swift +8 -2
  167. package/ios/Player/Player.swift +960 -0
  168. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  169. package/ios/Player/PlayerEngine.swift +104 -0
  170. package/ios/Player/PlayerStatusTypes.swift +2 -6
  171. package/ios/Player/QueueManager.swift +93 -67
  172. package/ios/Player/RetryLoop.swift +291 -0
  173. package/ios/Player/ShuffleOrder.swift +33 -0
  174. package/ios/Player/SleepTimerManager.swift +14 -16
  175. package/ios/Player/VolumeFader.swift +5 -0
  176. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  177. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  178. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  179. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  180. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  181. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  182. package/ios/Tests/DeferredSeekTests.swift +70 -0
  183. package/ios/Tests/EmitterTests.swift +22 -38
  184. package/ios/Tests/ErrorStatusTests.swift +50 -0
  185. package/ios/Tests/FavoriteSetTests.swift +60 -0
  186. package/ios/Tests/GenerationMemoTests.swift +121 -0
  187. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  188. package/ios/Tests/JsonModelsTests.swift +194 -1
  189. package/ios/Tests/LRUCacheTests.swift +110 -0
  190. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  191. package/ios/Tests/MediaLoaderTests.swift +36 -67
  192. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  193. package/ios/Tests/NowPlayingLinesTests.swift +43 -0
  194. package/ios/Tests/ObserverTests.swift +88 -0
  195. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  196. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  197. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  198. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  199. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +489 -311
  200. package/ios/Tests/PlayingStateTests.swift +42 -0
  201. package/ios/Tests/QueueManagerTests.swift +196 -115
  202. package/ios/Tests/ReadyValueTests.swift +73 -0
  203. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  204. package/ios/Tests/RequestLayerTests.swift +228 -0
  205. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  206. package/ios/Tests/RetryLoopTests.swift +305 -0
  207. package/ios/Tests/SearchDrillInTests.swift +16 -16
  208. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  209. package/ios/Tests/SectionPresentationTests.swift +98 -0
  210. package/ios/Tests/SectionScopeTests.swift +139 -54
  211. package/ios/Tests/SimpleRouterTests.swift +38 -3
  212. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  213. package/ios/Tests/StyleResolverTests.swift +132 -0
  214. package/ios/Tests/Support/TestTypes.swift +146 -101
  215. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  216. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  217. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  218. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  219. package/ios/Tests/TrackIdentityTests.swift +20 -0
  220. package/ios/Tests/TrackSelectorTests.swift +168 -33
  221. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  222. package/ios/TrackSelector.swift +62 -65
  223. package/ios/Util/ArtworkImageFetcher.swift +58 -1
  224. package/ios/Util/ConcurrentMap.swift +19 -0
  225. package/ios/Util/Emitter.swift +40 -12
  226. package/ios/Util/GenerationMemo.swift +36 -0
  227. package/ios/Util/LRUCache.swift +23 -159
  228. package/ios/Util/NetworkMonitor.swift +32 -32
  229. package/ios/Util/OutputPicker.swift +48 -0
  230. package/ios/Util/ReadyValue.swift +56 -0
  231. package/ios/Util/SFSymbolRenderer.swift +59 -31
  232. package/ios/Util/SVGProcessor.swift +9 -12
  233. package/lib/commonjs/AudioBrowser.js +8 -8
  234. package/lib/commonjs/AudioBrowser.js.map +1 -1
  235. package/lib/commonjs/CLAUDE.md +52 -0
  236. package/lib/commonjs/features/browser-config.js +12 -8
  237. package/lib/commonjs/features/browser-config.js.map +1 -1
  238. package/lib/commonjs/features/browser.js +11 -3
  239. package/lib/commonjs/features/browser.js.map +1 -1
  240. package/lib/commonjs/features/carConnection.js +1 -1
  241. package/lib/commonjs/features/equalizer.js +1 -1
  242. package/lib/commonjs/features/errors.js +3 -3
  243. package/lib/commonjs/features/favorites.js +14 -11
  244. package/lib/commonjs/features/favorites.js.map +1 -1
  245. package/lib/commonjs/features/gate.js +16 -1
  246. package/lib/commonjs/features/gate.js.map +1 -1
  247. package/lib/commonjs/features/metadata.js +20 -3
  248. package/lib/commonjs/features/metadata.js.map +1 -1
  249. package/lib/commonjs/features/network.js +1 -1
  250. package/lib/commonjs/features/nowPlaying.js +1 -1
  251. package/lib/commonjs/features/output.js +1 -1
  252. package/lib/commonjs/features/playback/controls.js +4 -2
  253. package/lib/commonjs/features/playback/controls.js.map +1 -1
  254. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  255. package/lib/commonjs/features/playback/playing.js +1 -1
  256. package/lib/commonjs/features/playback/progress.js +3 -2
  257. package/lib/commonjs/features/playback/progress.js.map +1 -1
  258. package/lib/commonjs/features/playback/rate.js +8 -1
  259. package/lib/commonjs/features/playback/rate.js.map +1 -1
  260. package/lib/commonjs/features/playback/state.js +3 -4
  261. package/lib/commonjs/features/playback/state.js.map +1 -1
  262. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  263. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  264. package/lib/commonjs/features/playback/volume.js +1 -1
  265. package/lib/commonjs/features/player/options.js +48 -34
  266. package/lib/commonjs/features/player/options.js.map +1 -1
  267. package/lib/commonjs/features/player/setup.js +18 -9
  268. package/lib/commonjs/features/player/setup.js.map +1 -1
  269. package/lib/commonjs/features/player/validateOptions.js +23 -0
  270. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  271. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  272. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  273. package/lib/commonjs/features/queue/queue.js +13 -6
  274. package/lib/commonjs/features/queue/queue.js.map +1 -1
  275. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  276. package/lib/commonjs/features/queue/shuffle.js +1 -1
  277. package/lib/commonjs/features/remoteControls.js +13 -92
  278. package/lib/commonjs/features/remoteControls.js.map +1 -1
  279. package/lib/commonjs/features/sleepTimer.js +13 -1
  280. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  281. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  282. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  283. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  284. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  285. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  286. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  287. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  288. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  289. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  290. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  291. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  292. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  293. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  294. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  295. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  296. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  297. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  298. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  299. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  300. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  301. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  302. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  303. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  304. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  305. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  306. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  307. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  308. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  309. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  310. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  311. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  312. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  313. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  314. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  315. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  316. package/lib/commonjs/web/browser/sections.js +89 -0
  317. package/lib/commonjs/web/browser/sections.js.map +1 -0
  318. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  319. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  320. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  321. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  322. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  323. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  324. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  325. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  326. package/lib/module/AudioBrowser.js +2 -1
  327. package/lib/module/AudioBrowser.js.map +1 -1
  328. package/lib/module/CLAUDE.md +52 -0
  329. package/lib/module/features/browser-config.js +12 -8
  330. package/lib/module/features/browser-config.js.map +1 -1
  331. package/lib/module/features/browser.js +11 -3
  332. package/lib/module/features/browser.js.map +1 -1
  333. package/lib/module/features/carConnection.js +1 -1
  334. package/lib/module/features/equalizer.js +1 -1
  335. package/lib/module/features/errors.js +3 -3
  336. package/lib/module/features/favorites.js +14 -11
  337. package/lib/module/features/favorites.js.map +1 -1
  338. package/lib/module/features/gate.js +16 -1
  339. package/lib/module/features/gate.js.map +1 -1
  340. package/lib/module/features/metadata.js +20 -3
  341. package/lib/module/features/metadata.js.map +1 -1
  342. package/lib/module/features/network.js +1 -1
  343. package/lib/module/features/nowPlaying.js +1 -1
  344. package/lib/module/features/output.js +1 -1
  345. package/lib/module/features/playback/controls.js +4 -2
  346. package/lib/module/features/playback/controls.js.map +1 -1
  347. package/lib/module/features/playback/playWhenReady.js +1 -1
  348. package/lib/module/features/playback/playing.js +1 -1
  349. package/lib/module/features/playback/progress.js +3 -2
  350. package/lib/module/features/playback/progress.js.map +1 -1
  351. package/lib/module/features/playback/rate.js +8 -1
  352. package/lib/module/features/playback/rate.js.map +1 -1
  353. package/lib/module/features/playback/state.js +3 -4
  354. package/lib/module/features/playback/state.js.map +1 -1
  355. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  356. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  357. package/lib/module/features/playback/volume.js +1 -1
  358. package/lib/module/features/player/options.js +47 -32
  359. package/lib/module/features/player/options.js.map +1 -1
  360. package/lib/module/features/player/setup.js +17 -8
  361. package/lib/module/features/player/setup.js.map +1 -1
  362. package/lib/module/features/player/validateOptions.js +19 -0
  363. package/lib/module/features/player/validateOptions.js.map +1 -0
  364. package/lib/module/features/queue/activeTrack.js +15 -4
  365. package/lib/module/features/queue/activeTrack.js.map +1 -1
  366. package/lib/module/features/queue/queue.js +13 -6
  367. package/lib/module/features/queue/queue.js.map +1 -1
  368. package/lib/module/features/queue/repeatMode.js +1 -1
  369. package/lib/module/features/queue/shuffle.js +1 -1
  370. package/lib/module/features/remoteControls.js +13 -92
  371. package/lib/module/features/remoteControls.js.map +1 -1
  372. package/lib/module/features/sleepTimer.js +13 -1
  373. package/lib/module/features/sleepTimer.js.map +1 -1
  374. package/lib/module/test-utils/reactNativeStub.js +58 -0
  375. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  376. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  377. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  378. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  379. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  380. package/lib/module/utils/getTrackIdentity.js +20 -0
  381. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  382. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  383. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  384. package/lib/module/web/NativeAudioBrowser.js +202 -77
  385. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  386. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  387. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  388. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  389. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  390. package/lib/module/web/TrackPlayer/Player.js +254 -39
  391. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  392. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  393. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  394. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  395. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  396. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  397. package/lib/module/web/browser/BrowserManager.js +175 -100
  398. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  399. package/lib/module/web/browser/FavoriteManager.js +31 -21
  400. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  401. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  402. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  403. package/lib/module/web/browser/SearchManager.js +18 -23
  404. package/lib/module/web/browser/SearchManager.js.map +1 -1
  405. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  406. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  407. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  408. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  409. package/lib/module/web/browser/sections.js +83 -0
  410. package/lib/module/web/browser/sections.js.map +1 -0
  411. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  412. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  413. package/lib/module/web/http/followMediaRedirect.js +215 -0
  414. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  415. package/lib/module/web/player/NowPlayingManager.js +4 -3
  416. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  417. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  418. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  419. package/lib/typescript/package.json +1 -0
  420. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  421. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  422. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  423. package/lib/typescript/src/features/browser.d.ts +10 -2
  424. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  425. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  426. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  427. package/lib/typescript/src/features/errors.d.ts +3 -3
  428. package/lib/typescript/src/features/favorites.d.ts +14 -11
  429. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  430. package/lib/typescript/src/features/gate.d.ts +18 -2
  431. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  432. package/lib/typescript/src/features/metadata.d.ts +20 -3
  433. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  434. package/lib/typescript/src/features/network.d.ts +1 -1
  435. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  436. package/lib/typescript/src/features/output.d.ts +1 -1
  437. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  438. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  439. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  440. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  441. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  442. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  443. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  444. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  445. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  446. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  447. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  448. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  449. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  450. package/lib/typescript/src/features/player/options.d.ts +108 -56
  451. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  452. package/lib/typescript/src/features/player/setup.d.ts +14 -4
  453. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  454. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  455. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  456. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  457. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  458. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  459. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  460. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  461. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  462. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  463. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  464. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  465. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  466. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  467. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  468. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  469. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  470. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  471. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  472. package/lib/typescript/src/types/browser.d.ts +93 -61
  473. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  474. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  475. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  476. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  477. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  478. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  479. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  480. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  481. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  482. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  483. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  484. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +1 -2
  485. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  486. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  487. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  488. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +12 -12
  489. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  490. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  491. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  492. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  493. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  494. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  495. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  496. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  497. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  498. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  499. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  500. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  501. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  502. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  503. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  504. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  505. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  506. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  507. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  508. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  509. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  510. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  511. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  512. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  513. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  514. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  515. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  516. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  517. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  518. 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
  519. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  520. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  521. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  522. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  523. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  524. 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
  525. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  526. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  527. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  528. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  529. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  530. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  531. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  532. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  533. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +9 -12
  534. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  535. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  536. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  537. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  538. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  539. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  540. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  541. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  542. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  543. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  544. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  545. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  546. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  547. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  548. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  549. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  550. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  551. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  552. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  553. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  554. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  555. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  556. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  557. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  558. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  559. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  560. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  561. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  564. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  565. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -53
  566. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  567. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  568. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  572. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  573. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  574. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  575. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  576. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  577. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  578. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  579. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  581. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  582. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  583. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  584. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +17 -14
  585. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +9 -12
  586. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  587. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  588. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  589. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  590. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +12 -12
  591. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  592. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  593. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  594. package/nitrogen/generated/android/c++/JOptions.hpp +9 -12
  595. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  596. package/nitrogen/generated/android/c++/JOutputType.hpp +2 -2
  597. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  598. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  599. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  600. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  602. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  605. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  607. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  608. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  609. package/nitrogen/generated/android/c++/{JNotificationButton.hpp → JRemoteButton.hpp} +19 -19
  610. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +86 -0
  611. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  612. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  613. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  616. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  619. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  621. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  622. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  623. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  625. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  626. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  627. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  628. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  630. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  631. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  632. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  633. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  634. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  635. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  637. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  638. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  639. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  640. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  641. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp +26 -0
  642. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +75 -0
  643. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  644. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  645. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  646. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +20 -3
  647. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  648. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  649. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  650. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  651. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  652. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  653. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  654. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  655. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  656. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  657. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  658. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  659. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  660. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  661. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  662. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  663. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  664. 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
  665. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  666. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  667. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  668. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  669. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  670. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  671. 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
  672. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  673. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  674. 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
  675. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  676. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  677. 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
  678. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  679. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  680. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  681. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  682. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  683. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  684. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  685. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  686. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  687. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  688. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  689. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  690. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  691. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  692. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  693. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  694. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  695. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  696. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  697. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  698. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  699. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  700. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  701. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  702. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  703. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  704. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  705. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  706. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  707. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  708. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  709. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  710. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  711. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  712. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  713. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  714. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  715. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  716. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  717. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  718. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  719. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +29 -0
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +20 -3
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  739. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  746. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  749. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{NotificationButton.kt → RemoteButton.kt} +3 -3
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +61 -0
  752. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Variant_NullType_NotificationButtonLayout.kt → Variant_NullType_RemoteButtonLayout.kt} +24 -15
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  782. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  783. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  784. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +779 -665
  785. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +34 -16
  786. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +36 -18
  787. package/nitrogen/generated/ios/swift/AndroidOptions.swift +12 -12
  788. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  789. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  790. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  791. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  792. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  793. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  794. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  795. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  796. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  797. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  798. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  799. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  800. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  801. package/nitrogen/generated/ios/swift/NitroAndroidUpdateOptions.swift +12 -12
  802. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  803. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  804. package/nitrogen/generated/ios/swift/{NotificationButton.swift → RemoteButton.swift} +6 -6
  805. package/nitrogen/generated/ios/swift/RemoteButtonLayout.swift +57 -0
  806. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  807. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  808. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  809. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  810. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  811. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  812. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  813. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  814. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  815. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  816. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +30 -0
  817. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  818. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  819. package/nitrogen/generated/shared/c++/AndroidOptions.hpp +8 -8
  820. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  821. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  822. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  823. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  824. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  825. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  826. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  827. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  828. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  829. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  830. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  831. package/nitrogen/generated/shared/c++/NitroAndroidUpdateOptions.hpp +8 -8
  832. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  833. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  834. package/nitrogen/generated/shared/c++/{NotificationButton.hpp → RemoteButton.hpp} +19 -19
  835. package/nitrogen/generated/shared/c++/RemoteButtonLayout.hpp +94 -0
  836. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  837. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  838. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  839. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  840. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  841. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  842. package/package.json +24 -11
  843. package/src/AudioBrowser.ts +2 -1
  844. package/src/CLAUDE.md +52 -0
  845. package/src/features/battery.test.ts +79 -0
  846. package/src/features/browser-config.test.ts +21 -6
  847. package/src/features/browser-config.ts +12 -8
  848. package/src/features/browser.test.ts +1 -1
  849. package/src/features/browser.ts +11 -3
  850. package/src/features/carConnection.ts +1 -1
  851. package/src/features/equalizer.ts +1 -1
  852. package/src/features/errors.ts +3 -3
  853. package/src/features/favorites.ts +14 -11
  854. package/src/features/gate.ts +16 -1
  855. package/src/features/hook-wiring.test.ts +302 -0
  856. package/src/features/metadata.ts +20 -3
  857. package/src/features/network.ts +1 -1
  858. package/src/features/nowPlaying.ts +1 -1
  859. package/src/features/output.ts +1 -1
  860. package/src/features/playback/controls.ts +4 -2
  861. package/src/features/playback/playWhenReady.ts +1 -1
  862. package/src/features/playback/playing.ts +1 -1
  863. package/src/features/playback/progress.test.ts +169 -0
  864. package/src/features/playback/progress.ts +3 -2
  865. package/src/features/playback/rate.ts +8 -1
  866. package/src/features/playback/state.ts +3 -4
  867. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  868. package/src/features/playback/trackPlaybackTime.ts +1 -6
  869. package/src/features/playback/volume.ts +1 -1
  870. package/src/features/player/options.ts +126 -76
  871. package/src/features/player/setup.test.ts +24 -7
  872. package/src/features/player/setup.ts +22 -10
  873. package/src/features/player/validateOptions.ts +21 -0
  874. package/src/features/queue/activeTrack.ts +15 -4
  875. package/src/features/queue/queue.ts +13 -6
  876. package/src/features/queue/repeatMode.ts +1 -1
  877. package/src/features/queue/shuffle.ts +1 -1
  878. package/src/features/remoteControls.ts +13 -92
  879. package/src/features/sleepTimer.test.ts +172 -0
  880. package/src/features/sleepTimer.ts +9 -1
  881. package/src/nitro-stub-drift.test.ts +277 -0
  882. package/src/public-surface.test.ts +147 -0
  883. package/src/specs/audio-browser.nitro.ts +5 -4
  884. package/src/style-resolution.test.ts +210 -0
  885. package/src/test-utils/reactNativeStub.ts +60 -0
  886. package/src/types/browser-native.ts +7 -3
  887. package/src/types/browser-nodes.ts +403 -134
  888. package/src/types/browser.ts +97 -63
  889. package/src/utils/LazyNativeEmitter.ts +28 -15
  890. package/src/utils/NativeUpdatedValue.ts +29 -13
  891. package/src/utils/getTrackIdentity.ts +20 -0
  892. package/src/utils/useDebug.test.ts +182 -0
  893. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  894. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  895. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  896. package/src/web/NativeAudioBrowser.ts +241 -84
  897. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  898. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  899. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  900. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  901. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  902. package/src/web/TrackPlayer/Player.ts +284 -37
  903. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  904. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  905. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  906. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  907. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  908. package/src/web/__tests__/lifecycle.test.ts +345 -0
  909. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  910. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  911. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  912. package/src/web/__tests__/retry.test.ts +169 -0
  913. package/src/web/browser/BrowserManager.ts +209 -111
  914. package/src/web/browser/FavoriteManager.test.ts +84 -0
  915. package/src/web/browser/FavoriteManager.ts +28 -23
  916. package/src/web/browser/NavigationErrorManager.ts +3 -1
  917. package/src/web/browser/SearchManager.test.ts +75 -0
  918. package/src/web/browser/SearchManager.ts +25 -28
  919. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  920. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  921. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  922. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  923. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  924. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  925. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  926. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  927. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  928. package/src/web/browser/sections.test.ts +91 -0
  929. package/src/web/browser/sections.ts +72 -0
  930. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  931. package/src/web/http/RequestConfigBuilder.ts +140 -33
  932. package/src/web/http/followMediaRedirect.test.ts +289 -0
  933. package/src/web/http/followMediaRedirect.ts +253 -0
  934. package/src/web/player/NowPlayingManager.ts +4 -3
  935. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  936. package/src/web/util/BrowserPathHelper.ts +70 -13
  937. package/website/guide/android-auto.md +114 -0
  938. package/website/guide/android-certificates.md +409 -0
  939. package/website/guide/artwork.md +255 -0
  940. package/website/guide/audio-output.md +135 -0
  941. package/website/guide/automotive.md +86 -0
  942. package/website/guide/basic-usage.md +151 -0
  943. package/website/guide/battery.md +115 -0
  944. package/website/guide/browser.md +587 -0
  945. package/website/guide/carplay.md +650 -0
  946. package/website/guide/configuration.md +173 -0
  947. package/website/guide/equalizer.md +231 -0
  948. package/website/guide/errors.md +310 -0
  949. package/website/guide/favorites.md +154 -0
  950. package/website/guide/gate.md +143 -0
  951. package/website/guide/getting-started.md +46 -0
  952. package/website/guide/hooks.md +238 -0
  953. package/website/guide/live-streams.md +125 -0
  954. package/website/guide/metadata.md +239 -0
  955. package/website/guide/migrating-from-track-player.md +244 -0
  956. package/website/guide/native-callback-fetch.md +127 -0
  957. package/website/guide/network.md +86 -0
  958. package/website/guide/now-playing.md +175 -0
  959. package/website/guide/playback.md +328 -0
  960. package/website/guide/queue.md +300 -0
  961. package/website/guide/remote-controls.md +256 -0
  962. package/website/guide/search.md +255 -0
  963. package/website/guide/sleep-timer.md +268 -0
  964. package/website/guide/track.md +247 -0
  965. package/ios/Bridge.h +0 -8
  966. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  967. package/ios/Browser/MediaResolveComposer.swift +0 -114
  968. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  969. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  970. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  971. package/ios/Model/MediaURL.swift +0 -67
  972. package/ios/Model/SourceType.swift +0 -6
  973. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  974. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  975. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  976. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  977. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  978. package/ios/Observer/PlayerStateObserver.swift +0 -50
  979. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  980. package/ios/Option/PitchAlgorithms.swift +0 -17
  981. package/ios/Option/TimeEventFrequency.swift +0 -18
  982. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  983. package/ios/Player/MediaIntentCriteria.swift +0 -139
  984. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  985. package/ios/Player/PlaybackCoordinator.swift +0 -754
  986. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  987. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  988. package/ios/Player/PlaybackStateStore.swift +0 -27
  989. package/ios/Player/PlayingStateManager.swift +0 -33
  990. package/ios/Player/RetryManager.swift +0 -322
  991. package/ios/Player/SeekCompletionHandler.swift +0 -3
  992. package/ios/Player/SleepTimerHandling.swift +0 -15
  993. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  994. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  995. package/ios/Tests/MediaResolveTests.swift +0 -126
  996. package/ios/Tests/OnceValueTests.swift +0 -79
  997. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  998. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  999. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1000. package/ios/Tests/RetryManagerTests.swift +0 -89
  1001. package/ios/TrackPlayer.swift +0 -1014
  1002. package/ios/TrackPlayerCallbacks.swift +0 -86
  1003. package/ios/Util/MetadataAdapter.swift +0 -131
  1004. package/ios/Util/OnceValue.swift +0 -104
  1005. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1006. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1007. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1008. package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp +0 -94
  1009. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1010. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1011. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp +0 -26
  1012. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp +0 -75
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt +0 -50
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1017. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1018. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1019. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1020. package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift +0 -92
  1021. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1022. package/nitrogen/generated/ios/swift/Variant_NullType_NotificationButtonLayout.swift +0 -18
  1023. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1024. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
  1025. package/nitrogen/generated/shared/c++/NotificationButtonLayout.hpp +0 -102
@@ -1,7 +1,7 @@
1
1
  package com.audiobrowser.player
2
2
 
3
+ import com.audiobrowser.extension.identity
3
4
  import com.audiobrowser.util.url
4
-
5
5
  import com.margelo.nitro.audiobrowser.FormatNowPlayingParams
6
6
  import com.margelo.nitro.audiobrowser.NowPlayingMetadata
7
7
  import com.margelo.nitro.audiobrowser.NowPlayingUpdate
@@ -30,7 +30,8 @@ interface NowPlayingSurface {
30
30
  val playbackError: PlaybackError?
31
31
 
32
32
  /**
33
- * MUST be the real play/pause intent read from the underlying ExoPlayer — not the
33
+ * MUST be the real play/pause intent read from the underlying ExoPlayer, false while a transient
34
+ * audio focus loss suppresses output (as iOS pauses on an interruption) — not the
34
35
  * InterceptingPlayer-masked value, which can report false through a masked terminal error to keep
35
36
  * the session paused-but-alive. The formatter receives this; feeding it the masked value breaks
36
37
  * its output exactly in the error case the mask exists for.
@@ -106,10 +107,11 @@ class NowPlayingUpdater(private val surface: NowPlayingSurface, private val scop
106
107
  private var lastPublished: Published? = null
107
108
 
108
109
  /**
109
- * The track id whose now-playing artwork has been resolved (or is being resolved), so a
110
- * `nowPlayingArtwork` resolve runs once per track instead of on every render.
110
+ * The track identity (id-or-src, falling back to path — same key as [Published]) whose
111
+ * now-playing artwork has been resolved (or is being resolved), so a `nowPlayingArtwork` resolve
112
+ * runs once per track — id-less tracks included — instead of on every render.
111
113
  */
112
- private var artworkResolvedForTrackId: String? = null
114
+ private var artworkResolvedForTrack: String? = null
113
115
 
114
116
  /** Size hint (px, square) for now-playing artwork. Mirrors iOS (screen-width-capped to 1200). */
115
117
  private val artworkSizePx = 1200.0
@@ -165,7 +167,7 @@ class NowPlayingUpdater(private val surface: NowPlayingSurface, private val scop
165
167
  duration = track.duration,
166
168
  artwork = track.artwork?.url,
167
169
  description = track.description,
168
- mediaId = track.src ?: track.url,
170
+ mediaId = track.src ?: track.path,
169
171
  genre = track.genre,
170
172
  )
171
173
  }
@@ -228,7 +230,7 @@ class NowPlayingUpdater(private val surface: NowPlayingSurface, private val scop
228
230
  // default on null/throw.
229
231
  val activeFormatter = if (enabled) formatter else null
230
232
  if (activeFormatter != null) {
231
- val capturedId = track.src ?: track.url
233
+ val capturedId = track.src ?: track.path
232
234
  // Gate the raw load-control signal to the buffering state so `stalled` is correct on its
233
235
  // own: ExoPlayer's rebuffering flag is polled on a different cadence than state transitions
234
236
  // and can linger true into the PLAYING transition as a rebuffer recovers. Classify by
@@ -267,7 +269,7 @@ class NowPlayingUpdater(private val surface: NowPlayingSurface, private val scop
267
269
  formatted != null &&
268
270
  current != null &&
269
271
  currentIdx != null &&
270
- (current.src ?: current.url) == capturedId &&
272
+ (current.src ?: current.path) == capturedId &&
271
273
  renderGeneration == generation
272
274
  ) {
273
275
  applyFields(
@@ -294,7 +296,7 @@ class NowPlayingUpdater(private val surface: NowPlayingSurface, private val scop
294
296
  // the same fields are recomputed often; an unconditional stamp would churn the MediaSession
295
297
  // (and flicker Android Auto / now-playing) for no visible change. Keyed on the track identity
296
298
  // so a new track with a coincidentally identical line still publishes.
297
- val published = Published(index, track.src ?: track.url, title, secondaryLine, album)
299
+ val published = Published(index, track.identity ?: track.path, title, secondaryLine, album)
298
300
  if (published == lastPublished) return
299
301
  lastPublished = published
300
302
 
@@ -308,28 +310,23 @@ class NowPlayingUpdater(private val surface: NowPlayingSurface, private val scop
308
310
 
309
311
  /**
310
312
  * Resolves the playing track's now-playing artwork and stamps it onto the playing media item.
311
- * Guarded exactly like iOS: only when `nowPlayingArtwork` is configured AND the track has a
312
- * non-empty id (so the `{id}` token never resolves to an empty string). Otherwise the existing
313
- * artworkUri — which came from `artwork` (browse list path) — is left in place.
313
+ * Runs for EVERY playing track when `nowPlayingArtwork` is configured — id or not, exactly like
314
+ * iOS (an id-less track leaves any `{id}` token unfilled; the resolver warns and the request
315
+ * visibly 404s). Without a config, the existing artworkUri — which came from `artwork` (browse
316
+ * list path) — is left in place.
314
317
  */
315
318
  private fun maybeResolveArtwork(track: Track) {
316
- val trackId =
317
- track.id?.takeIf { it.isNotEmpty() }
318
- ?: run {
319
- // No id → skip nowPlayingArtwork entirely; keep the existing (browse) artworkUri.
320
- artworkResolvedForTrackId = null
321
- return
322
- }
323
-
324
319
  if (!surface.hasNowPlayingArtworkConfig) {
325
320
  // No now-playing artwork config (or no browser) → fall back to the existing artworkUri.
326
- artworkResolvedForTrackId = null
321
+ artworkResolvedForTrack = null
327
322
  return
328
323
  }
329
324
 
330
- // Already resolved (or resolving) for this track id — avoid a redundant resolve per render.
331
- if (artworkResolvedForTrackId == trackId) return
332
- artworkResolvedForTrackId = trackId
325
+ // Already resolved (or resolving) for this track — avoid a redundant resolve per render.
326
+ // Keyed on track identity (id-or-src, falling back to path) so id-less tracks dedupe too.
327
+ val trackKey = track.identity ?: track.path
328
+ if (trackKey != null && artworkResolvedForTrack == trackKey) return
329
+ artworkResolvedForTrack = trackKey
333
330
 
334
331
  scope.launch {
335
332
  val uri =
@@ -337,10 +334,10 @@ class NowPlayingUpdater(private val surface: NowPlayingSurface, private val scop
337
334
  ?: return@launch
338
335
 
339
336
  // Apply only if still the same track (a fast skip must not be overwritten by a stale
340
- // result).
337
+ // result), compared on the same identity key the resolve was launched under.
341
338
  val currentIdx = surface.currentIndex ?: return@launch
342
339
  val current = surface.currentTrack ?: return@launch
343
- if (current.id != trackId) return@launch
340
+ if ((current.identity ?: current.path) != trackKey) return@launch
344
341
 
345
342
  surface.stampArtwork(currentIdx, current, uri)
346
343
  }
@@ -17,13 +17,21 @@ sealed interface PlaybackEvent {
17
17
  data class ExoPlaybackStateChanged(
18
18
  @get:MediaPlayer.State val exoState: Int,
19
19
  val mediaItemCount: Int,
20
- val playWhenReady: Boolean,
20
+ val shouldPlayWhenReady: Boolean,
21
21
  ) : PlaybackEvent
22
22
 
23
23
  /** The active media item changed (auto-advance, skip, queue swap). */
24
24
  data class MediaItemTransition(val hasTrack: Boolean, val isPlaying: Boolean) : PlaybackEvent
25
25
 
26
- data class PlayWhenReadyChanged(val playWhenReady: Boolean) : PlaybackEvent
26
+ /**
27
+ * An input of [Player.shouldPlayWhenReady] changed: the intent, or a playback suppression such as
28
+ * a transient audio focus loss, which moves the machine as a pause does. [exoState] is the real
29
+ * ExoPlayer state, as in [ExoPlaybackStateChanged].
30
+ */
31
+ data class ShouldPlayWhenReadyChanged(
32
+ val shouldPlayWhenReady: Boolean,
33
+ @get:MediaPlayer.State val exoState: Int,
34
+ ) : PlaybackEvent
27
35
 
28
36
  data class IsPlayingChanged(val isPlaying: Boolean) : PlaybackEvent
29
37
  }
@@ -42,12 +50,12 @@ object PlaybackStateMachine {
42
50
  when (event.exoState) {
43
51
  MediaPlayer.STATE_BUFFERING -> listOf(PlaybackState.BUFFERING)
44
52
  MediaPlayer.STATE_READY ->
45
- // While playing (playWhenReady), READY is a transient before PLAYING —
53
+ // While playing (shouldPlayWhenReady), READY is a transient before PLAYING —
46
54
  // suppress it so consumers don't flash a settled/non-loading state
47
55
  // mid-startup (none→loading→buffering→playing). When paused it IS the
48
56
  // settled signal a buffer-that-finished-while-paused needs, so consumers
49
57
  // can clear their loading spinner (mono#3325).
50
- if (event.playWhenReady) emptyList() else listOf(PlaybackState.READY)
58
+ if (event.shouldPlayWhenReady) emptyList() else listOf(PlaybackState.READY)
51
59
  MediaPlayer.STATE_IDLE ->
52
60
  // A terminal error (or an explicit stop) idles ExoPlayer; transitioning to NONE
53
61
  // would clear the ERROR/STOPPED state the session is rendering.
@@ -68,16 +76,20 @@ object PlaybackStateMachine {
68
76
  listOf(PlaybackState.LOADING, PlaybackState.READY, PlaybackState.PLAYING)
69
77
  else -> listOf(PlaybackState.LOADING)
70
78
  }
71
- is PlaybackEvent.PlayWhenReadyChanged ->
72
- // STOPPED and ENDED are terminal: dropping the intent there (stop()'s own
73
- // clear, the clear on natural end, or a redundant pause press) must not
74
- // re-report the state as PAUSED.
75
- if (
76
- !event.playWhenReady && current != PlaybackState.STOPPED && current != PlaybackState.ENDED
77
- ) {
78
- listOf(PlaybackState.PAUSED)
79
- } else {
80
- emptyList()
79
+ is PlaybackEvent.ShouldPlayWhenReadyChanged ->
80
+ when {
81
+ // STOPPED and ENDED are terminal: dropping the intent there (stop()'s own
82
+ // clear, the clear on natural end, or a redundant pause press) must not
83
+ // re-report the state as PAUSED.
84
+ !event.shouldPlayWhenReady &&
85
+ current != PlaybackState.STOPPED &&
86
+ current != PlaybackState.ENDED -> listOf(PlaybackState.PAUSED)
87
+ !event.shouldPlayWhenReady -> emptyList()
88
+ // Resuming while ExoPlayer still buffers (a pause or suppression that began during a
89
+ // load): READY will be dropped as the transient before PLAYING, so report the load now.
90
+ current == PlaybackState.PAUSED && event.exoState == MediaPlayer.STATE_BUFFERING ->
91
+ listOf(PlaybackState.BUFFERING)
92
+ else -> emptyList()
81
93
  }
82
94
  is PlaybackEvent.IsPlayingChanged ->
83
95
  if (event.isPlaying) listOf(PlaybackState.PLAYING) else emptyList()
@@ -1,13 +1,17 @@
1
1
  package com.audiobrowser.player
2
2
 
3
- import com.audiobrowser.util.artworkOf
4
-
5
- import com.audiobrowser.util.url
6
-
7
3
  import android.content.Context
8
4
  import android.content.SharedPreferences
9
5
  import androidx.core.content.edit
10
6
  import androidx.media3.common.C
7
+ import com.audiobrowser.util.EMPTY_TRACK_STYLE
8
+ import com.audiobrowser.util.artworkOf
9
+ import com.audiobrowser.util.toArtworkRendering
10
+ import com.audiobrowser.util.toCardImage
11
+ import com.audiobrowser.util.toImageShape
12
+ import com.audiobrowser.util.toStyleDisplay
13
+ import com.audiobrowser.util.toWireString
14
+ import com.audiobrowser.util.url
11
15
  import com.margelo.nitro.audiobrowser.PlaybackState
12
16
  import com.margelo.nitro.audiobrowser.RepeatMode
13
17
  import com.margelo.nitro.audiobrowser.Track
@@ -20,12 +24,12 @@ import org.json.JSONObject
20
24
  import timber.log.Timber
21
25
 
22
26
  /**
23
- * Persists playback state for resumption after app restart. Stores the current track URL, position,
24
- * and player settings to enable playback resumption via MediaButtonReceiver (Bluetooth play button,
25
- * etc.).
27
+ * Persists playback state for resumption after app restart. Stores the current track (including its
28
+ * path), position, and player settings to enable playback resumption via MediaButtonReceiver
29
+ * (Bluetooth play button, etc.).
26
30
  *
27
31
  * Settings (repeatMode, shuffleEnabled, playbackSpeed) are auto-persisted when set via properties.
28
- * Position/URL are persisted via save() on pause or track change.
32
+ * Position/track are persisted via save() on pause or track change.
29
33
  */
30
34
  class PlaybackStateStore(private val player: Player) {
31
35
  private val prefs: SharedPreferences =
@@ -34,7 +38,7 @@ class PlaybackStateStore(private val player: Player) {
34
38
  /**
35
39
  * Persisted playback state for resumption.
36
40
  *
37
- * @param track The track being played (includes url for queue expansion)
41
+ * @param track The track being played (includes path for queue expansion)
38
42
  * @param positionMs The playback position in milliseconds (C.TIME_UNSET for default/live edge)
39
43
  * @param repeatMode The repeat mode setting
40
44
  * @param shuffleEnabled Whether shuffle mode was enabled
@@ -150,78 +154,11 @@ class PlaybackStateStore(private val player: Player) {
150
154
  Timber.d("Saved position: positionMs=0 (queue ended)")
151
155
  }
152
156
 
153
- private fun trackToJson(track: Track): String =
154
- JSONObject()
155
- .apply {
156
- put("id", track.id)
157
- put("url", track.url)
158
- put("src", track.src)
159
- put("title", track.title)
160
- put("subtitle", track.subtitle)
161
- put("artist", track.artist)
162
- put("albumUrl", track.albumUrl)
163
- put("album", track.album)
164
- put("artwork", track.artwork?.url)
165
- put("description", track.description)
166
- put("genre", track.genre)
167
- put("duration", track.duration)
168
- put("style", track.style?.name)
169
- put("childrenStyle", track.childrenStyle?.name)
170
- put("favorited", track.favorited)
171
- put("groupTitle", track.groupTitle)
172
- put("live", track.live)
173
- }
174
- .toString()
175
-
176
- private fun trackFromJson(json: String): Track? =
177
- runCatching {
178
- val obj = JSONObject(json)
179
- Track(
180
- id = obj.optString("id").takeIf { it.isNotEmpty() },
181
- url = obj.optString("url").takeIf { it.isNotEmpty() },
182
- src = obj.optString("src").takeIf { it.isNotEmpty() },
183
- title = obj.getString("title"),
184
- subtitle = obj.optString("subtitle").takeIf { it.isNotEmpty() },
185
- artist = obj.optString("artist").takeIf { it.isNotEmpty() },
186
- albumUrl = obj.optString("albumUrl").takeIf { it.isNotEmpty() },
187
- album = obj.optString("album").takeIf { it.isNotEmpty() },
188
- artwork = artworkOf(obj.optString("artwork").takeIf { it.isNotEmpty() }),
189
- artworkSource = null, // Not persisted - will be re-transformed on browse
190
- artworkCarPlayTinted = null, // iOS-only, not persisted
191
- description = obj.optString("description").takeIf { it.isNotEmpty() },
192
- genre = obj.optString("genre").takeIf { it.isNotEmpty() },
193
- duration =
194
- if (obj.has("duration") && !obj.isNull("duration")) obj.getDouble("duration") else null,
195
- style =
196
- obj
197
- .optString("style")
198
- .takeIf { it.isNotEmpty() }
199
- ?.let { runCatching { TrackStyle.valueOf(it) }.getOrNull() },
200
- childrenStyle =
201
- obj
202
- .optString("childrenStyle")
203
- .takeIf { it.isNotEmpty() }
204
- ?.let { runCatching { TrackStyle.valueOf(it) }.getOrNull() },
205
- favorited =
206
- if (obj.has("favorited") && !obj.isNull("favorited")) obj.getBoolean("favorited")
207
- else null,
208
- groupTitle = obj.optString("groupTitle").takeIf { it.isNotEmpty() },
209
- live = if (obj.has("live") && !obj.isNull("live")) obj.getBoolean("live") else null,
210
- // Not persisted: on resumption the contextual URL is re-browsed
211
- // (expandQueueFromContextualUrl), which re-parses each track's request
212
- // from the API's current response and re-caches it.
213
- request = null,
214
- imageRow = null, // Not persisted
215
- )
216
- }
217
- .onFailure { e -> Timber.w(e, "Failed to parse persisted track JSON") }
218
- .getOrNull()
219
-
220
157
  /**
221
158
  * Restores player settings from persisted state and returns the state for queue setup.
222
159
  *
223
160
  * Applies repeatMode, shuffleMode, and playbackSpeed to the player. The caller is responsible for
224
- * using the returned url and positionMs to set up the playback queue.
161
+ * using the returned path and positionMs to set up the playback queue.
225
162
  *
226
163
  * @return PersistedState if available, null otherwise
227
164
  */
@@ -230,7 +167,11 @@ class PlaybackStateStore(private val player: Player) {
230
167
  // Apply player settings from persisted state
231
168
  player.repeatMode = state.repeatMode
232
169
  player.shuffleMode = state.shuffleEnabled
233
- player.playbackSpeed = state.playbackSpeed
170
+ // Guarded because this input is untrusted: ExoPlayer's setPlaybackSpeed rejects a
171
+ // non-positive speed with IllegalArgumentException, and a snapshot holding one (a
172
+ // corrupted prefs file — the normal write path can't produce it) would then throw on
173
+ // every resume, permanently, since the bad value stays persisted.
174
+ if (state.playbackSpeed > 0f) player.playbackSpeed = state.playbackSpeed
234
175
 
235
176
  Timber.d(
236
177
  "Restored player settings: repeatMode=${state.repeatMode}, shuffle=${state.shuffleEnabled}, speed=${state.playbackSpeed}"
@@ -257,6 +198,100 @@ class PlaybackStateStore(private val player: Player) {
257
198
  }
258
199
 
259
200
  companion object {
201
+ // Internal (not private) so the round-trip is testable without a Player.
202
+ internal fun trackToJson(track: Track): String =
203
+ JSONObject()
204
+ .apply {
205
+ put("id", track.id)
206
+ put("path", track.path)
207
+ put("src", track.src)
208
+ put("title", track.title)
209
+ put("subtitle", track.subtitle)
210
+ put("artist", track.artist)
211
+ put("albumPath", track.albumPath)
212
+ put("album", track.album)
213
+ put("artwork", track.artwork?.url)
214
+ put("description", track.description)
215
+ put("genre", track.genre)
216
+ put("duration", track.duration)
217
+ // The style block persists as its wire shape (nested object, wire
218
+ // strings) and `disabled` beside it: a restored queue keeps its
219
+ // visible fidelity across process death (ADR 0011).
220
+ put(
221
+ "style",
222
+ track.style?.let { style ->
223
+ JSONObject().apply {
224
+ put("display", style.display?.toWireString())
225
+ put("artworkRendering", style.artworkRendering?.toWireString())
226
+ put("imageShape", style.imageShape?.toWireString())
227
+ put("accessorySymbol", style.accessorySymbol)
228
+ put("cardTint", style.cardTint)
229
+ put("cardImage", style.cardImage?.toWireString())
230
+ }
231
+ },
232
+ )
233
+ put("disabled", track.disabled)
234
+ put("favorited", track.favorited)
235
+ put("live", track.live)
236
+ put("icyCharset", track.icyCharset)
237
+ }
238
+ .toString()
239
+
240
+ internal fun trackFromJson(json: String): Track? =
241
+ runCatching {
242
+ val obj = JSONObject(json)
243
+ Track(
244
+ id = obj.optString("id").takeIf { it.isNotEmpty() },
245
+ path = obj.optString("path").takeIf { it.isNotEmpty() },
246
+ src = obj.optString("src").takeIf { it.isNotEmpty() },
247
+ title = obj.getString("title"),
248
+ subtitle = obj.optString("subtitle").takeIf { it.isNotEmpty() },
249
+ artist = obj.optString("artist").takeIf { it.isNotEmpty() },
250
+ albumPath = obj.optString("albumPath").takeIf { it.isNotEmpty() },
251
+ album = obj.optString("album").takeIf { it.isNotEmpty() },
252
+ artwork = artworkOf(obj.optString("artwork").takeIf { it.isNotEmpty() }),
253
+ artworkSource = null, // Not persisted - will be re-transformed on browse
254
+ description = obj.optString("description").takeIf { it.isNotEmpty() },
255
+ genre = obj.optString("genre").takeIf { it.isNotEmpty() },
256
+ duration =
257
+ if (obj.has("duration") && !obj.isNull("duration")) obj.getDouble("duration")
258
+ else null,
259
+ // Tolerant (ADR 0011): a snapshot written before the block model —
260
+ // `style` as an enum-name string — is not an object, so optJSONObject
261
+ // yields null and the track restores without a declaration.
262
+ style =
263
+ obj
264
+ .optJSONObject("style")
265
+ ?.let { style ->
266
+ TrackStyle(
267
+ display = style.optString("display").toStyleDisplay(),
268
+ artworkRendering = style.optString("artworkRendering").toArtworkRendering(),
269
+ imageShape = style.optString("imageShape").toImageShape(),
270
+ accessorySymbol = style.optString("accessorySymbol").takeIf { it.isNotEmpty() },
271
+ cardTint = style.optString("cardTint").takeIf { it.isNotEmpty() },
272
+ cardImage = style.optString("cardImage").toCardImage(),
273
+ )
274
+ }
275
+ // An empty block collapses to "no declaration" — one shape on
276
+ // every platform, matching the browse decoders.
277
+ ?.takeIf { it != EMPTY_TRACK_STYLE },
278
+ disabled =
279
+ if (obj.has("disabled") && !obj.isNull("disabled")) obj.getBoolean("disabled")
280
+ else null,
281
+ favorited =
282
+ if (obj.has("favorited") && !obj.isNull("favorited")) obj.getBoolean("favorited")
283
+ else null,
284
+ live = if (obj.has("live") && !obj.isNull("live")) obj.getBoolean("live") else null,
285
+ icyCharset = obj.optString("icyCharset").takeIf { it.isNotEmpty() },
286
+ // Not persisted: on resumption the contextual path is re-browsed
287
+ // (expandQueueFromContextualPath), which re-parses each track's request
288
+ // from the API's current response and re-caches it.
289
+ request = null,
290
+ )
291
+ }
292
+ .onFailure { e -> Timber.w(e, "Failed to parse persisted track JSON") }
293
+ .getOrNull()
294
+
260
295
  private const val PREFS_NAME = "audio_browser_playback_state_v3"
261
296
  private const val KEY_POSITION_MS = "position_ms"
262
297
  private const val KEY_REPEAT_MODE = "repeat_mode"