@mentra/bluetooth-sdk 3.2.0-dev.193 → 3.2.0-dev.195

package/ios/Source/types/DeviceModels.swift

@@ -169,9 +169,17 @@ public struct Device: Identifiable, Equatable, CustomStringConvertible {
 public struct ConnectOptions {
     public let saveAsDefault: Bool
     public let cancelExistingConnectionAttempt: Bool
+    /// Mentra Live on iOS only. Whether CoreBluetooth should require ANCS
+    /// authorization while establishing the connection.
+    public let requiresAncs: Bool
 
-    public init(saveAsDefault: Bool = true, cancelExistingConnectionAttempt: Bool = true) {
+    public init(
+        saveAsDefault: Bool = true,
+        cancelExistingConnectionAttempt: Bool = true,
+        requiresAncs: Bool = true
+    ) {
         self.saveAsDefault = saveAsDefault
         self.cancelExistingConnectionAttempt = cancelExistingConnectionAttempt
+        self.requiresAncs = requiresAncs
     }
 }

package/ios/Tests/MentraLiveConnectionOptionsTests.swift

@@ -0,0 +1,30 @@
+import CoreBluetooth
+@testable import MentraBluetoothSDK
+import XCTest
+
+final class MentraLiveConnectionOptionsTests: XCTestCase {
+    func testConnectOptionsRequireAncsByDefault() {
+        XCTAssertTrue(ConnectOptions().requiresAncs)
+    }
+
+    func testConnectOptionsCanDisableAncsRequirement() {
+        XCTAssertFalse(ConnectOptions(requiresAncs: false).requiresAncs)
+    }
+
+    #if os(macOS)
+        func testCoreBluetoothOptionsOmitAncsOnMacOS() {
+            XCTAssertNil(MentraLiveConnectionOptions.coreBluetoothOptions(requiresAncs: true))
+        }
+    #else
+        func testCoreBluetoothOptionsRequireAncsWhenEnabled() {
+            let options = MentraLiveConnectionOptions.coreBluetoothOptions(requiresAncs: true)
+
+            XCTAssertEqual(options?.count, 1)
+            XCTAssertEqual(options?[CBConnectPeripheralOptionRequiresANCS] as? Bool, true)
+        }
+    #endif
+
+    func testCoreBluetoothOptionsAreOmittedWhenAncsIsDisabled() {
+        XCTAssertNil(MentraLiveConnectionOptions.coreBluetoothOptions(requiresAncs: false))
+    }
+}

package/package.json

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

package/src/BluetoothSdk.types.ts

@@ -1485,6 +1485,13 @@ export interface Device {
 export interface ConnectOptions {
   saveAsDefault?: boolean
   cancelExistingConnectionAttempt?: boolean
+  /**
+   * iOS Mentra Live only. When true, CoreBluetooth requires ANCS authorization
+   * as part of the connection. Set false when the app does not use notification
+   * relay and must avoid the system ANCS authorization flow. Defaults to true.
+   * Android accepts this option as a no-op.
+   */
+  requiresAncs?: boolean
 }
 
 export type ScanResultsCallback = (devices: Device[]) => void

package/src/_private/BluetoothSdkModule.ts

@@ -295,6 +295,7 @@ installNativeLogConsole(NativeBluetoothSdkModule, Platform.OS)
 const DEFAULT_CONNECT_OPTIONS: Required<ConnectOptions> = {
   saveAsDefault: true,
   cancelExistingConnectionAttempt: true,
+  requiresAncs: true,
 }
 
 const DEFAULT_SCAN_TIMEOUT_MS = 15_000

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.193",
-  "releaseSetId": "mentra-3.2.0-dev.193",
-  "sourceCommit": "ca3b4bd4109d80253a3369cbf1ca8f9e86236fba",
-  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.193.json",
-  "otaManifestSha256": "b5201e1a9d926df220adfbf26cba934948d3f09ed81453c3600770a7618dd997"
+  "releaseIdentity": "3.2.0-dev.195",
+  "releaseSetId": "mentra-3.2.0-dev.195",
+  "sourceCommit": "321202ca96ec1852be19a7230ebcc3593fe87e54",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.195.json",
+  "otaManifestSha256": "70f26063b2c281b9b046965f6f6d7ca22f8b53242c6c5be02030c5a04c7115e4"
 })

package/src/react/useGlassesConnection.ts

@@ -22,6 +22,11 @@ export type UseGlassesConnectionOptions = {
   autoConnectDefault?: boolean
   defaultDeviceStorage?: DefaultDeviceStorage
   onError?: (error: unknown) => void
+  /**
+   * Whether iOS should require ANCS authorization when automatically connecting.
+   * Defaults to true. Android accepts this option as a no-op.
+   */
+  requiresAncs?: boolean
   scanModel?: DeviceModel
   scanTimeoutMs?: number
 }
@@ -117,8 +122,8 @@ export function useGlassesConnection(
     }
 
     autoConnectAttemptedRef.current = true
-    void connectDefault().catch(() => undefined)
-  }, [defaultDevice, options.autoConnectDefault, status.connected])
+    void connectDefault({requiresAncs: options.requiresAncs ?? true}).catch(() => undefined)
+  }, [defaultDevice, options.autoConnectDefault, options.requiresAncs, status.connected])
 
   async function runConnectionAction<T>(
     nextAction: Exclude<GlassesConnectionAction, "idle" | "scanning">,

package/src/react/useMentraBluetooth.ts

@@ -121,6 +121,11 @@ export type UseMentraBluetoothOptions = {
   defaultDeviceStorage?: DefaultDeviceStorage
   defaultModel?: DeviceModel
   onError?: (error: unknown) => void
+  /**
+   * Whether iOS should require ANCS authorization when automatically connecting.
+   * Defaults to true. Android accepts this option as a no-op.
+   */
+  requiresAncs?: boolean
   scanTimeoutMs?: number
 }
 
@@ -269,6 +274,7 @@ export function useMentraBluetooth(options: UseMentraBluetoothOptions = {}): Men
     autoConnectDefault: options.autoConnectDefault,
     defaultDeviceStorage: options.defaultDeviceStorage,
     onError: options.onError,
+    requiresAncs: options.requiresAncs,
     scanModel: options.defaultModel ?? DeviceModels.MentraLive,
     scanTimeoutMs: options.scanTimeoutMs,
   })