react-native-queue-player 1.0.2 → 1.0.4

package/ios/TrackPlayer.swift

@@ -424,6 +424,9 @@ class TrackPlayer: HybridTrackPlayerSpec {
   // first track needs the same initial-buffer leniency.
   private var currentItemObserver: NSKeyValueObservation?
   private var currentItemStatusObserver: NSKeyValueObservation?
+  // Duration can resolve a beat AFTER `.status` reaches `.readyToPlay`; observe
+  // it so the lock-screen duration lands even in that race.
+  private var currentItemDurationObserver: NSKeyValueObservation?
   private var gaplessFlipArmed: Bool = true
 
   /// Set to true by the `AVPlayerItemDidPlayToEndTime` notification
@@ -666,24 +669,11 @@ class TrackPlayer: HybridTrackPlayerSpec {
         break
       }
 
-      // Surface the interruption kind as a typed non-fatal
-      // `PlaybackError` so JS consumers can branch on the resume
-      // hint without inspecting a boolean. Wire literals + messages
-      // come from `InterruptionEventMapping` (single source of
-      // truth for the three nativeDomain strings).
-      let domain = InterruptionEventMapping.nativeDomain(for: kind)
-      let message = InterruptionEventMapping.message(for: kind)
-      let err = PlaybackError(
-        code: .unknown,
-        message: message,
-        fatal: false,
-        nativeCode: 0,
-        nativeDomain: domain,
-        nativeMessage: message,
-        queueItemId: "",
-        url: ""
-      )
-      self.errorListeners.forEach { $0(err) }
+      // An interruption is a normal lifecycle signal (call / Siri / a route
+      // handoff), NOT a playback error — surfacing it on the `onError` stream
+      // makes consumers render an error banner for a routine pause. The pause
+      // is already reported via the `.paused` state stamped with
+      // `reason = .interruption`, which is the correct, non-error signal.
     }
 
     self.audioSession.onRouteChange = { [weak self] kind in
@@ -992,6 +982,8 @@ class TrackPlayer: HybridTrackPlayerSpec {
   private func attachStatusObserverIfArmed() {
     currentItemStatusObserver?.invalidate()
     currentItemStatusObserver = nil
+    currentItemDurationObserver?.invalidate()
+    currentItemDurationObserver = nil
     tearDownBufferObservers()
     guard let item = self.player?.currentItem else {
       // No current item (empty queue / torn down) — settle to empty.
@@ -1034,6 +1026,14 @@ class TrackPlayer: HybridTrackPlayerSpec {
       }
     }
     self.dispatchItemStatus(item)
+    currentItemDurationObserver = item.observe(
+      \.duration, options: [.new]
+    ) { [weak self] _, _ in
+      guard let self else { return }
+      DispatchQueue.main.async {
+        self.nowPlayingInfo.refreshPositionAndRate()
+      }
+    }
     installBufferObservers(on: item)
   }
 
@@ -1086,6 +1086,11 @@ class TrackPlayer: HybridTrackPlayerSpec {
       // idempotent on items that already carry a tap, so a double-
       // fire is harmless.
       AudioTapProvider.shared.refreshActiveItemMixes()
+      // Duration is only reliably readable once the item is `.readyToPlay`.
+      // Re-publish now-playing so the lock-screen scrubber gets a duration on
+      // first load + auto-advance (not just after a manual skip, which is the
+      // only path that otherwise forces a state change that re-publishes it).
+      self.nowPlayingInfo.refreshPositionAndRate()
     case .failed:
       // Pause synchronously BEFORE surfacing the typed error. Without
       // this, AVQueuePlayer treats `.failed` as end-of-item and chain-
@@ -1191,6 +1196,8 @@ class TrackPlayer: HybridTrackPlayerSpec {
     currentItemObserver = nil
     currentItemStatusObserver?.invalidate()
     currentItemStatusObserver = nil
+    currentItemDurationObserver?.invalidate()
+    currentItemDurationObserver = nil
     tearDownBufferObservers()
   }
 
@@ -2043,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
@@ -2591,6 +2597,13 @@ class TrackPlayer: HybridTrackPlayerSpec {
       nowMs: Self.nowEpochMs(),
       trackDurationSec: durationSec,
       trackPositionSec: positionSec)
+    applySleepTimerResult(result)
+  }
+
+  /// Apply a `SleepTimerCore.Tick` decision to the engine — fade, state emit,
+  /// and the boundary pause. Shared by the polling tick and the real track-end
+  /// signal (`handlePlayerItemDidPlayToEndTime`).
+  private func applySleepTimerResult(_ result: SleepTimerCore.Tick) {
     applySleepTimerFade(result.fadeFraction)
     if result.stateChanged { emitSleepTimerChanged() }
     if result.pauseNow {
@@ -3766,6 +3779,12 @@ class TrackPlayer: HybridTrackPlayerSpec {
   @objc private func handlePlayerItemDidPlayToEndTime(_ notification: Notification) {
     DispatchQueue.main.async { [weak self] in
       guard let self else { return }
+      // End-of-track sleep timer: pause at the current track's real end —
+      // before the repeat-track rewind or the auto-advance — so the pause
+      // lands exactly at the boundary and fires even when the track duration
+      // was never known. Under repeat-one this pauses at the first natural end.
+      let sleepFired = self.sleepTimerCore.fireAtTrackEnd()
+      if sleepFired.pauseNow { self.applySleepTimerResult(sleepFired) }
       // Branch on repeat-track FIRST, separately from the
       // currentItem === item check. The notification dispatches
       // async to main but AVQueuePlayer
@@ -3796,8 +3815,10 @@ class TrackPlayer: HybridTrackPlayerSpec {
              player.currentItem === item {
             item.seek(to: .zero, completionHandler: nil)
             // Replay through the engine so the user's playback speed is
-            // restored (a raw AVPlayer.play() resets rate to 1.0).
-            self.engine?.play()
+            // restored (a raw AVPlayer.play() resets rate to 1.0) — unless the
+            // end-of-track sleep timer just fired, in which case we pause at
+            // this natural end instead of looping.
+            if !sleepFired.pauseNow { self.engine?.play() }
           }
         }
         // If the rewind window was lost (player chain-advanced
@@ -4162,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":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EAChB,MAAM,SAAS,CAAC;AAMjB,MAAM,WAAW,WACf,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;IAEzD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C;;;;;;;;;;OAUG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAGzB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD;;;;;;;;;OASG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D;;;;;;;;;;OAUG;IACH,QAAQ,IAAI,SAAS,EAAE,CAAC;IACxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAG5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;;;;;OAOG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAGhC,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD;;;;;;OAMG;IACH,eAAe,IAAI,YAAY,CAAC;IAChC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C;;;;;;;;;;;;;OAaG;IACH,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,wBAAwB;IACxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C;;;;;;;OAOG;IACH,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE;;;;;;;;;;OAUG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C;;;;;OAKG;IACH,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,oEAAoE;IACpE,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC;;;;;;;;;;;;;;;OAeG;IACH,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAGvC,QAAQ,IAAI,WAAW,CAAC;IACxB;;;;;;;OAOG;IACH,oBAAoB,IAAI,MAAM,CAAC;IAC/B;;;;;;;;;;;;;;OAcG;IACH,qBAAqB,IAAI,WAAW,GAAG,SAAS,CAAC;IACjD,gBAAgB,IAAI,MAAM,CAAC;IAC3B,qEAAqE;IACrE,sBAAsB,IAAI,mBAAmB,CAAC;IAC9C,SAAS,IAAI,MAAM,CAAC;IACpB,6EAA6E;IAC7E,iBAAiB,IAAI,oBAAoB,CAAC;IAC1C;;;;OAIG;IACH,cAAc,IAAI,WAAW,CAAC;IAC9B;;;;;;;OAOG;IACH,aAAa,IAAI,OAAO,CAAC;IACzB;;;;;;;OAOG;IACH,eAAe,IAAI,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;OAeG;IACH,cAAc,IAAI,OAAO,CAAC;IAC1B;;;;;;;;;;;;;OAaG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAC9B;;;;;;;;OAQG;IACH,iBAAiB,IAAI,cAAc,CAAC;IACpC,mEAAmE;IACnE,aAAa,IAAI,eAAe,CAAC;IAGjC,aAAa,CACX,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAChE,MAAM,IAAI,CAAC;IACd;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,aAAa,CACX,QAAQ,EAAE,CACR,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,MAAM,GAAG,SAAS,KAChC,IAAI,GACR,MAAM,IAAI,CAAC;IACd;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,mBAAmB,CACjB,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GACxD,MAAM,IAAI,CAAC;IACd,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9D,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC7C;;;;;;;;;;;;;;;;;OAiBG;IACH,sBAAsB,CACpB,QAAQ,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,GAC7C,MAAM,IAAI,CAAC;IACd;;;;;;OAMG;IACH,kBAAkB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC3E;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACxE;;;;;OAKG;IACH,qBAAqB,CAAC,QAAQ,EAAE,CAAC,aAAa,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAO9E;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAElD;;;;OAIG;IACH,eAAe,CACb,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,GACpD,MAAM,IAAI,CAAC;IAEd;;;;;OAKG;IACH,eAAe,CACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,GACjD,MAAM,IAAI,CAAC;IAEd;;;;;;;;;;;;OAYG;IACH,uBAAuB,CACrB,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,GAC9D,MAAM,IAAI,CAAC;IAEd;;;OAGG;IACH,mBAAmB,CACjB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,GAClD,MAAM,IAAI,CAAC;IAEd;;;;;;;;;;;;OAYG;IACH,qBAAqB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IAEzD;;;;;;OAMG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE/C;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAElD;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,GAC7C,MAAM,IAAI,CAAC;IAGd;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,uBAAuB,IAAI,WAAW,CAAC;IACvC;;;;;;OAMG;IACH,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,2CAA2C;IAC3C,iBAAiB,IAAI,cAAc,CAAC;IAEpC;;;;;;;;OAQG;IACH,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAAC;IAC/C;;;;;;OAMG;IACH,wBAAwB,CACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,GAClD,MAAM,IAAI,CAAC;CACf"}
+{"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.2",
+  "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-

package/ios/InterruptionEventMapping.swift

@@ -1,51 +0,0 @@
-import Foundation
-
-/// Maps `AudioSession.InterruptionKind` to the lib-standardized
-/// `nativeDomain` string + a stable human-readable message used by
-/// `TrackPlayer.wireAudioSession()` when firing the corresponding
-/// non-fatal `PlaybackError` through `errorListeners`.
-///
-/// Pure function; no instance state. Mirrors `PlaybackErrorMapping`.
-///
-/// Three `nativeDomain` strings — all share the
-/// `AUDIO_SESSION_INTERRUPTION_` prefix so JS consumers can branch
-/// on `nativeDomain.startsWith(...)` and treat any
-/// audio-session-interruption variant as a single category when they
-/// don't care about the resume-hint sub-state. `.endedShouldNotResume`
-/// maps to the bare `..._ENDED` (no `_SHOULD_NOT_RESUME` suffix) so
-/// consumers that ignore the resume-hint variant default to the
-/// "stop" semantics.
-enum InterruptionEventMapping {
-
-  /// Shared prefix for the three interruption `nativeDomain` strings.
-  static let nativeDomainPrefix = "AUDIO_SESSION_INTERRUPTION_"
-
-  /// `nativeDomain` for the supplied interruption kind.
-  static func nativeDomain(for kind: AudioSession.InterruptionKind) -> String {
-    switch kind {
-    case .began:
-      return nativeDomainPrefix + "BEGAN"
-    case .endedShouldResume:
-      return nativeDomainPrefix + "ENDED_SHOULD_RESUME"
-    case .endedShouldNotResume:
-      return nativeDomainPrefix + "ENDED"
-    }
-  }
-
-  /// Human-readable message for the supplied interruption kind.
-  /// Same string is fired as both `message` and `nativeMessage` on
-  /// the resulting `PlaybackError` — there's no lib-mapped vs native
-  /// distinction at this layer (session-scope event, not track-
-  /// scope error).
-  static func message(for kind: AudioSession.InterruptionKind) -> String {
-    switch kind {
-    case .began:
-      return "Audio session interruption began"
-    case .endedShouldResume:
-      return "Audio session interruption ended; system suggests resume"
-    case .endedShouldNotResume:
-      return "Audio session interruption ended"
-    }
-  }
-
-}

package/ios/Tests/InterruptionEventMappingTests.swift

@@ -1,91 +0,0 @@
-import XCTest
-@testable import QueuePlayer
-
-/// `InterruptionEventMapping` is a pure-function namespace mapping
-/// `AudioSession.InterruptionKind` to the lib-standardized
-/// `nativeDomain` string + a stable human-readable message + the
-/// non-fatal `PlaybackError` that `TrackPlayer.wireAudioSession()`
-/// fires through `errorListeners`.
-final class InterruptionEventMappingTests: XCTestCase {
-
-  // MARK: - nativeDomain
-
-  func testNativeDomainBeganIsBeganLiteral() {
-    XCTAssertEqual(
-      InterruptionEventMapping.nativeDomain(for: .began),
-      "AUDIO_SESSION_INTERRUPTION_BEGAN"
-    )
-  }
-
-  func testNativeDomainEndedShouldResumeIsResumeHintLiteral() {
-    XCTAssertEqual(
-      InterruptionEventMapping.nativeDomain(for: .endedShouldResume),
-      "AUDIO_SESSION_INTERRUPTION_ENDED_SHOULD_RESUME"
-    )
-  }
-
-  func testNativeDomainEndedShouldNotResumeIsBareEndedLiteral() {
-    XCTAssertEqual(
-      InterruptionEventMapping.nativeDomain(for: .endedShouldNotResume),
-      "AUDIO_SESSION_INTERRUPTION_ENDED"
-    )
-  }
-
-  func testAllInterruptionDomainsShareTheBranchablePrefix() {
-    let kinds: [AudioSession.InterruptionKind] = [
-      .began, .endedShouldResume, .endedShouldNotResume,
-    ]
-    for kind in kinds {
-      let domain = InterruptionEventMapping.nativeDomain(for: kind)
-      XCTAssertTrue(
-        domain.hasPrefix(InterruptionEventMapping.nativeDomainPrefix),
-        "domain for \(kind) must use the consumer-branchable prefix; got \(domain)"
-      )
-    }
-  }
-
-  func testTheThreeDomainsAreExactlyTheSetOfWireLiterals() {
-    let domains: Set<String> = [
-      InterruptionEventMapping.nativeDomain(for: .began),
-      InterruptionEventMapping.nativeDomain(for: .endedShouldResume),
-      InterruptionEventMapping.nativeDomain(for: .endedShouldNotResume),
-    ]
-    XCTAssertEqual(domains, [
-      "AUDIO_SESSION_INTERRUPTION_BEGAN",
-      "AUDIO_SESSION_INTERRUPTION_ENDED_SHOULD_RESUME",
-      "AUDIO_SESSION_INTERRUPTION_ENDED",
-    ], "wire-protocol literals must not drift; rename = breaking change for JS consumers")
-  }
-
-  // MARK: - message
-
-  func testMessagesAreNonEmpty() {
-    let kinds: [AudioSession.InterruptionKind] = [
-      .began, .endedShouldResume, .endedShouldNotResume,
-    ]
-    for kind in kinds {
-      XCTAssertFalse(
-        InterruptionEventMapping.message(for: kind).isEmpty,
-        "message for \(kind) must be non-empty"
-      )
-    }
-  }
-
-  func testMessagesAreDistinctPerKind() {
-    let began = InterruptionEventMapping.message(for: .began)
-    let resume = InterruptionEventMapping.message(for: .endedShouldResume)
-    let ended = InterruptionEventMapping.message(for: .endedShouldNotResume)
-    XCTAssertNotEqual(began, resume)
-    XCTAssertNotEqual(began, ended)
-    XCTAssertNotEqual(resume, ended)
-  }
-
-  // PlaybackError construction lives inline at the call site in
-  // `TrackPlayer.wireAudioSession()` — Swift cxx-interop excludes
-  // internal helpers that return C++-bridged types like
-  // `PlaybackError` from the `@testable import` swiftmodule export,
-  // so the construction can't be invoked from an XCTest target. The
-  // wire literals + messages are pinned by the tests above; full-
-  // path coverage lives in the Maestro `interruption-handling`
-  // suite.
-}