@mentra/bluetooth-sdk 3.2.1-dev.314 → 3.3.0-beta.942

package/src/_private/BluetoothSdkModule.ts

@@ -2,7 +2,7 @@ import {createScanSession} from "./scanSession"
 import {NativeModule, requireNativeModule} from "expo"
 import {Platform} from "react-native"
 
-import {installNativeLogConsole} from "./nativeLogConsole"
+import {installNativeLogConsole, installSdkUpdateNotice} from "./nativeLogConsole"
 
 import {
   BluetoothSettingsUpdate,
@@ -109,6 +109,8 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   connectSimulated(): Promise<void>
   disconnect(): Promise<void>
   forget(): Promise<void>
+  /** Explicit Unpair also resets connected NIMO glasses before forgetting. */
+  unpair(): Promise<void>
   forgetController(): Promise<void>
   showDashboard(): Promise<void>
   setBrightness(level: number, autoMode?: boolean | null): Promise<void>
@@ -145,6 +147,8 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>
   /** Mentra Live center-mic loudness / Barrier gate (cs_swit type 10). */
   setLoudnessGateEnabled(enabled: boolean): Promise<void>
+  /** Mentra Live power-off after ~20 min unworn (cs_swit type 11). */
+  setAutoPowerOffEnabled(enabled: boolean): Promise<void>
   /**
    * Mentra Live mic tuning. `null` clears every override and returns the
    * glasses to firmware defaults.
@@ -346,6 +350,7 @@ export type BluetoothSdkInternalModule = BluetoothSdkNativeModule
 // NativeModule<BluetoothSdkModuleEvents> already extends EventEmitter<BluetoothSdkModuleEvents>
 const NativeBluetoothSdkModule = requireNativeModule<BluetoothSdkNativeModule>("BluetoothSdk")
 installNativeLogConsole(NativeBluetoothSdkModule, Platform.OS)
+installSdkUpdateNotice(NativeBluetoothSdkModule)
 
 const DEFAULT_CONNECT_OPTIONS: Required<ConnectOptions> = {
   saveAsDefault: true,
@@ -578,6 +583,10 @@ NativeBluetoothSdkModule.setLoudnessGateEnabled = function (enabled: boolean) {
   return this.updateBluetoothSettings({loudness_gate_enabled: enabled})
 }
 
+NativeBluetoothSdkModule.setAutoPowerOffEnabled = function (enabled: boolean) {
+  return this.updateBluetoothSettings({auto_power_off_enabled: enabled})
+}
+
 NativeBluetoothSdkModule.setMicTuning = function (tuning: MicTuning | null) {
   // `{}` rather than null: the store drops null writes, and the native side
   // reads an empty object as "no overrides" and sends an explicit reset.

package/src/_private/MentraLocalNetworkModule.ts

@@ -1,5 +1,32 @@
 import {NativeModule, requireOptionalNativeModule} from "expo"
 
+export type NetworkCapabilitiesDiagnostic = {
+  wifi: boolean
+  cellular: boolean
+  ethernet: boolean
+  vpn: boolean
+  internet: boolean
+  validated: boolean
+  captivePortal: boolean
+}
+
+export type NetworkObservation = {
+  present: boolean
+  // A present network with null capabilities has disappeared or cannot be inspected.
+  capabilities: NetworkCapabilitiesDiagnostic | null
+}
+
+export type NetworkDiagnostics = {
+  sampledAtMs: number
+  processBound: NetworkObservation
+  // ConnectivityManager.activeNetwork is the caller's active default, not a privileged global read.
+  activeNetwork: NetworkObservation
+  glassesLocal: NetworkObservation
+  processBoundMatchesActive: boolean
+  processBoundMatchesGlassesLocal: boolean
+  activeNetworkMatchesGlassesLocal: boolean
+}
+
 export type LocalNetworkResponse = {
   status: number
   headers: Record<string, string>
@@ -26,6 +53,7 @@ type LocalNetworkEvents = {
 }
 
 declare class MentraLocalNetworkNativeModule extends NativeModule<LocalNetworkEvents> {
+  getNetworkDiagnostics(): NetworkDiagnostics
   connect(ssid: string, password: string): Promise<{connected: boolean; ssid: string; localAddress?: string}>
   request(
     requestId: string,

package/src/_private/nativeLogConsole.ts

@@ -22,3 +22,22 @@ export function installNativeLogConsole(source: SubscribedLogSource, platform: s
     console.log(`[native:${platform}]`, nativeLogMessage(message))
   })
 }
+
+type UpdateNoticeSource = {
+  addListener(event: "sdk_update_notice", listener: (event: {message: string}) => void): {remove(): void}
+}
+
+const updateNoticeKey = Symbol.for("mentra.bluetooth-sdk.update-notice")
+type SubscribedUpdateNoticeSource = UpdateNoticeSource & {[updateNoticeKey]?: {remove(): void}}
+
+/**
+ * The native SDK checks for a newer Mentra Bluetooth SDK at startup and emits
+ * its banner when this app is behind. A console warning reaches the developer
+ * in Metro and, in debug builds, as a LogBox warning; release builds show no UI.
+ */
+export function installSdkUpdateNotice(source: SubscribedUpdateNoticeSource): void {
+  source[updateNoticeKey]?.remove()
+  source[updateNoticeKey] = source.addListener("sdk_update_notice", ({message}) => {
+    console.warn(message)
+  })
+}

package/src/generated/changelogCatalog.ts

@@ -2,12 +2,16 @@
 export const GENERATED_RELEASE_CHANGELOGS = Object.freeze(
 [
   {
-    "version": "3.2.1",
+    "version": "3.3.0",
     "markdown": "This release is under active development. User-facing changes will be documented as they land."
   },
+  {
+    "version": "3.2.1",
+    "markdown": "- **Livestreamer:** \"Stream Here\" now works without a Wi-Fi network. Improved stream startup and connection reliability.\n- **Photos and gallery:** More reliable photo capture and gallery syncing.\n- **Mentra AI:** Reliability improvements and bug fixes.\n- **Miniapps:** Smoother transitions, with back buttons and gestures that take you to the previous screen inside a miniapp.\n- **Pairing and connections:** Improved G1 pairing and G2 background reconnection.\n- **Glasses updates:** Fixed repeated update checks and improved recovery after interrupted updates.\n- **Mentra Maps:** Bug fixes.\n- **NIMO:** Improved text and map layouts.\n- **Self-hosting:** Connect the Mentra App to your own self-hosted Mentra backend."
+  },
   {
     "version": "3.2.0",
-    "markdown": "This release is under active development. User-facing changes will be documented as they land.\n\n- Breaking Bluetooth SDK change: `forgetWifiNetwork(ssid)` now returns `WifiForgetResult` instead of `WifiStatusChangeEvent`. Migrate status-only consumers to the semantic `outcome`; the requested network remains `ssid`, while optional post-command connectivity is reported by `connected`, `currentSsid`, and `localIp`."
+    "markdown": "- Improved glasses connectivity and Wi-Fi setup.\n\n- Breaking Bluetooth SDK change: `forgetWifiNetwork(ssid)` now returns `WifiForgetResult` instead of `WifiStatusChangeEvent`. Migrate status-only consumers to the semantic `outcome`; the requested network remains `ssid`, while optional post-command connectivity is reported by `connected`, `currentSsid`, and `localIp`."
   },
   {
     "version": "3.1.1",

package/src/generated/releaseMetadata.ts

@@ -11,10 +11,10 @@ export interface BluetoothSdkReleaseMetadata {
 
 export const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
-  "familyBaseVersion": "3.2.1",
-  "releaseIdentity": "3.2.1-dev.314",
-  "releaseSetId": "mentra-3.2.1-dev.314",
-  "sourceCommit": "00ab17c37df5902fbdb1a5824a41288b6850acc5",
-  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.314.json",
-  "otaManifestSha256": "1062c560fcced026e5b43245e84cdd5febfd603f3ad19fbebef8fac455ba21d6"
+  "familyBaseVersion": "3.3.0",
+  "releaseIdentity": "3.3.0-beta.942",
+  "releaseSetId": "mentra-3.3.0-beta.942",
+  "sourceCommit": "5c18d26dfc6feb9070d4705e36a38ae074e242b1",
+  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-beta.942.json",
+  "otaManifestSha256": "94e1ba8266968b358748b30a6384882a6bc9df23aab38a01d786d448bdd044c9"
 })

package/src/index.ts

@@ -131,6 +131,7 @@ export const BluetoothSdk: BluetoothSdkPublicModule = Object.freeze({
   setGalleryModeEnabled: bindPublicMethod("setGalleryModeEnabled"),
   setVoiceActivityDetectionEnabled: bindPublicMethod("setVoiceActivityDetectionEnabled"),
   setLoudnessGateEnabled: bindPublicMethod("setLoudnessGateEnabled"),
+  setAutoPowerOffEnabled: bindPublicMethod("setAutoPowerOffEnabled"),
   /**
    * @deprecated Sticky action-button photo presets are deprecated. Prefer per-request
    * `requestPhoto(...)` options (e.g. `mode: "text"` for text sensor size/crop, or explicit per-shot

package/src/ota-transport/index.ts

@@ -1,9 +1,16 @@
 // This public adapter is the package-owned boundary over its native implementation.
 // eslint-disable-next-line no-restricted-imports
-import MentraLocalNetwork from "../_private/MentraLocalNetworkModule"
+import MentraLocalNetwork, {type NetworkDiagnostics} from "../_private/MentraLocalNetworkModule"
 // eslint-disable-next-line no-restricted-imports
 import MentraOtaServer from "../ota-server"
 
+// eslint-disable-next-line no-restricted-imports
+export type {
+  NetworkCapabilitiesDiagnostic,
+  NetworkDiagnostics,
+  NetworkObservation,
+} from "../_private/MentraLocalNetworkModule"
+
 export type OtaTransportSubscription = {remove(): void}
 
 export type OtaLocalNetworkConnection = {
@@ -55,6 +62,8 @@ export type OtaServerResult = {
  */
 export const otaLocalNetwork = Object.freeze({
   isAvailable: (): boolean => MentraLocalNetwork != null,
+  /** Synchronous local observation; no network I/O, route changes or network identities. */
+  getNetworkDiagnostics: (): NetworkDiagnostics | null => MentraLocalNetwork?.getNetworkDiagnostics() ?? null,
   connect: async (ssid: string, password: string): Promise<OtaLocalNetworkConnection> => {
     if (!MentraLocalNetwork) throw new Error("Scoped local networking is not available in this native build")
     return MentraLocalNetwork.connect(ssid, password)