@mentra/bluetooth-sdk 0.1.11 → 0.1.13

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])
@@ -31,9 +28,16 @@ protocol SGCManager {
     /// Defaulted in an extension to delegate to the basic recording path; devices
     /// that support custom settings (e.g. Mentra Live) override this.
     func startVideoRecording(
-        requestId: String, save: Bool, flash: Bool, sound: Bool, width: Int, height: Int, fps: Int
+        requestId: String, save: Bool, flash: Bool, sound: Bool, width: Int, height: Int, fps: Int,
+        maxRecordingTimeMinutes: Int
     )
     func stopVideoRecording(requestId: String)
+    /// Stop recording and upload the result to `webhookUrl` (multipart) using
+    /// `authToken`. Supplied at stop time so the token is fresh when the upload
+    /// runs. Defaulted in an extension to ignore the upload target and just stop;
+    /// devices that support webhook upload (e.g. Mentra Live) override this. An
+    /// empty/nil `webhookUrl` means "keep the video on device".
+    func stopVideoRecording(requestId: String, webhookUrl: String?, authToken: String?)
 
     // MARK: - Button Settings
 
@@ -47,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
@@ -111,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()
@@ -145,11 +150,15 @@ extension SGCManager {
 
     func startVideoRecording(
         requestId: String, save: Bool, flash: Bool, sound: Bool, width _: Int, height _: Int,
-        fps _: Int
+        fps _: Int, maxRecordingTimeMinutes _: Int
     ) {
         startVideoRecording(requestId: requestId, save: save, flash: flash, sound: sound)
     }
 
+    func stopVideoRecording(requestId: String, webhookUrl _: String?, authToken _: String?) {
+        stopVideoRecording(requestId: requestId)
+    }
+
     // MARK: - Dashboard (default: combined wire format; Nex implements single-field)
 
     func setDashboardHeightOnly(_ height: Int) {

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/ios/Source/types/DeviceModels.swift

@@ -3,7 +3,11 @@ import Foundation
 public struct MentraBluetoothSDKConfiguration {
     public static let `default` = MentraBluetoothSDKConfiguration()
 
-    public init() {}
+    public let analytics: BluetoothSdkAnalyticsConfiguration
+
+    public init(analytics: BluetoothSdkAnalyticsConfiguration = BluetoothSdkAnalyticsConfiguration()) {
+        self.analytics = analytics
+    }
 }
 
 public enum DeviceModel: String {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "0.1.11",
+  "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/plugin/build/index.d.ts

@@ -1,6 +1,10 @@
 import { type ConfigPlugin } from "expo/config-plugins";
 export interface BluetoothSdkPluginProps {
     node?: boolean;
+    analytics?: boolean | BluetoothSdkAnalyticsPluginProps;
+}
+export interface BluetoothSdkAnalyticsPluginProps {
+    enabled?: boolean;
 }
 declare const withBluetoothSdk: ConfigPlugin<BluetoothSdkPluginProps>;
 export default withBluetoothSdk;

package/plugin/build/withAndroid.d.ts

@@ -1,4 +1,3 @@
 import { type ConfigPlugin } from "expo/config-plugins";
-export declare const withAndroidConfiguration: ConfigPlugin<{
-    node?: boolean;
-}>;
+import { type BluetoothSdkPluginProps } from "./index";
+export declare const withAndroidConfiguration: ConfigPlugin<BluetoothSdkPluginProps>;

package/plugin/build/withAndroid.js

@@ -7,6 +7,10 @@ exports.withAndroidConfiguration = void 0;
 const child_process_1 = require("child_process");
 const path_1 = __importDefault(require("path"));
 const config_plugins_1 = require("expo/config-plugins");
+const META_ANALYTICS_DISABLED = "com.mentra.bluetoothsdk.analytics.disabled";
+const STALE_META_POSTHOG_API_KEY = "com.mentra.bluetoothsdk.analytics.posthog_api_key";
+const STALE_META_POSTHOG_HOST = "com.mentra.bluetoothsdk.analytics.posthog_host";
+const ANALYTICS_META_NAMES = [META_ANALYTICS_DISABLED, STALE_META_POSTHOG_API_KEY, STALE_META_POSTHOG_HOST];
 function getBluetoothSdkRoot() {
     return path_1.default.dirname(require.resolve("../../package.json"));
 }
@@ -133,9 +137,51 @@ function withSherpaOnnxLocalMavenRepo(config) {
         return config;
     });
 }
+function resolveAnalyticsProps(props) {
+    const analytics = props?.analytics;
+    let disabled;
+    if (analytics === false) {
+        disabled = true;
+    }
+    else if (analytics === true) {
+        disabled = false;
+    }
+    else if (typeof analytics === "object" && analytics.enabled !== undefined) {
+        disabled = !analytics.enabled;
+    }
+    return {
+        disabled,
+    };
+}
+function upsertMetaData(application, name, value) {
+    application["meta-data"] ??= [];
+    const existing = application["meta-data"].find((item) => item.$?.["android:name"] === name);
+    const entry = existing ?? { $: { "android:name": name } };
+    entry.$["android:value"] = value;
+    if (!existing) {
+        application["meta-data"].push(entry);
+    }
+}
+function removeMetaData(application, name) {
+    application["meta-data"] = (application["meta-data"] ?? []).filter((item) => item.$?.["android:name"] !== name);
+}
+function withAnalyticsManifestMetadata(config, props) {
+    return (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+        const analytics = resolveAnalyticsProps(props);
+        const application = config_plugins_1.AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults);
+        for (const name of ANALYTICS_META_NAMES) {
+            removeMetaData(application, name);
+        }
+        if (analytics.disabled !== undefined) {
+            upsertMetaData(application, META_ANALYTICS_DISABLED, analytics.disabled ? "true" : "false");
+        }
+        return config;
+    });
+}
 const withAndroidConfiguration = (config, props) => {
     config = withSettingsGradleModifications(config);
     config = withSherpaOnnxLocalMavenRepo(config);
+    config = withAnalyticsManifestMetadata(config, props);
     if (props?.node) {
         config = withGradlePropertiesModifications(config);
     }

package/plugin/build/withIos.d.ts

@@ -1,4 +1,3 @@
 import { type ConfigPlugin } from "expo/config-plugins";
-export declare const withIosConfiguration: ConfigPlugin<{
-    node?: boolean;
-}>;
+import { type BluetoothSdkPluginProps } from "./index";
+export declare const withIosConfiguration: ConfigPlugin<BluetoothSdkPluginProps>;

package/plugin/build/withIos.js

@@ -10,6 +10,9 @@ const path_1 = __importDefault(require("path"));
 const config_plugins_1 = require("expo/config-plugins");
 const BLUETOOTH_SDK_EXPO_ADAPTER_ENV = "MENTRA_BLUETOOTH_SDK_INCLUDE_EXPO_ADAPTER";
 const BLUETOOTH_SDK_EXPO_ADAPTER_LINE = `ENV['${BLUETOOTH_SDK_EXPO_ADAPTER_ENV}'] ||= '1'`;
+const INFO_ANALYTICS_DISABLED = "MentraBluetoothSdkAnalyticsDisabled";
+const STALE_INFO_POSTHOG_API_KEY = "MentraBluetoothSdkPostHogApiKey";
+const STALE_INFO_POSTHOG_HOST = "MentraBluetoothSdkPostHogHost";
 const ensureBluetoothSdkExpoAdapterPodEnv = (podfile) => {
     if (podfile.includes(BLUETOOTH_SDK_EXPO_ADAPTER_ENV)) {
         return podfile;
@@ -51,11 +54,40 @@ const withXcodeEnvLocal = (config) => {
         },
     ]);
 };
+function resolveAnalyticsProps(props) {
+    const analytics = props?.analytics;
+    let disabled;
+    if (analytics === false) {
+        disabled = true;
+    }
+    else if (analytics === true) {
+        disabled = false;
+    }
+    else if (typeof analytics === "object" && analytics.enabled !== undefined) {
+        disabled = !analytics.enabled;
+    }
+    return {
+        disabled,
+    };
+}
+function withAnalyticsInfoPlist(config, props) {
+    return (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        const analytics = resolveAnalyticsProps(props);
+        delete config.modResults[INFO_ANALYTICS_DISABLED];
+        delete config.modResults[STALE_INFO_POSTHOG_API_KEY];
+        delete config.modResults[STALE_INFO_POSTHOG_HOST];
+        if (analytics.disabled !== undefined) {
+            config.modResults[INFO_ANALYTICS_DISABLED] = analytics.disabled;
+        }
+        return config;
+    });
+}
 const withIosConfiguration = (config, props) => {
     config = (0, config_plugins_1.withPodfile)(config, (config) => {
         config.modResults.contents = ensureBluetoothSdkExpoAdapterPodEnv(config.modResults.contents);
         return config;
     });
+    config = withAnalyticsInfoPlist(config, props);
     if (props?.node) {
         config = withXcodeEnvLocal(config);
     }

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 = {
@@ -307,6 +314,24 @@ export type VideoRecordingSuccessStatusEvent =
   | VideoRecordingStartedStatusEvent
   | VideoRecordingStoppedStatusEvent
 
+export type MediaUploadSuccessEvent = {
+  type: "media_success"
+  requestId: string
+  mediaUrl: string
+  mediaType: number
+  timestamp: number
+}
+
+export type MediaUploadErrorEvent = {
+  type: "media_error"
+  requestId: string
+  errorMessage: string
+  mediaType: number
+  timestamp: number
+}
+
+export type MediaUploadEvent = MediaUploadSuccessEvent | MediaUploadErrorEvent
+
 export type GalleryStatusEvent = {
   type: "gallery_status"
   photos: number
@@ -403,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"
 
 /**
@@ -416,6 +457,12 @@ export interface VideoRecordingSettings {
   width?: number
   height?: number
   fps?: number
+  /**
+   * Optional auto-stop timer in minutes, sent on `start_video_recording`.
+   * `0` (the default) means record until stopped or interrupted
+   * (battery/storage/thermal/error).
+   */
+  maxRecordingTimeMinutes?: number
 }
 export const DeviceModels = {
   Simulated: "Simulated Glasses",
@@ -487,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 = {
@@ -743,6 +801,8 @@ export type BluetoothSdkModuleEvents = {
   photo_response: (event: PhotoResponseEvent) => void
   photo_status: (event: PhotoStatusEvent) => void
   video_recording_status: (event: VideoRecordingStatusEvent) => void
+  media_success: (event: MediaUploadSuccessEvent) => void
+  media_error: (event: MediaUploadErrorEvent) => void
   gallery_status: (event: GalleryStatusEvent) => void
   compatible_glasses_search_stop: (event: CompatibleGlassesSearchStopEvent) => void
   heartbeat_sent: (event: HeartbeatSentEvent) => void
@@ -818,6 +878,8 @@ export type BluetoothSdkEventMap = {
   photo_response: PhotoResponseEvent
   photo_status: PhotoStatusEvent
   video_recording_status: VideoRecordingStatusEvent
+  media_success: MediaUploadSuccessEvent
+  media_error: MediaUploadErrorEvent
   gallery_status: GalleryStatusEvent
   compatible_glasses_search_stop: CompatibleGlassesSearchStopEvent
   swipe_volume_status: SwipeVolumeStatusEvent
@@ -831,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
@@ -885,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>
@@ -898,7 +959,18 @@ export interface BluetoothSdkPublicModule {
     sound: boolean,
     settings?: VideoRecordingSettings,
   ): Promise<VideoRecordingStartedStatusEvent>
-  stopVideoRecording(requestId: string): Promise<VideoRecordingStoppedStatusEvent>
+  /**
+   * 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
+   * the video on device (no upload).
+   */
+  stopVideoRecording(
+    requestId: string,
+    webhookUrl?: string,
+    authToken?: string,
+  ): Promise<VideoRecordingStoppedStatusEvent>
 
   startStream(params: StreamStartRequest): Promise<StreamStatusEvent>
   stopStream(): Promise<StreamStatusEvent>
@@ -920,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>
@@ -148,7 +149,11 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
     sound: boolean,
     settings?: VideoRecordingSettings,
   ): Promise<VideoRecordingStartedStatusEvent>
-  stopVideoRecording(requestId: string): Promise<VideoRecordingStoppedStatusEvent>
+  stopVideoRecording(
+    requestId: string,
+    webhookUrl?: string,
+    authToken?: string,
+  ): Promise<VideoRecordingStoppedStatusEvent>
 
   // Stream Commands
   startStream(params: StreamStartRequest): Promise<StreamStatusEvent>
@@ -567,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",
@@ -21,6 +26,8 @@ const PUBLIC_EVENT_NAMES = new Set<BluetoothSdkEventName>([
   "photo_response",
   "photo_status",
   "video_recording_status",
+  "media_success",
+  "media_error",
   "gallery_status",
   "compatible_glasses_search_stop",
   "swipe_volume_status",
@@ -34,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",
@@ -48,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),
@@ -75,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),
@@ -94,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),
@@ -138,6 +155,7 @@ export type {
   BluetoothSdkPublicModule as BluetoothSdkModule,
   BluetoothSdkSubscription,
   ButtonPhotoSize,
+  ButtonPhotoSettings,
   ButtonPressEvent,
   CameraFovPreset,
   CameraFovRequest,
@@ -179,6 +197,7 @@ export type {
   PhotoMeteredPreview,
   PhotoResponseEvent,
   PhotoRequestedCaptureConfig,
+  PhotoRequestParams,
   PhotoSize,
   PhotoStatusEvent,
   PhotoStatusState,