@mentra/bluetooth-sdk 3.2.0-dev.122 → 3.2.0-dev.127

package/README.md

@@ -8,7 +8,8 @@ The package includes:
 - React hooks under `@mentra/bluetooth-sdk/react` for common scan,
   connection, status, and event lifecycles.
 - Native Android code published as `com.mentraglass:bluetooth-sdk`.
-- Native iOS code available as the `MentraBluetoothSDK` Swift package.
+- Native iOS and macOS code available as the `MentraBluetoothSDK` Swift package.
+- Native macOS Expo Modules adapter for `react-native-macos` hosts.
 - An Expo config plugin that wires the native dependencies into generated Android and iOS projects.
 
 Use a development build or production native build. Expo Go cannot load this package because the SDK contains native code.
@@ -19,6 +20,9 @@ Use a development build or production native build. Expo Go cannot load this pac
 - Expo `49+` when using Expo.
 - Android min SDK `28+`.
 - iOS deployment target `15.1+`.
+- Native macOS deployment target `13+`. The Starter Kit's separate
+  `react-native-macos` host requires macOS `14+` and a matching React Native / Expo
+  Modules toolchain; the iOS/Android config plugin does not generate a Mac host.
 - A physical phone for real Bluetooth testing.
 - Bluetooth permissions, plus Android location permission where BLE scanning requires it.
 
@@ -526,13 +530,15 @@ project, not the local Gradle entrypoint. The check script prepares
 `mobile/android` and uses its Gradle wrapper with `-PmentraPublicSdk=true`,
 matching the CI release workflow's public SDK dependency mode.
 
-For bare native iOS apps, use the public SwiftPM repository:
+For bare native iOS or macOS apps, use the public SwiftPM repository:
 
 ```text
 https://github.com/Mentra-Community/mentra-bluetooth-sdk-ios.git
 ```
 
-Select version `0.1.20`, then add the `MentraBluetoothSDK` product to your app target.
+Select a coordinated SDK version that includes your target platform, then add
+the `MentraBluetoothSDK` product to your app target. Native macOS support is new
+on `dev`; use the local source override until a supporting release is published.
 
 For local SDK development, add this package folder directly in Xcode:
 
@@ -542,6 +548,14 @@ For local SDK development, add this package folder directly in Xcode:
 
 The core Swift package intentionally excludes optional local STT, Nex/SwiftProtobuf, Vuzix/Ultralite, and tar.bz2 extraction code paths.
 
+Native Mac hosts need Bluetooth and local-network usage descriptions, and
+sandbox entitlements for Bluetooth and outbound networking. Add microphone
+permission/audio-input capability for host microphone capture and network-server
+capability for local SDK servers. macOS uses CoreAudio instead of
+`AVAudioSession`; it does not provide iOS background modes or ANCS relay. See
+[the macOS integration guide](../../../mintlify-docs/bluetooth-sdk/macos.mdx)
+and the Starter Kit's `examples/macos` and `examples/react-native-macos` hosts.
+
 Maintainers publishing the public SwiftPM mirror should follow
 [RELEASING_IOS_SPM.md](./RELEASING_IOS_SPM.md).
 

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.0"
-    const val RELEASE_IDENTITY: String = "3.2.0-dev.122"
-    const val RELEASE_SET_ID: String = "mentra-3.2.0-dev.122"
-    const val SOURCE_COMMIT: String = "4564c9f8b5fc947a7bb46e9710cb1b6c9268d7bf"
-    const val OTA_MANIFEST_URL: String = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.122.json"
-    const val OTA_MANIFEST_SHA256: String = "796e5a40d857e3fc5f4fb920573639614a4cd4afc77102d23197bd2d6b5a78b3"
+    const val RELEASE_IDENTITY: String = "3.2.0-dev.127"
+    const val RELEASE_SET_ID: String = "mentra-3.2.0-dev.127"
+    const val SOURCE_COMMIT: String = "6f63b186e38f659faed60cbe5b9c95f457a32383"
+    const val OTA_MANIFEST_URL: String = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.127.json"
+    const val OTA_MANIFEST_SHA256: String = "426f58f142ca6d710089683c6e9462b0ce0c30d491b95747e960371e082f459c"
 }

package/build/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const BLUETOOTH_SDK_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.2.0",
-    "releaseIdentity": "3.2.0-dev.122",
-    "releaseSetId": "mentra-3.2.0-dev.122",
-    "sourceCommit": "4564c9f8b5fc947a7bb46e9710cb1b6c9268d7bf",
-    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.122.json",
-    "otaManifestSha256": "796e5a40d857e3fc5f4fb920573639614a4cd4afc77102d23197bd2d6b5a78b3"
+    "releaseIdentity": "3.2.0-dev.127",
+    "releaseSetId": "mentra-3.2.0-dev.127",
+    "sourceCommit": "6f63b186e38f659faed60cbe5b9c95f457a32383",
+    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.127.json",
+    "otaManifestSha256": "426f58f142ca6d710089683c6e9462b0ce0c30d491b95747e960371e082f459c"
 });
 //# 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,wHAAwH;IAC1I,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.0\",\n  \"releaseIdentity\": \"3.2.0-dev.122\",\n  \"releaseSetId\": \"mentra-3.2.0-dev.122\",\n  \"sourceCommit\": \"4564c9f8b5fc947a7bb46e9710cb1b6c9268d7bf\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.122.json\",\n  \"otaManifestSha256\": \"796e5a40d857e3fc5f4fb920573639614a4cd4afc77102d23197bd2d6b5a78b3\"\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,wHAAwH;IAC1I,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.0\",\n  \"releaseIdentity\": \"3.2.0-dev.127\",\n  \"releaseSetId\": \"mentra-3.2.0-dev.127\",\n  \"sourceCommit\": \"6f63b186e38f659faed60cbe5b9c95f457a32383\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.127.json\",\n  \"otaManifestSha256\": \"426f58f142ca6d710089683c6e9462b0ce0c30d491b95747e960371e082f459c\"\n})\n"]}

package/ios/BluetoothSdkModule.swift

@@ -695,6 +695,7 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
 
         // MARK: - STT Model Management
 
+        #if !os(macOS)
         AsyncFunction("setSttModelDetails") { (path: String, languageCode: String) in
             STTTools.setSttModelDetails(path, languageCode)
         }
@@ -747,6 +748,7 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
                 speed: speed
             )
         }
+        #endif
     }
 
     @MainActor
@@ -936,4 +938,3 @@ private extension ConnectOptions {
 
 
 
-

package/ios/MentraBluetoothSDK.podspec

@@ -12,7 +12,8 @@ Pod::Spec.new do |s|
   s.author         = package['author']
   s.homepage       = package['homepage']
   s.platforms      = {
-    :ios => '15.1'
+    :ios => '15.1',
+    :osx => '13.0'
   }
   s.swift_version  = '5.9'
   s.source         = {
@@ -23,10 +24,10 @@ Pod::Spec.new do |s|
 
   # External dependencies required by Bluetooth SDK native code
   s.dependency 'ExpoModulesCore' if include_expo_adapter
-  s.dependency 'SWCompression', '~> 4.8.0'
-  s.dependency 'SwiftProtobuf', '~> 1.0'
-  s.dependency 'onnxruntime-objc', '1.18.0'
-  s.dependency 'UltraliteSDK'
+  s.ios.dependency 'SWCompression', '~> 4.8.0'
+  s.ios.dependency 'SwiftProtobuf', '~> 1.0'
+  s.ios.dependency 'onnxruntime-objc', '1.18.0'
+  s.ios.dependency 'UltraliteSDK'
 
   # Swift/Objective-C compatibility
   s.pod_target_xcconfig = {
@@ -39,13 +40,14 @@ Pod::Spec.new do |s|
   # iOS frameworks required by Bluetooth SDK
   ios_frameworks = ['AVFoundation', 'CoreBluetooth', 'UIKit', 'CoreGraphics']
   ios_frameworks << 'Network' if include_expo_adapter
-  s.frameworks = ios_frameworks
+  s.ios.frameworks = ios_frameworks
+  s.osx.frameworks = ['AVFoundation', 'CoreBluetooth', 'CoreAudio', 'AudioToolbox', 'ImageIO', 'JavaScriptCore', 'Network']
 
   # System libraries required by MentraOS
-  s.library = 'bz2'
+  s.ios.library = 'bz2'
 
   # Vendored frameworks
-  s.vendored_frameworks = 'Packages/SherpaOnnx/sherpa-onnx.xcframework'
+  s.ios.vendored_frameworks = 'Packages/SherpaOnnx/sherpa-onnx.xcframework'
 
   s.resource_bundles = {
     'BluetoothSDKPrivacy' => ['Source/PrivacyInfo.xcprivacy']
@@ -60,7 +62,7 @@ Pod::Spec.new do |s|
     "Packages/SherpaOnnx/sherpa-onnx.xcframework/Headers/**/*.{h,hpp}",
     "Packages/libbz2/shim.h"
   ]
-  native_source_files.concat([
+  adapter_source_files = [
     "BluetoothSdkModule.swift",
     "LocalPhotoUploadServer.swift",
     "MentraPhotoReceiverModule.swift",
@@ -68,8 +70,24 @@ Pod::Spec.new do |s|
     "LocalOtaServer.swift",
     "BackgroundOtaArtifactDownloader.swift",
     "MentraOtaServerModule.swift"
-  ]) if include_expo_adapter
-  s.source_files = native_source_files
+  ]
+  native_source_files.concat(adapter_source_files) if include_expo_adapter
+  s.ios.source_files = native_source_files
+  s.osx.source_files = [
+    'Source/**/*.{h,m,mm,swift,hpp,cpp,c}',
+    'Packages/CoreObjC/**/*.{h,m,mm,hpp,cpp,c}'
+  ] + (include_expo_adapter ? adapter_source_files : [])
+  s.osx.exclude_files = [
+    'Source/Bridging-Header.h',
+    'Source/sgcs/Mach1.swift',
+    'Source/sgcs/MentraNex.swift',
+    'Source/sgcs/mentraos_ble.pb.swift',
+    'Source/stt/**/*',
+    'Source/tts/**/*',
+    'Source/utils/TarBz2Extractor.swift',
+    'Source/BridgeModule.{h,m}',
+    'Source/Bridge.m'
+  ]
 
   # Explicitly mark C++ headers and internal headers as private to prevent exposure in public interface
   s.private_header_files = [

package/ios/Source/BluetoothSdkDefaults.swift

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

package/ios/Source/DeviceManager.swift

@@ -9,7 +9,12 @@ import AVFoundation
 import Combine
 import CoreBluetooth
 import Foundation
+#if os(macOS)
+import CoreAudio
+#endif
+#if canImport(UIKit)
 import UIKit
+#endif
 #if SWIFT_PACKAGE
 import MentraBluetoothSDKCoreObjC
 #endif
@@ -43,6 +48,9 @@ struct ViewState {
     // MARK: - Unique (iOS)
 
     private var cancellables = Set<AnyCancellable>()
+    #if os(macOS)
+    private var audioRouteObserver: MacAudioRouteObserver?
+    #endif
     var sendStateWorkItem: DispatchWorkItem?
     let sendStateQueue = DispatchQueue(label: "sendStateQueue", qos: .userInitiated)
 
@@ -51,6 +59,7 @@ struct ViewState {
      * Attempts to automatically activate Mentra Live as the system audio device
      * If not paired yet, prompts user to pair in Settings
      */
+    #if !os(macOS)
     func setupAudioPairing(deviceName _: String) {
         // Don't configure audio session - PhoneMic.swift handles that
         // Just check if audio session supports Bluetooth (informational only)
@@ -83,6 +92,7 @@ struct ViewState {
             // Not found in availableInputs - not paired yet
 
             // Start monitoring for when user pairs manually
+            #if !os(macOS)
             AudioSessionMonitor.startMonitoring(devicePattern: audioDevicePattern) {
                 [weak self] (connected: Bool, _: String?) in
                 guard let self = self else { return }
@@ -96,9 +106,12 @@ struct ViewState {
                     self.glassesBluetoothClassicConnected = false
                 }
             }
+            #endif
         }
     }
 
+    #endif
+
     // MARK: - End Unique
 
     // MARK: - Properties
@@ -314,7 +327,7 @@ struct ViewState {
     private var micReinitTimer: Timer?
 
     /// STT:
-    #if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
+    #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
     private var transcriber: SherpaOnnxTranscriber?
     #endif
 
@@ -351,7 +364,7 @@ struct ViewState {
         // MemoryMonitor.start()
 
         // Initialize SherpaOnnx Transcriber
-        #if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
+        #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
         if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
            let window = windowScene.windows.first,
            let rootViewController = window.rootViewController
@@ -500,7 +513,7 @@ struct ViewState {
         handleSendingPcm(pcmData)
 
         // Send PCM to local transcriber.
-#if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
+#if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
         if shouldSendTranscript || localSttFallbackActive {
             transcriber?.acceptAudio(pcm16le: pcmData)
         }
@@ -517,11 +530,13 @@ struct ViewState {
 
         var phoneMicUnavailable = systemMicUnavailable
 
+        #if !os(macOS)
         let appState = UIApplication.shared.applicationState
         if appState == .background {
             // Bridge.log("App is in background - onboard mic unavailable to start!")
             phoneMicUnavailable = true
         }
+        #endif
 
         if micEnabled {
             for micMode in micRanking {
@@ -710,12 +725,12 @@ struct ViewState {
         } else if wearable.contains(DeviceTypes.FRAME) {
             // sgc = FrameManager()
         }
-#if !SWIFT_PACKAGE || MENTRA_FEATURE_NEX
+#if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_NEX)
         if sgc == nil && wearable.contains(DeviceTypes.NEX) {
             sgc = MentraNexSGC.getInstance()
         }
 #endif
-#if !SWIFT_PACKAGE || MENTRA_FEATURE_VUZIX
+#if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_VUZIX)
         if sgc == nil {
             if wearable.contains(DeviceTypes.MACH1) {
                 sgc = Mach1()
@@ -927,6 +942,10 @@ struct ViewState {
             return
         }
 
+        #if os(macOS)
+        glassesBluetoothClassicConnected = AudioSessionMonitor.isAudioDeviceConnected(devicePattern: audioDevicePattern)
+        otherBtConnected = AudioSessionMonitor.isOtherAudioDeviceConnected(devicePattern: audioDevicePattern)
+        #else
         // check if the device disconnected:
         let isConnected = AudioSessionMonitor.isAudioDeviceConnected(
             devicePattern: audioDevicePattern
@@ -948,17 +967,15 @@ struct ViewState {
 
         let isPaired = AudioSessionMonitor.isDevicePaired(devicePattern: audioDevicePattern)
         if isPaired {
-            let session = AVAudioSession.sharedInstance()
-            let deviceName = session.availableInputs?.first(where: {
-                $0.portName.localizedCaseInsensitiveContains(audioDevicePattern)
-            })?.portName
-            Bridge.log("MAN: Successfully detected newly paired device '\(deviceName)'")
+            Bridge.log("MAN: Successfully detected newly paired device '\(audioDevicePattern)'")
             glassesBluetoothClassicConnected = true
         } else {
             glassesBluetoothClassicConnected = false
         }
+        #endif
     }
 
+    #if !os(macOS)
     func onRouteChange(
         reason: AVAudioSession.RouteChangeReason, availableInputs: [AVAudioSessionPortDescription]
     ) {
@@ -980,6 +997,7 @@ struct ViewState {
 
         updateMicState()
     }
+    #endif
 
     func onInterruption(began: Bool) {
         Bridge.log("MAN: Interruption: \(began)")
@@ -988,7 +1006,7 @@ struct ViewState {
     }
 
     func restartTranscriber() {
-        #if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
+        #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
         Bridge.log("MAN: Restarting SherpaOnnxTranscriber via command")
         transcriber?.restart()
         #else
@@ -1054,6 +1072,16 @@ struct ViewState {
         }
 
         // check current audio device:
+        #if os(macOS)
+        audioRouteObserver = MacAudioRouteObserver(selectors: [kAudioHardwarePropertyDevices,
+            kAudioHardwarePropertyDefaultInputDevice, kAudioHardwarePropertyDefaultOutputDevice]) { [weak self] in
+            Task { @MainActor in
+                guard let self, self.audioRouteObserver != nil else { return }
+                self.checkCurrentAudioDevice()
+                self.updateMicState()
+            }
+        }
+        #endif
         checkCurrentAudioDevice()
 
         // save the default_wearable now that we're connected:
@@ -1146,6 +1174,9 @@ struct ViewState {
 
     func handleDeviceDisconnected() {
         Bridge.log("MAN: Device disconnected")
+        #if os(macOS)
+        audioRouteObserver = nil
+        #endif
         resetSystemTimeSync()
         resetMicHealth()
         DeviceStore.shared.apply("glasses", "headUp", false)
@@ -1825,6 +1856,11 @@ struct ViewState {
     }
 
     func disconnect(clearPendingConnection: Bool = true) {
+        #if os(macOS)
+        audioRouteObserver = nil
+        glassesBluetoothClassicConnected = false
+        otherBtConnected = false
+        #endif
         sgc?.clearDisplay() // clear the screen
         sgc?.disconnect()
         sgc = nil // Clear the SGC reference after disconnect
@@ -1932,8 +1968,12 @@ struct ViewState {
     }
 
     func cleanup() {
+        #if os(macOS)
+        audioRouteObserver = nil
+        PhoneMic.shared.cleanup()
+        #endif
         // Clean up transcriber resources
-#if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
+#if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
         transcriber?.shutdown()
         transcriber = nil
 #endif

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.0"
-    static let releaseIdentity = "3.2.0-dev.122"
-    static let releaseSetId = "mentra-3.2.0-dev.122"
-    static let sourceCommit = "4564c9f8b5fc947a7bb46e9710cb1b6c9268d7bf"
-    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.122.json"
-    static let otaManifestSha256 = "796e5a40d857e3fc5f4fb920573639614a4cd4afc77102d23197bd2d6b5a78b3"
+    static let releaseIdentity = "3.2.0-dev.127"
+    static let releaseSetId = "mentra-3.2.0-dev.127"
+    static let sourceCommit = "6f63b186e38f659faed60cbe5b9c95f457a32383"
+    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.127.json"
+    static let otaManifestSha256 = "426f58f142ca6d710089683c6e9462b0ce0c30d491b95747e960371e082f459c"
 }

package/ios/Source/audio/PcmStreamPlayer.swift

@@ -261,6 +261,17 @@ final class PcmStreamPlayer: @unchecked Sendable {
 
     private func installAudioSessionObservers() {
         let center = NotificationCenter.default
+        #if os(macOS)
+        observers.append(center.addObserver(
+            forName: .AVAudioEngineConfigurationChange, object: engine, queue: nil
+        ) { [weak self] _ in
+            self?.stateQueue.async {
+                // A device change invalidates scheduled buffers. Reject pending writes/close
+                // instead of leaving callers waiting for callbacks that cannot arrive.
+                self?.fail(PcmStreamError.native("Audio device changed; reopen the PCM stream"))
+            }
+        })
+        #else
         observers.append(
             center.addObserver(
                 forName: AVAudioSession.interruptionNotification,
@@ -294,6 +305,7 @@ final class PcmStreamPlayer: @unchecked Sendable {
                 }
             }
         )
+        #endif
     }
 
     private func removeAudioSessionObservers() {
@@ -301,6 +313,7 @@ final class PcmStreamPlayer: @unchecked Sendable {
         observers.removeAll()
     }
 
+    #if !os(macOS)
     private func handleInterruption(_ notification: Notification) {
         guard
             let raw = notification.userInfo?[AVAudioSessionInterruptionTypeKey] as? UInt,
@@ -321,6 +334,7 @@ final class PcmStreamPlayer: @unchecked Sendable {
             break
         }
     }
+    #endif
 }
 
 /// Process-wide registry matching the Android PCM stream bridge contract.

package/ios/Source/internal/BleTraceLogger.swift

@@ -1,6 +1,8 @@
 import Foundation
 import os.log
+#if canImport(UIKit)
 import UIKit
+#endif
 
 enum BleTraceLogger {
     private static let log = OSLog(subsystem: "com.mentra.bluetoothsdk", category: "MentraBleTrace")
@@ -66,9 +68,14 @@ enum BleTraceLogger {
             "event": event,
             "component": component,
             "pid": ProcessInfo.processInfo.processIdentifier,
-            "model": UIDevice.current.model,
-            "systemVersion": UIDevice.current.systemVersion,
         ]
+        #if os(macOS)
+        payload["model"] = "Mac"
+        payload["systemVersion"] = ProcessInfo.processInfo.operatingSystemVersionString
+        #else
+        payload["model"] = UIDevice.current.model
+        payload["systemVersion"] = UIDevice.current.systemVersion
+        #endif
         for (key, value) in extra {
             payload[key] = value
         }

package/ios/Source/internal/BluetoothSdkAnalytics.swift

@@ -8,7 +8,11 @@ public struct BluetoothSdkAnalyticsConfiguration {
 
     public init(enabled: Bool = true) {
         self.enabled = enabled
+        #if os(macOS)
+        surface = "macos"
+        #else
         surface = "ios"
+        #endif
     }
 
     var isReady: Bool {
@@ -141,14 +145,19 @@ final class BluetoothSdkAnalytics {
     }
 
     private func baseProperties(configuration: BluetoothSdkAnalyticsConfiguration) -> [String: Any] {
+        #if os(macOS)
+        let platform = "macos"
+        #else
+        let platform = "ios"
+        #endif
         var properties: [String: Any] = [
             "$process_person_profile": false,
             "event_source": "mentra_bluetooth_sdk",
-            "sdk_platform": "ios",
+            "sdk_platform": platform,
             "sdk_surface": configuration.surface,
             "app_identifier": Bundle.main.bundleIdentifier ?? "",
             "app_bundle_identifier": Bundle.main.bundleIdentifier ?? "",
-            "os_platform": "ios",
+            "os_platform": platform,
             "os_version": ProcessInfo.processInfo.operatingSystemVersionString,
         ]
         if let sdkVersion = BluetoothSdkDefaults.sdkVersion {

package/ios/Source/services/MacAudioDevices.swift

@@ -0,0 +1,96 @@
+#if os(macOS)
+    import CoreAudio
+    import Foundation
+
+    struct MacAudioDevice {
+        let id: AudioDeviceID
+        let name: String
+        let transport: UInt32
+        let hasInput: Bool
+
+        var isBluetooth: Bool {
+            transport == kAudioDeviceTransportTypeBluetooth || transport == kAudioDeviceTransportTypeBluetoothLE
+        }
+
+        static func input(for mode: String, devices: [MacAudioDevice], defaultInput: AudioDeviceID?) -> AudioDeviceID? {
+            let inputs = devices.filter(\.hasInput)
+            switch mode {
+            case MicTypes.PHONE_INTERNAL:
+                let builtIn = inputs.filter { $0.transport == kAudioDeviceTransportTypeBuiltIn }
+                return builtIn.first { $0.id == defaultInput }?.id ?? builtIn.map(\.id).min()
+            case MicTypes.BLUETOOTH, MicTypes.BLUETOOTH_CLASSIC:
+                // Respect the user's Sound settings; never pick an arbitrary nearby headset.
+                return inputs.first { $0.id == defaultInput && $0.isBluetooth }?.id
+            default:
+                return nil
+            }
+        }
+
+        static var available: [MacAudioDevice] {
+            var address = address(kAudioHardwarePropertyDevices)
+            var size: UInt32 = 0
+            guard AudioObjectGetPropertyDataSize(AudioObjectID(kAudioObjectSystemObject), &address, 0, nil, &size) == noErr
+            else { return [] }
+            var ids = [AudioDeviceID](repeating: 0, count: Int(size) / MemoryLayout<AudioDeviceID>.size)
+            guard AudioObjectGetPropertyData(AudioObjectID(kAudioObjectSystemObject), &address, 0, nil, &size, &ids) == noErr
+            else { return [] }
+            return ids.compactMap { id in
+                var nameAddress = self.address(kAudioObjectPropertyName)
+                var name: Unmanaged<CFString>?
+                var nameSize = UInt32(MemoryLayout<Unmanaged<CFString>?>.size)
+                guard AudioObjectGetPropertyData(id, &nameAddress, 0, nil, &nameSize, &name) == noErr
+                else { return nil }
+                guard let name = name?.takeRetainedValue() else { return nil }
+                var inputAddress = self.address(kAudioDevicePropertyStreams, scope: kAudioObjectPropertyScopeInput)
+                var inputSize: UInt32 = 0
+                let hasInput = AudioObjectGetPropertyDataSize(id, &inputAddress, 0, nil, &inputSize) == noErr && inputSize > 0
+                return MacAudioDevice(id: id, name: name as String,
+                                      transport: value(id, kAudioDevicePropertyTransportType) ?? 0, hasInput: hasInput)
+            }
+        }
+
+        static var defaultInput: AudioDeviceID? {
+            value(AudioObjectID(kAudioObjectSystemObject), kAudioHardwarePropertyDefaultInputDevice)
+        }
+
+        static var defaultOutput: AudioDeviceID? {
+            value(AudioObjectID(kAudioObjectSystemObject), kAudioHardwarePropertyDefaultOutputDevice)
+        }
+
+        static func value(_ object: AudioObjectID, _ selector: AudioObjectPropertySelector) -> UInt32? {
+            var address = address(selector)
+            var value: UInt32 = 0
+            var size = UInt32(MemoryLayout<UInt32>.size)
+            return AudioObjectGetPropertyData(object, &address, 0, nil, &size, &value) == noErr ? value : nil
+        }
+
+        static func address(_ selector: AudioObjectPropertySelector,
+                            scope: AudioObjectPropertyScope = kAudioObjectPropertyScopeGlobal) -> AudioObjectPropertyAddress
+        {
+            AudioObjectPropertyAddress(mSelector: selector, mScope: scope, mElement: kAudioObjectPropertyElementMain)
+        }
+    }
+
+    /// Observe route changes without selecting a system-wide audio device.
+    final class MacAudioRouteObserver {
+        private let listener: AudioObjectPropertyListenerBlock
+        private var selectors: [AudioObjectPropertySelector] = []
+
+        init(selectors: [AudioObjectPropertySelector], onChange: @escaping () -> Void) {
+            listener = { _, _ in onChange() }
+            for selector in selectors {
+                var address = MacAudioDevice.address(selector)
+                if AudioObjectAddPropertyListenerBlock(AudioObjectID(kAudioObjectSystemObject), &address, .main, listener) == noErr {
+                    self.selectors.append(selector)
+                }
+            }
+        }
+
+        deinit {
+            for selector in selectors {
+                var address = MacAudioDevice.address(selector)
+                AudioObjectRemovePropertyListenerBlock(AudioObjectID(kAudioObjectSystemObject), &address, .main, listener)
+            }
+        }
+    }
+#endif

package/ios/Source/services/MacPhoneMic.swift

@@ -0,0 +1,138 @@
+#if os(macOS)
+    import AudioUnit
+    import AVFoundation
+    import CoreAudio
+    import Foundation
+
+    @MainActor
+    final class PhoneMic {
+        static let shared = PhoneMic()
+        private var engine: AVAudioEngine?
+        private var configurationObserver: NSObjectProtocol?
+        private var routeObserver: MacAudioRouteObserver?
+        private var currentMode = ""
+        private var activeDevice: AudioDeviceID?
+        var isRecording: Bool {
+            engine?.isRunning == true
+        }
+
+        func checkPermissions() -> Bool {
+            AVCaptureDevice.authorizationStatus(for: .audio) == .authorized
+        }
+
+        func requestPermissions() async -> Bool {
+            checkPermissions()
+        }
+
+        func getAvailableInputDevices() -> [String: String] {
+            Dictionary(uniqueKeysWithValues: MacAudioDevice.available.filter(\.hasInput).map { (String($0.id), $0.name) })
+        }
+
+        func isRecordingWithMode(_ mode: String) -> Bool {
+            isRecording && currentMode == mode
+        }
+
+        func startMode(_ mode: String) -> Bool {
+            if isRecordingWithMode(mode) { return true }
+            guard !isRecording, checkPermissions() else { return false }
+            guard let device = MacAudioDevice.input(for: mode, devices: MacAudioDevice.available,
+                                                    defaultInput: MacAudioDevice.defaultInput) else { return false }
+            return start(device: device, mode: mode)
+        }
+
+        func startRecording() -> Bool {
+            startMode(MicTypes.PHONE_INTERNAL)
+        }
+
+        private func start(device: AudioDeviceID, mode: String) -> Bool {
+            let engine = AVAudioEngine()
+            let input = engine.inputNode
+            guard let unit = input.audioUnit else { return false }
+            var device = device
+            guard AudioUnitSetProperty(unit, kAudioOutputUnitProperty_CurrentDevice, kAudioUnitScope_Global,
+                                       0, &device, UInt32(MemoryLayout<AudioDeviceID>.size)) == noErr
+            else { return false }
+            let format = input.outputFormat(forBus: 0)
+            guard format.sampleRate > 0, format.channelCount > 0,
+                  let output = AVAudioFormat(commonFormat: .pcmFormatInt16, sampleRate: 16000, channels: 1, interleaved: false),
+                  let converter = AVAudioConverter(from: format, to: output)
+            else { return false }
+            input.installTap(onBus: 0, bufferSize: 1024, format: format) { [weak self, weak engine] buffer, _ in
+                let capacity = AVAudioFrameCount(ceil(Double(buffer.frameLength) * output.sampleRate / format.sampleRate))
+                guard let converted = AVAudioPCMBuffer(pcmFormat: output, frameCapacity: capacity) else { return }
+                var supplied = false
+                var error: NSError?
+                let result = converter.convert(to: converted, error: &error) { _, status in
+                    guard !supplied else { status.pointee = .noDataNow; return nil }
+                    supplied = true
+                    status.pointee = .haveData
+                    return buffer
+                }
+                guard result != .error, error == nil, converted.frameLength > 0,
+                      let samples = converted.int16ChannelData?[0] else { return }
+                let pcm = Data(bytes: samples, count: Int(converted.frameLength) * MemoryLayout<Int16>.size)
+                Task { @MainActor [weak self, weak engine] in
+                    guard let engine, self?.engine === engine else { return }
+                    DeviceManager.shared.handlePcm(pcm)
+                }
+            }
+            do {
+                try engine.start()
+            } catch {
+                input.removeTap(onBus: 0)
+                Bridge.log("MIC: macOS input failed: \(error.localizedDescription)")
+                return false
+            }
+            self.engine = engine
+            activeDevice = device
+            currentMode = mode
+            routeObserver = MacAudioRouteObserver(selectors: [kAudioHardwarePropertyDevices, kAudioHardwarePropertyDefaultInputDevice]) { [weak self, weak engine] in
+                Task { @MainActor in
+                    guard let self, let engine, self.engine === engine else { return }
+                    let desired = MacAudioDevice.input(for: self.currentMode, devices: MacAudioDevice.available,
+                                                       defaultInput: MacAudioDevice.defaultInput)
+                    guard desired != self.activeDevice else { return }
+                    self.stopRecording()
+                    DeviceManager.shared.updateMicState()
+                }
+            }
+            configurationObserver = NotificationCenter.default.addObserver(
+                forName: .AVAudioEngineConfigurationChange, object: engine, queue: .main
+            ) { [weak self, weak engine] _ in
+                Task { @MainActor in
+                    guard let engine, self?.engine === engine else { return }
+                    self?.stopRecording()
+                    DeviceManager.shared.updateMicState()
+                }
+            }
+            return true
+        }
+
+        func getActiveInputDevice() -> String? {
+            MacAudioDevice.available.first(where: { $0.id == activeDevice })?.name
+        }
+
+        func stopMode(_ mode: String) -> Bool {
+            guard currentMode == mode else { return false }
+            stopRecording()
+            return true
+        }
+
+        func stopRecording() {
+            routeObserver = nil
+            if let configurationObserver {
+                NotificationCenter.default.removeObserver(configurationObserver)
+            }
+            configurationObserver = nil
+            engine?.inputNode.removeTap(onBus: 0)
+            engine?.stop()
+            engine = nil
+            currentMode = ""
+            activeDevice = nil
+        }
+
+        func cleanup() {
+            stopRecording()
+        }
+    }
+#endif

package/ios/Source/services/PhoneMic.swift

@@ -5,6 +5,7 @@
 //  Created on 3/8/25.
 //
 
+#if !os(macOS)
 import AVFoundation
 import Combine
 import Foundation
@@ -661,3 +662,4 @@ class PhoneMic {
         stopRecording()
     }
 }
+#endif

package/ios/Source/sgcs/G1.swift

@@ -8,7 +8,7 @@
 import Combine
 import CoreBluetooth
 import Foundation
-import UIKit
+import CoreGraphics
 
 extension Data {
     func chunked(into size: Int) -> [Data] {
@@ -1822,7 +1822,7 @@ extension G1 {
     /// Mirrors G2.convertToG2Bmp() for local miniapp bitmap display support.
     /// G1 uses 1-bit monochrome BMP at 640x400 (576x135 active area).
     func convertToG1Bmp(_ imageData: Data, width: Int = 576, height: Int = 135) -> Data? {
-        guard let image = UIImage(data: imageData), let cgImage = image.cgImage else {
+        guard let image = SdkImage(data: imageData), let cgImage = image.cgImage else {
             Bridge.log("G1: convertToG1Bmp - could not decode image")
             return nil
         }

package/ios/Source/sgcs/G2.swift

@@ -9,7 +9,7 @@
 import Combine
 import CoreBluetooth
 import Foundation
-import UIKit
+import CoreGraphics
 
 /// Keep a low-rate, non-audio EvenHub sensor stream active so iOS continues receiving BLE
 /// notifications while the Mentra App is backgrounded. The samples stay internal unless IMU was
@@ -2565,7 +2565,7 @@ class G2: NSObject, SGCManager {
     /// (aspect-fit, centered on black) — the front half of `convertToG2Bmp`,
     /// exposed for the tiler which encodes per-tile BMPs from one render.
     private func renderG2Grayscale(_ data: Data, targetWidth: Int, targetHeight: Int) -> Data? {
-        guard let image = UIImage(data: data), let cgImage = image.cgImage else { return nil }
+        guard let image = SdkImage(data: data), let cgImage = image.cgImage else { return nil }
         let scale = min(
             Double(targetWidth) / Double(cgImage.width), Double(targetHeight) / Double(cgImage.height)
         )
@@ -3101,7 +3101,7 @@ class G2: NSObject, SGCManager {
     /// Scale source image to fit within containerWidth x containerHeight (maintaining aspect ratio),
     /// centered on a black background. Output BMP always matches container dimensions exactly.
     private func convertToG2Bmp(_ data: Data, containerWidth: Int, containerHeight: Int) -> Data? {
-        guard let image = UIImage(data: data), let cgImage = image.cgImage else {
+        guard let image = SdkImage(data: data), let cgImage = image.cgImage else {
             Bridge.log("G2: convertToG2Bmp - could not decode image")
             return nil
         }

package/ios/Source/sgcs/MentraLive.swift

@@ -16,7 +16,6 @@ import Combine
 import CoreBluetooth
 import Foundation
 import ImageIO
-import UIKit
 
 // MARK: - Supporting Types
 
@@ -355,11 +354,11 @@ class BlePhotoUploadService {
     }
 
     /**
-     * Decode image data (AVIF or JPEG) to UIImage.
+     * Decode image data (AVIF or JPEG).
      * AVIF arriving from glasses has a TIFF EXIF block appended to {@code mdat}; iOS ImageIO
      * rejects those bytes the same way Android does. Strip the Exif tail before decoding.
      */
-    private static func decodeImage(imageData: Data) -> UIImage? {
+    private static func decodeImage(imageData: Data) -> SdkImage? {
         let isAvif = isAvifData(imageData)
         var decodeData = imageData
         if isAvif && containsExifMarker(in: imageData) {
@@ -372,13 +371,13 @@ class BlePhotoUploadService {
             }
         }
 
-        if let image = UIImage(data: decodeData) {
+        if let image = SdkImage(data: decodeData) {
             return image
         }
 
         if isAvif {
-            if #available(iOS 16.0, *) {
-                return UIImage(data: decodeData)
+            if #available(iOS 16.0, macOS 13.0, *) {
+                return SdkImage(data: decodeData)
             } else {
                 Bridge.log("\(TAG): AVIF decoding not supported on iOS < 16")
                 return nil
@@ -1022,6 +1021,7 @@ extension MentraLive: CBCentralManagerDelegate {
         }
     }
 
+    #if !os(macOS)
     nonisolated func centralManager(
         _: CBCentralManager, didUpdateANCSAuthorizationFor peripheral: CBPeripheral
     ) {
@@ -1033,6 +1033,7 @@ extension MentraLive: CBCentralManagerDelegate {
             self.enableAncsRelayIfAuthorized()
         }
     }
+    #endif
 
     nonisolated func centralManager(
         _: CBCentralManager, didDisconnectPeripheral peripheral: CBPeripheral, error: Error?
@@ -2443,6 +2444,9 @@ class MentraLive: NSObject, SGCManager {
         // Set connection timeout
         startConnectionTimeout()
 
+        #if os(macOS)
+        centralManager?.connect(peripheral, options: nil)
+        #else
         // ANCS is hosted by iOS and is only exposed to authorized accessories.
         // Requiring it at connect time lets the system complete that authorization
         // flow before the glasses subscribe to the ANCS characteristics.
@@ -2450,12 +2454,14 @@ class MentraLive: NSObject, SGCManager {
             peripheral,
             options: [CBConnectPeripheralOptionRequiresANCS: true]
         )
+        #endif
     }
 
     /// Opt the firmware into ANCS only after iOS has authorized this accessory.
     /// Old firmware safely ignores the command, while new firmware stays inert
     /// for old mobile clients that never send it.
     private func enableAncsRelayIfAuthorized() {
+        #if !os(macOS)
         guard !ancsRelayEnableRequested,
               let peripheral = connectedPeripheral,
               txCharacteristic != nil,
@@ -2473,6 +2479,7 @@ class MentraLive: NSObject, SGCManager {
             ancsRelayEnableRequested = true
             Bridge.log("LIVE: Requested ANCS relay from compatible firmware")
         }
+        #endif
     }
 
     private func handleReconnection() {

package/ios/Source/sgcs/Nimo.swift

@@ -10,7 +10,7 @@ import AVFoundation
 import Compression
 import CoreBluetooth
 import Foundation
-import UIKit
+import CoreGraphics
 
 // MARK: - Nimo BLE Constants
 
@@ -846,7 +846,7 @@ class Nimo: NSObject, SGCManager {
         let targetHeight = NimoProtocol.NAV_LARGE_MAP_HEIGHT
         Bridge.log("NIMO: displayBitmap → nav large map (navAppEntered=\(navAppEntered))")
         guard let imageData = Data(base64Encoded: base64ImageData),
-              let image = UIImage(data: imageData)
+              let image = SdkImage(data: imageData)
         else {
             Bridge.log("NIMO: displayBitmap — could not decode image")
             return false
@@ -1640,7 +1640,7 @@ class Nimo: NSObject, SGCManager {
     // MARK: - Bitmap Helpers
 
     /// Aspect-fit the image into `width`x`height` on black, then convert to L8 grayscale.
-    private func bitmapToGrayscale(_ image: UIImage, width: Int, height: Int) -> Data? {
+    private func bitmapToGrayscale(_ image: SdkImage, width: Int, height: Int) -> Data? {
         guard let cgImage = image.cgImage else { return nil }
         let colorSpace = CGColorSpaceCreateDeviceGray()
         guard let context = CGContext(

package/ios/Source/utils/AudioSessionMonitor.swift

@@ -6,6 +6,7 @@
 //  Used to detect when Mentra Live glasses are paired/connected for audio
 //
 
+#if !os(macOS)
 import AVFoundation
 import Foundation
 import UIKit
@@ -281,3 +282,4 @@ class AudioSessionMonitor {
         }
     }
 }
+#endif

package/ios/Source/utils/JSCExperiment.swift

@@ -102,7 +102,7 @@ private func jlog(_ message: String) {
             ctx.name = "MentraJS: \(id)"
             // Inspectable in dev builds only. iOS 16.4+ guarded.
             #if DEBUG
-                if #available(iOS 16.4, *) {
+                if #available(iOS 16.4, macOS 13.3, *) {
                     ctx.isInspectable = true
                 }
             #endif

package/ios/Source/utils/MacAudioSessionMonitor.swift

@@ -0,0 +1,18 @@
+#if os(macOS)
+    import Foundation
+
+    enum AudioSessionMonitor {
+        static func isAudioDeviceConnected(devicePattern: String) -> Bool {
+            MacAudioDevice.available.contains {
+                $0.isBluetooth && $0.name.localizedCaseInsensitiveContains(devicePattern)
+            }
+        }
+
+        static func isOtherAudioDeviceConnected(devicePattern: String) -> Bool {
+            let output = MacAudioDevice.defaultOutput
+            return MacAudioDevice.available.contains {
+                $0.id == output && $0.isBluetooth && !$0.name.localizedCaseInsensitiveContains(devicePattern)
+            }
+        }
+    }
+#endif

package/ios/Source/utils/PhoneAudioMonitor.swift

@@ -50,9 +50,15 @@ class PhoneAudioMonitor {
 
     /// Check if any audio is currently playing on the device (including our own app)
     func isPlaying() -> Bool {
+        #if os(macOS)
+        // macOS has no AVAudioSession audio-focus contract. Explicit SDK playback
+        // is tracked; other applications retain independent system audio routes.
+        return ownAppAudioPlaying
+        #else
         let session = AVAudioSession.sharedInstance()
         // Combine: other apps playing OR our own app playing
         return session.isOtherAudioPlaying || ownAppAudioPlaying
+        #endif
     }
 
     func isOwnAppAudioPlaying() -> Bool {
@@ -88,6 +94,7 @@ class PhoneAudioMonitor {
             "PhoneAudioMonitor: Starting audio playback monitoring (initial state: \(lastKnownState ? "playing" : "not playing"))"
         )
 
+        #if !os(macOS)
         // Register for silenceSecondaryAudioHint notification
         // This is fired when other apps start/stop playing audio
         NotificationCenter.default.addObserver(
@@ -108,6 +115,7 @@ class PhoneAudioMonitor {
         // Start polling as a fallback mechanism
         // Some audio sources might not trigger notifications reliably
         startPolling()
+        #endif
     }
 
     /// Stop monitoring for phone audio playback changes
@@ -119,6 +127,7 @@ class PhoneAudioMonitor {
 
         Bridge.log("PhoneAudioMonitor: Stopping audio playback monitoring")
 
+        #if !os(macOS)
         NotificationCenter.default.removeObserver(
             self,
             name: AVAudioSession.silenceSecondaryAudioHintNotification,
@@ -132,11 +141,13 @@ class PhoneAudioMonitor {
         )
 
         stopPolling()
+        #endif
 
         listener = nil
         isMonitoring = false
     }
 
+    #if !os(macOS)
     /// Handle silenceSecondaryAudioHint notification
     @objc private func handleSilenceSecondaryAudioHint(_ notification: Notification) {
         guard let userInfo = notification.userInfo,
@@ -191,6 +202,8 @@ class PhoneAudioMonitor {
         }
     }
 
+    #endif
+
     /// Start polling isOtherAudioPlaying as a fallback mechanism
     private func startPolling() {
         pollingTimer = Timer.scheduledTimer(

package/ios/Source/utils/SdkImage.swift

@@ -0,0 +1,37 @@
+import Foundation
+import ImageIO
+import UniformTypeIdentifiers
+
+/// Decode upright pixels once, so bitmap rendering and JPEG encoding agree on both Apple platforms.
+struct SdkImage {
+    let cgImage: CGImage?
+    var size: CGSize {
+        CGSize(width: cgImage?.width ?? 0, height: cgImage?.height ?? 0)
+    }
+
+    init?(data: Data) {
+        guard let source = CGImageSourceCreateWithData(data as CFData, nil),
+              let properties = CGImageSourceCopyPropertiesAtIndex(source, 0, nil) as? [CFString: Any],
+              let width = properties[kCGImagePropertyPixelWidth] as? Int,
+              let height = properties[kCGImagePropertyPixelHeight] as? Int,
+              let image = CGImageSourceCreateThumbnailAtIndex(source, 0, [
+                  kCGImageSourceCreateThumbnailFromImageAlways: true,
+                  kCGImageSourceCreateThumbnailWithTransform: true,
+                  kCGImageSourceThumbnailMaxPixelSize: max(width, height),
+              ] as CFDictionary)
+        else { return nil }
+        cgImage = image
+    }
+
+    func jpegData(compressionQuality: CGFloat) -> Data? {
+        guard let cgImage else { return nil }
+        let data = NSMutableData()
+        guard let destination = CGImageDestinationCreateWithData(data, UTType.jpeg.identifier as CFString, 1, nil)
+        else { return nil }
+        CGImageDestinationAddImage(destination, cgImage, [
+            kCGImageDestinationLossyCompressionQuality: compressionQuality,
+            kCGImagePropertyOrientation: 1,
+        ] as CFDictionary)
+        return CGImageDestinationFinalize(destination) ? data as Data : nil
+    }
+}

package/ios/Tests/MacAudioDevicesTests.swift

@@ -0,0 +1,32 @@
+#if os(macOS)
+    import CoreAudio
+    @testable import MentraBluetoothSDK
+    import XCTest
+
+    final class MacAudioDevicesTests: XCTestCase {
+        private let devices = [
+            MacAudioDevice(id: 1, name: "Internal", transport: kAudioDeviceTransportTypeBuiltIn, hasInput: true),
+            MacAudioDevice(id: 2, name: "Headset A", transport: kAudioDeviceTransportTypeBluetooth, hasInput: true),
+            MacAudioDevice(id: 3, name: "Headset B", transport: kAudioDeviceTransportTypeBluetoothLE, hasInput: true),
+            MacAudioDevice(id: 4, name: "Speakers", transport: kAudioDeviceTransportTypeBluetooth, hasInput: false),
+        ]
+
+        func testBluetoothUsesSelectedInputRegardlessOfEnumerationOrder() {
+            for mode in [MicTypes.BLUETOOTH, MicTypes.BLUETOOTH_CLASSIC] {
+                for inputs in [devices, devices.reversed()] {
+                    XCTAssertEqual(MacAudioDevice.input(for: mode, devices: inputs, defaultInput: 3), 3)
+                    XCTAssertEqual(MacAudioDevice.input(for: mode, devices: inputs, defaultInput: 2), 2)
+                    XCTAssertNil(MacAudioDevice.input(for: mode, devices: inputs, defaultInput: 1))
+                    XCTAssertNil(MacAudioDevice.input(for: mode, devices: inputs, defaultInput: 4))
+                    XCTAssertNil(MacAudioDevice.input(for: mode, devices: inputs, defaultInput: nil))
+                }
+            }
+        }
+
+        func testInternalModeNeverFallsBackToBluetooth() {
+            XCTAssertEqual(MacAudioDevice.input(for: MicTypes.PHONE_INTERNAL, devices: devices, defaultInput: 3), 1)
+            XCTAssertNil(MacAudioDevice.input(for: MicTypes.PHONE_INTERNAL, devices: Array(devices.dropFirst()), defaultInput: 3))
+            XCTAssertNil(MacAudioDevice.input(for: "invalid", devices: devices, defaultInput: 1))
+        }
+    }
+#endif

package/ios/Tests/SdkImageTests.swift

@@ -0,0 +1,53 @@
+import CoreGraphics
+import ImageIO
+@testable import MentraBluetoothSDK
+import UniformTypeIdentifiers
+import XCTest
+
+final class SdkImageTests: XCTestCase {
+    func testInvalidImageIsRejected() {
+        XCTAssertNil(SdkImage(data: Data("not an image".utf8)))
+    }
+
+    func testAllExifOrientationsProduceUprightPixelsAndJpegs() throws {
+        // Six asymmetric tiles distinguish rotations from reflections.
+        let pixels: [UInt8] = [10, 50, 90, 130, 170, 210]
+        let raster = (0 ..< 32).flatMap { y in (0 ..< 48).map { x in pixels[(y / 16) * 3 + x / 16] } }
+        let provider = try XCTUnwrap(CGDataProvider(data: Data(raster) as CFData))
+        let image = try XCTUnwrap(CGImage(width: 48, height: 32, bitsPerComponent: 8, bitsPerPixel: 8,
+                                          bytesPerRow: 48, space: CGColorSpaceCreateDeviceGray(), bitmapInfo: [],
+                                          provider: provider, decode: nil, shouldInterpolate: false, intent: .defaultIntent))
+        let expected: [[UInt8]] = [
+            [10, 50, 90, 130, 170, 210], [90, 50, 10, 210, 170, 130],
+            [210, 170, 130, 90, 50, 10], [130, 170, 210, 10, 50, 90],
+            [10, 130, 50, 170, 90, 210], [130, 10, 170, 50, 210, 90],
+            [210, 90, 170, 50, 130, 10], [90, 210, 50, 170, 10, 130],
+        ]
+        for orientation in 1 ... 8 {
+            let data = NSMutableData()
+            let destination = try XCTUnwrap(CGImageDestinationCreateWithData(data, UTType.tiff.identifier as CFString, 1, nil))
+            CGImageDestinationAddImage(destination, image, [kCGImagePropertyOrientation: orientation] as CFDictionary)
+            XCTAssertTrue(CGImageDestinationFinalize(destination))
+
+            let decoded = try XCTUnwrap(SdkImage(data: data as Data))
+            let width = orientation < 5 ? 48 : 32
+            let height = orientation < 5 ? 32 : 48
+            XCTAssertEqual(decoded.size, CGSize(width: width, height: height))
+            let context = try XCTUnwrap(CGContext(data: nil, width: width, height: height, bitsPerComponent: 8,
+                                                  bytesPerRow: width, space: CGColorSpaceCreateDeviceGray(), bitmapInfo: 0))
+            try context.draw(XCTUnwrap(decoded.cgImage), in: CGRect(x: 0, y: 0, width: width, height: height))
+            let bytes = try XCTUnwrap(context.data).assumingMemoryBound(to: UInt8.self)
+            let actual = stride(from: 8, to: height, by: 16).flatMap { y in
+                stride(from: 8, to: width, by: 16).map { x in bytes[y * context.bytesPerRow + x] }
+            }
+            XCTAssertEqual(actual, expected[orientation - 1], "EXIF \(orientation)")
+
+            let jpeg = try XCTUnwrap(decoded.jpegData(compressionQuality: 1))
+            let source = try XCTUnwrap(CGImageSourceCreateWithData(jpeg as CFData, nil))
+            let properties = try XCTUnwrap(CGImageSourceCopyPropertiesAtIndex(source, 0, nil) as? [CFString: Any])
+            XCTAssertEqual(CGImageSourceGetType(source), UTType.jpeg.identifier as CFString)
+            XCTAssertEqual(properties[kCGImagePropertyOrientation] as? Int ?? 1, 1)
+            XCTAssertEqual(try XCTUnwrap(SdkImage(data: jpeg)).size, decoded.size)
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "3.2.0-dev.122",
+  "version": "3.2.0-dev.127",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",

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.0",
-  "releaseIdentity": "3.2.0-dev.122",
-  "releaseSetId": "mentra-3.2.0-dev.122",
-  "sourceCommit": "4564c9f8b5fc947a7bb46e9710cb1b6c9268d7bf",
-  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.122.json",
-  "otaManifestSha256": "796e5a40d857e3fc5f4fb920573639614a4cd4afc77102d23197bd2d6b5a78b3"
+  "releaseIdentity": "3.2.0-dev.127",
+  "releaseSetId": "mentra-3.2.0-dev.127",
+  "sourceCommit": "6f63b186e38f659faed60cbe5b9c95f457a32383",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.127.json",
+  "otaManifestSha256": "426f58f142ca6d710089683c6e9462b0ce0c30d491b95747e960371e082f459c"
 })