@glassly/bluetooth-sdk 0.1.0-dev.99 → 0.2.8-dev.444

package/ios/Tests/BluetoothSDKTests/GlassesNotificationTests.swift

@@ -0,0 +1,95 @@
+@testable import BluetoothSDK
+import Foundation
+import XCTest
+
+final class GlassesNotificationTests: XCTestCase {
+    func testConfigDictionaryRoundTrip() throws {
+        let source: [String: Any] = [
+            "enabled": true,
+            "popups": false,
+            // Bridge numbers arrive as NSNumber, not Int.
+            "popupSeconds": NSNumber(value: 7),
+            "holdDuringApps": false,
+            "blockedApps": ["com.example.one", "com.example.two"],
+            "allowedApps": [
+                ["id": "com.example.three", "name": "Three"],
+                ["id": "com.example.four"],
+            ],
+        ]
+
+        let config = try GlassesNotificationConfig(dictionary: source)
+        XCTAssertTrue(config.enabled)
+        XCTAssertFalse(config.popups)
+        XCTAssertEqual(config.popupSeconds, 7)
+        XCTAssertFalse(config.holdDuringApps)
+        XCTAssertEqual(config.blockedApps, ["com.example.one", "com.example.two"])
+        XCTAssertEqual(
+            config.allowedApps,
+            [
+                .init(id: "com.example.three", name: "Three"),
+                // A missing name falls back to the id.
+                .init(id: "com.example.four", name: "com.example.four"),
+            ]
+        )
+
+        let roundTripped = try GlassesNotificationConfig(dictionary: config.dictionary)
+        XCTAssertEqual(roundTripped, config)
+    }
+
+    func testConfigRejectsPopupSecondsOutOfRange() {
+        for seconds in [-1, 61] {
+            XCTAssertThrowsError(
+                try GlassesNotificationConfig(dictionary: ["popupSeconds": NSNumber(value: seconds)])
+            ) { error in
+                guard case GlassesNotificationError.invalidConfig = error else {
+                    return XCTFail("expected invalidConfig for \(seconds), got \(error)")
+                }
+            }
+        }
+    }
+
+    func testStatusDictionaryUsesNullForMissingFields() {
+        let dictionary = GlassesNotificationStatus.unsupported.dictionary
+        XCTAssertEqual(dictionary["supported"] as? Bool, false)
+        XCTAssertEqual(dictionary["feed"] as? String, "none")
+        XCTAssertEqual(dictionary["access"] as? String, "not_needed")
+        XCTAssertEqual(dictionary["phase"] as? String, "idle")
+        XCTAssertTrue(dictionary["config"] is NSNull)
+        XCTAssertTrue(dictionary["error"] is NSNull)
+    }
+
+    func testSnapPopupSeconds() {
+        XCTAssertEqual(G2NotificationTuning.snapPopupSeconds(0), 0)
+        XCTAssertEqual(G2NotificationTuning.snapPopupSeconds(1), 5)
+        XCTAssertEqual(G2NotificationTuning.snapPopupSeconds(5), 5)
+        // Ties round up.
+        XCTAssertEqual(G2NotificationTuning.snapPopupSeconds(6), 7)
+        XCTAssertEqual(G2NotificationTuning.snapPopupSeconds(7), 7)
+        XCTAssertEqual(G2NotificationTuning.snapPopupSeconds(8), 7)
+        XCTAssertEqual(G2NotificationTuning.snapPopupSeconds(9), 10)
+        XCTAssertEqual(G2NotificationTuning.snapPopupSeconds(30), 10)
+    }
+
+    func testFilterEnabledOnlyWithBlockedApps() {
+        func config(blocked: [String], allowed: [GlassesNotificationConfig.AllowedApp]) -> GlassesNotificationConfig {
+            GlassesNotificationConfig(
+                enabled: true,
+                popups: true,
+                popupSeconds: 5,
+                holdDuringApps: true,
+                blockedApps: blocked,
+                allowedApps: allowed
+            )
+        }
+
+        XCTAssertFalse(G2NotificationTuning.filterEnabled(for: config(blocked: [], allowed: [])))
+        XCTAssertFalse(
+            G2NotificationTuning.filterEnabled(
+                for: config(blocked: [], allowed: [.init(id: "com.example.one", name: "One")])
+            )
+        )
+        XCTAssertTrue(
+            G2NotificationTuning.filterEnabled(for: config(blocked: ["com.example.one"], allowed: []))
+        )
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassly/bluetooth-sdk",
-  "version": "0.1.0-dev.99",
+  "version": "0.2.8-dev.444",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",

package/plugin/build/withAndroid.js

@@ -24,7 +24,7 @@ function withSettingsGradleModifications(config) {
     return (0, config_plugins_1.withSettingsGradle)(config, (config) => {
         let settingsGradle = config.modResults.contents;
         const bluetoothSdkRoot = getBluetoothSdkRoot();
-        const bluetoothSdkRootExpression = `System.getenv("GLASSLY_BLUETOOTH_SDK_PACKAGE_PATH") ?: ${toGroovyString(bluetoothSdkRoot)}`;
+        const bluetoothSdkRootExpression = `System.getenv("BLUETOOTH_SDK_PACKAGE_PATH") ?: ${toGroovyString(bluetoothSdkRoot)}`;
         if (!settingsGradle.includes("project(':glassly-bluetooth-sdk').projectDir")) {
             const bluetoothSdkProjectBlock = `
   if (findProject(':glassly-bluetooth-sdk') != null) {
@@ -115,7 +115,7 @@ function withSherpaOnnxLocalMavenRepo(config) {
         }
         let contents = config.modResults.contents;
         const fallbackRoot = toGroovyString(getBluetoothSdkRoot());
-        const repoDirExpression = `new File(System.getenv("GLASSLY_BLUETOOTH_SDK_PACKAGE_PATH") ?: ${fallbackRoot}, "android/libs/maven")`;
+        const repoDirExpression = `new File(System.getenv("BLUETOOTH_SDK_PACKAGE_PATH") ?: ${fallbackRoot}, "android/libs/maven")`;
         const marker = "// bluetooth-sdk: sherpa-onnx local maven repo";
         if (contents.includes(marker)) {
             return config;

package/plugin/build/withIos.js

@@ -9,7 +9,7 @@ const child_process_1 = require("child_process");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const config_plugins_1 = require("expo/config-plugins");
-const BLUETOOTH_SDK_EXPO_ADAPTER_ENV = "GLASSLY_BLUETOOTH_SDK_INCLUDE_EXPO_ADAPTER";
+const BLUETOOTH_SDK_EXPO_ADAPTER_ENV = "BLUETOOTH_SDK_INCLUDE_EXPO_ADAPTER";
 const BLUETOOTH_SDK_EXPO_ADAPTER_LINE = `ENV['${BLUETOOTH_SDK_EXPO_ADAPTER_ENV}'] ||= '1'`;
 const INFO_ANALYTICS_DISABLED = "BluetoothSdkAnalyticsDisabled";
 exports.INFO_SDK_VERSION = "BluetoothSdkVersion";

package/scripts/gen-nex-proto.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+# Regenerate the Nex BLE protobuf bindings from proto/nex_ble.proto.
+# Needs protoc and protoc-gen-swift (brew install protobuf swift-protobuf).
+# Keep com.google.protobuf:protobuf-java in android/build.gradle >= the protoc
+# major used here; gencode refuses to load on an older runtime.
+set -euo pipefail
+cd "$(dirname "$0")/.."
+protoc --version
+protoc -I proto \
+  --java_out=android/src/main/java \
+  --swift_out=ios/Source/sgcs \
+  proto/nex_ble.proto

package/scripts/inject-ios-sdk-version.mjs

@@ -17,7 +17,7 @@ if (typeof version !== "string" || version.trim() === "") {
   throw new Error("mobile/modules/bluetooth-sdk/package.json is missing a version")
 }
 
-const placeholder = 'private static let swiftPackageSdkVersion = "__GLASSLY_BLUETOOTH_SDK_VERSION__"'
+const placeholder = 'private static let swiftPackageSdkVersion = "__BLUETOOTH_SDK_VERSION__"'
 const injectedVersion = `private static let swiftPackageSdkVersion = "${version}"`
 
 async function pathExists(filePath) {

package/src/BluetoothSdk.types.ts

@@ -45,6 +45,8 @@ export type TouchEvent = {
   deviceModel: DeviceModel
   gestureName: string
   timestamp: number
+  /** Native input source when supplied; G2 source 2 identifies the ring. */
+  source?: number
 }
 
 export type AccelEvent = {
@@ -55,6 +57,53 @@ export type AccelEvent = {
   timestamp: number
 }
 
+/**
+ * One raw HID key transition from the keyboard bridged through G2 Glassly CFW
+ * (revision 39+): keyboard page 7 or consumer page 12 usage ids, no layout
+ * applied. Phone receipt time in ms.
+ */
+export type KeyboardKeyEvent = {
+  page: number
+  usage: number
+  down: boolean
+  timestamp: number
+}
+
+/** One advertiser seen during a keyboard scan. `address` is MSB-first hex. */
+export type KeyboardAdvertEvent = {
+  address: string
+  /** 0 public, 1 random, 2 public identity, 3 random identity. */
+  addressType: number
+  name: string
+  /** Advertises the HID service (0x1812). */
+  hid: boolean
+  rssi: number
+}
+
+/**
+ * Pairing prompt from the keyboard bridge. `passkey`: the keyboard shows a
+ * PIN the user must enter on the phone (answer with g2KeyboardPasskey).
+ * `display`: the phone chose `value`; the user types it on the keyboard and
+ * presses Enter. `compare`: confirm the keyboard shows `value` (g2KeyboardCompare).
+ */
+export type KeyboardPairingEvent = {
+  kind: "passkey" | "display" | "compare"
+  value?: number
+}
+
+export type KeyboardBridgeState = "idle" | "scanning" | "connecting" | "pairing" | "configuring" | "connected" | "error"
+
+export type KeyboardBridgeStatus = {
+  keyboardBridge: boolean
+  keyboardConnected: boolean
+  keyboardName: string
+  keyboardSaved: boolean
+  keyboardState: KeyboardBridgeState
+  keyboardError: string
+  /** Firmware STATUS record when the bridge answered the query. */
+  firmware?: {enabled: boolean; conn: number; connected: boolean; encrypted: boolean; scanning: boolean}
+}
+
 export type HeadUpEvent = {
   up: boolean
 }
@@ -63,8 +112,39 @@ export type HeadUpEvent = {
  * Glasses magnetometer heading, streamed while the native navigation mode is
  * active (G2 service 0x08). Degrees 0…359, 0 = magnetic north.
  */
+export type LightSensorEvent = {
+  type: "light_sensor"
+  reason: "query" | "started" | "poll" | "stopped"
+  opened: boolean
+  passive: boolean
+  autoBrightness: boolean
+  readSucceeded: boolean
+  status: number
+  value: number
+  peak: number
+  targetLevel: number
+  brightness: number
+  gear: number
+  scaleQ10: number
+  sampleTimestampMs: number
+  timestamp: number
+}
+
+export type CompassSensorDiagnostics = {
+  accuracy: 0 | 1 | 2 | 3 | null
+  anomalies: 0 | 1 | 2 | null
+  source: "unknown" | "grv" | "gmrv" | "rv"
+  sampleMatched: boolean
+  grvValid: boolean
+  gmrvValid: boolean
+  rvValid: boolean
+  magneticDataFresh: boolean
+  sampleTimestampMs: number
+}
+
 export type CompassHeadingEvent = {
   type: "compass_heading"
+  diagnostics?: CompassSensorDiagnostics
   heading: number
   timestamp: number
 }
@@ -91,6 +171,29 @@ export type NavigationViewEvent = {
   viewIndex: number
 }
 
+/**
+ * A scene frame (display.render()) reached — or can no longer reach — the
+ * glasses. `seq` is the host's frame number; a report covers every earlier
+ * frame too, since unsent frames fold into the next one. `presented: false`
+ * carries the `reason` (screen off, nav UI up, page rebuilding, …).
+ */
+export type SceneFramePresentedEvent = {
+  type: "scene_frame_presented"
+  seq: number
+  appId: string
+  presented: boolean
+  reason?: string
+}
+
+/**
+ * The glasses finished every animation a scene frame started (Glassly CFW
+ * revision 27+). `tag` is the low 16 bits of the host frame number.
+ */
+export type SceneSettledEvent = {
+  type: "scene_settled"
+  tag: number
+}
+
 export type VoiceActivityDetectionStatusEvent = {
   type: "voice_activity_detection_status"
   voiceActivityDetectionEnabled: boolean
@@ -1001,10 +1104,13 @@ export type BluetoothSdkModuleEvents = {
   button_press: (event: ButtonPressEvent) => void
   touch_event: (event: TouchEvent) => void
   accel_event: (event: AccelEvent) => void
+  light_sensor: (event: LightSensorEvent) => void
   compass_heading: (event: CompassHeadingEvent) => void
   compass_calibration: (event: CompassCalibrationEvent) => void
   navigation_mode_change: (event: NavigationModeEvent) => void
   navigation_view_change: (event: NavigationViewEvent) => void
+  scene_frame_presented: (event: SceneFramePresentedEvent) => void
+  scene_settled: (event: SceneSettledEvent) => void
   head_up: (event: HeadUpEvent) => void
   voice_activity_detection_status: (event: VoiceActivityDetectionStatusEvent) => void
   speaking_status: (event: SpeakingStatusEvent) => void
@@ -1016,6 +1122,8 @@ export type BluetoothSdkModuleEvents = {
   phone_notification: (event: PhoneNotificationEvent) => void
   phone_notification_dismissed: (event: PhoneNotificationDismissedEvent) => void
   notification_app_seen: (event: NotificationAppSeenEvent) => void
+  glasses_notification_status: (event: GlassesNotificationStatus) => void
+  notification_upload_result: (event: NotificationUploadResult) => void
   wifi_status_change: (event: WifiStatusChangeEvent) => void
   wifi_scan_result: (event: WifiScanResultEvent) => void
   hotspot_status_change: (event: HotspotStatusChangeEvent) => void
@@ -1060,6 +1168,9 @@ export type BluetoothSdkModuleEvents = {
   receive_command_from_ble: (event: BleCommandTraceEvent) => void
   miniapp_selected: (event: MiniappSelectedEvent) => void
   extraction_progress: (event: ExtractionProgressEvent) => void
+  keyboard_key: (event: KeyboardKeyEvent) => void
+  keyboard_advert: (event: KeyboardAdvertEvent) => void
+  keyboard_pairing: (event: KeyboardPairingEvent) => void
 }
 
 export interface ExtractionProgressEvent {
@@ -1106,6 +1217,64 @@ export interface NotificationAppSeenEvent {
   timestamp: number
 }
 
+/** How connected glasses obtain the phone's notifications. */
+export type GlassesNotificationFeed = "phone_upload" | "ancs" | "none"
+
+/**
+ * Desired on-glass notification behaviour, in glasses-neutral terms. Drivers
+ * map it onto their protocol and snap values their firmware cannot take.
+ */
+export interface GlassesNotificationConfig {
+  /** Master switch: off keeps every phone notification off the glasses. */
+  enabled: boolean
+  /** Show a popup when a notification arrives; off keeps history only. */
+  popups: boolean
+  /** Seconds a popup stays up. 0 lets the firmware choose. */
+  popupSeconds: number
+  /** Hold popups while another glasses feature (navigation, a miniapp) is on screen. */
+  holdDuringApps: boolean
+  /** Ids the wearer blocked: Android package names or iOS bundle ids. */
+  blockedApps: string[]
+  /**
+   * Known ids minus blocked, for firmware whose filter is an allowlist.
+   * Filtering is off whenever `blockedApps` is empty, whatever this holds.
+   */
+  allowedApps: Array<{id: string; name: string}>
+}
+
+export interface GlassesNotificationStatus {
+  /** The connected driver can take a config at all. */
+  supported: boolean
+  feed: GlassesNotificationFeed
+  /**
+   * Whether the glasses may read the phone's notifications. `not_needed` when
+   * the phone uploads content itself.
+   */
+  access: "granted" | "denied" | "unknown" | "not_needed"
+  /** `applied` means the last config was written to the link, not acknowledged. `stale` needs a reconnect. */
+  phase: "idle" | "applying" | "applied" | "stale" | "error"
+  config: GlassesNotificationConfig | null
+  error: string | null
+}
+
+/** One phone notification handed to glasses that present content themselves. */
+export interface PhoneNotificationUpload {
+  notificationId: string
+  packageName: string
+  appName: string
+  title: string
+  subtitle: string
+  body: string
+  timestampMs: number
+}
+
+/** Outcome of an upload, by id only; content never crosses back. */
+export interface NotificationUploadResult {
+  notificationId: string
+  outcome: "sent" | "failed" | "cancelled" | "dropped"
+  detail: string
+}
+
 export type PublicGlassesStatus = Omit<
   GlassesStatus,
   "otaUpdateAvailable" | "otaProgress" | "otaInProgress" | "otaVersionUrl"
@@ -1126,6 +1295,8 @@ export type PublicBluetoothStatus = Pick<
 >
 
 export type BluetoothSdkEventMap = {
+  glasses_notification_status: GlassesNotificationStatus
+  notification_upload_result: NotificationUploadResult
   log: LogEvent
   device_discovered: Device
   default_device_changed: {device?: Device}
@@ -1175,6 +1346,9 @@ export type BluetoothSdkEventMap = {
   g2_firmware_flash_progress: G2FirmwareFlashProgressEvent
   version_info: VersionInfoEvent
   extraction_progress: ExtractionProgressEvent
+  keyboard_key: KeyboardKeyEvent
+  keyboard_advert: KeyboardAdvertEvent
+  keyboard_pairing: KeyboardPairingEvent
 }
 
 export type BluetoothSdkEventName = keyof BluetoothSdkEventMap
@@ -1226,6 +1400,12 @@ export interface BluetoothSdkPublicModule {
    * saying "Hey Even, show notifications"). G2 only; a no-op elsewhere.
    */
   showNativeNotificationPanel(): Promise<void>
+  /**
+   * Apply on-glass notification behaviour. Rejects when no glasses are connected
+   * or the connected driver has no firmware notification surface.
+   */
+  setGlassesNotificationConfig(config: GlassesNotificationConfig): Promise<void>
+  getGlassesNotificationStatus(): Promise<GlassesNotificationStatus>
   setDashboardPosition(height: number, depth: number): Promise<void>
   setHeadUpAngle(angleDegrees: number): Promise<void>
   setImuEnabled(enabled: boolean): Promise<void>
@@ -1320,6 +1500,19 @@ export interface BluetoothSdkPublicModule {
   requestVersionInfo(): Promise<VersionInfoResult>
   availableG2FirmwareArtifacts(): Promise<G2FirmwareArtifact[]>
   startG2FirmwareFlash(target: G2FirmwareTarget): Promise<G2FirmwareFlashResult>
+  /**
+   * BLE keyboard bridge (G2 Glassly CFW revision 39+): the right lens hosts one
+   * HID-over-GATT keyboard. Scan for five seconds (results also arrive as
+   * `keyboard_advert` events), connect and remember one, or drop it.
+   */
+  g2KeyboardScan(): Promise<KeyboardAdvertEvent[]>
+  g2KeyboardConnect(address: string, addressType: number, name: string): Promise<void>
+  g2KeyboardReconnect(): Promise<void>
+  g2KeyboardDisconnect(): Promise<void>
+  g2KeyboardForget(): Promise<void>
+  g2KeyboardPasskey(pin: number): Promise<void>
+  g2KeyboardCompare(accept: boolean): Promise<void>
+  g2KeyboardStatus(): Promise<KeyboardBridgeStatus>
   /**
    * Select the OTA manifest used by subsequent update checks and installs.
    * The URL may point at Glassly's hosted manifest or any customer-controlled HTTP(S) server.
@@ -1467,11 +1660,20 @@ export interface GlassesStatus {
    */
   sceneCanvasWidth?: number
   sceneCanvasHeight?: number
+  /** Connected firmware draws vector shapes and animates transitions on the glasses (G2 Glassly CFW). */
+  sceneVector?: boolean
+  /** Connected firmware reports when a scene frame's animations have ended (G2 Glassly CFW revision 27+). */
+  sceneSettle?: boolean
   // wifi info
   wifi: WifiStatus
   // battery info
   batteryLevel: number
   charging: boolean
+  /** R1 status relayed by the glasses; independent of the phone-connected controller. */
+  ringConnected: boolean
+  /** -1 until a valid connected R1 battery report is available. */
+  ringBatteryLevel: number
+  ringCharging: boolean
   caseBatteryLevel: number
   caseCharging: boolean
   caseOpen: boolean
@@ -1494,6 +1696,18 @@ export interface GlassesStatus {
    * on Android and for models that don't consume ANCS on-firmware.
    */
   ancsAuthorized?: boolean
+  /**
+   * G2 Glassly CFW keyboard bridge (revision 39+). `keyboardBridge` is true
+   * only while connected glasses run a firmware that hosts a keyboard;
+   * `keyboardSaved`/`keyboardName` describe the remembered keyboard, which
+   * the driver reconnects on every CFW detection.
+   */
+  keyboardBridge?: boolean
+  keyboardConnected?: boolean
+  keyboardName?: string
+  keyboardSaved?: boolean
+  keyboardState?: KeyboardBridgeState
+  keyboardError?: string
 }
 
 export interface CoreDashboardMenuItem {
@@ -1514,23 +1728,6 @@ export interface CoreSettings {
   calendar_events: CalendarEvent[]
 }
 
-/** G2 on-glass notification display behavior (NotificationControl protobuf). */
-export interface G2NotificationCtrlSetting {
-  enabled: boolean
-  auto_display: boolean
-  /** On-screen popup duration in seconds: 0 (firmware default), 5, 7, or 10. */
-  disp_time: number
-  avoid_disturb: boolean
-}
-
-/** G2 on-glass ANCS app filter (user/notify_whitelist.json push). */
-export interface G2NotificationFilterSetting {
-  /** false = whitelisting off on-glass (fail-open, every app shows). */
-  enabled: boolean
-  /** Allowlist entries; identifiers are iOS bundle ids. */
-  apps: Array<{id: string; name: string}>
-}
-
 export interface Device {
   /**
    * Stable app-facing key for this scan result, within the limits of the
@@ -1629,8 +1826,6 @@ export type BluetoothSettingsUpdate = Partial<{
   dashboard_depth: number
   menu_apps: DashboardMenuItem[] | CoreDashboardMenuItem[] | Array<Record<string, unknown>> | null
   calendar_events: CalendarEvent[]
-  notification_ctrl: G2NotificationCtrlSetting
-  notification_filter: G2NotificationFilterSetting
   metric_system: boolean
   twelve_hour_time: boolean
   gallery_mode: boolean

package/src/_internal.ts

@@ -7,7 +7,7 @@
  * surface.
  */
 export {default} from "./_private/BluetoothSdkModule"
-export type {BluetoothSdkInternalModule} from "./_private/BluetoothSdkModule"
+export type {BluetoothSdkInternalModule, JscSpawnAndMeasureResult} from "./_private/BluetoothSdkModule"
 export * from "./BluetoothSdk.types"
 export {default as LocalNetwork} from "./_private/LocalNetworkModule"
 export * from "./_private/LocalNetworkModule"

package/src/_private/BluetoothSdkModule.ts

@@ -26,8 +26,13 @@ import type {
   G2FirmwareFlashResult,
   G2FirmwareTarget,
   HotspotStatusChangeEvent,
+  KeyboardAdvertEvent,
+  KeyboardBridgeStatus,
   MicPreference,
+  GlassesNotificationConfig,
+  GlassesNotificationStatus,
   ObservableStoreCategory,
+  PhoneNotificationUpload,
   OtaQueryResult,
   OtaStartAckEvent,
   PhotoRequestParams,
@@ -108,6 +113,10 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   forget(): Promise<void>
   forgetController(): Promise<void>
   showDashboard(): Promise<void>
+  setGlassesNotificationConfig(config: GlassesNotificationConfig): Promise<void>
+  getGlassesNotificationStatus(): Promise<GlassesNotificationStatus>
+  /** Glasses that present phone notifications from uploaded content (G2 on Android). Rejects elsewhere. */
+  uploadPhoneNotification(upload: PhoneNotificationUpload): Promise<void>
   setBrightness(level: number, autoMode?: boolean | null): Promise<void>
   setAutoBrightness(enabled: boolean): Promise<void>
   setDashboardPosition(height: number, depth: number): Promise<void>
@@ -115,10 +124,13 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   setCalendarEvents(events: CalendarEvent[]): Promise<void>
   setHeadUpAngle(angleDegrees: number): Promise<void>
   setImuEnabled(enabled: boolean): Promise<void>
+  glassesSensorControl(sensor: string, operation: string, options: Record<string, number>): Promise<boolean>
   setScreenDisabled(disabled: boolean): Promise<void>
   ping(): Promise<void>
   dbg1(): Promise<void>
   dbg2(): Promise<void>
+  dbg3(): Promise<void>
+  dbg4(): Promise<void>
 
   // Incident Reporting
   sendIncidentId(incidentId: string, apiBaseUrl?: string | null): Promise<void>
@@ -185,6 +197,16 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   availableG2FirmwareArtifacts(): Promise<G2FirmwareArtifact[]>
   startG2FirmwareFlash(target: G2FirmwareTarget): Promise<G2FirmwareFlashResult>
 
+  // BLE keyboard bridge (G2 Glassly CFW revision 39+)
+  g2KeyboardScan(): Promise<KeyboardAdvertEvent[]>
+  g2KeyboardConnect(address: string, addressType: number, name: string): Promise<void>
+  g2KeyboardReconnect(): Promise<void>
+  g2KeyboardDisconnect(): Promise<void>
+  g2KeyboardForget(): Promise<void>
+  g2KeyboardPasskey(pin: number): Promise<void>
+  g2KeyboardCompare(accept: boolean): Promise<void>
+  g2KeyboardStatus(): Promise<KeyboardBridgeStatus>
+
   // Version Info Commands
   requestVersionInfo(): Promise<VersionInfoResult>
 
@@ -290,6 +312,24 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
 
   // Process resident-set-size in MB. iOS-only; Android stub returns 0.
   getMemoryMB(): number
+
+  // JSC memory-spike harness (see JSCExperiment.swift). iOS-only; not
+  // implemented on Android — callers must guard for its absence.
+  /** Spawn `count` JSContexts and report the memory delta vs `baselineMB`. */
+  jscSpawnAndMeasure(count: number, baselineMB: number): JscSpawnAndMeasureResult
+  /** Tear down every JSContext spawned by the harness. */
+  jscKillAll(): void
+}
+
+/** Result of {@link BluetoothSdkNativeModule.jscSpawnAndMeasure}. */
+export interface JscSpawnAndMeasureResult {
+  spawned: number
+  totalAlive: number
+  baselineMB: number
+  beforeMB: number
+  afterMB: number
+  deltaMB: number
+  perContextMB: number
 }
 
 export type BluetoothSdkInternalModule = BluetoothSdkNativeModule

package/src/generated/changelogCatalog.ts

@@ -7,7 +7,43 @@ export const GENERATED_RELEASE_CHANGELOGS = Object.freeze(
   },
   {
     "version": "3.1.0",
-    "markdown": "Software updates are more reliable, with clearer progress and recovery when the glasses restart.\n\n- GlasslyOS, Glassly Engine, the Bluetooth SDK, and the glasses client now share one coordinated release version.\n- Mentra Live updates can continue across APK, system, and firmware restarts without asking the user to start the same update again.\n- Bluetooth photo capture and transfer diagnostics are more precise and less disruptive to normal glasses traffic."
+    "markdown": "Software updates are more reliable, with clearer progress and recovery when the glasses restart.\n\n- Glassly, Glassly Engine, the Bluetooth SDK, and the glasses client now share one coordinated release version.\n- Mentra Live updates can continue across APK, system, and firmware restarts without asking the user to start the same update again.\n- Bluetooth photo capture and transfer diagnostics are more precise and less disruptive to normal glasses traffic."
+  },
+  {
+    "version": "0.2.8",
+    "markdown": "This release is under active development. User-facing changes will be documented as they land."
+  },
+  {
+    "version": "0.2.7",
+    "markdown": "This release is under active development. User-facing changes will be documented as they land."
+  },
+  {
+    "version": "0.2.6",
+    "markdown": "- Terminal follows light and dark mode, removes the on-glasses status badge, and uses font-scaled line spacing in the glasses session picker.\n- Notifications uses the explicit 5-second popup default and prevents text selection on iOS.\n- The session.display example removes the SVG and rotation demo."
+  },
+  {
+    "version": "0.2.5",
+    "markdown": "This release is under active development. User-facing changes will be documented as they land."
+  },
+  {
+    "version": "0.2.4",
+    "markdown": "This release is under active development. User-facing changes will be documented as they land."
+  },
+  {
+    "version": "0.2.3",
+    "markdown": "This release is under active development. User-facing changes will be documented as they land."
+  },
+  {
+    "version": "0.2.2",
+    "markdown": "This release is under active development. User-facing changes will be documented as they land."
+  },
+  {
+    "version": "0.2.1",
+    "markdown": "This release is under active development. User-facing changes will be documented as they land."
+  },
+  {
+    "version": "0.2.0",
+    "markdown": "The glasses UI on Glassly CFW is now a set of pages over one overlay: the dashboard, side menu, calendar, notification viewer and debug menu each stand on their own.\n\n- A phone notification shows the viewer on its own and closes back to whatever was on the glasses; it no longer opens the dashboard first, and the ignore-while-active hold is honoured everywhere on custom firmware.\n- Double tap on any page returns to the main content; head-down closes only the dashboard.\n- A debug menu on the dashboard (Debug Settings toggle) queries phone-side state such as isPhoneActive().\n- The metric toggle moved to Appearance, and miniapps can read the host's preferences.\n- Messenger group threads show on the notification title row."
   },
   {
     "version": "0.1.0",

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": "0.1.0",
-  "releaseIdentity": "0.1.0-dev.99",
-  "releaseSetId": "glassly-0.1.0-dev.99",
-  "sourceCommit": "2aeea5db8ad4e84303faf84a92d025f0d1930ebf",
+  "familyBaseVersion": "0.2.8",
+  "releaseIdentity": "0.2.8-dev.444",
+  "releaseSetId": "glassly-0.2.8-dev.444",
+  "sourceCommit": "9ad99e635c0320d07373d42bb7422daf5289d49d",
   "otaManifestUrl": null,
   "otaManifestSha256": null
 })