react-native-audio-browser 0.2.0-next.6 → 0.2.0-next.60

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 (1211) hide show
  1. package/README.md +66 -39
  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 +213 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +543 -419
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  9. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  10. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  11. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  12. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  13. package/android/src/main/java/com/audiobrowser/Service.kt +61 -72
  14. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  15. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  16. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  17. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +334 -536
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +37 -68
  19. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  20. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  21. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  22. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  23. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -29
  24. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  25. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  26. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +5 -15
  27. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  28. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  29. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  30. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  32. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  33. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +18 -40
  34. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  35. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  36. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  37. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  38. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  39. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  40. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  41. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  42. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  43. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  44. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +14 -31
  45. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  46. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +38 -27
  47. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  48. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  49. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +96 -113
  50. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  51. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +41 -35
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +125 -133
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  54. package/android/src/main/java/com/audiobrowser/player/Player.kt +396 -561
  55. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  56. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -21
  57. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +59 -113
  58. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +42 -101
  59. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  60. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  61. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  62. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  63. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +32 -67
  64. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  65. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  66. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  67. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  68. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +682 -0
  70. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  71. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  72. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  73. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  86. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  87. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  88. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  89. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  90. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  91. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  92. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  93. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  94. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -15
  95. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  96. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  97. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  98. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  99. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  100. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  101. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  102. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  103. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  104. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  105. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  106. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  107. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  108. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  109. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  110. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  111. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  112. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  113. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -82
  114. package/android/src/main/res/values/strings.xml +25 -5
  115. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  116. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  117. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  118. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  119. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  120. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +201 -0
  121. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -43
  122. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  123. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  124. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  125. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +158 -0
  126. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -23
  127. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +314 -8
  128. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  129. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  130. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -4
  131. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  132. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -55
  133. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  134. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  135. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  136. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  137. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +8 -16
  138. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  139. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  140. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +460 -0
  141. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  142. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  143. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  144. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  145. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  146. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  147. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  148. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  149. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +223 -20
  150. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +2 -26
  151. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +45 -33
  152. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  153. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  154. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  155. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +150 -0
  156. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  157. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  158. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +179 -0
  159. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +93 -0
  160. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  161. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +190 -0
  162. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +22 -65
  163. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -5
  164. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  165. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  166. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  167. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +2 -23
  168. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +279 -0
  169. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  170. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  171. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  172. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +926 -0
  173. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  174. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  175. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  176. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  177. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  178. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  179. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  180. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  181. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  182. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  183. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  184. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  185. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  186. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  187. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  188. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  189. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  190. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  191. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  192. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  193. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  194. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  195. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  196. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  197. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  198. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  199. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  200. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  201. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  202. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  203. package/android/src/test/resources/sonos/device_description.xml +78 -0
  204. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  205. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  206. package/ios/AVPlayerEngine.swift +354 -0
  207. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  208. package/ios/Browser/BrowseGate.swift +57 -0
  209. package/ios/Browser/BrowserConfig.swift +123 -104
  210. package/ios/Browser/BrowserError.swift +15 -0
  211. package/ios/Browser/BrowserManager.swift +139 -676
  212. package/ios/Browser/BrowserPathHelper.swift +54 -117
  213. package/ios/Browser/FavoriteSet.swift +43 -0
  214. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  215. package/ios/Browser/JsonModels.swift +244 -335
  216. package/ios/Browser/NavigationErrorState.swift +42 -0
  217. package/ios/Browser/PageResolver.swift +137 -0
  218. package/ios/Browser/RequestLayer.swift +181 -0
  219. package/ios/Browser/RequestPipeline.swift +293 -0
  220. package/ios/Browser/SearchDrillIn.swift +11 -17
  221. package/ios/Browser/SectionScope.swift +73 -26
  222. package/ios/Browser/SimpleRouter.swift +76 -154
  223. package/ios/Browser/StyleResolver.swift +41 -0
  224. package/ios/Browser/TabBarEntries.swift +8 -7
  225. package/ios/Browser/TrackIdTemplate.swift +29 -0
  226. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  227. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  228. package/ios/CarPlay/CarPlayController.swift +37 -1297
  229. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  230. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  231. package/ios/CarPlay/CarPlayNowPlayingManager.swift +129 -204
  232. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  233. package/ios/CarPlay/CarPlaySession+PageLoader.swift +92 -0
  234. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  235. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  236. package/ios/CarPlay/CarPlaySession.swift +203 -0
  237. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  238. package/ios/CarPlay/IntentHandlers.swift +94 -0
  239. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  240. package/ios/CarPlay/MediaIntentHandler.swift +63 -0
  241. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  242. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  243. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  244. package/ios/CarPlay/SectionPresentation.swift +67 -0
  245. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  246. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  247. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  248. package/ios/Extension/CxxVectorConformances.swift +4 -16
  249. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  250. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  251. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  252. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  253. package/ios/Extension/SearchParams+Query.swift +28 -0
  254. package/ios/Extension/Section+Copying.swift +26 -0
  255. package/ios/Extension/String+IcyCharset.swift +21 -0
  256. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  257. package/ios/Extension/Track+AVPlayer.swift +1 -18
  258. package/ios/Extension/Track+Copying.swift +13 -21
  259. package/ios/Extension/Track+Identity.swift +20 -0
  260. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  261. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  262. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  263. package/ios/Extension/URLError+Connectivity.swift +15 -0
  264. package/ios/Extension/Variant+Artwork.swift +8 -22
  265. package/ios/Http/HttpClient.swift +73 -167
  266. package/ios/HybridAudioBrowser+Browser.swift +130 -0
  267. package/ios/HybridAudioBrowser+Options.swift +102 -0
  268. package/ios/HybridAudioBrowser+Player.swift +333 -0
  269. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  270. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  271. package/ios/HybridAudioBrowser.swift +138 -1684
  272. package/ios/Model/NitroTypeStubs.swift +240 -32
  273. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  274. package/ios/Model/RemoteCommand.swift +6 -60
  275. package/ios/Model/TrackPlayerError.swift +14 -23
  276. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  277. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  278. package/ios/Observer/ItemObserver.swift +92 -0
  279. package/ios/Observer/PlayerObserver.swift +59 -0
  280. package/ios/Option/SessionCategories.swift +42 -92
  281. package/ios/PlaybackEvent.swift +2 -2
  282. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  283. package/ios/Player/AudioSessionController.swift +190 -0
  284. package/ios/Player/DeferredSeek.swift +70 -0
  285. package/ios/Player/EndOfTrackJudgement.swift +6 -13
  286. package/ios/Player/ErrorStatus.swift +51 -0
  287. package/ios/Player/MediaLoader.swift +73 -98
  288. package/ios/Player/NowPlayingLines.swift +49 -0
  289. package/ios/Player/NowPlayingUpdater.swift +176 -105
  290. package/ios/Player/PersistedPlaybackState.swift +1 -2
  291. package/ios/Player/PlaybackFailure.swift +121 -0
  292. package/ios/Player/PlaybackPersistence.swift +72 -0
  293. package/ios/Player/PlaybackStateMachine.swift +8 -11
  294. package/ios/Player/PlaybackTimer.swift +11 -8
  295. package/ios/Player/Player.swift +968 -0
  296. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  297. package/ios/Player/PlayerEngine.swift +104 -0
  298. package/ios/Player/PlayerStatusTypes.swift +1 -6
  299. package/ios/Player/QueueManager.swift +80 -98
  300. package/ios/Player/RetryLoop.swift +280 -0
  301. package/ios/Player/ShuffleOrder.swift +36 -43
  302. package/ios/Player/SleepTimerManager.swift +25 -42
  303. package/ios/Player/VolumeFader.swift +20 -15
  304. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  305. package/ios/RemoteCommand/RemoteCommandController.swift +101 -336
  306. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  307. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  308. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  309. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  310. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  311. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  312. package/ios/Tests/DeferredSeekTests.swift +68 -0
  313. package/ios/Tests/EmitterTests.swift +22 -39
  314. package/ios/Tests/EndOfTrackJudgementTests.swift +1 -6
  315. package/ios/Tests/ErrorStatusTests.swift +50 -0
  316. package/ios/Tests/FavoriteSetTests.swift +61 -0
  317. package/ios/Tests/GenerationMemoTests.swift +121 -0
  318. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  319. package/ios/Tests/JsonModelsTests.swift +189 -3
  320. package/ios/Tests/LRUCacheTests.swift +106 -0
  321. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  322. package/ios/Tests/MediaLoaderTests.swift +38 -78
  323. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  324. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  325. package/ios/Tests/ObserverTests.swift +88 -0
  326. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  327. package/ios/Tests/PlaybackFailureTests.swift +181 -0
  328. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  329. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  330. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  331. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  332. package/ios/Tests/PlayerPolicyTests.swift +444 -0
  333. package/ios/Tests/PlayerTests.swift +1403 -0
  334. package/ios/Tests/PlayingStateTests.swift +41 -0
  335. package/ios/Tests/QueueManagerTests.swift +205 -174
  336. package/ios/Tests/ReadyValueTests.swift +73 -0
  337. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  338. package/ios/Tests/RequestLayerTests.swift +228 -0
  339. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  340. package/ios/Tests/RetryLoopTests.swift +282 -0
  341. package/ios/Tests/SearchDrillInTests.swift +16 -17
  342. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  343. package/ios/Tests/SectionPresentationTests.swift +85 -0
  344. package/ios/Tests/SectionScopeTests.swift +136 -54
  345. package/ios/Tests/SimpleRouterTests.swift +39 -8
  346. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  347. package/ios/Tests/StyleResolverTests.swift +123 -0
  348. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  349. package/ios/Tests/Support/TestTypes.swift +135 -100
  350. package/ios/Tests/TabBarEntriesTests.swift +19 -21
  351. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  352. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  353. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  354. package/ios/Tests/TrackIdentityTests.swift +20 -0
  355. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  356. package/ios/Tests/TrackSelectorTests.swift +157 -34
  357. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  358. package/ios/TrackSelector.swift +62 -77
  359. package/ios/Util/ArtworkFreshness.swift +42 -0
  360. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  361. package/ios/Util/ConcurrentMap.swift +19 -0
  362. package/ios/Util/Emitter.swift +45 -22
  363. package/ios/Util/GenerationMemo.swift +36 -0
  364. package/ios/Util/LRUCache.swift +23 -159
  365. package/ios/Util/NetworkMonitor.swift +31 -33
  366. package/ios/Util/OutputPicker.swift +48 -0
  367. package/ios/Util/ReadyValue.swift +57 -0
  368. package/ios/Util/SFSymbolRenderer.swift +64 -49
  369. package/ios/Util/SVGProcessor.swift +9 -16
  370. package/lib/commonjs/AudioBrowser.js +8 -8
  371. package/lib/commonjs/AudioBrowser.js.map +1 -1
  372. package/lib/commonjs/CLAUDE.md +57 -0
  373. package/lib/commonjs/features/battery.js +16 -12
  374. package/lib/commonjs/features/battery.js.map +1 -1
  375. package/lib/commonjs/features/browser-config.js +13 -9
  376. package/lib/commonjs/features/browser-config.js.map +1 -1
  377. package/lib/commonjs/features/browser.js +78 -20
  378. package/lib/commonjs/features/browser.js.map +1 -1
  379. package/lib/commonjs/features/carConnection.js +3 -4
  380. package/lib/commonjs/features/carConnection.js.map +1 -1
  381. package/lib/commonjs/features/equalizer.js +10 -6
  382. package/lib/commonjs/features/equalizer.js.map +1 -1
  383. package/lib/commonjs/features/errors.js +35 -21
  384. package/lib/commonjs/features/errors.js.map +1 -1
  385. package/lib/commonjs/features/favorites.js +29 -24
  386. package/lib/commonjs/features/favorites.js.map +1 -1
  387. package/lib/commonjs/features/gate.js +28 -7
  388. package/lib/commonjs/features/gate.js.map +1 -1
  389. package/lib/commonjs/features/metadata.js +33 -14
  390. package/lib/commonjs/features/metadata.js.map +1 -1
  391. package/lib/commonjs/features/network.js +6 -2
  392. package/lib/commonjs/features/network.js.map +1 -1
  393. package/lib/commonjs/features/nowPlaying.js +29 -15
  394. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  395. package/lib/commonjs/features/output.js +10 -5
  396. package/lib/commonjs/features/output.js.map +1 -1
  397. package/lib/commonjs/features/playback/controls.js +13 -6
  398. package/lib/commonjs/features/playback/controls.js.map +1 -1
  399. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  400. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  401. package/lib/commonjs/features/playback/playing.js +5 -3
  402. package/lib/commonjs/features/playback/playing.js.map +1 -1
  403. package/lib/commonjs/features/playback/progress.js +13 -6
  404. package/lib/commonjs/features/playback/progress.js.map +1 -1
  405. package/lib/commonjs/features/playback/rate.js +8 -1
  406. package/lib/commonjs/features/playback/rate.js.map +1 -1
  407. package/lib/commonjs/features/playback/state.js +5 -6
  408. package/lib/commonjs/features/playback/state.js.map +1 -1
  409. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -7
  410. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  411. package/lib/commonjs/features/playback/volume.js +6 -5
  412. package/lib/commonjs/features/playback/volume.js.map +1 -1
  413. package/lib/commonjs/features/player/options.js +23 -29
  414. package/lib/commonjs/features/player/options.js.map +1 -1
  415. package/lib/commonjs/features/player/setup.js +41 -41
  416. package/lib/commonjs/features/player/setup.js.map +1 -1
  417. package/lib/commonjs/features/player/validateOptions.js +23 -0
  418. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  419. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  420. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  421. package/lib/commonjs/features/queue/queue.js +58 -23
  422. package/lib/commonjs/features/queue/queue.js.map +1 -1
  423. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  424. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  425. package/lib/commonjs/features/queue/shuffle.js +1 -2
  426. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  427. package/lib/commonjs/features/remoteControls.js +70 -125
  428. package/lib/commonjs/features/remoteControls.js.map +1 -1
  429. package/lib/commonjs/features/sleepTimer.js +28 -7
  430. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  431. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  432. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  433. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -14
  434. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  435. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -12
  436. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  437. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  438. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  439. package/lib/commonjs/utils/useDebug.js +16 -3
  440. package/lib/commonjs/utils/useDebug.js.map +1 -1
  441. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  442. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  443. package/lib/commonjs/web/NativeAudioBrowser.js +204 -81
  444. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  445. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  446. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  447. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  448. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  449. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  450. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  451. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  452. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  453. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  454. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  455. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  456. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  457. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  458. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  459. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  460. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  461. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  462. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  463. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  464. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  465. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  466. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  467. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  468. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  469. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  470. package/lib/commonjs/web/browser/sections.js +89 -0
  471. package/lib/commonjs/web/browser/sections.js.map +1 -0
  472. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  473. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  474. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  475. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  476. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  477. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  478. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  479. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  480. package/lib/module/AudioBrowser.js +2 -1
  481. package/lib/module/AudioBrowser.js.map +1 -1
  482. package/lib/module/CLAUDE.md +57 -0
  483. package/lib/module/features/battery.js +16 -12
  484. package/lib/module/features/battery.js.map +1 -1
  485. package/lib/module/features/browser-config.js +13 -9
  486. package/lib/module/features/browser-config.js.map +1 -1
  487. package/lib/module/features/browser.js +78 -20
  488. package/lib/module/features/browser.js.map +1 -1
  489. package/lib/module/features/carConnection.js +3 -4
  490. package/lib/module/features/carConnection.js.map +1 -1
  491. package/lib/module/features/equalizer.js +10 -6
  492. package/lib/module/features/equalizer.js.map +1 -1
  493. package/lib/module/features/errors.js +35 -21
  494. package/lib/module/features/errors.js.map +1 -1
  495. package/lib/module/features/favorites.js +29 -24
  496. package/lib/module/features/favorites.js.map +1 -1
  497. package/lib/module/features/gate.js +28 -7
  498. package/lib/module/features/gate.js.map +1 -1
  499. package/lib/module/features/metadata.js +33 -14
  500. package/lib/module/features/metadata.js.map +1 -1
  501. package/lib/module/features/network.js +6 -2
  502. package/lib/module/features/network.js.map +1 -1
  503. package/lib/module/features/nowPlaying.js +29 -15
  504. package/lib/module/features/nowPlaying.js.map +1 -1
  505. package/lib/module/features/output.js +10 -5
  506. package/lib/module/features/output.js.map +1 -1
  507. package/lib/module/features/playback/controls.js +13 -6
  508. package/lib/module/features/playback/controls.js.map +1 -1
  509. package/lib/module/features/playback/playWhenReady.js +6 -5
  510. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  511. package/lib/module/features/playback/playing.js +5 -3
  512. package/lib/module/features/playback/playing.js.map +1 -1
  513. package/lib/module/features/playback/progress.js +13 -6
  514. package/lib/module/features/playback/progress.js.map +1 -1
  515. package/lib/module/features/playback/rate.js +8 -1
  516. package/lib/module/features/playback/rate.js.map +1 -1
  517. package/lib/module/features/playback/state.js +5 -6
  518. package/lib/module/features/playback/state.js.map +1 -1
  519. package/lib/module/features/playback/trackPlaybackTime.js +6 -6
  520. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  521. package/lib/module/features/playback/volume.js +6 -5
  522. package/lib/module/features/playback/volume.js.map +1 -1
  523. package/lib/module/features/player/options.js +22 -27
  524. package/lib/module/features/player/options.js.map +1 -1
  525. package/lib/module/features/player/setup.js +40 -40
  526. package/lib/module/features/player/setup.js.map +1 -1
  527. package/lib/module/features/player/validateOptions.js +19 -0
  528. package/lib/module/features/player/validateOptions.js.map +1 -0
  529. package/lib/module/features/queue/activeTrack.js +15 -5
  530. package/lib/module/features/queue/activeTrack.js.map +1 -1
  531. package/lib/module/features/queue/queue.js +58 -23
  532. package/lib/module/features/queue/queue.js.map +1 -1
  533. package/lib/module/features/queue/repeatMode.js +3 -2
  534. package/lib/module/features/queue/repeatMode.js.map +1 -1
  535. package/lib/module/features/queue/shuffle.js +1 -2
  536. package/lib/module/features/queue/shuffle.js.map +1 -1
  537. package/lib/module/features/remoteControls.js +70 -125
  538. package/lib/module/features/remoteControls.js.map +1 -1
  539. package/lib/module/features/sleepTimer.js +28 -7
  540. package/lib/module/features/sleepTimer.js.map +1 -1
  541. package/lib/module/test-utils/reactNativeStub.js +58 -0
  542. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  543. package/lib/module/utils/LazyNativeEmitter.js +25 -14
  544. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  545. package/lib/module/utils/NativeUpdatedValue.js +31 -12
  546. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  547. package/lib/module/utils/getTrackIdentity.js +22 -0
  548. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  549. package/lib/module/utils/useDebug.js +16 -3
  550. package/lib/module/utils/useDebug.js.map +1 -1
  551. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  552. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  553. package/lib/module/web/NativeAudioBrowser.js +204 -81
  554. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  555. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  556. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  557. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  558. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  559. package/lib/module/web/TrackPlayer/Player.js +254 -39
  560. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  561. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  562. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  563. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  564. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  565. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  566. package/lib/module/web/browser/BrowserManager.js +175 -100
  567. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  568. package/lib/module/web/browser/FavoriteManager.js +31 -21
  569. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  570. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  571. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  572. package/lib/module/web/browser/SearchManager.js +18 -23
  573. package/lib/module/web/browser/SearchManager.js.map +1 -1
  574. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  575. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  576. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  577. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  578. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  579. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  580. package/lib/module/web/browser/sections.js +83 -0
  581. package/lib/module/web/browser/sections.js.map +1 -0
  582. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  583. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  584. package/lib/module/web/http/followMediaRedirect.js +215 -0
  585. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  586. package/lib/module/web/player/NowPlayingManager.js +4 -3
  587. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  588. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  589. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  590. package/lib/typescript/package.json +1 -0
  591. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  592. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  593. package/lib/typescript/src/features/battery.d.ts +17 -12
  594. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  595. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  596. package/lib/typescript/src/features/browser.d.ts +67 -19
  597. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  598. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  599. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  600. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  601. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  602. package/lib/typescript/src/features/errors.d.ts +37 -22
  603. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  604. package/lib/typescript/src/features/favorites.d.ts +29 -24
  605. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  606. package/lib/typescript/src/features/gate.d.ts +32 -10
  607. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  608. package/lib/typescript/src/features/metadata.d.ts +54 -17
  609. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  610. package/lib/typescript/src/features/network.d.ts +6 -2
  611. package/lib/typescript/src/features/network.d.ts.map +1 -1
  612. package/lib/typescript/src/features/nowPlaying.d.ts +29 -15
  613. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  614. package/lib/typescript/src/features/output.d.ts +10 -5
  615. package/lib/typescript/src/features/output.d.ts.map +1 -1
  616. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  617. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  618. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  619. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  620. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  621. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  622. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  623. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  624. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  625. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  626. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  627. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  628. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  629. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  630. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  631. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  632. package/lib/typescript/src/features/player/options.d.ts +74 -57
  633. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  634. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  635. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  636. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  637. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  638. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  639. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  640. package/lib/typescript/src/features/queue/queue.d.ts +52 -21
  641. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  642. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  643. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  644. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  645. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  646. package/lib/typescript/src/features/remoteControls.d.ts +81 -47
  647. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  648. package/lib/typescript/src/features/sleepTimer.d.ts +16 -8
  649. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  650. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  651. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  652. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  653. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  654. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  655. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  656. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  657. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  658. package/lib/typescript/src/types/browser.d.ts +242 -173
  659. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  660. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -16
  661. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  662. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -18
  663. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  664. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  665. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  666. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  667. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  668. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  669. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  670. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  671. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  672. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  673. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  674. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  675. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  676. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  677. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  678. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  679. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  680. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  681. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  682. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  683. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  684. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  686. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  687. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  689. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  690. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  691. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  692. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  694. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  695. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  696. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  697. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  698. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  699. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  700. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  701. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  702. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  703. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  704. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  705. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  706. 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
  707. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  708. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  710. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  711. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  712. 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
  713. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  717. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  718. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  720. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  721. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  722. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  723. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  724. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  725. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  726. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  727. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  728. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  732. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  735. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  742. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  743. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  746. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  747. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  749. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  752. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +72 -44
  754. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  755. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  756. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  757. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  760. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  763. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  765. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  766. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  769. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  771. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  772. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  773. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  774. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  777. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  780. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  783. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  785. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  787. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  795. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  799. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  802. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  810. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  814. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  815. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  816. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  820. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  822. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  823. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  825. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  826. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  828. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  829. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  830. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  831. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  832. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  833. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  834. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  835. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  836. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  837. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  838. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  839. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  840. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  841. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  842. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  852. 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
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  858. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  859. 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
  860. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  861. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  862. 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
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  865. 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
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  971. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  972. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  973. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +788 -641
  974. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  975. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +33 -12
  976. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  977. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  978. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  979. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  980. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  981. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  982. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  983. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  984. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  985. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  986. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  987. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  988. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  989. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  990. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  991. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  992. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  993. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  994. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  995. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  996. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  997. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  998. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  999. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1000. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1001. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1002. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1003. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1004. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1005. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1006. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1007. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1008. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1009. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1010. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1011. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1012. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  1013. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  1014. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1015. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1016. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1017. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1018. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1019. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1020. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1021. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1022. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1023. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1024. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1025. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1026. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1027. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1028. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1029. package/package.json +26 -12
  1030. package/src/AudioBrowser.ts +2 -1
  1031. package/src/CLAUDE.md +57 -0
  1032. package/src/docs-floors.test.ts +71 -0
  1033. package/src/features/battery.test.ts +79 -0
  1034. package/src/features/battery.ts +17 -13
  1035. package/src/features/browser-config.test.ts +21 -6
  1036. package/src/features/browser-config.ts +13 -9
  1037. package/src/features/browser.test.ts +1 -1
  1038. package/src/features/browser.ts +69 -20
  1039. package/src/features/carConnection.ts +3 -4
  1040. package/src/features/equalizer.ts +10 -6
  1041. package/src/features/errors.ts +37 -22
  1042. package/src/features/favorites.ts +29 -24
  1043. package/src/features/gate.ts +30 -9
  1044. package/src/features/hook-wiring.test.ts +302 -0
  1045. package/src/features/metadata.ts +54 -17
  1046. package/src/features/network.ts +6 -2
  1047. package/src/features/nowPlaying.ts +29 -15
  1048. package/src/features/output.ts +10 -5
  1049. package/src/features/playback/controls.ts +13 -6
  1050. package/src/features/playback/playWhenReady.ts +6 -5
  1051. package/src/features/playback/playing.ts +16 -3
  1052. package/src/features/playback/progress.test.ts +169 -0
  1053. package/src/features/playback/progress.ts +13 -6
  1054. package/src/features/playback/rate.ts +8 -1
  1055. package/src/features/playback/state.ts +10 -6
  1056. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  1057. package/src/features/playback/trackPlaybackTime.ts +9 -7
  1058. package/src/features/playback/volume.ts +6 -5
  1059. package/src/features/player/options.ts +83 -82
  1060. package/src/features/player/setup.test.ts +12 -3
  1061. package/src/features/player/setup.ts +123 -64
  1062. package/src/features/player/validateOptions.ts +21 -0
  1063. package/src/features/queue/activeTrack.ts +15 -5
  1064. package/src/features/queue/queue.ts +58 -23
  1065. package/src/features/queue/repeatMode.ts +2 -2
  1066. package/src/features/queue/shuffle.ts +1 -2
  1067. package/src/features/remoteControls.ts +70 -125
  1068. package/src/features/sleepTimer.test.ts +172 -0
  1069. package/src/features/sleepTimer.ts +24 -8
  1070. package/src/nitro-stub-drift.test.ts +277 -0
  1071. package/src/public-surface.test.ts +147 -0
  1072. package/src/specs/audio-browser.nitro.ts +10 -8
  1073. package/src/style-resolution.test.ts +210 -0
  1074. package/src/test-utils/reactNativeStub.ts +60 -0
  1075. package/src/types/browser-native.ts +7 -3
  1076. package/src/types/browser-nodes.ts +417 -151
  1077. package/src/types/browser.ts +248 -177
  1078. package/src/utils/LazyNativeEmitter.ts +25 -15
  1079. package/src/utils/NativeUpdatedValue.ts +29 -12
  1080. package/src/utils/getTrackIdentity.ts +22 -0
  1081. package/src/utils/useDebug.test.ts +182 -0
  1082. package/src/utils/useDebug.ts +16 -3
  1083. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  1084. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  1085. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1086. package/src/web/NativeAudioBrowser.ts +243 -88
  1087. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1088. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1089. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1090. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  1091. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1092. package/src/web/TrackPlayer/Player.ts +284 -37
  1093. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1094. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1095. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1096. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1097. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  1098. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1099. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1100. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1101. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1102. package/src/web/__tests__/retry.test.ts +169 -0
  1103. package/src/web/browser/BrowserManager.ts +209 -111
  1104. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1105. package/src/web/browser/FavoriteManager.ts +28 -23
  1106. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1107. package/src/web/browser/SearchManager.test.ts +75 -0
  1108. package/src/web/browser/SearchManager.ts +25 -28
  1109. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1110. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1111. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1112. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1113. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1114. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1115. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1116. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1117. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1118. package/src/web/browser/parseSearchResponse.ts +3 -4
  1119. package/src/web/browser/sections.test.ts +91 -0
  1120. package/src/web/browser/sections.ts +72 -0
  1121. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1122. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1123. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1124. package/src/web/http/followMediaRedirect.ts +253 -0
  1125. package/src/web/player/NowPlayingManager.ts +4 -3
  1126. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1127. package/src/web/util/BrowserPathHelper.ts +68 -13
  1128. package/website/guide/android-auto.md +126 -0
  1129. package/website/guide/android-certificates.md +488 -0
  1130. package/website/guide/artwork.md +300 -0
  1131. package/website/guide/audio-output.md +357 -0
  1132. package/website/guide/automotive.md +91 -0
  1133. package/website/guide/basic-usage.md +154 -0
  1134. package/website/guide/battery.md +142 -0
  1135. package/website/guide/browser.md +674 -0
  1136. package/website/guide/carplay.md +733 -0
  1137. package/website/guide/configuration.md +215 -0
  1138. package/website/guide/equalizer.md +235 -0
  1139. package/website/guide/errors.md +352 -0
  1140. package/website/guide/favorites.md +164 -0
  1141. package/website/guide/gate.md +157 -0
  1142. package/website/guide/getting-started.md +99 -0
  1143. package/website/guide/hooks.md +244 -0
  1144. package/website/guide/live-streams.md +156 -0
  1145. package/website/guide/metadata.md +273 -0
  1146. package/website/guide/migrating-from-track-player.md +289 -0
  1147. package/website/guide/native-callback-fetch.md +137 -0
  1148. package/website/guide/network.md +102 -0
  1149. package/website/guide/now-playing.md +203 -0
  1150. package/website/guide/playback.md +405 -0
  1151. package/website/guide/queue.md +334 -0
  1152. package/website/guide/remote-controls.md +314 -0
  1153. package/website/guide/search.md +270 -0
  1154. package/website/guide/sleep-timer.md +289 -0
  1155. package/website/guide/track.md +271 -0
  1156. package/ios/Bridge.h +0 -8
  1157. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1158. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1159. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1160. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1161. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1162. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -70
  1163. package/ios/Model/MediaURL.swift +0 -67
  1164. package/ios/Model/SourceType.swift +0 -6
  1165. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1166. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1167. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1168. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1169. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1170. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1171. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1172. package/ios/Option/PitchAlgorithms.swift +0 -17
  1173. package/ios/Option/TimeEventFrequency.swift +0 -18
  1174. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1175. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1176. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1177. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1178. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1179. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1180. package/ios/Player/PlaybackStateStore.swift +0 -27
  1181. package/ios/Player/PlayingStateManager.swift +0 -33
  1182. package/ios/Player/RetryManager.swift +0 -322
  1183. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1184. package/ios/Player/SleepTimerHandling.swift +0 -15
  1185. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1186. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1187. package/ios/Tests/MediaResolveTests.swift +0 -126
  1188. package/ios/Tests/OnceValueTests.swift +0 -79
  1189. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1190. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1191. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1192. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1193. package/ios/Tests/RetryManagerTests.swift +0 -89
  1194. package/ios/TrackPlayer.swift +0 -1014
  1195. package/ios/TrackPlayerCallbacks.swift +0 -86
  1196. package/ios/Util/MetadataAdapter.swift +0 -131
  1197. package/ios/Util/OnceValue.swift +0 -104
  1198. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1199. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1200. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1201. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1202. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1203. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1204. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1205. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1206. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1207. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1208. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1209. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1210. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1211. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -14,34 +14,24 @@ import kotlin.math.pow
14
14
  import timber.log.Timber
15
15
 
16
16
  /**
17
- * Custom LoadErrorHandlingPolicy that retries on recoverable IO errors with exponential backoff.
17
+ * Retries recoverable load errors with exponential backoff, until one of two duration budgets runs
18
+ * out.
18
19
  *
19
- * When a network monitor is provided and the device is offline during a network error, the policy
20
- * will use a shorter retry delay and the network restoration callback can trigger an immediate
21
- * retry when connectivity is restored.
20
+ * A load that has never produced audio ([hasPlayed]) is usually a dead stream, so it gets the short
21
+ * first-connect budget, counted in online time only, so a station tapped while offline still gets
22
+ * its seconds once connectivity returns. Every load is also bounded by the full recovery budget,
23
+ * offline time included. Budgets are kept here, never through
24
+ * [LoadErrorHandlingPolicy.LoadErrorInfo.errorCount]: that counts per loadable (an HLS stream has a
25
+ * playlist and segment loadables, each counted apart), so it cannot bound a load.
22
26
  *
23
- * Two duration budgets apply, chosen by whether the current load has ever produced audio
24
- * ([hasPlayed]): a short first-connect budget — a stream that fails before ever playing is usually
25
- * dead, and the listener is actively waiting for a verdict — and the full recovery budget for a
26
- * stream that played and then dropped (tunnels, handovers, encoder restarts). The short budget
27
- * counts only online time, so a station tapped in a tunnel still gets its online seconds once
28
- * connectivity returns. Both budgets are enforced here at the policy level, never via ExoPlayer's
29
- * [LoadErrorHandlingPolicy.LoadErrorInfo.errorCount] — that counts per *loadable* (an HLS stream
30
- * has playlist and segment loadables, each with its own count), so it cannot express a per-load
31
- * promise.
32
- *
33
- * @param maxRetries Maximum number of retries, or null for infinite retries
34
- * @param maxRetryDurationMs Maximum duration to keep retrying before giving up, or null for default
35
- * (2 minutes)
36
- * @param firstConnectMaxRetryDurationMs Maximum duration to keep retrying a load that has never
37
- * produced audio, while online, or null for default (12 seconds)
38
- * @param shouldRetry Optional callback to check if retry should proceed (e.g., check playWhenReady)
39
- * @param isOnline Optional callback to check current network state
40
- * @param hasPlayed Optional callback: whether the current load has produced audio. Must be safe to
41
- * call from ExoPlayer's loader thread (e.g. backed by a volatile cache).
42
- * @param onRetryPending Optional callback invoked when a retry is pending, with the load error
43
- * being retried (for surfacing it while the retry runs, and for network restoration
44
- * acceleration). Invoked on ExoPlayer's loader thread.
27
+ * @param maxRetries the most retries per loadable; null for no limit
28
+ * @param maxRetryDurationMs the full recovery budget; null for 2 minutes
29
+ * @param firstConnectMaxRetryDurationMs the online budget of a load that has never produced audio;
30
+ * null for 12 seconds
31
+ * @param shouldRetry false gives up at once (e.g. the player is paused)
32
+ * @param hasPlayed whether the current load has produced audio; called on ExoPlayer's loader thread
33
+ * @param onRetryPending called on ExoPlayer's loader thread each time a retry is scheduled, with
34
+ * the error being retried
45
35
  */
46
36
  class RetryLoadErrorHandlingPolicy(
47
37
  private val maxRetries: Int? = null,
@@ -50,64 +40,45 @@ class RetryLoadErrorHandlingPolicy(
50
40
  private val shouldRetry: () -> Boolean = { true },
51
41
  private val isOnline: () -> Boolean = { true },
52
42
  private val hasPlayed: () -> Boolean = { false },
53
- private val onRetryPending: ((exception: IOException, isNetworkError: Boolean) -> Unit)? = null,
43
+ private val onRetryPending: ((exception: IOException) -> Unit)? = null,
54
44
  ) : DefaultLoadErrorHandlingPolicy() {
55
45
 
56
46
  companion object {
57
- private const val INITIAL_RETRY_DELAY_MS = 1000L // 1 second
58
- private const val MAX_RETRY_DELAY_MS = 5000L // 5 seconds cap
47
+ private const val INITIAL_RETRY_DELAY_MS = 1000L
48
+ private const val MAX_RETRY_DELAY_MS = 5000L
59
49
  private const val BACKOFF_MULTIPLIER = 1.5
60
- // When offline, use a short fixed delay instead of exponential backoff.
61
- // ExoPlayer's retry timer can't be interrupted, so we use a short delay to:
62
- // 1. Allow our network restoration callback to trigger immediate retry
63
- // 2. Keep polling in case the callback doesn't fire
50
+ // Fixed while offline, so the first retry after connectivity returns lands soon.
64
51
  private const val OFFLINE_RETRY_DELAY_MS = 1000L
65
- // Default maximum duration to keep retrying before giving up (in milliseconds).
66
- private const val DEFAULT_MAX_RETRY_DURATION_MS = 120_000L // 2 minutes
67
- // Default maximum duration for a load that has never produced audio, while online.
52
+ private const val DEFAULT_MAX_RETRY_DURATION_MS = 120_000L
68
53
  private const val DEFAULT_FIRST_CONNECT_MAX_RETRY_DURATION_MS = 12_000L
69
54
 
70
- // HTTP status codes that are worth retrying
71
- private val RETRYABLE_HTTP_STATUS_CODES =
72
- setOf(
73
- 408, // Request Timeout
74
- 429, // Too Many Requests
75
- 500, // Internal Server Error
76
- 502, // Bad Gateway
77
- 503, // Service Unavailable
78
- 504, // Gateway Timeout
79
- )
55
+ private val RETRYABLE_HTTP_STATUS_CODES = setOf(408, 429, 500, 502, 503, 504)
80
56
  }
81
57
 
82
- // Maximum duration to keep retrying before giving up.
83
- // This prevents surprising playback resumption after long periods offline.
58
+ // Stops playback resuming by surprise after a long time offline.
84
59
  private val maxRetryDurationMs: Long = maxRetryDurationMs ?: DEFAULT_MAX_RETRY_DURATION_MS
85
60
 
86
61
  private val firstConnectMaxRetryDurationMs: Long =
87
62
  firstConnectMaxRetryDurationMs ?: DEFAULT_FIRST_CONNECT_MAX_RETRY_DURATION_MS
88
63
 
89
- // Track when we started retrying to enforce max duration
64
+ // Written on ExoPlayer's loader thread, reset from the main thread.
90
65
  @Volatile private var firstErrorTime: Long? = null
91
66
 
92
- // First error observed while online — the first-connect budget's clock. Never set while
93
- // offline, and wiped by any offline observation, so an offline stretch cannot burn the short
94
- // budget: the clock restarts at the next error observed online.
67
+ // The first-connect budget's clock: set at the first error seen online and wiped by any seen
68
+ // offline, so an offline stretch never burns it.
95
69
  @Volatile private var firstOnlineErrorTime: Long? = null
96
70
 
97
- /** Resets the retry timer. Call when track changes. */
71
+ /** Restarts both budgets: call when a new load begins, or once playback has proven healthy. */
98
72
  fun reset() {
99
73
  firstErrorTime = null
100
74
  firstOnlineErrorTime = null
101
75
  }
102
76
 
103
- /**
104
- * The name of the exhausted budget, or null while budget remains. The recovery duration bounds
105
- * everything (including offline waits); the first-connect duration additionally bounds
106
- * never-played loads, online only.
107
- */
77
+ /** The name of the exhausted budget, or null while both have time left. */
108
78
  private fun exhaustedBudget(currentTime: Long): String? {
109
79
  firstErrorTime?.let { start ->
110
- if (currentTime - start >= maxRetryDurationMs) return "max retry duration ($maxRetryDurationMs ms)"
80
+ if (currentTime - start >= maxRetryDurationMs)
81
+ return "max retry duration ($maxRetryDurationMs ms)"
111
82
  }
112
83
  if (!hasPlayed() && isOnline()) {
113
84
  firstOnlineErrorTime?.let { start ->
@@ -119,9 +90,8 @@ class RetryLoadErrorHandlingPolicy(
119
90
  return null
120
91
  }
121
92
 
122
- /** Calculates exponential backoff delay: 1s -> 1.5s -> 2.3s -> 3.4s -> 5s (capped) */
93
+ /** 1s, 1.5s, 2.25s, ... capped at [MAX_RETRY_DELAY_MS]; [errorCount] is 1-based. */
123
94
  private fun calculateBackoffDelay(errorCount: Int): Long {
124
- // errorCount is 1-based (first error = 1)
125
95
  val exponentialDelay =
126
96
  INITIAL_RETRY_DELAY_MS * BACKOFF_MULTIPLIER.pow((errorCount - 1).toDouble())
127
97
  return min(exponentialDelay.toLong(), MAX_RETRY_DELAY_MS)
@@ -132,52 +102,39 @@ class RetryLoadErrorHandlingPolicy(
132
102
  val errorCount = loadErrorInfo.errorCount
133
103
  val currentTime = System.currentTimeMillis()
134
104
 
135
- // Don't retry if player is paused/stopped (e.g., another app took audio focus)
136
105
  if (!shouldRetry()) {
137
106
  Timber.d("Retry skipped: shouldRetry() returned false (player likely paused)")
138
107
  return C.TIME_UNSET
139
108
  }
140
109
 
141
- // Check if we've exceeded max retries
142
110
  if (maxRetries != null && errorCount > maxRetries) {
143
111
  Timber.d("Max retries ($maxRetries) exceeded, not retrying")
144
112
  return C.TIME_UNSET
145
113
  }
146
114
 
147
- // Track when we started retrying
148
115
  if (firstErrorTime == null) {
149
116
  firstErrorTime = currentTime
150
117
  }
151
118
  if (isOnline()) {
152
119
  if (firstOnlineErrorTime == null) firstOnlineErrorTime = currentTime
153
120
  } else {
154
- // Seeing the device offline restarts the first-connect clock: a station that lost
155
- // connectivity mid-budget gets its full online seconds again after restoration,
156
- // instead of the offline gap counting against it.
157
121
  firstOnlineErrorTime = null
158
122
  }
159
123
 
160
- // Check if we've been retrying too long (prevents surprising resumption after long
161
- // offline periods, and grants dead-on-arrival streams a fast verdict)
162
124
  exhaustedBudget(currentTime)?.let { budget ->
163
125
  Timber.d("$budget exceeded, giving up")
164
126
  return C.TIME_UNSET
165
127
  }
166
128
 
167
- // Classify the error
168
129
  val errorClassification = classifyError(exception)
169
130
 
170
131
  return if (errorClassification.isRecoverable) {
171
- // Check if we're offline during a network error
172
132
  val currentlyOffline = !isOnline()
173
133
  val isNetworkError = errorClassification.isNetworkError
174
134
 
175
135
  val delay =
176
136
  if (currentlyOffline && isNetworkError) {
177
- // Use shorter delay when offline - we'll retry immediately when network comes back
178
- Timber.d(
179
- "Device is offline, using short retry delay (will accelerate when network returns)"
180
- )
137
+ Timber.d("Device is offline, using short retry delay")
181
138
  OFFLINE_RETRY_DELAY_MS
182
139
  } else {
183
140
  calculateBackoffDelay(errorCount)
@@ -187,32 +144,22 @@ class RetryLoadErrorHandlingPolicy(
187
144
  "Retrying after IO error (attempt $errorCount, delay ${delay}ms, offline=$currentlyOffline): ${exception.message}"
188
145
  )
189
146
 
190
- // Notify that a retry is pending (for network restoration acceleration)
191
- onRetryPending?.invoke(exception, isNetworkError)
147
+ onRetryPending?.invoke(exception)
192
148
 
193
149
  delay
194
150
  } else {
195
- // Non-recoverable error: stop now. We can't delegate to super here —
196
- // DefaultLoadErrorHandlingPolicy still schedules a backoff retry for some errors it doesn't
197
- // consider fatal (e.g. a 404 InvalidResponseCodeException), which combined with our infinite
198
- // getMinimumLoadableRetryCount would retry a dead URL until the max-retry-duration timeout.
151
+ // Not super's verdict: it still backs off on some errors it doesn't treat as fatal (a 404),
152
+ // which with the unbounded getMinimumLoadableRetryCount would retry a dead URL for the whole
153
+ // budget.
199
154
  C.TIME_UNSET
200
155
  }
201
156
  }
202
157
 
203
- /** Classification result for an error */
204
158
  private data class ErrorClassification(val isRecoverable: Boolean, val isNetworkError: Boolean)
205
159
 
206
160
  /**
207
- * Classifies whether an error is recoverable and whether it's network-related.
208
- *
209
- * Load errors are delivered as a raw [IOException] (e.g.
210
- * [HttpDataSource.HttpDataSourceException], `UnknownHostException`, `SocketTimeoutException`) —
211
- * never as a `PlaybackException`, which is only surfaced at the player level *after* retries are
212
- * exhausted. So we classify by walking the IOException cause chain. This is essential: a plain
213
- * Wi-Fi drop surfaces as a socket/DNS IOException, and unless we flag it as a network error the
214
- * connectivity-restoration path can't fire an immediate retry, leaving playback stuck buffering
215
- * until it returns.
161
+ * Walks the cause chain: load errors arrive as raw IOExceptions (a Wi-Fi drop is a socket or DNS
162
+ * error), never as a PlaybackException. Anything not known to be fatal counts as a network error.
216
163
  */
217
164
  private fun classifyError(exception: IOException): ErrorClassification {
218
165
  val nonRecoverable = ErrorClassification(isRecoverable = false, isNetworkError = false)
@@ -220,14 +167,11 @@ class RetryLoadErrorHandlingPolicy(
220
167
  var current: Throwable? = exception
221
168
  while (current != null) {
222
169
  when (current) {
223
- // HTTP responses: only retry server errors (5xx) and specific client errors (408, 429).
224
- // Other status codes (e.g. 403/404) will never succeed on retry.
225
170
  is HttpDataSource.InvalidResponseCodeException -> {
226
171
  val retryable = current.responseCode in RETRYABLE_HTTP_STATUS_CODES
227
172
  return ErrorClassification(isRecoverable = retryable, isNetworkError = retryable)
228
173
  }
229
- // Errors that retrying cannot fix — mirror DefaultLoadErrorHandlingPolicy's
230
- // non-retryable set so we don't spin until the max-retry-duration timeout.
174
+ // Mirrors DefaultLoadErrorHandlingPolicy's fatal set.
231
175
  is HttpDataSource.CleartextNotPermittedException,
232
176
  is ParserException,
233
177
  is FileNotFoundException,
@@ -236,20 +180,17 @@ class RetryLoadErrorHandlingPolicy(
236
180
  current = current.cause
237
181
  }
238
182
 
239
- // A read at a position the source can no longer provide (e.g. behind a live window) won't
240
- // recover via an in-place loader retry.
183
+ // A position the source can no longer serve (e.g. behind a live window) won't come back on an
184
+ // in-place retry.
241
185
  if (DataSourceException.isCausedByPositionOutOfRange(exception)) {
242
186
  return nonRecoverable
243
187
  }
244
188
 
245
- // Any other IOException is a transient network/transport failure (connection reset, DNS
246
- // failure, socket timeout, network interface lost, ...): recoverable, and flagged as a network
247
- // error so connectivity restoration can trigger an immediate retry.
248
189
  return ErrorClassification(isRecoverable = true, isNetworkError = true)
249
190
  }
250
191
 
251
192
  override fun getMinimumLoadableRetryCount(dataType: Int): Int {
252
- // Return the max retries, or MAX_VALUE for infinite
193
+ // Unbounded by default: the duration budgets decide when to stop.
253
194
  return maxRetries ?: Int.MAX_VALUE
254
195
  }
255
196
  }
@@ -0,0 +1,24 @@
1
+ package com.audiobrowser.player
2
+
3
+ import androidx.media3.exoplayer.source.ShuffleOrder
4
+ import kotlin.random.Random
5
+
6
+ /**
7
+ * A shuffle order over [count] items with [startIndex] (clamped into range) at shuffle position 0
8
+ * and the rest in random order. [random] only seeds the order's later reshuffles on insert.
9
+ *
10
+ * Media3 discards the start index: `ShuffleOrder.cloneAndSet(insertionCount, startIndex)` defaults
11
+ * to `cloneAndClear().cloneAndInsert(0, insertionCount)` and `DefaultShuffleOrder` does not
12
+ * override it, so with shuffle on the starting track lands at a random position, and when it lands
13
+ * last the queue ends after its first track. Apply it whether or not shuffle is on: enabling
14
+ * shuffle later does not regenerate the order.
15
+ */
16
+ internal fun shuffleOrderLedBy(startIndex: Int, count: Int, random: Random = Random): ShuffleOrder {
17
+ val first = startIndex.coerceIn(0, (count - 1).coerceAtLeast(0))
18
+ val indices = IntArray(count)
19
+ if (count > 0) {
20
+ indices[0] = first
21
+ ((0 until count) - first).shuffled().forEachIndexed { i, index -> indices[i + 1] = index }
22
+ }
23
+ return ShuffleOrder.DefaultShuffleOrder(indices, random.nextLong())
24
+ }
@@ -4,13 +4,11 @@ import android.os.Handler
4
4
  import android.os.Looper
5
5
 
6
6
  /**
7
- * Manages a sleep timer that calls a completion callback after a specified duration.
8
- *
9
- * The timer stores the expiration time as a timestamp and uses a Handler to schedule the completion
10
- * callback. Supports both time-based and end-of-track modes, plus an optional fade-out that starts
11
- * `fadeDuration` seconds before the deadline so silence lands exactly when the timer completes.
7
+ * A sleep timer whose hooks run on the main looper: [onComplete] at the deadline, and with a fade,
8
+ * [onFadeStart] early enough that the fade ends at the deadline. Subclass it to act on the hooks.
12
9
  */
13
10
  open class SleepTimer {
11
+ // Deadline in epoch milliseconds; null when idle or in end-of-track mode.
14
12
  var time: Double? = null
15
13
  private set
16
14
 
@@ -25,10 +23,8 @@ open class SleepTimer {
25
23
  get() = time != null || sleepWhenPlayedToEnd
26
24
 
27
25
  /**
28
- * Sets a timer to complete after the specified number of seconds.
29
- *
30
- * @param seconds Number of seconds until the timer completes
31
- * @param fadeDuration Seconds over which to fade out before completion; clamped to [seconds]
26
+ * Completes after [seconds], replacing any armed timer. [fadeDuration] seconds is clamped to
27
+ * [seconds]; null or non-positive means no fade.
32
28
  */
33
29
  fun sleepAfter(seconds: Double, fadeDuration: Double? = null) {
34
30
  stopTimer()
@@ -52,8 +48,8 @@ open class SleepTimer {
52
48
  }
53
49
 
54
50
  /**
55
- * Sets the timer to complete when the current track finishes playing. Note: The actual completion
56
- * logic must be handled by the caller when the track ends.
51
+ * Arms end-of-track mode, replacing any armed timer. The timer never completes this mode itself:
52
+ * the caller acts when the track ends and calls [clear].
57
53
  */
58
54
  fun sleepWhenPlayedToEnd() {
59
55
  stopTimer()
@@ -62,11 +58,7 @@ open class SleepTimer {
62
58
  sleepWhenPlayedToEnd = true
63
59
  }
64
60
 
65
- /**
66
- * Clears the active timer.
67
- *
68
- * @return true if a timer was running and was cleared, false otherwise
69
- */
61
+ /** Disarms the timer; returns whether one was armed. */
70
62
  fun clear(): Boolean {
71
63
  val wasRunning = isRunning
72
64
  stopTimer()
@@ -76,25 +68,16 @@ open class SleepTimer {
76
68
  return wasRunning
77
69
  }
78
70
 
79
- /** Override this method to handle timer completion. */
80
- open fun onComplete() {
81
- // Default implementation does nothing - override in subclass
82
- }
71
+ open fun onComplete() {}
83
72
 
84
- /** Override to begin fading the volume; the timer still completes at its deadline. */
85
- open fun onFadeStart(durationSeconds: Double) {
86
- // Default implementation does nothing - override in subclass
87
- }
73
+ open fun onFadeStart(durationSeconds: Double) {}
88
74
 
89
- /** Override to handle a fade cancelled before completion — restore the volume. */
90
- open fun onFadeCancel() {
91
- // Default implementation does nothing - override in subclass
92
- }
75
+ /** Called on every re-arm or clear, whether or not a fade is running; not on completion. */
76
+ open fun onFadeCancel() {}
93
77
 
94
78
  private fun complete() {
95
79
  if (!isRunning) return
96
- // Tear down without onFadeCancel: completion pauses first, then the completion handler
97
- // restores the volume.
80
+ // No onFadeCancel: onComplete pauses first, then restores the volume itself.
98
81
  stopTimer()
99
82
  time = null
100
83
  sleepWhenPlayedToEnd = false
@@ -7,11 +7,9 @@ import com.margelo.nitro.core.NullType
7
7
  import timber.log.Timber
8
8
 
9
9
  /**
10
- * Owns the Sleep Timer's interplay with the volume fade and its JS event emission: the timer counts
11
- * down natively (the webview may be asleep), an optional fade finishes exactly at the deadline, and
12
- * completion pauses — never stops — with the pre-fade volume restored so a half-asleep listener can
13
- * resume at full volume. Mirrors iOS's SleepTimerManager. [pause] is the player's pause;
14
- * [onChanged] emits onSleepTimerChanged.
10
+ * Runs the sleep timer's volume fade and emits each state change through [onChanged]. Completion
11
+ * pauses rather than stops, and restores the pre-fade volume so the listener resumes at full
12
+ * volume. Mirrors iOS's SleepTimerManager.
15
13
  */
16
14
  internal class SleepTimerManager(
17
15
  private val volumeFader: VolumeFader,
@@ -38,7 +36,6 @@ internal class SleepTimerManager(
38
36
 
39
37
  private fun none(): NitroSleepTimer = NitroSleepTimer.create(NullType.NULL)
40
38
 
41
- /** The current state: a time-based deadline, end-of-track, or none. */
42
39
  fun get(): NitroSleepTimer =
43
40
  when {
44
41
  timer.time != null -> NitroSleepTimer.create(SleepTimerTime(timer.time!!))
@@ -47,28 +44,27 @@ internal class SleepTimerManager(
47
44
  }
48
45
 
49
46
  /**
50
- * Pauses playback after [seconds], optionally fading out over the last [fadeDuration] seconds
51
- * (clamped to [seconds]).
47
+ * Pauses after [seconds]. A [fadeDuration] (seconds) fades out over the last part of that
48
+ * interval, clamped to [seconds].
52
49
  */
53
50
  fun setAfter(seconds: Double, fadeDuration: Double? = null) {
54
51
  timer.sleepAfter(seconds, fadeDuration)
55
52
  onChanged(get())
56
53
  }
57
54
 
58
- /** Pauses playback when the current track finishes playing. */
59
55
  fun setEndOfTrack() {
60
56
  timer.sleepWhenPlayedToEnd()
61
57
  onChanged(get())
62
58
  }
63
59
 
64
- /** Clears the active timer. @return true when a timer was actually cleared. */
60
+ /** @return true when a timer was armed and is now cleared. */
65
61
  fun clear(): Boolean {
66
62
  val wasRunning = timer.clear()
67
63
  if (wasRunning) onChanged(none())
68
64
  return wasRunning
69
65
  }
70
66
 
71
- /** Pauses when an end-of-track sleep is armed; called when a track finishes naturally. */
67
+ /** Call when a track plays to its end; pauses only if an end-of-track sleep is armed. */
72
68
  fun onTrackEnd() {
73
69
  if (timer.sleepWhenPlayedToEnd) {
74
70
  Timber.d("Sleep timer triggered on track end, pausing playback")
@@ -1,22 +1,13 @@
1
1
  package com.audiobrowser.player
2
2
 
3
3
  /**
4
- * Caps how many times the player auto-recovers from a media3
5
- * [androidx.media3.common.util.StuckPlayerException] before surfacing a terminal error.
4
+ * Caps how often the player recovers from a media3
5
+ * [androidx.media3.common.util.StuckPlayerException] before it surfaces a terminal error. Once the
6
+ * cap is passed, every call gives up until [reset], so a dead stream yields one error instead of a
7
+ * recover/error sawtooth.
6
8
  *
7
- * media3 1.9.0 detects a stuck player and reports it through Player.Listener.onPlayerError. We
8
- * recover (re-prepare / rejoin live edge) rather than going to ERROR, because for a live-radio app
9
- * a transient stall should reconnect, not stop playback. But a genuinely dead stream would re-fire
10
- * forever, so we allow at most [maxRecoveries] recoveries. The budget refills only when the caller
11
- * has proof the stream is alive (sustained playback) or on a track change — both via [reset]. Once
12
- * the cap is exceeded the decision stays [Decision.GIVE_UP] (it does not self-refill), so a dead
13
- * stream produces one clean terminal error instead of a recover/error sawtooth.
14
- *
15
- * Deliberately holds no clock or time-window: a time-window keyed on recovery timing lets a stream
16
- * that re-stalls just outside the window recover indefinitely. "Is it alive?" is answered by the
17
- * caller from actual playback progress, not elapsed time.
18
- *
19
- * @param maxRecoveries Maximum recoveries allowed before giving up.
9
+ * It holds no time window on purpose: a stream that re-stalls just outside one would recover
10
+ * forever. Whether the stream is alive is the caller's call, from playback progress.
20
11
  */
21
12
  class StuckRecoveryPolicy(private val maxRecoveries: Int = DEFAULT_MAX_RECOVERIES) {
22
13
  enum class Decision {
@@ -27,19 +18,15 @@ class StuckRecoveryPolicy(private val maxRecoveries: Int = DEFAULT_MAX_RECOVERIE
27
18
  private var recoveryCount = 0
28
19
 
29
20
  /**
30
- * Records a stuck event and decides what to do. [Decision.RECOVER] means the caller should
31
- * re-prepare; [Decision.GIVE_UP] means recovery is exhausted and the caller should surface a
32
- * terminal error. Stays [Decision.GIVE_UP] until [reset] is called.
21
+ * Records a stuck event. [Decision.RECOVER] for the first [maxRecoveries] calls, then
22
+ * [Decision.GIVE_UP] until [reset].
33
23
  */
34
24
  fun onStuck(): Decision {
35
25
  recoveryCount++
36
26
  return if (recoveryCount > maxRecoveries) Decision.GIVE_UP else Decision.RECOVER
37
27
  }
38
28
 
39
- /**
40
- * Refills the recovery budget. Call on proof the stream is alive (sustained playback) or on a
41
- * track change.
42
- */
29
+ /** Refills the budget. Call on sustained playback or a track change. */
43
30
  fun reset() {
44
31
  recoveryCount = 0
45
32
  }