@siteed/expo-audio-studio 2.18.5 → 2.18.6

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.18.6] - 2026-03-06
+### Fixed
+- fix(ios): `resetToDefaultDevice` now correctly resets the engine tap when switching back to the system default input (was a no-op due to `deviceId=nil` guard)
+- fix(ios): recovery path after a failed device switch no longer produces silent audio (missing tap reinstall before engine restart)
+- fix(ios): `setupNowPlayingInfo` no longer overrides user-configured audio session options (e.g. whisper-mode / no-Bluetooth configs)
+- fix(ios): `selectInputDevice` now syncs `deviceId` into `recordingSettings` before updating the engine, ensuring the port lookup succeeds
+- fix(ios): phone-call auto-resume handler respects user-configured `categoryOptions` instead of hardcoded `[.allowBluetooth, .mixWithOthers]`
+- fix(ios): `AudioDeviceManager.prepareAudioSession` preserves existing session options when already `.playAndRecord`
 
 ## [2.18.5] - 2026-02-23
 ### Changed

package/ios/AudioDeviceManager.swift

@@ -87,11 +87,15 @@ class AudioDeviceManager {
         do {
             let session = AVAudioSession.sharedInstance()
             
-            // Configure with options needed for Bluetooth detection
-            try session.setCategory(.playAndRecord, mode: .default, options: [.allowBluetooth, .allowBluetoothA2DP, .mixWithOthers])
-            
-            // Activate the session
-            try session.setActive(true, options: .notifyOthersOnDeactivation)
+            // Preserve existing session configuration if already set up for recording
+            if session.category == .playAndRecord {
+                Logger.debug("AudioDeviceManager", "Session already .playAndRecord, preserving categoryOptions")
+                try session.setActive(true, options: .notifyOthersOnDeactivation)
+            } else {
+                // Configure with options needed for Bluetooth detection
+                try session.setCategory(.playAndRecord, mode: .default, options: [.allowBluetooth, .allowBluetoothA2DP, .mixWithOthers])
+                try session.setActive(true, options: .notifyOthersOnDeactivation)
+            }
             
             // Give the system a moment to detect Bluetooth devices if needed
             // Minimal delay that still allows devices to be detected

package/ios/AudioStreamManager.swift

@@ -217,7 +217,8 @@ class AudioStreamManager: NSObject, AudioDeviceManagerDelegate {
                         // Configure audio session
                         do {
                             let session = AVAudioSession.sharedInstance()
-                            try session.setCategory(.playAndRecord, mode: .default, options: [.allowBluetooth, .mixWithOthers])
+                            let resumeOptions: AVAudioSession.CategoryOptions = self.recordingSettings?.ios?.audioSession?.categoryOptions ?? [.allowBluetooth, .mixWithOthers]
+                            try session.setCategory(.playAndRecord, mode: .default, options: resumeOptions)
                             try session.setActive(true, options: .notifyOthersOnDeactivation)
                             
                             // Resume if we're still recording and paused
@@ -251,15 +252,9 @@ class AudioStreamManager: NSObject, AudioDeviceManagerDelegate {
     }
     
     private func setupNowPlayingInfo() {
-        // Configure audio session for background audio
+        // Session is already configured by configureAudioSession(); do not override it here.
         audioSession = AVAudioSession.sharedInstance()
-        do {
-            try audioSession?.setCategory(.playAndRecord, mode: .default, options: [.allowBluetooth, .mixWithOthers])
-            try audioSession?.setActive(true)
-        } catch {
-            Logger.debug("AudioStreamManager", "Failed to configure audio session: \(error)")
-        }
-        
+
         // Setup Now Playing info
         notificationView = MPNowPlayingInfoCenter.default()
         updateNowPlayingInfo(isPaused: false)
@@ -1683,37 +1678,59 @@ class AudioStreamManager: NSObject, AudioDeviceManagerDelegate {
         return outputBuffer
     }
 
+    /// Performs the full engine stop → reset → reinstall tap → restart cycle for a device switch.
+    /// Pass `nil` to revert to the system-default input.
+    /// This is the single source of truth for all device-switch paths (Bug 1 + Bug 2 fixes).
+    public func performDeviceSwitch(port: AVAudioSessionPortDescription?) {
+        let wasRunning = audioEngine.isRunning
+        do {
+            if wasRunning { audioEngine.stop() }
+            audioEngine.inputNode.removeTap(onBus: 0)
+            try AVAudioSession.sharedInstance().setPreferredInput(port)
+            Thread.sleep(forTimeInterval: 0.15)
+            audioEngine.reset()
+            _ = installTapWithHardwareFormat()
+            if wasRunning {
+                audioEngine.prepare()
+                try audioEngine.start()
+                lastEmissionTime = Date()
+                lastEmissionTimeAnalysis = Date()
+                Logger.debug("AudioStreamManager", "Device switch complete; engine restarted (port: \(port?.portName ?? "default"))")
+            }
+        } catch {
+            Logger.debug("AudioStreamManager", "Device switch failed: \(error.localizedDescription)")
+            if wasRunning {
+                do {
+                    _ = installTapWithHardwareFormat()  // Bug 2 fix: reinstall tap in recovery path
+                    audioEngine.prepare()
+                    try audioEngine.start()
+                    Logger.debug("AudioStreamManager", "Engine recovery after device switch succeeded")
+                } catch {
+                    Logger.debug("AudioStreamManager", "Engine recovery failed: \(error.localizedDescription)")
+                }
+            }
+        }
+    }
+
     /// Attempts to update the audio session with the preferred input device from current settings.
     /// Called externally when the device selection changes.
-    /// Note: Avoids changing sample rate or buffer duration while engine might be running.
     public func updateAudioSessionWithCurrentSettings() {
         guard let settings = self.recordingSettings, let deviceId = settings.deviceId else {
             Logger.debug("Cannot update audio session preference, settings or deviceId missing")
             return
         }
-        
+
         let session = AVAudioSession.sharedInstance()
-        
-        // Find the requested device port
         let selectedPort = session.availableInputs?.first { port in
-            // Normalize IDs for comparison, especially for Bluetooth
-            let portNormalizedId = deviceManager.normalizeBluetoothDeviceId(port.uid)
-            let requestedNormalizedId = deviceManager.normalizeBluetoothDeviceId(deviceId)
-            return portNormalizedId == requestedNormalizedId
+            deviceManager.normalizeBluetoothDeviceId(port.uid) == deviceManager.normalizeBluetoothDeviceId(deviceId)
         }
-        
-        if let portToSet = selectedPort {
-            do {
-                try session.setPreferredInput(portToSet)
-                Logger.debug("Attempted to set preferred input to: \(portToSet.portName) (ID: \(portToSet.uid))")
-                 // We add a small delay hoping the system applies the change before potential next operations
-                Thread.sleep(forTimeInterval: 0.1)
-            } catch {
-                Logger.debug("Failed to set preferred input device \(portToSet.portName): \(error.localizedDescription)")
-            }
-        } else {
-            Logger.debug("Could not find device with ID \(deviceId) to set as preferred input.")
+
+        guard let portToSet = selectedPort else {
+            Logger.debug("Could not find device with ID \(deviceId)")
+            return
         }
+
+        performDeviceSwitch(port: portToSet)
     }
 
     /// Stops the current audio recording.

package/ios/ExpoAudioStreamModule.swift

@@ -759,6 +759,8 @@ public class ExpoAudioStreamModule: Module, AudioStreamManagerDelegate, AudioDev
         AsyncFunction("selectInputDevice") { (deviceId: String, promise: Promise) in
             Logger.debug("ExpoAudioStreamModule", "selectInputDevice called with ID: \(deviceId)")
             self.deviceManager.selectInputDevice(deviceId, promise: promise)
+            // Sync deviceId into recordingSettings so updateAudioSessionWithCurrentSettings can find the port
+            self.streamManager.recordingSettings?.deviceId = deviceId
             // Update the audio recorder if recording is in progress or prepared
             if self.streamManager.isRecording || self.streamManager.isPrepared {
                 Logger.debug("ExpoAudioStreamModule", "selectInputDevice: Calling updateAudioSessionWithCurrentSettings because recording/prepared.")
@@ -776,11 +778,15 @@ public class ExpoAudioStreamModule: Module, AudioStreamManagerDelegate, AudioDev
             Logger.debug("ExpoAudioStreamModule", "resetToDefaultDevice called.")
             self.deviceManager.resetToDefaultDevice { success, error in
                 if success {
+                    // Clear stored deviceId so updateAudioSessionWithCurrentSettings won't bail early
+                    self.streamManager.recordingSettings?.deviceId = nil
                     if self.streamManager.isRecording || self.streamManager.isPrepared {
-                        Logger.debug("ExpoAudioStreamModule", "resetToDefaultDevice: Calling updateAudioSessionWithCurrentSettings because recording/prepared.")
-                        self.streamManager.updateAudioSessionWithCurrentSettings()
+                        Logger.debug("ExpoAudioStreamModule", "resetToDefaultDevice: Performing device switch to system default.")
+                        // Bug 1 fix: call performDeviceSwitch(nil) directly — updateAudioSessionWithCurrentSettings
+                        // would bail immediately because deviceId is now nil.
+                        self.streamManager.performDeviceSwitch(port: nil)
                     } else {
-                        Logger.debug("ExpoAudioStreamModule", "resetToDefaultDevice: Not calling updateAudioSessionWithCurrentSettings because not recording/prepared.")
+                        Logger.debug("ExpoAudioStreamModule", "resetToDefaultDevice: Not recording/prepared, no engine action needed.")
                     }
                     promise.resolve(true)
                 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@siteed/expo-audio-studio",
-    "version": "2.18.5",
+    "version": "2.18.6",
     "description": "Comprehensive audio processing library for React Native and Expo with recording, analysis, visualization, and streaming capabilities across iOS, Android, and web",
     "license": "MIT",
     "type": "commonjs",