@mentra/bluetooth-sdk 0.1.12 → 0.1.13

package/ios/Source/sgcs/MentraLive.swift

@@ -1234,6 +1234,9 @@ class MentraLive: NSObject, SGCManager {
     func getBatteryStatus() {}
     func setBrightness(_: Int, autoMode _: Bool) {}
     func clearDisplay() {}
+    func sendText(_ text: String) async {
+        await sendTextWall(text)
+    }
     func sendTextWall(_: String) async {}
     func ping() {
         Bridge.log("LIVE: ping()")
@@ -1611,18 +1614,15 @@ class MentraLive: NSObject, SGCManager {
         }
     }
 
-    func requestPhoto(
-        _ requestId: String, appId: String, size: String?, webhookUrl: String?, authToken: String?,
-        compress: String?, flash: Bool, save: Bool, sound: Bool, exposureTimeNs: Double?, iso: Int?
-    ) {
+    func requestPhoto(_ request: PhotoRequest) {
         Bridge.log(
-            "LIVE: PHOTO PIPELINE [5/6] requestPhoto() entry requestId=\(requestId) appId=\(appId) flash=\(flash) save=\(save) sound=\(sound) iso=\(iso.map { String($0) } ?? "auto")"
+            "LIVE: PHOTO PIPELINE [5/6] requestPhoto() entry requestId=\(request.requestId) appId=\(request.appId) flash=\(request.flash) save=\(request.save) sound=\(request.sound) iso=\(request.iso.map { String($0) } ?? "auto") aeDivisor=\(request.aeExposureDivisor.map { String($0) } ?? "nil")"
         )
 
         var json: [String: Any] = [
             "type": "take_photo",
-            "requestId": requestId,
-            "appId": appId,
+            "requestId": request.requestId,
+            "appId": request.appId,
         ]
 
         // Always generate BLE ID for potential fallback
@@ -1631,15 +1631,15 @@ class MentraLive: NSObject, SGCManager {
         json["bleImgId"] = bleImgId
         json["transferMethod"] = "auto"
 
-        if let webhookUrl, !webhookUrl.isEmpty {
+        if let webhookUrl = request.webhookUrl, !webhookUrl.isEmpty {
             json["webhookUrl"] = webhookUrl
 
             var transfer = BlePhotoTransfer(
-                bleImgId: bleImgId, requestId: requestId, webhookUrl: webhookUrl
+                bleImgId: bleImgId, requestId: request.requestId, webhookUrl: webhookUrl
             )
 
             // Store authToken for BLE transfer if provided
-            if let authToken, !authToken.isEmpty {
+            if let authToken = request.authToken, !authToken.isEmpty {
                 transfer.authToken = authToken
             }
 
@@ -1647,32 +1647,28 @@ class MentraLive: NSObject, SGCManager {
         }
 
         // Add authToken to JSON if provided
-        if let authToken, !authToken.isEmpty {
+        if let authToken = request.authToken, !authToken.isEmpty {
             json["authToken"] = authToken
         }
 
-        // propagate size (default to medium if invalid)
-        if let size, ["small", "medium", "large", "full"].contains(size) {
-            json["size"] = size
-        } else {
-            json["size"] = "medium"
-        }
-
-        // Add compress parameter
-        json["compress"] = compress ?? "none"
+        let allowedSizes = ["low", "medium", "high", "max"]
+        let size = request.size.rawValue
+        json["size"] = allowedSizes.contains(size) ? size : "medium"
 
-        json["flash"] = flash
-        json["save"] = save
-        json["sound"] = sound
+        json["compress"] = request.compress?.rawValue ?? "none"
+        json["flash"] = request.flash
+        json["save"] = request.save
+        json["sound"] = request.sound
 
-        if let e = exposureTimeNs, e.isFinite, e > 0, e <= Double(Int64.max) {
-            Bridge.log("LIVE: Using manual exposure time for photo request \(requestId): \(Int64(e)) ns")
+        if let e = request.exposureTimeNs, e.isFinite, e > 0, e <= Double(Int64.max) {
+            Bridge.log("LIVE: Using manual exposure time for photo request \(request.requestId): \(Int64(e)) ns")
             json["exposureTimeNs"] = Int64(e)
         }
-        if let iso, iso > 0 {
-            Bridge.log("LIVE: Using manual ISO for photo request \(requestId): ISO \(iso)")
+        if let iso = request.iso, iso > 0 {
+            Bridge.log("LIVE: Using manual ISO for photo request \(request.requestId): ISO \(iso)")
             json["iso"] = iso
         }
+        request.appendScanFields(to: &json)
 
         Bridge.log("LIVE: PHOTO PIPELINE [5b/6] take_photo JSON ready bleImgId=\(bleImgId) transferMethod=auto")
         Bridge.log("LIVE: PHOTO PIPELINE [6/6] Dispatching take_photo to sendJson()")
@@ -2883,13 +2879,17 @@ class MentraLive: NSObject, SGCManager {
     /// Send OTA start command to glasses.
     /// Called when user approves an update (onboarding or background mode).
     /// Triggers glasses to begin download and installation.
-    func sendOtaStart() {
+    func sendOtaStart(otaVersionUrl: String?) {
         Bridge.log("LIVE: 📱 Sending ota_start command to glasses")
 
-        let json: [String: Any] = [
+        var json: [String: Any] = [
             "type": "ota_start",
             "timestamp": Int(Date().timeIntervalSince1970 * 1000),
         ]
+        if let otaVersionUrl = otaVersionUrl?.trimmingCharacters(in: .whitespacesAndNewlines),
+           !otaVersionUrl.isEmpty {
+            json["ota_version_url"] = otaVersionUrl
+        }
 
         sendJson(json, wakeUp: true)
     }
@@ -5197,12 +5197,73 @@ extension MentraLive {
     }
 
     func sendButtonPhotoSettings() {
-        let size = DeviceStore.shared.get("bluetooth", "button_photo_size") as! String
-        sendButtonPhotoSettings(requestId: nil, size: size)
+        let size = DeviceStore.shared.get("bluetooth", "button_photo_size") as? String
+        let mfnr = DeviceStore.shared.get("bluetooth", "button_photo_mfnr") as? Bool
+        let zsl = DeviceStore.shared.get("bluetooth", "button_photo_zsl") as? Bool
+        let noiseReduction = DeviceStore.shared.get("bluetooth", "button_photo_noise_reduction") as? Bool
+        let edgeEnhancement = DeviceStore.shared.get("bluetooth", "button_photo_edge_enhancement") as? Bool
+        let ispDigitalGain = DeviceStore.shared.get("bluetooth", "button_photo_isp_digital_gain") as? Int
+        let ispAnalogGain = DeviceStore.shared.get("bluetooth", "button_photo_isp_analog_gain") as? String
+        let aeExposureDivisor = DeviceStore.shared.get("bluetooth", "button_photo_ae_exposure_divisor") as? Int
+        let isoCap = DeviceStore.shared.get("bluetooth", "button_photo_iso_cap") as? Int
+        let compressStr = DeviceStore.shared.get("bluetooth", "button_photo_compress") as? String
+        let sound = DeviceStore.shared.get("bluetooth", "button_photo_sound") as? Bool
+
+        let settings = ButtonPhotoSettings(
+            size: ButtonPhotoSize(normalizedRawValue: size ?? "medium"),
+            mfnr: mfnr,
+            zsl: zsl,
+            noiseReduction: noiseReduction,
+            edgeEnhancement: edgeEnhancement,
+            ispDigitalGain: ispDigitalGain,
+            ispAnalogGain: ispAnalogGain,
+            aeExposureDivisor: aeExposureDivisor,
+            isoCap: isoCap,
+            compress: compressStr,
+            sound: sound,
+            resetCaptureTuning: false
+        )
+
+        sendButtonPhotoSettings(requestId: nil, settings: settings)
     }
 
     func sendButtonPhotoSettings(requestId: String?, size: String) {
-        Bridge.log("Sending button photo setting: \(size)")
+        sendButtonPhotoSettings(requestId: requestId, settings: ButtonPhotoSettings(size: ButtonPhotoSize(normalizedRawValue: size)))
+    }
+
+    func sendButtonPhotoSettings(requestId: String?, settings: ButtonPhotoSettings) {
+        var details = settings.size.map { "size=\($0.rawValue)" } ?? "size=unchanged"
+        if let mfnr = settings.mfnr {
+            details += ", mfnr=\(mfnr)"
+        }
+        if let zsl = settings.zsl {
+            details += ", zsl=\(zsl)"
+        }
+        if let noiseReduction = settings.noiseReduction {
+            details += ", noiseReduction=\(noiseReduction)"
+        }
+        if let edgeEnhancement = settings.edgeEnhancement {
+            details += ", edgeEnhancement=\(edgeEnhancement)"
+        }
+        if let ispDigitalGain = settings.ispDigitalGain {
+            details += ", ispDigitalGain=\(ispDigitalGain)"
+        }
+        if let ispAnalogGain = settings.ispAnalogGain {
+            details += ", ispAnalogGain=\(ispAnalogGain)"
+        }
+        if let aeExposureDivisor = settings.aeExposureDivisor {
+            details += ", aeExposureDivisor=\(aeExposureDivisor)"
+        }
+        if let isoCap = settings.isoCap {
+            details += ", isoCap=\(isoCap)"
+        }
+        if let compress = settings.compress {
+            details += ", compress=\(compress)"
+        }
+        if let sound = settings.sound {
+            details += ", sound=\(sound)"
+        }
+        Bridge.log("Sending button photo setting: \(details)")
 
         guard connectionState == ConnTypes.CONNECTED else {
             Bridge.log("Cannot send button photo settings - not connected")
@@ -5211,11 +5272,46 @@ extension MentraLive {
 
         var json: [String: Any] = [
             "type": "button_photo_setting",
-            "size": size,
         ]
+        if let size = settings.size {
+            json["size"] = size.rawValue
+        }
         if let requestId, !requestId.isEmpty {
             json["request_id"] = requestId
         }
+        if let mfnr = settings.mfnr {
+            json["mfnr"] = mfnr
+        }
+        if let zsl = settings.zsl {
+            json["zsl"] = zsl
+        }
+        if let noiseReduction = settings.noiseReduction {
+            json["noiseReduction"] = noiseReduction
+        }
+        if let edgeEnhancement = settings.edgeEnhancement {
+            json["edgeEnhancement"] = edgeEnhancement
+        }
+        if let ispDigitalGain = settings.ispDigitalGain {
+            json["ispDigitalGain"] = ispDigitalGain
+        }
+        if let ispAnalogGain = settings.ispAnalogGain, !ispAnalogGain.isEmpty {
+            json["ispAnalogGain"] = ispAnalogGain
+        }
+        if let aeExposureDivisor = settings.aeExposureDivisor, aeExposureDivisor > 1 {
+            json["aeExposureDivisor"] = aeExposureDivisor
+        }
+        if let isoCap = settings.isoCap, isoCap > 0 {
+            json["isoCap"] = isoCap
+        }
+        if let compress = settings.compress, !compress.isEmpty {
+            json["compress"] = compress
+        }
+        if let sound = settings.sound {
+            json["sound"] = sound
+        }
+        if settings.resetCaptureTuning == true {
+            json["resetCaptureTuning"] = true
+        }
         sendJson(json, wakeUp: true)
     }
 

package/ios/Source/sgcs/MentraNex.swift

@@ -51,10 +51,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         }
     }
 
-    func requestPhoto(
-        _: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?,
-        compress _: String?, flash _: Bool, save _: Bool, sound _: Bool, exposureTimeNs _: Double?, iso _: Int?
-    ) {}
+    func requestPhoto(_: PhotoRequest) {}
 
     func startStream(_: [String: Any]) {}
 
@@ -81,6 +78,10 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         updateGlassesAutoBrightness(autoMode)
     }
 
+    func sendText(_ text: String) async {
+        await sendTextWall(text)
+    }
+
     func sendDoubleTextWall(_ top: String, _ bottom: String) async {
         await sendTextWall("\(top)\n\(bottom)")
     }
@@ -178,7 +179,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
     func sendHotspotState(_: Bool) {}
 
-    func sendOtaStart() {}
+    func sendOtaStart(otaVersionUrl: String?) {}
     func sendOtaQueryStatus() {}
 
     func sendUserEmailToGlasses(_: String) {}

package/ios/Source/sgcs/SGCManager.swift

@@ -18,10 +18,7 @@ protocol SGCManager {
 
     // MARK: - Camera & Media
 
-    func requestPhoto(
-        _ requestId: String, appId: String, size: String?, webhookUrl: String?, authToken: String?,
-        compress: String?, flash: Bool, save: Bool, sound: Bool, exposureTimeNs: Double?, iso: Int?
-    )
+    func requestPhoto(_ request: PhotoRequest)
     func startStream(_ message: [String: Any])
     func stopStream()
     func sendStreamKeepAlive(_ message: [String: Any])
@@ -54,6 +51,7 @@ protocol SGCManager {
 
     func setBrightness(_ level: Int, autoMode: Bool)
     func clearDisplay()
+    func sendText(_ text: String) async
     func sendTextWall(_ text: String) async
     func sendDoubleTextWall(_ top: String, _ bottom: String) async
     /// Display a bitmap. Optional `x`/`y`/`width`/`height` position and size the target
@@ -118,7 +116,7 @@ protocol SGCManager {
     func sendWifiCredentials(_ ssid: String, _ password: String)
     func forgetWifiNetwork(_ ssid: String)
     func sendHotspotState(_ enabled: Bool)
-    func sendOtaStart()
+    func sendOtaStart(otaVersionUrl: String?)
     func sendOtaQueryStatus()
     func sendSetSystemTime(_ timestampMs: Int64)
     func sendOtaRetryVersionCheck()

package/ios/Source/sgcs/Simulated.swift

@@ -79,8 +79,8 @@ class Simulated: SGCManager {
 
     // MARK: - Camera & Media
 
-    func requestPhoto(_: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?, compress _: String?, flash _: Bool, save _: Bool, sound _: Bool, exposureTimeNs _: Double?, iso _: Int?) {
-        Bridge.log("requestPhoto")
+    func requestPhoto(_ request: PhotoRequest) {
+        Bridge.log("requestPhoto flash=\(request.flash) save=\(request.save) sound=\(request.sound)")
     }
 
     func startStream(_: [String: Any]) {
@@ -133,6 +133,10 @@ class Simulated: SGCManager {
         Bridge.log("clearDisplay")
     }
 
+    func sendText(_ text: String) async {
+        await sendTextWall(text)
+    }
+
     func sendTextWall(_: String) async {
         Bridge.log("sendTextWall")
     }
@@ -246,7 +250,7 @@ class Simulated: SGCManager {
         Bridge.log("sendUserEmailToGlasses: \(email)")
     }
 
-    func sendOtaStart() {
+    func sendOtaStart(otaVersionUrl: String?) {
         Bridge.log("sendOtaStart")
     }
 

package/ios/Source/status/DeviceStatus.swift

@@ -921,7 +921,7 @@ struct BluetoothStatusUpdate: CustomStringConvertible {
     }
 
     var buttonPhotoSize: ButtonPhotoSize? {
-        optionalStringValue(values, "button_photo_size").flatMap(ButtonPhotoSize.init(rawValue:))
+        optionalStringValue(values, "button_photo_size").map { ButtonPhotoSize(normalizedRawValue: $0) }
     }
 
     var buttonCameraLed: Bool? {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -22,6 +22,11 @@
       "react-native": "./src/photo-receiver/index.ts",
       "default": "./build/photo-receiver/index.js"
     },
+    "./debug": {
+      "types": "./build/debug.d.ts",
+      "react-native": "./src/debug.ts",
+      "default": "./build/debug.js"
+    },
     "./_private/*": null,
     "./build/*": null,
     "./src/*": null,

package/src/BluetoothSdk.types.ts

@@ -248,6 +248,13 @@ export type PhotoCaptureMetadata = {
   sensorTimestampNs?: number
   totalLightProxy?: number
   mfnrLikely?: boolean
+  mfnrApplied?: boolean
+  width?: number
+  height?: number
+  noiseReductionWarning?: "not_implemented" | string
+  ispDigitalGainWarning?: "not_implemented" | string
+  ispAnalogGainWarning?: "not_implemented" | string
+  [key: string]: unknown
 }
 
 export type PhotoStatusEvent = {
@@ -421,8 +428,24 @@ export type SettingsAckSuccessEvent = Omit<SettingsAckEvent, "status"> & {
 
 export type RgbLedAction = "on" | "off"
 export type RgbLedColor = "red" | "green" | "blue" | "orange" | "white"
-export type PhotoSize = "small" | "medium" | "large" | "full"
-export type ButtonPhotoSize = "small" | "medium" | "large" | "max"
+export type PhotoSize = "low" | "medium" | "high" | "max"
+export type ButtonPhotoSize = "low" | "medium" | "high" | "max"
+
+export type ButtonPhotoSettings = {
+  size: ButtonPhotoSize
+  mfnr?: boolean
+  zsl?: boolean
+  noiseReduction?: boolean
+  edgeEnhancement?: boolean
+  ispDigitalGain?: number
+  ispAnalogGain?: string
+  aeExposureDivisor?: number
+  isoCap?: number
+  compress?: PhotoCompression
+  sound?: boolean
+  /** When true, clears stored NR/edge/ISP presets on the glasses before applying other fields. */
+  resetCaptureTuning?: boolean
+}
 export type PhotoCompression = "none" | "medium" | "heavy"
 
 /**
@@ -511,6 +534,17 @@ export type PhotoRequestParams = {
   exposureTimeNs?: number | null
   /** Sensor ISO for this capture only. Only used when exposureTimeNs enables manual exposure. */
   iso?: number | null
+  /** After AE convergence, divide metered exposure by this factor (scan mode). */
+  aeExposureDivisor?: number
+  /** Cap ISO after AE metering (scan mode). */
+  isoCap?: number
+  /** Requested on wire; glasses may log not_implemented. */
+  noiseReduction?: boolean
+  edgeEnhancement?: boolean
+  mfnr?: boolean
+  zsl?: boolean
+  ispDigitalGain?: number
+  ispAnalogGain?: string
 }
 
 export type StreamVideoConfig = {
@@ -859,7 +893,6 @@ export type BluetoothSdkEventMap = {
   mic_pcm: MicPcmEvent
   mic_lc3: MicLc3Event
   stream_status: StreamStatusEvent
-  ota_update_available: OtaUpdateAvailableEvent
   ota_start_ack: OtaStartAckEvent
   ota_status: OtaStatusEvent
   version_info: VersionInfoEvent
@@ -913,7 +946,7 @@ export interface BluetoothSdkPublicModule {
 
   setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>
   setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>
-  setButtonPhotoSettings(size: ButtonPhotoSize): Promise<SettingsAckSuccessEvent>
+  setButtonPhotoSettings(settings: ButtonPhotoSettings): Promise<SettingsAckSuccessEvent>
   setButtonVideoRecordingSettings(width: number, height: number, fps: number): Promise<SettingsAckSuccessEvent>
   setButtonCameraLed(enabled: boolean): Promise<SettingsAckSuccessEvent>
   setButtonMaxRecordingTime(minutes: number): Promise<SettingsAckSuccessEvent>
@@ -959,12 +992,10 @@ export interface BluetoothSdkPublicModule {
   ): Promise<RgbLedControlSuccessResponseEvent>
 
   requestVersionInfo(): Promise<VersionInfoResult>
-  /** Ask connected Mentra Live glasses to check/report OTA availability and status. */
-  checkForOtaUpdate(): Promise<OtaQueryResult>
-  /** Start the OTA flow after your app has presented the available update to the user. */
+  /** Fetch the configured OTA manifest and return whether any ASG/BES/MTK update is available. */
+  checkForOtaUpdate(): Promise<boolean>
+  /** Start the OTA flow with the same configured manifest URL used by checkForOtaUpdate(). */
   startOtaUpdate(): Promise<OtaStartAckEvent>
-  /** Re-run the glasses-side OTA version check, mainly after correcting clock skew/TLS failures. */
-  retryOtaVersionCheck(): Promise<OtaQueryResult>
 
   // // stt commands (MOVE TO CRUST)
   // setSttModelDetails(path: string, languageCode: string): Promise<void>

package/src/_private/BluetoothSdkModule.ts

@@ -2,10 +2,9 @@ import {NativeModule, requireNativeModule} from "expo"
 
 import {
   BluetoothSettingsUpdate,
-  BluetoothSdkPublicModule,
   BluetoothSdkModuleEvents,
   BluetoothStatus,
-  ButtonPhotoSize,
+  ButtonPhotoSettings,
   CalendarEvent,
   CAMERA_FOV_DEFAULT,
   CAMERA_FOV_MAX,
@@ -122,7 +121,8 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   // Gallery Commands
   setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>
   setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>
-  setButtonPhotoSettings(size: ButtonPhotoSize): Promise<SettingsAckSuccessEvent>
+  setButtonPhotoSettings(settings: ButtonPhotoSettings): Promise<SettingsAckSuccessEvent>
+  setButtonPhotoCaptureSettings(settings: ButtonPhotoSettings): Promise<SettingsAckSuccessEvent>
   setButtonVideoRecordingSettings(width: number, height: number, fps: number): Promise<SettingsAckSuccessEvent>
   setButtonCameraLed(enabled: boolean): Promise<SettingsAckSuccessEvent>
   setButtonMaxRecordingTime(minutes: number): Promise<SettingsAckSuccessEvent>
@@ -131,12 +131,13 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   requestPhoto(params: PhotoRequestParams): Promise<PhotoSuccessResponseEvent>
 
   // OTA Commands
-  sendOtaStart(): Promise<OtaStartAckEvent>
+  setOtaVersionUrl(otaVersionUrl: string): void
+  getOtaVersionUrl(): string
+  checkForOtaUpdate(): Promise<boolean>
+  startOtaUpdate(otaVersionUrl?: string | null): Promise<OtaStartAckEvent>
   sendOtaQueryStatus(): Promise<OtaQueryResult>
   /** Re-run glasses-side OTA version check (called after a clock fix invalidates a TLS failure). */
   retryOtaVersionCheck(): Promise<OtaQueryResult>
-  checkForOtaUpdate(): Promise<OtaQueryResult>
-  startOtaUpdate(): Promise<OtaStartAckEvent>
 
   // Version Info Commands
   requestVersionInfo(): Promise<VersionInfoResult>
@@ -571,8 +572,6 @@ const nativeStartStream = NativeBluetoothSdkModule.startStream.bind(NativeBlueto
 NativeBluetoothSdkModule.startExternallyManagedStream = function (params: StreamStartRequest) {
   return nativeStartStream({...params, keepAliveMode: "external"} as StreamStartRequest)
 }
-NativeBluetoothSdkModule.checkForOtaUpdate = NativeBluetoothSdkModule.sendOtaQueryStatus.bind(NativeBluetoothSdkModule)
-NativeBluetoothSdkModule.startOtaUpdate = NativeBluetoothSdkModule.sendOtaStart.bind(NativeBluetoothSdkModule)
 
 export default NativeBluetoothSdkModule
-export const BluetoothSdk = NativeBluetoothSdkModule as BluetoothSdkPublicModule
+export const BluetoothSdk = NativeBluetoothSdkModule as BluetoothSdkInternalModule

package/src/_private/photoRequestPayload.ts

@@ -1,4 +1,23 @@
-import type {PhotoRequestParams} from "../BluetoothSdk.types"
+import type {PhotoRequestParams, PhotoSize} from "../BluetoothSdk.types"
+
+/** Maps unknown/legacy size strings to the current wire format. */
+export function normalizePhotoSizeTier(size: string | undefined): PhotoSize {
+  switch (size) {
+    case "small":
+      return "low"
+    case "large":
+      return "high"
+    case "full":
+      return "max"
+    case "low":
+    case "medium":
+    case "high":
+    case "max":
+      return size
+    default:
+      return "medium"
+  }
+}
 
 /** Expo Android bridge rejects null values in Map<String, Any> — omit optional nullish fields. */
 export function photoRequestParamsForNative(
@@ -7,7 +26,7 @@ export function photoRequestParamsForNative(
   const payload: Record<string, string | number | boolean> = {
     requestId: params.requestId,
     appId: params.appId,
-    size: params.size,
+    size: normalizePhotoSizeTier(params.size),
     webhookUrl: params.webhookUrl ?? "",
     compress: params.compress,
     flash: true,
@@ -24,5 +43,29 @@ export function photoRequestParamsForNative(
   if (hasManualExposure && params.iso != null && Number.isFinite(params.iso) && params.iso > 0) {
     payload.iso = Math.round(params.iso)
   }
+  if (params.aeExposureDivisor != null && params.aeExposureDivisor > 1) {
+    payload.aeExposureDivisor = Math.round(params.aeExposureDivisor)
+  }
+  if (params.isoCap != null && params.isoCap > 0) {
+    payload.isoCap = Math.round(params.isoCap)
+  }
+  if (params.noiseReduction != null) {
+    payload.noiseReduction = params.noiseReduction
+  }
+  if (params.edgeEnhancement != null) {
+    payload.edgeEnhancement = params.edgeEnhancement
+  }
+  if (params.mfnr != null) {
+    payload.mfnr = params.mfnr
+  }
+  if (params.zsl != null) {
+    payload.zsl = params.zsl
+  }
+  if (params.ispDigitalGain != null) {
+    payload.ispDigitalGain = Math.round(params.ispDigitalGain)
+  }
+  if (params.ispAnalogGain != null && params.ispAnalogGain.length > 0) {
+    payload.ispAnalogGain = params.ispAnalogGain
+  }
   return payload
 }

package/src/debug.ts

@@ -0,0 +1,9 @@
+import PrivateBluetoothSdkModule from "./_private/BluetoothSdkModule"
+
+export function setOtaVersionUrl(otaVersionUrl: string): void {
+  PrivateBluetoothSdkModule.setOtaVersionUrl(otaVersionUrl)
+}
+
+export function getOtaVersionUrl(): string {
+  return PrivateBluetoothSdkModule.getOtaVersionUrl()
+}

package/src/index.ts

@@ -1,5 +1,10 @@
 import PrivateBluetoothSdkModule from "./_private/BluetoothSdkModule"
-import type {BluetoothSdkEventListener, BluetoothSdkEventName, BluetoothSdkPublicModule} from "./BluetoothSdk.types"
+import type {
+  BluetoothSdkEventListener,
+  BluetoothSdkEventName,
+  BluetoothSdkPublicModule,
+  ButtonPhotoSettings,
+} from "./BluetoothSdk.types"
 
 const PUBLIC_EVENT_NAMES = new Set<BluetoothSdkEventName>([
   "log",
@@ -36,7 +41,6 @@ const PUBLIC_EVENT_NAMES = new Set<BluetoothSdkEventName>([
   "mic_pcm",
   "mic_lc3",
   "stream_status",
-  "ota_update_available",
   "ota_start_ack",
   "ota_status",
   "version_info",
@@ -50,6 +54,10 @@ const addListener: BluetoothSdkPublicModule["addListener"] = (eventName, listene
   return PrivateBluetoothSdkModule.addListener(eventName, listener as BluetoothSdkEventListener<BluetoothSdkEventName>)
 }
 
+const startOtaUpdate: BluetoothSdkPublicModule["startOtaUpdate"] = () => {
+  return PrivateBluetoothSdkModule.startOtaUpdate()
+}
+
 export const BluetoothSdk: BluetoothSdkPublicModule = Object.freeze({
   addListener,
   getDefaultDevice: PrivateBluetoothSdkModule.getDefaultDevice.bind(PrivateBluetoothSdkModule),
@@ -77,7 +85,15 @@ export const BluetoothSdk: BluetoothSdkPublicModule = Object.freeze({
   setGalleryModeEnabled: PrivateBluetoothSdkModule.setGalleryModeEnabled.bind(PrivateBluetoothSdkModule),
   setVoiceActivityDetectionEnabled:
     PrivateBluetoothSdkModule.setVoiceActivityDetectionEnabled.bind(PrivateBluetoothSdkModule),
-  setButtonPhotoSettings: PrivateBluetoothSdkModule.setButtonPhotoSettings.bind(PrivateBluetoothSdkModule),
+  setButtonPhotoSettings: (settings: ButtonPhotoSettings) => {
+    // setButtonPhotoCaptureSettings is available in SDK 0.1.13+. Guard for OTA version-skew
+    // where a new JS bundle runs against an older native module that only has the string form.
+    if (typeof PrivateBluetoothSdkModule.setButtonPhotoCaptureSettings === "function") {
+      return PrivateBluetoothSdkModule.setButtonPhotoCaptureSettings(settings)
+    }
+    // Legacy fallback: old native bridge only accepts a size string
+    return PrivateBluetoothSdkModule.setButtonPhotoSettings({size: settings.size ?? "max"} as any)
+  },
   setButtonVideoRecordingSettings:
     PrivateBluetoothSdkModule.setButtonVideoRecordingSettings.bind(PrivateBluetoothSdkModule),
   setButtonCameraLed: PrivateBluetoothSdkModule.setButtonCameraLed.bind(PrivateBluetoothSdkModule),
@@ -96,9 +112,8 @@ export const BluetoothSdk: BluetoothSdkPublicModule = Object.freeze({
   setGlassesMediaVolume: PrivateBluetoothSdkModule.setGlassesMediaVolume.bind(PrivateBluetoothSdkModule),
   rgbLedControl: PrivateBluetoothSdkModule.rgbLedControl.bind(PrivateBluetoothSdkModule),
   requestVersionInfo: PrivateBluetoothSdkModule.requestVersionInfo.bind(PrivateBluetoothSdkModule),
-  checkForOtaUpdate: PrivateBluetoothSdkModule.sendOtaQueryStatus.bind(PrivateBluetoothSdkModule),
-  startOtaUpdate: PrivateBluetoothSdkModule.sendOtaStart.bind(PrivateBluetoothSdkModule),
-  retryOtaVersionCheck: PrivateBluetoothSdkModule.retryOtaVersionCheck.bind(PrivateBluetoothSdkModule),
+  checkForOtaUpdate: PrivateBluetoothSdkModule.checkForOtaUpdate.bind(PrivateBluetoothSdkModule),
+  startOtaUpdate,
   setSttModelDetails: PrivateBluetoothSdkModule.setSttModelDetails.bind(PrivateBluetoothSdkModule),
   getSttModelPath: PrivateBluetoothSdkModule.getSttModelPath.bind(PrivateBluetoothSdkModule),
   checkSttModelAvailable: PrivateBluetoothSdkModule.checkSttModelAvailable.bind(PrivateBluetoothSdkModule),
@@ -140,6 +155,7 @@ export type {
   BluetoothSdkPublicModule as BluetoothSdkModule,
   BluetoothSdkSubscription,
   ButtonPhotoSize,
+  ButtonPhotoSettings,
   ButtonPressEvent,
   CameraFovPreset,
   CameraFovRequest,
@@ -181,6 +197,7 @@ export type {
   PhotoMeteredPreview,
   PhotoResponseEvent,
   PhotoRequestedCaptureConfig,
+  PhotoRequestParams,
   PhotoSize,
   PhotoStatusEvent,
   PhotoStatusState,