@neoskola/auto-play 0.2.7 → 0.2.9

package/ios/scenes/AutoPlayInterfaceController.swift

@@ -51,13 +51,14 @@ class AutoPlayInterfaceController: NSObject, CPInterfaceControllerDelegate {
         _ templateToPush: CPTemplate,
         animated: Bool
     ) async throws -> Bool {
-        // CPNowPlayingTemplate is a singleton — check if already in the stack
+        // CPNowPlayingTemplate.shared must NEVER be pushed via pushTemplate().
+        // Apple's CarPlay framework throws an uncatchable NSException (Objective-C)
+        // when attempting to push this singleton. The Now Playing UI appears
+        // automatically when MPNowPlayingInfoCenter is configured and playbackState
+        // is set to .playing.
         if templateToPush is CPNowPlayingTemplate {
-            let alreadyInStack = interfaceController.templates.contains(where: { $0 is CPNowPlayingTemplate })
-            if alreadyInStack {
-                print("[AutoPlay] CPNowPlayingTemplate already in stack, skipping push")
-                return true
-            }
+            print("[AutoPlay] CPNowPlayingTemplate cannot be pushed — skipping. Configure MPNowPlayingInfoCenter instead.")
+            return true
         }
 
         return try await interfaceController.pushTemplate(

package/ios/templates/NowPlayingTemplate.swift

@@ -20,11 +20,18 @@ class NowPlayingTemplate: AutoPlayTemplate {
         template = CPNowPlayingTemplate.shared
         initTemplate(template: template, id: config.id)
 
-        // Do NOT call setupNowPlayingButtons(), updateNowPlayingInfo(), or loadImageAsync() here.
-        // This constructor runs on the JS thread (not main thread).
-        // CPNowPlayingTemplate.shared is a system singleton — modifying it off the main thread
-        // causes a thread safety crash. All UI setup is deferred to invalidate() which runs
-        // on @MainActor during push.
+        // Constructor runs on the JS thread. Dispatch all CarPlay UI setup to main thread.
+        // CPNowPlayingTemplate.shared is Apple's singleton — must be modified on main thread.
+        // This also ensures MPNowPlayingInfoCenter and MPRemoteCommandCenter are configured
+        // even if push() is never called (CarPlay shows "Now Playing" bar automatically).
+        DispatchQueue.main.async { [weak self] in
+            guard let self = self else { return }
+            self.setupNowPlayingButtons()
+            self.updateNowPlayingInfo()
+            if let image = config.image {
+                self.loadImageAsync(image: image)
+            }
+        }
     }
 
     private func setupNowPlayingButtons() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neoskola/auto-play",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Android Auto and Apple CarPlay for react-native",
   "main": "lib/index",
   "module": "lib/index",