@mentra/bluetooth-sdk 0.1.21-beta.0 → 0.1.21-beta.2

package/ios/Source/streaming/StreamModels.swift

@@ -217,25 +217,79 @@ public struct StreamResolvedConfig: Equatable {
     }
 }
 
+private func streamInt64Value(_ value: Any?) -> Int64? {
+    if let int64 = value as? Int64 { return int64 }
+    if let int = value as? Int { return Int64(int) }
+    if let number = value as? NSNumber { return number.int64Value }
+    return nil
+}
+
+/// Live encoder and device telemetry reported by the glasses while streaming.
+public struct StreamLiveStats: Equatable {
+    public let bitrate: Int64?
+    public let fps: Double?
+    public let droppedFrames: Int64?
+    public let duration: Int64?
+    public let temperatureC: Double?
+
+    public init(
+        bitrate: Int64? = nil,
+        fps: Double? = nil,
+        droppedFrames: Int64? = nil,
+        duration: Int64? = nil,
+        temperatureC: Double? = nil
+    ) {
+        self.bitrate = bitrate
+        self.fps = fps
+        self.droppedFrames = droppedFrames
+        self.duration = duration
+        self.temperatureC = temperatureC
+    }
+
+    init?(values: [String: Any]?) {
+        guard let values else { return nil }
+        self.init(
+            bitrate: streamInt64Value(values["bitrate"]),
+            fps: doubleValue(values["fps"]),
+            droppedFrames: streamInt64Value(values["droppedFrames"]),
+            duration: streamInt64Value(values["duration"]),
+            temperatureC: doubleValue(values["temperatureC"])
+        )
+    }
+
+    var values: [String: Any] {
+        var values: [String: Any] = [:]
+        if let bitrate { values["bitrate"] = bitrate }
+        if let fps { values["fps"] = fps }
+        if let droppedFrames { values["droppedFrames"] = droppedFrames }
+        if let duration { values["duration"] = duration }
+        if let temperatureC { values["temperatureC"] = temperatureC }
+        return values
+    }
+}
+
 public struct StreamRequest {
     public let streamUrl: String
     public let streamId: String
     public let sound: Bool
     public let video: StreamVideoConfig?
     public let audio: StreamAudioConfig?
+    public let authToken: String?
 
     public init(
         streamUrl: String,
         streamId: String = "",
         sound: Bool = true,
         video: StreamVideoConfig? = nil,
-        audio: StreamAudioConfig? = nil
+        audio: StreamAudioConfig? = nil,
+        authToken: String? = nil
     ) {
         self.streamUrl = streamUrl
         self.streamId = streamId
         self.sound = sound
         self.video = video
         self.audio = audio
+        self.authToken = authToken
     }
 
     init(values: [String: Any]) {
@@ -248,7 +302,8 @@ public struct StreamRequest {
             streamId: values["streamId"] as? String ?? "",
             sound: values["sound"] as? Bool ?? true,
             video: StreamVideoConfig(values: values["video"] as? [String: Any]),
-            audio: StreamAudioConfig(values: values["audio"] as? [String: Any])
+            audio: StreamAudioConfig(values: values["audio"] as? [String: Any]),
+            authToken: values["authToken"] as? String ?? values["auth_token"] as? String
         )
     }
 
@@ -264,6 +319,9 @@ public struct StreamRequest {
         if let audioValues = audio?.dictionary, !audioValues.isEmpty {
             values["audio"] = audioValues
         }
+        if let authToken, !authToken.isEmpty {
+            values["authToken"] = authToken
+        }
         return values
     }
 }
@@ -553,18 +611,21 @@ public enum StreamStatus: CustomStringConvertible, Equatable {
 
 public struct StreamStatusEvent: CustomStringConvertible {
     public let status: StreamStatus
-    // True when the glasses will retry the failed publisher themselves
-    // (emitting side lands in PR #3488); absent on older firmware and on
-    // events not parsed from a glasses status map. Carried here instead of
-    // as an `.error` associated value so the public case stays unchanged.
+    public let stats: StreamLiveStats?
+    /// True when the glasses will retry the failed publisher themselves
+    /// (emitting side lands in PR #3488); absent on older firmware and on
+    /// events not parsed from a glasses status map. Carried here instead of
+    /// as an `.error` associated value so the public case stays unchanged.
     public private(set) var willRetry: Bool?
 
-    public init(status: StreamStatus) {
+    public init(status: StreamStatus, stats: StreamLiveStats? = nil) {
         self.status = status
+        self.stats = stats
     }
 
     public init(values: [String: Any]) {
         status = StreamStatus(values: values)
+        stats = StreamLiveStats(values: values["stats"] as? [String: Any])
         willRetry = boolValue(values, "willRetry")
     }
 
@@ -583,6 +644,9 @@ public struct StreamStatusEvent: CustomStringConvertible {
     public var values: [String: Any] {
         var values = status.values
         values["type"] = "stream_status"
+        if let stats {
+            values["stats"] = stats.values
+        }
         if let willRetry {
             values["willRetry"] = willRetry
         }

package/ios/Source/types/DeviceModels.swift

@@ -19,6 +19,7 @@ public enum DeviceModel: String {
     case z100
     case frame
     case nimo
+    case ar99
     case simulated
     case r1
 
@@ -40,6 +41,8 @@ public enum DeviceModel: String {
             DeviceTypes.FRAME
         case .nimo:
             DeviceTypes.NIMO
+        case .ar99:
+            DeviceTypes.AR99
         case .simulated:
             DeviceTypes.SIMULATED
         case .r1:
@@ -65,6 +68,8 @@ public enum DeviceModel: String {
             .frame
         case DeviceTypes.NIMO:
             .nimo
+        case DeviceTypes.AR99:
+            .ar99
         case DeviceTypes.SIMULATED:
             .simulated
         case ControllerTypes.R1:
@@ -80,6 +85,7 @@ public struct Device: Identifiable, Equatable, CustomStringConvertible {
     public let name: String
     /// CoreBluetooth identifier when available.
     public let identifier: String?
+    public let projectName: String?
     public let rssi: Int?
     /// Stable app-facing scan-result key. Do not parse; use typed fields instead.
     public let id: String
@@ -88,12 +94,14 @@ public struct Device: Identifiable, Equatable, CustomStringConvertible {
         model: DeviceModel,
         name: String,
         identifier: String? = nil,
+        projectName: String? = nil,
         rssi: Int? = nil,
         id: String? = nil
     ) {
         self.model = model
         self.name = name
         self.identifier = identifier
+        self.projectName = projectName
         self.rssi = rssi
         self.id = id ?? identifier.flatMap { $0.isEmpty ? nil : $0 } ?? "\(model.deviceType):\(name)"
     }
@@ -111,6 +119,9 @@ public struct Device: Identifiable, Equatable, CustomStringConvertible {
         if let identifier, !identifier.isEmpty {
             values["address"] = identifier
         }
+        if let projectName, !projectName.isEmpty {
+            values["projectName"] = projectName
+        }
         if let rssi {
             values["rssi"] = rssi
         }
@@ -121,11 +132,13 @@ public struct Device: Identifiable, Equatable, CustomStringConvertible {
         guard let model = stringValue(values, "model") else { return nil }
         guard let name = stringValue(values, "name") else { return nil }
         let identifier = stringValue(values, "address").flatMap { $0.isEmpty ? nil : $0 }
+        let projectName = stringValue(values, "projectName").flatMap { $0.isEmpty ? nil : $0 }
         let rssi = intValue(values["rssi"])
         self.init(
             model: DeviceModel.fromDeviceType(model),
             name: name,
             identifier: identifier,
+            projectName: projectName,
             rssi: rssi,
             id: stringValue(values, "id")
         )

package/ios/Source/utils/BleJsonCompact.swift

@@ -19,6 +19,14 @@ enum BleJsonCompact {
         "transferMethod": "tm",
         "manual": "m",
         "reconnecting": "rc",
+        "stats": "st",
+        "width": "w",
+        "height": "h",
+        "bitrate": "br",
+        "fps": "f",
+        "droppedFrames": "df",
+        "duration": "du",
+        "temperatureC": "tc",
     ]
 
     private static let shortToLong: [String: String] = {

package/ios/Source/utils/Constants.swift

@@ -8,6 +8,7 @@ struct DeviceTypes {
     static let NEX = "Mentra Display"
     static let FRAME = "Brilliant Frame"
     static let NIMO = "NIMO"
+    static let AR99 = "AR99"
 
     static let ALL = [
         SIMULATED,
@@ -19,6 +20,7 @@ struct DeviceTypes {
         NEX,
         FRAME,
         NIMO,
+        AR99,
     ]
 
     /// Private init to prevent instantiation

package/ios/Source/utils/PhoneAudioMonitor.swift

@@ -55,6 +55,10 @@ class PhoneAudioMonitor {
         return session.isOtherAudioPlaying || ownAppAudioPlaying
     }
 
+    func isOwnAppAudioPlaying() -> Bool {
+        ownAppAudioPlaying
+    }
+
     /// Notify the monitor that our own app started/stopped playing audio
     /// Called from RN AudioPlaybackService via Bridge
     func setOwnAppAudioPlaying(_ playing: Bool) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "0.1.21-beta.0",
+  "version": "0.1.21-beta.2",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",

package/src/BluetoothSdk.types.ts

@@ -5,7 +5,7 @@ export type GlassesNotReadyEvent = {
 }
 
 // NOTE: unlike most events below, the native module does NOT include a `type`
-// field on the button_press payload — it sends only {buttonId, pressType,
+// field on the button_press payload 闂?it sends only {buttonId, pressType,
 // timestamp} (see BluetoothSdkModule on both iOS and Android). Consumers must
 // filter on `pressType` / the "button_press" listener name, never `event.type`.
 export type ButtonPressEvent = {
@@ -85,7 +85,7 @@ export function createDisconnectedGlassesStatus(): Partial<GlassesStatus> {
   }
 }
 
-/** K900 `sr_getvol` response (Mentra Live glasses media step volume 0–15). */
+/** K900 `sr_getvol` response (Mentra Live glasses media step volume 0闂?5). */
 export type GlassesMediaVolumeGetResult = {
   level: number
   statusCode: number
@@ -119,11 +119,11 @@ export type WifiStatusChangeEvent = WifiStatus & {
   /**
    * Glasses-reported provisioning failure reason when THIS event is the verdict of a
    * failed connect attempt; absent on routine link-state updates. An attempt property,
-   * not a link property — which is why it lives on the event, not on WifiStatus:
+   * not a link property 闂?which is why it lives on the event, not on WifiStatus:
    * "connect_timeout" arrives on a disconnected status (never associated), while
    * "connected_to_other_network" arrives on a *connected* status (the attempt failed
    * and the glasses ended up on / fell back to a different SSID than requested).
-   * Requires ASG client v40+ — older glasses never send it.
+   * Requires ASG client v40+ 闂?older glasses never send it.
    */
   error?: string
 }
@@ -453,17 +453,21 @@ export type RgbLedAction = "on" | "off"
 export type RgbLedColor = "red" | "green" | "blue" | "orange" | "white"
 export type PhotoSize = "low" | "medium" | "high" | "max"
 export type PhotoMode = "photo" | "text"
+export type PhotoTransferMethod = "auto" | "direct" | "ble"
 export type ButtonPhotoSize = "low" | "medium" | "high" | "max"
 
 /**
  * @deprecated Sticky action-button photo presets via {@link BluetoothSdkPublicModule.setPhotoCaptureDefaults}
  * are deprecated. Prefer per-request {@link BluetoothSdkPublicModule.requestPhoto} options
- * (e.g. `mode: "text"` for AE ÷3) instead of persisting button-photo tuning on the glasses.
+ * (e.g. `mode: "text"` for text sensor size/crop, or explicit `aeExposureDivisor`) instead of
+ * persisting button-photo tuning on the glasses.
  */
 export type PhotoCaptureDefaults = {
   size?: PhotoSize
-  mfnr?: boolean
+  /** ZSL preview buffering for physical camera-button photos. */
   zsl?: boolean
+  /** MFNR still capture for physical camera-button photos. */
+  mfnr?: boolean
   noiseReduction?: boolean
   edgeEnhancement?: boolean
   ispDigitalGain?: number
@@ -509,6 +513,7 @@ export const DeviceModels = {
   Z100: "Vuzix Z100",
   Frame: "Brilliant Frame",
   Nimo: "NIMO",
+  Ar99: "AR99",
   R1: "Even Realities R1",
 } as const
 
@@ -523,7 +528,7 @@ export type DashboardMenuItem = {
 
 export const CAMERA_FOV_MIN = 62
 export const CAMERA_FOV_MAX = 118
-export const CAMERA_FOV_DEFAULT = 102
+export const CAMERA_FOV_DEFAULT = CAMERA_FOV_MAX
 
 export type CameraRoiPosition = "center" | "bottom" | "top"
 export type CameraRoiPositionValue = 0 | 1 | 2
@@ -570,8 +575,8 @@ export type PhotoRequestParams = {
   appId?: string
   size: PhotoSize
   mode?: PhotoMode
-  /** `ble` skips direct upload and forces phone-relayed BLE image transfer. */
-  transferMethod?: "auto" | "ble"
+  /** `direct` disables BLE fallback; `ble` skips direct upload and forces phone-relayed transfer. */
+  transferMethod?: PhotoTransferMethod
   webhookUrl: string | null
   authToken: string | null
   compress: PhotoCompression
@@ -587,8 +592,10 @@ export type PhotoRequestParams = {
   /** Requested on wire; glasses may log not_implemented. */
   noiseReduction?: boolean
   edgeEnhancement?: boolean
-  mfnr?: boolean
+  /** ZSL buffering. Forced off for manual/scan stills because fixed sensor controls take priority. */
   zsl?: boolean
+  /** MFNR still capture. Forced off for manual/scan stills because fixed sensor controls take priority. */
+  mfnr?: boolean
   ispDigitalGain?: number
   ispAnalogGain?: string
 }
@@ -601,6 +608,10 @@ export type WarmUpCameraParams = {
   exposureTimeNs?: number | null
   /** Ready-state hold; defaults to 15 seconds and is capped at 60 seconds by ASG. */
   durationMs?: number
+  /** ZSL preview buffering for the warm-up session. */
+  zsl?: boolean
+  /** MFNR still capture for the warm-up session. */
+  mfnr?: boolean
 }
 
 export type StreamVideoConfig = {
@@ -721,7 +732,7 @@ export type StreamResolvedConfig = {
   }
 }
 
-/** Live encoder telemetry, when the glasses emit it (no firmware does yet). */
+/** Live encoder and device telemetry emitted periodically by supported glasses firmware. */
 export type StreamLiveStats = {
   /** Current encoded video bitrate in bits per second. */
   bitrate?: number
@@ -730,7 +741,7 @@ export type StreamLiveStats = {
   droppedFrames?: number
   /** Seconds since the stream started. */
   duration?: number
-  /** Device temperature in °C, if the hardware reports it. */
+  /** Device temperature in 闂佺娅ｉ悡? if the hardware reports it. */
   temperatureC?: number
 }
 
@@ -790,6 +801,17 @@ export type MtkUpdateCompleteEvent = {
   timestamp: number
 }
 
+/**
+ * The glasses process restarted while the BES kept the BLE link alive (its `sid`
+ * changed, or first appeared after an update from a pre-sid build). There is no
+ * physical disconnect for this — treat it as the logical reconnect edge.
+ */
+export type GlassesSessionChangedEvent = {
+  type: "glasses_session_changed"
+  previous_sid: string
+  sid: string
+}
+
 /** @deprecated Glasses no longer emit ota_progress; use {@link OtaStatusEvent} and status-store mapping. */
 export type OtaProgressEvent = {
   type: "ota_progress"
@@ -806,16 +828,6 @@ export type OtaStartAckEvent = {
   type: "ota_start_ack"
   timestamp: number
 }
-
-export type OtaUpdateAvailableEvent = {
-  type: "ota_update_available"
-  version_code?: number
-  version_name?: string
-  updates?: string[]
-  total_size?: number
-  cache_ready?: boolean
-}
-
 export type OtaStatusEvent = {
   type: "ota_status"
   session_id: string
@@ -894,9 +906,10 @@ export type BluetoothSdkModuleEvents = {
   stream_status: (event: StreamStatusEvent) => void
   keep_alive_ack: (event: KeepAliveAckEvent) => void
   mtk_update_complete: (event: MtkUpdateCompleteEvent) => void
-  ota_update_available: (event: OtaUpdateAvailableEvent) => void
+  glasses_session_changed: (event: GlassesSessionChangedEvent) => void
   ota_start_ack: (event: OtaStartAckEvent) => void
   ota_status: (event: OtaStatusEvent) => void
+  ar99_ota_status: (event: Ar99OtaStatusEvent) => void
   version_info: (event: VersionInfoEvent) => void
   send_command_to_ble: (event: BleCommandTraceEvent) => void
   receive_command_from_ble: (event: BleCommandTraceEvent) => void
@@ -910,6 +923,16 @@ export interface ExtractionProgressEvent {
   totalBytes: number
 }
 
+export interface Ar99OtaStatusEvent {
+  type: "ar99_ota_status"
+  phase: string
+  progress: number
+  offset: number
+  total: number
+  errorMessage?: string
+  error_message?: string
+}
+
 export interface PhoneNotificationEvent {
   notificationId: string
   app: string
@@ -982,9 +1005,9 @@ export type BluetoothSdkEventMap = {
   mic_pcm: MicPcmEvent
   mic_lc3: MicLc3Event
   stream_status: StreamStatusEvent
-  ota_update_available: OtaUpdateAvailableEvent
   ota_start_ack: OtaStartAckEvent
   ota_status: OtaStatusEvent
+  ar99_ota_status: Ar99OtaStatusEvent
   version_info: VersionInfoEvent
   extraction_progress: ExtractionProgressEvent
 }
@@ -1036,9 +1059,10 @@ export interface BluetoothSdkPublicModule {
 
   setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>
   setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>
+  setLoudnessGateEnabled(enabled: boolean): Promise<void>
   /**
    * @deprecated Sticky action-button photo presets are deprecated. Prefer per-request
-   * `requestPhoto(...)` options (e.g. `mode: "text"` for AE ÷3, or explicit per-shot
+   * `requestPhoto(...)` options (e.g. `mode: "text"` for text sensor size/crop, or explicit per-shot
    * fields). Still functional until removed in a future release.
    */
   setPhotoCaptureDefaults(settings: PhotoCaptureDefaults): Promise<SettingsAckSuccessEvent>
@@ -1078,7 +1102,7 @@ export interface BluetoothSdkPublicModule {
    * Stop the active recording. When {@link webhookUrl} is provided, the glasses
    * upload the recorded video to it (multipart) using {@link authToken}. These
    * are supplied at stop time (not start) so the token is fresh when the upload
-   * runs — a recording can last arbitrarily long. An empty/omitted webhook keeps
+   * runs 闂?a recording can last arbitrarily long. An empty/omitted webhook keeps
    * the video on device (no upload).
    */
   stopVideoRecording(
@@ -1111,6 +1135,10 @@ export interface BluetoothSdkPublicModule {
   checkForOtaUpdate(): Promise<boolean>
   /** Start the OTA flow with the same configured manifest URL used by checkForOtaUpdate(). */
   startOtaUpdate(): Promise<OtaStartAckEvent>
+  startAr99OtaFromFile(path: string): Promise<boolean>
+  cancelAr99Ota(): Promise<void>
+  sendAr99FactoryReset(): Promise<void>
+  buildAr99OtaSignature(secret: string, appName: string, currentVersion: string, serialNumber: string, nonce: string): string
 
   // // stt commands (MOVE TO CRUST)
   // setSttModelDetails(path: string, languageCode: string): Promise<void>
@@ -1173,6 +1201,8 @@ export interface OtaUpdateInfo {
   updates: string[] // ["apk", "mtk", "bes"]
   totalSize: number
   cacheReady?: boolean
+  /** True when the APK step installs an older build than the glasses currently run (exact-pin manifests only). */
+  isDowngrade?: boolean
 }
 
 export interface OtaProgress {
@@ -1257,13 +1287,15 @@ 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.
+   * typed model, name, address, projectName, and rssi fields instead.
    */
   id: string
   model: DeviceModel
   name: string
   /** Platform address/identifier when available: Android Bluetooth address, iOS CoreBluetooth identifier. */
   address?: string
+  /** Optional AR99 project discriminator. Supported value: AR99. */
+  projectName?: string
   /**
    * Optional scan signal strength. It may be undefined at first discovery and
    * appear in a later scan update when the platform reports RSSI metadata.
@@ -1294,7 +1326,7 @@ export interface WifiSearchResult {
   ssid: string
   requiresPassword: boolean
   signalStrength: number
-  /** Frequency in MHz (from glasses scan). 5 GHz band is typically 5170–5825. Omitted if unknown. */
+  /** Frequency in MHz (from glasses scan). 5 GHz band is typically 5170闂?825. Omitted if unknown. */
   frequency?: number
 }
 
@@ -1347,6 +1379,7 @@ export type BluetoothSettingsUpdate = Partial<{
   twelve_hour_time: boolean
   gallery_mode: boolean
   voice_activity_detection_enabled: boolean
+  loudness_gate_enabled: boolean
   button_photo_size: ButtonPhotoSize
   button_video_settings: {width: number; height: number; fps: number}
   button_video_width: number

package/src/_internal.ts

@@ -11,3 +11,4 @@ export type {BluetoothSdkInternalModule} from "./_private/BluetoothSdkModule"
 export * from "./BluetoothSdk.types"
 export {default as MentraLocalNetwork} from "./_private/MentraLocalNetworkModule"
 export * from "./_private/MentraLocalNetworkModule"
+export {BLUETOOTH_SDK_VERSION, sdkPinnedOtaManifestUrl} from "./_private/sdkOtaManifest"

package/src/_private/BluetoothSdkModule.ts

@@ -125,9 +125,11 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   // Gallery Commands
   setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>
   setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>
+  /** Mentra Live center-mic loudness / Barrier gate (cs_swit type 10). */
+  setLoudnessGateEnabled(enabled: boolean): Promise<void>
   /**
    * @deprecated Sticky action-button photo presets are deprecated. Prefer per-request
-   * `requestPhoto(...)` options (e.g. `mode: "text"` for AE ÷3).
+   * `requestPhoto(...)` options (e.g. `mode: "text"` for text sensor size/crop).
    */
   setPhotoCaptureDefaults(settings: PhotoCaptureDefaults): Promise<SettingsAckSuccessEvent>
   setVideoRecordingDefaults(width: number, height: number, fps: number): Promise<SettingsAckSuccessEvent>
@@ -157,6 +159,10 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   checkForOtaUpdate(): Promise<boolean>
   startOtaUpdate(otaVersionUrl?: string | null): Promise<OtaStartAckEvent>
   sendOtaQueryStatus(): Promise<OtaQueryResult>
+  startAr99OtaFromFile(path: string): Promise<boolean>
+  cancelAr99Ota(): Promise<void>
+  sendAr99FactoryReset(): Promise<void>
+  buildAr99OtaSignature(secret: string, appName: string, currentVersion: string, serialNumber: string, nonce: string): string
 
   // Version Info Commands
   requestVersionInfo(): Promise<VersionInfoResult>
@@ -191,7 +197,7 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   setOwnAppAudioPlaying(playing: boolean): Promise<void>
 
   // Live PCM output stream (miniapp speaker.createStream). MentraOS-internal
-  // — 16-bit LE PCM chunks into a streaming AudioTrack (USAGE_MEDIA, so it
+  // ? 16-bit LE PCM chunks into a streaming AudioTrack (USAGE_MEDIA, so it
   // follows the phone's media route, e.g. A2DP to glasses). Implemented with
   // AudioTrack on Android and AVAudioEngine on iOS.
   /** Open a PCM stream session. One AudioTrack per id; caller manages ids. */
@@ -209,7 +215,7 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
 
   /** Mentra Live only: K900 `cs_getvol` / `sr_getvol`. */
   getGlassesMediaVolume(): Promise<GlassesMediaVolumeGetResult>
-  /** Mentra Live only: K900 `cs_vol` / `sr_vol`; level clamped 0–15 on native. */
+  /** Mentra Live only: K900 `cs_vol` / `sr_vol`; level clamped 0??5 on native. */
   setGlassesMediaVolume(level: number): Promise<GlassesMediaVolumeSetResult>
 
   // RGB LED Control
@@ -270,7 +276,7 @@ const DEFAULT_SCAN_TIMEOUT_MS = 15_000
 function bindNativeMethod<T extends (...args: never[]) => unknown>(module: Record<string, unknown>, name: string): T {
   const method = module[name]
   if (typeof method !== "function") {
-    console.warn(`[BluetoothSdk] Native method "${name}" is unavailable — rebuild the app (bun android / bun ios)`)
+    console.warn(`[BluetoothSdk] Native method "${name}" is unavailable ??rebuild the app (bun android / bun ios)`)
     return (async () => {
       throw new Error(`BluetoothSdk.${name} is not available in this native build. Rebuild the app.`)
     }) as T
@@ -287,10 +293,10 @@ const CAMERA_ROI_POSITION_VALUES: Record<CameraRoiPosition, CameraFovSetting["ro
 }
 
 // Named presets are a convenience layer over the numeric {fov, roiPosition} API.
-// "narrow" uses 82, a device-tested FOV; "standard" matches CAMERA_FOV_DEFAULT.
+// The default is the full sensor; "standard" preserves the historical 102� crop.
 const CAMERA_FOV_PRESETS: Record<CameraFovPreset, CameraFovSetting> = {
   narrow: {fov: 82, roiPosition: 0},
-  standard: {fov: CAMERA_FOV_DEFAULT, roiPosition: 0},
+  standard: {fov: 102, roiPosition: 0},
   wide: {fov: CAMERA_FOV_MAX, roiPosition: 0},
 }
 
@@ -486,6 +492,10 @@ NativeBluetoothSdkModule.setVoiceActivityDetectionEnabled = function (enabled: b
   return this.updateBluetoothSettings({voice_activity_detection_enabled: enabled})
 }
 
+NativeBluetoothSdkModule.setLoudnessGateEnabled = function (enabled: boolean) {
+  return this.updateBluetoothSettings({loudness_gate_enabled: enabled})
+}
+
 const nativeSetCameraFov = bindNativeMethod<(fov: CameraFovSetting) => MaybePromise<CameraFovResult>>(
   NativeBluetoothSdkModule as unknown as Record<string, unknown>,
   "setCameraFov",
@@ -639,3 +649,7 @@ NativeBluetoothSdkModule.warmUpCamera = function (params: WarmUpCameraParams) {
 
 export default NativeBluetoothSdkModule
 export const BluetoothSdk = NativeBluetoothSdkModule as BluetoothSdkInternalModule
+
+
+
+

package/src/_private/cameraRequestPayload.ts

@@ -9,8 +9,8 @@ function nonBlankString(value?: string | null): string | undefined {
 /** Expo Android bridge rejects null values in Map<String, Any> — omit optional nullish fields. */
 export function warmUpCameraParamsForNative(
   params: WarmUpCameraParams,
-): Record<string, string | number> {
-  const payload: Record<string, string | number> = {
+): Record<string, string | number | boolean> {
+  const payload: Record<string, string | number | boolean> = {
     size: normalizePhotoSizeTier(params.size),
     mode: params.mode ?? "photo",
   }
@@ -26,5 +26,11 @@ export function warmUpCameraParamsForNative(
   if (durationMs != null && Number.isFinite(durationMs) && durationMs > 0) {
     payload.durationMs = Math.round(durationMs)
   }
+  if (params.mfnr != null) {
+    payload.mfnr = params.mfnr
+  }
+  if (params.zsl != null) {
+    payload.zsl = params.zsl
+  }
   return payload
 }

package/src/_private/photoRequestPayload.ts

@@ -1,4 +1,14 @@
-import type {PhotoRequestParams, PhotoSize} from "../BluetoothSdk.types"
+import type {PhotoRequestParams, PhotoSize, PhotoTransferMethod} from "../BluetoothSdk.types"
+
+const PHOTO_TRANSFER_METHODS = new Set<PhotoTransferMethod>(["auto", "direct", "ble"])
+
+function photoTransferMethodForNative(value: unknown): PhotoTransferMethod {
+  if (value === undefined) return "auto"
+  if (typeof value === "string" && PHOTO_TRANSFER_METHODS.has(value as PhotoTransferMethod)) {
+    return value as PhotoTransferMethod
+  }
+  throw new TypeError(`Invalid transferMethod ${JSON.stringify(value)}. Expected "auto", "direct", or "ble".`)
+}
 
 /** Maps unknown/legacy size strings to the current wire format. */
 export function normalizePhotoSizeTier(size: string | undefined): PhotoSize {
@@ -29,7 +39,7 @@ export function photoRequestParamsForNative(params: PhotoRequestParams): Record<
   const payload: Record<string, string | number | boolean> = {
     size: normalizePhotoSizeTier(params.size),
     mode: params.mode ?? "photo",
-    transferMethod: params.transferMethod ?? "auto",
+    transferMethod: photoTransferMethodForNative(params.transferMethod),
     webhookUrl: params.webhookUrl ?? "",
     compress: params.compress,
     sound: params.sound,