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

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 (1092) hide show
  1. package/README.md +37 -23
  2. package/android/build.gradle +58 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +215 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +546 -283
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +38 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +18 -2
  9. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +131 -0
  10. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +165 -0
  11. package/android/src/main/java/com/audiobrowser/Service.kt +41 -11
  12. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  13. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +23 -10
  14. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  15. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  16. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  17. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  18. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  19. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  20. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  21. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  22. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  23. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  24. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  25. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  26. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  27. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +16 -0
  28. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +1 -1
  29. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  30. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  31. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +4 -1
  32. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  33. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  34. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +639 -278
  35. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +85 -33
  36. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +88 -44
  37. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  38. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  39. package/android/src/main/java/com/audiobrowser/player/Player.kt +333 -186
  40. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  41. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  42. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +33 -16
  43. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  44. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  45. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +10 -13
  46. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +64 -0
  47. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +98 -0
  48. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  49. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +110 -0
  50. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +696 -0
  51. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +113 -0
  52. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  53. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  54. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +92 -0
  55. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +105 -0
  56. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  57. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  58. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +550 -0
  59. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +99 -0
  60. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +201 -0
  61. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  62. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +66 -0
  63. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  64. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +63 -0
  65. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +63 -0
  66. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +68 -0
  67. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  68. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  69. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  70. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  71. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  72. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  73. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  74. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +15 -0
  75. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +61 -40
  76. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  77. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +5 -1
  78. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +24 -49
  79. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +23 -1
  80. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  81. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +2 -2
  82. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  83. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +103 -67
  84. package/android/src/main/res/values/strings.xml +25 -5
  85. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +18 -0
  86. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  87. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  88. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  89. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  90. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +159 -0
  91. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  92. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  93. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  94. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  95. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  96. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  97. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  98. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  99. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  100. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  101. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  102. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  103. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  104. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  105. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +477 -0
  106. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +1 -2
  107. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  108. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -0
  109. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  110. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +138 -0
  111. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  112. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +212 -2
  113. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  114. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  115. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  116. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +136 -0
  117. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +67 -0
  118. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  119. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +213 -0
  120. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +192 -0
  121. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  122. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  123. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +151 -0
  124. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +275 -0
  125. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  126. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  127. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  128. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +815 -0
  129. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +203 -0
  130. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +90 -0
  131. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +73 -0
  132. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +135 -0
  133. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +170 -0
  134. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +174 -0
  135. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +691 -0
  136. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  137. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +165 -0
  138. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  139. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +204 -0
  140. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +99 -0
  141. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  142. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  143. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  144. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  145. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  146. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  147. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  148. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  149. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  150. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  151. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  152. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  153. package/android/src/test/resources/sonos/device_description.xml +78 -0
  154. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  155. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +79 -0
  156. package/ios/AVPlayerEngine.swift +362 -0
  157. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  158. package/ios/Browser/BrowseGate.swift +58 -0
  159. package/ios/Browser/BrowserConfig.swift +115 -81
  160. package/ios/Browser/BrowserError.swift +16 -0
  161. package/ios/Browser/BrowserManager.swift +155 -654
  162. package/ios/Browser/BrowserPathHelper.swift +68 -51
  163. package/ios/Browser/FavoriteSet.swift +46 -0
  164. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  165. package/ios/Browser/JsonModels.swift +270 -321
  166. package/ios/Browser/NavigationErrorState.swift +41 -0
  167. package/ios/Browser/PageResolver.swift +147 -0
  168. package/ios/Browser/RequestLayer.swift +185 -0
  169. package/ios/Browser/RequestPipeline.swift +303 -0
  170. package/ios/Browser/SearchDrillIn.swift +7 -7
  171. package/ios/Browser/SectionScope.swift +82 -23
  172. package/ios/Browser/SimpleRouter.swift +73 -144
  173. package/ios/Browser/StyleResolver.swift +58 -0
  174. package/ios/Browser/TabBarEntries.swift +9 -3
  175. package/ios/Browser/TrackIdTemplate.swift +37 -0
  176. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  177. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  178. package/ios/CarPlay/CarPlayController.swift +37 -1297
  179. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  180. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  181. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  182. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  183. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  184. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  185. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  186. package/ios/CarPlay/CarPlaySession.swift +207 -0
  187. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  188. package/ios/CarPlay/IntentHandlers.swift +96 -0
  189. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  190. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  191. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  192. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  193. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  194. package/ios/CarPlay/SectionPresentation.swift +77 -0
  195. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  196. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  197. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  198. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  199. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  200. package/ios/Extension/SearchParams+Query.swift +28 -0
  201. package/ios/Extension/Section+Copying.swift +29 -0
  202. package/ios/Extension/String+IcyCharset.swift +21 -0
  203. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  204. package/ios/Extension/Track+AVPlayer.swift +0 -16
  205. package/ios/Extension/Track+Copying.swift +11 -13
  206. package/ios/Extension/Track+Identity.swift +25 -0
  207. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  208. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  209. package/ios/Extension/URLError+Connectivity.swift +15 -0
  210. package/ios/Http/HttpClient.swift +71 -165
  211. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  212. package/ios/HybridAudioBrowser+Options.swift +105 -0
  213. package/ios/HybridAudioBrowser+Player.swift +341 -0
  214. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  215. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  216. package/ios/HybridAudioBrowser.swift +131 -1652
  217. package/ios/Model/NitroTypeStubs.swift +239 -24
  218. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  219. package/ios/Model/RemoteCommand.swift +6 -60
  220. package/ios/Model/TrackPlayerError.swift +6 -2
  221. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  222. package/ios/Observer/ItemObserver.swift +90 -0
  223. package/ios/Observer/PlayerObserver.swift +59 -0
  224. package/ios/Option/SessionCategories.swift +42 -92
  225. package/ios/Player/AudioSessionController.swift +191 -0
  226. package/ios/Player/DeferredSeek.swift +70 -0
  227. package/ios/Player/ErrorStatus.swift +50 -0
  228. package/ios/Player/MediaLoader.swift +66 -87
  229. package/ios/Player/NowPlayingLines.swift +52 -0
  230. package/ios/Player/NowPlayingUpdater.swift +182 -85
  231. package/ios/Player/PlaybackFailure.swift +125 -0
  232. package/ios/Player/PlaybackPersistence.swift +73 -0
  233. package/ios/Player/PlaybackTimer.swift +8 -2
  234. package/ios/Player/Player.swift +975 -0
  235. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  236. package/ios/Player/PlayerEngine.swift +104 -0
  237. package/ios/Player/PlayerStatusTypes.swift +2 -6
  238. package/ios/Player/QueueManager.swift +93 -67
  239. package/ios/Player/RetryLoop.swift +291 -0
  240. package/ios/Player/ShuffleOrder.swift +33 -0
  241. package/ios/Player/SleepTimerManager.swift +14 -16
  242. package/ios/Player/VolumeFader.swift +5 -0
  243. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  244. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  245. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  246. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  247. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  248. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  249. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  250. package/ios/Tests/DeferredSeekTests.swift +70 -0
  251. package/ios/Tests/EmitterTests.swift +22 -38
  252. package/ios/Tests/ErrorStatusTests.swift +50 -0
  253. package/ios/Tests/FavoriteSetTests.swift +60 -0
  254. package/ios/Tests/GenerationMemoTests.swift +121 -0
  255. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  256. package/ios/Tests/JsonModelsTests.swift +194 -1
  257. package/ios/Tests/LRUCacheTests.swift +110 -0
  258. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  259. package/ios/Tests/MediaLoaderTests.swift +36 -67
  260. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  261. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  262. package/ios/Tests/ObserverTests.swift +88 -0
  263. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  264. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  265. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  266. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  267. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  268. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +573 -395
  269. package/ios/Tests/PlayingStateTests.swift +42 -0
  270. package/ios/Tests/QueueManagerTests.swift +196 -115
  271. package/ios/Tests/ReadyValueTests.swift +73 -0
  272. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  273. package/ios/Tests/RequestLayerTests.swift +228 -0
  274. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  275. package/ios/Tests/RetryLoopTests.swift +305 -0
  276. package/ios/Tests/SearchDrillInTests.swift +16 -16
  277. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  278. package/ios/Tests/SectionPresentationTests.swift +98 -0
  279. package/ios/Tests/SectionScopeTests.swift +139 -54
  280. package/ios/Tests/SimpleRouterTests.swift +38 -3
  281. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  282. package/ios/Tests/StyleResolverTests.swift +132 -0
  283. package/ios/Tests/Support/TestTypes.swift +146 -101
  284. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  285. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  286. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  287. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  288. package/ios/Tests/TrackIdentityTests.swift +20 -0
  289. package/ios/Tests/TrackSelectorTests.swift +168 -33
  290. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  291. package/ios/TrackSelector.swift +62 -65
  292. package/ios/Util/ArtworkFreshness.swift +42 -0
  293. package/ios/Util/ArtworkImageFetcher.swift +143 -5
  294. package/ios/Util/ConcurrentMap.swift +19 -0
  295. package/ios/Util/Emitter.swift +40 -12
  296. package/ios/Util/GenerationMemo.swift +36 -0
  297. package/ios/Util/LRUCache.swift +23 -159
  298. package/ios/Util/NetworkMonitor.swift +32 -32
  299. package/ios/Util/OutputPicker.swift +48 -0
  300. package/ios/Util/ReadyValue.swift +56 -0
  301. package/ios/Util/SFSymbolRenderer.swift +59 -31
  302. package/ios/Util/SVGProcessor.swift +9 -12
  303. package/lib/commonjs/AudioBrowser.js +8 -8
  304. package/lib/commonjs/AudioBrowser.js.map +1 -1
  305. package/lib/commonjs/CLAUDE.md +52 -0
  306. package/lib/commonjs/features/browser-config.js +12 -8
  307. package/lib/commonjs/features/browser-config.js.map +1 -1
  308. package/lib/commonjs/features/browser.js +11 -3
  309. package/lib/commonjs/features/browser.js.map +1 -1
  310. package/lib/commonjs/features/carConnection.js +1 -1
  311. package/lib/commonjs/features/equalizer.js +1 -1
  312. package/lib/commonjs/features/errors.js +3 -3
  313. package/lib/commonjs/features/favorites.js +14 -11
  314. package/lib/commonjs/features/favorites.js.map +1 -1
  315. package/lib/commonjs/features/gate.js +16 -1
  316. package/lib/commonjs/features/gate.js.map +1 -1
  317. package/lib/commonjs/features/metadata.js +20 -3
  318. package/lib/commonjs/features/metadata.js.map +1 -1
  319. package/lib/commonjs/features/network.js +1 -1
  320. package/lib/commonjs/features/nowPlaying.js +1 -1
  321. package/lib/commonjs/features/output.js +4 -3
  322. package/lib/commonjs/features/output.js.map +1 -1
  323. package/lib/commonjs/features/playback/controls.js +4 -2
  324. package/lib/commonjs/features/playback/controls.js.map +1 -1
  325. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  326. package/lib/commonjs/features/playback/playing.js +1 -1
  327. package/lib/commonjs/features/playback/progress.js +3 -2
  328. package/lib/commonjs/features/playback/progress.js.map +1 -1
  329. package/lib/commonjs/features/playback/rate.js +8 -1
  330. package/lib/commonjs/features/playback/rate.js.map +1 -1
  331. package/lib/commonjs/features/playback/state.js +3 -4
  332. package/lib/commonjs/features/playback/state.js.map +1 -1
  333. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  334. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  335. package/lib/commonjs/features/playback/volume.js +1 -1
  336. package/lib/commonjs/features/player/options.js +3 -19
  337. package/lib/commonjs/features/player/options.js.map +1 -1
  338. package/lib/commonjs/features/player/setup.js +7 -3
  339. package/lib/commonjs/features/player/setup.js.map +1 -1
  340. package/lib/commonjs/features/player/validateOptions.js +23 -0
  341. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  342. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  343. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  344. package/lib/commonjs/features/queue/queue.js +13 -6
  345. package/lib/commonjs/features/queue/queue.js.map +1 -1
  346. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  347. package/lib/commonjs/features/queue/shuffle.js +1 -1
  348. package/lib/commonjs/features/remoteControls.js +13 -92
  349. package/lib/commonjs/features/remoteControls.js.map +1 -1
  350. package/lib/commonjs/features/sleepTimer.js +13 -1
  351. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  352. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  353. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  354. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  355. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  356. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  357. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  358. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  359. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  360. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  361. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  362. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  363. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  364. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  365. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  366. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  367. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  368. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  369. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  370. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  371. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  372. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  373. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  374. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  375. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  376. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  377. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  378. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  379. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  380. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  381. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  382. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  383. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  384. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  385. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  386. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  387. package/lib/commonjs/web/browser/sections.js +89 -0
  388. package/lib/commonjs/web/browser/sections.js.map +1 -0
  389. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  390. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  391. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  392. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  393. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  394. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  395. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  396. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  397. package/lib/module/AudioBrowser.js +2 -1
  398. package/lib/module/AudioBrowser.js.map +1 -1
  399. package/lib/module/CLAUDE.md +52 -0
  400. package/lib/module/features/browser-config.js +12 -8
  401. package/lib/module/features/browser-config.js.map +1 -1
  402. package/lib/module/features/browser.js +11 -3
  403. package/lib/module/features/browser.js.map +1 -1
  404. package/lib/module/features/carConnection.js +1 -1
  405. package/lib/module/features/equalizer.js +1 -1
  406. package/lib/module/features/errors.js +3 -3
  407. package/lib/module/features/favorites.js +14 -11
  408. package/lib/module/features/favorites.js.map +1 -1
  409. package/lib/module/features/gate.js +16 -1
  410. package/lib/module/features/gate.js.map +1 -1
  411. package/lib/module/features/metadata.js +20 -3
  412. package/lib/module/features/metadata.js.map +1 -1
  413. package/lib/module/features/network.js +1 -1
  414. package/lib/module/features/nowPlaying.js +1 -1
  415. package/lib/module/features/output.js +4 -3
  416. package/lib/module/features/output.js.map +1 -1
  417. package/lib/module/features/playback/controls.js +4 -2
  418. package/lib/module/features/playback/controls.js.map +1 -1
  419. package/lib/module/features/playback/playWhenReady.js +1 -1
  420. package/lib/module/features/playback/playing.js +1 -1
  421. package/lib/module/features/playback/progress.js +3 -2
  422. package/lib/module/features/playback/progress.js.map +1 -1
  423. package/lib/module/features/playback/rate.js +8 -1
  424. package/lib/module/features/playback/rate.js.map +1 -1
  425. package/lib/module/features/playback/state.js +3 -4
  426. package/lib/module/features/playback/state.js.map +1 -1
  427. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  428. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  429. package/lib/module/features/playback/volume.js +1 -1
  430. package/lib/module/features/player/options.js +2 -17
  431. package/lib/module/features/player/options.js.map +1 -1
  432. package/lib/module/features/player/setup.js +6 -2
  433. package/lib/module/features/player/setup.js.map +1 -1
  434. package/lib/module/features/player/validateOptions.js +19 -0
  435. package/lib/module/features/player/validateOptions.js.map +1 -0
  436. package/lib/module/features/queue/activeTrack.js +15 -4
  437. package/lib/module/features/queue/activeTrack.js.map +1 -1
  438. package/lib/module/features/queue/queue.js +13 -6
  439. package/lib/module/features/queue/queue.js.map +1 -1
  440. package/lib/module/features/queue/repeatMode.js +1 -1
  441. package/lib/module/features/queue/shuffle.js +1 -1
  442. package/lib/module/features/remoteControls.js +13 -92
  443. package/lib/module/features/remoteControls.js.map +1 -1
  444. package/lib/module/features/sleepTimer.js +13 -1
  445. package/lib/module/features/sleepTimer.js.map +1 -1
  446. package/lib/module/test-utils/reactNativeStub.js +58 -0
  447. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  448. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  449. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  450. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  451. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  452. package/lib/module/utils/getTrackIdentity.js +20 -0
  453. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  454. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  455. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  456. package/lib/module/web/NativeAudioBrowser.js +202 -77
  457. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  458. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  459. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  460. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  461. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  462. package/lib/module/web/TrackPlayer/Player.js +254 -39
  463. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  464. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  465. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  466. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  467. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  468. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  469. package/lib/module/web/browser/BrowserManager.js +175 -100
  470. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  471. package/lib/module/web/browser/FavoriteManager.js +31 -21
  472. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  473. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  474. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  475. package/lib/module/web/browser/SearchManager.js +18 -23
  476. package/lib/module/web/browser/SearchManager.js.map +1 -1
  477. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  478. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  479. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  480. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  481. package/lib/module/web/browser/sections.js +83 -0
  482. package/lib/module/web/browser/sections.js.map +1 -0
  483. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  484. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  485. package/lib/module/web/http/followMediaRedirect.js +215 -0
  486. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  487. package/lib/module/web/player/NowPlayingManager.js +4 -3
  488. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  489. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  490. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  491. package/lib/typescript/package.json +1 -0
  492. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  493. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  494. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  495. package/lib/typescript/src/features/browser.d.ts +10 -2
  496. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  497. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  498. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  499. package/lib/typescript/src/features/errors.d.ts +3 -3
  500. package/lib/typescript/src/features/favorites.d.ts +14 -11
  501. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  502. package/lib/typescript/src/features/gate.d.ts +18 -2
  503. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  504. package/lib/typescript/src/features/metadata.d.ts +20 -3
  505. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  506. package/lib/typescript/src/features/network.d.ts +1 -1
  507. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  508. package/lib/typescript/src/features/output.d.ts +4 -3
  509. package/lib/typescript/src/features/output.d.ts.map +1 -1
  510. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  511. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  512. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  513. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  514. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  515. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  516. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  517. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  518. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  519. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  520. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  521. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  522. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  523. package/lib/typescript/src/features/player/options.d.ts +24 -21
  524. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  525. package/lib/typescript/src/features/player/setup.d.ts +46 -1
  526. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  527. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  528. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  529. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  530. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  531. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  532. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  533. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  534. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  535. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  536. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  537. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  538. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  539. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  540. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  541. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  542. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  543. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  544. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  545. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  546. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  547. package/lib/typescript/src/types/browser.d.ts +93 -61
  548. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  549. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  550. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  551. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  552. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  553. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  554. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  555. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  556. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  557. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  558. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  559. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  560. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  561. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  564. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  565. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  566. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  567. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  568. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  572. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  573. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  574. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  575. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  576. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  577. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  578. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  579. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  581. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  582. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  583. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  584. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  585. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  586. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  587. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  588. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  589. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  590. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  591. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  592. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  593. 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
  594. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  595. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  596. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  597. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  598. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  599. 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
  600. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  602. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  605. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  607. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  608. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  609. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  610. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  611. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  612. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  613. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  616. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  619. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  621. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  622. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  623. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  625. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  626. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  627. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  628. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  630. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  631. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  632. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  633. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  634. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  635. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  637. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  638. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  639. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  640. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +72 -44
  641. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  642. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  643. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  644. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  645. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  646. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  647. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  648. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  649. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  650. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  651. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  652. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  653. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  654. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  655. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  656. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  657. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  658. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  659. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  660. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  661. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  662. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  663. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  664. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  665. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  666. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  667. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  668. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  669. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  670. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  671. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  672. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  673. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  674. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  675. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  676. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  677. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  678. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  679. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  680. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  681. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  682. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  683. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  684. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  686. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  687. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  689. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  690. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  691. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  692. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  694. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  695. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  696. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  697. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  698. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  699. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  700. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  701. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  702. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  703. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  704. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  705. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  707. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  709. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  710. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  711. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  712. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  713. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  715. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  716. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  717. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  718. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  719. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  739. 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
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  746. 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
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  749. 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
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  752. 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
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  782. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  783. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  784. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  785. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  786. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  787. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  788. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  789. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  790. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  791. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  792. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  793. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  794. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  795. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  796. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  797. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  798. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  799. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  800. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  801. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  802. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  803. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  804. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  805. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  806. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  807. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  808. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  809. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  810. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  811. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  812. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  813. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  814. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  815. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  816. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  817. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  818. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  819. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  820. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  821. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  822. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  823. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  824. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  825. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  826. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  827. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  828. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  829. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  830. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  831. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  832. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  833. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  834. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  835. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  836. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  837. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  838. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  839. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  840. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  841. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  842. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  852. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  858. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  859. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  860. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +788 -641
  861. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  862. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +33 -12
  863. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  864. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  865. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  866. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  867. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  868. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  869. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  870. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  871. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  872. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  873. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  874. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  875. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  876. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  877. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  878. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  879. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  880. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  881. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  882. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  883. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  884. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  885. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  886. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  887. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  888. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  889. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  890. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  891. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  892. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  893. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  894. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  895. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  896. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  897. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  898. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  899. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  900. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  901. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  902. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  903. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  904. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  905. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  906. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  907. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  908. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  909. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  910. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  911. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  912. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  913. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  914. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  915. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  916. package/package.json +24 -11
  917. package/src/AudioBrowser.ts +2 -1
  918. package/src/CLAUDE.md +52 -0
  919. package/src/features/battery.test.ts +79 -0
  920. package/src/features/browser-config.test.ts +21 -6
  921. package/src/features/browser-config.ts +12 -8
  922. package/src/features/browser.test.ts +1 -1
  923. package/src/features/browser.ts +11 -3
  924. package/src/features/carConnection.ts +1 -1
  925. package/src/features/equalizer.ts +1 -1
  926. package/src/features/errors.ts +3 -3
  927. package/src/features/favorites.ts +14 -11
  928. package/src/features/gate.ts +16 -1
  929. package/src/features/hook-wiring.test.ts +302 -0
  930. package/src/features/metadata.ts +20 -3
  931. package/src/features/network.ts +1 -1
  932. package/src/features/nowPlaying.ts +1 -1
  933. package/src/features/output.ts +4 -3
  934. package/src/features/playback/controls.ts +4 -2
  935. package/src/features/playback/playWhenReady.ts +1 -1
  936. package/src/features/playback/playing.ts +1 -1
  937. package/src/features/playback/progress.test.ts +169 -0
  938. package/src/features/playback/progress.ts +3 -2
  939. package/src/features/playback/rate.ts +8 -1
  940. package/src/features/playback/state.ts +3 -4
  941. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  942. package/src/features/playback/trackPlaybackTime.ts +1 -6
  943. package/src/features/playback/volume.ts +1 -1
  944. package/src/features/player/options.ts +31 -40
  945. package/src/features/player/setup.test.ts +12 -3
  946. package/src/features/player/setup.ts +58 -5
  947. package/src/features/player/validateOptions.ts +21 -0
  948. package/src/features/queue/activeTrack.ts +15 -4
  949. package/src/features/queue/queue.ts +13 -6
  950. package/src/features/queue/repeatMode.ts +1 -1
  951. package/src/features/queue/shuffle.ts +1 -1
  952. package/src/features/remoteControls.ts +13 -92
  953. package/src/features/sleepTimer.test.ts +172 -0
  954. package/src/features/sleepTimer.ts +9 -1
  955. package/src/nitro-stub-drift.test.ts +277 -0
  956. package/src/public-surface.test.ts +147 -0
  957. package/src/specs/audio-browser.nitro.ts +10 -8
  958. package/src/style-resolution.test.ts +210 -0
  959. package/src/test-utils/reactNativeStub.ts +60 -0
  960. package/src/types/browser-native.ts +7 -3
  961. package/src/types/browser-nodes.ts +403 -134
  962. package/src/types/browser.ts +97 -63
  963. package/src/utils/LazyNativeEmitter.ts +28 -15
  964. package/src/utils/NativeUpdatedValue.ts +29 -13
  965. package/src/utils/getTrackIdentity.ts +20 -0
  966. package/src/utils/useDebug.test.ts +182 -0
  967. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  968. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  969. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  970. package/src/web/NativeAudioBrowser.ts +241 -84
  971. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  972. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  973. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  974. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  975. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  976. package/src/web/TrackPlayer/Player.ts +284 -37
  977. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  978. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  979. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  980. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  981. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  982. package/src/web/__tests__/lifecycle.test.ts +345 -0
  983. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  984. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  985. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  986. package/src/web/__tests__/retry.test.ts +169 -0
  987. package/src/web/browser/BrowserManager.ts +209 -111
  988. package/src/web/browser/FavoriteManager.test.ts +84 -0
  989. package/src/web/browser/FavoriteManager.ts +28 -23
  990. package/src/web/browser/NavigationErrorManager.ts +3 -1
  991. package/src/web/browser/SearchManager.test.ts +75 -0
  992. package/src/web/browser/SearchManager.ts +25 -28
  993. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  994. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  995. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  996. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  997. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  998. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  999. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1000. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1001. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1002. package/src/web/browser/sections.test.ts +91 -0
  1003. package/src/web/browser/sections.ts +72 -0
  1004. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1005. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1006. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1007. package/src/web/http/followMediaRedirect.ts +253 -0
  1008. package/src/web/player/NowPlayingManager.ts +4 -3
  1009. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1010. package/src/web/util/BrowserPathHelper.ts +70 -13
  1011. package/website/guide/android-auto.md +114 -0
  1012. package/website/guide/android-certificates.md +409 -0
  1013. package/website/guide/artwork.md +255 -0
  1014. package/website/guide/audio-output.md +339 -0
  1015. package/website/guide/automotive.md +86 -0
  1016. package/website/guide/basic-usage.md +151 -0
  1017. package/website/guide/battery.md +115 -0
  1018. package/website/guide/browser.md +587 -0
  1019. package/website/guide/carplay.md +650 -0
  1020. package/website/guide/configuration.md +179 -0
  1021. package/website/guide/equalizer.md +231 -0
  1022. package/website/guide/errors.md +310 -0
  1023. package/website/guide/favorites.md +154 -0
  1024. package/website/guide/gate.md +143 -0
  1025. package/website/guide/getting-started.md +46 -0
  1026. package/website/guide/hooks.md +238 -0
  1027. package/website/guide/live-streams.md +125 -0
  1028. package/website/guide/metadata.md +239 -0
  1029. package/website/guide/migrating-from-track-player.md +244 -0
  1030. package/website/guide/native-callback-fetch.md +127 -0
  1031. package/website/guide/network.md +86 -0
  1032. package/website/guide/now-playing.md +175 -0
  1033. package/website/guide/playback.md +328 -0
  1034. package/website/guide/queue.md +300 -0
  1035. package/website/guide/remote-controls.md +256 -0
  1036. package/website/guide/search.md +255 -0
  1037. package/website/guide/sleep-timer.md +268 -0
  1038. package/website/guide/track.md +247 -0
  1039. package/ios/Bridge.h +0 -8
  1040. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1041. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1042. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1043. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1044. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1045. package/ios/Model/MediaURL.swift +0 -67
  1046. package/ios/Model/SourceType.swift +0 -6
  1047. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1048. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1049. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1050. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1051. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1052. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1053. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1054. package/ios/Option/PitchAlgorithms.swift +0 -17
  1055. package/ios/Option/TimeEventFrequency.swift +0 -18
  1056. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1057. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1058. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1059. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1060. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1061. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1062. package/ios/Player/PlaybackStateStore.swift +0 -27
  1063. package/ios/Player/PlayingStateManager.swift +0 -33
  1064. package/ios/Player/RetryManager.swift +0 -322
  1065. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1066. package/ios/Player/SleepTimerHandling.swift +0 -15
  1067. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1068. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1069. package/ios/Tests/MediaResolveTests.swift +0 -126
  1070. package/ios/Tests/OnceValueTests.swift +0 -79
  1071. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1072. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1073. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1074. package/ios/Tests/RetryManagerTests.swift +0 -89
  1075. package/ios/TrackPlayer.swift +0 -1014
  1076. package/ios/TrackPlayerCallbacks.swift +0 -86
  1077. package/ios/Util/MetadataAdapter.swift +0 -131
  1078. package/ios/Util/OnceValue.swift +0 -104
  1079. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1080. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1081. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1082. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1083. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1084. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1085. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1086. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1087. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1088. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1089. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1090. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1091. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1092. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -0,0 +1,302 @@
1
+ /** @vitest-environment happy-dom */
2
+
3
+ import { renderHook, act, cleanup } from '@testing-library/react'
4
+ import { describe, it, expect, afterEach, vi } from 'vitest'
5
+
6
+ /**
7
+ * The hooks that are a single delegation to `useNativeUpdatedValue`. Their
8
+ * behaviour is covered once in `utils/useNativeUpdatedValue.test.ts`; what is
9
+ * per-hook and untestable there is the wiring — which native callback slot the
10
+ * emitter claims, and which `eventKey` is pulled out of the payload.
11
+ * (`useActiveTrack` and `useQueue` are getter-refreshed instead — they update
12
+ * on transitions AND favorite toggles — and are covered in their own block.)
13
+ *
14
+ * Both are easy to get wrong and silent when wrong: the hook simply never
15
+ * updates, or yields the whole event where a field was meant. Five slots
16
+ * already differ in name from the emitter that claims them
17
+ * (`onPlaybackPlayWhenReadyChanged` behind `onPlayWhenReadyChanged`, and
18
+ * friends), so the names cannot be derived — they have to be pinned.
19
+ */
20
+ const slots = vi.hoisted(() => new Map<string, (event: unknown) => void>())
21
+
22
+ vi.mock('../native', () => ({
23
+ nativeBrowser: new Proxy({} as Record<string, unknown>, {
24
+ get(target, prop: string) {
25
+ // Getters are the pre-native fallback; undefined stands in for "native
26
+ // has not answered yet", which is what these tests start from.
27
+ target[prop] ??= vi.fn(() => undefined)
28
+ return target[prop]
29
+ },
30
+ set(target, prop: string, value) {
31
+ if (typeof value === 'function') slots.set(prop, value)
32
+ target[prop] = value
33
+ return true
34
+ }
35
+ })
36
+ }))
37
+
38
+ const { useBatteryOptimizationStatus, useBatteryWarningPending } =
39
+ await import('./battery')
40
+ const { useContent, usePath, useTabs } = await import('./browser')
41
+ const { useCarConnected } = await import('./carConnection')
42
+ const { useEqualizerSettings } = await import('./equalizer')
43
+ const { useFormattedNavigationError, useNavigationError, usePlaybackError } =
44
+ await import('./errors')
45
+ const { useOnline } = await import('./network')
46
+ const { useNowPlaying } = await import('./nowPlaying')
47
+ const { useOutput } = await import('./output')
48
+ const { useOptions } = await import('./player/options')
49
+ const { usePlayingState } = await import('./playback/playing')
50
+ const { usePlayWhenReady } = await import('./playback/playWhenReady')
51
+ const { useProgress } = await import('./playback/progress')
52
+ const { usePlayback } = await import('./playback/state')
53
+ const { useSystemVolume } = await import('./playback/volume')
54
+ const { useActiveTrack } = await import('./queue/activeTrack')
55
+ const { useQueue } = await import('./queue/queue')
56
+ const { useRepeatMode } = await import('./queue/repeatMode')
57
+ const { useShuffle } = await import('./queue/shuffle')
58
+
59
+ afterEach(cleanup)
60
+
61
+ type Wiring = {
62
+ name: string
63
+ hook: () => unknown
64
+ /** The property on the Nitro object the emitter assigns its callback to. */
65
+ slot: string
66
+ event: unknown
67
+ /** What the hook returns — differs from `event` exactly when an eventKey applies. */
68
+ expected: unknown
69
+ }
70
+
71
+ const wirings: Wiring[] = [
72
+ // Payload passed through whole (no eventKey).
73
+ {
74
+ name: 'useOutput',
75
+ hook: useOutput,
76
+ slot: 'onOutputChanged',
77
+ event: { type: 'bluetooth' },
78
+ expected: { type: 'bluetooth' }
79
+ },
80
+ {
81
+ name: 'useNowPlaying',
82
+ hook: useNowPlaying,
83
+ slot: 'onNowPlayingChanged',
84
+ event: { title: 'Song' },
85
+ expected: { title: 'Song' }
86
+ },
87
+ {
88
+ name: 'useOnline',
89
+ hook: useOnline,
90
+ slot: 'onOnlineChanged',
91
+ event: true,
92
+ expected: true
93
+ },
94
+ {
95
+ name: 'useCarConnected',
96
+ hook: useCarConnected,
97
+ slot: 'onCarConnectedChanged',
98
+ event: true,
99
+ expected: true
100
+ },
101
+ {
102
+ name: 'useEqualizerSettings',
103
+ hook: useEqualizerSettings,
104
+ slot: 'onEqualizerChanged',
105
+ event: { enabled: true },
106
+ expected: { enabled: true }
107
+ },
108
+ {
109
+ name: 'usePath',
110
+ hook: usePath,
111
+ slot: 'onPathChanged',
112
+ event: '/artists/1',
113
+ expected: '/artists/1'
114
+ },
115
+ {
116
+ name: 'useContent',
117
+ hook: useContent,
118
+ slot: 'onContentChanged',
119
+ event: { src: 'a' },
120
+ expected: { src: 'a' }
121
+ },
122
+ {
123
+ name: 'useTabs',
124
+ hook: useTabs,
125
+ slot: 'onTabsChanged',
126
+ event: [{ src: 'a' }],
127
+ expected: [{ src: 'a' }]
128
+ },
129
+ {
130
+ name: 'usePlayback',
131
+ hook: usePlayback,
132
+ slot: 'onPlaybackChanged',
133
+ event: { state: 'playing' },
134
+ expected: { state: 'playing' }
135
+ },
136
+ {
137
+ name: 'useSystemVolume',
138
+ hook: useSystemVolume,
139
+ slot: 'onSystemVolumeChanged',
140
+ event: 0.4,
141
+ expected: 0.4
142
+ },
143
+ {
144
+ name: 'useProgress',
145
+ hook: useProgress,
146
+ slot: 'onPlaybackProgressUpdated',
147
+ event: { position: 1, duration: 2, buffered: 3 },
148
+ expected: { position: 1, duration: 2, buffered: 3 }
149
+ },
150
+ {
151
+ name: 'usePlayingState',
152
+ hook: usePlayingState,
153
+ slot: 'onPlaybackPlayingState',
154
+ event: { state: 'ready' },
155
+ expected: { state: 'ready' }
156
+ },
157
+ {
158
+ name: 'useShuffle',
159
+ hook: useShuffle,
160
+ slot: 'onPlaybackShuffleModeChanged',
161
+ event: true,
162
+ expected: true
163
+ },
164
+ {
165
+ name: 'useFormattedNavigationError',
166
+ hook: useFormattedNavigationError,
167
+ slot: 'onFormattedNavigationError',
168
+ event: { title: 'Offline' },
169
+ expected: { title: 'Offline' }
170
+ },
171
+ {
172
+ name: 'useOptions',
173
+ hook: useOptions,
174
+ slot: 'onOptionsChanged',
175
+ event: { playbackSpeed: 1.5 },
176
+ expected: { playbackSpeed: 1.5 }
177
+ },
178
+
179
+ // A field lifted out of the payload — the eventKey cases.
180
+ {
181
+ name: 'usePlaybackError',
182
+ hook: usePlaybackError,
183
+ slot: 'onPlaybackError',
184
+ event: { error: { code: 'network' } },
185
+ expected: { code: 'network' }
186
+ },
187
+ {
188
+ name: 'useNavigationError',
189
+ hook: useNavigationError,
190
+ slot: 'onNavigationError',
191
+ event: { error: { code: 'notFound' } },
192
+ expected: { code: 'notFound' }
193
+ },
194
+ {
195
+ name: 'usePlayWhenReady',
196
+ hook: usePlayWhenReady,
197
+ slot: 'onPlaybackPlayWhenReadyChanged',
198
+ event: { playWhenReady: true },
199
+ expected: true
200
+ },
201
+ {
202
+ name: 'useRepeatMode',
203
+ hook: useRepeatMode,
204
+ slot: 'onPlaybackRepeatModeChanged',
205
+ event: { repeatMode: 'queue' },
206
+ expected: 'queue'
207
+ },
208
+ {
209
+ name: 'useBatteryWarningPending',
210
+ hook: useBatteryWarningPending,
211
+ slot: 'onBatteryWarningPendingChanged',
212
+ event: { pending: true },
213
+ expected: true
214
+ },
215
+ {
216
+ name: 'useBatteryOptimizationStatus',
217
+ hook: useBatteryOptimizationStatus,
218
+ slot: 'onBatteryOptimizationStatusChanged',
219
+ event: { status: 'unrestricted' },
220
+ expected: 'unrestricted'
221
+ }
222
+ ]
223
+
224
+ describe.each(wirings)('$name', ({ hook, slot, event, expected }) => {
225
+ it(`reads $slot`, () => {
226
+ // A slot nothing claimed means the emitter assigns a different property
227
+ // than the one named here — the hook would never update in production.
228
+ expect(slots.has(slot)).toBe(true)
229
+
230
+ const { result } = renderHook(() => hook())
231
+ act(() => slots.get(slot)!(event))
232
+ expect(result.current).toEqual(expected)
233
+ })
234
+ })
235
+
236
+ describe('hook wiring table', () => {
237
+ it('covers every delegating hook exactly once', () => {
238
+ const names = wirings.map((w) => w.name)
239
+ expect(new Set(names).size).toBe(names.length)
240
+ expect(new Set(wirings.map((w) => w.slot)).size).toBe(wirings.length)
241
+ })
242
+ })
243
+
244
+ /**
245
+ * `useActiveTrack` and `useQueue` are getter-refreshed: a favorite toggle
246
+ * mutates the active track in place WITHOUT a transition event —
247
+ * transitions and mutations are separate events — so
248
+ * these hooks re-read their native getter on the transition slot AND on
249
+ * `onFavoriteChanged`.
250
+ */
251
+ const { nativeBrowser } = await import('../native')
252
+
253
+ describe.each([
254
+ {
255
+ name: 'useActiveTrack',
256
+ hook: useActiveTrack,
257
+ getter: 'getActiveTrack',
258
+ transitionSlot: 'onPlaybackActiveTrackChanged',
259
+ initial: { src: 'a', favorited: false },
260
+ mutated: { src: 'a', favorited: true }
261
+ },
262
+ {
263
+ name: 'useQueue',
264
+ hook: useQueue,
265
+ getter: 'getQueue',
266
+ transitionSlot: 'onPlaybackQueueChanged',
267
+ initial: [{ src: 'a', favorited: false }],
268
+ mutated: [{ src: 'a', favorited: true }]
269
+ }
270
+ ])(
271
+ '$name (getter-refreshed)',
272
+ ({ hook, getter, transitionSlot, initial, mutated }) => {
273
+ it(`re-reads ${getter} on ${transitionSlot} and onFavoriteChanged`, () => {
274
+ expect(slots.has(transitionSlot)).toBe(true)
275
+ expect(slots.has('onFavoriteChanged')).toBe(true)
276
+
277
+ const getterMock = (
278
+ nativeBrowser as unknown as Record<string, ReturnType<typeof vi.fn>>
279
+ )[getter]!
280
+
281
+ getterMock.mockReturnValue(initial)
282
+ const { result } = renderHook(() => hook())
283
+ expect(result.current).toEqual(initial)
284
+
285
+ // A transition re-reads the getter (the event payload is not consumed).
286
+ getterMock.mockReturnValue(mutated)
287
+ act(() => slots.get(transitionSlot)!({}))
288
+ expect(result.current).toEqual(mutated)
289
+
290
+ // A favorite toggle mutates in place — no transition event fires, but
291
+ // the hook must still refresh.
292
+ getterMock.mockReturnValue(initial)
293
+ act(() =>
294
+ slots.get('onFavoriteChanged')!({
295
+ track: { src: 'a' },
296
+ favorited: false
297
+ })
298
+ )
299
+ expect(result.current).toEqual(initial)
300
+ })
301
+ }
302
+ )
@@ -98,8 +98,13 @@ export interface ChapterMetadata {
98
98
 
99
99
  /**
100
100
  * Subscribes to chapter metadata events.
101
+ *
102
+ * @platform ios android
103
+ * Never fires on web — the web player does not read chapter markers. See
104
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
105
+ *
101
106
  * @param callback - Called when chapter metadata is received
102
- * @returns Cleanup function to unsubscribe
107
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
103
108
  */
104
109
  export const onChapterMetadata = NativeUpdatedValue.emitterize<
105
110
  ChapterMetadata[]
@@ -107,8 +112,13 @@ export const onChapterMetadata = NativeUpdatedValue.emitterize<
107
112
 
108
113
  /**
109
114
  * Subscribes to track metadata events.
115
+ *
116
+ * @platform ios android
117
+ * Never fires on web — the web player does not read embedded file tags. See
118
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
119
+ *
110
120
  * @param callback - Called when static track metadata is received
111
- * @returns Cleanup function to unsubscribe
121
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
112
122
  */
113
123
  export const onTrackMetadata = NativeUpdatedValue.emitterize<TrackMetadata>(
114
124
  (cb) => (nativeBrowser.onTrackMetadata = cb)
@@ -116,8 +126,15 @@ export const onTrackMetadata = NativeUpdatedValue.emitterize<TrackMetadata>(
116
126
 
117
127
  /**
118
128
  * Subscribes to timed metadata events (ICY/ID3 from live streams).
129
+ *
130
+ * @platform ios android
131
+ * Never fires on web. ICY metadata is stripped by the browser before the player
132
+ * can see it, and no browser API exposes it; in-band ID3 from HLS is reachable
133
+ * but not yet wired. See
134
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
135
+ *
119
136
  * @param callback - Called when stream metadata is received (title, artist from ICY/ID3 tags)
120
- * @returns Cleanup function to unsubscribe
137
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
121
138
  */
122
139
  export const onTimedMetadata = NativeUpdatedValue.emitterize<TimedMetadata>(
123
140
  (cb) => (nativeBrowser.onTimedMetadata = cb)
@@ -17,7 +17,7 @@ export function getOnline(): boolean {
17
17
  /**
18
18
  * Subscribes to network connectivity changes.
19
19
  * @param callback - Called when network state changes
20
- * @returns Cleanup function to unsubscribe
20
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
21
21
  */
22
22
  export const onOnlineChanged = NativeUpdatedValue.emitterize<boolean>(
23
23
  (cb) => (nativeBrowser.onOnlineChanged = cb)
@@ -74,7 +74,7 @@ export function clearNowPlayingFlash(): void {
74
74
  * Subscribes to now playing metadata change events.
75
75
  * Fires when updateNowPlaying is called or when the track changes.
76
76
  * @param callback - Called when now playing metadata changes
77
- * @returns Cleanup function to unsubscribe
77
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
78
78
  */
79
79
  export const onNowPlayingChanged =
80
80
  NativeUpdatedValue.emitterize<NowPlayingMetadata>(
@@ -34,8 +34,9 @@ export function supportsOutputSwitcher(): boolean {
34
34
  /**
35
35
  * The current audio output, or `undefined` when unknown. iOS reports one while a
36
36
  * session is active; Android reports the active output route via AudioManager
37
- * (the `type` is coarse — e.g. wired headphones may report as `speaker`). Guard
38
- * for `undefined`.
37
+ * (the `type` is coarse — e.g. wired headphones may report as `speaker`), or the
38
+ * remote output selected in the Output Switcher when `remoteOutputs` is on.
39
+ * Guard for `undefined`.
39
40
  */
40
41
  export function getOutput(): Output | undefined {
41
42
  return nativeBrowser.getOutput()
@@ -46,7 +47,7 @@ export function getOutput(): Output | undefined {
46
47
  /**
47
48
  * Subscribes to current-output changes (headphones unplugged, Bluetooth speaker
48
49
  * connected, AirPlay/route selected). Fires on iOS and Android 11+; never below.
49
- * @returns Cleanup function to unsubscribe.
50
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
50
51
  */
51
52
  export const onOutputChanged = NativeUpdatedValue.emitterize<Output>(
52
53
  (cb) => (nativeBrowser.onOutputChanged = cb)
@@ -58,8 +58,10 @@ export function seekTo(position: number): void {
58
58
  }
59
59
 
60
60
  /**
61
- * Jump to the live edge of the current track. No-op for non-live tracks; for
62
- * live, seeks to the window end (HLS) or reconnects (non-seekable streams).
61
+ * Jump to the live edge of the current track; no-op unless the track
62
+ * declares `live: true`. A stream with a seekable live window (HLS) seeks
63
+ * to the window's edge; a non-seekable stream (e.g. ICY radio) reconnects
64
+ * to rejoin live — an expired URL re-resolves through `media.resolve`.
63
65
  */
64
66
  export function seekToLiveEdge(): void {
65
67
  nativeBrowser.seekToLiveEdge()
@@ -35,7 +35,7 @@ export function setPlayWhenReady(playWhenReady: boolean): void {
35
35
  /**
36
36
  * Subscribes to play when ready changes.
37
37
  * @param callback - Called when playWhenReady changes
38
- * @returns Cleanup function to unsubscribe
38
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
39
39
  */
40
40
  export const onPlayWhenReadyChanged =
41
41
  NativeUpdatedValue.emitterize<PlaybackPlayWhenReadyChangedEvent>(
@@ -23,7 +23,7 @@ export function getPlayingState(): PlayingState {
23
23
  /**
24
24
  * Subscribes to playing state changes.
25
25
  * @param callback - Called when playing or buffering state changes
26
- * @returns Cleanup function to unsubscribe
26
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
27
27
  */
28
28
  export const onPlayingState = NativeUpdatedValue.emitterize<PlayingState>(
29
29
  (cb) => (nativeBrowser.onPlaybackPlayingState = cb)
@@ -0,0 +1,169 @@
1
+ /** @vitest-environment happy-dom */
2
+
3
+ import { renderHook, act, cleanup } from '@testing-library/react'
4
+ import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
5
+ import type { Progress } from './progress'
6
+ import {
7
+ appStateListenerCount,
8
+ resetAppState,
9
+ setAppState
10
+ } from '../../test-utils/reactNativeStub'
11
+
12
+ const native = vi.hoisted(() => ({
13
+ getProgress: vi.fn<() => Progress>(() => ({
14
+ position: 0,
15
+ duration: 0,
16
+ buffered: 0
17
+ })),
18
+ onPlaybackChanged: undefined as ((event: unknown) => void) | undefined,
19
+ onPlaybackProgressUpdated: undefined as ((event: unknown) => void) | undefined
20
+ }))
21
+
22
+ vi.mock('../../native', () => ({ nativeBrowser: native }))
23
+
24
+ const { usePolledProgress } = await import('./progress')
25
+
26
+ const at = (position: number): Progress => ({
27
+ position,
28
+ duration: 300,
29
+ buffered: position + 10
30
+ })
31
+
32
+ beforeEach(() => {
33
+ vi.useFakeTimers()
34
+ resetAppState()
35
+ native.getProgress.mockReturnValue(at(0))
36
+ })
37
+
38
+ afterEach(() => {
39
+ cleanup()
40
+ vi.useRealTimers()
41
+ })
42
+
43
+ describe('usePolledProgress', () => {
44
+ it('starts at zero and polls the first value in', () => {
45
+ native.getProgress.mockReturnValue(at(12))
46
+ const { result } = renderHook(() => usePolledProgress())
47
+ // The initial poll runs inside the effect, so the zeroed useState default is
48
+ // never observable to a caller.
49
+ expect(result.current).toEqual(at(12))
50
+ })
51
+
52
+ it('polls on the given interval', () => {
53
+ const { result } = renderHook(() => usePolledProgress(500))
54
+ native.getProgress.mockReturnValue(at(1))
55
+ act(() => {
56
+ vi.advanceTimersByTime(500)
57
+ })
58
+ expect(result.current).toEqual(at(1))
59
+
60
+ native.getProgress.mockReturnValue(at(2))
61
+ act(() => {
62
+ vi.advanceTimersByTime(500)
63
+ })
64
+ expect(result.current).toEqual(at(2))
65
+ })
66
+
67
+ it('does not poll before the interval elapses', () => {
68
+ renderHook(() => usePolledProgress(1000))
69
+ native.getProgress.mockClear()
70
+ act(() => {
71
+ vi.advanceTimersByTime(999)
72
+ })
73
+ expect(native.getProgress).not.toHaveBeenCalled()
74
+ })
75
+
76
+ it('keeps the same object when nothing changed', () => {
77
+ const { result } = renderHook(() => usePolledProgress(500))
78
+ const first = result.current
79
+ act(() => {
80
+ vi.advanceTimersByTime(500)
81
+ })
82
+ // Identity, not equality: the hook returns the previous state object so a
83
+ // consumer's useEffect/memo on progress does not re-fire every tick.
84
+ expect(result.current).toBe(first)
85
+ })
86
+
87
+ it('updates immediately when playback changes, without waiting for a tick', () => {
88
+ const { result } = renderHook(() => usePolledProgress(10_000))
89
+ native.getProgress.mockReturnValue(at(7))
90
+ act(() => {
91
+ native.onPlaybackChanged?.({ state: 'playing' })
92
+ })
93
+ expect(result.current).toEqual(at(7))
94
+ })
95
+
96
+ it('survives a getter that throws before setup', () => {
97
+ native.getProgress.mockImplementation(() => {
98
+ throw new Error('not set up')
99
+ })
100
+ const { result } = renderHook(() => usePolledProgress(500))
101
+ expect(result.current).toEqual({ position: 0, duration: 0, buffered: 0 })
102
+ expect(() => act(() => vi.advanceTimersByTime(500))).not.toThrow()
103
+ })
104
+
105
+ it('stops polling in the background and resumes on return', () => {
106
+ const { result } = renderHook(() => usePolledProgress(500))
107
+
108
+ act(() => {
109
+ setAppState('background')
110
+ })
111
+ native.getProgress.mockReturnValue(at(99))
112
+ act(() => {
113
+ vi.advanceTimersByTime(5_000)
114
+ })
115
+ expect(result.current).toEqual(at(0))
116
+
117
+ // Returning to the foreground updates once immediately rather than leaving
118
+ // a stale position on screen until the next interval.
119
+ act(() => {
120
+ setAppState('active')
121
+ })
122
+ expect(result.current).toEqual(at(99))
123
+ })
124
+
125
+ it('ignores playback events while backgrounded', () => {
126
+ const { result } = renderHook(() => usePolledProgress(500))
127
+ act(() => {
128
+ setAppState('background')
129
+ })
130
+ native.getProgress.mockReturnValue(at(42))
131
+ act(() => {
132
+ native.onPlaybackChanged?.({ state: 'playing' })
133
+ })
134
+ expect(result.current).toEqual(at(0))
135
+ })
136
+
137
+ it('does not stack pollers when backgrounded twice', () => {
138
+ renderHook(() => usePolledProgress(500))
139
+ act(() => {
140
+ setAppState('background')
141
+ })
142
+ act(() => {
143
+ setAppState('active')
144
+ })
145
+ act(() => {
146
+ setAppState('active')
147
+ })
148
+
149
+ native.getProgress.mockClear()
150
+ act(() => {
151
+ vi.advanceTimersByTime(500)
152
+ })
153
+ expect(native.getProgress).toHaveBeenCalledTimes(1)
154
+ })
155
+
156
+ it('tears down its timer and subscriptions on unmount', () => {
157
+ const { unmount } = renderHook(() => usePolledProgress(500))
158
+ expect(appStateListenerCount()).toBe(1)
159
+
160
+ unmount()
161
+ expect(appStateListenerCount()).toBe(0)
162
+
163
+ native.getProgress.mockClear()
164
+ act(() => {
165
+ vi.advanceTimersByTime(5_000)
166
+ })
167
+ expect(native.getProgress).not.toHaveBeenCalled()
168
+ })
169
+ })
@@ -46,7 +46,7 @@ export function getProgress(): Progress {
46
46
  /**
47
47
  * Subscribes to playback progress updates.
48
48
  * @param callback - Called periodically with playback progress updates
49
- * @returns Cleanup function to unsubscribe
49
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
50
50
  */
51
51
  export const onProgressUpdated =
52
52
  NativeUpdatedValue.emitterize<PlaybackProgressUpdatedEvent>(
@@ -118,7 +118,8 @@ export function usePolledProgress(updateInterval = 1000): Progress {
118
118
  }
119
119
 
120
120
  const stop = () => {
121
- clearTimeout(timer)
121
+ // Guarded: React Native types clearTimeout(handle: number) — no undefined.
122
+ if (timer !== undefined) clearTimeout(timer)
122
123
  timer = undefined
123
124
  unsubscribeState?.()
124
125
  unsubscribeState = undefined
@@ -14,8 +14,15 @@ export function getRate(): number {
14
14
 
15
15
  /**
16
16
  * Sets the playback rate.
17
+ *
18
+ * The rate is a speed multiplier, not a transport control — it is independent
19
+ * of play/pause, and setting it while paused never starts playback. Use
20
+ * {@link play} / {@link pause} for that.
21
+ *
17
22
  * @param rate - The playback rate to change to, where 0.5 would be half speed,
18
- * 1 would be regular speed, 2 would be double speed etc.
23
+ * 1 would be regular speed, 2 would be double speed etc. Must be greater than
24
+ * zero; platforms disagree on what a non-positive rate does (iOS ignores it,
25
+ * Android throws, web stalls the element), so treat it as unsupported.
19
26
  */
20
27
  export function setRate(rate: number): void {
21
28
  nativeBrowser.setRate(rate)
@@ -18,9 +18,8 @@ import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue'
18
18
  * - `'buffering'`: Indicates that the player is currently loading more data
19
19
  * before it can continue playing or is ready to start playing.
20
20
  * - `'error'`: Indicates that playback of the current item failed. Call
21
- * `AudioBrowser.getError()` to get more information on the type of error that
22
- * occurred. Call `AudioBrowser.retry()` or `AudioBrowser.play()` to try to play
23
- * the item again.
21
+ * `getPlaybackError()` (or subscribe via `usePlaybackError()`) for the
22
+ * error details. Call `retry()` or `play()` to try to play the item again.
24
23
  * - `'ended'`: Indicates that playback stopped due to the end of the queue
25
24
  * being reached.
26
25
  */
@@ -55,7 +54,7 @@ export function getPlayback(): Playback {
55
54
  /**
56
55
  * Subscribes to playback state changes.
57
56
  * @param callback - Called when the playback state changes
58
- * @returns Cleanup function to unsubscribe
57
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
59
58
  */
60
59
  export const onPlaybackChanged = NativeUpdatedValue.emitterize<Playback>(
61
60
  (cb) => (nativeBrowser.onPlaybackChanged = cb)