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,74 +1,102 @@
1
1
  package com.audiobrowser.util
2
2
 
3
- import android.net.Uri
4
3
  import androidx.core.net.toUri
5
4
  import androidx.media3.common.HeartRating
6
5
  import androidx.media3.common.MediaItem
7
6
  import androidx.media3.common.MediaMetadata
8
7
  import com.audiobrowser.browser.BrowseArtworkRegistry
9
- import com.audiobrowser.browser.ResolvedArtwork
10
- import com.margelo.nitro.audiobrowser.ImageRowItem
8
+ import com.margelo.nitro.audiobrowser.Section
11
9
  import com.margelo.nitro.audiobrowser.Track
12
10
  import com.margelo.nitro.audiobrowser.TrackStyle
13
- import com.margelo.nitro.audiobrowser.Variant_String_ArtworkVariants
14
11
 
15
12
  /**
16
13
  * The single Track → Media3 [MediaItem] conversion. Owns the two easy-to-drift fallbacks: the
17
14
  * displayed artwork is the transformed `artworkSource.uri` falling back to the raw `artwork` field,
18
- * and the mediaId is the stable `id` for playable tracks, falling back to `url` then `src` (a Track
19
- * must have one of the latter two — see the `src` vs `url` note in CONTEXT.md). The list line
20
- * renders from `subtitle` (the now-playing line is re-stamped from `artist` by the now-playing
15
+ * and the mediaId is the stable `id` for playable tracks, falling back to `path` then `src` (a
16
+ * Track must have one of the latter two — see the `src` vs `path` note in CONTEXT.md). The list
17
+ * line renders from `subtitle` (the now-playing line is re-stamped from `artist` by the now-playing
21
18
  * pipeline; see the Now Playing Metadata guide).
22
19
  */
23
20
  object TrackFactory {
24
- fun fromMedia3(mediaItem: MediaItem): Track {
25
- return mediaItem.localConfiguration!!.tag as Track
21
+ /** Set once by the Player. */
22
+ @Volatile var artworkRoutes: ArtworkRoutes? = null
23
+
24
+ /**
25
+ * The artwork URI the session publishes for [url]. On Android Automotive OS, whose car media app
26
+ * loads artwork only from `content://`, `android.resource://` and `file://` URIs, http(s) artwork
27
+ * is served through the provider, as browse artwork always is.
28
+ */
29
+ fun sessionArtworkUri(url: String, headers: Map<String, String>?, isSvg: Boolean): String {
30
+ val provider = artworkRoutes?.takeIf { Automotive.device } ?: return url
31
+ return provider.route(url, headers, isSvg, pinned = true)
26
32
  }
27
33
 
34
+ /** Whether favoriting is on: the `favorite` capability, set by the Player. */
35
+ @Volatile var favoriteEnabled = false
36
+
28
37
  /**
29
- * Android Auto has no image-row rendering; its closest equivalent is a grid of artwork
30
- * tiles. A track carrying `imageRow` expands into its items as grid-styled rows (the
31
- * per-item content-style hint — hosts that ignore it fall back to list rows) grouped under
32
- * the row's title, followed by the row itself as a browsable "view all" link when it has a
33
- * `url` (a url-less row is a pure preview and contributes only its items). Tracks without
34
- * an `imageRow` pass through unchanged.
38
+ * Sets the heart `userRating`, which a controller's rating sets: [favorited], or unrated when it
39
+ * is unknown on a [playable] item, so Android Automotive OS's car media app, which draws it as
40
+ * its own favorite control, always has one to draw. None while favoriting is off.
35
41
  */
36
- fun expandImageRows(tracks: List<Track>): List<Track> =
37
- tracks.flatMap { track ->
38
- val items = track.imageRow
39
- if (items.isNullOrEmpty()) return@flatMap listOf(track)
40
- val expanded = items.map { it.toTrack(groupTitle = track.title) }
41
- if (track.url != null) {
42
- expanded + track.copy(imageRow = null, groupTitle = track.title)
43
- } else {
44
- expanded
42
+ fun MediaMetadata.Builder.setFavorite(
43
+ favorited: Boolean?,
44
+ playable: Boolean = true,
45
+ ): MediaMetadata.Builder =
46
+ setUserRating(
47
+ when {
48
+ !favoriteEnabled -> null
49
+ favorited != null -> HeartRating(favorited)
50
+ playable -> HeartRating()
51
+ else -> null
45
52
  }
46
- }
53
+ )
54
+
55
+ fun fromMedia3(mediaItem: MediaItem): Track {
56
+ return mediaItem.localConfiguration!!.tag as Track
57
+ }
47
58
 
48
- /** The row-item equivalent of a full Track, for surfaces that render items as plain rows. */
49
- fun ImageRowItem.toTrack(groupTitle: String?): Track =
59
+ /**
60
+ * A synthetic browsable Track for a section's "view more" row — the section has a path but no
61
+ * Track to hang it on (ADR 0010). It carries the section's declared item block as its own,
62
+ * `display` included: the section's declaration about this content's layout is the only declared
63
+ * promise the "view all" page can ever have (there is no consumer-authored handle to declare one
64
+ * on), and without it Android Auto would always render that page as a list.
65
+ *
66
+ * [title] is the consumer's `viewMoreTitle`, one string for every section — not the section's own
67
+ * title, which the group header above the row already shows.
68
+ */
69
+ fun navigationTrack(section: Section, title: String): Track =
50
70
  Track(
51
- id = id,
52
- url = url,
53
- src = src,
54
- artwork = artwork?.let { Variant_String_ArtworkVariants.First(it) },
55
- artworkSource = artworkSource,
56
- request = request,
57
- artworkCarPlayTinted = null,
71
+ id = null,
72
+ path = section.path,
73
+ src = null,
74
+ artwork = null,
75
+ artworkSource = null,
76
+ request = null,
58
77
  title = title,
59
78
  subtitle = null,
60
- artist = artist,
61
- albumUrl = albumUrl,
62
- album = album,
79
+ artist = null,
80
+ albumPath = null,
81
+ album = null,
63
82
  description = null,
64
83
  genre = null,
65
84
  duration = null,
66
- style = TrackStyle.GRID,
67
- childrenStyle = null,
85
+ style =
86
+ section.style?.let {
87
+ TrackStyle(
88
+ display = it.display,
89
+ artworkRendering = it.artworkRendering,
90
+ imageShape = it.imageShape,
91
+ accessorySymbol = it.accessorySymbol,
92
+ cardTint = it.cardTint,
93
+ cardImage = it.cardImage,
94
+ )
95
+ },
96
+ disabled = null,
68
97
  favorited = null,
69
- groupTitle = groupTitle,
70
- live = live,
71
- imageRow = null,
98
+ live = null,
99
+ icyCharset = null,
72
100
  )
73
101
 
74
102
  fun toMedia3(tracks: Array<Track>): List<MediaItem> {
@@ -76,7 +104,9 @@ object TrackFactory {
76
104
  }
77
105
 
78
106
  fun toMedia3(track: Track): MediaItem {
79
- val metadata = metadataBuilder(track).setArtworkUri(artworkUri(track)?.toUri()).build()
107
+ val artwork =
108
+ artworkUri(track)?.let { sessionArtworkUri(it, track.artworkSource?.headers, isSvg(track)) }
109
+ val metadata = metadataBuilder(track).setArtworkUri(artwork?.toUri()).build()
80
110
  return buildMediaItem(track, metadata)
81
111
  }
82
112
 
@@ -84,32 +114,35 @@ object TrackFactory {
84
114
  * Browse-surface conversion. Routes http(s) artwork through the content:// provider (so headers +
85
115
  * SVG apply in our process, and no bytes cross the Binder), registering it in [registry].
86
116
  * Non-http artwork (android.resource:// tab icons, file://) passes through to setArtworkUri
87
- * unchanged so vector/category icons survive. Plain toMedia3 (queue/now-playing) is unaffected.
117
+ * unchanged so vector/category icons survive.
88
118
  */
89
119
  fun toBrowseMediaItem(
90
120
  track: Track,
91
121
  registry: BrowseArtworkRegistry,
92
122
  authority: String,
123
+ section: Section? = null,
93
124
  ): MediaItem {
94
- val rawUrl = artworkUri(track) // artworkSource.uri ?: artwork
95
- val scheme = rawUrl?.let { Uri.parse(it).scheme?.lowercase() }
96
- val builder = metadataBuilder(track)
97
- if (rawUrl != null && (scheme == "http" || scheme == "https")) {
98
- val isSvg = SvgArtworkRenderer.isSvgUrl(rawUrl) || SvgArtworkRenderer.isSvgUrl(track.artwork?.url)
99
- val token = ArtworkUris.tokenFor(rawUrl)
100
- registry.register(token, ResolvedArtwork(rawUrl, track.artworkSource?.headers, isSvg))
101
- builder.setArtworkUri(ArtworkUris.contentUri(authority, token).toUri())
102
- } else if (rawUrl != null) {
103
- builder.setArtworkUri(rawUrl.toUri())
104
- }
105
- return buildMediaItem(track, builder.build())
125
+ val artwork =
126
+ artworkUri(track)?.let {
127
+ ArtworkRoutes(registry, authority)
128
+ .route(it, track.artworkSource?.headers, isSvg(track), pinned = false)
129
+ }
130
+ val metadata = metadataBuilder(track, section).setArtworkUri(artwork?.toUri()).build()
131
+ return buildMediaItem(track, metadata)
106
132
  }
107
133
 
134
+ private fun isSvg(track: Track): Boolean =
135
+ SvgArtworkRenderer.isSvgUrl(artworkUri(track)) ||
136
+ SvgArtworkRenderer.isSvgUrl(track.artwork?.url)
137
+
108
138
  /** The transformed artworkSource wins over the raw artwork field. */
109
139
  private fun artworkUri(track: Track): String? = track.artworkSource?.uri ?: track.artwork?.url
110
140
 
111
- /** All metadata except artwork. */
112
- private fun metadataBuilder(track: Track): MediaMetadata.Builder =
141
+ /**
142
+ * All metadata except artwork. The owning [section] (browse surfaces only) supplies the
143
+ * group-title header hint and the per-item style default (ADR 0010).
144
+ */
145
+ private fun metadataBuilder(track: Track, section: Section? = null): MediaMetadata.Builder =
113
146
  MediaMetadata.Builder()
114
147
  .setTitle(track.title)
115
148
  .setArtist(track.subtitle)
@@ -118,26 +151,29 @@ object TrackFactory {
118
151
  .setGenre(track.genre)
119
152
  .setIsBrowsable(track.src == null)
120
153
  .setIsPlayable(track.src != null)
121
- .setExtras(MediaExtrasBuilder.build(track))
122
- .apply { track.favorited?.let { setUserRating(HeartRating(it)) } }
154
+ .setExtras(MediaExtrasBuilder.build(track, section))
155
+ .setFavorite(track.favorited, playable = track.src != null)
123
156
 
124
157
  private fun buildMediaItem(track: Track, metadata: MediaMetadata): MediaItem {
125
- // A playable track's mediaId is the consumer's stable `id` when it has one.
126
- // Android Auto marks the "now playing" browse row by exact mediaId equality
127
- // between the row and the player's current item (media3 announces
128
- // `currentMediaItem.mediaId` in the legacy playback state), and a
158
+ // A playable track's mediaId is the consumer's stable `id` when it has one —
159
+ // the identity rule (id when non-blank, else src; see Track.identity /
160
+ // ADR 0008), except that an id-less playable track prefers its contextual
161
+ // `path` over `src` here, so this is deliberately NOT expressed via
162
+ // Track.identity. Android Auto marks the "now playing" browse row by exact
163
+ // mediaId equality between the row and the player's current item (media3
164
+ // announces `currentMediaItem.mediaId` in the legacy playback state), and a
129
165
  // consumer-loaded track's `src` can differ textually from the browse row's
130
166
  // for the same item (absolute vs relative, extra query params) — the id is
131
167
  // the one string both sides share. It is also context-free, so the same
132
168
  // station gets the same mediaId in every tab. Browsable-only tracks keep
133
- // `url` so navigation parentIds stay resolvable paths.
169
+ // `path` so navigation parentIds stay resolvable paths.
134
170
  val stableId = if (track.src != null) track.id?.takeUnless { it.isBlank() } else null
135
171
  val mediaId =
136
172
  stableId
137
- ?: track.url
173
+ ?: track.path
138
174
  ?: track.src
139
175
  ?: throw IllegalArgumentException(
140
- "Track must have either url or src defined. Track: title='${track.title}', artist='${track.artist}'"
176
+ "Track must have either path or src defined. Track: title='${track.title}', artist='${track.artist}'"
141
177
  )
142
178
  return MediaItem.Builder()
143
179
  .setMediaId(mediaId)
@@ -1,10 +1,30 @@
1
1
  <?xml version="1.0" encoding="utf-8"?>
2
+ <!--
3
+ Default copy for the two error tiles the library invents in the Android Auto
4
+ browse list. These rows have no consumer-authored Track behind them, so there
5
+ is nothing in the browse tree to read a title from; English here because a
6
+ default that renders beats a blank row.
7
+
8
+ Resources rather than a browser-config option — the route the library's
9
+ cross-platform copy takes (`formatNavigationError`, `carPlayLoadingTitle`,
10
+ `viewMoreTitle`) — because these two are not cross-platform. They exist only
11
+ because Media3 drops the message from `LibraryResult.ofError` on the legacy
12
+ browse bridge, so a row is the sole signal available; CarPlay has no
13
+ counterpart, stating failures in the list's centered empty view instead
14
+ (CarPlayController.showMessage). Android-only copy in the Android-idiomatic
15
+ place: an app re-skins either by declaring the same name in its own
16
+ strings.xml, and a `values-<locale>/` file can add translations later without
17
+ touching the API.
18
+ -->
2
19
  <resources>
3
- <!-- Error message shown in Android Auto when network is offline -->
20
+ <!--
21
+ The SessionError message a browse or search failure sends alongside its
22
+ tile. The tiles themselves are worded by the app's `formatNavigationError`
23
+ (ADR 0001), so these two are the library's only device-locale browse copy —
24
+ kept because a SessionError carries a string, not a navigation error.
25
+ Offline is distinct from the browse error: it is sent only when the network
26
+ monitor says we are actually offline, so it may name the cause.
27
+ -->
4
28
  <string name="audio_browser_offline_error">No internet connection</string>
5
- <string name="audio_browser_offline_error_subtitle">Check your connection and try again</string>
6
-
7
- <!-- Generic error message shown in Android Auto when browsing fails -->
8
29
  <string name="audio_browser_browse_error">Something went wrong</string>
9
- <string name="audio_browser_browse_error_subtitle">Please try again later</string>
10
30
  </resources>
@@ -0,0 +1,152 @@
1
+ package com.audiobrowser
2
+
3
+ import android.app.Notification
4
+ import android.app.NotificationManager
5
+ import android.content.Intent
6
+ import android.content.pm.ServiceInfo
7
+ import android.view.KeyEvent
8
+ import androidx.annotation.OptIn
9
+ import androidx.core.app.NotificationCompat
10
+ import androidx.core.app.ServiceCompat
11
+ import androidx.media3.common.util.UnstableApi
12
+ import androidx.media3.session.DefaultMediaNotificationProvider
13
+ import androidx.media3.session.MediaSession
14
+ import androidx.media3.session.MediaSessionService
15
+ import kotlinx.coroutines.CoroutineScope
16
+ import kotlinx.coroutines.Dispatchers
17
+ import org.junit.Assert.assertEquals
18
+ import org.junit.Assert.assertFalse
19
+ import org.junit.Assert.assertTrue
20
+ import org.junit.Test
21
+ import org.junit.runner.RunWith
22
+ import org.robolectric.Robolectric
23
+ import org.robolectric.RobolectricTestRunner
24
+ import org.robolectric.Shadows.shadowOf
25
+ import org.robolectric.annotation.Config
26
+
27
+ // Robolectric: startForeground/stopForeground/stopSelf only exist under the framework, and
28
+ // ShadowService records each.
29
+ @OptIn(UnstableApi::class)
30
+ @RunWith(RobolectricTestRunner::class)
31
+ class ForegroundStartTest {
32
+
33
+ class SessionlessService : MediaSessionService(), MediaSessionService.Listener {
34
+ override fun onGetSession(controllerInfo: MediaSession.ControllerInfo): MediaSession? = null
35
+ }
36
+
37
+ private val service = Robolectric.buildService(SessionlessService::class.java).create().get()
38
+ private val scope = CoroutineScope(Dispatchers.Unconfined)
39
+ private val mediaNotificationId = DefaultMediaNotificationProvider.DEFAULT_NOTIFICATION_ID
40
+
41
+ private fun notification(title: String): Notification =
42
+ NotificationCompat.Builder(service, DefaultMediaNotificationProvider.DEFAULT_CHANNEL_ID)
43
+ .setContentTitle(title)
44
+ .build()
45
+
46
+ @Test
47
+ fun `a cold search goes foreground before the search runs`() {
48
+ var foregroundIdDuringSearch: Int? = null
49
+
50
+ service.playInForeground(scope, startId = 1, hasMedia = { false }) {
51
+ foregroundIdDuringSearch = shadowOf(service).lastForegroundNotificationId
52
+ true
53
+ }
54
+
55
+ // Media3's id, so its own notification replaces the placeholder once playback starts.
56
+ assertEquals(mediaNotificationId, foregroundIdDuringSearch)
57
+ assertFalse(shadowOf(service).isForegroundStopped)
58
+ assertEquals(NEVER_STOPPED, shadowOf(service).stopSelfId)
59
+ }
60
+
61
+ @Test
62
+ fun `a cold search that finds nothing stops the service`() {
63
+ service.playInForeground(scope, startId = 7, hasMedia = { false }) { false }
64
+
65
+ assertTrue(shadowOf(service).isForegroundStopped)
66
+ assertTrue(shadowOf(service).notificationShouldRemoved)
67
+ assertEquals(7, shadowOf(service).stopSelfId)
68
+ }
69
+
70
+ @Test
71
+ fun `a search that finds nothing leaves the service running while the player has media`() {
72
+ service.playInForeground(scope, startId = 2, hasMedia = { true }) { false }
73
+
74
+ assertTrue(shadowOf(service).isForegroundStopped)
75
+ assertEquals(NEVER_STOPPED, shadowOf(service).stopSelfId)
76
+ }
77
+
78
+ @Test
79
+ fun `a search while Media3's notification shows holds that notification and leaves it to Media3`() {
80
+ val media = notification("Now playing")
81
+ service.getSystemService(NotificationManager::class.java).notify(mediaNotificationId, media)
82
+
83
+ service.playInForeground(scope, startId = 3, hasMedia = { true }) {
84
+ assertEquals(
85
+ "Now playing",
86
+ shadowOf(service).lastForegroundNotification.extras.getString(Notification.EXTRA_TITLE),
87
+ )
88
+ false
89
+ }
90
+
91
+ assertFalse(shadowOf(service).isForegroundStopped)
92
+ }
93
+
94
+ @Test
95
+ fun `a release while Media3's notification is in the foreground leaves it there`() {
96
+ val media = notification("Now playing")
97
+ ServiceCompat.startForeground(
98
+ service,
99
+ mediaNotificationId,
100
+ media,
101
+ ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK,
102
+ )
103
+ service.getSystemService(NotificationManager::class.java).notify(mediaNotificationId, media)
104
+
105
+ service.releasePlaceholder()
106
+
107
+ assertFalse(shadowOf(service).isForegroundStopped)
108
+ }
109
+
110
+ @Test
111
+ fun `the foreground start keys are the ones MediaButtonReceiver starts the service for`() {
112
+ fun press(keyCode: Int) =
113
+ Intent(Intent.ACTION_MEDIA_BUTTON)
114
+ .putExtra(Intent.EXTRA_KEY_EVENT, KeyEvent(KeyEvent.ACTION_DOWN, keyCode))
115
+
116
+ assertTrue(press(KeyEvent.KEYCODE_MEDIA_PLAY).isForegroundStartKey())
117
+ assertTrue(press(KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE).isForegroundStartKey())
118
+ assertTrue(press(KeyEvent.KEYCODE_HEADSETHOOK).isForegroundStartKey())
119
+ assertFalse(press(KeyEvent.KEYCODE_MEDIA_PAUSE).isForegroundStartKey())
120
+ assertFalse(press(KeyEvent.KEYCODE_MEDIA_NEXT).isForegroundStartKey())
121
+ assertFalse(Intent(Intent.ACTION_MEDIA_BUTTON).isForegroundStartKey())
122
+ }
123
+
124
+ @Test
125
+ @Config(sdk = [28])
126
+ fun `below API 29 a playing service holds Media3's notification again and keeps it`() {
127
+ val media = notification("Now playing")
128
+ ServiceCompat.startForeground(service, mediaNotificationId, media, 0)
129
+ service.getSystemService(NotificationManager::class.java).notify(mediaNotificationId, media)
130
+
131
+ service.playInForeground(scope, startId = 5, hasMedia = { true }) { false }
132
+
133
+ assertEquals(
134
+ "Now playing",
135
+ shadowOf(service).lastForegroundNotification.extras.getString(Notification.EXTRA_TITLE),
136
+ )
137
+ assertFalse(shadowOf(service).isForegroundStopped)
138
+ }
139
+
140
+ @Test
141
+ @Config(sdk = [25])
142
+ fun `below API 26 nothing is held, as startForegroundService does not exist`() {
143
+ service.holdForeground()
144
+
145
+ assertEquals(0, shadowOf(service).lastForegroundNotificationId)
146
+ }
147
+
148
+ private companion object {
149
+ // ShadowService's stopSelfId before any stopSelf(startId); Android's start ids begin at 1.
150
+ const val NEVER_STOPPED = 0
151
+ }
152
+ }
@@ -0,0 +1,103 @@
1
+ package com.audiobrowser
2
+
3
+ import android.content.ComponentName
4
+ import android.os.Binder
5
+ import android.os.Bundle
6
+ import android.os.Looper
7
+ import androidx.media3.common.HeartRating
8
+ import androidx.media3.session.MediaSession
9
+ import androidx.media3.session.SessionResult
10
+ import com.audiobrowser.model.PlayerUpdateOptions
11
+ import com.audiobrowser.util.TrackFactory
12
+ import org.junit.After
13
+ import org.junit.Assert.assertEquals
14
+ import org.junit.Test
15
+ import org.junit.runner.RunWith
16
+ import org.robolectric.Robolectric
17
+ import org.robolectric.RobolectricTestRunner
18
+ import org.robolectric.RuntimeEnvironment
19
+ import org.robolectric.Shadows.shadowOf
20
+
21
+ /**
22
+ * Media3 hands a legacy controller's `setRating` to the callback that names a media id, with the
23
+ * current item's id. Robolectric cannot route a MediaControllerCompat to the session, so these call
24
+ * that callback as Media3 does.
25
+ */
26
+ @RunWith(RobolectricTestRunner::class)
27
+ class LegacyRatingTest {
28
+
29
+ private val controller = run {
30
+ val application = RuntimeEnvironment.getApplication()
31
+ shadowOf(application)
32
+ .setComponentNameAndServiceForBindService(
33
+ ComponentName(application, HeadlessTaskService::class.java),
34
+ Binder(),
35
+ )
36
+ Robolectric.buildService(Service::class.java).create()
37
+ }
38
+ private val service = controller.get()
39
+ private val player = service.player
40
+ private val legacyController =
41
+ MediaSession.ControllerInfo.createTestOnlyControllerInfo(
42
+ "legacy",
43
+ 0,
44
+ 0,
45
+ MediaSession.ControllerInfo.LEGACY_CONTROLLER_VERSION,
46
+ MediaSession.ControllerInfo.LEGACY_CONTROLLER_INTERFACE_VERSION,
47
+ false,
48
+ Bundle.EMPTY,
49
+ false,
50
+ )
51
+ private val session = service.onGetSession(legacyController)
52
+
53
+ @After
54
+ fun destroy() {
55
+ controller.destroy()
56
+ TrackFactory.favoriteEnabled = false
57
+ }
58
+
59
+ private fun idle() = shadowOf(Looper.getMainLooper()).idle()
60
+
61
+ private fun rate(mediaId: String, heart: Boolean): Int {
62
+ val result =
63
+ player
64
+ .getMediaSessionCallback()
65
+ .onSetRating(session, legacyController, mediaId, HeartRating(heart))
66
+ .get()
67
+ idle()
68
+ return result.resultCode
69
+ }
70
+
71
+ private fun currentMediaId() = session.player.currentMediaItem!!.mediaId
72
+
73
+ private fun loadTrack() {
74
+ controller.bind()
75
+ player.applyOptions(
76
+ PlayerUpdateOptions().let { it.copy(capabilities = it.capabilities.copy(favorite = true)) }
77
+ )
78
+ player.load(TestFixtures.track(id = "a", favorited = false))
79
+ idle()
80
+ }
81
+
82
+ @Test
83
+ fun `a rating of the current item sets its favorite and USER_RATING`() {
84
+ loadTrack()
85
+
86
+ assertEquals(SessionResult.RESULT_SUCCESS, rate(currentMediaId(), true))
87
+ assertEquals(true, player.currentTrack?.favorited)
88
+ assertEquals(HeartRating(true), session.player.mediaMetadata.userRating)
89
+
90
+ assertEquals(SessionResult.RESULT_SUCCESS, rate(currentMediaId(), false))
91
+ assertEquals(false, player.currentTrack?.favorited)
92
+ assertEquals(HeartRating(false), session.player.mediaMetadata.userRating)
93
+ }
94
+
95
+ @Test
96
+ fun `a rating of another item leaves the favorite`() {
97
+ loadTrack()
98
+
99
+ assertEquals(SessionResult.RESULT_ERROR_NOT_SUPPORTED, rate("b", true))
100
+ assertEquals(false, player.currentTrack?.favorited)
101
+ assertEquals(HeartRating(false), session.player.mediaMetadata.userRating)
102
+ }
103
+ }
@@ -0,0 +1,22 @@
1
+ package com.audiobrowser
2
+
3
+ import com.margelo.nitro.audiobrowser.Output
4
+ import com.margelo.nitro.audiobrowser.OutputType
5
+ import org.junit.Assert.assertEquals
6
+ import org.junit.Assert.assertNull
7
+ import org.junit.Test
8
+
9
+ class RemoteOutputsTest {
10
+ @Test
11
+ fun `a selected route in the category is a remote output`() {
12
+ assertEquals(
13
+ Output(type = OutputType.REMOTE, name = "Kitchen", external = true),
14
+ remoteOutputOf("Kitchen", offersCategory = true),
15
+ )
16
+ }
17
+
18
+ @Test
19
+ fun `a selected route outside the category leaves the output to the local device`() {
20
+ assertNull(remoteOutputOf("Living room TV", offersCategory = false))
21
+ }
22
+ }
@@ -0,0 +1,101 @@
1
+ package com.audiobrowser
2
+
3
+ import android.content.ComponentName
4
+ import android.content.Intent
5
+ import android.content.ServiceConnection
6
+ import android.os.IBinder
7
+ import org.junit.Assert.assertEquals
8
+ import org.junit.Assert.assertFalse
9
+ import org.junit.Assert.assertTrue
10
+ import org.junit.Test
11
+ import org.junit.runner.RunWith
12
+ import org.robolectric.RobolectricTestRunner
13
+ import org.robolectric.RuntimeEnvironment
14
+ import org.robolectric.Shadows.shadowOf
15
+
16
+ // Robolectric: bindService/unbindService only exist under the framework, and ShadowApplication
17
+ // records both sides — which is precisely the leak being guarded against.
18
+ @RunWith(RobolectricTestRunner::class)
19
+ class ServiceBindingTest {
20
+
21
+ private val app = RuntimeEnvironment.getApplication()
22
+ private val intent = Intent(app, Service::class.java)
23
+ private val unbindableIntent = Intent("unbindable").setPackage(app.packageName)
24
+
25
+ private val connection =
26
+ object : ServiceConnection {
27
+ override fun onServiceConnected(name: ComponentName?, service: IBinder?) = Unit
28
+
29
+ override fun onServiceDisconnected(name: ComponentName?) = Unit
30
+ }
31
+
32
+ /** Both the auto-bind at construction and setup's bind reach the same object. */
33
+ @Test
34
+ fun bindingTwiceTakesOnlyOneBinding() {
35
+ val binding = ServiceBinding(app)
36
+
37
+ assertTrue(binding.bind(intent, connection))
38
+ assertTrue(binding.bind(intent, connection))
39
+
40
+ assertEquals(1, shadowOf(app).boundServiceConnections.size)
41
+
42
+ binding.unbind(connection)
43
+
44
+ assertTrue(shadowOf(app).boundServiceConnections.isEmpty())
45
+ assertEquals(1, shadowOf(app).unboundServiceConnections.size)
46
+ }
47
+
48
+ /** dispose() must not throw, and Android throws when unbinding a connection it never had. */
49
+ @Test
50
+ fun unbindWithoutBindIsANoOp() {
51
+ val binding = ServiceBinding(app)
52
+
53
+ binding.unbind(connection)
54
+
55
+ assertFalse(binding.isBound)
56
+ assertTrue(shadowOf(app).unboundServiceConnections.isEmpty())
57
+ }
58
+
59
+ /**
60
+ * Android registers the connection before it asks the ActivityManager, so a false return still
61
+ * leaves a binding to release. Treating false as "nothing bound" strands it permanently — the
62
+ * leak this class exists to prevent.
63
+ */
64
+ @Test
65
+ fun failedBindStillHoldsAConnectionToRelease() {
66
+ val binding = ServiceBinding(app)
67
+ shadowOf(app).declareActionUnbindable("unbindable")
68
+
69
+ assertFalse(binding.bind(unbindableIntent, connection))
70
+
71
+ assertTrue(binding.isBound)
72
+
73
+ binding.unbind(connection)
74
+
75
+ assertEquals(1, shadowOf(app).unboundServiceConnections.size)
76
+ }
77
+
78
+ /**
79
+ * setupPlayer binds after the auto-bind at construction already has. If that first bind failed,
80
+ * the service never connects, so setup must hear false and reject rather than wait for it.
81
+ */
82
+ @Test
83
+ fun bindingAgainAfterAFailedBindReportsTheFailure() {
84
+ val binding = ServiceBinding(app)
85
+ shadowOf(app).declareActionUnbindable("unbindable")
86
+
87
+ assertFalse(binding.bind(unbindableIntent, connection))
88
+ assertFalse(binding.bind(unbindableIntent, connection))
89
+ }
90
+
91
+ @Test
92
+ fun unbindIsIdempotent() {
93
+ val binding = ServiceBinding(app)
94
+ binding.bind(intent, connection)
95
+
96
+ binding.unbind(connection)
97
+ binding.unbind(connection)
98
+
99
+ assertEquals(1, shadowOf(app).unboundServiceConnections.size)
100
+ }
101
+ }