react-native-queue-player 1.0.3 → 1.0.4

package/ios/Tests/EQProcessorTests.swift

@@ -1,10 +1,7 @@
 import XCTest
 @testable import QueuePlayer
 
-/// Unit coverage for `EQProcessor` cascade. Audible response
-/// (sine-sweep magnitude per band) is verified at the integration
-/// layer via the demo Maestro EQ suite once the AVPlayerItem mix
-/// attach path is wired.
+/// Unit coverage for `EQProcessor` cascade.
 final class EQProcessorTests: XCTestCase {
 
   func testIsNotReadyBeforeChannelCountSet() {

package/ios/Tests/EQTapTests.swift

@@ -4,8 +4,7 @@ import XCTest
 
 /// Skeleton coverage for `EQTap` — tap creation, HLS detection,
 /// pass-through process body. The actual tap firing is on the
-/// audio render thread and verified at the integration layer via
-/// the demo Maestro EQ suite once the DSP body lands.
+/// audio render thread.
 final class EQTapTests: XCTestCase {
 
   func testPassThroughCopiesInputToOutput() {

package/ios/Tests/EqualizerAudioMixProviderTests.swift

@@ -2,10 +2,9 @@ import AVFoundation
 import XCTest
 @testable import QueuePlayer
 
-/// Provider-layer coverage for the shared `AudioTapProvider`. Real
-/// audio routing is verified at the integration layer via the demo
-/// Maestro EQ + visualizer suites; these tests cover the
-/// configuration + bypass + consumer-registration surface.
+/// Provider-layer coverage for the shared `AudioTapProvider`. These
+/// tests cover the configuration + bypass + consumer-registration
+/// surface.
 ///
 /// Filename note: kept at `EqualizerAudioMixProviderTests.swift`
 /// even though the class is `AudioTapProviderTests`. Renaming the

package/ios/Tests/EqualizerHybridTests.swift

@@ -3,9 +3,7 @@ import XCTest
 @testable import QueuePlayer
 
 /// Wiring coverage for the iOS `Equalizer` HybridObject.
-/// Targets the synchronous internal core; the async Promise-
-/// returning surface is exercised at integration via the demo
-/// Maestro EQ suite.
+/// Targets the synchronous internal core.
 final class EqualizerHybridTests: XCTestCase {
 
   private var defaults: UserDefaults!

package/ios/Tests/FFTProcessorTests.swift

@@ -243,9 +243,7 @@ final class FFTProcessorTests: XCTestCase {
     // `ingest` resumes, `onFrame` fires again at the documented
     // intervalMs cadence. Live audio chains express "pause" by
     // ceasing tap callbacks; the unit-test analogue is a sleep
-    // window. End-to-end pause/play coverage lives in the
-    // `visualizer:*` integration suite's `pause-stops-resume-restarts`
-    // step.
+    // window.
     let n = 256
     let intervalMs = 1
     let lock = NSLock()

package/ios/Tests/GaplessEngineLifecycleTests.swift

@@ -4,8 +4,6 @@ import XCTest
 
 /// Lifecycle smoke coverage for `GaplessEngine` — empty-queue
 /// sentinels + idempotent / delegate-clearing release contract.
-/// Behavioural coverage of transport + seek runs through the
-/// existing TrackPlayer integration suites + Maestro flows.
 final class GaplessEngineLifecycleTests: XCTestCase {
 
   func testEmptyQueueReturnsDocumentedSentinelState() {

package/ios/Tests/LookaheadCacheEvictionTests.swift

@@ -4,10 +4,7 @@ import XCTest
 
 /// `LookaheadCacheEviction.computeEvictions` unit tests.
 ///
-/// Pure-logic LRU policy. Plain JUnit-equivalent — no FS access, no
-/// URLSession. File + index mutation is tested through the
-/// LookaheadCacheTests integration path that drives `download` past
-/// the budget.
+/// Pure-logic LRU policy. No FS access, no URLSession.
 final class LookaheadCacheEvictionTests: XCTestCase {
 
   func testNoEvictionWhenUnderBudget() {

package/ios/Tests/MetadataReaderTests.swift

@@ -4,8 +4,6 @@ import XCTest
 /// Byte-level unit tests for `MetadataReader`'s container parsers.
 /// Builds synthetic ID3v2 / FLAC / MP4 byte sequences in-memory and
 /// verifies tag extraction surfaces the expected `[key: value]` map.
-/// End-to-end "extract from a real media file" coverage lives in
-/// the auto-suite `replaygain.ts`.
 final class MetadataReaderTests: XCTestCase {
 
   // MARK: - ID3v2 TXXX

package/ios/Tests/MilestoneTrackerTests.swift

@@ -2,9 +2,7 @@ import XCTest
 @testable import QueuePlayer
 
 /// Unit tests for `MilestoneTracker` — the pure 25/50/75/90% crossing
-/// logic behind `onPlaybackMilestone`. Native wiring (progress tick,
-/// seek, track-change reset) is covered by the `playback-milestones`
-/// demo suite.
+/// logic behind `onPlaybackMilestone`.
 final class MilestoneTrackerTests: XCTestCase {
 
   /// 200s track, ticks every ~10s of media time.

package/ios/Tests/NowPlayingFormatExtractorTests.swift

@@ -3,10 +3,9 @@ import CoreMedia
 import XCTest
 @testable import QueuePlayer
 
-/// Pure-mapping coverage for `NowPlayingFormatExtractor`. The async
-/// `extract(item:)` path is exercised end-to-end through the demo
-/// suites; these tests pin the codec / container / MIME tables so a
-/// future contributor can't drift the JS-visible enum without a test
+/// Pure-mapping coverage for `NowPlayingFormatExtractor`. These
+/// tests pin the codec / container / MIME tables so a future
+/// contributor can't drift the JS-visible enum without a test
 /// failure.
 final class NowPlayingFormatExtractorTests: XCTestCase {
 

package/ios/Tests/PlaybackErrorMappingTests.swift

@@ -5,9 +5,6 @@ import AVFoundation
 
 /// Unit tests for the iOS half of the cross-platform error-code
 /// mapping in `PlaybackErrorMapping.swift`.
-/// Mirrors the Android-side coverage in
-/// `TrackPlayerEventsTest.kt#error mapping classifies Media3 codes`
-/// + `error mapping strips query strings`.
 ///
 /// **Why string-keyed assertions?** NOTES.md §6 — Swift's
 /// `-cxx-interoperability-mode=default` hides members of functions

package/ios/Tests/PlaybackModeStateMachineTests.swift

@@ -3,15 +3,11 @@ import XCTest
 
 /// Coverage for the pure-Swift `CrossfadeDurationBounds` helper that
 /// powers `PlaybackModeStateMachine.requireValid`. Full state-machine
-/// validation coverage (constructing `PlaybackMode` instances + driving
-/// `setRequested`) lives in the Android Robolectric suite — `PlaybackMode`
-/// is bridged via Nitro `@_spi` and can't be constructed from a Swift
-/// XCTest target, so the throws path is exercised end-to-end via the
-/// in-app TS test runner's `playback-mode` suite (the
-/// `crossfade-duration-out-of-range-rejected` and
-/// `crossfade-duration-non-quantised-rejected` steps in
-/// `RNQP-Demo/src/tests/suites/playback-mode.ts`). Mirrors the
-/// cxx-interop carve-out already documented in AGENTS.md §2.
+/// validation (constructing `PlaybackMode` instances + driving
+/// `setRequested`) is out of scope here — `PlaybackMode` is bridged
+/// via Nitro `@_spi` and can't be constructed from a Swift XCTest
+/// target. Mirrors the cxx-interop carve-out already documented in
+/// AGENTS.md §2.
 final class PlaybackModeStateMachineTests: XCTestCase {
 
   func testCrossfadeBoundsHelperAcceptsEveryValueOnTheStep() {

package/ios/Tests/PlayerStateDerivationTests.swift

@@ -3,8 +3,7 @@ import XCTest
 @testable import QueuePlayer
 
 /// Unit tests for `PlayerStateDerivation` — the pure `PlayerState` mapping
-/// shared by both engines. Native wiring (getState + the two emit paths + the
-/// end-of-queue latch) is covered by the queue-end / crossfade demo suites.
+/// shared by both engines.
 final class PlayerStateDerivationTests: XCTestCase {
 
   private func derive(

package/ios/Tests/ProgressEmissionGateTests.swift

@@ -2,9 +2,7 @@ import XCTest
 @testable import QueuePlayer
 
 /// Unit tests for `ProgressEmissionGate` — the pure throttle behind the
-/// configurable / background-reduced `onProgress` cadence. Native wiring
-/// (the periodic tick, the cast push, and the UIApplication background /
-/// foreground observers) is covered by the progress demo suites.
+/// configurable / background-reduced `onProgress` cadence.
 ///
 /// Most tests pass `samplerPeriodMs: 0` to exercise exact interval semantics;
 /// the jitter + quantization tests pass the production `500` to verify the

package/ios/Tests/QueueMutationArithmeticTests.swift

@@ -3,9 +3,6 @@ import XCTest
 @_spi(QueuePlayerTests) import QueuePlayer
 
 /// Pure-Swift tests for the queue-mutation index-shift arithmetic.
-/// 1:1 mirror of `android/.../QueueMutationArithmeticTest.kt` —
-/// every Kotlin test name has a Swift twin so the cross-platform
-/// matrix stays in lock-step.
 final class QueueMutationArithmeticTests: XCTestCase {
 
   // MARK: - clampInsertBefore

package/ios/Tests/RemoteCommandsTests.swift

@@ -6,11 +6,8 @@ import XCTest
 /// registrations + the per-command `isEnabled` state. Tests pin the
 /// install / uninstall lifecycle and the `setSkipCapability` ->
 /// `nextTrackCommand.isEnabled` / `previousTrackCommand.isEnabled`
-/// mapping. Dispatch into the owner's `onCommand` closure is verified
-/// at the integration layer (Maestro suite + JS-visible reason
-/// classification); attempting to fire `MPRemoteCommandCenter`
-/// handlers from XCTest would require lib-side SPI we deliberately
-/// do not ship.
+/// mapping. Attempting to fire `MPRemoteCommandCenter` handlers from
+/// XCTest would require lib-side SPI we deliberately do not ship.
 ///
 /// The shared command center is process-global. `setUp` resets all
 /// seven commands the lib touches, `tearDown` calls `uninstall()` to

package/ios/Tests/ReplayGainExtractorTests.swift

@@ -4,11 +4,6 @@ import XCTest
 /// Unit tests for `ReplayGainExtractor`'s pure string parsers
 /// (`parseGainDb`, `parsePeak`) and the `selectGain(mode:)` matrix
 /// on `ReplayGainData`.
-///
-/// Container-level extraction (ID3v2 TXXX, FLAC Vorbis, MP4
-/// freeform) is covered by `MetadataReaderTests`. End-to-end
-/// extraction-on-load is covered by the auto-suite `replaygain.ts`
-/// step.
 final class ReplayGainExtractorTests: XCTestCase {
 
   // Helper: `XCTAssertEqual` with the `accuracy:` overload requires

package/ios/Tests/SkipCapabilityTests.swift

@@ -2,15 +2,12 @@ import XCTest
 @testable import QueuePlayer
 @_spi(QueuePlayerTests) import QueuePlayer
 
-/// Integration tests for the canSkip surface + `onSkipCapabilityChange`
-/// listener emission. Pairs with the pure-helper coverage in
-/// `SkipIndexTests` (`canSkipNext` / `canSkipPrevious`).
+/// Tests for the canSkip surface + `onSkipCapabilityChange`
+/// listener emission.
 ///
-/// XCTest can cover only the cases where `configure(...)` has not yet
+/// Covers the cases where `configure(...)` has not yet
 /// stood up an AVQueuePlayer — initial cached-getter state, listener
-/// registration + auto-fire, dispose closure correctness. Behavioural
-/// coverage of every `recomputeCapabilities()` hook point lives in
-/// the Robolectric sibling and the end-to-end demo suite.
+/// registration + auto-fire, dispose closure correctness.
 final class SkipCapabilityTests: XCTestCase {
 
   func testGetCanSkipNextReturnsFalseInitially() throws {

package/ios/Tests/VoiceDonationTests.swift

@@ -4,10 +4,10 @@ import XCTest
 @_spi(QueuePlayerTests) import QueuePlayer
 
 /// Smoke coverage for `VoiceDonation.donateVoiceVocabulary`. Live
-/// `INVocabulary` delivery is verified via the manual siri-cold-start
-/// playbook; this test pins the in-process contract that the method
-/// early-returns when `NSSiriUsageDescription` is absent from the
-/// host bundle (the XCTest bundle's plist).
+/// `INVocabulary` delivery isn't exercised here; this test pins the
+/// in-process contract that the method early-returns when
+/// `NSSiriUsageDescription` is absent from the host bundle (the XCTest
+/// bundle's plist).
 @available(iOS 13.0, *)
 final class VoiceDonationTests: XCTestCase {
   func testDonateVoiceVocabularyEarlyReturnsWithoutUsageDescription() {

package/ios/TrackPlayer.swift

@@ -2050,8 +2050,7 @@ class TrackPlayer: HybridTrackPlayerSpec {
 
   /// Map the Nitrogen-generated `RepeatMode` enum onto the pure-Swift
   /// `QueueSkipRepeatMode` so `QueueSkipArithmetic` can stay off the
-  /// Swift ↔ C++ interop path (needed so XCTest targets reach the
-  /// arithmetic without C++-interop friction).
+  /// Swift ↔ C++ interop path.
   private func repeatModeAsSkipMode() -> QueueSkipRepeatMode {
     switch self.repeatModeState {
     case .off: return .off
@@ -4184,6 +4183,10 @@ class TrackPlayer: HybridTrackPlayerSpec {
     return CarPlayCoordinator.shared.bridge.registerOnCarDisconnect(callback)
   }
 
+  func isCarConnected() throws -> Bool {
+    return CarPlayCoordinator.shared.isCarConnected
+  }
+
   // MARK: - Lookahead cache — runtime config + status surface
   func setLookaheadCache(config: LookaheadCacheConfig) throws -> Promise<Void> {
     return Promise<Void>.async {

package/lib/typescript/TrackPlayer.nitro.d.ts

@@ -473,6 +473,23 @@ export interface TrackPlayer extends HybridObject<{
      * automotive-specific subscriptions the consumer set up on connect.
      */
     onCarDisconnect(callback: () => void): () => void;
+    /**
+     * Whether an automotive controller is connected right now. The
+     * pull-based counterpart to `onCarConnect` / `onCarDisconnect`: it holds
+     * the same state those events transition between, so a consumer that
+     * missed the connect event — e.g. it fired before the consumer registered
+     * its handler in this app process — can still gate car-only work, like
+     * pushing browse snapshots, on the current connection.
+     *
+     * `true` between the first automotive controller connecting and the last
+     * one dropping. "Automotive controller" is the same classification the
+     * connect/disconnect events use: the CarPlay scene on iOS; the headless
+     * Android Auto / Wear / Assistant controllers on Android. Returns `false`
+     * before the first connection and after a full disconnect. The state is
+     * process-scoped: a fresh app process starts disconnected until a
+     * controller connects within it.
+     */
+    isCarConnected(): boolean;
     /**
      * Fires when the platform's media service is freshly bound to the JS
      * side. `reason = 'first-bind'` for the initial bind during a JS-

package/lib/typescript/TrackPlayer.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrackPlayer.nitro.d.ts","sourceRoot":"","sources":["../../src/TrackPlayer.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TrackPlayer.nitro.d.ts","sourceRoot":"","sources":["../../src/TrackPlayer.nitro.ts"],"names":[],"mappings":"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"}

package/nitrogen/generated/android/c++/JHybridTrackPlayerSpec.cpp

@@ -949,6 +949,11 @@ namespace margelo::nitro::queueplayer {
       }
     }();
   }
+  bool JHybridTrackPlayerSpec::isCarConnected() {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jboolean()>("isCarConnected");
+    auto __result = method(_javaPart);
+    return static_cast<bool>(__result);
+  }
   std::function<void()> JHybridTrackPlayerSpec::onServiceReady(const std::function<void(ServiceReadyReason /* reason */)>& callback) {
     static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<JFunc_void::javaobject>(jni::alias_ref<JFunc_void_ServiceReadyReason::javaobject> /* callback */)>("onServiceReady_cxx");
     auto __result = method(_javaPart, JFunc_void_ServiceReadyReason_cxx::fromCpp(callback));

package/nitrogen/generated/android/c++/JHybridTrackPlayerSpec.hpp

@@ -113,6 +113,7 @@ namespace margelo::nitro::queueplayer {
     void donateVoiceVocabulary(const VoiceVocabulary& vocabulary) override;
     std::function<void()> onCarConnect(const std::function<void()>& callback) override;
     std::function<void()> onCarDisconnect(const std::function<void()>& callback) override;
+    bool isCarConnected() override;
     std::function<void()> onServiceReady(const std::function<void(ServiceReadyReason /* reason */)>& callback) override;
     std::shared_ptr<Promise<void>> setLookaheadCache(const LookaheadCacheConfig& config) override;
     CacheStatus getLookaheadCacheStatus() override;

package/nitrogen/generated/android/kotlin/com/margelo/nitro/queueplayer/HybridTrackPlayerSpec.kt

@@ -346,6 +346,10 @@ abstract class HybridTrackPlayerSpec: HybridObject() {
     return Func_void_java(__result)
   }
   
+  @DoNotStrip
+  @Keep
+  abstract fun isCarConnected(): Boolean
+  
   abstract fun onServiceReady(callback: (reason: ServiceReadyReason) -> Unit): () -> Unit
   
   @DoNotStrip

package/nitrogen/generated/ios/c++/HybridTrackPlayerSpecSwift.hpp

@@ -669,6 +669,14 @@ namespace margelo::nitro::queueplayer {
       auto __value = std::move(__result.value());
       return __value;
     }
+    inline bool isCarConnected() override {
+      auto __result = _swiftPart.isCarConnected();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
     inline std::function<void()> onServiceReady(const std::function<void(ServiceReadyReason /* reason */)>& callback) override {
       auto __result = _swiftPart.onServiceReady(callback);
       if (__result.hasError()) [[unlikely]] {

package/nitrogen/generated/ios/swift/HybridTrackPlayerSpec.swift

@@ -72,6 +72,7 @@ public protocol HybridTrackPlayerSpec_protocol: HybridObject {
   func donateVoiceVocabulary(vocabulary: VoiceVocabulary) throws -> Void
   func onCarConnect(callback: @escaping () -> Void) throws -> () -> Void
   func onCarDisconnect(callback: @escaping () -> Void) throws -> () -> Void
+  func isCarConnected() throws -> Bool
   func onServiceReady(callback: @escaping (_ reason: ServiceReadyReason) -> Void) throws -> () -> Void
   func setLookaheadCache(config: LookaheadCacheConfig) throws -> Promise<Void>
   func getLookaheadCacheStatus() throws -> CacheStatus

package/nitrogen/generated/ios/swift/HybridTrackPlayerSpec_cxx.swift

@@ -1255,6 +1255,18 @@ open class HybridTrackPlayerSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func isCarConnected() -> bridge.Result_bool_ {
+    do {
+      let __result = try self.__implementation.isCarConnected()
+      let __resultCpp = __result
+      return bridge.create_Result_bool_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_bool_(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func onServiceReady(callback: bridge.Func_void_ServiceReadyReason) -> bridge.Result_std__function_void____ {
     do {

package/nitrogen/generated/shared/c++/HybridTrackPlayerSpec.cpp

@@ -73,6 +73,7 @@ namespace margelo::nitro::queueplayer {
       prototype.registerHybridMethod("donateVoiceVocabulary", &HybridTrackPlayerSpec::donateVoiceVocabulary);
       prototype.registerHybridMethod("onCarConnect", &HybridTrackPlayerSpec::onCarConnect);
       prototype.registerHybridMethod("onCarDisconnect", &HybridTrackPlayerSpec::onCarDisconnect);
+      prototype.registerHybridMethod("isCarConnected", &HybridTrackPlayerSpec::isCarConnected);
       prototype.registerHybridMethod("onServiceReady", &HybridTrackPlayerSpec::onServiceReady);
       prototype.registerHybridMethod("setLookaheadCache", &HybridTrackPlayerSpec::setLookaheadCache);
       prototype.registerHybridMethod("getLookaheadCacheStatus", &HybridTrackPlayerSpec::getLookaheadCacheStatus);

package/nitrogen/generated/shared/c++/HybridTrackPlayerSpec.hpp

@@ -187,6 +187,7 @@ namespace margelo::nitro::queueplayer {
       virtual void donateVoiceVocabulary(const VoiceVocabulary& vocabulary) = 0;
       virtual std::function<void()> onCarConnect(const std::function<void()>& callback) = 0;
       virtual std::function<void()> onCarDisconnect(const std::function<void()>& callback) = 0;
+      virtual bool isCarConnected() = 0;
       virtual std::function<void()> onServiceReady(const std::function<void(ServiceReadyReason /* reason */)>& callback) = 0;
       virtual std::shared_ptr<Promise<void>> setLookaheadCache(const LookaheadCacheConfig& config) = 0;
       virtual CacheStatus getLookaheadCacheStatus() = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-queue-player",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Nitro Modules audio playback library for React Native — gapless, EQ, crossfade, automotive, voice, casting",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/index.d.ts",

package/src/TrackPlayer.nitro.ts

@@ -549,6 +549,24 @@ export interface TrackPlayer
    */
   onCarDisconnect(callback: () => void): () => void;
 
+  /**
+   * Whether an automotive controller is connected right now. The
+   * pull-based counterpart to `onCarConnect` / `onCarDisconnect`: it holds
+   * the same state those events transition between, so a consumer that
+   * missed the connect event — e.g. it fired before the consumer registered
+   * its handler in this app process — can still gate car-only work, like
+   * pushing browse snapshots, on the current connection.
+   *
+   * `true` between the first automotive controller connecting and the last
+   * one dropping. "Automotive controller" is the same classification the
+   * connect/disconnect events use: the CarPlay scene on iOS; the headless
+   * Android Auto / Wear / Assistant controllers on Android. Returns `false`
+   * before the first connection and after a full disconnect. The state is
+   * process-scoped: a fresh app process starts disconnected until a
+   * controller connects within it.
+   */
+  isCarConnected(): boolean;
+
   /**
    * Fires when the platform's media service is freshly bound to the JS
    * side. `reason = 'first-bind'` for the initial bind during a JS-