@mentra/bluetooth-sdk 0.1.3 → 0.1.5

package/build/react/useMentraBluetooth.js

@@ -0,0 +1,156 @@
+import { useState } from "react";
+import BluetoothSdk from "../index";
+import { DeviceModels, createDisconnectedGlassesStatus, isConnectedGlassesConnectionStatus, isReadyGlassesConnectionStatus, } from "../BluetoothSdk.types";
+import { useGlassesConnection, } from "./useGlassesConnection";
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function firmwareInfo(status) {
+    const firmwareSources = [
+        ["firmwareVersion", "firmware"],
+        ["deviceFirmwareVersion", "device"],
+        ["rightFirmwareVersion", "right"],
+        ["leftFirmwareVersion", "left"],
+        ["besFirmwareVersion", "bes"],
+        ["mtkFirmwareVersion", "mtk"],
+        ["appVersion", "app"],
+    ];
+    for (const [key, source] of firmwareSources) {
+        const value = stringValue(status[key]);
+        if (value) {
+            return {
+                appVersion: stringValue(status.appVersion),
+                buildNumber: stringValue(status.buildNumber),
+                source,
+                version: value,
+            };
+        }
+    }
+    return {
+        appVersion: stringValue(status.appVersion),
+        buildNumber: stringValue(status.buildNumber),
+        source: "unknown",
+        version: null,
+    };
+}
+function batteryState(status) {
+    const level = typeof status.batteryLevel === "number" && status.batteryLevel >= 0 ? status.batteryLevel : null;
+    return {
+        charging: status.charging ?? false,
+        level,
+    };
+}
+function connectedGlassesInfo(status) {
+    return {
+        appVersion: stringValue(status.appVersion),
+        bluetoothName: stringValue(status.bluetoothName),
+        buildNumber: stringValue(status.buildNumber),
+        color: stringValue(status.color),
+        deviceModel: stringValue(status.deviceModel),
+        firmwareVersion: stringValue(status.firmwareVersion),
+        serialNumber: stringValue(status.serialNumber),
+        style: stringValue(status.style),
+    };
+}
+function runtimeGlassesState(status) {
+    const connection = status.connection ?? createDisconnectedGlassesStatus().connection ?? { state: "disconnected" };
+    if (!isConnectedGlassesConnectionStatus(connection)) {
+        return {
+            connected: false,
+            connection,
+            ready: false,
+        };
+    }
+    return {
+        battery: batteryState(status),
+        connected: true,
+        connection,
+        device: connectedGlassesInfo(status),
+        firmware: firmwareInfo(status),
+        hotspot: status.hotspot ?? { state: "disabled" },
+        ready: isReadyGlassesConnectionStatus(connection),
+        signal: {
+            strengthDbm: numberValue(status.signalStrength),
+            updatedAt: numberValue(status.signalStrengthUpdatedAt),
+        },
+        wifi: status.wifi ?? { state: "disconnected" },
+    };
+}
+function phoneSdkState(status, defaultDevice, galleryMode) {
+    return {
+        currentMic: status.currentMic || null,
+        defaultDevice,
+        galleryMode,
+        lastLog: status.lastLog ?? [],
+        micRanking: status.micRanking ?? [],
+        otherBluetoothConnected: status.otherBtConnected ?? false,
+        searching: status.searching ?? false,
+        searchingController: status.searchingController ?? false,
+        systemMicUnavailable: status.systemMicUnavailable ?? false,
+        wifiScanResults: status.wifiScanResults ?? [],
+    };
+}
+function scanController(connection) {
+    return {
+        active: connection.scan.scanning,
+        clear: connection.scan.clearResults,
+        devices: connection.scan.devices,
+        error: connection.scan.error,
+        model: connection.scan.model,
+        selectedDevice: connection.scan.selectedDevice,
+        selectDevice: connection.scan.selectDevice,
+        setModel: connection.scan.setModel,
+        start: connection.scan.startScan,
+        stop: connection.scan.stopScan,
+    };
+}
+export function useMentraBluetooth(options = {}) {
+    const connection = useGlassesConnection({
+        autoConnectDefault: options.autoConnectDefault,
+        defaultDeviceStorage: options.defaultDeviceStorage,
+        onError: options.onError,
+        scanModel: options.defaultModel ?? DeviceModels.MentraLive,
+        scanTimeoutMs: options.scanTimeoutMs,
+    });
+    const [galleryModeApplying, setGalleryModeApplying] = useState(false);
+    const [galleryModeError, setGalleryModeError] = useState(null);
+    async function setGalleryMode(mode) {
+        setGalleryModeApplying(true);
+        setGalleryModeError(null);
+        try {
+            await BluetoothSdk.setGalleryMode(mode);
+        }
+        catch (error) {
+            setGalleryModeError(error);
+            options.onError?.(error);
+            throw error;
+        }
+        finally {
+            setGalleryModeApplying(false);
+        }
+    }
+    const galleryMode = {
+        applying: galleryModeApplying,
+        desired: connection.bluetoothStatus.galleryModeAuto === false ? "manual" : "auto",
+        error: galleryModeError,
+    };
+    return {
+        busy: connection.busy || galleryModeApplying,
+        clearDefaultDevice: connection.clearDefaultDevice,
+        connect: connection.connect,
+        connectDefault: connection.connectDefault,
+        defaultDevice: connection.defaultDevice,
+        disconnect: connection.disconnect,
+        error: galleryModeError ?? connection.error,
+        glasses: runtimeGlassesState(connection.glassesStatus),
+        refresh: connection.refresh,
+        scan: scanController(connection),
+        sdk: phoneSdkState(connection.bluetoothStatus, connection.defaultDevice, galleryMode),
+        setDefaultDevice: connection.setDefaultDevice,
+        setGalleryMode,
+    };
+}
+//# sourceMappingURL=useMentraBluetooth.js.map

package/build/react/useMentraBluetooth.js.map

@@ -0,0 +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  DeviceModels,\n  createDisconnectedGlassesStatus,\n  isConnectedGlassesConnectionStatus,\n  isReadyGlassesConnectionStatus,\n} from \"../BluetoothSdk.types\"\nimport type {\n  ConnectOptions,\n  Device,\n  DeviceModel,\n  GalleryMode,\n  GlassesConnectionStatus,\n  HotspotStatus,\n  PublicBluetoothStatus,\n  PublicGlassesStatus,\n  MicMode,\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      wifi: WifiStatus\n    }\n\nexport type GalleryModeState = {\n  applying: boolean\n  desired: GalleryMode\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  setGalleryMode: (mode: GalleryMode) => 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    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 setGalleryMode(mode: GalleryMode) {\n    setGalleryModeApplying(true)\n    setGalleryModeError(null)\n    try {\n      await BluetoothSdk.setGalleryMode(mode)\n    } catch (error) {\n      setGalleryModeError(error)\n      options.onError?.(error)\n      throw error\n    } finally {\n      setGalleryModeApplying(false)\n    }\n  }\n\n  const galleryMode: GalleryModeState = {\n    applying: galleryModeApplying,\n    desired: connection.bluetoothStatus.galleryModeAuto === false ? \"manual\" : \"auto\",\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    setGalleryMode,\n  }\n}\n"]}

package/ios/BluetoothSdkModule.swift

@@ -457,7 +457,7 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
                 self.bluetoothSdk().setMicState(
                     enabled: enabled,
                     useGlassesMic: useGlassesMic ?? true,
-                    bypassVad: bypassVad ?? false,
+                    bypassVad: bypassVad ?? true,
                     sendTranscript: sendTranscript ?? false,
                     sendLc3Data: sendLc3Data ?? false
                 )
@@ -589,13 +589,13 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
     }
 
     @MainActor
-    public func mentraBluetoothSDK(_: MentraBluetoothSDK, didReceiveMicPcm frame: Data) {
-        sendEvent("mic_pcm", ["pcm": frame])
+    public func mentraBluetoothSDK(_: MentraBluetoothSDK, didReceiveMicPcm event: MicPcmEvent) {
+        sendEvent("mic_pcm", event.values)
     }
 
     @MainActor
-    public func mentraBluetoothSDK(_: MentraBluetoothSDK, didReceiveMicLc3 frame: Data) {
-        sendEvent("mic_lc3", ["lc3": frame])
+    public func mentraBluetoothSDK(_: MentraBluetoothSDK, didReceiveMicLc3 event: MicLc3Event) {
+        sendEvent("mic_lc3", event.values)
     }
 
     @MainActor

package/ios/Source/Bridge.swift

@@ -10,6 +10,11 @@ import Foundation
 /// Bridge for Bluetooth SDK communication between Expo modules and native iOS code
 /// Has commands for the Bluetooth SDK to use to send messages to JavaScript
 class Bridge {
+    private static let micSampleRate = 16_000
+    private static let pcmBitsPerSample = 16
+    private static let micChannels = 1
+    private static let lc3FrameDurationMs = 10
+    private static let defaultLc3FrameSizeBytes = 60
     private static let eventSinkLock = NSLock()
     private static let defaultEventSinkId = "default"
     private static var eventSinks: [String: (String, [String: Any]) -> Void] = [:]
@@ -72,18 +77,47 @@ class Bridge {
         Bridge.sendTypedMessage("pair_failure", body: data)
     }
 
+    @MainActor
     static func sendMicPcm(_ data: Data) {
-        // let base64String = data.base64EncodedString()
-        // let body = ["base64": base64String]
-        let body = ["pcm": data]
-        Bridge.sendTypedMessage("mic_pcm", body: body)
+        Bridge.sendTypedMessage("mic_pcm", body: micPcmEventBody(data))
     }
 
+    @MainActor
     static func sendMicLc3(_ data: Data) {
-        // let base64String = data.base64EncodedString()
-        // let body = ["base64": base64String]
-        let body = ["lc3": data]
-        Bridge.sendTypedMessage("mic_lc3", body: body)
+        Bridge.sendTypedMessage("mic_lc3", body: micLc3EventBody(data))
+    }
+
+    @MainActor
+    private static func micPcmEventBody(_ data: Data) -> [String: Any] {
+        [
+            "pcm": data,
+            "sampleRate": micSampleRate,
+            "bitsPerSample": pcmBitsPerSample,
+            "channels": micChannels,
+            "encoding": "pcm_s16le",
+            "vadGated": isVadGated(),
+        ]
+    }
+
+    @MainActor
+    private static func micLc3EventBody(_ data: Data) -> [String: Any] {
+        let frameSizeBytes = DeviceStore.shared.get("bluetooth", "lc3_frame_size") as? Int ?? defaultLc3FrameSizeBytes
+        return [
+            "lc3": data,
+            "sampleRate": micSampleRate,
+            "channels": micChannels,
+            "encoding": "lc3",
+            "frameDurationMs": lc3FrameDurationMs,
+            "frameSizeBytes": frameSizeBytes,
+            "bitrate": frameSizeBytes * 8 * (1000 / lc3FrameDurationMs),
+            "packetizedFromGlasses": false,
+            "vadGated": isVadGated(),
+        ]
+    }
+
+    @MainActor
+    private static func isVadGated() -> Bool {
+        !(DeviceStore.shared.get("bluetooth", "bypass_vad") as? Bool ?? true)
     }
 
     static func saveSetting(_ key: String, _ value: Any) {

package/ios/Source/DeviceManager.swift

@@ -1013,7 +1013,6 @@ struct ViewState {
 
     func handleDeviceDisconnected() {
         Bridge.log("MAN: Device disconnected")
-        // setMicState(shouldSendPcData, shouldSendTranscript, false)
         // shouldSendBootingMessage = true  // Reset for next first connect
     }
 

package/ios/Source/DeviceStore.swift

@@ -96,7 +96,7 @@ class DeviceStore {
         store.set("bluetooth", "should_send_pcm", false)
         store.set("bluetooth", "should_send_lc3", false)
         store.set("bluetooth", "should_send_transcript", false)
-        store.set("bluetooth", "bypass_vad", false)
+        store.set("bluetooth", "bypass_vad", true)
     }
 
     func get(_ category: String, _ key: String) -> Any? {

package/ios/Source/MentraBluetoothSDK.swift

@@ -159,8 +159,10 @@ public enum DeviceModel: String {
 public struct Device: Identifiable, Equatable, CustomStringConvertible {
     public let model: DeviceModel
     public let name: String
+    /// CoreBluetooth identifier when available.
     public let identifier: String?
     public let rssi: Int?
+    /// Stable app-facing scan-result key. Do not parse; use typed fields instead.
     public let id: String
 
     public init(
@@ -527,7 +529,7 @@ public struct BluetoothStatus: CustomStringConvertible {
     public var shouldSendPcm: Bool { boolValue(values, "should_send_pcm") ?? false }
     public var shouldSendLc3: Bool { boolValue(values, "should_send_lc3") ?? false }
     public var shouldSendTranscript: Bool { boolValue(values, "should_send_transcript") ?? false }
-    public var bypassVad: Bool { boolValue(values, "bypass_vad") ?? false }
+    public var bypassVad: Bool { boolValue(values, "bypass_vad") ?? true }
     public var offlineCaptionsRunning: Bool { boolValue(values, "offline_captions_running") ?? false }
     public var localSttFallbackActive: Bool { boolValue(values, "local_stt_fallback_active") ?? false }
     public var shouldSendBootingMessage: Bool { boolValue(values, "shouldSendBootingMessage") ?? true }
@@ -1912,6 +1914,109 @@ public struct LocalTranscriptionEvent: CustomStringConvertible {
     }
 }
 
+public struct MicPcmEvent: CustomStringConvertible {
+    public static let sampleRate = 16_000
+    public static let bitsPerSample = 16
+    public static let channels = 1
+    public static let encoding = "pcm_s16le"
+
+    public let pcm: Data
+    public let sampleRate: Int
+    public let bitsPerSample: Int
+    public let channels: Int
+    public let encoding: String
+    public let vadGated: Bool
+    public let values: [String: Any]
+
+    public init(values: [String: Any]) {
+        let pcm = values["pcm"] as? Data ?? Data()
+        let sampleRate = intValue(values["sampleRate"]) ?? Self.sampleRate
+        let bitsPerSample = intValue(values["bitsPerSample"]) ?? Self.bitsPerSample
+        let channels = intValue(values["channels"]) ?? Self.channels
+        let encoding = values["encoding"] as? String ?? Self.encoding
+        let vadGated = boolValue(values, "vadGated") ?? false
+
+        var normalized = values
+        normalized["type"] = "mic_pcm"
+        normalized["pcm"] = pcm
+        normalized["sampleRate"] = sampleRate
+        normalized["bitsPerSample"] = bitsPerSample
+        normalized["channels"] = channels
+        normalized["encoding"] = encoding
+        normalized["vadGated"] = vadGated
+
+        self.pcm = pcm
+        self.sampleRate = sampleRate
+        self.bitsPerSample = bitsPerSample
+        self.channels = channels
+        self.encoding = encoding
+        self.vadGated = vadGated
+        self.values = normalized
+    }
+
+    public var description: String {
+        "MicPcmEvent(bytes: \(pcm.count), sampleRate: \(sampleRate), bitsPerSample: \(bitsPerSample), channels: \(channels), encoding: \(encoding), vadGated: \(vadGated))"
+    }
+}
+
+public struct MicLc3Event: CustomStringConvertible {
+    public static let sampleRate = 16_000
+    public static let channels = 1
+    public static let encoding = "lc3"
+    public static let frameDurationMs = 10
+    public static let defaultFrameSizeBytes = 60
+
+    public let lc3: Data
+    public let sampleRate: Int
+    public let channels: Int
+    public let encoding: String
+    public let frameDurationMs: Int
+    public let frameSizeBytes: Int
+    public let bitrate: Int
+    public let packetizedFromGlasses: Bool
+    public let vadGated: Bool
+    public let values: [String: Any]
+
+    public init(values: [String: Any]) {
+        let lc3 = values["lc3"] as? Data ?? Data()
+        let sampleRate = intValue(values["sampleRate"]) ?? Self.sampleRate
+        let channels = intValue(values["channels"]) ?? Self.channels
+        let encoding = values["encoding"] as? String ?? Self.encoding
+        let frameDurationMs = intValue(values["frameDurationMs"]) ?? Self.frameDurationMs
+        let frameSizeBytes = intValue(values["frameSizeBytes"]) ?? Self.defaultFrameSizeBytes
+        let bitrate = intValue(values["bitrate"]) ?? frameSizeBytes * 8 * (1000 / frameDurationMs)
+        let packetizedFromGlasses = boolValue(values, "packetizedFromGlasses") ?? false
+        let vadGated = boolValue(values, "vadGated") ?? false
+
+        var normalized = values
+        normalized["type"] = "mic_lc3"
+        normalized["lc3"] = lc3
+        normalized["sampleRate"] = sampleRate
+        normalized["channels"] = channels
+        normalized["encoding"] = encoding
+        normalized["frameDurationMs"] = frameDurationMs
+        normalized["frameSizeBytes"] = frameSizeBytes
+        normalized["bitrate"] = bitrate
+        normalized["packetizedFromGlasses"] = packetizedFromGlasses
+        normalized["vadGated"] = vadGated
+
+        self.lc3 = lc3
+        self.sampleRate = sampleRate
+        self.channels = channels
+        self.encoding = encoding
+        self.frameDurationMs = frameDurationMs
+        self.frameSizeBytes = frameSizeBytes
+        self.bitrate = bitrate
+        self.packetizedFromGlasses = packetizedFromGlasses
+        self.vadGated = vadGated
+        self.values = normalized
+    }
+
+    public var description: String {
+        "MicLc3Event(bytes: \(lc3.count), sampleRate: \(sampleRate), channels: \(channels), frameDurationMs: \(frameDurationMs), frameSizeBytes: \(frameSizeBytes), bitrate: \(bitrate), packetizedFromGlasses: \(packetizedFromGlasses), vadGated: \(vadGated))"
+    }
+}
+
 public struct GlassesMediaVolumeGetResult: CustomStringConvertible {
     public let level: Int?
     public let statusCode: Int?
@@ -1989,8 +2094,8 @@ public protocol MentraBluetoothSDKDelegate: AnyObject {
     func mentraBluetoothSDK(_ sdk: MentraBluetoothSDK, didDiscover device: Device)
     func mentraBluetoothSDK(_ sdk: MentraBluetoothSDK, didStopScan reason: ScanStopReason)
     func mentraBluetoothSDK(_ sdk: MentraBluetoothSDK, didReceive event: BluetoothEvent)
-    func mentraBluetoothSDK(_ sdk: MentraBluetoothSDK, didReceiveMicPcm frame: Data)
-    func mentraBluetoothSDK(_ sdk: MentraBluetoothSDK, didReceiveMicLc3 frame: Data)
+    func mentraBluetoothSDK(_ sdk: MentraBluetoothSDK, didReceiveMicPcm event: MicPcmEvent)
+    func mentraBluetoothSDK(_ sdk: MentraBluetoothSDK, didReceiveMicLc3 event: MicLc3Event)
     func mentraBluetoothSDK(_ sdk: MentraBluetoothSDK, didChangeDefaultDevice device: Device?)
     func mentraBluetoothSDK(_ sdk: MentraBluetoothSDK, didLog message: String)
     func mentraBluetoothSDK(_ sdk: MentraBluetoothSDK, didFail error: BluetoothError)
@@ -2003,8 +2108,8 @@ public extension MentraBluetoothSDKDelegate {
     func mentraBluetoothSDK(_: MentraBluetoothSDK, didDiscover _: Device) {}
     func mentraBluetoothSDK(_: MentraBluetoothSDK, didStopScan _: ScanStopReason) {}
     func mentraBluetoothSDK(_: MentraBluetoothSDK, didReceive _: BluetoothEvent) {}
-    func mentraBluetoothSDK(_: MentraBluetoothSDK, didReceiveMicPcm _: Data) {}
-    func mentraBluetoothSDK(_: MentraBluetoothSDK, didReceiveMicLc3 _: Data) {}
+    func mentraBluetoothSDK(_: MentraBluetoothSDK, didReceiveMicPcm _: MicPcmEvent) {}
+    func mentraBluetoothSDK(_: MentraBluetoothSDK, didReceiveMicLc3 _: MicLc3Event) {}
     func mentraBluetoothSDK(_: MentraBluetoothSDK, didChangeDefaultDevice _: Device?) {}
     func mentraBluetoothSDK(_: MentraBluetoothSDK, didLog _: String) {}
     func mentraBluetoothSDK(_: MentraBluetoothSDK, didFail _: BluetoothError) {}
@@ -2298,7 +2403,7 @@ public final class MentraBluetoothSDK {
     public func setMicState(
         enabled: Bool,
         useGlassesMic: Bool = true,
-        bypassVad: Bool = false,
+        bypassVad: Bool = true,
         sendTranscript: Bool = false,
         sendLc3Data: Bool = false
     ) {
@@ -2567,12 +2672,14 @@ public final class MentraBluetoothSDK {
         case "touch_event":
             delegate?.mentraBluetoothSDK(self, didReceive: .touch(TouchEvent(values: data)))
         case "mic_pcm":
-            if let frame = data["pcm"] as? Data {
-                delegate?.mentraBluetoothSDK(self, didReceiveMicPcm: frame)
+            let event = MicPcmEvent(values: data)
+            if !event.pcm.isEmpty {
+                delegate?.mentraBluetoothSDK(self, didReceiveMicPcm: event)
             }
         case "mic_lc3":
-            if let frame = data["lc3"] as? Data {
-                delegate?.mentraBluetoothSDK(self, didReceiveMicLc3: frame)
+            let event = MicLc3Event(values: data)
+            if !event.lc3.isEmpty {
+                delegate?.mentraBluetoothSDK(self, didReceiveMicLc3: event)
             }
         case "local_transcription":
             let event = LocalTranscriptionEvent(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -12,10 +12,16 @@
       "react-native": "./src/index.ts",
       "default": "./build/index.js"
     },
+    "./react": {
+      "types": "./build/react/index.d.ts",
+      "react-native": "./src/react/index.ts",
+      "default": "./build/react/index.js"
+    },
     "./_private/*": null,
     "./build/*": null,
     "./src/*": null,
     "./app.plugin": "./app.plugin.js",
+    "./app.plugin.js": "./app.plugin.js",
     "./package.json": "./package.json"
   },
   "files": [

package/src/BluetoothSdk.types.ts

@@ -295,11 +295,24 @@ export type WsBinEvent = {
 export type MicPcmEvent = {
   type: "mic_pcm"
   pcm: ArrayBuffer
+  sampleRate: 16000
+  bitsPerSample: 16
+  channels: 1
+  encoding: "pcm_s16le"
+  vadGated: boolean
 }
 
 export type MicLc3Event = {
   type: "mic_lc3"
   lc3: ArrayBuffer
+  sampleRate: 16000
+  channels: 1
+  encoding: "lc3"
+  frameDurationMs: 10
+  frameSizeBytes: number
+  bitrate: number
+  packetizedFromGlasses: boolean
+  vadGated: boolean
 }
 
 export type StreamStatusLifecycleState = "initializing" | "streaming" | "stopping" | "stopped"
@@ -381,7 +394,7 @@ export type OtaUpdateAvailableEvent = {
   cache_ready?: boolean
 }
 
-/** @deprecated Glasses no longer emit ota_progress; use {@link OtaStatusEvent} and legacy store mapping. */
+/** @deprecated Glasses no longer emit ota_progress; use {@link OtaStatusEvent} and status-store mapping. */
 export type OtaProgressEvent = {
   type: "ota_progress"
   stage?: OtaStage
@@ -491,8 +504,6 @@ export type PublicBluetoothStatus = Pick<
 >
 
 export type BluetoothSdkEventMap = {
-  glasses_status: Partial<PublicGlassesStatus>
-  bluetooth_status: Partial<PublicBluetoothStatus>
   log: LogEvent
   device_discovered: Device
   default_device_changed: {device?: Device}
@@ -540,8 +551,6 @@ export interface BluetoothSdkPublicModule {
     listener: BluetoothSdkEventListener<EventName>,
   ): BluetoothSdkSubscription
 
-  getGlassesStatus(): Promise<PublicGlassesStatus>
-  getBluetoothStatus(): Promise<PublicBluetoothStatus>
   getDefaultDevice(): Promise<Device | null>
   setDefaultDevice(device: Device | null): Promise<void>
   clearDefaultDevice(): Promise<void>
@@ -614,8 +623,6 @@ export interface BluetoothSdkPublicModule {
   ): Promise<void>
 
   requestVersionInfo(): Promise<void>
-  onGlassesStatus(callback: (changed: Partial<PublicGlassesStatus>) => void): () => void
-  onBluetoothStatus(callback: (changed: Partial<PublicBluetoothStatus>) => void): () => void
 }
 
 // OTA update status types
@@ -711,9 +718,15 @@ export interface CoreSettings {
 }
 
 export interface Device {
+  /**
+   * Stable app-facing key for this scan result, within the limits of the
+   * platform identifier available to the SDK. Do not parse this value; use the
+   * typed model, name, address, and rssi fields instead.
+   */
   id: string
   model: DeviceModel
   name: string
+  /** Platform address/identifier when available: Android Bluetooth address, iOS CoreBluetooth identifier. */
   address?: string
   rssi?: number
 }

package/src/_internal.ts

@@ -1,7 +1,7 @@
 /**
  * MentraOS-only compatibility entrypoint.
  *
- * Partner apps should import from `@mentra/bluetooth-sdk`. This file is not a
+ * Apps should import from `@mentra/bluetooth-sdk`. This file is not a
  * package export; MentraOS resolves it through its local
  * `@mentra/bluetooth-sdk-internal` alias while the app is migrated onto the
  * public SDK surface.

package/src/_private/BluetoothSdkModule.ts

@@ -20,6 +20,7 @@ import {
   ObservableStoreCategory,
   PhotoCompression,
   PhotoSize,
+  PublicBluetoothStatus,
   RgbLedAction,
   RgbLedColor,
   ScanModelOptions,
@@ -33,17 +34,18 @@ import {
  *
  * This file intentionally lives under `_private` so the package root can expose
  * a small SDK surface while MentraOS uses its monorepo-only internal alias
- * during migration.
+ * during migration. Raw status getters/listeners stay here so React hooks can
+ * shape native store snapshots before app code sees them.
  */
 
 type GlassesListener = (changed: Partial<GlassesStatus>) => void
-type BluetoothStatusListener = (changed: Partial<BluetoothStatus>) => void
+type BluetoothStatusListener = (changed: Partial<PublicBluetoothStatus>) => void
 type MaybePromise<T> = T | Promise<T>
 
 declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEvents> {
   // Observable Store Functions (native)
   getGlassesStatus(): Promise<GlassesStatus>
-  getBluetoothStatus(): Promise<BluetoothStatus>
+  getBluetoothStatus(): Promise<PublicBluetoothStatus>
   getDefaultDevice(): Promise<Device | null>
   update(category: ObservableStoreCategory, values: object): Promise<void>
 
@@ -194,7 +196,7 @@ const CAMERA_FOV_SETTINGS: Record<CameraFov, CameraFovSetting> = {
   wide: {fov: 118, roiPosition: 0},
 }
 
-function searchResultsForModel(status: Partial<BluetoothStatus>, model: DeviceModel): Device[] {
+function searchResultsForModel(status: Partial<PublicBluetoothStatus>, model: DeviceModel): Device[] {
   return status.searchResults?.filter((device) => device.model === model) ?? []
 }
 
@@ -388,7 +390,7 @@ NativeBluetoothSdkModule.setMicState = function (
     nativeSetMicState(
       enabled,
       useGlassesMic ?? true,
-      bypassVad ?? false,
+      bypassVad ?? true,
       sendTranscript ?? false,
       sendLc3Data ?? false,
     ),