@mentra/bluetooth-sdk 3.2.1-dev.276 → 3.2.1-dev.277

package/android/src/main/java/com/mentra/bluetoothsdk/GeneratedReleaseMetadata.kt

@@ -3,9 +3,9 @@ package com.mentra.bluetoothsdk
 /** Generated by release CI. Do not edit in a release checkout. */
 internal object GeneratedReleaseMetadata {
     const val FAMILY_BASE_VERSION: String = "3.2.1"
-    const val RELEASE_IDENTITY: String = "3.2.1-dev.276"
-    const val RELEASE_SET_ID: String = "mentra-3.2.1-dev.276"
-    const val SOURCE_COMMIT: String = "b74cc190367ec2cd3aa44b43562648920adaba67"
-    const val OTA_MANIFEST_URL: String = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.276.json"
-    const val OTA_MANIFEST_SHA256: String = "91c76567180dbda2c90b8679725bccd237b46a954b8af50ef417633694c35563"
+    const val RELEASE_IDENTITY: String = "3.2.1-dev.277"
+    const val RELEASE_SET_ID: String = "mentra-3.2.1-dev.277"
+    const val SOURCE_COMMIT: String = "2668275c49728812fea5356f6df3e78e73f1ed87"
+    const val OTA_MANIFEST_URL: String = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.277.json"
+    const val OTA_MANIFEST_SHA256: String = "527d30a6400d5accdbf83e2c4316ec6e30e2b7ef1d70b6fd54e7abcec1bcc183"
 }

package/build/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const BLUETOOTH_SDK_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.2.1",
-    "releaseIdentity": "3.2.1-dev.276",
-    "releaseSetId": "mentra-3.2.1-dev.276",
-    "sourceCommit": "b74cc190367ec2cd3aa44b43562648920adaba67",
-    "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.276.json",
-    "otaManifestSha256": "91c76567180dbda2c90b8679725bccd237b46a954b8af50ef417633694c35563"
+    "releaseIdentity": "3.2.1-dev.277",
+    "releaseSetId": "mentra-3.2.1-dev.277",
+    "sourceCommit": "2668275c49728812fea5356f6df3e78e73f1ed87",
+    "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.277.json",
+    "otaManifestSha256": "527d30a6400d5accdbf83e2c4316ec6e30e2b7ef1d70b6fd54e7abcec1bcc183"
 });
 //# sourceMappingURL=releaseMetadata.js.map

package/build/generated/releaseMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,8BAA8B,GAA0C,MAAM,CAAC,MAAM,CAAC;IACjG,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,iIAAiI;IACnJ,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface BluetoothSdkReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.2.1\",\n  \"releaseIdentity\": \"3.2.1-dev.276\",\n  \"releaseSetId\": \"mentra-3.2.1-dev.276\",\n  \"sourceCommit\": \"b74cc190367ec2cd3aa44b43562648920adaba67\",\n  \"otaManifestUrl\": \"https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.276.json\",\n  \"otaManifestSha256\": \"91c76567180dbda2c90b8679725bccd237b46a954b8af50ef417633694c35563\"\n})\n"]}
+{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,8BAA8B,GAA0C,MAAM,CAAC,MAAM,CAAC;IACjG,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,iIAAiI;IACnJ,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface BluetoothSdkReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.2.1\",\n  \"releaseIdentity\": \"3.2.1-dev.277\",\n  \"releaseSetId\": \"mentra-3.2.1-dev.277\",\n  \"sourceCommit\": \"2668275c49728812fea5356f6df3e78e73f1ed87\",\n  \"otaManifestUrl\": \"https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.277.json\",\n  \"otaManifestSha256\": \"527d30a6400d5accdbf83e2c4316ec6e30e2b7ef1d70b6fd54e7abcec1bcc183\"\n})\n"]}

package/ios/Source/BluetoothSdkDefaults.swift

@@ -11,7 +11,7 @@ enum BluetoothSdkDefaults {
     static let voiceActivityDetectionEnabled = false
     static let loudnessGateEnabled = false
     private static let infoSdkVersionKey = "MentraBluetoothSdkVersion"
-    private static let swiftPackageSdkVersion = "3.2.1-dev.276"
+    private static let swiftPackageSdkVersion = "3.2.1-dev.277"
     private static let swiftPackageSdkVersionPlaceholder = "__MENTRA" + "_BLUETOOTH_SDK_VERSION__"
 
     private static func normalizedSdkVersion(_ value: String?) -> String? {

package/ios/Source/DeviceManager.swift

@@ -50,6 +50,8 @@ struct ViewState {
     private var cancellables = Set<AnyCancellable>()
     #if os(macOS)
     private var audioRouteObserver: MacAudioRouteObserver?
+    #else
+    private var audioRouteObservation: AudioRouteObservation?
     #endif
     var sendStateWorkItem: DispatchWorkItem?
     let sendStateQueue = DispatchQueue(label: "sendStateQueue", qos: .userInitiated)
@@ -366,6 +368,18 @@ struct ViewState {
         Bridge.log("MAN: init()")
         super.init()
 
+        #if !os(macOS)
+        // Pair Audio precedes BLE readiness and microphone capture. Its audio
+        // state must not depend on the lazily created PhoneMic singleton.
+        audioRouteObservation = AudioRouteObservation(names: [
+            AVAudioSession.routeChangeNotification,
+            UIApplication.didBecomeActiveNotification,
+        ]) { [weak self] in
+            self?.refreshAudioDeviceState()
+            self?.updateMicState()
+        }
+        #endif
+
         // Start memory monitoring (logs every 30s to help detect leaks)
         // MemoryMonitor.start()
 
@@ -929,6 +943,16 @@ struct ViewState {
     }
 
     func checkCurrentAudioDevice() {
+        #if os(macOS)
+        refreshAudioDeviceState()
+        #else
+        // DeviceStore calls this when the selected glasses change. Replace any
+        // pending route checks so the new target gets its own settling window.
+        audioRouteObservation?.refresh()
+        #endif
+    }
+
+    private func refreshAudioDeviceState() {
         let audioDevicePattern = getAudioDevicePattern()
         Bridge.log("MAN: checkCurrentAudioDevice: audioDevicePattern: \(audioDevicePattern)")
 
@@ -942,59 +966,13 @@ struct ViewState {
         glassesBluetoothClassicConnected = AudioSessionMonitor.isAudioDeviceConnected(devicePattern: audioDevicePattern)
         otherBtConnected = AudioSessionMonitor.isOtherAudioDeviceConnected(devicePattern: audioDevicePattern)
         #else
-        // check if the device disconnected:
-        let isConnected = AudioSessionMonitor.isAudioDeviceConnected(
-            devicePattern: audioDevicePattern
-        )
-
-        if !isConnected {
-            Bridge.log("MAN: Device '\(deviceName)' disconnected")
-            glassesBluetoothClassicConnected = false
-
-            let isOtherDeviceConnected = AudioSessionMonitor.isOtherAudioDeviceConnected(
-                devicePattern: audioDevicePattern
-            )
-            if isOtherDeviceConnected {
-                Bridge.log("MAN: Other device connected, returning")
-                otherBtConnected = true
-            }
-            return
-        }
-
-        let isPaired = AudioSessionMonitor.isDevicePaired(devicePattern: audioDevicePattern)
-        if isPaired {
-            Bridge.log("MAN: Successfully detected newly paired device '\(audioDevicePattern)'")
-            glassesBluetoothClassicConnected = true
-        } else {
-            glassesBluetoothClassicConnected = false
-        }
+        // A connected HFP input remains eligible even while another output is
+        // selected. Inspect available inputs as well as the active A2DP route.
+        glassesBluetoothClassicConnected = AudioSessionMonitor.isDevicePaired(devicePattern: audioDevicePattern)
+        otherBtConnected = AudioSessionMonitor.isOtherAudioDeviceConnected(devicePattern: audioDevicePattern)
         #endif
     }
 
-    #if !os(macOS)
-    func onRouteChange(
-        reason: AVAudioSession.RouteChangeReason, availableInputs: [AVAudioSessionPortDescription]
-    ) {
-        Bridge.log("MAN: onRouteChange: reason: \(reason)")
-        Bridge.log("MAN: onRouteChange: inputs: \(availableInputs)")
-
-        // check if our deviceName is connected:
-        // (return if deviceName is empty):
-        if deviceName.isEmpty {
-            Bridge.log("MAN: Device name is empty, returning")
-            return
-        }
-
-        // Add small delay to let iOS populate availableInputs
-        DispatchQueue.main.asyncAfter(deadline: .now() + 0.2) { [weak self] in
-            guard let self = self else { return }
-            checkCurrentAudioDevice()
-        }
-
-        updateMicState()
-    }
-    #endif
-
     func onInterruption(began: Bool) {
         Bridge.log("MAN: Interruption: \(began)")
         systemMicUnavailable = began

package/ios/Source/GeneratedReleaseMetadata.swift

@@ -3,9 +3,9 @@ import Foundation
 /// Generated by release CI. Do not edit in a release checkout.
 enum GeneratedReleaseMetadata {
     static let familyBaseVersion = "3.2.1"
-    static let releaseIdentity = "3.2.1-dev.276"
-    static let releaseSetId = "mentra-3.2.1-dev.276"
-    static let sourceCommit = "b74cc190367ec2cd3aa44b43562648920adaba67"
-    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.276.json"
-    static let otaManifestSha256 = "91c76567180dbda2c90b8679725bccd237b46a954b8af50ef417633694c35563"
+    static let releaseIdentity = "3.2.1-dev.277"
+    static let releaseSetId = "mentra-3.2.1-dev.277"
+    static let sourceCommit = "2668275c49728812fea5356f6df3e78e73f1ed87"
+    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.277.json"
+    static let otaManifestSha256 = "527d30a6400d5accdbf83e2c4316ec6e30e2b7ef1d70b6fd54e7abcec1bcc183"
 }

package/ios/Source/audio/PcmStreamPlayer.swift

@@ -1,5 +1,6 @@
 import AVFoundation
 import Foundation
+import os
 
 private enum PcmStreamError: LocalizedError {
     case invalidArgument(String)
@@ -25,6 +26,7 @@ private enum PcmStreamError: LocalizedError {
 /// recovery, close, and abort deterministic without blocking Expo's module
 /// queue.
 final class PcmStreamPlayer: @unchecked Sendable {
+    private let logger = Logger(subsystem: "com.mentra.pcm-stream", category: "playback")
     private static let backpressureCeilingMs: Int64 = 2000
     private static let maximumBacklogMs: Int64 = 10000
 
@@ -37,6 +39,7 @@ final class PcmStreamPlayer: @unchecked Sendable {
 
     private var queuedFrames: Int64 = 0
     private var playedFrames: Int64 = 0
+    private var writtenFrames: Int64 = 0
     private var closing = false
     private var aborted = false
     private var finished = false
@@ -107,6 +110,10 @@ final class PcmStreamPlayer: @unchecked Sendable {
                     }
 
                     let buffer = try makeBuffer(data: data, frameCount: frameCount)
+                    if writtenFrames == 0 {
+                        logger.info("PCM_PLAYBACK first_write frames=\(frameCount) sampleRate=\(self.sampleRate) engineRunning=\(self.engine.isRunning)")
+                    }
+                    writtenFrames += Int64(frameCount)
                     queuedFrames += Int64(frameCount)
                     player.scheduleBuffer(
                         buffer,
@@ -157,6 +164,7 @@ final class PcmStreamPlayer: @unchecked Sendable {
         await withCheckedContinuation { continuation in
             stateQueue.async { [self] in
                 if !aborted {
+                    logger.info("PCM_PLAYBACK abort writtenFrames=\(self.writtenFrames) playedFrames=\(self.playedFrames) queuedFrames=\(self.queuedFrames)")
                     aborted = true
                     finished = true
                     player.stop()
@@ -201,6 +209,10 @@ final class PcmStreamPlayer: @unchecked Sendable {
 
     private func didPlay(frameCount: Int) {
         guard !aborted, terminalError == nil else { return }
+        if playedFrames == 0 {
+            let rate = sampleRate
+            logger.info("PCM_PLAYBACK first_played frames=\(frameCount) sampleRate=\(rate)")
+        }
         queuedFrames = max(0, queuedFrames - Int64(frameCount))
         playedFrames += Int64(frameCount)
 

package/ios/Source/services/PhoneMic.swift

@@ -359,9 +359,7 @@ class PhoneMic {
         }
 
         Bridge.log("MIC: handleRouteChange: \(reason)")
-        DeviceManager.shared.onRouteChange(
-            reason: reason, availableInputs: audioSession?.availableInputs ?? []
-        )
+        // DeviceManager observes readiness independently of microphone capture.
 
         // // If we're recording and the audio route changed (e.g., AirPods connected/disconnected)
         // if isRecording {

package/ios/Source/utils/AudioRouteObservation.swift

@@ -0,0 +1,54 @@
+import Combine
+import Foundation
+
+/// Keeps audio readiness observable before microphone capture has been started.
+final class AudioRouteObservation {
+    private var subscriptions = Set<AnyCancellable>()
+    private var pendingRecheck: DispatchWorkItem?
+    private var generation = 0
+    private let settlingDelays: [TimeInterval]
+    private let onChange: () -> Void
+
+    init(
+        center: NotificationCenter = .default,
+        names: [Notification.Name],
+        settlingDelays: [TimeInterval] = [0.2, 0.3, 0.5],
+        onChange: @escaping () -> Void
+    ) {
+        self.settlingDelays = settlingDelays
+        self.onChange = onChange
+        for name in names {
+            center.publisher(for: name)
+                .receive(on: DispatchQueue.main)
+                .sink { [weak self] _ in self?.refresh() }
+                .store(in: &subscriptions)
+        }
+    }
+
+    deinit {
+        pendingRecheck?.cancel()
+    }
+
+    /// Start a new settling window for a route, foreground, or selected-device
+    /// change. The callback must read the current target and route each time.
+    func refresh() {
+        dispatchPrecondition(condition: .onQueue(.main))
+        pendingRecheck?.cancel()
+        generation += 1
+        reconcile(generation: generation, nextDelay: 0)
+    }
+
+    private func reconcile(generation: Int, nextDelay: Int) {
+        guard generation == self.generation else { return }
+        onChange()
+        // availableInputs can lag the notification, including after removal.
+        // Reconcile at 200, 500, and 1000 ms even if the first read was ready.
+        // A reentrant refresh also supersedes this window.
+        guard generation == self.generation, nextDelay < settlingDelays.count else { return }
+        let recheck = DispatchWorkItem { [weak self] in
+            self?.reconcile(generation: generation, nextDelay: nextDelay + 1)
+        }
+        pendingRecheck = recheck
+        DispatchQueue.main.asyncAfter(deadline: .now() + settlingDelays[nextDelay], execute: recheck)
+    }
+}

package/ios/Source/utils/AudioSessionMonitor.swift

@@ -6,9 +6,10 @@
 //  Used to detect when Mentra Live glasses are paired/connected for audio
 //
 
+import Foundation
+
 #if !os(macOS)
 import AVFoundation
-import Foundation
 import UIKit
 
 class AudioSessionMonitor {
@@ -57,11 +58,14 @@ class AudioSessionMonitor {
         Bridge.log("AudioMonitor: Checking active route, output count: \(outputs.count)")
         for output in outputs {
             Bridge.log("AudioMonitor:   - \(output.portName) (type: \(output.portType.rawValue))")
-            if output.portType == .bluetoothHFP || output.portType == .bluetoothA2DP {
-                if output.portName.localizedCaseInsensitiveContains(devicePattern) {
-                    Bridge.log("AudioMonitor: ✅ Found active audio device: \(output.portName)")
-                    return true
-                }
+            if BluetoothAudioRoute.matches(
+                name: output.portName,
+                portType: output.portType.rawValue,
+                target: devicePattern,
+                isIOSAppOnMac: ProcessInfo.processInfo.isiOSAppOnMac
+            ) {
+                Bridge.log("AudioMonitor: ✅ Found active audio device: \(output.portName)")
+                return true
             }
         }
 
@@ -283,3 +287,13 @@ class AudioSessionMonitor {
     }
 }
 #endif
+
+/// AVAudioSession preserves the route name on iOS-on-Mac but reports the
+/// CoreAudio transport "Bluetooth" instead of iPhone's profile-specific port.
+enum BluetoothAudioRoute {
+    static func matches(name: String, portType: String, target: String, isIOSAppOnMac: Bool) -> Bool {
+        guard !target.isEmpty, name.localizedCaseInsensitiveContains(target) else { return false }
+        return portType == "BluetoothHFP" || portType == "BluetoothA2DPOutput"
+            || (isIOSAppOnMac && portType == "Bluetooth")
+    }
+}

package/ios/Tests/AudioRouteObservationTests.swift

@@ -0,0 +1,142 @@
+import Foundation
+@testable import MentraBluetoothSDK
+import XCTest
+
+final class AudioRouteObservationTests: XCTestCase {
+    @MainActor
+    func testInputsBecomingAvailableAfterNotificationAreReconciled() async {
+        let center = NotificationCenter()
+        let route = Notification.Name("test.audio.route")
+        var inputAvailable = false
+        var ready = false
+        let initialRead = expectation(description: "Initial unavailable input observed")
+        let changed = expectation(description: "Delayed input becomes ready without another event")
+        var firstRead = true
+        let observer = AudioRouteObservation(center: center, names: [route]) {
+            if firstRead {
+                firstRead = false
+                initialRead.fulfill()
+            }
+            if inputAvailable, !ready { changed.fulfill() }
+            ready = inputAvailable
+        }
+
+        center.post(name: route, object: nil)
+        await fulfillment(of: [initialRead], timeout: 2)
+        XCTAssertFalse(ready)
+        inputAvailable = true
+        await fulfillment(of: [changed], timeout: 1)
+        XCTAssertTrue(ready)
+        withExtendedLifetime(observer) {}
+    }
+
+    @MainActor
+    func testInitiallyReadyInputCanDisappearDuringSettling() async {
+        var inputAvailable = true
+        var ready = false
+        let disappeared = expectation(description: "Input removal observed during settling")
+        let observer = AudioRouteObservation(names: [], settlingDelays: [0.05, 0.05]) {
+            if ready, !inputAvailable { disappeared.fulfill() }
+            ready = inputAvailable
+        }
+        observer.refresh()
+        XCTAssertTrue(ready)
+        inputAvailable = false
+        await fulfillment(of: [disappeared], timeout: 2)
+        XCTAssertFalse(ready)
+        withExtendedLifetime(observer) {}
+    }
+
+    @MainActor
+    func testDeviceChangeReplacesPendingChecksAndReadsOnlyCurrentTarget() async {
+        var target = "first"
+        var availableInputs = Set<String>()
+        var observations: [(String, Bool)] = []
+        var secondChecks = 0
+        let settled = expectation(description: "Replacement window completed")
+        let observer = AudioRouteObservation(names: [], settlingDelays: [0.05, 0.05, 0.1]) {
+            observations.append((target, availableInputs.contains(target)))
+            if target == "second" {
+                secondChecks += 1
+                if secondChecks == 2 {
+                    // The old target is available, but its readiness must not leak.
+                    XCTAssertFalse(observations.contains { $0.1 })
+                    availableInputs.insert("second")
+                }
+                if secondChecks == 4 { settled.fulfill() }
+            }
+        }
+        observer.refresh()
+        target = "second"
+        observer.refresh() // Same entry point used by DeviceStore's device_name change.
+        availableInputs.insert("first")
+        await fulfillment(of: [settled], timeout: 2)
+        XCTAssertEqual(observations.filter { $0.0 == "first" }.count, 1)
+        XCTAssertEqual(observations.filter { $0.0 == "second" }.count, 4)
+        XCTAssertEqual(observations.last?.0, "second")
+        XCTAssertEqual(observations.last?.1, true)
+        withExtendedLifetime(observer) {}
+    }
+
+    @MainActor
+    func testUnavailableInputStopsRecheckingAfterBoundedWindow() async {
+        var checks = 0
+        let settled = expectation(description: "Immediate read and two scheduled rechecks completed")
+        let extraCheck = expectation(description: "No rechecks beyond the configured window")
+        extraCheck.isInverted = true
+        let observer = AudioRouteObservation(names: [], settlingDelays: [0.02, 0.02]) {
+            checks += 1
+            if checks == 3 { settled.fulfill() }
+            if checks > 3 { extraCheck.fulfill() }
+        }
+        observer.refresh()
+        await fulfillment(of: [settled], timeout: 2)
+        XCTAssertEqual(checks, 3)
+        await fulfillment(of: [extraCheck], timeout: 0.1)
+        XCTAssertEqual(checks, 3)
+        withExtendedLifetime(observer) {}
+    }
+
+    @MainActor
+    func testReleasingObserverCancelsPendingRechecks() async throws {
+        var checks = 0
+        var observer: AudioRouteObservation? = AudioRouteObservation(names: [], settlingDelays: [0.02]) {
+            checks += 1
+        }
+        observer?.refresh()
+        XCTAssertEqual(checks, 1)
+        observer = nil
+        try await Task.sleep(nanoseconds: 100_000_000)
+        XCTAssertEqual(checks, 1)
+    }
+
+    func testObservesRouteAndForegroundWithoutStartingAMicrophone() async {
+        let center = NotificationCenter()
+        let route = Notification.Name("test.audio.route")
+        let foreground = Notification.Name("test.audio.foreground")
+        let changed = expectation(description: "Both readiness events delivered")
+        changed.expectedFulfillmentCount = 2
+        let observer = AudioRouteObservation(center: center, names: [route, foreground]) {
+            XCTAssertTrue(Thread.isMainThread)
+            changed.fulfill()
+        }
+        center.post(name: route, object: nil)
+        center.post(name: foreground, object: nil)
+        await fulfillment(of: [changed], timeout: 1)
+        withExtendedLifetime(observer) {}
+    }
+
+    func testReleasingObserverStopsReadinessCallbacks() async {
+        let center = NotificationCenter()
+        let route = Notification.Name("test.audio.route")
+        let changed = expectation(description: "Released observer is silent")
+        changed.isInverted = true
+        var observer: AudioRouteObservation? = AudioRouteObservation(center: center, names: [route]) {
+            changed.fulfill()
+        }
+        XCTAssertNotNil(observer)
+        observer = nil
+        center.post(name: route, object: nil)
+        await fulfillment(of: [changed], timeout: 0.1)
+    }
+}

package/ios/Tests/BluetoothAudioRouteTests.swift

@@ -0,0 +1,37 @@
+@testable import MentraBluetoothSDK
+import XCTest
+
+final class BluetoothAudioRouteTests: XCTestCase {
+    func testRecognizesIPhoneProfiles() {
+        for port in ["BluetoothHFP", "BluetoothA2DPOutput"] {
+            XCTAssertTrue(BluetoothAudioRoute.matches(
+                name: "Mentra_Live_03BE", portType: port, target: "03BE", isIOSAppOnMac: false
+            ))
+        }
+    }
+
+    func testRecognizesObservedMacTransportOnlyOnMac() {
+        XCTAssertTrue(BluetoothAudioRoute.matches(
+            name: "Mentra_Live_03BE", portType: "Bluetooth", target: "mentra_live_03be", isIOSAppOnMac: true
+        ))
+        XCTAssertFalse(BluetoothAudioRoute.matches(
+            name: "Mentra_Live_03BE", portType: "Bluetooth", target: "03BE", isIOSAppOnMac: false
+        ))
+    }
+
+    func testRejectsDifferentGlassesAndMissingIdentity() {
+        for target in ["023B", ""] {
+            XCTAssertFalse(BluetoothAudioRoute.matches(
+                name: "Mentra_Live_03BE", portType: "Bluetooth", target: target, isIOSAppOnMac: true
+            ))
+        }
+    }
+
+    func testRejectsNonBluetoothDeviceWithMatchingName() {
+        for port in ["Speaker", "USBAudio", "BuiltInMic", ""] {
+            XCTAssertFalse(BluetoothAudioRoute.matches(
+                name: "Mentra_Live_03BE", portType: port, target: "03BE", isIOSAppOnMac: true
+            ))
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "3.2.1-dev.276",
+  "version": "3.2.1-dev.277",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -114,7 +114,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@mentra/cloud-protocol": "3.2.1-dev.276"
+    "@mentra/cloud-protocol": "3.2.1-dev.277"
   },
   "devDependencies": {
     "@types/node": "^25.9.3",

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface BluetoothSdkReleaseMetadata {
 export const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "3.2.1",
-  "releaseIdentity": "3.2.1-dev.276",
-  "releaseSetId": "mentra-3.2.1-dev.276",
-  "sourceCommit": "b74cc190367ec2cd3aa44b43562648920adaba67",
-  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.276.json",
-  "otaManifestSha256": "91c76567180dbda2c90b8679725bccd237b46a954b8af50ef417633694c35563"
+  "releaseIdentity": "3.2.1-dev.277",
+  "releaseSetId": "mentra-3.2.1-dev.277",
+  "sourceCommit": "2668275c49728812fea5356f6df3e78e73f1ed87",
+  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.277.json",
+  "otaManifestSha256": "527d30a6400d5accdbf83e2c4316ec6e30e2b7ef1d70b6fd54e7abcec1bcc183"
 })