@mentra/bluetooth-sdk 3.2.0-dev.180 → 3.2.0-dev.187

package/build/react/useBluetoothScan.js

@@ -31,6 +31,7 @@ function hasDevice(devices, selectedDevice, dedupe) {
 }
 export function useBluetoothScan(options = {}) {
     const [devices, setDevices] = useState([]);
+    const [diagnostic, setDiagnostic] = useState(null);
     const [error, setError] = useState(null);
     const [model, setModelState] = useState(options.model ?? DeviceModels.MentraLive);
     const [scanning, setScanning] = useState(false);
@@ -63,10 +64,13 @@ export function useBluetoothScan(options = {}) {
         };
     }, []);
     function clearResults() {
+        setDiagnostic(null);
         setDevices([]);
         selectDevice(null);
     }
     function setModel(nextModel) {
+        if (scanningRef.current)
+            void stopScan();
         setModelState(nextModel);
         clearResults();
     }
@@ -78,6 +82,7 @@ export function useBluetoothScan(options = {}) {
             setModelState(nextModel);
         }
         setError(null);
+        setDiagnostic(null);
         setScanning(true);
         scanningRef.current = true;
         setDevices([]);
@@ -85,10 +90,16 @@ export function useBluetoothScan(options = {}) {
         try {
             const nextDevices = await BluetoothSdk.scan(scanModel, {
                 ...(timeoutMsRef.current == null ? {} : { timeoutMs: timeoutMsRef.current }),
+                onDiagnostic: (hint) => {
+                    if (activeScanRef.current === scanId)
+                        setDiagnostic(hint);
+                },
                 onResults: (results) => {
                     if (activeScanRef.current !== scanId) {
                         return;
                     }
+                    if (results.length > 0)
+                        setDiagnostic(null);
                     setDevices(dedupeDevices(results, dedupeRef.current));
                 },
             });
@@ -114,6 +125,7 @@ export function useBluetoothScan(options = {}) {
         }
     }
     async function stopScan() {
+        setDiagnostic(null);
         activeScanRef.current += 1;
         setScanning(false);
         scanningRef.current = false;
@@ -122,6 +134,7 @@ export function useBluetoothScan(options = {}) {
     return {
         clearResults,
         devices,
+        diagnostic,
         error,
         model,
         scanning,

package/build/react/useBluetoothScan.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBluetoothScan.js","sourceRoot":"","sources":["../../src/react/useBluetoothScan.ts"],"names":[],"mappings":"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","sourcesContent":["import {useEffect, useRef, useState} from \"react\"\n\nimport BluetoothSdk, {DeviceModels} from \"../index\"\nimport type {Device, DeviceModel} from \"../BluetoothSdk.types\"\n\nexport type BluetoothScanDedupe = \"id\" | \"name\" | ((device: Device) => string)\n\nexport type UseBluetoothScanOptions = {\n  dedupe?: BluetoothScanDedupe\n  model?: DeviceModel\n  onError?: (error: unknown) => void\n  timeoutMs?: number\n}\n\nexport type BluetoothScanHookResult = {\n  clearResults: () => void\n  devices: Device[]\n  error: unknown | null\n  model: DeviceModel\n  scanning: boolean\n  selectedDevice: Device | null\n  selectDevice: (device: Device | null) => void\n  setModel: (model: DeviceModel) => void\n  startScan: (model?: DeviceModel) => Promise<Device[]>\n  stopScan: () => Promise<void>\n}\n\nfunction dedupeKey(device: Device, dedupe: BluetoothScanDedupe): string {\n  if (typeof dedupe === \"function\") {\n    return dedupe(device)\n  }\n  if (dedupe === \"name\") {\n    return `${device.model}:${device.name}`\n  }\n  return device.id\n}\n\nfunction dedupeDevices(devices: Device[], dedupe: BluetoothScanDedupe): Device[] {\n  const seen = new Set<string>()\n  const nextDevices: Device[] = []\n\n  devices.forEach((device) => {\n    const key = dedupeKey(device, dedupe)\n    if (seen.has(key)) {\n      return\n    }\n    seen.add(key)\n    nextDevices.push(device)\n  })\n\n  return nextDevices\n}\n\nfunction hasDevice(devices: Device[], selectedDevice: Device | null, dedupe: BluetoothScanDedupe): boolean {\n  if (!selectedDevice) {\n    return true\n  }\n  const selectedKey = dedupeKey(selectedDevice, dedupe)\n  return devices.some((device) => dedupeKey(device, dedupe) === selectedKey)\n}\n\nexport function useBluetoothScan(options: UseBluetoothScanOptions = {}): BluetoothScanHookResult {\n  const [devices, setDevices] = useState<Device[]>([])\n  const [error, setError] = useState<unknown | null>(null)\n  const [model, setModelState] = useState<DeviceModel>(options.model ?? DeviceModels.MentraLive)\n  const [scanning, setScanning] = useState(false)\n  const [selectedDevice, selectDevice] = useState<Device | null>(null)\n  const activeScanRef = useRef(0)\n  const dedupeRef = useRef<BluetoothScanDedupe>(options.dedupe ?? \"id\")\n  const onErrorRef = useRef(options.onError)\n  const scanningRef = useRef(false)\n  const timeoutMsRef = useRef(options.timeoutMs)\n\n  useEffect(() => {\n    dedupeRef.current = options.dedupe ?? \"id\"\n    onErrorRef.current = options.onError\n    timeoutMsRef.current = options.timeoutMs\n  }, [options.dedupe, options.onError, options.timeoutMs])\n\n  useEffect(() => {\n    scanningRef.current = scanning\n  }, [scanning])\n\n  useEffect(() => {\n    if (!hasDevice(devices, selectedDevice, dedupeRef.current)) {\n      selectDevice(null)\n    }\n  }, [devices, selectedDevice])\n\n  useEffect(() => {\n    return () => {\n      if (!scanningRef.current) {\n        return\n      }\n      activeScanRef.current += 1\n      void BluetoothSdk.stopScan().catch(() => undefined)\n    }\n  }, [])\n\n  function clearResults() {\n    setDevices([])\n    selectDevice(null)\n  }\n\n  function setModel(nextModel: DeviceModel) {\n    setModelState(nextModel)\n    clearResults()\n  }\n\n  async function startScan(nextModel?: DeviceModel): Promise<Device[]> {\n    const scanId = activeScanRef.current + 1\n    activeScanRef.current = scanId\n    const scanModel = nextModel ?? model\n    if (nextModel && nextModel !== model) {\n      setModelState(nextModel)\n    }\n\n    setError(null)\n    setScanning(true)\n    scanningRef.current = true\n    setDevices([])\n    selectDevice(null)\n\n    try {\n      const nextDevices = await BluetoothSdk.scan(scanModel, {\n        ...(timeoutMsRef.current == null ? {} : {timeoutMs: timeoutMsRef.current}),\n        onResults: (results) => {\n          if (activeScanRef.current !== scanId) {\n            return\n          }\n          setDevices(dedupeDevices(results, dedupeRef.current))\n        },\n      })\n      const finalDevices = dedupeDevices(nextDevices, dedupeRef.current)\n      if (activeScanRef.current === scanId) {\n        setDevices(finalDevices)\n        setError(null)\n      }\n      return finalDevices\n    } catch (nextError) {\n      if (activeScanRef.current === scanId) {\n        setError(nextError)\n        onErrorRef.current?.(nextError)\n      }\n      throw nextError\n    } finally {\n      if (activeScanRef.current === scanId) {\n        setScanning(false)\n        scanningRef.current = false\n      }\n    }\n  }\n\n  async function stopScan() {\n    activeScanRef.current += 1\n    setScanning(false)\n    scanningRef.current = false\n    await BluetoothSdk.stopScan()\n  }\n\n  return {\n    clearResults,\n    devices,\n    error,\n    model,\n    scanning,\n    selectedDevice,\n    selectDevice,\n    setModel,\n    startScan,\n    stopScan,\n  }\n}\n"]}
+{"version":3,"file":"useBluetoothScan.js","sourceRoot":"","sources":["../../src/react/useBluetoothScan.ts"],"names":[],"mappings":"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","sourcesContent":["import {useEffect, useRef, useState} from \"react\"\n\nimport BluetoothSdk, {DeviceModels} from \"../index\"\nimport type {Device, DeviceModel, ScanDiagnostic} from \"../BluetoothSdk.types\"\n\nexport type BluetoothScanDedupe = \"id\" | \"name\" | ((device: Device) => string)\n\nexport type UseBluetoothScanOptions = {\n  dedupe?: BluetoothScanDedupe\n  model?: DeviceModel\n  onError?: (error: unknown) => void\n  timeoutMs?: number\n}\n\nexport type BluetoothScanHookResult = {\n  clearResults: () => void\n  devices: Device[]\n  diagnostic: ScanDiagnostic | null\n  error: unknown | null\n  model: DeviceModel\n  scanning: boolean\n  selectedDevice: Device | null\n  selectDevice: (device: Device | null) => void\n  setModel: (model: DeviceModel) => void\n  startScan: (model?: DeviceModel) => Promise<Device[]>\n  stopScan: () => Promise<void>\n}\n\nfunction dedupeKey(device: Device, dedupe: BluetoothScanDedupe): string {\n  if (typeof dedupe === \"function\") {\n    return dedupe(device)\n  }\n  if (dedupe === \"name\") {\n    return `${device.model}:${device.name}`\n  }\n  return device.id\n}\n\nfunction dedupeDevices(devices: Device[], dedupe: BluetoothScanDedupe): Device[] {\n  const seen = new Set<string>()\n  const nextDevices: Device[] = []\n\n  devices.forEach((device) => {\n    const key = dedupeKey(device, dedupe)\n    if (seen.has(key)) {\n      return\n    }\n    seen.add(key)\n    nextDevices.push(device)\n  })\n\n  return nextDevices\n}\n\nfunction hasDevice(devices: Device[], selectedDevice: Device | null, dedupe: BluetoothScanDedupe): boolean {\n  if (!selectedDevice) {\n    return true\n  }\n  const selectedKey = dedupeKey(selectedDevice, dedupe)\n  return devices.some((device) => dedupeKey(device, dedupe) === selectedKey)\n}\n\nexport function useBluetoothScan(options: UseBluetoothScanOptions = {}): BluetoothScanHookResult {\n  const [devices, setDevices] = useState<Device[]>([])\n  const [diagnostic, setDiagnostic] = useState<ScanDiagnostic | null>(null)\n  const [error, setError] = useState<unknown | null>(null)\n  const [model, setModelState] = useState<DeviceModel>(options.model ?? DeviceModels.MentraLive)\n  const [scanning, setScanning] = useState(false)\n  const [selectedDevice, selectDevice] = useState<Device | null>(null)\n  const activeScanRef = useRef(0)\n  const dedupeRef = useRef<BluetoothScanDedupe>(options.dedupe ?? \"id\")\n  const onErrorRef = useRef(options.onError)\n  const scanningRef = useRef(false)\n  const timeoutMsRef = useRef(options.timeoutMs)\n\n  useEffect(() => {\n    dedupeRef.current = options.dedupe ?? \"id\"\n    onErrorRef.current = options.onError\n    timeoutMsRef.current = options.timeoutMs\n  }, [options.dedupe, options.onError, options.timeoutMs])\n\n  useEffect(() => {\n    scanningRef.current = scanning\n  }, [scanning])\n\n  useEffect(() => {\n    if (!hasDevice(devices, selectedDevice, dedupeRef.current)) {\n      selectDevice(null)\n    }\n  }, [devices, selectedDevice])\n\n  useEffect(() => {\n    return () => {\n      if (!scanningRef.current) {\n        return\n      }\n      activeScanRef.current += 1\n      void BluetoothSdk.stopScan().catch(() => undefined)\n    }\n  }, [])\n\n  function clearResults() {\n    setDiagnostic(null)\n    setDevices([])\n    selectDevice(null)\n  }\n\n  function setModel(nextModel: DeviceModel) {\n    if (scanningRef.current) void stopScan()\n    setModelState(nextModel)\n    clearResults()\n  }\n\n  async function startScan(nextModel?: DeviceModel): Promise<Device[]> {\n    const scanId = activeScanRef.current + 1\n    activeScanRef.current = scanId\n    const scanModel = nextModel ?? model\n    if (nextModel && nextModel !== model) {\n      setModelState(nextModel)\n    }\n\n    setError(null)\n    setDiagnostic(null)\n    setScanning(true)\n    scanningRef.current = true\n    setDevices([])\n    selectDevice(null)\n\n    try {\n      const nextDevices = await BluetoothSdk.scan(scanModel, {\n        ...(timeoutMsRef.current == null ? {} : {timeoutMs: timeoutMsRef.current}),\n        onDiagnostic: (hint) => {\n          if (activeScanRef.current === scanId) setDiagnostic(hint)\n        },\n        onResults: (results) => {\n          if (activeScanRef.current !== scanId) {\n            return\n          }\n          if (results.length > 0) setDiagnostic(null)\n          setDevices(dedupeDevices(results, dedupeRef.current))\n        },\n      })\n      const finalDevices = dedupeDevices(nextDevices, dedupeRef.current)\n      if (activeScanRef.current === scanId) {\n        setDevices(finalDevices)\n        setError(null)\n      }\n      return finalDevices\n    } catch (nextError) {\n      if (activeScanRef.current === scanId) {\n        setError(nextError)\n        onErrorRef.current?.(nextError)\n      }\n      throw nextError\n    } finally {\n      if (activeScanRef.current === scanId) {\n        setScanning(false)\n        scanningRef.current = false\n      }\n    }\n  }\n\n  async function stopScan() {\n    setDiagnostic(null)\n    activeScanRef.current += 1\n    setScanning(false)\n    scanningRef.current = false\n    await BluetoothSdk.stopScan()\n  }\n\n  return {\n    clearResults,\n    devices,\n    diagnostic,\n    error,\n    model,\n    scanning,\n    selectedDevice,\n    selectDevice,\n    setModel,\n    startScan,\n    stopScan,\n  }\n}\n"]}

package/build/react/useMentraBluetooth.d.ts

@@ -1,5 +1,5 @@
 import type { ConnectOptions, Device, DeviceModel, GlassesConnectionStatus, HotspotStatus, MicMode, SettingsAckSuccessEvent, WifiSearchResult, WifiStatus } from "../BluetoothSdk.types";
-import { type DefaultDeviceStorage } from "./useGlassesConnection";
+import { type DefaultDeviceStorage, type GlassesConnectionHookResult } from "./useGlassesConnection";
 export type BatteryState = {
     charging: boolean;
     level: number | null;
@@ -65,6 +65,7 @@ export type ScanController = {
     active: boolean;
     clear: () => void;
     devices: Device[];
+    diagnostic: GlassesConnectionHookResult["scan"]["diagnostic"];
     error: unknown | null;
     model: DeviceModel;
     selectedDevice: Device | null;

package/build/react/useMentraBluetooth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMentraBluetooth.d.ts","sourceRoot":"","sources":["../../src/react/useMentraBluetooth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useMentraBluetooth.d.ts","sourceRoot":"","sources":["../../src/react/useMentraBluetooth.ts"],"names":[],"mappings":"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"}

package/build/react/useMentraBluetooth.js

@@ -99,6 +99,7 @@ function scanController(connection) {
         active: connection.scan.scanning,
         clear: connection.scan.clearResults,
         devices: connection.scan.devices,
+        diagnostic: connection.scan.diagnostic,
         error: connection.scan.error,
         model: connection.scan.model,
         selectedDevice: connection.scan.selectedDevice,

package/build/react/useMentraBluetooth.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMentraBluetooth.js","sourceRoot":"","sources":["../../src/react/useMentraBluetooth.ts"],"names":[],"mappings":"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","sourcesContent":["import {useState} from \"react\"\n\nimport BluetoothSdk from \"../index\"\nimport {\n  DEFAULT_VOICE_ACTIVITY_DETECTION_ENABLED,\n  DeviceModels,\n  createDisconnectedGlassesStatus,\n  isConnectedGlassesConnectionStatus,\n  isReadyGlassesConnectionStatus,\n} from \"../BluetoothSdk.types\"\nimport type {\n  ConnectOptions,\n  Device,\n  DeviceModel,\n  GlassesConnectionStatus,\n  HotspotStatus,\n  PublicBluetoothStatus,\n  PublicGlassesStatus,\n  MicMode,\n  SettingsAckSuccessEvent,\n  WifiSearchResult,\n  WifiStatus,\n} from \"../BluetoothSdk.types\"\n\nimport {\n  useGlassesConnection,\n  type DefaultDeviceStorage,\n  type GlassesConnectionHookResult,\n} from \"./useGlassesConnection\"\n\nexport type BatteryState = {\n  charging: boolean\n  level: number | null\n}\n\nexport type ConnectedGlassesInfo = {\n  appVersion?: string\n  bluetoothName?: string\n  buildNumber?: string\n  color?: string\n  deviceModel?: string\n  firmwareVersion?: string\n  serialNumber?: string\n  style?: string\n}\n\nexport type FirmwareInfo = {\n  appVersion?: string\n  buildNumber?: string\n  source:\n    | \"app\"\n    | \"bes\"\n    | \"device\"\n    | \"firmware\"\n    | \"left\"\n    | \"mtk\"\n    | \"right\"\n    | \"unknown\"\n  version: string | null\n}\n\nexport type SignalState = {\n  strengthDbm: number | null\n  updatedAt: number | null\n}\n\nexport type GlassesRuntimeState =\n  | {\n      connected: false\n      connection: Exclude<GlassesConnectionStatus, {state: \"connected\"}>\n      ready: false\n    }\n  | {\n      battery: BatteryState\n      connected: true\n      connection: Extract<GlassesConnectionStatus, {state: \"connected\"}>\n      device: ConnectedGlassesInfo\n      firmware: FirmwareInfo\n      hotspot: HotspotStatus\n      ready: boolean\n      signal: SignalState\n      voiceActivityDetectionEnabled: boolean\n      wifi: WifiStatus\n    }\n\nexport type GalleryModeState = {\n  applying: boolean\n  enabled: boolean\n  error: unknown | null\n}\n\nexport type PhoneSdkRuntimeState = {\n  currentMic: MicMode | null\n  defaultDevice: Device | null\n  galleryMode: GalleryModeState\n  lastLog: string[]\n  micRanking: MicMode[]\n  otherBluetoothConnected: boolean\n  searching: boolean\n  searchingController: boolean\n  systemMicUnavailable: boolean\n  wifiScanResults: WifiSearchResult[]\n}\n\nexport type ScanController = {\n  active: boolean\n  clear: () => void\n  devices: Device[]\n  error: unknown | null\n  model: DeviceModel\n  selectedDevice: Device | null\n  selectDevice: (device: Device | null) => void\n  setModel: (model: DeviceModel) => void\n  start: (model?: DeviceModel) => Promise<Device[]>\n  stop: () => Promise<void>\n}\n\nexport type UseMentraBluetoothOptions = {\n  autoConnectDefault?: boolean\n  defaultDeviceStorage?: DefaultDeviceStorage\n  defaultModel?: DeviceModel\n  onError?: (error: unknown) => void\n  scanTimeoutMs?: number\n}\n\nexport type MentraBluetoothSession = {\n  busy: boolean\n  clearDefaultDevice: () => Promise<void>\n  connect: (device?: Device, options?: ConnectOptions) => Promise<void>\n  connectDefault: (options?: ConnectOptions) => Promise<void>\n  defaultDevice: Device | null\n  disconnect: () => Promise<void>\n  error: unknown | null\n  glasses: GlassesRuntimeState\n  refresh: () => Promise<void>\n  scan: ScanController\n  sdk: PhoneSdkRuntimeState\n  setDefaultDevice: (device: Device | null) => Promise<void>\n  setGalleryModeEnabled: (enabled: boolean) => Promise<SettingsAckSuccessEvent>\n  setVoiceActivityDetectionEnabled: (enabled: boolean) => Promise<void>\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.length > 0 ? value : undefined\n}\n\nfunction numberValue(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : null\n}\n\nfunction firmwareInfo(status: Partial<PublicGlassesStatus>): FirmwareInfo {\n  const firmwareSources = [\n    [\"firmwareVersion\", \"firmware\"],\n    [\"deviceFirmwareVersion\", \"device\"],\n    [\"rightFirmwareVersion\", \"right\"],\n    [\"leftFirmwareVersion\", \"left\"],\n    [\"besFirmwareVersion\", \"bes\"],\n    [\"mtkFirmwareVersion\", \"mtk\"],\n    [\"appVersion\", \"app\"],\n  ] as const\n\n  for (const [key, source] of firmwareSources) {\n    const value = stringValue((status as Record<string, unknown>)[key])\n    if (value) {\n      return {\n        appVersion: stringValue(status.appVersion),\n        buildNumber: stringValue(status.buildNumber),\n        source,\n        version: value,\n      }\n    }\n  }\n\n  return {\n    appVersion: stringValue(status.appVersion),\n    buildNumber: stringValue(status.buildNumber),\n    source: \"unknown\",\n    version: null,\n  }\n}\n\nfunction batteryState(status: Partial<PublicGlassesStatus>): BatteryState {\n  const level = typeof status.batteryLevel === \"number\" && status.batteryLevel >= 0 ? status.batteryLevel : null\n  return {\n    charging: status.charging ?? false,\n    level,\n  }\n}\n\nfunction connectedGlassesInfo(status: Partial<PublicGlassesStatus>): ConnectedGlassesInfo {\n  return {\n    appVersion: stringValue(status.appVersion),\n    bluetoothName: stringValue(status.bluetoothName),\n    buildNumber: stringValue(status.buildNumber),\n    color: stringValue(status.color),\n    deviceModel: stringValue(status.deviceModel),\n    firmwareVersion: stringValue(status.firmwareVersion),\n    serialNumber: stringValue(status.serialNumber),\n    style: stringValue(status.style),\n  }\n}\n\nfunction runtimeGlassesState(status: Partial<PublicGlassesStatus>): GlassesRuntimeState {\n  const connection = status.connection ?? createDisconnectedGlassesStatus().connection ?? {state: \"disconnected\"}\n\n  if (!isConnectedGlassesConnectionStatus(connection)) {\n    return {\n      connected: false,\n      connection,\n      ready: false,\n    }\n  }\n\n  return {\n    battery: batteryState(status),\n    connected: true,\n    connection,\n    device: connectedGlassesInfo(status),\n    firmware: firmwareInfo(status),\n    hotspot: status.hotspot ?? {state: \"disabled\"},\n    ready: isReadyGlassesConnectionStatus(connection),\n    signal: {\n      strengthDbm: numberValue((status as Record<string, unknown>).signalStrength),\n      updatedAt: numberValue((status as Record<string, unknown>).signalStrengthUpdatedAt),\n    },\n    voiceActivityDetectionEnabled: status.voiceActivityDetectionEnabled ?? DEFAULT_VOICE_ACTIVITY_DETECTION_ENABLED,\n    wifi: status.wifi ?? {state: \"disconnected\"},\n  }\n}\n\nfunction phoneSdkState(\n  status: Partial<PublicBluetoothStatus>,\n  defaultDevice: Device | null,\n  galleryMode: GalleryModeState,\n): PhoneSdkRuntimeState {\n  return {\n    currentMic: status.currentMic || null,\n    defaultDevice,\n    galleryMode,\n    lastLog: status.lastLog ?? [],\n    micRanking: status.micRanking ?? [],\n    otherBluetoothConnected: status.otherBtConnected ?? false,\n    searching: status.searching ?? false,\n    searchingController: status.searchingController ?? false,\n    systemMicUnavailable: status.systemMicUnavailable ?? false,\n    wifiScanResults: status.wifiScanResults ?? [],\n  }\n}\n\nfunction scanController(connection: GlassesConnectionHookResult): ScanController {\n  return {\n    active: connection.scan.scanning,\n    clear: connection.scan.clearResults,\n    devices: connection.scan.devices,\n    error: connection.scan.error,\n    model: connection.scan.model,\n    selectedDevice: connection.scan.selectedDevice,\n    selectDevice: connection.scan.selectDevice,\n    setModel: connection.scan.setModel,\n    start: connection.scan.startScan,\n    stop: connection.scan.stopScan,\n  }\n}\n\nexport function useMentraBluetooth(options: UseMentraBluetoothOptions = {}): MentraBluetoothSession {\n  const connection = useGlassesConnection({\n    autoConnectDefault: options.autoConnectDefault,\n    defaultDeviceStorage: options.defaultDeviceStorage,\n    onError: options.onError,\n    scanModel: options.defaultModel ?? DeviceModels.MentraLive,\n    scanTimeoutMs: options.scanTimeoutMs,\n  })\n  const [galleryModeApplying, setGalleryModeApplying] = useState(false)\n  const [galleryModeError, setGalleryModeError] = useState<unknown | null>(null)\n\n  async function setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent> {\n    setGalleryModeApplying(true)\n    setGalleryModeError(null)\n    try {\n      return await BluetoothSdk.setGalleryModeEnabled(enabled)\n    } catch (error) {\n      setGalleryModeError(error)\n      options.onError?.(error)\n      throw error\n    } finally {\n      setGalleryModeApplying(false)\n    }\n  }\n\n  async function setVoiceActivityDetectionEnabled(enabled: boolean) {\n    try {\n      await BluetoothSdk.setVoiceActivityDetectionEnabled(enabled)\n    } catch (error) {\n      options.onError?.(error)\n      throw error\n    }\n  }\n\n  const galleryMode: GalleryModeState = {\n    applying: galleryModeApplying,\n    enabled: connection.bluetoothStatus.galleryModeEnabled !== false,\n    error: galleryModeError,\n  }\n\n  return {\n    busy: connection.busy || galleryModeApplying,\n    clearDefaultDevice: connection.clearDefaultDevice,\n    connect: connection.connect,\n    connectDefault: connection.connectDefault,\n    defaultDevice: connection.defaultDevice,\n    disconnect: connection.disconnect,\n    error: galleryModeError ?? connection.error,\n    glasses: runtimeGlassesState(connection.glassesStatus),\n    refresh: connection.refresh,\n    scan: scanController(connection),\n    sdk: phoneSdkState(connection.bluetoothStatus, connection.defaultDevice, galleryMode),\n    setDefaultDevice: connection.setDefaultDevice,\n    setGalleryModeEnabled,\n    setVoiceActivityDetectionEnabled,\n  }\n}\n"]}
+{"version":3,"file":"useMentraBluetooth.js","sourceRoot":"","sources":["../../src/react/useMentraBluetooth.ts"],"names":[],"mappings":"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","sourcesContent":["import {useState} from \"react\"\n\nimport BluetoothSdk from \"../index\"\nimport {\n  DEFAULT_VOICE_ACTIVITY_DETECTION_ENABLED,\n  DeviceModels,\n  createDisconnectedGlassesStatus,\n  isConnectedGlassesConnectionStatus,\n  isReadyGlassesConnectionStatus,\n} from \"../BluetoothSdk.types\"\nimport type {\n  ConnectOptions,\n  Device,\n  DeviceModel,\n  GlassesConnectionStatus,\n  HotspotStatus,\n  PublicBluetoothStatus,\n  PublicGlassesStatus,\n  MicMode,\n  SettingsAckSuccessEvent,\n  WifiSearchResult,\n  WifiStatus,\n} from \"../BluetoothSdk.types\"\n\nimport {\n  useGlassesConnection,\n  type DefaultDeviceStorage,\n  type GlassesConnectionHookResult,\n} from \"./useGlassesConnection\"\n\nexport type BatteryState = {\n  charging: boolean\n  level: number | null\n}\n\nexport type ConnectedGlassesInfo = {\n  appVersion?: string\n  bluetoothName?: string\n  buildNumber?: string\n  color?: string\n  deviceModel?: string\n  firmwareVersion?: string\n  serialNumber?: string\n  style?: string\n}\n\nexport type FirmwareInfo = {\n  appVersion?: string\n  buildNumber?: string\n  source:\n    | \"app\"\n    | \"bes\"\n    | \"device\"\n    | \"firmware\"\n    | \"left\"\n    | \"mtk\"\n    | \"right\"\n    | \"unknown\"\n  version: string | null\n}\n\nexport type SignalState = {\n  strengthDbm: number | null\n  updatedAt: number | null\n}\n\nexport type GlassesRuntimeState =\n  | {\n      connected: false\n      connection: Exclude<GlassesConnectionStatus, {state: \"connected\"}>\n      ready: false\n    }\n  | {\n      battery: BatteryState\n      connected: true\n      connection: Extract<GlassesConnectionStatus, {state: \"connected\"}>\n      device: ConnectedGlassesInfo\n      firmware: FirmwareInfo\n      hotspot: HotspotStatus\n      ready: boolean\n      signal: SignalState\n      voiceActivityDetectionEnabled: boolean\n      wifi: WifiStatus\n    }\n\nexport type GalleryModeState = {\n  applying: boolean\n  enabled: boolean\n  error: unknown | null\n}\n\nexport type PhoneSdkRuntimeState = {\n  currentMic: MicMode | null\n  defaultDevice: Device | null\n  galleryMode: GalleryModeState\n  lastLog: string[]\n  micRanking: MicMode[]\n  otherBluetoothConnected: boolean\n  searching: boolean\n  searchingController: boolean\n  systemMicUnavailable: boolean\n  wifiScanResults: WifiSearchResult[]\n}\n\nexport type ScanController = {\n  active: boolean\n  clear: () => void\n  devices: Device[]\n  diagnostic: GlassesConnectionHookResult[\"scan\"][\"diagnostic\"]\n  error: unknown | null\n  model: DeviceModel\n  selectedDevice: Device | null\n  selectDevice: (device: Device | null) => void\n  setModel: (model: DeviceModel) => void\n  start: (model?: DeviceModel) => Promise<Device[]>\n  stop: () => Promise<void>\n}\n\nexport type UseMentraBluetoothOptions = {\n  autoConnectDefault?: boolean\n  defaultDeviceStorage?: DefaultDeviceStorage\n  defaultModel?: DeviceModel\n  onError?: (error: unknown) => void\n  scanTimeoutMs?: number\n}\n\nexport type MentraBluetoothSession = {\n  busy: boolean\n  clearDefaultDevice: () => Promise<void>\n  connect: (device?: Device, options?: ConnectOptions) => Promise<void>\n  connectDefault: (options?: ConnectOptions) => Promise<void>\n  defaultDevice: Device | null\n  disconnect: () => Promise<void>\n  error: unknown | null\n  glasses: GlassesRuntimeState\n  refresh: () => Promise<void>\n  scan: ScanController\n  sdk: PhoneSdkRuntimeState\n  setDefaultDevice: (device: Device | null) => Promise<void>\n  setGalleryModeEnabled: (enabled: boolean) => Promise<SettingsAckSuccessEvent>\n  setVoiceActivityDetectionEnabled: (enabled: boolean) => Promise<void>\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.length > 0 ? value : undefined\n}\n\nfunction numberValue(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : null\n}\n\nfunction firmwareInfo(status: Partial<PublicGlassesStatus>): FirmwareInfo {\n  const firmwareSources = [\n    [\"firmwareVersion\", \"firmware\"],\n    [\"deviceFirmwareVersion\", \"device\"],\n    [\"rightFirmwareVersion\", \"right\"],\n    [\"leftFirmwareVersion\", \"left\"],\n    [\"besFirmwareVersion\", \"bes\"],\n    [\"mtkFirmwareVersion\", \"mtk\"],\n    [\"appVersion\", \"app\"],\n  ] as const\n\n  for (const [key, source] of firmwareSources) {\n    const value = stringValue((status as Record<string, unknown>)[key])\n    if (value) {\n      return {\n        appVersion: stringValue(status.appVersion),\n        buildNumber: stringValue(status.buildNumber),\n        source,\n        version: value,\n      }\n    }\n  }\n\n  return {\n    appVersion: stringValue(status.appVersion),\n    buildNumber: stringValue(status.buildNumber),\n    source: \"unknown\",\n    version: null,\n  }\n}\n\nfunction batteryState(status: Partial<PublicGlassesStatus>): BatteryState {\n  const level = typeof status.batteryLevel === \"number\" && status.batteryLevel >= 0 ? status.batteryLevel : null\n  return {\n    charging: status.charging ?? false,\n    level,\n  }\n}\n\nfunction connectedGlassesInfo(status: Partial<PublicGlassesStatus>): ConnectedGlassesInfo {\n  return {\n    appVersion: stringValue(status.appVersion),\n    bluetoothName: stringValue(status.bluetoothName),\n    buildNumber: stringValue(status.buildNumber),\n    color: stringValue(status.color),\n    deviceModel: stringValue(status.deviceModel),\n    firmwareVersion: stringValue(status.firmwareVersion),\n    serialNumber: stringValue(status.serialNumber),\n    style: stringValue(status.style),\n  }\n}\n\nfunction runtimeGlassesState(status: Partial<PublicGlassesStatus>): GlassesRuntimeState {\n  const connection = status.connection ?? createDisconnectedGlassesStatus().connection ?? {state: \"disconnected\"}\n\n  if (!isConnectedGlassesConnectionStatus(connection)) {\n    return {\n      connected: false,\n      connection,\n      ready: false,\n    }\n  }\n\n  return {\n    battery: batteryState(status),\n    connected: true,\n    connection,\n    device: connectedGlassesInfo(status),\n    firmware: firmwareInfo(status),\n    hotspot: status.hotspot ?? {state: \"disabled\"},\n    ready: isReadyGlassesConnectionStatus(connection),\n    signal: {\n      strengthDbm: numberValue((status as Record<string, unknown>).signalStrength),\n      updatedAt: numberValue((status as Record<string, unknown>).signalStrengthUpdatedAt),\n    },\n    voiceActivityDetectionEnabled: status.voiceActivityDetectionEnabled ?? DEFAULT_VOICE_ACTIVITY_DETECTION_ENABLED,\n    wifi: status.wifi ?? {state: \"disconnected\"},\n  }\n}\n\nfunction phoneSdkState(\n  status: Partial<PublicBluetoothStatus>,\n  defaultDevice: Device | null,\n  galleryMode: GalleryModeState,\n): PhoneSdkRuntimeState {\n  return {\n    currentMic: status.currentMic || null,\n    defaultDevice,\n    galleryMode,\n    lastLog: status.lastLog ?? [],\n    micRanking: status.micRanking ?? [],\n    otherBluetoothConnected: status.otherBtConnected ?? false,\n    searching: status.searching ?? false,\n    searchingController: status.searchingController ?? false,\n    systemMicUnavailable: status.systemMicUnavailable ?? false,\n    wifiScanResults: status.wifiScanResults ?? [],\n  }\n}\n\nfunction scanController(connection: GlassesConnectionHookResult): ScanController {\n  return {\n    active: connection.scan.scanning,\n    clear: connection.scan.clearResults,\n    devices: connection.scan.devices,\n    diagnostic: connection.scan.diagnostic,\n    error: connection.scan.error,\n    model: connection.scan.model,\n    selectedDevice: connection.scan.selectedDevice,\n    selectDevice: connection.scan.selectDevice,\n    setModel: connection.scan.setModel,\n    start: connection.scan.startScan,\n    stop: connection.scan.stopScan,\n  }\n}\n\nexport function useMentraBluetooth(options: UseMentraBluetoothOptions = {}): MentraBluetoothSession {\n  const connection = useGlassesConnection({\n    autoConnectDefault: options.autoConnectDefault,\n    defaultDeviceStorage: options.defaultDeviceStorage,\n    onError: options.onError,\n    scanModel: options.defaultModel ?? DeviceModels.MentraLive,\n    scanTimeoutMs: options.scanTimeoutMs,\n  })\n  const [galleryModeApplying, setGalleryModeApplying] = useState(false)\n  const [galleryModeError, setGalleryModeError] = useState<unknown | null>(null)\n\n  async function setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent> {\n    setGalleryModeApplying(true)\n    setGalleryModeError(null)\n    try {\n      return await BluetoothSdk.setGalleryModeEnabled(enabled)\n    } catch (error) {\n      setGalleryModeError(error)\n      options.onError?.(error)\n      throw error\n    } finally {\n      setGalleryModeApplying(false)\n    }\n  }\n\n  async function setVoiceActivityDetectionEnabled(enabled: boolean) {\n    try {\n      await BluetoothSdk.setVoiceActivityDetectionEnabled(enabled)\n    } catch (error) {\n      options.onError?.(error)\n      throw error\n    }\n  }\n\n  const galleryMode: GalleryModeState = {\n    applying: galleryModeApplying,\n    enabled: connection.bluetoothStatus.galleryModeEnabled !== false,\n    error: galleryModeError,\n  }\n\n  return {\n    busy: connection.busy || galleryModeApplying,\n    clearDefaultDevice: connection.clearDefaultDevice,\n    connect: connection.connect,\n    connectDefault: connection.connectDefault,\n    defaultDevice: connection.defaultDevice,\n    disconnect: connection.disconnect,\n    error: galleryModeError ?? connection.error,\n    glasses: runtimeGlassesState(connection.glassesStatus),\n    refresh: connection.refresh,\n    scan: scanController(connection),\n    sdk: phoneSdkState(connection.bluetoothStatus, connection.defaultDevice, galleryMode),\n    setDefaultDevice: connection.setDefaultDevice,\n    setGalleryModeEnabled,\n    setVoiceActivityDetectionEnabled,\n  }\n}\n"]}

package/ios/BluetoothSdkModule.swift

@@ -55,6 +55,8 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
             "save_setting",
             "local_transcription",
             "phone_notification",
+            "native_notification_status",
+            "native_notification_delivery",
             "phone_notification_dismissed",
             "ws_text",
             "ws_bin",
@@ -220,6 +222,13 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
             }
         }
 
+        AsyncFunction("getScanDiagnostic") { (model: String) -> [String: String]? in
+            await MainActor.run {
+                guard let diagnostic = self.bluetoothSdk().scanDiagnostic(for: DeviceModel.fromDeviceType(model)) else { return nil }
+                return ["code": diagnostic.code, "message": diagnostic.message]
+            }
+        }
+
         AsyncFunction("stopScan") {
             await MainActor.run {
                 self.bluetoothSdk().stopScan()
@@ -290,6 +299,27 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
             }
         }
 
+        AsyncFunction("configureNativeNotifications") { (values: [String: Any]) in
+            try await MainActor.run {
+                try self.bluetoothSdk().configureNativeNotifications(NativeNotificationConfig(
+                    enabled: values["enabled"] as? Bool ?? false,
+                    autoDisplay: values["autoDisplay"] as? Bool ?? true,
+                    durationSeconds: (values["durationSeconds"] as? NSNumber)?.intValue ?? 5,
+                    doNotDisturb: values["doNotDisturb"] as? Bool ?? false,
+                    blockedApps: values["blockedApps"] as? [String] ?? []
+                ))
+            }
+        }
+        AsyncFunction("getNativeNotificationStatus") {
+            await MainActor.run { self.bluetoothSdk().getNativeNotificationStatus().dictionary }
+        }
+
+        // MARK: - Native Notification Centre
+
+        AsyncFunction("sendPhoneNotification") { (_: [String: Any]) in
+            throw NativeNotificationError.unsupported
+        }
+
         // MARK: - WiFi Commands
 
         AsyncFunction("requestWifiScan") {

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.0-dev.180"
+    private static let swiftPackageSdkVersion = "3.2.0-dev.187"
     private static let swiftPackageSdkVersionPlaceholder = "__MENTRA" + "_BLUETOOTH_SDK_VERSION__"
 
     private static func normalizedSdkVersion(_ value: String?) -> String? {

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.180"
-    static let releaseSetId = "mentra-3.2.0-dev.180"
-    static let sourceCommit = "1f24e462561fef37b7082204847a541db4a87c41"
-    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.180.json"
-    static let otaManifestSha256 = "cbf2a1b81430bd34942e2a1764138f6d79197767b4434a2d8c44311768f8b873"
+    static let releaseIdentity = "3.2.0-dev.187"
+    static let releaseSetId = "mentra-3.2.0-dev.187"
+    static let sourceCommit = "d8b34892f11593baa3c075b94380253b06eb874d"
+    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.187.json"
+    static let otaManifestSha256 = "cf21f4ab6347acb12eefa38d2f0a3b433bc0e05428c527bcda57a8693d7a72f9"
 }

package/ios/Source/MentraBluetoothSDK.swift

@@ -24,6 +24,7 @@ private final class ActiveScanSession {
     let model: DeviceModel
     let onResults: ([Device]) -> Void
     let onComplete: ([Device]) -> Void
+    let onDiagnostic: ((ScanDiagnostic) -> Void)?
     var latestResults: [Device] = []
     var timeoutTask: Task<Void, Never>?
     weak var publicSession: ScanSession?
@@ -31,11 +32,13 @@ private final class ActiveScanSession {
     init(
         model: DeviceModel,
         onResults: @escaping ([Device]) -> Void,
-        onComplete: @escaping ([Device]) -> Void
+        onComplete: @escaping ([Device]) -> Void,
+        onDiagnostic: ((ScanDiagnostic) -> Void)?
     ) {
         self.model = model
         self.onResults = onResults
         self.onComplete = onComplete
+        self.onDiagnostic = onDiagnostic
     }
 }
 
@@ -354,13 +357,27 @@ public final class MentraBluetoothSDK {
         timeout: TimeInterval = 15,
         onResults: @escaping ([Device]) -> Void,
         onComplete: @escaping ([Device]) -> Void = { _ in }
+    ) throws -> ScanSession {
+        try scan(model: model, timeout: timeout, onResults: onResults, onDiagnostic: nil, onComplete: onComplete)
+    }
+
+    /// Optional advisory before an empty completed scan. Existing scan overloads
+    /// retain their signatures and behavior; cancellation does not produce hints.
+    @discardableResult
+    public func scan(
+        model: DeviceModel,
+        timeout: TimeInterval = 15,
+        onResults: @escaping ([Device]) -> Void,
+        onDiagnostic: ((ScanDiagnostic) -> Void)?,
+        onComplete: @escaping ([Device]) -> Void = { _ in }
     ) throws -> ScanSession {
         let normalizedTimeout = timeout > 0 && timeout.isFinite ? timeout : 15
         let id = UUID()
         let activeSession = ActiveScanSession(
             model: model,
             onResults: onResults,
-            onComplete: onComplete
+            onComplete: onComplete,
+            onDiagnostic: onDiagnostic
         )
         let publicSession = ScanSession { [weak self] in
             self?.finishScanSession(id, reason: .cancelled, shouldStopScan: true)
@@ -481,6 +498,16 @@ public final class MentraBluetoothSDK {
         DeviceManager.shared.showDashboard()
     }
 
+    public func configureNativeNotifications(_ config: NativeNotificationConfig) throws {
+        try config.validate()
+        guard let driver = DeviceManager.shared.sgc else { throw NativeNotificationError.notConnected }
+        try driver.configureNativeNotifications(config)
+    }
+
+    public func getNativeNotificationStatus() -> NativeNotificationStatus {
+        DeviceManager.shared.sgc?.getNativeNotificationStatus() ?? .unavailable
+    }
+
     public func showNotificationsPanel() {
         DeviceManager.shared.showNotificationsPanel()
     }
@@ -2107,6 +2134,25 @@ private func dispatchDiscoveredDevices(_ rawSearchResults: Any?) {
         activeSession.onResults(devices)
     }
 
+    /// Used by both the native scan callback and the React Native scan wrapper.
+    func scanDiagnostic(for model: DeviceModel) -> ScanDiagnostic? {
+        let status = glassesStatus
+        guard model != .simulated, !status.connected,
+              status.connectionState != .connected, status.connectionState != .connecting,
+              status.connectionState != .bonding else { return nil }
+        let services = ConnectedDeviceMatcher.serviceUUIDs(for: model).map { CBUUID(string: $0) }
+        let saved = currentDefaultDevice()
+        guard let device = BluetoothAvailability.shared.connectedPeripherals(withServices: services).first(where: {
+            ConnectedDeviceMatcher.matches(model: model, defaultDevice: saved, name: $0.name, identifier: $0.identifier.uuidString)
+        }) else { return nil }
+        let name = device.name.flatMap { $0.isEmpty ? nil : $0 } ?? device.identifier.uuidString
+        return ScanDiagnostic(
+            code: "device_connected_on_phone",
+            message: "Scan found no glasses, but a matching device \"\(name)\" is already connected to this phone. " +
+                "If another app is using it, disconnect it there and scan again."
+        )
+    }
+
     private func finishScanSession(_ id: UUID, reason: ScanStopReason, shouldStopScan: Bool) {
         guard let activeSession = activeScanSessions.removeValue(forKey: id) else { return }
         activeSession.timeoutTask?.cancel()
@@ -2114,6 +2160,11 @@ private func dispatchDiscoveredDevices(_ rawSearchResults: Any?) {
         if shouldStopScan {
             stopScan(reason: reason)
         }
+        if reason == .completed, activeSession.latestResults.isEmpty,
+           let onDiagnostic = activeSession.onDiagnostic, let diagnostic = scanDiagnostic(for: activeSession.model)
+        {
+            onDiagnostic(diagnostic)
+        }
         activeSession.onComplete(activeSession.latestResults)
     }
 

package/ios/Source/NativeNotifications.swift

@@ -0,0 +1,52 @@
+import Foundation
+
+/// Desired notification-centre controls. Submission does not imply firmware acknowledgement.
+public struct NativeNotificationConfig: Equatable, Sendable {
+    public var enabled: Bool
+    public var autoDisplay: Bool
+    public var durationSeconds: Int
+    public var doNotDisturb: Bool
+    public var blockedApps: [String]
+
+    public init(enabled: Bool = false, autoDisplay: Bool = true, durationSeconds: Int = 5, doNotDisturb: Bool = false, blockedApps: [String] = []) {
+        self.enabled = enabled
+        self.autoDisplay = autoDisplay
+        self.durationSeconds = durationSeconds
+        self.doNotDisturb = doNotDisturb
+        self.blockedApps = blockedApps
+    }
+
+    func validate() throws {
+        guard (1 ... 30).contains(durationSeconds) else { throw NativeNotificationError.invalidDuration }
+    }
+
+    func validateForAncs() throws {
+        try validate()
+        guard blockedApps.isEmpty else { throw NativeNotificationError.unsupported }
+    }
+
+    var dictionary: [String: Any] {
+        ["enabled": enabled, "autoDisplay": autoDisplay, "durationSeconds": durationSeconds, "doNotDisturb": doNotDisturb, "blockedApps": blockedApps]
+    }
+}
+
+public enum NativeNotificationError: Error {
+    case unsupported
+    case notConnected
+    case invalidDuration
+}
+
+public struct NativeNotificationStatus: Sendable {
+    public let supported: Bool
+    public let source: String
+    public let authorization: String
+    public let state: String
+    public let config: NativeNotificationConfig
+    public let error: String
+
+    static let unavailable = NativeNotificationStatus(supported: false, source: "unsupported", authorization: "unknown", state: "unavailable", config: .init(), error: "")
+
+    var dictionary: [String: Any] {
+        ["supported": supported, "source": source, "authorization": authorization, "state": state, "config": config.dictionary, "error": error]
+    }
+}

package/ios/Source/connection/ScanSession.swift

@@ -6,6 +6,17 @@ public enum ScanStopReason {
     case error
 }
 
+/// A non-fatal explanation for an empty scan; it does not establish app ownership.
+public struct ScanDiagnostic: Equatable {
+    public let code: String
+    public let message: String
+
+    public init(code: String, message: String) {
+        self.code = code
+        self.message = message
+    }
+}
+
 @MainActor
 public final class ScanSession {
     private let stopAction: () -> Void

package/ios/Source/internal/BluetoothAvailability.swift

@@ -41,6 +41,13 @@ final class BluetoothAvailability: NSObject, CBCentralManagerDelegate {
         listeners[id] = nil
     }
 
+    /// Read-only system lookup. It neither connects nor claims ownership.
+    func connectedPeripherals(withServices services: [CBUUID]) -> [CBPeripheral] {
+        dispatchPrecondition(condition: .onQueue(.main))
+        guard let centralManager, centralManager.state == .poweredOn, !services.isEmpty else { return [] }
+        return centralManager.retrieveConnectedPeripherals(withServices: services)
+    }
+
     func requirePoweredOn(operation: String) throws {
         if let current = centralManager?.state {
             state = current

package/ios/Source/internal/ConnectedDeviceMatcher.swift

@@ -0,0 +1,45 @@
+import Foundation
+
+/// Model-level identity heuristic for system-connected peripherals, not app ownership.
+enum ConnectedDeviceMatcher {
+    static func matches(model: DeviceModel, defaultDevice: Device?, name: String?, identifier: String?) -> Bool {
+        guard model != .simulated else { return false }
+        if let saved = defaultDevice, saved.model == model {
+            let savedID = saved.identifier.flatMap { $0.isEmpty ? nil : $0 }
+            let candidateID = identifier.flatMap { $0.isEmpty ? nil : $0 }
+            if let savedID, let candidateID {
+                if savedID.caseInsensitiveCompare(candidateID) == .orderedSame { return true }
+            } else if let name, !name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty, name == saved.name {
+                return true
+            }
+        }
+        guard let name else { return false }
+        switch model {
+        case .mentraLive:
+            return name == "Xy_A" || name.hasPrefix("XyBLE_") || name.lowercased().hasPrefix("mentra_live")
+        case .mentraNex:
+            return name.hasPrefix("Nex1-") || name.hasPrefix("MENTRA_DISPLAY_")
+        default:
+            return false
+        }
+    }
+
+    /// Service IDs used by the corresponding SGCs. CoreBluetooth cannot enumerate
+    /// every system connection without service filters; unsupported models stay silent.
+    static func serviceUUIDs(for model: DeviceModel) -> [String] {
+        switch model {
+        case .mentraLive, .mentraNex:
+            return ["00004860-0000-1000-8000-00805F9B34FB"]
+        case .g1:
+            return ["6E400001-B5A3-F393-E0A9-E50E24DCCA9E"]
+        case .g2:
+            return ["00002760-08C2-11E1-9073-0E8AC72E0000"]
+        case .nimo:
+            return ["00007033-0000-1000-8000-00805F9B34FB"]
+        case .ar99:
+            return ["A72EC9A8-CF72-8544-AD96-D1481A02CE98"]
+        default:
+            return []
+        }
+    }
+}