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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1037) hide show
  1. package/README.md +37 -23
  2. package/android/build.gradle +43 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/main/AndroidManifest.xml +3 -1
  5. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +550 -283
  6. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +38 -0
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +18 -2
  8. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +131 -0
  9. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +128 -0
  10. package/android/src/main/java/com/audiobrowser/Service.kt +41 -11
  11. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  12. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +23 -10
  13. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  14. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  15. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  16. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  17. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  18. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  19. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  20. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  21. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  22. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  23. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  24. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  25. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  26. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +7 -0
  27. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +1 -1
  28. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  29. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  30. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  31. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +639 -278
  32. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +85 -33
  33. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +88 -44
  34. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  35. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  36. package/android/src/main/java/com/audiobrowser/player/Player.kt +180 -84
  37. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  38. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  39. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +16 -4
  40. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  41. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  42. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  43. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  44. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  45. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  46. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  47. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  48. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  49. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +15 -0
  50. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +61 -40
  51. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  52. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +5 -1
  53. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +24 -49
  54. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +22 -1
  55. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  56. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +2 -2
  57. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  58. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +103 -67
  59. package/android/src/main/res/values/strings.xml +25 -5
  60. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  61. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  62. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +22 -0
  63. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  64. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +159 -0
  65. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  66. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  67. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  68. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  69. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  70. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  71. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  72. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  73. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  74. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  75. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  76. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  77. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  78. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +477 -0
  79. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +1 -2
  80. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  81. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  82. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +138 -0
  83. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  84. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +212 -2
  85. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  86. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  87. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  88. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +67 -0
  89. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  90. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +192 -0
  91. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  92. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  93. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +151 -0
  94. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  95. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  96. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  97. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  98. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  99. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  100. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  101. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +95 -0
  102. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  103. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  104. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  105. package/ios/AVPlayerEngine.swift +362 -0
  106. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  107. package/ios/Browser/BrowseGate.swift +58 -0
  108. package/ios/Browser/BrowserConfig.swift +115 -81
  109. package/ios/Browser/BrowserError.swift +16 -0
  110. package/ios/Browser/BrowserManager.swift +155 -654
  111. package/ios/Browser/BrowserPathHelper.swift +68 -51
  112. package/ios/Browser/FavoriteSet.swift +46 -0
  113. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  114. package/ios/Browser/JsonModels.swift +270 -321
  115. package/ios/Browser/NavigationErrorState.swift +41 -0
  116. package/ios/Browser/PageResolver.swift +147 -0
  117. package/ios/Browser/RequestLayer.swift +185 -0
  118. package/ios/Browser/RequestPipeline.swift +303 -0
  119. package/ios/Browser/SearchDrillIn.swift +7 -7
  120. package/ios/Browser/SectionScope.swift +82 -23
  121. package/ios/Browser/SimpleRouter.swift +73 -144
  122. package/ios/Browser/StyleResolver.swift +58 -0
  123. package/ios/Browser/TabBarEntries.swift +9 -3
  124. package/ios/Browser/TrackIdTemplate.swift +37 -0
  125. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  126. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  127. package/ios/CarPlay/CarPlayController.swift +37 -1297
  128. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  129. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  130. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  131. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  132. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  133. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  134. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  135. package/ios/CarPlay/CarPlaySession.swift +207 -0
  136. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  137. package/ios/CarPlay/IntentHandlers.swift +96 -0
  138. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  139. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  140. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  141. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  142. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  143. package/ios/CarPlay/SectionPresentation.swift +77 -0
  144. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  145. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  146. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  147. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  148. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  149. package/ios/Extension/SearchParams+Query.swift +28 -0
  150. package/ios/Extension/Section+Copying.swift +29 -0
  151. package/ios/Extension/String+IcyCharset.swift +21 -0
  152. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  153. package/ios/Extension/Track+AVPlayer.swift +0 -16
  154. package/ios/Extension/Track+Copying.swift +11 -13
  155. package/ios/Extension/Track+Identity.swift +25 -0
  156. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  157. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  158. package/ios/Extension/URLError+Connectivity.swift +15 -0
  159. package/ios/Http/HttpClient.swift +71 -165
  160. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  161. package/ios/HybridAudioBrowser+Options.swift +105 -0
  162. package/ios/HybridAudioBrowser+Player.swift +341 -0
  163. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  164. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  165. package/ios/HybridAudioBrowser.swift +131 -1652
  166. package/ios/Model/NitroTypeStubs.swift +239 -24
  167. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  168. package/ios/Model/RemoteCommand.swift +6 -60
  169. package/ios/Model/TrackPlayerError.swift +6 -2
  170. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  171. package/ios/Observer/ItemObserver.swift +90 -0
  172. package/ios/Observer/PlayerObserver.swift +59 -0
  173. package/ios/Option/SessionCategories.swift +42 -92
  174. package/ios/Player/AudioSessionController.swift +191 -0
  175. package/ios/Player/DeferredSeek.swift +70 -0
  176. package/ios/Player/ErrorStatus.swift +50 -0
  177. package/ios/Player/MediaLoader.swift +66 -87
  178. package/ios/Player/NowPlayingLines.swift +52 -0
  179. package/ios/Player/NowPlayingUpdater.swift +182 -85
  180. package/ios/Player/PlaybackFailure.swift +125 -0
  181. package/ios/Player/PlaybackPersistence.swift +73 -0
  182. package/ios/Player/PlaybackTimer.swift +8 -2
  183. package/ios/Player/Player.swift +975 -0
  184. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  185. package/ios/Player/PlayerEngine.swift +104 -0
  186. package/ios/Player/PlayerStatusTypes.swift +2 -6
  187. package/ios/Player/QueueManager.swift +93 -67
  188. package/ios/Player/RetryLoop.swift +291 -0
  189. package/ios/Player/ShuffleOrder.swift +33 -0
  190. package/ios/Player/SleepTimerManager.swift +14 -16
  191. package/ios/Player/VolumeFader.swift +5 -0
  192. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  193. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  194. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  195. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  196. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  197. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  198. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  199. package/ios/Tests/DeferredSeekTests.swift +70 -0
  200. package/ios/Tests/EmitterTests.swift +22 -38
  201. package/ios/Tests/ErrorStatusTests.swift +50 -0
  202. package/ios/Tests/FavoriteSetTests.swift +60 -0
  203. package/ios/Tests/GenerationMemoTests.swift +121 -0
  204. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  205. package/ios/Tests/JsonModelsTests.swift +194 -1
  206. package/ios/Tests/LRUCacheTests.swift +110 -0
  207. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  208. package/ios/Tests/MediaLoaderTests.swift +36 -67
  209. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  210. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  211. package/ios/Tests/ObserverTests.swift +88 -0
  212. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  213. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  214. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  215. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  216. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  217. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +573 -395
  218. package/ios/Tests/PlayingStateTests.swift +42 -0
  219. package/ios/Tests/QueueManagerTests.swift +196 -115
  220. package/ios/Tests/ReadyValueTests.swift +73 -0
  221. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  222. package/ios/Tests/RequestLayerTests.swift +228 -0
  223. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  224. package/ios/Tests/RetryLoopTests.swift +305 -0
  225. package/ios/Tests/SearchDrillInTests.swift +16 -16
  226. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  227. package/ios/Tests/SectionPresentationTests.swift +98 -0
  228. package/ios/Tests/SectionScopeTests.swift +139 -54
  229. package/ios/Tests/SimpleRouterTests.swift +38 -3
  230. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  231. package/ios/Tests/StyleResolverTests.swift +132 -0
  232. package/ios/Tests/Support/TestTypes.swift +146 -101
  233. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  234. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  235. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  236. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  237. package/ios/Tests/TrackIdentityTests.swift +20 -0
  238. package/ios/Tests/TrackSelectorTests.swift +168 -33
  239. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  240. package/ios/TrackSelector.swift +62 -65
  241. package/ios/Util/ArtworkFreshness.swift +42 -0
  242. package/ios/Util/ArtworkImageFetcher.swift +143 -5
  243. package/ios/Util/ConcurrentMap.swift +19 -0
  244. package/ios/Util/Emitter.swift +40 -12
  245. package/ios/Util/GenerationMemo.swift +36 -0
  246. package/ios/Util/LRUCache.swift +23 -159
  247. package/ios/Util/NetworkMonitor.swift +32 -32
  248. package/ios/Util/OutputPicker.swift +48 -0
  249. package/ios/Util/ReadyValue.swift +56 -0
  250. package/ios/Util/SFSymbolRenderer.swift +59 -31
  251. package/ios/Util/SVGProcessor.swift +9 -12
  252. package/lib/commonjs/AudioBrowser.js +8 -8
  253. package/lib/commonjs/AudioBrowser.js.map +1 -1
  254. package/lib/commonjs/CLAUDE.md +52 -0
  255. package/lib/commonjs/features/browser-config.js +12 -8
  256. package/lib/commonjs/features/browser-config.js.map +1 -1
  257. package/lib/commonjs/features/browser.js +11 -3
  258. package/lib/commonjs/features/browser.js.map +1 -1
  259. package/lib/commonjs/features/carConnection.js +1 -1
  260. package/lib/commonjs/features/equalizer.js +1 -1
  261. package/lib/commonjs/features/errors.js +3 -3
  262. package/lib/commonjs/features/favorites.js +14 -11
  263. package/lib/commonjs/features/favorites.js.map +1 -1
  264. package/lib/commonjs/features/gate.js +16 -1
  265. package/lib/commonjs/features/gate.js.map +1 -1
  266. package/lib/commonjs/features/metadata.js +20 -3
  267. package/lib/commonjs/features/metadata.js.map +1 -1
  268. package/lib/commonjs/features/network.js +1 -1
  269. package/lib/commonjs/features/nowPlaying.js +1 -1
  270. package/lib/commonjs/features/output.js +4 -3
  271. package/lib/commonjs/features/output.js.map +1 -1
  272. package/lib/commonjs/features/playback/controls.js +4 -2
  273. package/lib/commonjs/features/playback/controls.js.map +1 -1
  274. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  275. package/lib/commonjs/features/playback/playing.js +1 -1
  276. package/lib/commonjs/features/playback/progress.js +3 -2
  277. package/lib/commonjs/features/playback/progress.js.map +1 -1
  278. package/lib/commonjs/features/playback/rate.js +8 -1
  279. package/lib/commonjs/features/playback/rate.js.map +1 -1
  280. package/lib/commonjs/features/playback/state.js +3 -4
  281. package/lib/commonjs/features/playback/state.js.map +1 -1
  282. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  283. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  284. package/lib/commonjs/features/playback/volume.js +1 -1
  285. package/lib/commonjs/features/player/options.js +3 -19
  286. package/lib/commonjs/features/player/options.js.map +1 -1
  287. package/lib/commonjs/features/player/setup.js +5 -3
  288. package/lib/commonjs/features/player/setup.js.map +1 -1
  289. package/lib/commonjs/features/player/validateOptions.js +23 -0
  290. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  291. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  292. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  293. package/lib/commonjs/features/queue/queue.js +13 -6
  294. package/lib/commonjs/features/queue/queue.js.map +1 -1
  295. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  296. package/lib/commonjs/features/queue/shuffle.js +1 -1
  297. package/lib/commonjs/features/remoteControls.js +13 -92
  298. package/lib/commonjs/features/remoteControls.js.map +1 -1
  299. package/lib/commonjs/features/sleepTimer.js +13 -1
  300. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  301. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  302. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  303. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  304. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  305. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  306. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  307. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  308. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  309. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  310. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  311. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  312. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  313. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  314. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  315. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  316. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  317. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  318. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  319. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  320. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  321. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  322. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  323. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  324. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  325. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  326. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  327. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  328. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  329. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  330. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  331. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  332. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  333. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  334. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  335. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  336. package/lib/commonjs/web/browser/sections.js +89 -0
  337. package/lib/commonjs/web/browser/sections.js.map +1 -0
  338. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  339. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  340. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  341. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  342. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  343. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  344. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  345. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  346. package/lib/module/AudioBrowser.js +2 -1
  347. package/lib/module/AudioBrowser.js.map +1 -1
  348. package/lib/module/CLAUDE.md +52 -0
  349. package/lib/module/features/browser-config.js +12 -8
  350. package/lib/module/features/browser-config.js.map +1 -1
  351. package/lib/module/features/browser.js +11 -3
  352. package/lib/module/features/browser.js.map +1 -1
  353. package/lib/module/features/carConnection.js +1 -1
  354. package/lib/module/features/equalizer.js +1 -1
  355. package/lib/module/features/errors.js +3 -3
  356. package/lib/module/features/favorites.js +14 -11
  357. package/lib/module/features/favorites.js.map +1 -1
  358. package/lib/module/features/gate.js +16 -1
  359. package/lib/module/features/gate.js.map +1 -1
  360. package/lib/module/features/metadata.js +20 -3
  361. package/lib/module/features/metadata.js.map +1 -1
  362. package/lib/module/features/network.js +1 -1
  363. package/lib/module/features/nowPlaying.js +1 -1
  364. package/lib/module/features/output.js +4 -3
  365. package/lib/module/features/output.js.map +1 -1
  366. package/lib/module/features/playback/controls.js +4 -2
  367. package/lib/module/features/playback/controls.js.map +1 -1
  368. package/lib/module/features/playback/playWhenReady.js +1 -1
  369. package/lib/module/features/playback/playing.js +1 -1
  370. package/lib/module/features/playback/progress.js +3 -2
  371. package/lib/module/features/playback/progress.js.map +1 -1
  372. package/lib/module/features/playback/rate.js +8 -1
  373. package/lib/module/features/playback/rate.js.map +1 -1
  374. package/lib/module/features/playback/state.js +3 -4
  375. package/lib/module/features/playback/state.js.map +1 -1
  376. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  377. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  378. package/lib/module/features/playback/volume.js +1 -1
  379. package/lib/module/features/player/options.js +2 -17
  380. package/lib/module/features/player/options.js.map +1 -1
  381. package/lib/module/features/player/setup.js +4 -2
  382. package/lib/module/features/player/setup.js.map +1 -1
  383. package/lib/module/features/player/validateOptions.js +19 -0
  384. package/lib/module/features/player/validateOptions.js.map +1 -0
  385. package/lib/module/features/queue/activeTrack.js +15 -4
  386. package/lib/module/features/queue/activeTrack.js.map +1 -1
  387. package/lib/module/features/queue/queue.js +13 -6
  388. package/lib/module/features/queue/queue.js.map +1 -1
  389. package/lib/module/features/queue/repeatMode.js +1 -1
  390. package/lib/module/features/queue/shuffle.js +1 -1
  391. package/lib/module/features/remoteControls.js +13 -92
  392. package/lib/module/features/remoteControls.js.map +1 -1
  393. package/lib/module/features/sleepTimer.js +13 -1
  394. package/lib/module/features/sleepTimer.js.map +1 -1
  395. package/lib/module/test-utils/reactNativeStub.js +58 -0
  396. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  397. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  398. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  399. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  400. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  401. package/lib/module/utils/getTrackIdentity.js +20 -0
  402. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  403. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  404. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  405. package/lib/module/web/NativeAudioBrowser.js +202 -77
  406. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  407. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  408. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  409. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  410. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  411. package/lib/module/web/TrackPlayer/Player.js +254 -39
  412. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  413. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  414. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  415. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  416. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  417. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  418. package/lib/module/web/browser/BrowserManager.js +175 -100
  419. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  420. package/lib/module/web/browser/FavoriteManager.js +31 -21
  421. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  422. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  423. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  424. package/lib/module/web/browser/SearchManager.js +18 -23
  425. package/lib/module/web/browser/SearchManager.js.map +1 -1
  426. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  427. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  428. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  429. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  430. package/lib/module/web/browser/sections.js +83 -0
  431. package/lib/module/web/browser/sections.js.map +1 -0
  432. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  433. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  434. package/lib/module/web/http/followMediaRedirect.js +215 -0
  435. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  436. package/lib/module/web/player/NowPlayingManager.js +4 -3
  437. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  438. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  439. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  440. package/lib/typescript/package.json +1 -0
  441. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  442. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  443. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  444. package/lib/typescript/src/features/browser.d.ts +10 -2
  445. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  446. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  447. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  448. package/lib/typescript/src/features/errors.d.ts +3 -3
  449. package/lib/typescript/src/features/favorites.d.ts +14 -11
  450. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  451. package/lib/typescript/src/features/gate.d.ts +18 -2
  452. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  453. package/lib/typescript/src/features/metadata.d.ts +20 -3
  454. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  455. package/lib/typescript/src/features/network.d.ts +1 -1
  456. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  457. package/lib/typescript/src/features/output.d.ts +4 -3
  458. package/lib/typescript/src/features/output.d.ts.map +1 -1
  459. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  460. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  461. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  462. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  463. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  464. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  465. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  466. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  467. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  468. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  469. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  470. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  471. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  472. package/lib/typescript/src/features/player/options.d.ts +24 -21
  473. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  474. package/lib/typescript/src/features/player/setup.d.ts +16 -1
  475. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  476. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  477. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  478. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  479. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  480. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  481. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  482. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  483. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  484. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  485. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  486. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  487. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  488. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  489. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  490. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  491. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  492. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  493. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  494. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  495. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  496. package/lib/typescript/src/types/browser.d.ts +93 -61
  497. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  498. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  499. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  500. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  501. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  502. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  503. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  504. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  505. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  506. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  507. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  508. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  509. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  510. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  511. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  512. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  513. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  514. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  515. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  516. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  517. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  518. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  519. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  520. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  521. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  522. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  523. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  524. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  525. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  526. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  527. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  528. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  529. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  530. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  531. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  532. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  533. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  534. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  535. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  536. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  537. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  538. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  539. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  540. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  541. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  542. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  543. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  544. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  545. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  546. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  547. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  548. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  549. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  550. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  551. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  552. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  553. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  554. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  555. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  556. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  557. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  558. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  559. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  560. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  561. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  564. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  565. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  566. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  567. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  568. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  572. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  573. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  574. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  575. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  576. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  577. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  578. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  579. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  581. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  582. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  583. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  584. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  585. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  586. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  587. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  588. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  589. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +68 -44
  590. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  591. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  592. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  593. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  594. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  595. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  596. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  597. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  598. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  599. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  600. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  602. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  605. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  607. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  608. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +19 -12
  609. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  610. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  611. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  612. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  613. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  616. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  619. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JOutputType.hpp +5 -2
  621. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  622. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  623. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  625. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  626. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  627. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  628. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  630. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  631. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  632. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  633. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  634. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  635. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  637. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  638. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  639. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  640. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  641. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  642. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  643. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  644. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  645. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  646. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  647. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  648. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  649. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  650. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  651. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  652. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  653. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  654. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  655. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  656. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  657. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  658. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  659. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  660. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  661. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  662. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  663. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  664. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  665. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  666. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  667. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  668. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  669. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  670. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  671. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  672. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  673. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  674. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  675. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  676. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  677. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  678. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  679. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  680. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  681. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  682. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  683. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  684. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  685. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  686. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  687. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  688. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  689. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  690. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  691. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  692. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  693. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  694. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  695. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  696. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  697. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  698. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  699. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  700. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  701. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  702. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  703. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  704. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  705. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  706. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  707. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  708. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  709. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  710. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  711. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  712. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  713. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  714. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  715. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  716. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  717. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  718. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  719. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  739. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  746. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  749. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  752. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +2 -1
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  782. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  783. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  784. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  785. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  786. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  787. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  788. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  789. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  790. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  791. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  792. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  793. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  794. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  795. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  796. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  797. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  798. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  799. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  800. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  801. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  802. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  803. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  804. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  805. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  806. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  807. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +767 -638
  808. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +28 -10
  809. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +30 -12
  810. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  811. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  812. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  813. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  814. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  815. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  816. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  817. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  818. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  819. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  820. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  821. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  822. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +19 -1
  823. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  824. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  825. package/nitrogen/generated/ios/swift/OutputType.swift +4 -0
  826. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  827. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  828. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  829. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  830. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  831. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  832. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  833. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  834. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  835. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  836. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  837. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  838. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  839. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  840. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  841. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  842. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  843. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  844. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  845. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  846. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  847. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  848. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  849. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  850. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +6 -2
  851. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  852. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  853. package/nitrogen/generated/shared/c++/OutputType.hpp +5 -1
  854. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  855. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  856. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  857. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  858. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  859. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  860. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  861. package/package.json +24 -11
  862. package/src/AudioBrowser.ts +2 -1
  863. package/src/CLAUDE.md +52 -0
  864. package/src/features/battery.test.ts +79 -0
  865. package/src/features/browser-config.test.ts +21 -6
  866. package/src/features/browser-config.ts +12 -8
  867. package/src/features/browser.test.ts +1 -1
  868. package/src/features/browser.ts +11 -3
  869. package/src/features/carConnection.ts +1 -1
  870. package/src/features/equalizer.ts +1 -1
  871. package/src/features/errors.ts +3 -3
  872. package/src/features/favorites.ts +14 -11
  873. package/src/features/gate.ts +16 -1
  874. package/src/features/hook-wiring.test.ts +302 -0
  875. package/src/features/metadata.ts +20 -3
  876. package/src/features/network.ts +1 -1
  877. package/src/features/nowPlaying.ts +1 -1
  878. package/src/features/output.ts +4 -3
  879. package/src/features/playback/controls.ts +4 -2
  880. package/src/features/playback/playWhenReady.ts +1 -1
  881. package/src/features/playback/playing.ts +1 -1
  882. package/src/features/playback/progress.test.ts +169 -0
  883. package/src/features/playback/progress.ts +3 -2
  884. package/src/features/playback/rate.ts +8 -1
  885. package/src/features/playback/state.ts +3 -4
  886. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  887. package/src/features/playback/trackPlaybackTime.ts +1 -6
  888. package/src/features/playback/volume.ts +1 -1
  889. package/src/features/player/options.ts +31 -40
  890. package/src/features/player/setup.test.ts +12 -3
  891. package/src/features/player/setup.ts +27 -5
  892. package/src/features/player/validateOptions.ts +21 -0
  893. package/src/features/queue/activeTrack.ts +15 -4
  894. package/src/features/queue/queue.ts +13 -6
  895. package/src/features/queue/repeatMode.ts +1 -1
  896. package/src/features/queue/shuffle.ts +1 -1
  897. package/src/features/remoteControls.ts +13 -92
  898. package/src/features/sleepTimer.test.ts +172 -0
  899. package/src/features/sleepTimer.ts +9 -1
  900. package/src/nitro-stub-drift.test.ts +277 -0
  901. package/src/public-surface.test.ts +147 -0
  902. package/src/specs/audio-browser.nitro.ts +9 -8
  903. package/src/style-resolution.test.ts +210 -0
  904. package/src/test-utils/reactNativeStub.ts +60 -0
  905. package/src/types/browser-native.ts +7 -3
  906. package/src/types/browser-nodes.ts +403 -134
  907. package/src/types/browser.ts +97 -63
  908. package/src/utils/LazyNativeEmitter.ts +28 -15
  909. package/src/utils/NativeUpdatedValue.ts +29 -13
  910. package/src/utils/getTrackIdentity.ts +20 -0
  911. package/src/utils/useDebug.test.ts +182 -0
  912. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  913. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  914. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  915. package/src/web/NativeAudioBrowser.ts +241 -84
  916. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  917. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  918. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  919. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  920. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  921. package/src/web/TrackPlayer/Player.ts +284 -37
  922. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  923. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  924. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  925. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  926. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  927. package/src/web/__tests__/lifecycle.test.ts +345 -0
  928. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  929. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  930. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  931. package/src/web/__tests__/retry.test.ts +169 -0
  932. package/src/web/browser/BrowserManager.ts +209 -111
  933. package/src/web/browser/FavoriteManager.test.ts +84 -0
  934. package/src/web/browser/FavoriteManager.ts +28 -23
  935. package/src/web/browser/NavigationErrorManager.ts +3 -1
  936. package/src/web/browser/SearchManager.test.ts +75 -0
  937. package/src/web/browser/SearchManager.ts +25 -28
  938. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  939. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  940. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  941. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  942. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  943. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  944. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  945. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  946. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  947. package/src/web/browser/sections.test.ts +91 -0
  948. package/src/web/browser/sections.ts +72 -0
  949. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  950. package/src/web/http/RequestConfigBuilder.ts +140 -33
  951. package/src/web/http/followMediaRedirect.test.ts +289 -0
  952. package/src/web/http/followMediaRedirect.ts +253 -0
  953. package/src/web/player/NowPlayingManager.ts +4 -3
  954. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  955. package/src/web/util/BrowserPathHelper.ts +70 -13
  956. package/website/guide/android-auto.md +114 -0
  957. package/website/guide/android-certificates.md +409 -0
  958. package/website/guide/artwork.md +255 -0
  959. package/website/guide/audio-output.md +158 -0
  960. package/website/guide/automotive.md +86 -0
  961. package/website/guide/basic-usage.md +151 -0
  962. package/website/guide/battery.md +115 -0
  963. package/website/guide/browser.md +587 -0
  964. package/website/guide/carplay.md +650 -0
  965. package/website/guide/configuration.md +173 -0
  966. package/website/guide/equalizer.md +231 -0
  967. package/website/guide/errors.md +310 -0
  968. package/website/guide/favorites.md +154 -0
  969. package/website/guide/gate.md +143 -0
  970. package/website/guide/getting-started.md +46 -0
  971. package/website/guide/hooks.md +238 -0
  972. package/website/guide/live-streams.md +125 -0
  973. package/website/guide/metadata.md +239 -0
  974. package/website/guide/migrating-from-track-player.md +244 -0
  975. package/website/guide/native-callback-fetch.md +127 -0
  976. package/website/guide/network.md +86 -0
  977. package/website/guide/now-playing.md +175 -0
  978. package/website/guide/playback.md +328 -0
  979. package/website/guide/queue.md +300 -0
  980. package/website/guide/remote-controls.md +256 -0
  981. package/website/guide/search.md +255 -0
  982. package/website/guide/sleep-timer.md +268 -0
  983. package/website/guide/track.md +247 -0
  984. package/ios/Bridge.h +0 -8
  985. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  986. package/ios/Browser/MediaResolveComposer.swift +0 -114
  987. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  988. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  989. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  990. package/ios/Model/MediaURL.swift +0 -67
  991. package/ios/Model/SourceType.swift +0 -6
  992. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  993. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  994. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  995. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  996. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  997. package/ios/Observer/PlayerStateObserver.swift +0 -50
  998. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  999. package/ios/Option/PitchAlgorithms.swift +0 -17
  1000. package/ios/Option/TimeEventFrequency.swift +0 -18
  1001. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1002. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1003. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1004. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1005. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1006. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1007. package/ios/Player/PlaybackStateStore.swift +0 -27
  1008. package/ios/Player/PlayingStateManager.swift +0 -33
  1009. package/ios/Player/RetryManager.swift +0 -322
  1010. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1011. package/ios/Player/SleepTimerHandling.swift +0 -15
  1012. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1013. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1014. package/ios/Tests/MediaResolveTests.swift +0 -126
  1015. package/ios/Tests/OnceValueTests.swift +0 -79
  1016. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1017. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1018. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1019. package/ios/Tests/RetryManagerTests.swift +0 -89
  1020. package/ios/TrackPlayer.swift +0 -1014
  1021. package/ios/TrackPlayerCallbacks.swift +0 -86
  1022. package/ios/Util/MetadataAdapter.swift +0 -131
  1023. package/ios/Util/OnceValue.swift +0 -104
  1024. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1025. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1026. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1027. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1028. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1029. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1030. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1031. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1032. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1033. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1034. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1035. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1036. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1037. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -1,43 +1,84 @@
1
1
  package com.audiobrowser.browser
2
2
 
3
- import com.margelo.nitro.audiobrowser.ImageRowItem
3
+ import com.audiobrowser.extension.identity
4
+ import com.margelo.nitro.audiobrowser.ResolvedTrack
5
+ import com.margelo.nitro.audiobrowser.Section
4
6
  import com.margelo.nitro.audiobrowser.Track
5
7
 
6
8
  /**
7
- * Queue scope is the tapped section, not the whole page (ADR 0006): the
8
- * playback context a listener expects is the list they tapped in — a page
9
- * aggregating several sections must not leak next/previous across them.
9
+ * Queue scope is the tapped section, not the whole page (ADR 0006): the playback context a listener
10
+ * expects is the list they tapped in — a page aggregating several sections must not leak
11
+ * next/previous across them. Sections are structural (ADR 0010), so scoping is a lookup, not a
12
+ * groupTitle-run derivation.
10
13
  */
11
14
  object SectionScope {
12
- sealed class Section {
13
- /** The tapped id lives inside an image row's items. */
14
- data class ImageRow(val items: List<ImageRowItem>) : Section()
15
-
16
- /**
17
- * The contiguous `groupTitle` run around the tapped child (items with no
18
- * group title form runs of their own).
19
- */
20
- data class Run(val tracks: List<Track>) : Section()
21
- }
15
+ /**
16
+ * The section containing the tapped identity, plus the tapped child's offset within it — non-null
17
+ * only when the stamped flat index pinned the exact copy.
18
+ */
19
+ data class Scoped(val section: Section, val tappedOffset: Int?)
22
20
 
23
21
  /**
24
- * The section of [children] containing the playable [trackId], or null
25
- * when the id is not found.
22
+ * The section of [sections] containing the playable [trackId] (a track identity — id when
23
+ * non-blank, else src), or null when not found.
24
+ *
25
+ * [tappedIndex] — the flat page position stamped into the contextual URL (children concatenated
26
+ * in section order) — is a tie-breaker, never an identifier: when the child at that position
27
+ * still carries the tapped identity, it pins which section (and which copy) was tapped; when it
28
+ * doesn't (the list shifted), resolution falls back to the first section containing the identity.
29
+ * A stale index can therefore never select a different track — at worst a different copy of the
30
+ * same one.
26
31
  */
27
- fun section(children: List<Track>, trackId: String): Section? {
28
- for (child in children) {
29
- val items = child.imageRow
30
- if (items != null && items.any { it.src == trackId }) {
31
- return Section.ImageRow(items.toList())
32
+ fun scoped(sections: List<Section>, trackId: String, tappedIndex: Int? = null): Scoped? {
33
+ if (tappedIndex != null && tappedIndex >= 0) {
34
+ var start = 0
35
+ for (section in sections) {
36
+ val offset = tappedIndex - start
37
+ if (offset < section.children.size) {
38
+ if (section.children[offset].identity == trackId) {
39
+ return Scoped(section, offset)
40
+ }
41
+ break
42
+ }
43
+ start += section.children.size
44
+ }
45
+ }
46
+ for (section in sections) {
47
+ if (section.children.any { it.identity == trackId }) {
48
+ return Scoped(section, null)
32
49
  }
33
50
  }
34
- val index = children.indexOfFirst { it.src == trackId }
35
- if (index < 0) return null
36
- val group = children[index].groupTitle
37
- var start = index
38
- while (start > 0 && children[start - 1].groupTitle == group) start--
39
- var end = index
40
- while (end + 1 < children.size && children[end + 1].groupTitle == group) end++
41
- return Section.Run(children.subList(start, end + 1).toList())
51
+ return null
42
52
  }
43
53
  }
54
+
55
+ // Page shape helpers (ADR 0010)
56
+
57
+ /**
58
+ * One untitled section — the canonical wrap of a flat track list (`children` authoring sugar,
59
+ * search results — ADR 0010).
60
+ */
61
+ fun untitledSection(children: Array<Track>): Section =
62
+ Section(title = null, style = null, path = null, children = children)
63
+
64
+ /**
65
+ * The canonical sectioned shape: `sections` wins when present; plain `children` is authoring sugar
66
+ * for one untitled section.
67
+ */
68
+ val ResolvedTrack.normalizedSections: List<Section>?
69
+ get() = sections?.toList() ?: children?.let { listOf(untitledSection(it)) }
70
+
71
+ /**
72
+ * [normalizedSections] with the page block folded in: each section's style resolves `section ??
73
+ * page` per property ([StyleResolver], ADR 0011), so everything downstream sees only effective
74
+ * section blocks — a page is a Track that is also the container of its sections.
75
+ */
76
+ fun ResolvedTrack.styleResolvedSections(): List<Section>? =
77
+ normalizedSections?.map { it.copy(style = StyleResolver.sectionStyle(it.style, style)) }
78
+
79
+ /**
80
+ * The page's children concatenated in section order — the flattening that defines contextual
81
+ * `__index` positions and the flat views (tabs, search) of a sectioned page.
82
+ */
83
+ val ResolvedTrack.flattenedChildren: List<Track>?
84
+ get() = normalizedSections?.flatMap { it.children.asList() }
@@ -0,0 +1,60 @@
1
+ package com.audiobrowser.browser
2
+
3
+ import com.margelo.nitro.audiobrowser.SectionStyle
4
+ import com.margelo.nitro.audiobrowser.TrackStyle
5
+
6
+ /**
7
+ * The one place style declarations resolve to effective values (ADR 0011).
8
+ *
9
+ * Two mechanisms, deliberately distinct:
10
+ * - **Inherited item properties** resolve `track ?? section ?? page`, per property — a track's own
11
+ * declaration wins over the blocks that contain it.
12
+ * - **Container properties and the positional `display`** resolve by scope override: `section ??
13
+ * page` — the page declares for its whole scope, a section overrides for its own children.
14
+ * `display` is never inherited item-to-container: each holder describes its own children, and a
15
+ * track's `display` is the promise for the page *it* opens, not its rendering inside this
16
+ * section.
17
+ *
18
+ * Every key of `SectionStyle` must be read by [sectionStyle] and every inherited key of
19
+ * `TrackStyle` by [trackStyle] — Nitro flattens the spec's `extends`, so
20
+ * `src/style-resolution.test.ts` enforces this completeness, not the type system.
21
+ */
22
+ object StyleResolver {
23
+ /**
24
+ * Folds the page block into a section's block: every `SectionStyle` key resolves `section ??
25
+ * page`. The result is the section's effective block; item resolution then only needs `track ??
26
+ * section`.
27
+ */
28
+ fun sectionStyle(section: SectionStyle?, page: SectionStyle?): SectionStyle =
29
+ SectionStyle(
30
+ display = section?.display ?: page?.display,
31
+ artworkRendering = section?.artworkRendering ?: page?.artworkRendering,
32
+ imageShape = section?.imageShape ?: page?.imageShape,
33
+ accessorySymbol = section?.accessorySymbol ?: page?.accessorySymbol,
34
+ cardTint = section?.cardTint ?: page?.cardTint,
35
+ cardImage = section?.cardImage ?: page?.cardImage,
36
+ gridWrap = section?.gridWrap ?: page?.gridWrap,
37
+ gridTile = section?.gridTile ?: page?.gridTile,
38
+ )
39
+
40
+ /**
41
+ * Resolves a track's effective item properties against its (page-folded) section block.
42
+ *
43
+ * No Android renderer consumes the result yet — today's only inherited property
44
+ * (`artworkRendering`) is CarPlay-rendered — but the resolver ships on both platforms so the
45
+ * completeness test can hold every future inherited key to the same rule from day one.
46
+ */
47
+ fun trackStyle(track: TrackStyle?, section: SectionStyle?): TrackStyle =
48
+ TrackStyle(
49
+ // Positional deny-list: `display` is never inherited onto an item — resolved null, so no
50
+ // renderer can mistake the handle's page promise for this item's own layout.
51
+ display = null,
52
+ artworkRendering = track?.artworkRendering ?: section?.artworkRendering,
53
+ imageShape = track?.imageShape ?: section?.imageShape,
54
+ // 'none' resolves like any value — a renderer treats it as "no accessory, derived
55
+ // behavior" (the inheritance escape). No Android surface draws these properties today.
56
+ accessorySymbol = track?.accessorySymbol ?: section?.accessorySymbol,
57
+ cardTint = track?.cardTint ?: section?.cardTint,
58
+ cardImage = track?.cardImage ?: section?.cardImage,
59
+ )
60
+ }
@@ -2,6 +2,7 @@ package com.audiobrowser.extension
2
2
 
3
3
  import com.margelo.nitro.audiobrowser.ResolvedTrack
4
4
  import com.margelo.nitro.audiobrowser.Track
5
+ import com.margelo.nitro.audiobrowser.TrackStyle
5
6
 
6
7
  /**
7
8
  * The Track view of a ResolvedTrack: every display/playback field carried over, the browse-only
@@ -12,24 +13,36 @@ import com.margelo.nitro.audiobrowser.Track
12
13
  fun ResolvedTrack.toTrack(): Track =
13
14
  Track(
14
15
  id = id,
15
- url = url,
16
+ path = path,
16
17
  src = src,
17
18
  artwork = artwork,
18
19
  artworkSource = artworkSource,
19
20
  request = request,
20
- artworkCarPlayTinted = artworkCarPlayTinted,
21
21
  title = title,
22
22
  subtitle = subtitle,
23
23
  artist = artist,
24
- albumUrl = albumUrl,
24
+ albumPath = albumPath,
25
25
  album = album,
26
26
  description = description,
27
27
  genre = genre,
28
28
  duration = duration,
29
- style = style,
30
- childrenStyle = childrenStyle,
29
+ // An explicit SectionStyle → TrackStyle projection: the page's container
30
+ // properties (gridWrap) have no meaning on a plain Track, so they drop —
31
+ // Nitro flattens the spec's `extends`, making this narrowing a hand-written
32
+ // field list rather than an upcast (ADR 0011).
33
+ style =
34
+ style?.let {
35
+ TrackStyle(
36
+ display = it.display,
37
+ artworkRendering = it.artworkRendering,
38
+ imageShape = it.imageShape,
39
+ accessorySymbol = it.accessorySymbol,
40
+ cardTint = it.cardTint,
41
+ cardImage = it.cardImage,
42
+ )
43
+ },
44
+ disabled = disabled,
31
45
  favorited = favorited,
32
- groupTitle = groupTitle,
33
46
  live = live,
34
- imageRow = imageRow,
47
+ icyCharset = icyCharset,
35
48
  )
@@ -0,0 +1,20 @@
1
+ package com.audiobrowser.extension
2
+
3
+ import com.audiobrowser.util.BrowserPathHelper
4
+ import com.margelo.nitro.audiobrowser.Track
5
+
6
+ /**
7
+ * The queue position of the tapped surface, for skip-in-place. Exact-surface match first: a
8
+ * contextual path carries the tapped page position (`__index`), so path equality pins the exact
9
+ * copy when the page holds the same identity more than once. The identity match remains for
10
+ * index-less paths (e.g. pre-stamp persisted state); an index-stamped path with no exact match
11
+ * returns -1, and the caller falls through to expansion, which re-scopes the queue to the tapped
12
+ * section (ADR 0009).
13
+ */
14
+ fun Array<Track>.indexOfTappedTrack(contextualPath: String, trackId: String?): Int {
15
+ val index = indexOfFirst { it.path == contextualPath }
16
+ if (index >= 0 || BrowserPathHelper.extractIndex(contextualPath) != null || trackId == null) {
17
+ return index
18
+ }
19
+ return indexOfFirst { it.identity == trackId }
20
+ }
@@ -0,0 +1,15 @@
1
+ package com.audiobrowser.extension
2
+
3
+ import com.margelo.nitro.audiobrowser.Track
4
+
5
+ /**
6
+ * A track's identity: the opaque `id` when present (non-blank), else the playable `src`. Two tracks
7
+ * refer to the same item iff their identities are equal. Browsable-only tracks (neither `id` nor
8
+ * `src`) have no identity — they are addressed by `path` instead.
9
+ *
10
+ * This is THE comparison rule for favorites matching, section scoping, skip-in-place, the car
11
+ * now-playing row indicator, and the contextual `__trackId` — see ADR 0008. Mirrors the TS
12
+ * `trackIdentity` helper.
13
+ */
14
+ val Track.identity: String?
15
+ get() = id?.takeUnless { it.isBlank() } ?: src
@@ -1,5 +1,6 @@
1
1
  package com.audiobrowser.http
2
2
 
3
+ import com.audiobrowser.BuildConfig
3
4
  import java.io.IOException
4
5
  import java.util.concurrent.TimeUnit
5
6
  import kotlinx.coroutines.Dispatchers
@@ -27,13 +28,29 @@ class HttpClient {
27
28
  isLenient = true
28
29
  }
29
30
 
30
- private val loggingInterceptor =
31
+ /**
32
+ * Full request/response logging, for debug builds only.
33
+ *
34
+ * Timber is exposed as `api`, so whatever this logs reaches the host app's tree — a Crashlytics
35
+ * or Sentry breadcrumb tree included. That means credentials attached by the request-transform
36
+ * layer and every response body, so the interceptor is not installed in release at all: `BODY`
37
+ * also buffers and stringifies each response whether or not anything reads the log.
38
+ *
39
+ * The redactions apply in debug too. Logcat is shared in bug reports and screen shares.
40
+ */
41
+ private fun loggingInterceptor() =
31
42
  HttpLoggingInterceptor { message -> Timber.d(message) }
32
- .apply { level = HttpLoggingInterceptor.Level.BODY }
43
+ .apply {
44
+ level = HttpLoggingInterceptor.Level.BODY
45
+ redactHeader("Authorization")
46
+ redactHeader("Proxy-Authorization")
47
+ redactHeader("Cookie")
48
+ redactHeader("Set-Cookie")
49
+ }
33
50
 
34
51
  private val client =
35
52
  OkHttpClient.Builder()
36
- .addInterceptor(loggingInterceptor)
53
+ .apply { if (BuildConfig.DEBUG) addInterceptor(loggingInterceptor()) }
37
54
  .connectTimeout(TIMEOUT_SECONDS, TimeUnit.SECONDS)
38
55
  .readTimeout(TIMEOUT_SECONDS, TimeUnit.SECONDS)
39
56
  .writeTimeout(TIMEOUT_SECONDS, TimeUnit.SECONDS)
@@ -153,12 +153,11 @@ object RequestConfigBuilder {
153
153
  * per-track `request` override (e.g. a strict-UA sentinel the consumer swaps for a clean
154
154
  * User-Agent) — and returns the config whose fields win.
155
155
  *
156
- * No-op when the media config has no `resolve` callback or no track is available (so the
157
- * request/media layers stand). The callback may return its config synchronously (variant `first`)
158
- * or via a Promise (`second`). Mirrors iOS resolveMediaTrackConfig + applyMediaResolveLayer.
156
+ * No-op when the media config has no `resolve` callback (so the request/media layers stand). The
157
+ * callback may return its config synchronously (variant `first`) or via a Promise (`second`).
158
+ * Mirrors iOS resolveMediaTrackConfig + applyMediaResolveLayer.
159
159
  */
160
- suspend fun applyMediaResolve(layered: MediaRequestConfig, track: Track?): MediaRequestConfig {
161
- if (track == null) return layered
160
+ suspend fun applyMediaResolve(layered: MediaRequestConfig, track: Track): MediaRequestConfig {
162
161
  if (layered.resolve == null && layered.resolveSync == null) return layered
163
162
  val resolved: RequestConfig =
164
163
  try {
@@ -0,0 +1,24 @@
1
+ package com.audiobrowser.model
2
+
3
+ import java.nio.charset.Charset
4
+
5
+ /** Re-decodes an ICY `StreamTitle` with the charset the track declares. */
6
+ internal object IcyTitle {
7
+ /**
8
+ * [title] re-decoded through ISO-8859-1 with [charset] when it is Latin-1 shaped: every char at
9
+ * or below U+00FF, at least one at or above U+0080. That shape is what media3's ISO-8859-1
10
+ * fallback yields for bytes that are not UTF-8, and also what a station that UTF-8-encoded its
11
+ * legacy bytes yields; ISO-8859-1 is lossless, so both re-decode. Returns [title] as is when it
12
+ * has another shape, is pure ASCII, or [charset] is not one the runtime can decode with.
13
+ */
14
+ fun redecode(title: String, charset: String): String {
15
+ var high = false
16
+ for (c in title) {
17
+ if (c.code > 0xFF) return title
18
+ if (c.code >= 0x80) high = true
19
+ }
20
+ if (!high) return title
21
+ val cs = runCatching { Charset.forName(charset) }.getOrNull() ?: return title
22
+ return String(title.toByteArray(Charsets.ISO_8859_1), cs)
23
+ }
24
+ }
@@ -15,11 +15,12 @@ data class PlaybackMetadata(
15
15
  companion object {
16
16
  /**
17
17
  * Creates PlaybackMetadata from raw Metadata entries. Handles ICY streams specially, uses
18
- * Media3's unified approach for everything else.
18
+ * Media3's unified approach for everything else. [icyCharset] is the track's declared charset
19
+ * for ICY titles media3 decoded as Latin-1; it never touches other metadata.
19
20
  */
20
- fun from(metadata: Metadata): PlaybackMetadata? {
21
+ fun from(metadata: Metadata, icyCharset: String? = null): PlaybackMetadata? {
21
22
  // Try ICY first (streaming-specific)
22
- fromIcy(metadata)?.let {
23
+ fromIcy(metadata, icyCharset)?.let {
23
24
  return it
24
25
  }
25
26
 
@@ -32,12 +33,15 @@ data class PlaybackMetadata(
32
33
  }
33
34
 
34
35
  /** Shoutcast / Icecast metadata (ICY protocol) https://cast.readme.io/docs/icy */
35
- private fun fromIcy(metadata: Metadata): PlaybackMetadata? {
36
+ private fun fromIcy(metadata: Metadata, icyCharset: String?): PlaybackMetadata? {
36
37
  for (i in 0 until metadata.length()) {
37
38
  when (val entry = metadata[i]) {
38
39
  is IcyInfo -> {
39
- if (entry.title != null) {
40
- return PlaybackMetadata(title = entry.title)
40
+ val title = entry.title
41
+ if (title != null) {
42
+ return PlaybackMetadata(
43
+ title = icyCharset?.let { IcyTitle.redecode(title, it) } ?: title
44
+ )
41
45
  }
42
46
  }
43
47
  }
@@ -70,6 +70,13 @@ data class PlayerSetupOptions(
70
70
  val automaticBuffer: Boolean
71
71
  get() = rebufferBuffer == null
72
72
 
73
+ /**
74
+ * A copy that equals another's when both build the same engine: without the now-playing options,
75
+ * which apply without a rebuild. A formatter is a new object on every setup call.
76
+ */
77
+ fun engineOptions() =
78
+ copy(autoUpdateNowPlayingMetadata = true, nowPlayingMetadataFormatter = null)
79
+
73
80
  fun update(options: NativeSetupPlayerOptions) {
74
81
  // Android-specific options
75
82
  options.android?.let { android ->
@@ -20,7 +20,7 @@ data class PlayerUpdateOptions(
20
20
  var progressUpdateEventInterval: Double? = null,
21
21
 
22
22
  // Player capabilities - most enabled by default, only false values disable
23
- // Exceptions: bookmark, jumpForward, jumpBackward default to false
23
+ // Exceptions: jumpForward, jumpBackward default to false
24
24
  var capabilities: PlayerCapabilities =
25
25
  PlayerCapabilities(
26
26
  play = null,
@@ -0,0 +1,77 @@
1
+ package com.audiobrowser.player
2
+
3
+ import okhttp3.HttpUrl
4
+ import okhttp3.Interceptor
5
+ import okhttp3.Request
6
+ import okhttp3.Response
7
+
8
+ /**
9
+ * Drops the caller's headers once a redirect leaves the origin.
10
+ *
11
+ * OkHttp does this for `Authorization` alone — RetryAndFollowUpInterceptor.buildRedirectRequest is
12
+ * a single `removeHeader("Authorization")` — so every other configured header, an `X-Api-Key` say,
13
+ * still reaches whatever host the first one named. iOS forwards none across a hop and web clears
14
+ * them too; this brings Android in line.
15
+ *
16
+ * Installed as a **network** interceptor, which runs once per hop. `chain.call().request()` is the
17
+ * call's original request, so the comparison is always against the URL the credential was addressed
18
+ * to rather than the hop before.
19
+ *
20
+ * Scoped to the redirect hop, and only that. An HLS segment or key fetch is its own Call, already
21
+ * addressed to the absolute CDN URL, and [TransformingDataSource] deliberately re-applies the
22
+ * config's headers to it — authenticated segments are a supported shape, and web does the same
23
+ * through Shaka's request filter. So this closes the leak of handing a credential to a host the
24
+ * caller never named; it is not a rule that the credential stays on one origin.
25
+ */
26
+ internal object CrossOriginHeaderStripper : Interceptor {
27
+
28
+ /**
29
+ * Headers that describe the transport rather than the caller. OkHttp and media3 set these per hop
30
+ * — `Range` carries the seek, `Host` and `Connection` are the connection's own — so the request
31
+ * breaks without them. Everything else on a media request came from the media config, and is the
32
+ * caller's to send only to the host it addressed.
33
+ *
34
+ * `Icy-MetaData` is media3's, not the caller's: `ProgressiveMediaPeriod` asks for Shoutcast
35
+ * metadata through `ICY_METADATA_HEADERS` on the DataSpec — the same channel
36
+ * [TransformingDataSource] puts the config's headers on, so nothing downstream can tell them
37
+ * apart. Dropping it on a hop costs the station's `icy-metaint`, so `IcyDataSource` is never
38
+ * installed and `onMetadata` stops firing: live "now playing" disappears on exactly the
39
+ * redirecting streams this interceptor exists for, and the interleaved metadata bytes stay in the
40
+ * audio as audible chirping. It is a request for a response format, never a credential.
41
+ */
42
+ private val TRANSPORT_HEADERS =
43
+ setOf(
44
+ "accept",
45
+ "accept-encoding",
46
+ "connection",
47
+ "content-length",
48
+ "host",
49
+ "icy-metadata",
50
+ "range",
51
+ "transfer-encoding",
52
+ "user-agent",
53
+ )
54
+
55
+ override fun intercept(chain: Interceptor.Chain): Response {
56
+ val request = chain.request()
57
+ val addressed = chain.call().request().url
58
+ return chain.proceed(
59
+ if (sameOrigin(addressed, request.url)) request else stripCallerHeaders(request)
60
+ )
61
+ }
62
+
63
+ /** Scheme, host and port — the same origin test `followMediaRedirect` applies on web. */
64
+ internal fun sameOrigin(a: HttpUrl, b: HttpUrl): Boolean =
65
+ a.scheme == b.scheme && a.host == b.host && a.port == b.port
66
+
67
+ /** The request with every caller-supplied header removed. */
68
+ internal fun stripCallerHeaders(request: Request): Request =
69
+ request
70
+ .newBuilder()
71
+ .apply {
72
+ request.headers.names().forEach { name ->
73
+ if (name.lowercase() !in TRANSPORT_HEADERS) removeHeader(name)
74
+ }
75
+ }
76
+ .build()
77
+ }
@@ -0,0 +1,63 @@
1
+ package com.audiobrowser.player
2
+
3
+ import androidx.media3.common.C
4
+ import androidx.media3.common.MediaItem
5
+ import androidx.media3.common.PlaybackParameters
6
+ import androidx.media3.common.Player as MediaPlayer
7
+ import androidx.media3.exoplayer.ExoPlayer
8
+ import androidx.media3.exoplayer.source.ShuffleOrder
9
+
10
+ /**
11
+ * What an engine is playing, and how: what [Player.setup] carries from the engine it releases to
12
+ * the one it builds, so new setup options don't stop playback.
13
+ */
14
+ internal data class EnginePlayback(
15
+ val mediaItems: List<MediaItem>,
16
+ val index: Int,
17
+ /**
18
+ * [C.TIME_UNSET] for a live item, which resumes at the live edge, and for 0, which is also how a
19
+ * live item reads before it has loaded.
20
+ */
21
+ val positionMs: Long,
22
+ val prepared: Boolean,
23
+ val playWhenReady: Boolean,
24
+ val repeatMode: Int,
25
+ val shuffleModeEnabled: Boolean,
26
+ val shuffleOrder: ShuffleOrder,
27
+ val playbackParameters: PlaybackParameters,
28
+ val volume: Float,
29
+ val skipSilenceEnabled: Boolean,
30
+ ) {
31
+ fun restoreTo(exoPlayer: ExoPlayer) {
32
+ exoPlayer.repeatMode = repeatMode
33
+ exoPlayer.shuffleModeEnabled = shuffleModeEnabled
34
+ exoPlayer.playbackParameters = playbackParameters
35
+ exoPlayer.volume = volume
36
+ exoPlayer.skipSilenceEnabled = skipSilenceEnabled
37
+ if (mediaItems.isNotEmpty()) {
38
+ exoPlayer.setMediaItems(mediaItems, index, positionMs)
39
+ exoPlayer.setShuffleOrder(shuffleOrder)
40
+ if (prepared) exoPlayer.prepare()
41
+ }
42
+ exoPlayer.playWhenReady = playWhenReady
43
+ }
44
+
45
+ companion object {
46
+ fun of(exoPlayer: ExoPlayer) =
47
+ EnginePlayback(
48
+ mediaItems = (0 until exoPlayer.mediaItemCount).map { exoPlayer.getMediaItemAt(it) },
49
+ index = exoPlayer.currentMediaItemIndex,
50
+ positionMs =
51
+ exoPlayer.currentPosition.takeUnless { exoPlayer.isCurrentMediaItemLive || it == 0L }
52
+ ?: C.TIME_UNSET,
53
+ prepared = exoPlayer.playbackState != MediaPlayer.STATE_IDLE,
54
+ playWhenReady = exoPlayer.playWhenReady,
55
+ repeatMode = exoPlayer.repeatMode,
56
+ shuffleModeEnabled = exoPlayer.shuffleModeEnabled,
57
+ shuffleOrder = exoPlayer.shuffleOrder,
58
+ playbackParameters = exoPlayer.playbackParameters,
59
+ volume = exoPlayer.volume,
60
+ skipSilenceEnabled = exoPlayer.skipSilenceEnabled,
61
+ )
62
+ }
63
+ }
@@ -4,18 +4,22 @@ import android.content.Context
4
4
  import androidx.media3.common.MediaItem
5
5
  import androidx.media3.datasource.DataSource
6
6
  import androidx.media3.datasource.DefaultDataSource
7
- import androidx.media3.datasource.DefaultHttpDataSource
8
7
  import androidx.media3.datasource.TransferListener
9
8
  import androidx.media3.datasource.cache.CacheDataSource
10
9
  import androidx.media3.datasource.cache.SimpleCache
10
+ import androidx.media3.datasource.okhttp.OkHttpDataSource
11
11
  import androidx.media3.exoplayer.drm.DrmSessionManagerProvider
12
12
  import androidx.media3.exoplayer.source.DefaultMediaSourceFactory
13
13
  import androidx.media3.exoplayer.source.MediaSource
14
14
  import androidx.media3.exoplayer.upstream.LoadErrorHandlingPolicy
15
15
  import androidx.media3.extractor.DefaultExtractorsFactory
16
16
  import com.audiobrowser.model.RetryPolicy
17
+ import com.audiobrowser.util.TrackFactory
17
18
  import com.margelo.nitro.audiobrowser.MediaRequestConfig
19
+ import com.margelo.nitro.audiobrowser.Track
18
20
  import java.io.IOException
21
+ import java.util.concurrent.TimeUnit
22
+ import okhttp3.OkHttpClient
19
23
 
20
24
  class MediaFactory(
21
25
  private val context: Context,
@@ -26,11 +30,25 @@ class MediaFactory(
26
30
  private val hasPlayed: () -> Boolean = { false },
27
31
  private val onRetryPending: ((exception: IOException, isNetworkError: Boolean) -> Unit)? = null,
28
32
  private val transferListener: TransferListener? = null,
29
- private val getRequestConfig: (originalUrl: String) -> MediaRequestConfig?,
33
+ private val getRequestConfig: (originalUrl: String, track: Track) -> MediaRequestConfig?,
30
34
  ) : MediaSource.Factory {
31
35
 
32
36
  companion object {
33
37
  private const val DEFAULT_USER_AGENT = "react-native-audio-browser"
38
+
39
+ /**
40
+ * The client media requests go out on. One per process so connections are reused; not
41
+ * `HttpClient`'s browse client, whose read timeout is sized for JSON and would cut a long media
42
+ * read short. The timeouts are media3's own defaults, so stall detection and
43
+ * [RetryLoadErrorHandlingPolicy] behave as they did before.
44
+ */
45
+ private val mediaHttpClient: OkHttpClient by lazy {
46
+ OkHttpClient.Builder()
47
+ .connectTimeout(8, TimeUnit.SECONDS)
48
+ .readTimeout(8, TimeUnit.SECONDS)
49
+ .addNetworkInterceptor(CrossOriginHeaderStripper)
50
+ .build()
51
+ }
34
52
  }
35
53
 
36
54
  private val extractorsFactory =
@@ -95,24 +113,28 @@ class MediaFactory(
95
113
  // ExoPlayer's IO thread. This prevents deadlocks when the JS thread is blocked by
96
114
  // synchronous Nitro calls (e.g., seekTo) while a media transform callback needs the
97
115
  // JS thread to resolve.
116
+
117
+ // OkHttp rather than DefaultHttpDataSource, for how each treats a redirect.
118
+ // DefaultHttpDataSource re-applies the request headers on every hop, handing
119
+ // an Authorization header to whatever host the first one named. OkHttp drops
120
+ // that one header itself, and [CrossOriginHeaderStripper] drops the rest.
98
121
  val httpFactory =
99
- DefaultHttpDataSource.Factory().apply {
100
- // Deliberately NOT setUserAgent(): DefaultHttpDataSource applies the factory
101
- // user-agent as a FINAL setRequestProperty("User-Agent", …) that runs after —
102
- // and overrides — the per-request DataSpec headers. That would clobber the
103
- // User-Agent TransformingDataSource sets per request (the whole point of the
104
- // per-request userAgent override). Supplying the same value as a default
105
- // request property keeps the default for un-overridden requests while letting
106
- // the per-request DataSpec header win.
122
+ OkHttpDataSource.Factory(mediaHttpClient).apply {
123
+ // Deliberately NOT setUserAgent(): it is applied last via addHeader(),
124
+ // which appends, so a request already carrying one would send two. As a
125
+ // default request property it is merged under dataSpec.httpRequestHeaders
126
+ // and applied with header(), letting TransformingDataSource's per-request
127
+ // override win.
107
128
  setDefaultRequestProperties(mapOf("User-Agent" to DEFAULT_USER_AGENT))
108
- setAllowCrossProtocolRedirects(true)
109
129
  // Connect transfer listener for bandwidth measurement
110
130
  transferListener?.let { setTransferListener(it) }
111
131
  }
112
132
  val baseFactory: DataSource.Factory = DefaultDataSource.Factory(context, httpFactory)
113
133
 
114
134
  // Wrap with TransformingDataSource to resolve URLs on the IO thread
115
- val transformingFactory = TransformingDataSource.Factory(baseFactory, getRequestConfig)
135
+ val track = TrackFactory.fromMedia3(mediaItem)
136
+ val transformingFactory =
137
+ TransformingDataSource.Factory(baseFactory) { url -> getRequestConfig(url, track) }
116
138
 
117
139
  // Configure data source factory with optional caching
118
140
  val dataSourceFactory =