@mentra/bluetooth-sdk 0.1.0

package/src/BluetoothSdkModule.ts

@@ -0,0 +1,259 @@
+import {NativeModule, requireNativeModule} from "expo"
+
+import {
+  ConnectOptions,
+  BluetoothSdkModuleEvents,
+  BluetoothStatus,
+  DeviceScanRequest,
+  GalleryMode,
+  Device,
+  GlassesMediaVolumeGetResult,
+  GlassesMediaVolumeSetResult,
+  GlassesStatus,
+  PhotoCompression,
+  PhotoSize,
+  RgbLedAction,
+  RgbLedColor,
+  StreamKeepAliveRequest,
+  StreamStartRequest,
+} from "./BluetoothSdk.types"
+
+type GlassesListener = (changed: Partial<GlassesStatus>) => void
+type BluetoothStatusListener = (changed: Partial<BluetoothStatus>) => void
+type MaybePromise<T> = T | Promise<T>
+
+declare class BluetoothSdkModule extends NativeModule<BluetoothSdkModuleEvents> {
+  // Observable Store Functions (native)
+  getGlassesStatus(): Promise<GlassesStatus>
+  getBluetoothStatus(): Promise<BluetoothStatus>
+  getDefaultDevice(): Promise<Device | null>
+  update(category: string, values: Record<string, any>): Promise<void>
+
+  // Display Commands
+  displayEvent(params: Record<string, any>): Promise<void>
+  displayText(params: Record<string, any>): Promise<void>
+  clearDisplay(): Promise<void>
+
+  // Connection Commands
+  requestStatus(): Promise<void>
+  connectDefault(options?: ConnectOptions): Promise<void>
+  connectDefaultWithOptions(options: Required<ConnectOptions>): Promise<void>
+  setDefaultDevice(device: Device | null): Promise<void>
+  clearDefaultDevice(): Promise<void>
+  startScan(params: DeviceScanRequest): Promise<void>
+  connect(device: Device, options?: ConnectOptions): Promise<void>
+  connectWithOptions(device: Device, options: Required<ConnectOptions>): Promise<void>
+  cancelConnectionAttempt(): Promise<void>
+  connectDefaultController(): Promise<void>
+  disconnectController(): Promise<void>
+  connectSimulated(): Promise<void>
+  disconnect(): Promise<void>
+  forget(): Promise<void>
+  forgetController(): Promise<void>
+  showDashboard(): Promise<void>
+  ping(): Promise<void>
+  dbg1(): Promise<void>
+  dbg2(): Promise<void>
+
+  // Incident Reporting
+  sendIncidentId(incidentId: string, apiBaseUrl?: string | null): Promise<void>
+
+  // WiFi Commands
+  requestWifiScan(): Promise<void>
+  sendWifiCredentials(ssid: string, password: string): Promise<void>
+  forgetWifiNetwork(ssid: string): Promise<void>
+  setHotspotState(enabled: boolean): Promise<void>
+  /** Logs current WiFi frequency (MHz) and 5 GHz band to Android logcat. */
+  logCurrentWifiFrequency(): Promise<void>
+
+  // Gallery Commands
+  setGalleryMode(mode: GalleryMode): Promise<void>
+  queryGalleryStatus(): Promise<void>
+  photoRequest(
+    requestId: string,
+    appId: string,
+    size: PhotoSize,
+    webhookUrl: string | null,
+    authToken: string | null,
+    compress: PhotoCompression,
+    flash: boolean,
+    sound: boolean,
+  ): Promise<void>
+
+  // OTA Commands
+  sendOtaStart(): Promise<void>
+  sendOtaQueryStatus(): Promise<void>
+
+  // Version Info Commands
+  requestVersionInfo(): Promise<void>
+
+  // Video Recording Commands
+  startVideoRecording(requestId: string, save: boolean, flash: boolean, sound: boolean): Promise<void>
+  stopVideoRecording(requestId: string): Promise<void>
+
+  // Stream Commands
+  startStream(params: StreamStartRequest): Promise<void>
+  stopStream(): Promise<void>
+  keepStreamAlive(params: StreamKeepAliveRequest): Promise<void>
+
+  // Microphone Commands
+  setMicState(sendPcmData: boolean, sendTranscript: boolean, bypassVad: boolean): Promise<void>
+  restartTranscriber(): Promise<void>
+
+  // Audio Playback Monitoring
+  // Notify native side when our app starts/stops playing audio
+  // Used to suspend LC3 mic during audio playback to avoid MCU overload
+  setOwnAppAudioPlaying(playing: boolean): Promise<void>
+
+  /** 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. */
+  setGlassesMediaVolume(level: number): Promise<GlassesMediaVolumeSetResult>
+
+  // RGB LED Control
+  rgbLedControl(
+    requestId: string,
+    packageName: string | null,
+    action: RgbLedAction,
+    color: RgbLedColor | null,
+    ontime: number,
+    offtime: number,
+    count: number,
+  ): Promise<void>
+
+  // STT Commands
+  setSttModelDetails(path: string, languageCode: string): Promise<void>
+  getSttModelPath(): Promise<string>
+  checkSttModelAvailable(): Promise<boolean>
+  validateSttModel(path: string): Promise<boolean>
+  extractTarBz2(sourcePath: string, destinationPath: string): Promise<boolean>
+
+  // Helper methods for type-safe observable store access
+  updateGlasses(values: Partial<GlassesStatus>): Promise<void>
+  updateBluetoothSettings(values: Record<string, any>): Promise<void>
+  onGlassesStatus(callback: GlassesListener): () => void
+  onBluetoothStatus(callback: BluetoothStatusListener): () => void
+
+  // Process resident-set-size in MB. iOS-only; Android stub returns 0.
+  getMemoryMB(): number
+}
+
+// This call loads the native module object from the JSI.
+// NativeModule<BluetoothSdkModuleEvents> already extends EventEmitter<BluetoothSdkModuleEvents>
+const NativeBluetoothSdkModule = requireNativeModule<BluetoothSdkModule>("BluetoothSdk")
+
+const DEFAULT_CONNECT_OPTIONS: Required<ConnectOptions> = {
+  saveAsDefault: true,
+  cancelExistingConnectionAttempt: true,
+}
+
+function adaptConnectionStatusToNative(connection: GlassesStatus["connection"]): Record<string, any> {
+  switch (connection.state) {
+    case "connected":
+      return {connectionState: "CONNECTED", connected: true, fullyBooted: connection.fullyBooted}
+    case "scanning":
+      return {connectionState: "SCANNING", connected: false, fullyBooted: false}
+    case "connecting":
+      return {connectionState: "CONNECTING", connected: false, fullyBooted: false}
+    case "bonding":
+      return {connectionState: "BONDING", connected: false, fullyBooted: false}
+    case "disconnected":
+      return {connectionState: "DISCONNECTED", connected: false, fullyBooted: false}
+  }
+}
+
+function adaptGlassesUpdateToNative(values: Partial<GlassesStatus>): Record<string, any> {
+  const {wifi, hotspot, connection, ...rest} = values
+  let update: Record<string, any> = {...rest}
+  if (connection) {
+    update = {
+      ...update,
+      ...adaptConnectionStatusToNative(connection),
+    }
+  }
+  if (wifi?.state === "connected") {
+    update = {
+      ...update,
+      wifiConnected: true,
+      wifiSsid: wifi.ssid,
+      wifiLocalIp: wifi.localIp ?? "",
+    }
+  } else if (wifi?.state === "disconnected") {
+    update = {
+      ...update,
+      wifiConnected: false,
+      wifiSsid: "",
+      wifiLocalIp: "",
+    }
+  }
+  if (hotspot?.state === "enabled") {
+    update = {
+      ...update,
+      hotspotEnabled: true,
+      hotspotSsid: hotspot.ssid,
+      hotspotPassword: hotspot.password,
+      hotspotGatewayIp: hotspot.localIp,
+    }
+  } else if (hotspot?.state === "disabled") {
+    update = {
+      ...update,
+      hotspotEnabled: false,
+      hotspotSsid: "",
+      hotspotPassword: "",
+      hotspotGatewayIp: "",
+    }
+  }
+  return update
+}
+
+// Add helper methods to the module
+const nativeGetGlassesStatus = NativeBluetoothSdkModule.getGlassesStatus.bind(
+  NativeBluetoothSdkModule,
+) as () => MaybePromise<GlassesStatus>
+NativeBluetoothSdkModule.getGlassesStatus = function () {
+  return Promise.resolve(nativeGetGlassesStatus())
+}
+
+const nativeGetBluetoothStatus = NativeBluetoothSdkModule.getBluetoothStatus.bind(NativeBluetoothSdkModule) as () => MaybePromise<BluetoothStatus>
+NativeBluetoothSdkModule.getBluetoothStatus = function () {
+  return Promise.resolve(nativeGetBluetoothStatus())
+}
+
+const nativeGetDefaultDevice = NativeBluetoothSdkModule.getDefaultDevice.bind(
+  NativeBluetoothSdkModule,
+) as () => MaybePromise<Device | null>
+NativeBluetoothSdkModule.getDefaultDevice = function () {
+  return Promise.resolve(nativeGetDefaultDevice())
+}
+
+NativeBluetoothSdkModule.updateGlasses = function (values: Partial<GlassesStatus>) {
+  return this.update("glasses", adaptGlassesUpdateToNative(values))
+}
+
+NativeBluetoothSdkModule.updateBluetoothSettings = function (values: Record<string, any>) {
+  return this.update("bluetooth", values)
+}
+
+NativeBluetoothSdkModule.onGlassesStatus = function (callback: GlassesListener) {
+  const subscription = this.addListener("glasses_status", callback)
+  return () => subscription.remove()
+}
+
+NativeBluetoothSdkModule.onBluetoothStatus = function (callback: BluetoothStatusListener) {
+  const subscription = this.addListener("bluetooth_status", callback)
+  return () => subscription.remove()
+}
+
+const nativeConnectDefault = NativeBluetoothSdkModule.connectDefault.bind(NativeBluetoothSdkModule)
+NativeBluetoothSdkModule.connectDefault = function (options?: ConnectOptions) {
+  if (!options) {
+    return nativeConnectDefault()
+  }
+  return this.connectDefaultWithOptions({...DEFAULT_CONNECT_OPTIONS, ...options})
+}
+
+NativeBluetoothSdkModule.connect = function (device: Device, options?: ConnectOptions) {
+  return this.connectWithOptions(device, {...DEFAULT_CONNECT_OPTIONS, ...options})
+}
+
+export default NativeBluetoothSdkModule

package/src/index.ts

@@ -0,0 +1,4 @@
+// Reexport the native module. On web, it will be resolved to BluetoothSdkModule.web.ts
+// and on native platforms to BluetoothSdkModule.ts
+export {default} from "./BluetoothSdkModule"
+export * from "./BluetoothSdk.types"